across-bridge

🌉 Across Bridge

Across Protocol v3 を使用して EVM チェーン間でトークンをブリッジします。 Across は intent ベースのブリッジです。リレイヤーが 宛先チェーンで流動性を立て替え、元のチェーンで返済を受けるため、決済が高速 （数秒から数分）で、手数料も低く抑えられます（0.05～0.5%）。

使用する場面

• クロスチェーンのトークン転送: 「Base から Arbitrum へ 50 USDC をブリッジ」
• L1 ↔ L2 の移動: 「Ethereum から Optimism へ 0.01 ETH を送金」
• ステーブルコインのホップ: 「Arbitrum から Base へ USDT を移動」
• スピードが重要: Across は数秒～数分で完了するのに対し、ネイティブブリッジは 7 日かかります

対応チェーン

Ethereum · Arbitrum · Optimism · Base · Polygon · BSC · Linea · zkSync · Scroll · Mantle

対応トークン

ETH · WETH · USDC · USDT · WBTC · DAI

呼び出し方法

すべての操作は core.skill_tools 以下に公開された Python 関数です。スキル名に ハイフンが含まれるため、_modules 辞書を使ってアクセスします:

python3 - <<'EOF'
from core.skill_tools import _modules
across = _modules["across-bridge"]
import json
q = across.bridge_quote(from_chain="base", to_chain="arbitrum",
                        token="USDC", amount=1, wallet="0x...")
print(json.dumps(q, indent=2))
EOF

bridge_quote(from_chain, to_chain, token, amount, wallet=None)

ライブクォートを取得します — オンチェーンでの操作は行いません。出力量、手数料、 推定完了時間、そして（wallet が指定されている場合は）署名可能な承認トランザクションと ブリッジトランザクションを返します。

bridge_execute(from_chain, to_chain, token, amount, wallet, confirm_arrival=True)

1 回の呼び出しですべてを実行します:

1. Across の /swap から最新のクォートを取得します
2. SpokePool に ERC-20 の承認を送信します（必要な場合のみ。ネイティブ ETH の場合はスキップされます）
3. depositV3 のブリッジトランザクションを送信します
4. 資金が到着するまで（またはタイムアウトまで）宛先チェーンの残高をポーリングします

status、output_amount、approval_tx、 bridge_tx、arrival_confirmed を含む完全なレシートを返します。

bridge_status(origin_chain, deposit_tx_hash)

送信済みのデポジットの充填ステータスを Across のステータス API で確認します。

ワークフロー

クォートだけを取得する（実行なし）

python3 - <<'EOF'
from core.skill_tools import _modules
across = _modules["across-bridge"]
import json
q = across.bridge_quote(from_chain="base", to_chain="arbitrum",
                        token="USDC", amount=50)
print(json.dumps(q, indent=2))
EOF

レスポンスの主なフィールド:

• output_amount_human — 受取人が受け取るトークン量
• fees.total_pct — 手数料の割合（例: 4688000000000000 = 0.47%）
• estimated_fill_time_sec — 予想される決済時間
• needs_approval — ブリッジ前に ERC-20 の承認が必要かどうか

エンドツーエンドでブリッジする（一般的なケース）

python3 - <<'EOF'
from core.skill_tools import _modules
across = _modules["across-bridge"]
import json
r = across.bridge_execute(from_chain="base", to_chain="arbitrum",
                          token="USDC", amount=1,
                          wallet="0x0B52...Eb16")
print(json.dumps(r, indent=2, default=str))
EOF

この 1 回の呼び出しで承認 + デポジット + 到着確認を処理します。手動で wallet_transfer を呼び出したり calldata をエンコードしたりする必要はありません — Across の /swap API が署名可能なトランザクションを返し、このスキルがそれらを送出します。

送信済みのデポジットのステータスを確認する

python3 - <<'EOF'
from core.skill_tools import _modules
across = _modules["across-bridge"]
import json
s = across.bridge_status(origin_chain="base", deposit_tx_hash="0x...")
print(json.dumps(s, indent=2))
EOF

受け入れ / 危険信号のガイダンス

良好なルート:

• 手数料 < 0.5% · 完了時間 < 60 秒 · 出力 ≈ 入力（少額の手数料を差し引いたもの）

以下の場合は続行する前にユーザーに警告してください:

• 手数料 > 1%（高コストなルート、または金額が非常に少ない — 最低デポジットが適用されます）
• 完了時間 > 10 分（混雑したルート）
• 金額が limits.min_deposit を下回っている（クォートで isAmountTooLow が示されます）

主な事実

• ネイティブ ETH: msg.value が金額を運びます。承認ステップはありません。Across が ラッピング／アンラッピングを自動的に処理します。
• ERC-20: msg.value = 0 です。ブリッジの前にまず approve(spokePool, amount) が必要です。 bridge_execute がこれを自動的に送信します。
• クォートはライブで app.across.to/api/swap から取得され、約 30 秒間有効です。 bridge_execute はブロードキャスト直前に再取得します。
• ガスはデフォルトでスポンサーされます — Starchild ウォレット経由であり、ユーザーは 元のチェーンでガス用のネイティブトークンを用意する必要がありません。
• 決済: Across のリレイヤーは通常、数秒から数分以内に充填します。bridge_execute は 最大 180 秒間、宛先の残高をポーリングします。
• ウォレット: Starchild Agent Wallet を使用します（wallet スキルと同じ）。 別途ウォレット接続は不要です。

依存関係

• requests (pip)
• core.skill_tools.wallet（プラットフォーム — 署名／ブロードキャスト用）

テスト済みルート

このスキルは実際のオンチェーンブリッジで検証されました: 1 USDC を Base → Arbitrum へ、 約 35 秒以内に宛先への到着を確認、手数料 0.47%。