Documentation Index
Fetch the complete documentation index at: https://docs.agentwallex.com/llms.txt
Use this file to discover all available pages before exploring further.
Presentation
Le moteur de politiques evalue chaque transaction avant qu’elle n’atteigne la couche de signature MPC. Les politiques sont definies par agent et peuvent etre mises a jour a tout moment via le SDK ou l’API REST. La premiere violation de politique arrete immediatement la transaction.
Types de politiques
Limites de depenses
Controlez combien un agent peut depenser :
await aw.policies.update("agent_abc123", {
maxTransactionAmount: "500", // Max per single transaction (USDC)
dailyLimit: "5000", // Rolling 24-hour total
monthlyLimit: "50000", // Rolling 30-day total
});
| Regle | Description | Fenetre |
|---|
maxTransactionAmount | Montant maximum pour un seul paiement | Par transaction |
dailyLimit | Total maximum sur 24 heures glissantes | Fenetre glissante |
monthlyLimit | Total maximum sur 30 jours glissants | Fenetre glissante |
Controles d’adresses
Restreignez les adresses auxquelles un agent peut envoyer :
await aw.policies.update("agent_abc123", {
// Whitelist mode: only send to these addresses
allowedAddresses: [
"0xTrustedVendor1",
"0xTrustedVendor2",
"0xTrustedExchange",
],
// Blacklist mode: block specific addresses
blockedAddresses: [
"0xKnownScam",
],
});
Si allowedAddresses est defini, seules ces adresses sont autorisees. Si allowedAddresses et blockedAddresses sont definis simultanement, allowedAddresses a la priorite.
Controles de jetons
Restreignez les jetons avec lesquels un agent peut effectuer des transactions :
await aw.policies.update("agent_abc123", {
allowedTokens: ["USDC", "USDT"], // Only stablecoins
});
Controles de velocite
Limitez la frequence des transactions pour empecher les agents incontroles :
await aw.policies.update("agent_abc123", {
velocityLimit: {
maxCount: 100, // Max number of transactions
windowSeconds: 3600, // Per hour
},
});
Controles temporels
Restreignez les moments ou les transactions peuvent avoir lieu :
await aw.policies.update("agent_abc123", {
schedule: {
timezone: "America/New_York",
allowedHours: { start: 9, end: 17 }, // 9 AM - 5 PM
allowedDays: [1, 2, 3, 4, 5], // Monday - Friday
},
});
Approbation humaine
Acheminez les transactions de haute valeur vers une revision humaine :
await aw.policies.update("agent_abc123", {
requireHumanApproval: true,
humanApprovalThreshold: "1000", // Transactions above $1000
approvalTimeout: 3600, // 1 hour to approve before auto-reject
approvers: [
"user_admin1@company.com",
"user_admin2@company.com",
],
});
L’approbation humaine est disponible sur les plans Growth et Enterprise. Lorsqu’une transaction necessite une approbation, un evenement webhook est envoye et la transaction entre dans l’etat pending_approval.
Ordre d’evaluation des politiques
Les politiques sont verifiees dans cet ordre. Le premier echec arrete la transaction :
Statut de l'agent
L’agent est-il actif (non gele) ?
Verification du jeton
Ce jeton est-il dans la liste allowedTokens ?
Verification de l'adresse
Le destinataire est-il dans allowedAddresses et pas dans blockedAddresses ?
Verification du montant
Cela depasse-t-il maxTransactionAmount ?
Limite quotidienne
Cela depasserait-il le total quotidien glissant ?
Limite mensuelle
Cela depasserait-il le total mensuel glissant ?
Verification de velocite
L’agent a-t-il depasse son taux de transactions (velocityLimit) ?
Verification de planification
Est-ce dans les heures et jours autorises ?
Approbation humaine
Cela necessite-t-il une revision humaine basee sur le seuil ?
Filet de securite d'infrastructure
Limites strictes appliquees par Paratro (ne peuvent pas etre outrepassees).
Evenements de violation de politique
Lorsqu’une politique bloque une transaction, l’API renvoie une erreur detaillee :
{
"code": "policy_violation",
"type": "invalid_request_error",
"message": "Transaction would exceed daily limit"
}
await aw.webhooks.create({
url: "https://your-app.com/webhooks",
events: ["policy.violated"],
});
Modeles de politiques
Utilisez des modeles pour les configurations courantes :
// Conservative: tight limits for testing
await aw.policies.applyTemplate("agent_abc123", "conservative");
// Standard: balanced limits for production
await aw.policies.applyTemplate("agent_abc123", "standard");
// Custom: define and reuse your own templates
await aw.policies.createTemplate("my-template", {
maxTransactionAmount: "200",
dailyLimit: "2000",
allowedTokens: ["USDC"],
velocityLimit: { maxCount: 50, windowSeconds: 3600 },
});
await aw.policies.applyTemplate("agent_abc123", "my-template");
Bonnes pratiques
Commencez de maniere restrictive, elargissez progressivement. Demarrez avec des limites strictes et augmentez-les a mesure que vous gagnez confiance dans le comportement de votre agent.
- Utilisez allowedAddresses — Mettez en liste blanche les adresses de confiance plutot que de vous fier uniquement aux limites de montant.
- Activez l’approbation humaine pour les montants eleves — Definissez un seuil au-dessus duquel les humains revisent les transactions.
- Surveillez les violations de politiques — Suivez les violations via les webhooks pour identifier les agents mal configures.
- Utilisez les limites de velocite — Empchez les boucles incontroles ou un agent tente des transactions de maniere repetee.
- Revisez les politiques chaque semaine — A mesure que les comportements des agents evoluent, mettez a jour les politiques en consequence.
