Imported from roohe/agentic-super-skills (skills_library/emblem-token-swap/SKILL.md). Install upstream with npx skills add roohe/agentic-super-skills --skill emblem-token-swap. Copyright stays with the author (MIT).

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

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

npm install -g @emblemvault/agentwallet

# Solana swap (uses splBuyIntent)
emblemai --agent --profile default -m "Use splBuyIntent to swap 5 SOL for USDC on Solana"

# Cross-chain bridge (uses ChangeNow)
emblemai --agent --profile default -m "Use getChangeNowSwapQuote to get a quote for bridging 0.05 ETH from Ethereum to SOL on Solana"

Trigger phrases:

• "Swap SOL to USDC"
• "Exchange ETH for USDT"
• "Convert my tokens"
• "Bridge tokens to Base"

Workflow: Safe Token Swap

Step 1: Check Balance

Confirm you have enough of the source token.

emblemai --agent --profile default -m "Use solanaBalances to show my Solana token balances"

Step 2: Get a Quote

Preview the swap before executing.

emblemai --agent --profile default -m "Use splBuyIntent to get a quote for swapping 5 SOL to USDC"

Step 3: Execute the Swap

emblemai --agent --profile default -m "Use splBuyIntent to swap 5 SOL for USDC on Solana"

Safe mode requires your confirmation before executing.

Step 4: Verify

Confirm the new balance.

emblemai --agent --profile default -m "Use solanaBalances to show my updated balances"

Swap Patterns

Solana Swaps

# By token amount
emblemai --agent --profile default -m "Use splBuyIntent to swap 0.5 SOL for USDC"

# By dollar amount
emblemai --agent --profile default -m "Use splBuyIntent to swap $20 of SOL for JUP"

# By token name
emblemai --agent --profile default -m "Use splBuyIntent to swap 100 USDC for BONK"

EVM Swaps

# Ethereum
emblemai --agent --profile default -m "Use ethSwapQuote to get a quote for swapping 0.01 ETH to USDC, then use ethSwap to execute"

# Base
emblemai --agent --profile default -m "Use baseSwapQuote to quote 0.005 ETH to USDC on Base"

# BSC
emblemai --agent --profile default -m "Use bscSwapQuote to quote 0.1 BNB to USDT on BSC"

# Polygon
emblemai --agent --profile default -m "Use polygonSwapQuote to quote 10 POL to USDC on Polygon"

Hedera Swaps

emblemai --agent --profile default -m "Use hederaTokensSwapQuote to get a quote for 100 HBAR to USDC, then use hederaTokensSwap to execute"

Cross-Chain Bridge

emblemai --agent --profile default -m "Use getChangeNowSwapQuote to quote bridging 0.1 ETH to SOL"
emblemai --agent --profile default -m "Use getChangeNowSupportedCurrencies to show available bridge currencies"

Communication Rules

Always include these in swap requests:

1. Tool name — specify the exact tool for reliable routing
2. Amount — dollar value or token quantity
3. Source token — what you're swapping from
4. Target token — what you're swapping to

Safety

All swaps require explicit user confirmation (safe mode). The agent will:

1. Show you the swap details (amount, route, estimated output)
2. Wait for your approval before executing
3. Report the transaction result

Never bypasses confirmation for any value-moving operation.

Helper Script

bash scripts/swap-helper.sh

See scripts/swap-helper.sh for an interactive swap walkthrough.

Links

• Agent Wallet CLI
• EmblemVault Docs — canonical
• EmblemVault Docs — interactive