src/cli.ts),封装了大部分模块方法,适合用于冒烟测试和在 devnet 上初始化池。CLI 不包含在发布的 npm 包中,请在 SDK 仓库的克隆中运行。
git clone https://github.com/alephium/powfi-sdk && cd powfi-sdk
bun install
bun src/cli.ts <module> <action> [args]
环境变量
| 变量 | 默认值 | 含义 |
|---|---|---|
NETWORK | devnet | mainnet、testnet 或 devnet |
PRIVATE_KEY | 无 | 签名私钥。devnet 以外必需;在 devnet 上使用内置测试钱包。 |
GROUP | 未设置 | 设置后使用 default(有分组)密钥类型,否则使用 gl-secp256k1(无分组)。 |
1.5),滑点以基点表示。
CPMM
bun src/cli.ts cpmm <A> <B> <action> [args]
| 操作 | 说明 |
|---|---|
info | 储备量和价格 |
create <amountA> <amountB> | 创建代币对并注入初始流动性 |
add <amountA> [amountB] [slippageBps] | 添加流动性。如果一侧数量为 0,CLI 会自动计算。 |
rm <percentage> [slippageBps] | 移除一定百分比的 LP 代币 |
swap <symbolIn> <amountIn> [slippageBps] | 兑换。负数表示精确输出。 |
sim-swap <symbolIn> <amountIn> | 仅报价 |
swap-to <targetPrice> [slippageBps] | 把价格推到目标值 |
CLMM
bun src/cli.ts clmm <A> <B> <configIndex> <action> [args]
| 操作 | 说明 |
|---|---|
info [priceMin] [priceMax] | 池信息,或某个区间的头寸信息 |
create <price> [amountA] [amountB] | 以指定价格创建池 |
add <priceMin> <priceMax> <amount1> [amount2] | 在价格区间内添加流动性 |
rm <priceMin> <priceMax> <percent> | 移除头寸的一定百分比 |
swap <symbolIn> <amountIn> [slippageBps] | 兑换。负数表示精确输出。 |
sim-swap <symbolIn> <amountIn> | 模拟 |
swap-to <targetPrice> | 兑换直到价格(以 A 计的 B)达到目标值 |
质押及其他
| 命令 | 说明 |
|---|---|
stake deposit <amountALPH> | 质押 ALPH 获得 xALPH |
stake donate <amountALPH> | 向 xALPH 持有者捐赠 ALPH |
stake info | xALPH 价格和你的持仓 |
token list | 显示签名器持有的、在代币列表中的代币余额 |
token ext | 显示签名器所有非零代币余额,包括未收录的代币 |
ref create [referrer] · ref info [address] | 推荐(DEX 账户)操作 |
示例(devnet)
docker compose -f docker/docker-compose.yml up -d
bun src/cli.ts stake deposit 500
bun src/cli.ts clmm ALPH xALPH 0 create 10 10 100
bun src/cli.ts clmm ALPH xALPH 0 add 5 15 1
bun src/cli.ts clmm ALPH xALPH 0 swap xALPH 0.1 100
bun src/cli.ts clmm ALPH xALPH 0 rm 5 15 50
scripts/test_cli.sh 运行一个更长的端到端流程。