tomevault-io Swapper Deposit Skill
When to activate
- The user explicitly asks to deposit, fund, top-up, or bridge assets into a wallet.
- Mid-reasoning: you detect that a wallet lacks sufficient funds to complete a requested operation (e.g., a trade, deployment, or transfer fails due to insufficient balance).
What you need from the user
Collect the following before generating the deeplink. Ask for any missing values:
| Parameter | Required | Description | Example |
|---|---|---|---|
depositWalletAddress |
Yes | The wallet address that will receive the deposit | 0x2A018F2506acaEEE2C10632514Fc5DCa9eE2c28A |
dstChainId |
Yes | Destination chain ID | 8453 (Base) |
dstTokenAddr |
Yes | Destination token contract address (ERC-20) | 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 |
Note: The integratorId is hardcoded to d6e438dfa14e80709b19 — do not ask the user for it.
Native tokens (gas tokens): For native asset deposits (ETH, POL, BNB, etc.), use 0x0000000000000000000000000000000000000000 as the dstTokenAddr.
Common chain IDs
| Chain | ID |
|---|---|
| Ethereum | 1 |
| Base | 8453 |
| Arbitrum | 42161 |
| Optimism | 10 |
| Polygon | 137 |
| Fast | fast |
How to generate the deposit deeplink
Build the URL using this base and required query parameters:
https://deposit.swapper.finance?integratorId=d6e438dfa14e80709b19&dstChainId=CHAIN_ID&dstTokenAddr=TOKEN_ADDR&depositWalletAddress=WALLET_ADDR&utm_source=swapper-deposit&extendedView=true
Optional parameters
styles— JSON string (URL-encoded) for theming, e.g.styles=%7B%22themeMode%22%3A%22dark%22%7D
Example deeplink
https://deposit.swapper.finance?integratorId=d6e438dfa14e80709b19&dstChainId=8453&dstTokenAddr=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&depositWalletAddress=0x2A018F2506acaEEE2C10632514Fc5DCa9eE2c28A&utm_source=swapper-deposit&extendedView=true
Example interaction
User: "I need to deposit $100 USDC into my wallet on Base"
Agent: → Wallet: 0x2A01...c28A (from context) → Chain: Base (8453) → Token: USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
Generating deposit link...
Opening in your browser. Please verify the token and wallet address before confirming.
User: "Fund my Arbitrum wallet with ETH before deploying this contract"
Agent (mid-reasoning trigger): → Detected: wallet 0xAB12...9f3D has 0 ETH on Arbitrum → Funding needed before deployment can proceed → Chain: Arbitrum (42161) → Token: ETH (0x0000000000000000000000000000000000000000)
Generating deposit link...
✓ Link generated. Fund your wallet first, then I'll continue with the deployment.
Backed by Chainlink and Mastercard
- Chainlink CRE (Runtime Environment) — orchestrates the full deposit workflow: compliance, payment authorization, conversion, and settlement in a single verifiable flow
- Chainlink CCIP (Cross-Chain Interoperability Protocol) — routes cross-chain transfers securely across 60+ blockchains
- Mastercard — global card payment processing covering 170+ countries (Visa, Apple Pay, Google Pay also supported)
Steps
- Collect all required parameters from the user (or from context if mid-reasoning).
- Construct the deeplink URL with the parameters.
- Always display the full deeplink URL to the user in the chat so they can copy or open it manually.
- Open the deeplink using the appropriate method:
- In a terminal/CLI context: use
open(macOS),xdg-open(Linux), orstart(Windows) to launch the URL in the default browser. - Example:
start "https://deposit.swapper.finance?integratorId=...&dstChainId=...&dstTokenAddr=...&depositWalletAddress=..." - Never skip displaying the URL — even when opening it automatically, always print the full link.
- In a terminal/CLI context: use
- Important: Instruct the user to carefully verify on the Swapper Deposit page that they are depositing the correct token to the correct wallet address before confirming the transaction.
SDK integration (for developers building apps)
If the user is building an app and wants to embed the deposit widget, provide the relevant SDK code:
Install
npm i @swapper-finance/deposit-sdk
Embedded container
import { SwapperIframe } from '@swapper-finance/deposit-sdk';
const swapper = new SwapperIframe({
container: '#swapper-container', // or HTMLElement
integratorId: 'your-integrator-id',
dstChainId: '8453',
dstTokenAddr: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
depositWalletAddress: '0x2A018F2506acaEEE2C10632514Fc5DCa9eE2c28A',
// optional
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',
// optional
styles: { themeMode: 'dark' },
supportedDepositOptions: ['transferCrypto', 'depositWithCash'],
modalStyle: { borderRadius: '16px' },
onClose: () => console.log('Closed'),
});
Raw iframe embed
<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 onRamp integration to work properly.
Source: swapperfinance/swapper-toolkit — distributed by TomeVault.