Skip to main content
Ce guide utilise le testnet : votre premier swap ne coûte rien de réel. Obtenez des ALPH de testnet gratuits via le faucet :
Pour passer en production, remplacez networkId par 'mainnet' et choisissez un token qui a un pool sur le mainnet. Les swaps sur le mainnet dépensent des fonds réels.
Nécessite Node.js 20+ (ou Bun 1.0+).
1

Installer

Créez un nouveau projet en module ES (les extraits utilisent un await de premier niveau) :
Ajoutez aussi @alephium/web3-wallet si vous signez depuis un backend avec une clé privée.Placez les extraits ci-dessous dans un seul fichier index.ts, dans l’ordre, et exécutez-le avec npx tsx index.ts (ou bun index.ts).
2

Charger le SDK (lecture seule)

Aucun signataire n’est nécessaire pour lire les pools ou calculer des cotations. Les adresses des contrats pour mainnet, testnet et devnet sont incluses dans le package.
3

Lire un pool CPMM et coter un swap

computeSwapAmount est une fonction pure : après un seul appel à getPoolState, vous pouvez recoter à chaque frappe sans toucher au réseau.
4

Ajouter un signataire et swapper

Dans un navigateur, passez le SignerProvider du wallet (par exemple issu de @alephium/web3-react) au lieu d’un PrivateKeyWallet.
5

Attendre la confirmation

Étapes suivantes

SDK TypeScript

Initialisation du SDK, rôle de chaque module et pièges courants.

Swapper sur CLMM

Coter à partir d’une courbe de liquidité simulée, puis exécuter avec une limite de prix.

Montants et slippage

Unités bigint, décimales et application du slippage en points de base.

Staker de l'ALPH

Minter du xALPH et gérer les demandes d’unstake.