Creer un portefeuille d’agent
Chaque agent obtient son propre portefeuille securise par MPC. Specifiez la chaine et les politiques initiales lors de la creation.
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}`);
Alimenter le portefeuille
Envoyez des jetons a l’adresse du portefeuille de l’agent. L’adresse du portefeuille est une adresse on-chain standard qui peut recevoir des jetons de n’importe quelle source.
En mode sandbox (eip155:84532), utilisez un faucet testnet pour obtenir des jetons de test. Aucun fonds reel n’est necessaire.
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"}'
Envoyer un paiement
Executez un paiement on-chain via l’agent. La transaction passe par le moteur de politiques et la signature MPC avant la diffusion.
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
Verifier le solde
Interrogez le solde x402 d’un agent :
curl -X GET https://api.agentwallex.com/api/v1/x402/balances \
-H "X-API-Key: awx_your_api_key"
Lister les transactions
Consultez l’historique des transactions d’un agent :
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})`);
});
Geler et degeler
Arretez instantanement toutes les transactions d’un agent. Utile pour les urgences ou la maintenance planifiee.
Geler
await aw.agents.freeze("agent_abc123");
// All transactions are now blocked
Degeler
// Subject to 10-minute cool-down after freeze
await aw.agents.unfreeze("agent_abc123");
Il y a une periode de refroidissement obligatoire de 10 minutes apres le gel avant que vous puissiez degeler. Tenter de degeler plus tot renverra une erreur.
Supprimer un agent
Supprimez definitivement un agent et son portefeuille. Cette action est irreversible.
curl -X DELETE https://api.agentwallex.com/api/v1/agents/agent_abc123 \
-H "X-API-Key: awx_your_api_key"
Assurez-vous que le solde du portefeuille est a zero avant la suppression. Tous les fonds restants seront inaccessibles apres la suppression.
