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

deepbook-move — скилл для Claude Code: возможности и установка

Скилл deepbook-move для Claude Code помогает писать и отлаживать Move-контракты с DeepBook V3. Он подключается к вопросам о пулах, ордерах, обменах, флеш-займах и правах BalanceManager.

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

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

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

Скилл помогает создавать, проверять и отлаживать Move-контракты, которые вызывают DeepBook V3. Он разбирает лимитные и рыночные ордера, обмены без BalanceManager, флеш-займы и вызовы DeepBook внутри программируемых транзакций. Для зависимости в Move.toml используется deepbook = { mvr = "@deepbook/core" }.

В рекомендациях разобраны типы активов пула, TradeProof и полномочия TradeCap, DepositCap и WithdrawCap. Скилл объясняет, что FlashLoan нужно вернуть соответствующим вызовом в той же транзакции: без возврата она откатывается. Пул нельзя использовать одновременно для займа и торговой операции в одной транзакции.

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

  • создать Move-контракт с лимитным или рыночным ордером DeepBook
  • собрать обмен через пул без BalanceManager
  • разобрать возврат флеш-займа в транзакции
  • настроить права владельца BalanceManager и держателей капов

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

  • Помоги добавить в Move-контракт лимитный ордер через deepbook::pool.
  • Разбери обмен swap_exact_base_for_quote без BalanceManager.
  • Проверь, как вернуть FlashLoan в той же транзакции.

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

1Через Skills CLI (Vercel)

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

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

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

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

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

Вопросы о deepbook-move

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

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

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

Помогает писать, проверять и отлаживать Move-контракты для DeepBook V3: от ордеров и обменов до флеш-займов и управления доступом через BalanceManager.

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

В Move.toml добавь зависимость deepbook = { mvr = "@deepbook/core" }. Скилл описывает интеграцию с DeepBook V3.

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

SKILL.md · Apache-2.0
---
name: deepbook-move
description: >
  Guides writing, reviewing, and debugging Move smart contracts that call DeepBook V3:
  placing limit or market orders on-chain, creating pools, swapping without a
  BalanceManager, flash loans, BalanceManager/TradeCap authorization, and composing
  DeepBook calls in programmable transaction blocks. Use when the user asks about
  deepbook::pool, place_limit_order, swap_exact_base_for_quote, borrow_flashloan_base,
  FlashLoan hot potato, TradeProof, TradeCap/DepositCap/WithdrawCap, or adding
  `deepbook = { mvr = "@deepbook/core" }` to Move.toml.
---

# DeepBook V3 Move Integration

## Setup

`Move.toml`:

```toml
[dependencies]
deepbook = { mvr = "@deepbook/core" }
```

```move
use deepbook::pool::{Self, Pool};
use deepbook::balance_manager::{Self, BalanceManager, TradeProof, TradeCap};
```

Every `Pool` function is generic over `<BaseAsset, QuoteAsset>` and the type arguments must match the pool's creation order exactly: `Pool<SUI, USDC>` is a different type from `Pool<USDC, SUI>`.

## Orders (require a BalanceManager + TradeProof)

```move
public fun place_limit_order<BaseAsset, QuoteAsset>(
    self: &mut Pool<BaseAsset, QuoteAsset>,
    balance_manager: &mut BalanceManager,
    trade_proof: &TradeProof,
    client_order_id: u64,
    order_type: u8,
    self_matching_option: u8,
    price: u64,
    quantity: u64,
    is_bid: bool,
    pay_with_deep: bool,
    expire_timestamp: u64,
    clock: &Clock,
    ctx: &mut TxContext,
): OrderInfo
```

`place_market_order` takes the same arguments minus `price` and `expire_timestamp`.
`cancel_order<BaseAsset, QuoteAsset>(pool, balance_manager, trade_proof, order_id, clock, ctx)`.

`order_type` constants: `0` = NO_RESTRICTION, `1` = IMMEDIATE_OR_CANCEL (IOC), `2` = FILL_OR_KILL (FOK), `3` = POST_ONLY.

Every order placement and cancellation needs a `TradeProof`, created in the same transaction:

