a2a-swap-cli

P2P OTC token swaps for AI agents and humans. No DEX, no slippage, no MEV.

What is this?

a2a-swap-cli is a CLI and SDK for trustless OTC token swaps on Base chain.

• CREATE2 escrow per trade -- tokens are locked before the contract is even deployed
• Offchain matching -- fast discovery, zero gas for browsing
• Reputation gating -- sellers choose who can accept their offers
• Two swap modes: Direct offers and RFQ (Request for Quote)

Install

npm install a2a-swap

Add your wallet private key to .env:

# Wallet (use --wallet mykey)
PRIVATE_KEY_MYKEY=0x...

Usage

npx a2a-swap <command> [options]

All commands require --wallet <name> to select a wallet from .env.

---

Commands

Swap Flow

propose -- Create a new OTC offer

Computes a CREATE2 escrow address and transfers your sell tokens to it.

npx a2a-swap propose --sell "1000 tUSDC" --buy "0.5 tWETH" --wallet test1
npx a2a-swap propose --sell "1000 tUSDC" --buy "0.5 tWETH" --min-score 3 --wallet test1

Option	Required	Default	Description
--sell <amount token>	Yes	--	Amount and token to sell
--buy <amount token>	Yes	--	Amount and token to buy
--min-score <n>	No	0	Minimum buyer reputation score
--duration <seconds>	No	3600	Offer duration (max 30 days)
--chain <chain>	No	base	Target chain
--wallet <name>	Yes	--	Named wallet from .env

accept <id> -- Accept an open offer

Deploys the escrow contract and transfers your buy tokens to it. Settlement happens automatically.

npx a2a-swap accept 42 --wallet test2

cancel <id> -- Cancel an offer

Free if still open. Reputation penalty (-2) if already matched.

npx a2a-swap cancel 42 --wallet test1

---

RFQ Flow

rfq -- Broadcast a Request for Quote

Post what you need and your budget. Other agents/users submit competing quotes.

npx a2a-swap rfq --need "1 tWETH" --budget "2200 tUSDC" --wallet test1

Option	Required	Default	Description
--need <amount token>	Yes	--	Token and amount needed
--budget <amount token>	Yes	--	Max willing to pay
--min-score <n>	No	0	Minimum quoter reputation score
--duration <seconds>	No	3600	RFQ duration
--chain <chain>	No	base	Target chain
--wallet <name>	Yes	--	Named wallet from .env

quote <rfq-id> -- Submit a quote

npx a2a-swap quote 7 --offer "0.9 tWETH" --wallet test2

quotes <rfq-id> -- List quotes

npx a2a-swap quotes 7

pick <rfq-id> <quote-id> -- Accept a quote

npx a2a-swap pick 7 3 --wallet test1

---

Discovery

list -- View open offers

npx a2a-swap list
npx a2a-swap list --chain base

watch -- Poll for new offers

npx a2a-swap watch
npx a2a-swap watch --interval 5

history -- View past trades

npx a2a-swap history --wallet test1
npx a2a-swap history --wallet test1 --limit 50

trust <address> -- Check reputation

npx a2a-swap trust 0x1234...abcd

---

SDK

import { A2ASwap } from "a2a-swap"

const otc = new A2ASwap()

// Create an offer
const offer = await otc.propose({
  seller: "0x...",
  sellToken: "0x...",
  sellAmount: "1000000000000000000",
  buyToken: "0x...",
  buyAmount: "500000000000000000",
  minScore: 3,
})

// Accept an offer
const result = await otc.accept(offer.offerId, "0xBuyerAddress")

// RFQ flow
const rfq = await otc.createRfq({ ... })
const quotes = await otc.listQuotes(rfq.rfqId)
await otc.pickQuote(rfq.rfqId, quotes[0].id)

// Query
const rep = await otc.getReputation("0x...")
const trades = await otc.getHistory("0x...", 20)
const offers = await otc.listOffers("base")

---

Reputation System

Event	Score Delta
Successful swap	+1 (both sides)
Buyer timeout (no deposit)	-3 (buyer)
Post-match cancellation	-2 (canceller)

score = successful_swaps - (failed_swaps * 3) - (cancellations * 2)

Sellers set --min-score to filter out low-reputation buyers.

Utility

unwrap -- Convert WETH back to ETH

npx a2a-swap unwrap --wallet test1
npx a2a-swap unwrap --wallet test1 --amount 0.5

Option	Required	Default	Description
--amount <ether>	No	all	Amount to unwrap
--chain <chain>	No	base	Target chain
--wallet <name>	Yes	--	Named wallet from .env

---

Native ETH Support

Use ETH as a token symbol. The CLI auto-wraps ETH → WETH before escrow deposit and auto-unwraps after settlement.

npx a2a-swap propose --sell "0.5 ETH" --buy "1000 USDC" --wallet test1
npx a2a-swap unwrap --wallet test1   # manual unwrap if needed

---

Supported Tokens

Base Sepolia (Testnet)

Symbol	Decimals	Address
USDC	6	0x036CbD53842c5426634e7929541eC2318f3dCF7e
WETH	18	0x4200000000000000000000000000000000000006
DAI	18	0x7683022d84F726a96c4A6611cD31DBf5409c0Ac9
tUSDC	18	0xc210208ee5Ad77FFa7E0eB0690f74a2E269d42b2
tWETH	18	0x4322cB832Ab806cC123540428125a92180725a23

Base (Mainnet)

Symbol	Decimals	Address
USDC	6	0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
WETH	18	0x4200000000000000000000000000000000000006
DAI	18	0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb

You can also pass raw token addresses instead of symbols:

npx a2a-swap propose --sell "1000 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" --buy "0.5 WETH" --wallet test1

---

Architecture

Seller CLI ──> API Server ──> Supabase (offers, quotes, reputation)
Buyer  CLI ──> API Server ──> Operator EOA (CREATE2 deploy + settle)
                          ──> Base chain (TradeEscrow contracts)

How a trade works:

1. Seller runs propose -> API computes CREATE2 escrow address -> Seller sends tokens to that address
2. Buyer runs accept -> API validates reputation + deploys escrow -> Buyer sends tokens to escrow
3. Operator detects both deposits -> calls settle() -> tokens swapped, 0.1% fee deducted

---

Project Structure

src/
  cli/commands/       CLI command implementations
  sdk/index.ts        SDK (A2ASwap class)
  api.ts              API client with signature auth
  config.ts           Environment config
  contract.ts         ethers.js signer/provider
  sign.ts             EIP-191 request signing
  tokens.ts           Token symbol/address/decimals registry
  weth.ts             ETH wrap/unwrap operations
  poll.ts             Settlement polling + auto-unwrap

License

MIT