The Agentic Financial Simulation Layer
Let your contracts face the swarm.
erisnet.xyz · クイックスタート · ドキュメント
Markets ship behavior（市場は挙動として現れる）. プロトコルの本当の弱点は、監査レポートのチェック項目を眺めるだけでは見つけきれない。多数の自律エージェント（取引 bot）を実際に市場で競わせて初めて、AMM の価格のゆがみ・清算の連鎖・オラクル更新の遅れといった弱点が「現実の挙動」として表に出てくる。Eris はそれをローカルで再現する競争シミュレータの MVP（実証版）。erisnet.xyz が掲げる Agentic Financial Simulation Layer（自律エージェントが金融プロトコルを継続的にストレステストする環境）のローカル版にあたる。
ローカル anvil 上に全 protocol を deploy したマルチプロトコル DeFi 環境で動く戦略シミュレータ。複数の自律エージェントが同じ mempool で互いに競い、コーディネータが市場を駆動して run 後に価値系列を再構成・採点する。エージェントには RPC・秘密鍵・pending トランザクション・txpool を一切渡さず、確定済み状態の観測のみを与える。
- マルチプロトコル DeFi 環境 — Uniswap V3 / Balancer v2 / Curve / Aave v3 / GMX v2 を 1 つの Anvil 上に揃え、プロトコルアダプタレジストリ（
src/protocols/）でプラガブルに有効化する。 - 多エージェント競争 — エージェントは完全独立プロセスとして自分のペースでブロックを購読し、自分で署名して直接送信する。ブロック内順序は anvil
--order fees（priority fee 降順）で決まる。 - 制御可能な fair price — コーディネータが SEED 由来の決定論的な fair price を毎ブロック生成し、オンチェーンの
PriceFeedとモックオラクルへ書き込む。Aave のヘルスファクタや GMX のマーク価格がこれに追従する。 - 市場ストレス & 清算 — 価格スパイク／クラッシュを注入し、Aave 清算経路を誘発できる。
- LLM 駆動の自律エージェント — 戦略を実行時に LLM が生成・改訂する（手書きのトレードロジック無し）。
- fork 無しのローカルデプロイモード — fork backend への cold state RPC 往復（fork RPC レイテンシ）を避け、マルチアセット（WETH/WBTC）も動く。
アーキテクチャ（環境とエージェント実行の分離）の詳細は アーキテクチャ を参照。
Arbitrum を fork せず、本 repo 同梱の deployer/ がローカル anvil 上に全 protocol を deploy したものに接続する。fork RPC レイテンシを避けられ、マルチアセット（WETH/WBTC）も動く。詳細は ローカルリアルタイムシミュレーション。
# poc（リポジトリルート）
npm install
cp config/example.yaml config/local.yaml # run 設定 + エージェントロスター
cp .env.example .env.local # 秘密情報のみ（ローカルは Anvil の dev キーで動くため任意）
npm run build:contracts # PriceFeed + モックオラクルを forge build（out/ が無ければ初回 1 回）
# 同梱 deployer/（初回のみ。GMX クローン取得 + Aave 依存 install で数分）
cd deployer
npm install
forge build # 共有 mock トークンをコンパイル
cp .env.example .env
./scripts/setup-vendors.sh # 外部 repo(GMX) を clone+パッチ、Aave deps を install
cd ..# 別ターミナル: deployer で anvil 起動 + 全 venue deploy（--exit は付けない）
cd deployer && npm run deploy -- --keep-fresh
# poc 側（リポジトリルート）: deploy アドレスを取り込み、ローカルデプロイモードで run
npm run gen:local-constants
npm run sim:realtime -- --local-deploy --agents agents.local.json \
--seed 1 --blocks 24 --seconds 70 --protocols uniswap,balancer,curve
--local-deployフラグ（または config のrun.localDeploy: true）でローカルデプロイモードになる。CLI エントリが起動時にこれを検出して内部でERIS_LOCAL_DEPLOY=1を立て、src/constants.tsがローカルデプロイ済アドレス（WETH/USDC/WBTC 等）を overlay する（env を手で渡す必要はない）。
出力は runs/<run_id>/ 下に書かれる（summary.json / events.jsonl / blocks.csv / agents/<id>.jsonl）。確認できること:
- 全 agent と flow ウォレットのセットアップが完了する。
- 各ブロックで flow トランザクションと有効な agent トランザクションが提出される。
summary.jsonのvalueSeries.failedReadsが0。
| ドキュメント | 内容 |
|---|---|
| アーキテクチャ | 環境（市場機構＋採点者）とエージェント実行の分離・fair price 配布・採点の再構成 |
| プロトコルとアクション | 各 venue のアクション・ステーブルコイン会計・オラクル制御・GMX 非同期実行 |
| 設定（config/local.yaml） | YAML 単一ソースの設定・セクション・ロスターの書き方 |
| ローカルリアルタイムシミュレーション | 非fork のローカルデプロイモードの前提・手順・主要設定・トラブルシュート |
| LLM 駆動の自律エージェント | 実行時に戦略を生成・改訂する LLM エージェント（2 層構成・バックエンド・チューニング） |
| 市場ストレスイベント | 価格スパイク／クラッシュの注入と Aave 清算の誘発 |
| リポジトリ構成 | ディレクトリ構成の早見表 |
| run 出力と解析 | runs/<id>/ の出力ファイルと run 後の解析方法 |
これは研究・実験用の MVP / Proof of Concept であり、本番運用を意図しない。Aave / GMX のオラクルはコーディネータが制御するモックで、fair price は決定論的に生成される合成パスである。シミュレーションの結果（PnL・順位・識別力）は環境の構成・SEED・サンプル数に依存し、実市場のパフォーマンスを保証しない。
Built by Nyx Foundation · Let your contracts face the swarm.