```move
// owner of the BalanceManager
public fun generate_proof_as_owner(bm: &mut BalanceManager, ctx: &TxContext): TradeProof
// delegated trader holding a TradeCap
public fun generate_proof_as_trader(bm: &mut BalanceManager, trade_cap: &TradeCap, ctx: &TxContext): TradeProof
```

## Swaps (no BalanceManager, no TradeProof)

```move
public fun swap_exact_base_for_quote<BaseAsset, QuoteAsset>(
    self: &mut Pool<BaseAsset, QuoteAsset>,
    base_in: Coin<BaseAsset>,
    deep_in: Coin<DEEP>,
    min_quote_out: u64,
    clock: &Clock,
    ctx: &mut TxContext,
): (Coin<BaseAsset>, Coin<QuoteAsset>, Coin<DEEP>)

public fun swap_exact_quote_for_base<BaseAsset, QuoteAsset>(
    self: &mut Pool<BaseAsset, QuoteAsset>,
    quote_in: Coin<QuoteAsset>,
    deep_in: Coin<DEEP>,
    min_base_out: u64,
    clock: &Clock,
    ctx: &mut TxContext,
): (Coin<BaseAsset>, Coin<QuoteAsset>, Coin<DEEP>)
```

Both return three coins: leftover base, leftover quote, and unused DEEP. `deep_in` pays the taker fee — overestimating is safe because the unused DEEP is returned; underestimating aborts.

Simulate first:

```move
public fun get_quantity_out<BaseAsset, QuoteAsset>(
    self: &Pool<BaseAsset, QuoteAsset>,
    base_quantity: u64,
    quote_quantity: u64,
    clock: &Clock,
): (u64, u64, u64) // (base_out, quote_out, deep_required)
```

Exactly one of `base_quantity` or `quote_quantity` must be non-zero; passing both or neither is invalid.

## Flash loans

```move
public fun borrow_flashloan_base<BaseAsset, QuoteAsset>(
    self: &mut Pool<BaseAsset, QuoteAsset>, base_amount: u64, ctx: &mut TxContext,
): (Coin<BaseAsset>, FlashLoan)

public fun borrow_flashloan_quote<BaseAsset, QuoteAsset>(
    self: &mut Pool<BaseAsset, QuoteAsset>, quote_amount: u64, ctx: &mut TxContext,
): (Coin<QuoteAsset>, FlashLoan)

public fun return_flashloan_base<BaseAsset, QuoteAsset>(
    self: &mut Pool<BaseAsset, QuoteAsset>, coin: Coin<BaseAsset>, flash_loan: FlashLoan,
)

public fun return_flashloan_quote<BaseAsset, QuoteAsset>(
    self: &mut Pool<BaseAsset, QuoteAsset>, coin: Coin<QuoteAsset>, flash_loan: FlashLoan,
)
```

`FlashLoan` has **no abilities** — it cannot be stored, copied, or dropped, so it must be consumed by the matching `return_flashloan_*` call in the same transaction. If it is not repaid the whole transaction reverts and no state change persists. The maximum borrowable amount is the pool's current holdings of that asset. There is no borrow fee; repay the exact borrowed amount.

## BalanceManager and delegation

A `BalanceManager` is a shared object that holds a user's balances and is reused across **all** pools — deposit once, trade everywhere. Two-tier authorization:

- **Owner** — full control: deposit, withdraw, mint and revoke caps, `generate_proof_as_owner`.
- **Cap holders** — `TradeCap` can only trade (`generate_proof_as_trader`); it **cannot deposit or withdraw**. `DepositCap` can only deposit, `WithdrawCap` can only withdraw.

```move
public fun new(ctx: &mut TxContext): BalanceManager
public fun mint_trade_cap(bm: &mut BalanceManager, ctx: &mut TxContext): TradeCap
public fun deposit<T>(bm: &mut BalanceManager, coin: Coin<T>, ctx: &mut TxContext)
public fun withdraw<T>(bm: &mut BalanceManager, amount: u64, ctx: &mut TxContext): Coin<T>
```

Limit: **1,000 total capabilities per BalanceManager** across TradeCap, DepositCap, and WithdrawCap combined. Beyond that, shard across multiple BalanceManagers.

