skills.rest
Lightupwrld
LightupwrldCOMMUNITY
Explore all skills by this author →
GitHub

swap-tokens

Generate server-side token swap code using Circle App Kit or Swap Kit SDKs.

1|Updated Jul 20, 2026
Search Tags:#stablecoin#defi#usdc#token swap#cross-chain bridge#circle app kit#swap kit
One-click install
npx skills add https://github.com/Lightupwrld/Cycuxio --skill swap-tokens-lightupwrld
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: swap-tokens
Source: https://github.com/Lightupwrld/Cycuxio/tree/main/.agents/skills/swap-tokens
Command: npx skills add https://github.com/Lightupwrld/Cycuxio --skill swap-tokens-lightupwrld

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @circle-fin/app-kit, @circle-fin/swap-kit, @circle-fin/adapter-viem-v2, @circle-fin/adapter-solana-kit, @circle-fin/adapter-circle-wallets, viem, and includes references (resource) components.

What problem does it solve? Building token swap functionality requires choosing the right Circle SDK, configuring wallet adapters, and handling slippage, fees, and cross-chain routing correctly. This Skill guides the AI through a structured decision process and generates correct, secure swap integration code. ## Core Features & Use Cases - SDK Selection Guidance: Walks through a Decision Guide to choose between App Kit (swap + bridge + send) and standalone Swap Kit (swap-only). - Multi-Adapter Support: Generates swap code for Viem private key wallets, Solana Kit wallets, and Circle developer-controlled wallets. - Advanced Swap Configuration: Covers rate estimation, slippage tolerance, stop limits, custom developer fees, and multi-step cross-chain swap + bridge patterns. - Use Case: A developer wants to let users convert USDT to USDC on Ethereum from a backend service. The Skill asks the right questions, then generates a complete server-side script using App Kit with the Viem adapter, including estimation and error handling. ## Quick Start Ask the AI to build a token swap that converts USDT to USDC on Ethereum using Circle App Kit with a private key wallet.

Frequently Asked Questions about swap-tokens

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I swap tokens with Circle App Kit?▼

Install @circle-fin/app-kit with a wallet adapter, create a kit key in the Circle Developer Console, then call kit.swap() with the chain, tokenIn, tokenOut, and amountIn. Swaps run server-side only because the kit key cannot be exposed to client code.

What is the difference between Circle App Kit and Swap Kit?▼

App Kit (@circle-fin/app-kit) is an all-inclusive SDK covering swap, bridge, and send, while Swap Kit (@circle-fin/swap-kit) is a lighter standalone package for swap-only use cases. App Kit is recommended unless you are certain you will never need bridge or send.

Which chains and tokens does Circle swap support?▼

Swaps run on mainnet chains including Ethereum, Base, Arbitrum, Solana, and Polygon, plus Arc Testnet. Supported token aliases include USDC, EURC, USDT, PYUSD, DAI, WBTC, WETH, and WSOL, and any token can be specified by contract address.

Can I use Circle swap with a browser wallet like MetaMask?▼

No. Swap requires a kit key, which is a server-side-only credential, so client-side wallet connections like wagmi or ConnectKit are not supported. Use the Viem private key adapter, Solana Kit adapter, or Circle developer-controlled wallets instead.

How do I set slippage or a minimum output for a swap?▼

Set slippageBps in the swap config for a relative tolerance in basis points, or set stopLimit for an absolute minimum output amount. When both are provided, stopLimit takes precedence over slippageBps.

How do I move tokens cross-chain with Circle SDKs?▼

Cross-chain movement uses App Kit only, combining separate swap and bridge calls since bridge supports USDC only. Swap the source token to USDC, bridge USDC to the destination chain, then swap to the target token if needed.

Related Skills

Explore More Software Engineering Skills→
levantuylevantuy
3

swap-tokens

Generate server-side token swap code using Circle App Kit or Swap Kit SDKs.

Community
Advanced
LumenWipeLumenWipe
3

soroswap-sdk

Build Soroswap DEX token swaps and liquidity transactions on Stellar.

Official
Advanced
LuisSambranoLuisSambrano
7

celo-bridge

Bridge assets between Celo and Ethereum using native and third-party solutions.

Community
Intermediate
RHEcosystemAppEngRHEcosystemAppEng
48

validate-environment

Validate OpenShift tool installations, cluster connectivity, and permissions.

Official
Basic