> ## Documentation Index
> Fetch the complete documentation index at: https://docs.powfi.alephium.org/llms.txt
> Use this file to discover all available pages before exploring further.

# SDK et API

> Développez sur Powfi, le protocole DeFi d'Alephium : swaps, liquidité concentrée et à produit constant, et staking liquide xALPH.

Powfi propose aujourd'hui une seule surface d'intégration : le **SDK TypeScript** (`@alephium/powfi-sdk`). Il encapsule les smart contracts Powfi sur Alephium (pools CPMM, pools CLMM et staking xALPH), calcule les cotations localement, puis construit et signe les transactions via n'importe quel signataire `@alephium/web3`.

## À qui s'adresse ce chapitre

* **Développeurs de wallets et de frontends** qui veulent coter et exécuter des swaps, afficher les données des pools ou permettre aux utilisateurs de fournir de la liquidité.
* **Développeurs backend et de bots** qui font du market making, de l'arbitrage ou de l'automatisation de trésorerie sur les pools Powfi.
* **Agrégateurs et intégrateurs** qui routent des flux via Powfi, avec éventuellement des [frais d'intégrateur](/fr/guides/integrator-fees).

<Info>
  **Envie de lancer quelque chose tout de suite ?** Le [Démarrage rapide](/fr/quickstart) lit un pool CPMM sur le testnet et cote un swap en une vingtaine de lignes, sans signataire.
</Info>

## Choisir votre mode d'intégration

| Vous développez | Utilisez | Pourquoi |
| - | - | - |
| Une interface de swap ou un wallet | `powfi.cpmm` / `powfi.clmm` + fonctions de cotation statiques | Cotations locales (pas de RPC à chaque frappe), transactions indépendantes du signataire |
| Un bot de trading ou un backend | `Powfi.load({ networkId, signer })` avec un `PrivateKeyWallet` | Contrôle total du slippage, des échéances et du choix de route |
| Un gestionnaire de liquidité CLMM | `powfi.clmm` + [`TickUtils`](/fr/utilities/tick-utils) + [`ClmmLiquidityUtils`](/fr/utilities/liquidity-utils) | Conversion prix ↔ tick et calculs de position identiques à l'arrondi on-chain |
| Une intégration de staking | `powfi.staking` | Staker de l'ALPH contre du xALPH, gérer les demandes d'unstake |
| Ce que les modules ne couvrent pas | Les [artefacts de contrats](/fr/reference/contracts) réexportés | Accès direct et typé à chaque contrat et script Powfi |

En cas de doute, commencez par les façades de modules (`powfi.cpmm`, `powfi.clmm`, `powfi.staking`). Ne descendez aux bindings de contrats bruts que lorsque vous avez besoin d'une méthode que le SDK n'encapsule pas.

## Composants du protocole

<CardGroup cols={2}>
  <Card title="CPMM" icon="scale-balanced" href="/fr/modules/cpmm">
    Pools à produit constant (x·y=k) avec des frais de swap de 0,3 % et des jetons LP fongibles.
  </Card>

  <Card title="CLMM" icon="chart-area" href="/fr/modules/clmm">
    Pools à liquidité concentrée (style Uniswap V3) avec paliers de frais, plages de ticks et récompenses de farming.
  </Card>

  <Card title="Staking" icon="coins" href="/fr/modules/staking">
    Stakez de l'ALPH contre du xALPH liquide, et retirez-le au fil de son déblocage.
  </Card>

  <Card title="Liste de jetons" icon="list" href="/fr/modules/token">
    Métadonnées des jetons (symbole, décimales, logo) issues de la liste de jetons Alephium, avec cache.
  </Card>
</CardGroup>

## Pour aller plus loin

<CardGroup cols={3}>
  <Card title="Démarrage rapide" icon="rocket" href="/fr/quickstart">
    Installer, charger, coter, swapper.
  </Card>

  <Card title="SDK TypeScript" icon="code" href="/fr/typescript-sdk">
    Initialisation, façades de modules, résultats de transaction, pièges courants.
  </Card>

  <Card title="Guides" icon="book-open" href="/fr/guides/cpmm-swap">
    Recettes complètes pour les tâches courantes.
  </Card>
</CardGroup>

<Note>
  **Versions.** Tous les exemples de code de ce chapitre ciblent `@alephium/powfi-sdk@1.0.2` (`@alephium/web3@3.0.3`). Lorsque le SDK évolue, les pages sont revérifiées et cette mention est mise à jour. Si un exemple échoue sur une version plus récente, consultez d'abord le [changelog sur GitHub](https://github.com/alephium/powfi-sdk).
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.