跳到內容

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 餘額。