Crear una billetera de agente
Cada agente obtiene su propia billetera con seguridad MPC. Especifique la cadena y las políticas iniciales al momento de la creación.
const agent = await aw.agents.create({
name: "payment-agent",
chain: "eip155:8453", // Base mainnet
policies: {
maxTransactionAmount: "500",
dailyLimit: "5000",
allowedTokens: ["USDC"],
},
metadata: { team: "growth" },
});
console.log(`Agent ID: ${agent.id}`);
console.log(`Wallet address: ${agent.wallet.address}`);
console.log(`Chain: ${agent.wallet.chain}`);
Fondear la billetera
Envíe tokens a la dirección de billetera del agente. La dirección de billetera es una dirección on-chain estándar que puede recibir tokens de cualquier fuente.
En modo sandbox (eip155:84532), use un faucet de testnet para obtener tokens de prueba. No se necesitan fondos reales.
curl -X POST https://api.agentwallex.com/api/v1/x402/balances/deposit-address \
-H "X-API-Key: awx_your_api_key" \
-H "Content-Type: application/json" \
-d '{"agent_id": "agent_abc123", "chain": "eip155:8453"}'
Enviar un pago
Ejecute un pago on-chain a través del agente. La transacción pasa por el motor de políticas y la firma MPC antes de la difusión.
const tx = await aw.payments.send({
agentId: "agent_abc123",
to: "0xRecipientAddress",
amount: "50.00",
token: "USDC",
memo: "Payment for API access",
});
console.log(`Transaction ID: ${tx.id}`);
console.log(`Hash: ${tx.hash}`);
console.log(`Status: ${tx.status}`); // "pending" -> "confirmed"
console.log(`Fee: ${tx.fee}`); // Network gas fee
Consultar saldo
Consulte el saldo x402 de un agente:
curl -X GET https://api.agentwallex.com/api/v1/x402/balances \
-H "X-API-Key: awx_your_api_key"
Listar transacciones
Vea el historial de transacciones de un agente:
const { transactions } = await aw.payments.list({
agentId: "agent_abc123",
limit: 50,
status: "confirmed",
});
transactions.forEach(tx => {
console.log(`${tx.amount} ${tx.token} -> ${tx.to} (${tx.status})`);
});
Congelar y descongelar
Detenga instantáneamente todas las transacciones de un agente. Útil para emergencias o mantenimiento programado.
Congelar
await aw.agents.freeze("agent_abc123");
// All transactions are now blocked
Descongelar
// Subject to 10-minute cool-down after freeze
await aw.agents.unfreeze("agent_abc123");
Hay un período obligatorio de enfriamiento de 10 minutos después de congelar antes de que pueda descongelar. Intentar descongelar antes devolverá un error.
Eliminar un agente
Elimine permanentemente un agente y su billetera. Esta acción es irreversible.
curl -X DELETE https://api.agentwallex.com/api/v1/agents/agent_abc123 \
-H "X-API-Key: awx_your_api_key"
Asegúrese de que el saldo de la billetera sea cero antes de eliminar. Cualquier fondo restante será inaccesible después de la eliminación.
