Emblem Token Swap

1---2name: emblem-token-swap3description: >4  Execute token swaps across 6 blockchains via EmblemAI. Automatic route optimization and5  cross-chain bridging via ChangeNow. Use when the user wants to swap tokens, exchange crypto,6  convert between currencies, or bridge assets cross-chain.7license: MIT8compatibility: >9  Requires Node.js >= 18.0.0, @emblemvault/agentwallet CLI, and internet access.10  Works on Claude Code, Cursor, Codex, OpenClaw, and other agents following the Agent Skills spec.11metadata:12  author: EmblemAI13  version: "1.1.0"14  homepage: https://emblemvault.dev15---16 17# Emblem Token Swap18 19Guided token swapping powered by **EmblemAI**. Swap tokens on Solana, Ethereum, Base, BSC, Polygon, and Hedera with automatic routing. Cross-chain bridging via ChangeNow.20 21**Requires**: `npm install -g @emblemvault/agentwallet`22 23---24 25## What This Skill Can Do26 27| Chain | Quote Tool | Swap Tool | Balance Tool | Token Search |28|-------|-----------|-----------|-------------|--------------|29| Solana | `splBuyIntent` (quote mode) | `splBuyIntent` (swap mode) | `solanaBalances` | `findSolanaSwapToken` |30| Ethereum | `ethSwapQuote` | `ethSwap` | `ethGetBalances` | `searchCryptoByName` |31| Base | `baseSwapQuote` | `baseSwap` | `baseGetBalances` | `searchEvmTokensBirdeye` |32| BSC | `bscSwapQuote` | `bscSwap` | `bscGetBalances` | `searchEvmTokensBirdeye` |33| Polygon | `polygonSwapQuote` | `polygonSwap` | `polygonGetBalances` | `searchEvmTokensBirdeye` |34| Hedera | `hederaTokensSwapQuote` | `hederaTokensSwap` | `hederaGetBalances` | `hederaFindTokens` |35| Cross-chain | `getChangeNowSwapQuote` | `swapUsingChangeNow` | — | `getChangeNowSupportedCurrencies` |36 37### Notes38 39- **Solana** uses `splBuyIntent` for both quotes and execution — it handles token lookup by name/symbol/CA and flexible amounts ($USD, SOL, or token quantity)40- **EVM chains** (Ethereum, Base, BSC, Polygon) route through automatic DEX aggregation41- **Cross-chain** bridges via ChangeNow support 500+ currencies42- Bitcoin has balance support (`getBTCBalances`) but no on-chain swap tools — use ChangeNow for BTC bridges43 44---45 46## Quick Start47 48```bash49npm install -g @emblemvault/agentwallet50 51# Solana swap (uses splBuyIntent)52emblemai --agent --profile default -m "Use splBuyIntent to swap 5 SOL for USDC on Solana"53 54# Cross-chain bridge (uses ChangeNow)55emblemai --agent --profile default -m "Use getChangeNowSwapQuote to get a quote for bridging 0.05 ETH from Ethereum to SOL on Solana"56```57 58**Trigger phrases:**59- "Swap SOL to USDC"60- "Exchange ETH for USDT"61- "Convert my tokens"62- "Bridge tokens to Base"63 64---65 66## Workflow: Safe Token Swap67 68### Step 1: Check Balance69Confirm you have enough of the source token.70```bash71emblemai --agent --profile default -m "Use solanaBalances to show my Solana token balances"72```73 74### Step 2: Get a Quote75Preview the swap before executing.76```bash77emblemai --agent --profile default -m "Use splBuyIntent to get a quote for swapping 5 SOL to USDC"78```79 80### Step 3: Execute the Swap81```bash82emblemai --agent --profile default -m "Use splBuyIntent to swap 5 SOL for USDC on Solana"83```84Safe mode requires your confirmation before executing.85 86### Step 4: Verify87Confirm the new balance.88```bash89emblemai --agent --profile default -m "Use solanaBalances to show my updated balances"90```91 92---93 94## Swap Patterns95 96### Solana Swaps97```bash98# By token amount99emblemai --agent --profile default -m "Use splBuyIntent to swap 0.5 SOL for USDC"100 101# By dollar amount102emblemai --agent --profile default -m "Use splBuyIntent to swap $20 of SOL for JUP"103 104# By token name105emblemai --agent --profile default -m "Use splBuyIntent to swap 100 USDC for BONK"106```107 108### EVM Swaps109```bash110# Ethereum111emblemai --agent --profile default -m "Use ethSwapQuote to get a quote for swapping 0.01 ETH to USDC, then use ethSwap to execute"112 113# Base114emblemai --agent --profile default -m "Use baseSwapQuote to quote 0.005 ETH to USDC on Base"115 116# BSC117emblemai --agent --profile default -m "Use bscSwapQuote to quote 0.1 BNB to USDT on BSC"118 119# Polygon120emblemai --agent --profile default -m "Use polygonSwapQuote to quote 10 POL to USDC on Polygon"121```122 123### Hedera Swaps124```bash125emblemai --agent --profile default -m "Use hederaTokensSwapQuote to get a quote for 100 HBAR to USDC, then use hederaTokensSwap to execute"126```127 128### Cross-Chain Bridge129```bash130emblemai --agent --profile default -m "Use getChangeNowSwapQuote to quote bridging 0.1 ETH to SOL"131emblemai --agent --profile default -m "Use getChangeNowSupportedCurrencies to show available bridge currencies"132```133 134---135 136## Communication Rules137 138**Always include these in swap requests:**1391. **Tool name** — specify the exact tool for reliable routing1402. **Amount** — dollar value or token quantity1413. **Source token** — what you're swapping from1424. **Target token** — what you're swapping to143 144| Bad | Good |145|-----|------|146| `"swap sol usdc"` | `"Use splBuyIntent to swap 5 SOL for USDC"` |147| `"buy eth"` | `"Use ethSwap to swap 100 USDC to ETH on Ethereum"` |148| `"bridge"` | `"Use getChangeNowSwapQuote to bridge 0.05 ETH to SOL"` |149 150---151 152## Safety153 154All swaps require explicit user confirmation (safe mode). The agent will:1551. Show you the swap details (amount, route, estimated output)1562. Wait for your approval before executing1573. Report the transaction result158 159Never bypasses confirmation for any value-moving operation.160 161---162 163## Helper Script164 165```bash166bash scripts/swap-helper.sh167```168 169See [scripts/swap-helper.sh](scripts/swap-helper.sh) for an interactive swap walkthrough.170 171---172 173## Links174 175- [Agent Wallet CLI](https://www.npmjs.com/package/@emblemvault/agentwallet)176- [EmblemVault Docs](https://emblemvault.dev)