> ## 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.

# Demarrage rapide

> Integrez AgentWallex en moins de 5 minutes — creez un portefeuille d'agent et envoyez votre premier paiement.

## Prerequis

* Node.js 18+ ou Python 3.9+
* Une cle API AgentWallex (`awx_...`) — [inscrivez-vous pour un acces anticipe](https://agentwallex.com)
* Comprehension basique des transactions blockchain

## Installation

<CodeGroup>
  ```bash npm theme={null}
  npm install @agentwallex/sdk
  ```

  ```bash yarn theme={null}
  yarn add @agentwallex/sdk
  ```

  ```bash pnpm theme={null}
  pnpm add @agentwallex/sdk
  ```

  ```bash pip theme={null}
  pip install agentwallex
  ```
</CodeGroup>

## Integration etape par etape

<Steps>
  <Step title="Initialiser le client">
    Creez un client AgentWallex avec votre cle API. Utilisez `sandbox` pour les tests et `production` pour le mainnet.

    <CodeGroup>
      ```typescript TypeScript theme={null}
      import { AgentWallex } from "@agentwallex/sdk";

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

      ```python Python theme={null}
      from agentwallex import AgentWallex

      aw = AgentWallex(
          api_key=os.environ["AGENTWALLEX_API_KEY"],
          environment="sandbox",  # use "production" for mainnet
      )
      ```
    </CodeGroup>
  </Step>

  <Step title="Creer un portefeuille d'agent">
    Chaque agent obtient son propre portefeuille securise par MPC avec des politiques configurables.

    <CodeGroup>
      ```typescript TypeScript theme={null}
      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}`);
      ```

      ```python Python theme={null}
      agent = await aw.agents.create(
          name="my-trading-agent",
          chain="eip155:84532",
          policies={
              "max_transaction_amount": "100",
              "daily_limit": "1000",
              "allowed_addresses": ["0x..."],
          },
      )

      print(f"Agent ID: {agent.id}")
      print(f"Wallet: {agent.wallet.address}")
      ```
    </CodeGroup>
  </Step>

  <Step title="Alimenter le portefeuille">
    Envoyez des jetons testnet a l'adresse du portefeuille de votre agent. Sur Base Sepolia, vous pouvez utiliser un [faucet](https://www.coinbase.com/faucets/base-ethereum-goerli-faucet) pour obtenir des USDC de test.

    <Note>
      En mode sandbox, le portefeuille de votre agent est sur un testnet. Aucun fonds reel n'est en danger.
    </Note>
  </Step>

  <Step title="Envoyer un paiement">
    Executez un paiement on-chain via l'agent.

    <CodeGroup>
      ```typescript TypeScript theme={null}
      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"
      ```

      ```python Python theme={null}
      tx = await aw.payments.send(
          agent_id=agent.id,
          to="0xRecipientAddress",
          amount="10.00",
          token="USDC",
      )

      print(f"Transaction hash: {tx.hash}")
      print(f"Status: {tx.status}")  # "confirmed"
      ```
    </CodeGroup>
  </Step>
</Steps>

## 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

<CardGroup cols={2}>
  <Card title="SDK TypeScript" icon="js" href="/fr/sdks/typescript">
    Reference complete du SDK avec toutes les methodes et types.
  </Card>

  <Card title="API REST" icon="code" href="/fr/api-reference/overview">
    Points de terminaison HTTP pour les integrations personnalisees.
  </Card>

  <Card title="Micropaiements x402" icon="credit-card" href="/fr/features/x402-micropayments">
    Activez le paiement par appel d'API pour vos agents.
  </Card>

  <Card title="Moteur de politiques" icon="shield-check" href="/fr/features/policy-engine">
    Configurez les controles de depenses et les regles de securite.
  </Card>
</CardGroup>