## Rules and common mistakes

1. **Type parameter order.** `<USDC, SUI>` against a `Pool<SUI, USDC>` is a type mismatch; match the pool's base/quote order.
2. **Return the hot potato.** Forgetting `return_flashloan_*` compiles but aborts at runtime.
3. **Do not borrow from a pool and trade in that same pool in one transaction.** Borrowed funds are unavailable for settlement and the combined operations can fail; use a different pool or venue for the trade leg.
4. **`generate_proof_as_owner` only works from the owner address.** Delegated traders must call `generate_proof_as_trader` with a valid `TradeCap`.
5. **`generate_proof_as_trader` takes `ctx`** — `(bm, trade_cap, ctx: &TxContext)`; omitting it is a compile error.
6. **Use `_v2` variants where they exist** (e.g. `new_with_custom_owner_caps_v2`). The unsuffixed originals are stubs that `abort 1337`.
7. **Plan around the 1,000-cap limit** before building a system with many delegated trading accounts.

## Reference files

- `pool-api.md` — pool creation, order placement and cancellation, pool state queries, governance, constants.
- `balance-manager-api.md` — BalanceManager creation, cap minting and revocation, deposits/withdrawals, TradeProofs, events.
- `flash-loans.md` — borrow/return details, constraints, worked example.

Related skills: `deepbook-overview` (architecture, package addresses, pool IDs), `deepbook-sdk` (TypeScript), `sui-move` (Move fundamentals), `ptbs` (PTB composition).

If a signature is not above, read the reference file or `https://docs.sui.io/onchain-finance/deepbook/deepbookv3/contract-information` and the [deepbookv3 sources](https://github.com/MystenLabs/deepbookv3/tree/main/packages/deepbook/sources). Do not extrapolate from other protocols.

© MystenLabs · Apache-2.0 · MystenLabs/skills

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

Каталог скиллов SKILL.md →
move-ai-motion-capture calesthio Скилл move-ai-motion-capture для Claude Code автоматизирует планирование и обработку данных захвата движения в системах Move AI. Он помогает настраивать параметры съёмки и экспорт анимации. CX Codex +1 136установок move-code-quality davila7 Скилл move-code-quality разбирает пакеты на языке Move по чек-листу качества из Move Book и подсказывает, что поправить под Move 2024 Edition. CX Codex +1 100установок move davila7 Команда move для Claude Code синхронизирует статус задач с папками, трекерами и метаданными. Перемещает задачи между этапами разработки и QA. CX Codex +1 190установок rerender-move-effect-to-event tech-leads-club Правило rerender-move-effect-to-event требует запускать побочный эффект в обработчике события, которое его вызвало, а не через состояние и useEffect. CX Codex +1 ★ 7 191звёзд репо speckit.companion.living-move alfredoperez Команда speckit.companion.living-move переносит спецификации Speckit между общим каталогом capabilities и папками с кодом, одновременно обновляя реестр проекта. CX Codex +1 ★ 110звёзд репо Your Move Exercise Video API ymove-app MCP-сервер Your Move Exercise Video API с базой упражнений, видео и генерацией тренировок и программ прямо в чате с агентом. CX Codex +1 ★ 1звёзд репо

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

Весь набор →
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-sdk Скилл deepbook-sdk для Claude Code помогает подключить TypeScript-приложение к пулам DeepBook V3. Включается при разработке торговых приложений, ботов и скриптов на @mysten/deepbook-v3. CX Codex +1 183установок deepbook-margin Скилл deepbook-margin для Claude Code объясняет маржинальную торговлю в DeepBook на Sui. Подключается к задачам с заёмными позициями, залогом, рисками и ликвидацией. 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установок zklogin Объясняет устройство zkLogin и помогает интегрировать вход через OAuth в приложения на Sui. Подключается к вопросам о провайдерах OpenID, адресах, сроке сессии и безопасности. CX Codex +1 164установок kiosk Помогает писать, проверять и отлаживать Move-код с Sui Kiosk. Он подключается к задачам с торговлей активами, NFT и расширениями Kiosk. CX Codex +1 162установок

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

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