AMM 兑换与流动性
D9Amm 提供原生 D9 与已登记 USDT 之间的恒定乘积兑换池。所有报价与滑点计算均须使用 bigint 整数运算。
读取资金池状态
Section titled “读取资金池状态”请在同一个最终确认区块上读取以下存储项:
| 存储 | 返回值 |
|---|---|
D9Amm::D9Reserve |
D9 储备量(12 位小数) |
D9Amm::UsdtReserve |
USDT 储备量(6 位小数) |
D9Amm::FeePercent |
兑换手续费,单位为基点(30 = 0.30%) |
D9Amm::TotalLpTokens |
LP 份额总发行量 |
D9Amm::LiquidityProviders(account) |
指定账户持有的 LP 份额 |
1. 计算兑换报价
Section titled “1. 计算兑换报价”给定输入数量 amountIn、两侧储备 reserveIn 与 reserveOut 以及以基点计的手续费 feeBps:
function quoteSwapOutput( amountIn: bigint, reserveIn: bigint, reserveOut: bigint, feeBps: bigint,): bigint { const weightedInput = amountIn * (10000n - feeBps); return (weightedInput * reserveOut) / (reserveIn * 10000n + weightedInput);}若兑换后任一侧储备将低于 600,000 整币单位,请在前端拦截该交易(链上会拒绝触发储备下限的兑换):
- D9 下限:
600000000000000000最小单位(12 位小数) - USDT 下限:
600000000000最小单位(6 位小数)
2. 设置滑点下限并兑换
Section titled “2. 设置滑点下限并兑换”D9Amm::swap(direction, amount_in, min_out)| 参数 | 说明 |
|---|---|
direction |
SwapDirection::D9ToUsdt 或 SwapDirection::UsdtToD9 |
amount_in |
输入代币数量(最小单位) |
min_out |
扣除用户滑点容差后的最小可接受输出量 |
// 10 D9 兑换 USDT,滑点容差 1%const quotedUsdt = quoteSwapOutput(10000000000000n, d9Reserve, usdtReserve, 30n);const minUsdtOut = (quotedUsdt * 99n) / 100n;
const tx = chain.api.tx.D9Amm.swap({ direction: { type: "D9ToUsdt" }, amount_in: 10000000000000n, min_out: minUsdtOut,});3. 添加或移除流动性
Section titled “3. 添加或移除流动性”| 调用 | 用途 |
|---|---|
D9Amm::add_liquidity(d9_amount, usdt_amount, min_lp_out) |
按池内比例存入 D9 与 USDT 并铸造 LP 份额。 |
D9Amm::remove_liquidity(lp_amount, min_d9_out, min_usdt_out) |
销毁 LP 份额并按比例取回 D9 与 USDT。 |
请根据当前储备量扣除用户滑点容差来计算 min_lp_out、min_d9_out 与 min_usdt_out。交易最终确认后,重新读取 D9Amm::LiquidityProviders(account) 以更新界面展示的 LP 余额。
