deepbook-predict

DeepBook Predict

MCP 工具： 如果你的环境支持，请同时查询 Sui 文档 MCP 服务（https://sui.mcp.kapa.ai），以获取最新答案。使用它进行验证，并查找这些参考文件未涵盖的详细信息。

来源限制： 本技能中的所有信息均仅来源于 docs.sui.io、deepbookv3 代码库（predict-testnet-4-16 分支）和 @mysten/deepbook-predict npm 包。扩展或更新本技能时，只能使用这些来源。请勿使用第三方博客、教程或非官方文档。

DeepBook Predict 是 Sui 上基于到期时间的预测市场协议，应用可以创建市场，用户则可根据预言机数据，以定价方式建立二元或垂直区间头寸。@mysten/deepbook-predict npm 包（v0.2.1）提供了专用于该协议的 TypeScript SDK；开发者也可以直接使用 Sui TypeScript SDK（@mysten/sui）构建交易。常见错误包括将 Predict 当作永续市场（它是基于到期时间的）、在创建 PredictManager 的同一笔交易中铸造并存入资产（必须先共享管理器），以及将硬编码的测试网 ID 当作永久地址。智能合约目前部署在测试网上，在主网部署前可能会有变动。

本技能会根据需要跳转到对应的参考文件。仅加载与当前任务相关的文件。

本技能中的所有模式均源自： https://docs.sui.io/onchain-finance/deepbook/deepbook-predict https://docs.sui.io/onchain-finance/deepbook/deepbook-predict/design https://docs.sui.io/onchain-finance/deepbook/deepbook-predict/tutorial https://github.com/MystenLabs/deepbookv3/tree/main/packages/predict

如果不确定某个 API 或参数，请先获取相关页面，再作答。 请勿根据其他预测市场协议进行猜测或推断。

---

参考文件

positions-and-oracles — 头寸类型、预言机生命周期与定价

路径： positions-and-oracles.md 适用场景： 用户询问二元头寸、垂直区间头寸、预言机的工作方式、预言机状态、结算机制、定价或金库/PLP 模型时。 涵盖内容： 二元头寸键与收益、垂直区间头寸键与收益、预言机生命周期（非活跃 → 活跃 → 待结算 → 已结算）、结算机制、金库和 PLP 流动性模型、定价与风险敞口。

workflow — 测试网集成工作流

路径： workflow.md 适用场景： 用户想要铸造头寸、赎回头寸、创建 PredictManager、提供或提取 PLP，或针对 Predict 协议构建交易时。 涵盖内容： SDK 设置、配置、创建 PredictManager、存入 DUSDC、铸造二元头寸、铸造垂直区间头寸、赎回（结算前和结算后）、LP 操作（提供和提取 PLP）、验证步骤、关键限制。

contract-info — 测试网合约地址

路径： contract-info.md 适用场景： 用户需要测试网包 ID、Predict 对象 ID、DUSDC 类型地址、公共服务 URL 或预言机事件类型时。 涵盖内容： 测试网包 ID、注册表 ID、Predict 对象 ID、DUSDC 规格、PLP 代币类型、公共服务端点、预言机事件类型。

---

路由指南

任务	加载
了解二元头寸与区间头寸的区别	positions-and-oracles
了解预言机的生命周期和结算	positions-and-oracles
了解金库和 PLP 模型	positions-and-oracles
铸造二元头寸	workflow
铸造垂直区间头寸	workflow
赎回头寸	workflow
创建 PredictManager	workflow
提供或提取 PLP	workflow
查询测试网地址	contract-info
查找公共服务端点	contract-info
构建预测市场应用	all reference files
完整集成 Predict	all reference files

---

技能内容

关键概念

• 基于到期时间的协议。 Predict 不是永续市场。每个头寸都有一个到期时间戳。到期后，头寸根据预言机记录的该时间戳价格进行结算。

• 二元头寸。 如果结算价格高于（看涨）或等于/低于（看跌）行权价，则支付固定名义金额。关键结构：(oracle_id, expiry, strike, is_up)。

• 垂直区间头寸。 如果结算价格落在两个行权价之间的区间内，则支付固定名义金额。关键结构：(oracle_id, expiry, lower_strike, higher_strike)。较低行权价必须小于较高行权价。

• PredictManager。 一个封装 DeepBook BalanceManager 的共享账户。用于持有 DUSDC 报价余额并跟踪头寸数量。必须在存入资金或铸造头寸之前，通过单独的交易创建并共享。

• OracleSVI。 特定资产和到期时间的市场状态容器。存储现货/远期价格、SVI 参数、激活状态和结算数据。状态依次经历四个阶段：未激活 → 已激活 → 待结算 → 已结算。

• 金库和 PLP。 金库承接每笔交易的另一方。流动性提供者存入 DUSDC 以获得 PLP（Predict LP）代币。金库会根据按市值计价的总负债实施敞口限制。

• DUSDC。 所有 Predict 操作使用的报价资产。可通过测试网代币申请表获取。

• 提供专用 SDK。 @mysten/deepbook-predict npm 包（v0.2.1）提供了用于与 DeepBook Predict 交互的专用 TypeScript SDK。通过 npm install @mysten/deepbook-predict 安装。若需要更底层的控制，也可以使用 @mysten/sui 直接构建交易。

规则

1. 在单独的交易中创建 PredictManager。 由于 create_manager 会在交易期间共享管理器，因此应在之后的交易中向其存入资金并从中铸造头寸，而不是在同一笔交易中完成。
2. 从公共服务获取预言机数据（https://predict-server.testnet.mystenlabs.com），不要使用硬编码值。预言机 ID、到期时间和行权价都是动态的。
3. 所有测试网 ID 都是临时的。 主网启动前，智能合约可能会更改。不要将当前的软件包 ID 或对象布局视为永久不变。
4. 铸造需要预言机处于激活状态。 预言机必须处于“已激活”状态。未激活、待结算和已结算的预言机都不接受新的铸造操作。
5. 可针对运行中的预言机和已结算的预言机进行赎回。 结算前，兑付金额反映当前买价。结算后，二元头寸按固定公允价值兑付；区间头寸若结算价格落在区间内，则兑付全部名义金额，否则兑付为零。
6. LP 提取受限。 提取资金时，必须在覆盖最大兑付义务后仍有足够的可用流动性；速率限制器也可能限制大额提取。

常见错误

• **在创建管理器的同一笔交易中铸造并存入。**必须先共享 PredictManager（交易 1），之后才能在后续交易中存入并铸造。
• **硬编码测试网地址。**这些地址会在主网上线时发生变化。请动态获取配置或维护配置文件。
• **假设仓位是永久的。**所有仓位都会到期。到期后，预言机将进入待结算状态，然后进入已结算状态。未解决的仓位必须在结算后赎回。
• **铸造前未验证预言机状态。**只有在预言机处于运行状态、接受报价资产、市场键与预言机匹配，并且管理器持有足够的已存入 DUSDC 时，铸造才能成功。
• 不知道该使用哪个 SDK。@mysten/deepbook-predict 软件包（v0.2.1）提供了用于 Predict 操作的高级辅助工具。如需更底层的控制，可直接使用 @mysten/sui 构建交易。两种方式都可行，请根据所需的控制程度进行选择。
• **区间使用了错误的行权价顺序。**垂直区间键要求 lower_strike < higher_strike。行权价顺序颠倒会导致铸造失败。