Skills

Swapper Toolkit is a skill pack that gives AI agents and coding assistants the ability to perform DeFi operations — depositing funds, bridging assets across chains, and managing crypto wallets — directly from your development environment.

It works with Claude Code, Cursor, Windsurf, OpenClaw, CrewAI, AutoGPT, and other AI agent frameworks.

---

Installation

Install the full toolkit with a single command:

npx skills add swapperfinance/swapper-toolkit

Once installed, skills are available as slash commands in your AI assistant.

---

Available Skills

/swapper-deposit

Deposit and bridge funds into a wallet or protocol using Swapper Finance.

Triggers when:

• You ask to deposit, fund, top-up, or bridge assets into a wallet.

• The agent detects mid-task that a wallet has insufficient funds, missing tokens, or needs funding before another operation can proceed.

Capabilities:

• Direct deposits to any wallet address

• Cross-chain bridge transfers (Ethereum, Base, Arbitrum, Optimism, Polygon, Fast, and more)

• Protocol deposits — lending, staking, liquidity pools

• Fiat on-ramp funding (where supported)

Example usage:

/swapper-deposit

The skill will collect the required information (wallet address, destination chain, and token), then generate a deposit deeplink and open it in your browser.

Supported chains:

Chain	Chain ID
Ethereum	1
Base	8453
Arbitrum	42161
Optimism	10
Polygon	137
Fast	fast
Solana	solana
HyperEVM	999
BNB Chain	56
Avalanche	43114

---

SDK Integration

If you're building an application and want to embed the deposit flow directly, the skill can also generate SDK integration code for you.

Install the SDK

npm i @swapper-finance/deposit-sdk

Embedded container

import { SwapperIframe } from "@swapper-finance/deposit-sdk";

const swapper = new SwapperIframe({
  container: "#swapper-container", // CSS selector or HTMLElement
  integratorId: "your-integrator-id",
  dstChainId: "8453",
  dstTokenAddr: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  depositWalletAddress: "0x2A018F2506acaEEE2C10632514Fc5DCa9eE2c28A",
  styles: { themeMode: "light" },
  supportedDepositOptions: ["transferCrypto", "depositWithCash"],
});

Modal popup

import { openSwapperModal } from "@swapper-finance/deposit-sdk";

const modal = openSwapperModal({
  integratorId: "your-integrator-id",
  dstChainId: "8453",
  dstTokenAddr: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  depositWalletAddress: "0x2A018F2506acaEEE2C10632514Fc5DCa9eE2c28A",
  styles: { themeMode: "dark" },
  supportedDepositOptions: ["transferCrypto", "depositWithCash"],
  modalStyle: { borderRadius: "16px" },
  onClose: () => console.log("Closed"),
});

Raw iframe

<iframe
  src="https://deposit.swapper.finance?integratorId=YOUR_ID&dstChainId=8453&dstTokenAddr=0x...&depositWalletAddress=0x..."
  title="Swapper Deposits Widget"
  allow="camera"
  sandbox="allow-forms allow-modals allow-popups allow-popups-to-escape-sandbox allow-same-origin allow-scripts"
></iframe>

Both the allow and sandbox attributes are required for the on-ramp integration to work properly.

---

Safety

All skills enforce strict safety rules:

• Explicit confirmation — Every transaction requires user approval before execution. Nothing is auto-approved.

• Transparent fees — Slippage, gas fees, and risks are surfaced before you confirm.

• Key security — Private keys and mnemonics are never stored in plain text.

---

More Skills

More skills are coming soon — including trade execution and wallet management. Follow the swapper-toolkit repository for updates.