Portefeuilles d'agent (mode test)

Un portefeuille d’agent (agent wallet) permet à un agent IA ou à un service automatisé d’envoyer des versements sans votre clé marchand. Vous l’approvisionnez avec une partie de votre solde, et vous donnez à l’agent une clé de portefeuille (ak_test_…) qui peut uniquement :

• lire son propre portefeuille et son solde, et
• créer des versements dans le cadre d’une politique fixe : un seul prestataire, un montant maximal par versement et une liste autorisée de numéros de bénéficiaires.

Le solde approvisionné du portefeuille est la limite totale de dépenses de l’agent. Il ne peut jamais toucher au reste de votre solde.

Vous (clé marchand)	L’agent (clé de portefeuille)
POST /v1/agent-wallets — créer avec une politique (Idempotency-Key obligatoire)	GET /v1/agent/wallet — sa politique
POST /v1/agent-wallets/{id}/fund · …/reclaim — approvisionner / reprendre l’argent non réservé	GET /v1/agent/balance
POST /v1/agent-wallets/{id}/keys — émettre une clé (affichée une seule fois)	POST /v1/agent/payouts — verser dans le cadre de la politique
POST /v1/agent-wallets/{id}/disable — bloquer les nouvelles écritures de l’agent	GET /v1/agent/payouts · …/{id}
GET /v1/agent-wallets/{id}/payouts · …/transfers · …/keys

Nouvelles tentatives sûres : action_id

Chaque versement d’agent porte un action_id fourni par votre application (par exemple l’identifiant de la tâche approuvée), et non inventé par le modèle. Xaalis associe un seul versement à chaque action_id du portefeuille : un appel d’outil relancé renvoie donc le versement d’origine au lieu de payer deux fois. Réutiliser un action_id avec un montant ou un bénéficiaire différent renvoie 409.

Limites de cette version

• Mode test uniquement : les clés de portefeuille de production (ak_live_) sont refusées.
• Désactiver un portefeuille bloque les nouvelles écritures de l’agent ; les versements déjà acceptés vont tout de même jusqu’au bout.

Le SDK TypeScript inclut des fonctions pour les portefeuilles d’agent (xaalis.agentWallets pour vous, un client d’agent avec payouts.createForAction pour l’agent), avec un exemple de gestionnaire d’outil.