К основному содержанию
скилл CX Codex

deepbook-sdk — скилл для Claude Code: интеграция и установка

Скилл deepbook-sdk для Claude Code помогает подключить TypeScript-приложение к пулам DeepBook V3. Включается при разработке торговых приложений, ботов и скриптов на @mysten/deepbook-v3.

Apache-2.0 183 установок ★ 25 обновлён 2026-11-12

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add MystenLabs/skills --skill deepbook-sdk -a claude-code
Открыть на GitHub

Что делает deepbook-sdk

Скилл объясняет, как настроить клиент DeepBook V3, управлять балансами и проводить сделки через TypeScript SDK. В нём разобраны лимитные и рыночные ордера, свопы, запросы к книге ордеров, отмена ордеров и торговые комиссии.

Материалы разделены по задачам: настройка клиента и BalanceManager, торговые операции, комиссии и стейкинг DEEP. Для ордеров нужны средства, внесённые в BalanceManager; свопы работают с объектами Coin кошелька. Идентификатор BalanceManager следует сохранять и использовать повторно.

Скилл напоминает использовать ключи пулов и монет SDK вместо адресов в сети, а для clientOrderId задавать числовую строку. Для разработки потребуется пакет @mysten/deepbook-v3.

Какие задачи решает

  • настроить клиент DeepBook V3 для TypeScript-приложения
  • создать и повторно использовать BalanceManager
  • разместить лимитный или рыночный ордер
  • выполнить своп и запросить книгу ордеров
  • разобраться с комиссиями и стейкингом DEEP

Примеры запросов агенту

  • Настрой TypeScript-клиент для работы с пулами DeepBook V3.
  • Добавь в торгового бота размещение рыночного ордера и обработку повторных попыток.
  • Покажи, как отменить ордер и рассчитать комиссию в DeepBook.

Как установить deepbook-sdk

1Через Skills CLI (Vercel)

npx skills add MystenLabs/skills --skill deepbook-sdk -a claude-code

2Вручную: положить файлы

~/.claude/skills/deepbook-sdk/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/deepbook-sdk/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о deepbook-sdk

Как установить deepbook-sdk в Claude Code?

Выполни npx skills add MystenLabs/skills --skill deepbook-sdk -a claude-code. Файл скилла находится по пути ~/.claude/skills/deepbook-sdk/SKILL.md.

Что делает deepbook-sdk?

Скилл помогает интегрировать @mysten/deepbook-v3 в TypeScript-приложения, которые работают с пулами DeepBook V3. Он охватывает настройку клиента, балансы, ордера, свопы и комиссии.

Что нужно для работы deepbook-sdk?

В приложении используется пакет @mysten/deepbook-v3 и клиент SuiGrpcClient. Для ордеров нужны средства, внесённые в BalanceManager.

Исходный текст

SKILL.md · Apache-2.0
---
name: deepbook-sdk
description: >
  DeepBook V3 TypeScript SDK integration. Use when building trading applications,
  bots, or scripts that interact with DeepBook pools using the @mysten/deepbook-v3
  SDK. Covers client setup, BalanceManager lifecycle, placing limit and market
  orders, swaps, querying order books, order management, and fee handling.

  For DeepBook architecture and contract addresses, see the `deepbook-overview` skill.
  For Move smart contract integration, see the `deepbook-move` skill.
---

# DeepBook V3 SDK

> **MCP tool:** When available in your environment, also query the Sui documentation MCP server (`https://sui.mcp.kapa.ai`) for up-to-date answers. Use it for verification and for details not covered by these reference files.

