Grimoire Across Skill

Use this skill to query Across Protocol bridge data for cross-chain strategy inputs.

Preferred invocations:

grimoire venue across ...
npx -y @grimoirelabs/cli venue across ... (no-install)
bun run packages/cli/src/index.ts venue across ... (repo-local)
grimoire-across ... (direct binary from @grimoirelabs/venues)

Recommended preflight:

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

Commands

grimoire venue across info — adapter metadata and supported chains
grimoire venue across chains — list supported bridge chains
grimoire venue across quote --asset <symbol|address> --from <chainId> --to <chainId> --amount <wei> [--recipient <address>] — get a bridge quote with fees and limits
grimoire venue across status --tx-hash <hash> [--api-url <url>] — check deposit status by origin tx hash
grimoire venue across routes --asset <symbol> — list available bridge routes for an asset

Examples

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

Supported Chains

Chain	ID
Ethereum	1
Optimism	10
Polygon	137
Base	8453
Arbitrum	42161

Quote Response

The quote command returns:

inputAmount / outputAmount — amounts in smallest unit (wei)
estimatedFillTimeSec — expected bridge time
isAmountTooLow — whether the amount is below minimum
limits.minDeposit / limits.maxDeposit / limits.maxDepositInstant
fees.lpFee / fees.relayerGasFee / fees.relayerCapitalFee / fees.totalRelayFee
route.spokePoolAddress — spoke pool contract used

Metric Surface (Spell Comparisons)

Across exposes quote_out for bridge output comparisons:

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

Selector fields:

required: to_chain
optional: amount (defaults to 1 unit of input asset), asset_out (defaults to input asset)

Spell Constraints

When writing bridge actions in .spell files targeting Across, use with clauses:

across.bridge(USDC, params.amount, 8453) with (
  max_slippage=50,
  require_quote=true,
)

Constraint	Type	Description
`max_slippage`	integer (bps)	Maximum slippage in basis points (converted to min_output)
`min_output`	integer (wei)	Explicit minimum output amount floor
`require_quote`	boolean	Fail if quote fetch fails
`require_simulation`	boolean	Fail if simulation unavailable
`max_gas`	integer (wei)	Validate gas estimate against cap

Notes

Amounts are always in the token's smallest unit (wei). For USDC (6 decimals): 1000 USDC = 1000000000.
The status command queries the Across public API (https://app.across.to/api/deposits/status).
Routes are computed from the built-in token registry; use raw addresses for unlisted tokens.
Prefer --format json in automation; the CLI defaults to toon format for interactive use.

grimoire-across