Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

ch06-03 精度、tick size、lot size 和最小量

返回本章

先从用户动作开始

这一节把“精度、tick size、lot size 和最小量”当作应用流程来读:先看用户要完成什么,再反推 PTB 需要哪些对象、参数、dry run 和失败处理。

源码入口

从应用反推链上

create_permissionless_pool 要求 tick_sizelot_sizemin_size 合法。下单时 order_info::new 会校验价格、数量和过期时间,相关错误包括 EOrderInvalidPrice = 0EOrderBelowMinimumSize = 1EOrderInvalidLotSize = 2EInvalidExpireTimestamp = 3

UI 输入必须先转换为整数:

  • price 必须落在 tick size 网格上。
  • quantity 必须是 lot size 的整数倍。
  • quantity 必须大于等于 min size。
  • 市价单仍然以 base quantity 表示,只是 price 由 pool.place_market_order 自动设为买单 MAX_PRICE 或卖单 MIN_PRICE

应用侧应在输入框旁展示最小步进,而不是等链上 abort。

工程旁白:Spot 应用先看用户状态机:市场、余额、订单、提交、确认。链上提交仍然落到 pool.movebalance_manager.move;UI 只是把这些固定入口组织成用户能理解的交易动作。

精度和池子发现是所有交易动作的前置条件。用户输入的十进制价格和数量必须转换为 tick/lot 对齐的整数,再交给 pool.move,否则错误会在链上校验阶段暴露。

写应用时

  • 所有用户输入先做 decimal、tick size、lot size 和 min size 转换,再构造 PTB。
  • 提交前 dry run,提交后用 digest、事件和 order_query.move 刷新状态。
  • UI/CLI 中分开展示 wallet coins、manager 余额、open orders 和最近一次交易状态。

动手检查

  • 精度、tick size、lot size 和最小量 需要哪些对象 ID、type arguments、cap/proof 和数值参数?
  • dry run 失败时应给用户显示哪类提示:余额、精度、订单状态、版本暂停还是 Gas?
  • 交易成功后应用应该依赖事件、order query 还是本地缓存更新页面?