> For the complete documentation index, see [llms.txt](https://docs.pancakeswap.finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pancakeswap.finance/japanese/tordingutsru/building-trading-agents-on-pancakeswap-v3/reference-agent-order-intents-settlement-agent.md).

# リファレンスエージェント — 注文/インテント決済エージェント

> PancakeSwapアグリゲーションを通じてルーティングし、ターゲットトークンをクライアントに直接配送することで、一度に1つのスワップインテントジョブを実行するERC-8183プロバイダーエージェントです。

### 0. ERC-8183へのマッピング

ERC-8183（エージェンティックコマース；Virtuals + Ethereum Foundation）は、Open → Funded → Submitted → TerminalというステートのJobを3つのロールで定義します。BNBの**BNBAgent SDK**がライブ実装です。

| ロール                                       | このエージェントにおいて                                                                            |
| ----------------------------------------- | --------------------------------------------------------------------------------------- |
| **クライアント**（エージェントA）                       | スワップインテントを投稿します：「トークンAのXをトークンBにスワップし、≥`minOut`で配送してください」、入力とチップをエスクローします                |
| **プロバイダー**（エージェントB） — **これがリファレンスエージェント** | **PancakeSwapアグリゲーション**を通じて見積もりを取得し、`minOut`を達成/超えることができる場合にスワップを実行してトークンBをクライアントに配送します |
| **エバリュエーター**                              | クライアントがトークンBの量 ≥ `minOut`を受け取ったことを確認し、チップを放出します（またはクライアントに返金します）                        |

成果物は客観的です（「クライアントは ≥ `minOut`を受け取ったか？」）。これがリバランサーではなくERC-8183に適合する理由です。

***

### 1. 目的とワンライン範囲

> PancakeSwapアグリゲーションを通じてルーティングし、ターゲットトークンをクライアントに直接配送することで、一度に1つのスワップインテントJobを実行する**プロバイダー**エージェント — それだけです。

***

### 2. エージェントに許可されること（機能許可リスト）

| # | 機能         | サーフェス                                                  | 注意事項                                              |
| - | ---------- | ------------------------------------------------------ | ------------------------------------------------- |
| A | オープンジョブの検索 | BNBAgent SDK（ERC-8183レジストリ）                            | 読み取り専用；提供できるスワップインテントジョブにフィルタリング                  |
| B | ルートの見積もり   | **PancakeSwapアグリゲーション**（Aggregator API / Smart Router） | 読み取り専用；V3全体で最良の価格                                 |
| C | ジョブの承認     | BNBAgent SDK（Funded → committed）                       | 新鮮な見積もり ≥ `minOut`かつチップ ≥ フロアの場合のみ                |
| D | スワップの実行    | PancakeSwapルーター                                        | ジョブエスクローから入力を引き出し；**出力受取人 = クライアント**、1つのトランザクションで |
| E | 成果物の提出     | BNBAgent SDK（→ Submitted）                              | 証拠として決済トランザクションハッシュを使用                            |
| F | チップの請求     | ERC-8183エスクロー / x402                                   | エバリュエーターがJobをTerminalとマークした後のみ                    |

**すべての決済の出力は直接クライアントに送られます。エージェントの唯一の収益はジョブのチップです。**

***

### 3. ハードガードレール（フィーチャリングへの入り口）

| ガードレール                | ルール                                                                                                   |
| --------------------- | ----------------------------------------------------------------------------------------------------- |
| **実行できないものは絶対に承認しない** | \_新鮮な\_見積もりが`minOut`をクリアする場合のみジョブを承認します。できない場合は、ジョブをFundedのまま別のプロバイダーに残します。                           |
| **実行時に再見積もり**         | 決済直前に再見積もりを行い、ルートが`minOut`をクリアしなくなった場合は中止します（古い見積もりは使用しない）。                                           |
| **アトミック決済**           | エスクローから引き出し→スワップ→クライアントへ配送を**1つのトランザクション**で、出力受取人 = クライアント。エージェントは失敗したステップにまたがってクライアントの資金を保持してはいけません。 |
| **スリッページ**            | 実行スリッページを制限し、スリッページ後も配送額 ≥ `minOut`でなければならず、そうでなければトランザクションがrevertします。絶対に`amountOutMin = 0`にしない。      |
| **デッドライン**            | 決済トランザクションに短いデッドライン（≤ 5分）；ジョブ自身のデッドラインを尊重します。                                                         |
| **最小チップ / 最大価値**      | チップのフロアを下回るまたは1ジョブの価値上限を超えるジョブを承認しない。                                                                 |
| **トークンセーフリスト**        | PancakeSwapトークンリストに含まれるトークンのジョブのみ提供します（ハニーポット/偽トークン対策）。                                               |
| **シングルジョブ並行処理（v1）**   | 一度に1つのジョブを実行し、過剰なコミットメントをしない。                                                                         |
| **ガスの前提条件**           | 承認前に完全な決済に十分なBNBがあることを確認します。                                                                          |
| **冪等性**               | 既にSubmitted/TerminalのJobを二重に提出または再実行しない。                                                              |

いずれかのルールを満たせない場合は、**ジョブをスキップ**します — 決済を強制しないでください。

***

### 4. スコープ外 — エージェントがしてはいけないこと

1. **指定されたスワップ以外にクライアントの資金を使用する。** 出力受取人は常にクライアントです。
2. **独自の在庫を使ったり、元本リスクを取る。** v1は**エスクロープルのみ** — クライアントのエスクロー入力をルーティングします；独自の残高からは補充しません。
3. **PancakeSwap以外または未確認のコントラクトを通じてルーティングする**、またはPancakeSwapアグリゲーション外で決済する。
4. **セーフリストに含まれないトークンのジョブを提供する**、またはv1ではスケールドUI / RWAトークン（§5）。
5. **レバレッジ、無期限取引、マージン、またはレンディングを使用する。**
6. **実際に実行していない成果物を提出する**（虚偽の証明）または**自分のジョブを評価する**（利益相反）。
7. PancakeSwapまたはERC-8183コントラクト上の**オーナー/アドミン関数を呼び出す**。
8. 1回の決済を超えて**無期限のトークン承認を保持する**；ジョブ金額に承認をスコープします。

***

### 5. PancakeSwap固有のロジック（アプリケーションの正確性）

* **PancakeSwapアグリゲーションを通じてルーティング**し、単一のプールではなく — V2 / V3 / Stableにわたる最良の執行がすべての価値提案です（「最良の価格がチップを獲得する」）。
* ルーターの`recipient`をクライアントアドレスに設定することで**クライアントへアトミックに配送**します；「自分にスワップして、次に転送」という2ステップは使用しません。
* **見積もりの鮮度** — オンチェーン価格は発見と決済の間に変動します；実行時に再見積もりします（ガードレール§3）。
* **`minOut`は生の単位です。** **スケールドUI / ERC-8056トークン**（Binanceストックトークン / RWAエクイティ）では生の値 ≠ 表示値；誤った処理は静かに誤配送します。**生ユニット処理をエンジニアリングがエンドツーエンドで確認するまでv1からスケールドUIトークンを除外します。**
* 決済スワップの**スリッページ最小値**は、チップ/手数料の分割を考慮した後も\_配送額\_ ≥ `minOut`となるように導出する必要があります。

***

### 6. 失敗と回復の動作

* **実行時に見積もりが`minOut`に達しない** → エスクロープル前/それとアトミックに中止；Jobは別のプロバイダーのためにFundedのままです。部分的な状態なし。
* **既にSubmitted/Terminal** → スキップ（冪等）。
* **決済トランザクションがrevert** → Jobは他者が請求可能なまま；エージェントは失敗を記録して次に進みます。
* **あるジョブでの繰り返しの失敗** → ループリトライではなく、そのジョブをローカルでブラックリストに追加してアラートを出します。

***

### 7. 統合ポイント（BNB / ERC-8183の部分）

これらはBNB Agent Studio / BNBAgent SDKによって提供され、PancakeSwapが構築するものではありませんが、仕様に依存しています：

* **ジョブライフサイクル**（Open → Funded → Submitted → クレーム）はBNBAgent SDK経由。
* **プロバイダーID**はERC-8004経由。
* **エスクロー + ペイアウト**はERC-8183エスクロー / x402経由。
* **エバリュエーター** — 述語は「クライアントのトークンB残高が ≥ `minOut`増加した」でなければなりません。エバリュエーターを誰が運営するか（中立/プロトコル vs. クライアント）、および述語がオンチェーンで強制可能かどうかをBNBに確認してください。

***

### 8. 推奨v1の姿勢とオープンな決定事項

1. **エスクロープルのみ、一度に1ジョブ、トークンセーフリストのみ、スケールドUIトークンなし。** ローンチ時にフィーチャリングするための最小の安全なサーフェス。
2. **PancakeSwapのスワップインターフェースを確認** — **アグリゲーター（`aggr`）HTTP API** vs **Smart Router SDK**。JerryのメモはPCS aggr apiの使用を示しています；エージェントが呼び出すものを確認する必要があります（統合が変わり、ガイドにアグリゲーションセクションが必要かどうかに影響します）。
3. BNBに**エスクロー機構を確認** — プロバイダーはスワップをルーティングするためにクライアントのエスクロー入力を引き出すことができるか、またクライアントへの配送が成果物として強制可能か？
4. **エバリュエーターのオーナーと述語を確認**（§7）。

> フィーチャリング前のエンジニアリング承認：アトミックなエスクロープル → スワップ → クライアントへの配送ルーティング；実行時の再見積もり；スリッページ後の`minOut`計算；セーフリスト強制；冪等なジョブ処理。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.pancakeswap.finance/japanese/tordingutsru/building-trading-agents-on-pancakeswap-v3/reference-agent-order-intents-settlement-agent.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.