Emblem Token Swap
Run guided multi-chain token swaps and balance checks through the EmblemAI agent wallet CLI while building crypto or agent-wallet features.
Overview
Emblem Token Swap is an agent skill for the Build phase that walks the EmblemAI CLI through multi-chain balance checks and token swaps using named chain tools.
Install
npx skills add https://github.com/emblemcompany/agent-skills --skill emblem-token-swapWhat is this skill?
- Walks balances across Solana, Ethereum, Base, BSC, Polygon, and Hedera via one agent message
- Documents per-chain swap commands (splBuyIntent, ethSwap, baseSwap, bscSwap, polygonSwap, hederaTokensSwap)
- Includes cross-chain bridge quoting with getChangeNowSwapQuote
- Requires global @emblemvault/agentwallet CLI and names exact tool identifiers in prompts
- Bash helper script (swap-helper.sh) prints step-by-step CLI invocations for agents
- 7 chain-specific swap command families documented
- 2-step helper flow: balances then swap commands
Adoption & trust: 8.5k installs on skills.sh; 10 GitHub stars; 1/3 security scanners passed (skills.sh audits).
What problem does it solve?
You need your agent to swap or bridge assets on several chains but keep forgetting the exact emblemai tool names and message patterns.
Who is it for?
Indie builders already using EmblemAI agent wallets who want copy-paste swap flows across Solana, EVM L2s, BSC, Polygon, and Hedera.
Skip if: Products with no on-chain payments, teams that cannot install a global npm CLI, or anyone who needs custody or compliance sign-off beyond what their own review provides.
When should I use this skill?
You are implementing or debugging token swaps through EmblemAI and want the agent to use explicit tool names per chain.
What do I get? / Deliverables
Your agent runs a consistent balance-then-swap script with chain-specific commands and bridge quotes instead of improvising wallet calls.
- Executed or templated emblemai balance and swap command sequences
- Chain-specific swap intent prompts ready for agent replay
Recommended Skills
Journey fit
Token swap orchestration is an integration task you wire into the product during the build phase, not a launch or growth playbook. The skill shells out to emblemai with chain-specific swap intents, which is classic third-party and wallet integration work.
How it compares
Use as a chain-specific CLI recipe skill, not as a generic DEX SDK or a hosted swap MCP server.
Common Questions / FAQ
Who is emblem-token-swap for?
Solo and indie builders integrating EmblemAI agent wallets into CLIs or agents who need standardized swap and balance prompts across multiple chains.
When should I use emblem-token-swap?
During Build integrations when you are wiring wallet automation, testing small mainnet or testnet swaps, or documenting how your agent should call splBuyIntent, ethSwap, baseSwap, or bridge quotes.
Is emblem-token-swap safe to install?
Swaps move real funds when you use funded profiles; review the Security Audits panel on this Prism page and never paste seed phrases into agent chats.
SKILL.md
READMESKILL.md - Emblem Token Swap
#!/bin/bash # swap-helper.sh - Token swap walkthrough via EmblemAI # Usage: bash scripts/swap-helper.sh set -e echo "Token Swap Helper" echo "==================================================" if ! command -v emblemai &> /dev/null; then echo "Error: emblemai CLI not found" echo "Install with: npm install -g @emblemvault/agentwallet" exit 1 fi echo "" echo "Step 1: Current Balances" echo "------------------------" emblemai --agent --profile default -m "Show my balances with USD values. Use solanaBalances, ethGetBalances, baseGetBalances, bscGetBalances, polygonGetBalances, hederaGetBalances, getBTCBalances" echo "" echo "Step 2: Swap Commands by Chain" echo "------------------------------" echo "" echo " Solana: emblemai --agent --profile default -m 'Use splBuyIntent to swap 5 SOL for USDC'" echo " Ethereum: emblemai --agent --profile default -m 'Use ethSwap to swap 0.01 ETH for USDC'" echo " Base: emblemai --agent --profile default -m 'Use baseSwap to swap 0.005 ETH for USDC'" echo " BSC: emblemai --agent --profile default -m 'Use bscSwap to swap 0.1 BNB for USDT'" echo " Polygon: emblemai --agent --profile default -m 'Use polygonSwap to swap 10 POL for USDC'" echo " Hedera: emblemai --agent --profile default -m 'Use hederaTokensSwap to swap 100 HBAR for USDC'" echo " Bridge: emblemai --agent --profile default -m 'Use getChangeNowSwapQuote to bridge 0.05 ETH to SOL'" echo "" echo "Tips:" echo " - Name the exact tool for reliable routing" echo " - Safe mode will ask for confirmation before executing" echo " - Solana splBuyIntent supports \$USD, SOL, or token amounts" echo "" echo "==================================================" --- name: emblem-token-swap description: > Execute token swaps across 6 blockchains via EmblemAI. Automatic route optimization and cross-chain bridging via ChangeNow. Use when the user wants to swap tokens, exchange crypto, convert between currencies, or bridge assets cross-chain. license: MIT compatibility: > Requires Node.js >= 18.0.0, @emblemvault/agentwallet CLI, and internet access. Works on Claude Code, Cursor, Codex, OpenClaw, and other agents following the Agent Skills spec. metadata: author: EmblemAI version: "1.1.0" homepage: https://emblemvault.ai docs: https://emblemvault.ai/docs docs-interactive: https://emblemvault.dev --- # Emblem Token Swap Guided token swapping powered by **EmblemAI**. Swap tokens on Solana, Ethereum, Base, BSC, Polygon, and Hedera with automatic routing. Cross-chain bridging via ChangeNow. **Requires**: `npm install -g @emblemvault/agentwallet` --- ## What This Skill Can Do | Chain | Quote Tool | Swap Tool | Balance Tool | Token Search | |-------|-----------|-----------|-------------|--------------| | Solana | `splBuyIntent` (quote mode) | `splBuyIntent` (swap mode) | `solanaBalances` | `findSolanaSwapToken` | | Ethereum | `ethSwapQuote` | `ethSwap` | `ethGetBalances` | `searchCryptoByName` | | Base | `baseSwapQuote` | `baseSwap` | `baseGetBalances` | `searchEvmTokensBirdeye` | | BSC | `bscSwapQuote` | `bscSwap` | `bscGetBalances` | `searchEvmTokensBirdeye` | | Polygon | `polygonSwapQuote` | `polygonSwap` | `polygonGetBalances` | `searchEvmTokensBirdeye` | | Hedera | `hederaTokensSwapQuote` | `hederaTokensSwap` | `hederaGetBalances` | `hederaFindTokens` | | Cross-chain | `getChangeNowSwapQuote` | `swapUsingChangeNow` | — | `getChangeNowSupportedCurrencies` | ### Notes - **Solana** uses `splBuyIntent` for both quotes and execution — it handles token lookup by name/symbol/CA and flexible amounts ($USD, SOL, or token quantity) - **EVM chains** (Ethereum, Base, BSC, Polygon) route through automatic DEX aggregation - **Cross-chain** bridges via ChangeNow support 500+ currencies - Bitcoin has balance support (`getBTCBalances`) but no on-chain swap tools — use ChangeNow for BTC bridges --- ## Quick Start ```bash npm install -g @emblemvault/agentwallet # Solana swap (uses splBuyInten