Skip to main content
本指南使用 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 并管理解除质押请求。