Saltar al contenido principal

​
Requisitos previos

​
Instalación

npm install @agentwallex/sdk

​
Integración paso a paso

1

Inicializar el cliente

Cree un cliente AgentWallex con su clave API. Use sandbox para pruebas y production para mainnet.
import { AgentWallex } from "@agentwallex/sdk";

const aw = new AgentWallex({
  apiKey: process.env.AGENTWALLEX_API_KEY!,
  environment: "sandbox", // use "production" for mainnet
});
2

Crear una billetera de agente

Cada agente obtiene su propia billetera con seguridad MPC y políticas configurables.
const agent = await aw.agents.create({
  name: "my-trading-agent",
  chain: "eip155:84532",
  policies: {
    maxTransactionAmount: "100",   // USDC
    dailyLimit: "1000",
    allowedAddresses: ["0x..."],
  },
});

console.log(`Agent ID: ${agent.id}`);
console.log(`Wallet: ${agent.wallet.address}`);
3

Fondear la billetera

Envíe tokens de testnet a la dirección de billetera de su agente. En Base Sepolia, puede usar un faucet para obtener USDC de prueba.
En modo sandbox, la billetera de su agente está en una testnet. No hay fondos reales en riesgo.
4

Enviar un pago

Ejecute un pago on-chain a través del agente.
const tx = await aw.payments.send({
  agentId: agent.id,
  to: "0xRecipientAddress",
  amount: "10.00",
  token: "USDC",
});

console.log(`Transaction hash: ${tx.hash}`);
console.log(`Status: ${tx.status}`); // "confirmed"

​
Qué sucede internamente

  1. Verificación de políticas — El motor de políticas valida la transacción contra las reglas de su agente (límites de gasto, lista blanca de direcciones, controles de velocidad).
  2. Firma MPC — La transacción se firma mediante MPC de umbral 2-de-3. Ninguna parte individual posee jamás la clave completa.
  3. Difusión — La transacción firmada se envía a la red.
  4. Confirmación — AgentWallex monitorea y confirma la transacción, luego entrega un evento webhook.

​
Próximos pasos

SDK de TypeScript

Referencia completa del SDK con todos los métodos y tipos.

API REST

Endpoints HTTP para integraciones personalizadas.

Micropagos x402

Habilite el pago por llamada a API para sus agentes.

Motor de políticas

Configure controles de gasto y reglas de seguridad.