emblem-token-swap

Files (2)

• SKILL.md
• swap-helper.sh · scripts/

SKILL.md (first lines)

# 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 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 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
```bash
# 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
```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"
```

---

From EmblemCompany/Agent-skills, MIT.

More from EmblemCompany/Agent-skills