ch08-02 MarginRegistry

先看风险边界

这里先把问题放到风险控制面里。“MarginRegistry”不是在 DeepBook 旁边加一层 UI，而是把 registry、manager、oracle、borrow/supply state 接进同一条链上风控路径。

源码入口

重点阅读：

源码旁白：先定位结构体、入口函数和事件，再回到本节的资金路径或应用流程。不要从 helper 函数开始读。

关键定义

MarginRegistry 外层是 key object，真实配置在 Versioned 里的 MarginRegistryInner。这让包升级和版本门禁可以独立于 registry 对象 ID 演进。

public struct MarginRegistry has key {
    id: UID,
    inner: Versioned,
}

public struct MarginRegistryInner has store {
    registry_id: ID,
    allowed_versions: VecSet<u64>,
    pool_registry: Table<ID, PoolConfig>,
    margin_pools: Table<TypeName, ID>,
    margin_managers: Table<address, VecSet<ID>>,
    allowed_maintainers: VecSet<ID>,
    allowed_pause_caps: VecSet<ID>,
}

public struct PoolConfig has copy, drop, store {
    base_margin_pool_id: ID,
    quote_margin_pool_id: ID,
    risk_ratios: RiskRatios,
    user_liquidation_reward: u64,
    pool_liquidation_reward: u64,
    enabled: bool,
    extra_fields: VecMap<String, u64>,
}

public struct RiskRatios has copy, drop, store {
    min_withdraw_risk_ratio: u64,
    min_borrow_risk_ratio: u64,
    liquidation_risk_ratio: u64,
    target_liquidation_risk_ratio: u64,
}

应用侧要把 PoolConfig 当成交易对级风控真值：同一个 MarginPool 可以服务多个 DeepBook Pool，但每个交易对的 base/quote 池、清算奖励和风险率都来自 registry，而不是来自前端配置文件。

读风险控制面

MarginRegistry 是所有 Margin 交易的控制平面。结构体在 margin_registry.move 中定义：

allowed_versions：允许调用的 Margin package 版本。init 默认写入 margin_constants::margin_version()。
pool_registry：DeepBook Pool ID 到 PoolConfig 的映射。
margin_pools：资产类型 TypeName 到对应 MarginPool<Asset> ID 的映射。
margin_managers：owner 地址到其 MarginManager ID 集合的映射。
allowed_maintainers 和 allowed_pause_caps：维护者和暂停能力白名单。

PoolConfig 是每个 DeepBook Pool 的 Margin 风控配置，包含：

base_margin_pool_id、quote_margin_pool_id：这个交易对可使用的 base/quote 借贷池。
RiskRatios：min_withdraw_risk_ratio、min_borrow_risk_ratio、liquidation_risk_ratio、target_liquidation_risk_ratio。
user_liquidation_reward、pool_liquidation_reward：清算者和借贷池奖励，使用 9 位小数定点数。
enabled：是否允许常规 Margin 交易。

应用授权分两层：DeepBook 核心需要授权 Margin app，Margin 侧还要注册并启用具体 DeepBook Pool。部署脚本 scripts/transactions/marginPrep.ts 展示了顺序：authorizeMarginApp、创建 Pyth 配置、创建 MarginPool、registerDeepbookPool、enableDeepbookPool、enableDeepbookPoolForLoan。

工程旁白

MarginRegistry 是应用读取风控参数的首要来源。前端展示池状态时，不应把 DeepBook Pool ID、base/quote MarginPool ID 和风险率配置写死；这些值可能通过维护者交易被暂停、更新或重新授权。

借款和提款失败经常不是余额不足，而是 registry 中的池没有启用、版本不在 allowed list、DeepBook Pool 没有被对应 MarginPool 授权。交易前模拟要把这些配置状态作为独立检查项输出。

风控判断

把 PoolConfig 当作链上真值，SDK 配置只保存对象 ID 和类型，不缓存风险阈值作为执行依据。
部署或测试环境初始化时按 marginPrep.ts 的顺序执行，先授权 app，再创建池和注册交易对。
错误提示要区分 pool_enabled 失败、loan 未启用、版本不允许和风险率不足。

动手检查

当前 DeepBook Pool 的 base/quote MarginPool ID 来自 registry 还是本地配置？
min_borrow_risk_ratio 和 liquidation_risk_ratio 分别在哪些操作中被检查？
如果 Pool 被暂停，用户还能通过哪些 reduce-only 路径降低风险？

Keyboard shortcuts

DeepBook 开发权威指南