mcpField
G
grimoire-across

grimoire-across

github.com/franalgaba其他662 次安装25 周前更新
代码仓库

关于 grimoire-across

grimoire-across 是用于查询 Across Protocol 跨链桥数据的技能，面向需要跨链策略输入的用户。它可通过 CLI 查询报价、路由和交易状态，并提供报价指标与 Spell 约束说明。

主要功能

  1. 01查询支持的链与桥接路由
  2. 02获取报价、费用和限额
  3. 03按交易哈希查询存款状态
  4. 04提供报价输出指标
  5. 05说明 Spell 桥接约束

适用场景

  1. 01比较不同链之间的桥接报价
  2. 02核查跨链存款进度
  3. 03为 Spell 桥接操作设置约束

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/franalgaba/grimoire --skill grimoire-across

安装后在 Claude Code 中输入/grimoire-across确认已加载。

详细介绍

Grimoire Across 技能

使用此技能查询 Across Protocol 桥接数据，获取跨链策略所需的输入。

推荐调用方式：

  • grimoire venue across ...
  • npx -y @grimoirelabs/cli venue across ...（无需安装）
  • bun run packages/cli/src/index.ts venue across ...（在仓库本地运行）
  • grimoire-across ...（来自 @grimoirelabs/venues 的直接二进制文件）

建议的预检：

  • grimoire venue doctor --adapter across --chain 1 --rpc-url <rpc> --json

命令

  • grimoire venue across info — 适配器元数据和支持的链
  • grimoire venue across chains — 列出支持的桥接链
  • grimoire venue across quote --asset <symbol|address> --from <chainId> --to <chainId> --amount <wei> [--recipient <address>] — 获取包含费用和限额的桥接报价
  • grimoire venue across status --tx-hash <hash> [--api-url <url>] — 根据源链交易哈希检查存款状态
  • grimoire venue across routes --asset <symbol> — 列出该资产可用的桥接路线

示例

grimoire venue across info
grimoire venue across chains
grimoire venue across quote --asset USDC --from 1 --to 8453 --amount 1000000000
grimoire venue across quote --asset WETH --from 42161 --to 1 --amount 500000000000000000
grimoire venue across status --tx-hash 0xabc123...
grimoire venue across routes --asset USDC
grimoire venue across routes --asset WETH

支持的链

链ID
Ethereum1
Optimism10
Polygon137
Base8453
Arbitrum42161

报价响应

quote 命令返回：

  • inputAmount / outputAmount — 以最小单位（wei）表示的数量
  • estimatedFillTimeSec — 预期桥接时间
  • isAmountTooLow — 数量是否低于最小值
  • limits.minDeposit / limits.maxDeposit / limits.maxDepositInstant
  • fees.lpFee / fees.relayerGasFee / fees.relayerCapitalFee / fees.totalRelayFee
  • route.spokePoolAddress — 使用的 spoke pool 合约

指标接口（Spell 对比）

Across 提供 quote_out，用于比较桥接输出：

across_out = metric("quote_out", across, USDC, "to_chain=8453,amount=1000000")

选择器字段：

  • 必填：to_chain
  • 可选：amount（默认为 1 单位的输入资产）、asset_out（默认为输入资产）

Spell 限制

为针对 Across 的 .spell 文件编写桥接操作时，请使用 with 子句：

across.bridge(USDC, params.amount, 8453) with (
  max_slippage=50,
  require_quote=true,
)
限制类型说明
max_slippageinteger (bps)最大滑点（以基点计，转换为 min_output）
min_outputinteger (wei)明确的最低输出数量
require_quoteboolean如果获取报价失败则报错
require_simulationboolean如果模拟不可用则报错
max_gasinteger (wei)根据上限验证 Gas 估算值

备注

  • 数量始终以代币的最小单位（wei）表示。对于 USDC（6 位小数）：1000 USDC = 1000000000。
  • status 命令会查询 Across 公共 API（https://app.across.to/api/deposits/status）。
  • 路线根据内置代币注册表计算；对于未列出的代币，请使用原始地址。
  • 自动化场景中优先使用 --format json；CLI 在交互使用时默认采用 toon 格式。

评论

支持 Markdown