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