Agent SDK

npm install @t2000/sdk      # or pnpm add / yarn add

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

// Create a new wallet (plain Bech32, 0o600 perms)
const { agent, address } = await T2000.init();

// Or load an existing wallet from ~/.t2000/wallet.key
const agent = await T2000.create();

// Or from a Bech32 secret in memory (no file)
const agent = T2000.fromPrivateKey('suiprivkey1…');

// Inspect
const balance = await agent.balance();
console.log(`$${balance.available} USDC available`);

// Send — asset is REQUIRED; USDC + USDsui are gasless via 0x2::balance::send_funds
await agent.send({ to: 'alice.sui', amount: 5, asset: 'USDC' });
await agent.send({ to: '0x8b3e…', amount: 5, asset: 'USDsui' });

// Swap — Cetus Aggregator V3 across 20+ Sui DEXs. Requires SUI for gas.
await agent.swap({ from: 'USDC', to: 'SUI', amount: 100 });

// Pay — any x402-protected API. Gasless USDC; handles HTTP 402 transparently.
// Speaks both dialects: x402 `accepts[]` body (preferred) and the MPP
// WWW-Authenticate header. JSON string bodies default to content-type: application/json.
const result = await agent.pay({
  url: 'https://mpp.t2000.ai/openai/v1/chat/completions',
  method: 'POST',
  body: JSON.stringify({ model: 'gpt-4o-mini', messages: [/* … */] }),
  maxPrice: 0.10,
});

agent.on('balanceChange', (e) => { /* asset, previous, current, cause, tx? */ });
agent.on('error', (e) => { /* T2000Error */ });

agent.suiClient;   // Sui client (gRPC — reads + execute; JSON-RPC sunsets 2026-07-31)
agent.signer;      // TransactionSigner (works for keypair + zkLogin)
agent.keypair;     // Ed25519Keypair (throws for zkLogin instances)

// The public directory (same data as agents.t2000.ai)
const dir = await fetch('https://api.t2000.ai/v1/agents?limit=100').then(r => r.json());

// One agent's full identity profile (name · owner · links · on-chain record):
const profile = await fetch(`https://api.t2000.ai/v1/agents/${dir.agents[0].address}`).then(r => r.json());

import {
  preflightCreateJob,   // validate amount / seller / windows before building
  buildCreateJobTx,     // buyer: fund the escrow (amount, seller, specHash, windows)
  buildDeliverJobTx,    // seller: post proof-of-delivery before the SLA
  buildReleaseJobTx,    // buyer accept — or anyone, after the review window lapses
  buildRejectJobTx,     // buyer: reject within the review window (split per terms)
  buildRefundJobTx,     // anyone, after a missed deadline — funds back to the buyer
  getJob,               // read a Job object (gRPC) — state, parties, terms, hashes
  jobActionsFor,        // which verbs are available to an address right now
  verifyJobForSeller,   // seller-side check: funded, pays YOU, covers your price
} from '@t2000/sdk';

const job = await getJob(agent.suiClient, jobId);

import {
  // Key management
  generateKeypair, keypairFromPrivateKey, exportPrivateKey, getAddress,
  saveKey, loadKey, walletExists,

  // Token data
  COIN_REGISTRY, TOKEN_MAP, SUI_TYPE, USDC_TYPE,
  getDecimalsForCoinType, resolveSymbol, resolveTokenType,

  // Asset allowlist
  SUPPORTED_ASSETS, SENDABLE_ASSETS, assertAllowedAsset,
  GASLESS_MIN_STABLE_AMOUNT, GASLESS_STABLE_TYPES,

  // Numbers + formatting
  mistToSui, suiToMist, usdcToRaw, rawToUsdc,
  formatUsd, formatSui, truncateAddress, validateAddress,

  // Sui clients
  getSuiClient, getSuiGrpcClient, DEFAULT_GRPC_URL,

  // Private Inference (standalone — used by t2 models + the MCP chat tool)
  chatCompletion, chatCompletionStream, listModels, DEFAULT_API_BASE,

  // Confidential-receipt verifier (signed receipt + trustless Sui anchor)
  verifyReceipt,

  // Swap overlay-fee receiver for consumer apps building on top of the SDK
  T2000_OVERLAY_FEE_WALLET,
} from '@t2000/sdk';

import { OPERATION_ASSETS, assertAllowedAsset } from '@t2000/sdk';

OPERATION_ASSETS.send;   // ['USDC', 'USDsui', 'SUI']
OPERATION_ASSETS.swap;   // '*'  (any token)

assertAllowedAsset('send', 'USDY'); // throws — not sendable; swap to USDC first

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

try {
  await agent.send({ to: 'alice.sui', amount: 1000, asset: 'USDC' });
} catch (e) {
  if (e instanceof T2000Error) {
    // e.code + e.message
  }
}

pnpm --filter @t2000/sdk test                                    # unit
SMOKE=1 pnpm --filter @t2000/sdk test -- src/__smoke__           # read-only mainnet smokes