franalgaba/grimoire

grimoire-across

Fetches Across Protocol bridge quotes, routes, and deposit status using the Grimoire venue CLI. Use when you need bridge quotes, route availability, or cross-chain deposit tracking.

First seen Mar 23, 2026

Installation

$ npx skills add franalgaba/grimoire --skill grimoire-across

Also in this package

Other skills from franalgaba/grimoire · top by installs.

npx skills add franalgaba/grimoire

Browse all from franalgaba/grimoire

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 6
License MIT
Default branch main
Open issues 0
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,571 B
  • docs SUMMARY.md 204 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 61 installs

SKILL.md

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.