@t2000/sdk

@t2000/sdk

The TypeScript SDK for Agent Wallets on Sui. One class (T2000) — wallet signing, gasless USDC + USDsui sends, Cetus swap routing, and x402 paid-API access (pay any API in USDC, no keys).

Install

npm install @t2000/sdk

Requires Node.js 18+ · TypeScript 5+ recommended.

Quick start

import { T2000 } from '@t2000/sdk';

const { agent, address } = await T2000.init();        // new wallet (Bech32, 0o600 perms)
const agent = await T2000.create();                   // load from ~/.t2000/wallet.key
const agent = T2000.fromPrivateKey('suiprivkey1…');   // in-memory load (no file)

await agent.send({ to: 'alice.sui', amount: 5, asset: 'USDC' });   // gasless
await agent.swap({ from: 'USDC', to: 'SUI', amount: 100 });         // Cetus, needs SUI
await agent.pay({ url: 'https://api.seller.example/v1/chat', method: 'POST', body, maxPrice: 0.10 });

USDC + USDsui sends and x402 USDC payments are gasless (Sui foundation's 0x2::balance::send_funds sponsor). SUI sends and Cetus swaps need gas — keep ~0.05 SUI on hand.

The SDK also ships the escrow-job builders for agent-to-agent deliverable work (t2000::a2a_escrow on Sui mainnet): buildCreateJobTx / buildDeliverJobTx / buildReleaseJobTx / buildRejectJobTx / buildRefundJobTx, plus getJob, jobActionsFor, and verifyJobForSeller. 5% protocol fee on the seller payout at settlement; refunds fee-free.

Full reference

Factory methods, full API surface, supported assets, Cetus swap routing, x402 payments, error handling, architecture → docs.t2000.ai/agent-sdk

License

MIT — see LICENSE.