CLAUDE.md

1# Swapper AI Agent Toolkit
2 
3This repository contains the Swapper AI Agent Toolkit — skills that give AI agents the ability to deposit funds, swap tokens, and manage wallets in DeFi.
4 
5## What is Swapper Finance?
6 
7Swapper Finance is the payment infrastructure layer for Web3. It lets users and agents deposit funds into DeFi protocols via payment cards (Mastercard, Visa, Apple Pay, Google Pay), crypto transfers, and wallet connections. Supports 170+ countries. Cross-chain via Chainlink CCIP. End-to-end orchestration via Chainlink CRE. Card processing via Mastercard.
8 
9## Repository structure
10 
11```
12skills/
13  swapper-deposit/    # Deposit and bridge funds into DeFi
14    skill.md          # Skill definition (read by agents)
15  swapper-trade/       # Token swap skill (coming soon)
16    skill.md
17  swapper-wallet/     # Wallet management skill (coming soon)
18    skill.md
19CLAUDE.md             # This file (read by Claude Code automatically)
20README.md             # Repository overview
21package.json          # Skill pack metadata
22```
23 
24## How the deposit skill works
25 
261. Agent calls `/swapper-deposit` with wallet address, chain, token
272. Skill generates a Swapper deposit deeplink with correct parameters
283. Deeplink opens in user's browser
294. User completes deposit via Swapper widget (card, transfer, or wallet)
305. Funds land in the target wallet or protocol on the target chain
31 
32The skill does NOT execute transactions — it generates a link. The user always confirms.
33 
34## Deeplink format
35 
36```
37https://deposit.swapper.finance?integratorId=d6e438dfa14e80709b19&dstChainId=CHAIN_ID&dstTokenAddr=TOKEN_ADDR&depositWalletAddress=WALLET_ADDR&utm_source=swapper-deposit&extendedView=true
38```
39 
40- `integratorId` is always `d6e438dfa14e80709b19` (hardcoded)
41- For native tokens (ETH, POL, BNB), use `0x0000000000000000000000000000000000000000` as token address
42 
43## Supported chains
44 
45| Chain       | Chain ID |
46|-------------|----------|
47| Ethereum    | 1        |
48| Base        | 8453     |
49| Arbitrum    | 42161    |
50| Optimism    | 10       |
51| Polygon     | 137      |
52| Fast        | fast     |
53| Solana      | solana   |
54| HyperEVM   | 999      |
55| BNB Chain   | 56       |
56| Avalanche   | 43114    |
57 
58## Safety rules
59 
60- Every transaction requires explicit user confirmation
61- Never auto-approve transactions
62- Always surface fees and risks before confirmation
63- Never store or access private keys
64- Always display the full deeplink URL so user can verify