emblem-token-swap

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

npm install -g @emblemvault/agentwallet
 
# Solana swap (uses splBuyIntent)
emblemai --agent --profile default -m "Use splBuyIntent to swap 5 SOL for USDC 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.

Step 2: Get a Quote

Preview the swap before executing.

Step 3: Execute the Swap

Safe mode requires your confirmation before executing.

Step 4: Verify

Confirm the new balance.

Swap Patterns

Solana Swaps

EVM Swaps

Hedera Swaps

Cross-Chain Bridge

Communication Rules

Always include these in swap requests:

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

Bad	Good
`"swap sol usdc"`	`"Use splBuyIntent to swap 5 SOL for USDC"`
`"buy eth"`	`"Use ethSwap to swap 100 USDC to ETH on Ethereum"`
`"bridge"`	`"Use getChangeNowSwapQuote to bridge 0.05 ETH to SOL"`

Safety

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

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

Never bypasses confirmation for any value-moving operation.

Helper Script

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