@agentwallex/sdk

TypeScript SDK for AgentWallex — the financial control platform for the agent economy.

Zero dependencies. Works with Node.js 18+ (native fetch).

Installation

npm install @agentwallex/sdk

Quick Start

import { AgentWallex } from '@agentwallex/sdk';

const awx = new AgentWallex({ apiKey: 'awx_sk_live_...' });

// Create an agent
const agent = await awx.agents.create({
  agent_name: 'research-bot',
  chain: 'base',
  agent_description: 'Autonomous research agent',
});

// Transfer USDC
const tx = await awx.agents.transfer(agent.agent_id, {
  amount: '25.00',
  to_address: '0xRecipient...',
  chain: 'base',
});

// Check balance
const balances = await awx.agents.getBalance(agent.agent_id);
for (const b of balances) {
  console.log(`${b.chain}: ${b.available} available`);
}

Resources

| Resource | Description | |----------|-------------| | awx.agents | Create, list, update, and delete AI agents | | awx.account | Account info, top-up, and platform balance | | awx.transactions | Query and filter transaction history | | awx.policies | Create and manage spending policies | | awx.policyTemplates | Browse and apply pre-built policy templates | | awx.approvals | Review and action pending approval requests | | awx.apiKeys | Manage API keys for programmatic access | | awx.webhooks | Configure webhook endpoints and delivery | | awx.paymentMethods | Manage payment methods for top-ups | | awx.x402Resources | Register and manage x402 paid API endpoints |

Multi-Chain Support

AgentWallex supports the following chains:

• Base — Fast, low-cost L2
• Ethereum — Mainnet
• BSC — Binance Smart Chain
• Tron — TRC-20 transfers
• Polygon — Polygon PoS
• Solana — SPL token transfers

Configuration

// Production (default)
const awx = new AgentWallex({ apiKey: 'awx_sk_live_...' });

// Sandbox
const sandbox = new AgentWallex({
  apiKey: 'awx_sk_test_...',
  sandbox: true,
});

// Advanced options
const awx = new AgentWallex({
  apiKey: 'awx_sk_live_...',
  baseURL: 'https://custom.api/v1',
  timeout: 30000,
  maxRetries: 2,
});

Error Handling

import { AgentWallex, NotFoundError, PaymentRequiredError, RateLimitError } from '@agentwallex/sdk';

try {
  await awx.agents.retrieve('nonexistent');
} catch (err) {
  if (err instanceof NotFoundError) console.log('Not found');
  if (err instanceof RateLimitError) console.log('Rate limited — will auto-retry');
}

Auto-Pagination

import { autoPaginate } from '@agentwallex/sdk';

for await (const agent of autoPaginate((p) => awx.agents.list(p))) {
  console.log(agent.agent_name);
}

Links

• Documentation
• Dashboard
• Website

License

MIT