跳转到内容

AMM 兑换与流动性

D9Amm 提供原生 D9 与已登记 USDT 之间的恒定乘积兑换池。所有报价与滑点计算均须使用 bigint 整数运算。

请在同一个最终确认区块上读取以下存储项:

存储 返回值
D9Amm::D9Reserve D9 储备量(12 位小数)
D9Amm::UsdtReserve USDT 储备量(6 位小数)
D9Amm::FeePercent 兑换手续费,单位为基点(30 = 0.30%)
D9Amm::TotalLpTokens LP 份额总发行量
D9Amm::LiquidityProviders(account) 指定账户持有的 LP 份额

给定输入数量 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 位小数)
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,
});
调用 用途
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 余额。