across-bridge

🌉 Across Bridge

使用 Across Protocol v3 在 EVM 链之间跨链转移代币。 Across 是一种基于意图的桥：中继者在目标链上垫付流动性，并在源链上获得偿付， 因此结算很快（几秒到几分钟），费用也很低（0.05–0.5%）。

何时使用

• 跨链代币转移：“将 50 USDC 从 Base 跨链到 Arbitrum”
• L1 ↔ L2 转移：“将 0.01 ETH 从 Ethereum 发送到 Optimism”
• 稳定币跳转：“将 USDT 从 Arbitrum 转移到 Base”
• 速度很重要：Across 可在几秒到几分钟内完成，而原生桥需要 7 天

支持的链

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

支持的代币

ETH · WETH · USDC · USDT · WBTC · DAI

如何调用

所有操作都是以 Python 函数形式暴露在 core.skill_tools 下。由于 技能名称包含连字符，请使用 _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. 从 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

这单次调用会处理授权 + 存款 + 到账验证。无需 手动调用 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% · 完成时间 < 60s · 输出 ≈ 输入（减去少量费用）

如果出现以下情况，请在继续前警告用户：

• 费用 > 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，有效期约 30s。 bridge_execute 会在广播前重新获取。
• Gas 默认由 Starchild 钱包赞助 — 用户不需要 源链上的原生代币来支付 gas。
• 结算：Across 中继者通常会在几秒到几分钟内完成。 bridge_execute 会轮询目标余额，最长 180s。
• 钱包：使用 Starchild Agent Wallet（与 wallet 技能相同）。 无需单独连接钱包。

依赖

• requests（pip）
• core.skill_tools.wallet（平台 — 用于签名/广播）

已测试路线

此技能已通过真实链上跨链验证：1 USDC Base → Arbitrum， 确认在约 35 秒内到达目标链，费用 0.47%。