Emblem Token Swap

by emblemcompany9a68a35c4d61MIT12 starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 4 months ago

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.

Includes scriptsBusiness & Finance
AI-generated overview

Guided token swaps and cross-chain bridges across six blockchains via the EmblemAI agent wallet CLI.

What it does
This skill guides an agent through quoting and executing cryptocurrency token swaps on Solana, Ethereum, Base, BSC, Polygon and Hedera, plus cross-chain bridging through ChangeNow. It documents per-chain quote, swap, balance and token-search tools, and prescribes a four-step workflow: check balance, get a quote, execute the swap, then verify the new balance. It also ships an interactive walkthrough script, scripts/swap-helper.sh, and requires explicit user confirmation before any value-moving operation.
When to use it
Use it when a user wants to swap or exchange tokens, convert between cryptocurrencies, or bridge assets across chains. It fits requests such as swapping SOL for USDC, quoting an ETH-to-USDC swap on Base, or bridging ETH to SOL.
Requirements
Node.js 18.0.0 or newer, the @emblemvault/agentwallet CLI installed globally via npm, and internet access. It ships an executable helper script (scripts/swap-helper.sh) and works with agents following the Agent Skills spec.

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

ChainQuote ToolSwap ToolBalance ToolToken Search
SolanasplBuyIntent (quote mode)splBuyIntent (swap mode)solanaBalancesfindSolanaSwapToken
EthereumethSwapQuoteethSwapethGetBalancessearchCryptoByName
BasebaseSwapQuotebaseSwapbaseGetBalancessearchEvmTokensBirdeye
BSCbscSwapQuotebscSwapbscGetBalancessearchEvmTokensBirdeye
PolygonpolygonSwapQuotepolygonSwappolygonGetBalancessearchEvmTokensBirdeye
HederahederaTokensSwapQuotehederaTokensSwaphederaGetBalanceshederaFindTokens
Cross-chaingetChangeNowSwapQuoteswapUsingChangeNow—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 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.

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

Step 2: Get a Quote

Preview the swap before executing.

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

Step 3: Execute the Swap

bash
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.

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

Swap Patterns

Solana Swaps

bash
# By token amountemblemai --agent --profile default -m "Use splBuyIntent to swap 0.5 SOL for USDC"
# By dollar amountemblemai --agent --profile default -m "Use splBuyIntent to swap $20 of SOL for JUP"
# By token nameemblemai --agent --profile default -m "Use splBuyIntent to swap 100 USDC for BONK"

EVM Swaps

bash
# Ethereumemblemai --agent --profile default -m "Use ethSwapQuote to get a quote for swapping 0.01 ETH to USDC, then use ethSwap to execute"
# Baseemblemai --agent --profile default -m "Use baseSwapQuote to quote 0.005 ETH to USDC on Base"
# BSCemblemai --agent --profile default -m "Use bscSwapQuote to quote 0.1 BNB to USDT on BSC"
# Polygonemblemai --agent --profile default -m "Use polygonSwapQuote to quote 10 POL to USDC on Polygon"

Hedera Swaps

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

Cross-Chain Bridge

bash
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
BadGood
"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:

  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
bash scripts/swap-helper.sh

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


Links

Source and attribution

Source:emblemcompany/agent-skillsinskills/emblem-token-swapat commit9a68a35

License: MIT

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal