提现是两段式：提交那一刻钱就从可用余额扣走，之后只能确认或失败。

发起提现

POST /v1/withdrawals            ← 提交（钱立刻从可用扣走）
POST /v1/withdrawals/{id}/confirm  ← 你确认链上已出款
POST /v1/withdrawals/{id}/fail     ← 你确认出款失败，钱退回

提交那一刻钱就扣了

不是「冻结」，是进入一个独立的桶。这个桶：

• 会员看不到、花不了
• 你也解不开 —— 只能靠 confirm 或 fail 两条路出去

⚠ 这是刻意的。如果它是普通的「冻结」，那么任何一个能解冻的接口都能

把这笔钱放回去 —— 而那笔钱可能已经在链上了。

地址必须来自地址簿

GET|POST /v1/withdraw-addresses

主线里没有「输入地址」这一步。 新增地址要过强认证 + 24 小时冷静期，提交提现时地址会被快照进订单 —— 之后改地址簿不影响已提交的单。

⚠ 24 小时冷静期不是可以绕过的产品细节。它挡的是「账号被盗之后立刻

加一个地址并把钱提走」。

fail 不是「取消」

fail 的语义是「我确认链上没出去，请把钱退回」。在你确认之前调它，风险是钱其实已经在链上了，而余额被退了回去。

相关端点

• POST /v1/withdrawals
• POST /v1/withdraw-addresses
• POST /v1/withdrawals/{id}/confirm