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 Ajoutez aussi
await de premier niveau) :@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)
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
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.