> **Source constraint:** All information in this skill is sourced exclusively from [docs.sui.io](https://docs.sui.io/onchain-finance/deepbook/deepbookv3), the [deepbook-sandbox examples](https://github.com/MystenLabs/deepbook-sandbox/tree/main/examples/sandbox), and the [deepbookv3 repository](https://github.com/MystenLabs/deepbookv3). When extending or updating this skill, only pull from these sources. Do not use third-party blogs, tutorials, or unofficial documentation.

The `@mysten/deepbook-v3` SDK provides a TypeScript client for interacting with DeepBook V3 pools on Sui. This skill covers how to set up the client, manage balances, place orders, execute swaps, and handle fees. Common AI-coding mistakes include hardcoding on-chain IDs instead of using SDK pool/coin keys, creating a new BalanceManager per transaction instead of reusing one, and using non-numeric `clientOrderId` values.

This skill routes to focused reference files. Load only the ones relevant to the current task.

All patterns in this skill are derived from:
  https://docs.sui.io/onchain-finance/deepbook/deepbookv3/spot-workflow
  https://docs.sui.io/onchain-finance/deepbook/deepbookv3-sdk
  https://github.com/MystenLabs/deepbook-sandbox/tree/main/examples/sandbox

If unsure about any API, fetch the relevant page before answering.
Do not guess or extrapolate from other SDKs or libraries.

---

## Reference files

### client-setup — Client Initialization and BalanceManager Lifecycle
**Path:** `client-setup.md`
**Load when:** setting up a DeepBook client, creating or reusing a BalanceManager, configuring the SDK for testnet or mainnet, or understanding the three-tier setup pattern (read-only, basic, advanced).
**Covers:** SDK installation, `SuiGrpcClient` construction with `$extend(deepbook({...}))`, keypair setup, BalanceManager creation and reuse, deposits and withdrawals, the sandbox setup patterns.

### trading — Orders, Swaps, and Order Lifecycle
**Path:** `trading.md`
**Load when:** placing limit or market orders, executing swaps, querying order books, checking order status, canceling orders, or understanding the order lifecycle.
**Covers:** limit order placement (`POST_ONLY`, `NO_RESTRICTION`), market order placement with retry patterns, swap functions (with and without BalanceManager), order book queries, open order queries, order cancellation, self-matching behavior, the complete order lifecycle from placement to withdrawal.

### fees — Fee Structure and DEEP Staking
**Path:** `fees.md`
**Load when:** the user asks about trading fees, DEEP token staking, fee discounts, how to fund a BalanceManager with DEEP, or how fees are calculated.
**Covers:** DEEP vs input-token fee payment, fee calculation via `DeepPrice`, governance fee parameters, staking for fee discounts, acquiring testnet DEEP, referral system.

---

## Routing guide

| Task | Load |
|------|------|
| Setting up a DeepBook client | client-setup |
| Creating or reusing a BalanceManager | client-setup |
| Depositing or withdrawing funds | client-setup |
| Placing a limit order | trading |
| Placing a market order | trading |
| Executing a swap | trading |
| Querying the order book | trading |
| Checking or canceling orders | trading |
| Understanding fees or staking | fees |
| Funding a BalanceManager with DEEP | fees |
| Building a complete trading bot | **all reference files** |
| Full spot trading workflow | **all reference files** |

---

## Skill Content

### Key concepts

- **DeepBook client via `$extend`.** The SDK uses the `deepbook` function (imported from `@mysten/deepbook-v3`) with `SuiGrpcClient.$extend(deepbook({...}))` to add DeepBook-specific transaction builders. Methods follow a curried pattern under two namespaces: `client.deepbook.deepBook.method({ params })(tx)` for trading operations and `client.deepbook.balanceManager.method({ params })(tx)` for balance management, where `tx` is a `Transaction` object.

- **Pool and coin keys.** The SDK references pools and coins by string keys (e.g., `"DEEP_SUI"`, `"SUI"`) rather than raw on-chain addresses. The SDK maps these to the correct addresses per network.

- **BalanceManager lifecycle.** A BalanceManager is a shared on-chain object. Create it once, persist its ID, and reuse it across transactions. Creating a new one per transaction wastes gas and creates orphaned objects.

- **Swaps vs orders.** Swaps operate directly on wallet `Coin` objects without a BalanceManager. Orders require a BalanceManager with deposited funds.

### Rules

1. **Always use SDK keys for pools and coins.** Never hardcode on-chain IDs — the SDK handles address resolution per network.
2. **`clientOrderId` must be a numeric string** (encoded as `u64`). Labels like `"order-1"` will fail.
3. **Reuse BalanceManagers.** Persist the ID from creation and pass it when constructing the client.
4. **Size deposits to wallet balance.** The SDK validates at build time — depositing more than the wallet holds causes an `Insufficient balance` error before the transaction is even submitted.
5. **Handle the market maker rebalance window** on localnet/sandbox. The sandbox market maker has a ~15-second rebalance cycle where liquidity temporarily disappears. Use retry helpers.

### Common mistakes

- **Creating a new BalanceManager every run.** This creates orphaned shared objects. Check for existing managers via the indexer or persist the ID.
- **Using `POST_ONLY` for taker orders.** `POST_ONLY` guarantees the order rests on the book. If it would cross and fill, it is silently rejected — no order is returned and no error is thrown.
- **Forgetting to deposit before trading.** Orders draw from BalanceManager balances, not wallet balances. Funds must be deposited first.
- **Not depositing DEEP for fees.** On non-whitelisted pools, DEEP must be in the BalanceManager to pay fees. Without it, trades fail.
- **Ignoring self-matching.** When `selfMatchingOption` is not specified, the SDK defaults to `SelfMatchingOptions.SELF_MATCHING_ALLOWED`, which means your taker order can fill against your own resting maker orders. This is often unintentional. Explicitly set `SelfMatchingOptions.CANCEL_TAKER` or `SelfMatchingOptions.CANCEL_MAKER` to prevent self-fills.

© MystenLabs · Apache-2.0 · MystenLabs/skills

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
qdrant-clients-sdk официальный github Скилл qdrant-clients-sdk для GitHub Copilot подсказывает, как подключать Qdrant через официальные SDK и API. Помогает писать код на Python, TypeScript, Rust, Go, .NET или Java. CX Codex +1 61установок zapier-sdk zapier Скилл zapier-sdk подключает скрипты к 9,000+ сторонним сервисам через OAuth Zapier. Помогает писать интеграции без возни с отдельными API и ключами каждого сервиса. CX Codex +1 1 100установок tinybird-typescript-sdk-guidelines tinybirdco Скилл tinybird-typescript-sdk-guidelines учит агента описывать пайпы, источники данных и запросы через @tinybirdco/sdk с полной типизацией. Пригодится при переносе старых конфигураций в код на TypeScript. CX Codex +1 1 100установок claude-sdk-integration-patterns manutej Скилл claude-sdk-integration-patterns для Claude Code содержит паттерны интеграции Claude API и TypeScript SDK. Агент применяет их для стриминга, вызова функций и обработки ошибок в приложениях. CX Codex +1 437установок javascript-sdk 101-skills Скилл javascript-sdk учит агента работать с @inferencesh/sdk: запускать приложения inference.sh, стримить прогресс и собирать агентов прямо в JS/TS-коде. CX Codex +1 239установок copilot-sdk-nodejs официальный github Правило copilot-sdk-nodejs задаёт стиль работы с Microsoft Copilot SDK в Node.js и TypeScript. Оно применяется к файлам .ts, .js и package.json. CX Codex +1 ★ 41 430звёзд репо

Из того же набора30

Весь набор →
generate-sui-agent-config Скилл generate-sui-agent-config для Claude Code и Codex создаёт файлы инструкций CLAUDE.md или AGENT.md в проектах на блокчейне Sui. Настраивает контекст агента при инициализации репозитория. CX Codex +1 391установок move-security Скилл move-security для Claude Code проверяет безопасность смарт-контрактов на Move в Sui. Подключается при аудите пакета, настройке прав доступа или проверке работы с ключами и случайностью. CX Codex +1 381установок sui-networks-gas Скилл sui-networks-gas для Claude Code объясняет сети Sui и расчёт газа. Включается на вопросы о Mainnet, Testnet, Devnet, Localnet, бюджетах газа и эпохах. CX Codex +1 184установок deepbook-overview Скилл deepbook-overview для Claude Code объясняет устройство DeepBook V3 на Sui и варианты интеграции. Запускается на вопросах о CLOB, пулах, токене DEEP и адресах mainnet. CX Codex +1 183установок deepbook-margin Скилл deepbook-margin для Claude Code объясняет маржинальную торговлю в DeepBook на Sui. Подключается к задачам с заёмными позициями, залогом, рисками и ликвидацией. CX Codex +1 181установок deepbook-move Скилл deepbook-move для Claude Code помогает писать и отлаживать Move-контракты с DeepBook V3. Он подключается к вопросам о пулах, ордерах, обменах, флеш-займах и правах BalanceManager. CX Codex +1 181установок deepbook-predict Объясняет интеграцию DeepBook Predict с рынками прогнозов на Sui. Помогает создавать и закрывать позиции, разбирать расчёт и работу пула ликвидности. CX Codex +1 181установок sui-ts-sdk-backend Скилл sui-ts-sdk-backend для Claude Code помогает писать серверный код и агентов, которые работают с Sui через TypeScript SDK. Подключается для настройки клиента, подписания транзакций и запуска их сериями. CX Codex +1 167установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой