across-protocol-ai-agent-skill

Across 协议开发技能

此技能的用途

当用户提出以下需求时，使用此技能：

• 集成跨链桥或兑换（任意代币间转账）
• 将钱包或 dApp 与 Across API 集成
• 嵌入跨链操作（在一笔交易中完成桥接 + 铸造/质押/存入）
• 跟踪存款并监控状态
• 查询费用、转账限额或发现路由
• 设置集成方费用收取
• 构造链上意图（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 通过一次调用处理源链兑换、桥接和目标链兑换。
• 支持使用 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
桥接 + 目标链操作（铸造、质押）	在请求体中提供 actions，使用 Swap API POST /swap/approval
以 TypeScript 编程集成	App SDK createAcrossClient()
仅桥接并自定义兑换路由	/suggested-fees + 手动调用 depositV3
直接构造链上意图（ERC-7683）	在受支持的链上使用 AcrossOriginSettler.open()
跟踪存款	使用 depositTxnRef 或 originChainId + depositId 调用 GET /deposit/status

3. 确保符合 Across 特定要求

请始终明确以下内容：

• 集成方 ID（2 字节十六进制字符串）
• 代币地址：必须与具体链匹配（原生代币请使用包装代币地址）
• 金额单位：始终使用最小单位（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