Passer au contenu principal

​
Prerequis

​
Installation

npm install @agentwallex/sdk

​
Integration etape par etape

1

Initialiser le client

Creez un client AgentWallex avec votre cle API. Utilisez sandbox pour les tests et production pour le mainnet.
import { AgentWallex } from "@agentwallex/sdk";

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

Creer un portefeuille d'agent

Chaque agent obtient son propre portefeuille securise par MPC avec des politiques 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

Alimenter le portefeuille

Envoyez des jetons testnet a l’adresse du portefeuille de votre agent. Sur Base Sepolia, vous pouvez utiliser un faucet pour obtenir des USDC de test.
En mode sandbox, le portefeuille de votre agent est sur un testnet. Aucun fonds reel n’est en danger.
4

Envoyer un paiement

Executez un paiement on-chain via l’agent.
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"

​
Ce qui se passe en coulisses

  1. Verification de politique — Le moteur de politiques valide la transaction par rapport aux regles de votre agent (limites de depenses, liste blanche d’adresses, controles de velocite).
  2. Signature MPC — La transaction est signee en utilisant le MPC a seuil 2-sur-3. Aucune partie ne detient jamais la cle complete.
  3. Diffusion — La transaction signee est soumise au reseau.
  4. Confirmation — AgentWallex surveille et confirme la transaction, puis delivre un evenement webhook.

​
Prochaines etapes

SDK TypeScript

Reference complete du SDK avec toutes les methodes et types.

API REST

Points de terminaison HTTP pour les integrations personnalisees.

Micropaiements x402

Activez le paiement par appel d’API pour vos agents.

Moteur de politiques

Configurez les controles de depenses et les regles de securite.