across-protocol-ai-agent-skill

Across プロトコル開発スキル

このスキルの用途

ユーザーから次の依頼があった場合に、このスキルを使用してください。

• クロスチェーンブリッジまたはスワップの統合（任意のトークン間の転送）
• Across API を使用したウォレットまたは dApp の統合
• 埋め込み型のクロスチェーン操作（1 回のトランザクションでブリッジとミント／ステーク／デポジットを実行）
• デポジットの追跡とステータスの監視
• 手数料の見積もり、転送制限、ルートの検出
• インテグレーター手数料の徴収設定
• オンチェーンインテントの構築（ERC-7683／SpokePool デポジット）
• リレイヤーの運用または設定
• クロスチェーン統合コードのセキュリティレビュー

ルートタイプの略称

Swap API では、各トークンが直接ブリッジ可能（B）か、ブリッジ可能なトークンへの変換が必要（A = Any）かに基づく略称でルートを分類します。

略称	意味	例
B2B	ブリッジ可能 → ブリッジ可能	Arbitrum 上の USDC → Base 上の USDC（スワップなし、ブリッジのみ）
A2B	任意 → ブリッジ可能	Arbitrum 上の WBTC → Base 上の USDC（送信元でのスワップ＋ブリッジ）
B2A	ブリッジ可能 → 任意	Arbitrum 上の USDC → Base 上の WBTC（ブリッジ＋送信先でのスワップ）
A2A	任意 → 任意	Arbitrum 上の WBTC → Base 上の DAI（送信元でのスワップ＋ブリッジ＋送信先でのスワップ）

これらの略称は、crossSwapType のレスポンスと返金動作のデフォルト設定に表示されます。

デフォルトのスタック構成（推奨）

1. まず Swap API を使う（ほとんどのインテグレーターに推奨）

• すべてのクロスチェーンスワップに GET /swap/approval を使用してください。署名して送信できる実行可能な calldata が返されます。
• 送信先での操作（ミント、ステーク、デポジット）を埋め込む必要がある場合は、POST /swap/approval を使用してください。
• Swap API は、送信元でのスワップ、ブリッジ、送信先でのスワップを 1 回の呼び出しで処理します。
• インテグレーター手数料の徴収に appFee と appFeeRecipient をサポートしています。

2. Suggested-fees API：レガシー用途のみ

• 独自のスワップインフラストラクチャを管理しており、ブリッジ手数料の見積もりだけが必要な場合に限り、/suggested-fees を使用してください。
• この方法では、トランザクションを自分で組み立てる必要があります（depositV3 呼び出しを手動で構築します）。
• 送信元または送信先でのスワップには対応していません。

3. トレードタイプの選択

• exactInput（デフォルト）：ユーザーが送信する数量を指定します。「X トークンをスワップする」フローに最適です。
• minOutput：ユーザーが受け取る最低数量を指定します。ブリッジ後の操作を伴わないシンプルなスワップに最適です。
• exactOutput：ユーザーが送信先で受け取る正確な数量を指定します。複数ステップのフロー（たとえば、ミントに必要な正確な ERC-20 数量）に最適です。

4. スリッページ

• デフォルトでは slippage=auto を使用してください。
• 数値で指定するスリッページ（0〜1）は、送信元と送信先の両方でスワップが行われる場合、それぞれに分配されます。
• スワップが片方だけで行われる場合は、指定したスリッページ全体がそのスワップに適用されます。

5. 返金の動作

• B2B または A2B ルート（送信先でのスワップなし）では、デフォルトで送信元チェーンに返金されます。
• B2A または A2A ルート（送信先でのスワップあり）では、デフォルトで送信先チェーンに返金されます。
• 必要に応じて refundOnOrigin=true/false で上書きしてください。
• 返金先の優先順位：refundAddress > recipient > depositor

運用手順（タスクの実行方法）

1. タスクを分類する

• UI またはウォレットの統合
• バックエンドまたはスクリプト
• 埋め込み型操作
• 追跡または監視
• オンチェーンまたは ERC-7683
• リレイヤーの運用

2. 適切な統合方法を選択する

タスク	使用する方法
クロスチェーンスワップ（任意のトークン間）	Swap API GET /swap/approval
ブリッジ＋送信先での操作（ミント、ステーク）	Swap API POST /swap/approval と actions ボディ
TypeScript によるプログラム統合	App SDK createAcrossClient()
カスタムスワップルーティングを使ったブリッジのみの処理	/suggested-fees ＋ 手動の depositV3
直接オンチェーンインテント（ERC-7683）	対応チェーン上の AcrossOriginSettler.open()
デポジットの追跡	depositTxnRef または originChainId ＋ depositId を指定した GET /deposit/status

3. Across 固有の正確性を考慮して実装する

以下の点を必ず明示してください。

• インテグレーター ID（2 バイトの 16 進文字列）
• トークンアドレス：対象のチェーンに一致させる必要があります（ネイティブトークンにはラップ済みアドレスを使用してください）
• 金額の単位：常に最小単位を使用してください（ETH は wei、USDC は 1e6、WETH は 1e18）
• チェーン ID：チェーン名ではなく、正確な数値のチェーン ID を使用してください
• 承認トランザクション：Swap API のレスポンスで approvalTxns を確認してください
• /swap/approval と /suggested-fees のレスポンスはキャッシュしないでください

4. テストネットでテストし、メインネットでリリースする

• テストネットのベース URL：https://testnet.across.to/api
• テストネットでは少額（約 $10）を使用してください。テストネットでのフィルには約 1 分かかります（メインネットでは約 2 秒です）。
• テストネットのリレイヤーには手動で資金が補充されます。大きな金額でテストしないでください。
• 統合ロジックを検証できたら、メインネット（https://app.across.to/api）に切り替えてください。

5. 成果物に関する要件

変更を実装する際は、以下を提示してください。

• 変更したファイルと差分の正確な一覧
• インストール、ビルド、テストを実行するコマンド
• 署名、手数料、スリッページ、承認、返金、クロスチェーンメッセージに関わる内容がある場合は、「リスクに関する注意事項」のセクション

必要に応じて参照してください

• Swap API の詳細： SKILL.md
• レガシーなブリッジのみの統合： SKILL.md
• 埋め込み型クロスチェーンアクション： SKILL.md
• 入金の追跡： SKILL.md
• チェーンとトークンのリファレンス： SKILL.md
• セキュリティチェックリスト： SKILL.md
• リソースとリンク： SKILL.md