deepbook-predict — скилл для Claude Code: рынки Sui
Скилл для Claude Code объясняет интеграцию DeepBook Predict с рынками прогнозов на Sui. Помогает создавать и закрывать позиции, разбирать расчёт и работу пула ликвидности.
Apache-2.0 181 установок ★ 25 обновлён 2026-11-12
npx skills add MystenLabs/skills --skill deepbook-predict -a claude-codeЧто делает deepbook-predict
Скилл описывает интеграцию DeepBook Predict в TypeScript: создание и погашение позиций, состояния рынка и расчёты после экспирации. Каждая позиция задаёт диапазон цены; направленная позиция задаёт диапазон выше или ниже страйка. Для вызовов используются @mysten/deepbook-v3 и @mysten/deepbook-v3/predict.
При создании позиции нужно сохранить вместе marketId и orderId: идентификатор ордера уникален только внутри рынка, а частичное закрытие выдаёт новый. Количество задаётся целыми лотами по 0.01 USDC и означает максимальную выплату. Истёкший, но ещё не рассчитанный рынок остаётся в списке и отклоняет котировку. Скилл также описывает PoolVault и доли PLP; тип залоговой монеты берётся из getConfig(network).quoteCoinType.
Какие задачи решает
- создать позицию с диапазоном страйка
- сохранить идентификатор ордера вместе с рынком
- определить, рассчитан ли рынок после экспирации
- разобрать депозиты и вывод средств из PoolVault
Примеры запросов агенту
- Покажи, как создать позицию DeepBook Predict в TypeScript.
- Объясни, как хранить
marketIdиorderIdпосле частичного закрытия. - Как проверить расчёт рынка и вывести доли PLP?
Как установить deepbook-predict
1Через Skills CLI (Vercel)
npx skills add MystenLabs/skills --skill deepbook-predict -a claude-code2Вручную: положить файлы
~/.claude/skills/deepbook-predict/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/deepbook-predict/
1Через Skills CLI (Vercel)
npx skills add MystenLabs/skills --skill deepbook-predict -a codex2Вручную: положить файлы
.agents/skills/deepbook-predict/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add MystenLabs/skills --skill deepbook-predict -a cursor2Вручную: положить файлы
.cursor/skills/deepbook-predict/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install MystenLabs/skills deepbook-predict2Вручную: положить файлы
.github/skills/deepbook-predict/SKILL.md1Через Skills CLI (Vercel)
npx skills add MystenLabs/skills --skill deepbook-predict -a gemini-cli2Командой платформы
gemini skills install https://github.com/MystenLabs/skills --path deepbook-predictВручную: положить файлы
.devin/skills/deepbook-predict/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add MystenLabs/skills --skill deepbook-predict -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о deepbook-predict
Как установить deepbook-predict в Claude Code?
Выполни npx skills add MystenLabs/skills --skill deepbook-predict -a claude-code. Файл скилла находится по пути ~/.claude/skills/deepbook-predict/SKILL.md.
Что делает deepbook-predict?
Помогает разрабатывать интеграцию DeepBook Predict на Sui: создавать позиции, читать состояния рынков, разбирать расчёт и работу пула PoolVault с долями PLP.
Чем deepbook-predict отличается от deepbook-sdk?
deepbook-predict посвящён рынкам прогнозов. Для спотовой торговли предназначен deepbook-sdk.
Исходный текст
SKILL.md · Apache-2.0
---
name: deepbook-predict
description: >
Guides DeepBook Predict integration on Sui: expiry-based prediction markets
where every position is a strike range, minting and redeeming positions,
market lifecycle and settlement, order ID handling, and the PoolVault/PLP
liquidity pool. Use when the user asks about DeepBook Predict, Sui prediction
markets, binary, directional, or range positions, strikes and expiry, quoting,
settlement or try_settle, market states, PLP shares, the predict vault,
quoteCoinType, or code importing `@mysten/deepbook-v3/predict`. For spot
trading use the `deepbook-sdk` skill; for margin, `deepbook-margin`; for
architecture, `deepbook-overview`.
---
# DeepBook Predict
Expiry-based prediction markets on Sui. Each market covers one underlying and one expiry timestamp. Predict is not a perpetual market.
If an API or parameter is not shown here or in the reference files, check docs.sui.io and the `deepbookv3` repository rather than extrapolating from other prediction protocols.
## Quick start
```ts
import { DeepBookClient } from '@mysten/deepbook-v3';
import { getConfig } from '@mysten/deepbook-v3/predict';
// Deployment IDs and coin types are per-network. Never hardcode a symbol.
const config = getConfig(network); // 'testnet' | 'mainnet'
const collateral = config.quoteCoinType;
// `active` means live and NOT YET SETTLED — expired-but-unsettled markets are
// still returned here, and quoting against them aborts.
const markets = await client.predict.read.markets();
const tradable = markets.filter((m) => !m.is_settled);
```
## Task: explain Predict and its position types
- **Every position is a range contract.** It pays a fixed amount if the settlement price lands inside the chosen strike range, and nothing otherwise.
- **A directional ("binary") position is a one-sided range.** Side `up` pays when settlement lands above the strike; side `down` pays when it lands at or below it.
- **Quantity is the maximum payout in USDC**, not a share count, and must be a whole lot of 0.01 USDC (10,000 base units at 6 decimals).
- **Liquidity providers** supply USDC to a shared pool, receive PLP shares, and take the other side of every trade.
Payoff detail and worked examples: `positions-and-oracles.md`.
## Task: mint a position in TypeScript
Checklist:
1. `getConfig(network)` → deployment IDs and `quoteCoinType`.
2. `client.predict.read.markets()` → pick a market that is not settled.
3. Build the mint call (market, side or strike range, quantity in whole 0.01 USDC lots). Exact argument names: `workflow.md`.
4. Execute, then decode the order ID from the **transaction result** — it exists nowhere else.
5. Persist `{ marketId, orderId }` together.
6. Re-read the order ID after any partial close.
```ts
const tx = new Transaction();
client.predict.mint(tx, mintArgs); // see workflow.md for mintArgs
const result = await suiClient.signAndExecuteTransaction({
transaction: tx,
signer: keypair,
options: { showEvents: true, showObjectChanges: true },
});
const { orderId } = client.predict.decode.mint(result);
await store.save({ marketId, orderId }); // both, always
```
Why both IDs: an order ID is unique only inside one market, so redeem and claim need the market ID alongside it. Closing part of a position replaces the order ID with a new one — the old ID no longer resolves.
## Task: market states and settlement
- `active` means live and not yet settled. It does **not** mean "not expired".
- An expired market that nobody has settled is still returned by `read.markets()`, and quoting against it aborts.
- Read the lifecycle state from the market — `is_settled`, or `try_settlement_price` — instead of comparing the expiry timestamp to the clock.
- A market becomes settled when someone calls `try_settle` and it succeeds. The gap between expiry and settlement has no fixed duration.
- After settlement, positions are claimed/redeemed against the settlement price: full notional if the price landed in range, zero otherwise.
```ts
const price = await client.predict.read.try_settlement_price(marketId);
if (!price) {
// expired or not: still unsettled — do not quote, do not claim
}
```
State machine detail: `positions-and-oracles.md`.
## Task: vault and PLP liquidity
- The Predict pool, **PoolVault**, is the counterparty to every trade.
- Liquidity providers deposit the pool's collateral coin (USDC) and receive **PLP** shares — a 6-decimal coin matching USDC's decimals.
- PLP is a proportional claim on pool value, so its value tracks pool profit and loss rather than paying a fixed yield.
- Read the exact collateral coin type from `getConfig(network).quoteCoinType`; do not assume a symbol.
- Withdrawals require available liquidity after covering maximum payout obligations, and large withdrawals may be throttled.
Supply/withdraw calls: `workflow.md`.
## Task: common mistakes
| Mistake | Do instead |
|---|---|
| Assuming the collateral coin symbol | Read `getConfig(network).quoteCoinType` |
| Inferring settlement from the expiry timestamp | Read `is_settled` or `try_settlement_price` |
| Quoting an expired market from `read.markets()` | Filter out unsettled-but-expired markets; quoting them aborts |
| Hardcoding package or object IDs | Treat them as pinned to a deployment; read them for the target network |
| Storing only the order ID | Store `{ marketId, orderId }`; order IDs are market-scoped |
| Reusing an order ID after a partial close | Decode the new order ID from that transaction's result |
| Quantity that is not a whole 0.01 USDC lot | Round to whole lots; quantity is maximum payout |
| Treating positions as perpetual | Every position expires and is claimed after settlement |
## Reference files
- `positions-and-oracles.md` — payoffs, market lifecycle, settlement mechanics, vault/PLP model.
- `workflow.md` — exact call arguments for mint, redeem, claim, LP supply and withdraw.
- `contract-info.md` — per-deployment IDs, coin types, server endpoint, event types.
© MystenLabs · Apache-2.0 · MystenLabs/skills