trails/SKILL.md
--- name: trails description: Trails — Cross-chain swap, bridge, and DeFi orchestration via Sequence. Use when an agent wants to swap tokens across chains, bridge assets, fund a Bankr wallet from any chain, deposit into yield vaults (Aave, Morpho), get token prices, discover earn pools, or quote cross-chain routes. Integrates with Bankr submit() for on-chain execution. Also use when asked about Trails, Sequence swaps, cross-chain bridging, or DeFi yield deposits. # Trails Cross-chain swap, br
npx skillsauth add bankrbot/openclaw-skills trailsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
name: trails description: Trails — Cross-chain swap, bridge, and DeFi orchestration via Sequence. Use when an agent wants to swap tokens across chains, bridge assets, fund a Bankr wallet from any chain, deposit into yield vaults (Aave, Morpho), get token prices, discover earn pools, or quote cross-chain routes. Integrates with Bankr submit() for on-chain execution. Also use when asked about Trails, Sequence swaps, cross-chain bridging, or DeFi yield deposits.
Cross-chain swap, bridge, and DeFi orchestration powered by Sequence. Agents specify the action — Trails automatically determines the optimal multi-step path across chains.
API Base: https://trails-api.sequence.app/rpc/Trails/<MethodName>
Auth Header: X-Access-Key: $TRAILS_API
Widget: https://demo.trails.build/
Bankr Integration: submit() from @bankr/cli broadcasts on-chain transactions
export TRAILS_API=<your-sequence-project-access-key> # from https://sequence.build
export BANKR_API_KEY=<your-bankr-key> # from bankr.bot/api-keys
BANKR_WALLET=$(curl -s https://api.bankr.bot/agent/me \
-H "X-API-Key: $BANKR_API_KEY" \
| jq -r '.wallets[] | select(.chain == "evm") | .address')
curl -s https://trails-api.sequence.app/rpc/Trails/QuoteIntent \
-H "Content-Type: application/json" \
-H "X-Access-Key: $TRAILS_API" \
-d "{
\"ownerAddress\": \"$BANKR_WALLET\",
\"originChainId\": 137,
\"originTokenAddress\": \"0x3c499c542cef5e3811e1192ce70d8cC03d5c3359\",
\"originTokenAmount\": \"10000000\",
\"destinationChainId\": 8453,
\"destinationTokenAddress\": \"0x0000000000000000000000000000000000000000\",
\"destinationTokenAmount\": \"0\",
\"tradeType\": \"EXACT_INPUT\",
\"options\": { \"slippageTolerance\": 0.005 }
}" | jq '.intent.quote'
curl -s https://trails-api.sequence.app/rpc/Trails/GetEarnPools \
-H "Content-Type: application/json" \
-H "X-Access-Key: $TRAILS_API" \
-d '{"chainIds": [137]}' \
| jq '[.pools[] | select(.isActive and .token.symbol == "USDC")] | sort_by(-.tvl) | .[0]'
Use the Trails widget URL with the Bankr wallet address as toAddress. See references/trails.md Recipe 1.
See references/trails.md Recipe 2.
See references/trails.md Recipe 3.
Use GetTokenList (body: {"chainIds": [137]}) or GetChains.
Use GetTokenPrices.
| Group | Method | Description |
| --------------------- | ---------------------------------- | ------------------------------------------------ |
| Intent lifecycle | QuoteIntent | Get quote + depositTransaction for a swap/bridge |
| | CommitIntent | Lock the intent, receive intentId |
| | ExecuteIntent | Notify Trails the deposit tx is mined |
| | WaitIntentReceipt | Poll until intent is complete |
| Intent management | GetIntent | Look up intent by ID |
| | GetIntentReceipt | Get final receipt |
| | SearchIntents | List intents by owner/status |
| | GetIntentHistory | Paginated history |
| | AbortIntent | Cancel a pending intent |
| Discovery | GetEarnPools | Active yield pools with APY, TVL, depositAddress |
| | GetChains | Supported chains |
| | GetTokenList | Tokens per chain |
| | GetTokenPrices | USD prices |
| | GetExactInputRoutes | Preview routes for exact-in |
| | GetExactOutputRoutes | Preview routes for exact-out |
| Reference | GetExchangeRate | Fiat conversion |
| | GetTrailsContracts | Contract addresses per chain |
| Utility | Ping / RuntimeStatus / Clock | Health + server time |
originTokenAmount is in base units (e.g. 10000000 = 10 USDC with 6 decimals)"0x000...000" for native token addressessubmit must be imported from @bankr/cli/dist/lib/api.js (not re-exported from main entry)"destinationToAddress" to QuoteIntent to send output to a different wallet than the payerdevelopment
Trust + memory layer for Bankr agents. Write a verifiable behavioral track record (decisions, hallucinations) for free, and check the risk/reputation of any agent or token before moving money — paid over x402 on Base.
tools
Cross-chain token swaps, quotes, portfolio and prices across 14 chains via the Suwappu DEX MCP server. Read-only by default; swap execution is opt-in and gated.
development
Build, inspect, configure, and safely transact with Juicebox V6 projects, terminals, rulesets, hooks, tiered NFTs, Revnets, Croptop, Bendystraw, and omnichain deployments. Use for Juicebox protocol questions, contract addresses or ABIs, project creation, payments, cash-outs, tokenomics, hooks, NFT tiers, cross-chain bridges, loan queries, transaction decoding, and Juicebox app/UI development on Ethereum, Optimism, Base, Arbitrum, or their Sepolia testnets.
tools
LP tokenized stocks onchain — range-LP Coinbase tokenized equities (NVDA, AAPL, GOOGL, META) and AERO/USDC on Aerodrome Slipstream (Base) for trading-fee + AERO emission yield. Use when the user wants to LP stocks or Aerodrome pools on Base, open/recenter/exit a Slipstream position, check pool status, NAV, or yields, get a portfolio overview ("how are my LP positions doing?") with P&L and projected APR, run a manage pass, or set up scheduled/price-triggered LP automations in the Bankr console. Auto-routes every position to the higher-yielding side — staked (AERO emissions) vs unstaked (trading fees) — at entry and re-checks on every manage pass. Bundled node scripts do the chain reads, gate checks, and calldata; writes go via the Bankr arbitrary-transaction flow. NOT for perps, spot trading, or Uniswap.