本指南使用 testnet,第一笔兑换不会花费真实资产。从水龙头领取免费的测试网 ALPH:正式使用时,把
networkId 改为 'mainnet',并换成在主网上有池子的代币。主网兑换会花费真实资金。需要 Node.js 20+(或 Bun 1.0+)。
1
安装
以 ES module 方式新建项目(示例代码使用了顶层 如果要在后端用私钥签名,还需安装
await):@alephium/web3-wallet。把下面各步的代码按顺序写进同一个 index.ts,用 npx tsx index.ts(或 bun index.ts)运行。2
加载 SDK(只读)
mainnet、testnet 和 devnet 的合约地址已打包在 SDK 中。3
读取 CPMM 池并获取兑换报价
computeSwapAmount 是纯函数:调用一次 getPoolState 之后,每次按键都可以重新报价,而无需访问网络。4
设置签名器并兑换
SignerProvider(例如来自 @alephium/web3-react),而不是 PrivateKeyWallet。5
等待确认
下一步
TypeScript SDK
SDK 如何初始化、各模块的作用,以及常见陷阱。
在 CLMM 上兑换
用模拟得到的流动性曲线报价,再带价格限制执行。
数量与滑点
bigint 单位、精度,以及基点滑点的计算方式。
质押 ALPH
铸造 xALPH 并管理解除质押请求。