across-bridge

Across Bridge 是一个使用 Across Protocol v3 在 EVM 链之间桥接代币的技能。Across 是意图（intent）型桥：中继者在目标链先垫付流动性，随后在源链获得偿还，因此结算较快（数秒到几分钟），费用较低（0.05–0.5%）。

【用途与适用场景】

跨链代币转移，例如“从 Base 桥接 50 USDC 到 Arbitrum”。
L1 与 L2 之间的资金移动，例如“从 Ethereum 发送 0.01 ETH 到 Optimism”。
稳定币流转，例如“把 USDT 从 Arbitrum 转到 Base”。
对速度有要求的场景：Across 在数秒到数分钟内填充，相比原生桥的 7 天更快。资料列出的支持链：Ethereum、Arbitrum、Optimism、Base、Polygon、BSC、Linea、zkSync、Scroll、Mantle。支持的代币：ETH、WETH、USDC、USDT、WBTC、DAI。

【主要能力】

bridge_quote(from_chain, to_chain, token, amount, wallet=None)：获取实时报价，不发起链上操作。返回输出数量、费用、预计填充时间；若提供 wallet，还会返回可签名（ready-to-sign）的授权与桥接交易。报价关键字段包括 output_amount_human（接收方将收到的代币数量）、fees.total_pct（费用百分比，例如 4688000000000000 表示 0.47%）、estimated_fill_time_sec（预计结算时间）、needs_approval（桥接前是否需要 ERC-20 授权）。
bridge_execute(from_chain, to_chain, token, amount, wallet, confirm_arrival=True)：一次调用完成整个端到端流程——从 Across /swap 获取最新报价；向 SpokePool 发送 ERC-20 授权（如需要，原生 ETH 会跳过）；发送 depositV3 桥接交易；轮询目标链余额直到资金到达（或超时）。返回包含 status、output_amount、approval_tx、bridge_tx、arrival_confirmed 的完整回执。
bridge_status(origin_chain, deposit_tx_hash)：通过 Across 的状态 API 查询已提交存款的填充状态。

【使用方式】所有操作都是 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

端到端桥接示例：

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

状态查询示例：

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

资料说明：bridge_execute 单次调用即处理授权、存款与到账验证，无需手动调用 wallet_transfer 或编码 calldata；Across /swap API 会返回可直接签名的交易，本技能负责派发。

【验收与风险提示】资料给出的良好路线标准：费用低于 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 钱包赞助 gas，用户在源链上不需要持有原生代币支付 gas。
结算：Across 中继者通常在数秒到数分钟内填充；bridge_execute 会轮询目标链余额最多 180 秒。
钱包：使用 Starchild Agent Wallet（与 wallet 技能相同），无需单独连接钱包。

【依赖】

requests（pip）
core.skill_tools.wallet（平台，用于签名与广播）

【测试路线】该技能经过真实链上桥接验证：1 USDC 从 Base 到 Arbitrum，约 35 秒内确认到达目标链，费用 0.47%。

【限制】资料未提供该技能的全部错误处理、超时后的资金状态处理、具体费用上限配置项或失败退款流程；也未提供移动端、Web 界面或其他语言 SDK 的说明。缺失信息暂未提供。

技能介绍