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

onchain-randomness — скилл для Claude Code

Скилл onchain-randomness для Claude Code настраивает работу с генератором случайных чисел в смарт-контрактах Sui Move. Защищает функции от атак композиции и утечек состояния.

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

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

Что делает onchain-randomness

Скилл инструктирует модель по работе со встроенным генератором случайных чисел на блокчейне Sui через общий объект Random по адресу 0x8. Он содержит правила создания экземпляров RandomGenerator, использования методов generate_u128, generate_u8_in_range или shuffle, а также передачи ссылки на генератор из TypeScript SDK.

Вторая часть материалов посвящена безопасности: предотвращению абортов транзакций в обёртках, ограничению вызовов внутри Programmable Transaction Blocks и паттерну commit-reveal. Любая попытка изменить объект 0x8 приведёт к падению транзакции, поэтому функции с генерацией обязаны объявляться как приватные entry.

Скилл также требует балансировать потребление газа между выигрышными и проигрышными ветками логики. Если ветки тратят разное количество вычислительного газа или памяти, атакующий сможет предсказывать исход по затратам. Вся справочная база опирается на официальную документацию Sui и интеграцию с MCP-сервером https://sui.mcp.kapa.ai.

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

  • Сгенерировать случайное число в смарт-контракте Sui Move через 0x8
  • Защитить функции со случайностью от атак композиции и манипуляций в PTB
  • Реализовать двухфазный паттерн commit-reveal для непредсказуемых механик
  • Сбалансировать расход газа между успешными и неуспешными ветками исполнения

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

  • Напиши Move-функцию с RandomGenerator для выбора победителя в лотерее
  • Проверь смарт-контракт на уязвимости при работе с объектом 0x8
  • Как сбалансировать потребление газа между выигрышной и проигрышной ветками в Sui?

Как установить onchain-randomness

1Через Skills CLI (Vercel)

npx skills add MystenLabs/skills --skill onchain-randomness -a claude-code

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

~/.claude/skills/onchain-randomness/SKILL.md

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

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

Вопросы об onchain-randomness

Как установить onchain-randomness в Claude Code?

Выполните команду npx skills add MystenLabs/skills --skill onchain-randomness -a claude-code. Файлы установятся в каталог ~/.claude/skills/onchain-randomness/SKILL.md.

Что делает onchain-randomness?

Предоставляет правила безопасной генерации случайных чисел в Sui Move с использованием объекта 0x8 и генератора RandomGenerator.

Что нужно для работы onchain-randomness?

Скилл использует документацию Sui и может опрашивать MCP-сервер по адресу https://sui.mcp.kapa.ai, если он подключён к среде.

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

SKILL.md · Apache-2.0
---
name: onchain-randomness
description: >
  Onchain randomness on Sui. Use when generating random values in Move smart contracts,
  working with the Random object (0x8) or RandomGenerator, securing randomness-consuming
  functions against composition attacks, PTB attacks, or state leakage, implementing
  commit-reveal patterns, balancing gas across execution paths, or integrating randomness
  from TypeScript.

  For general Move security patterns, see the `move-security` skill.
  For Move language fundamentals, see the `sui-move` skill.
  For TypeScript SDK patterns, see the `sui-sdks` skill.
---

# Onchain Randomness

> **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/sui-stack/on-chain-primitives/randomness-onchain](https://docs.sui.io/sui-stack/on-chain-primitives/randomness-onchain). When extending or updating this skill, only pull from this source. Do not use third-party blogs, tutorials, or unofficial documentation.

Sui provides native onchain randomness through the `Random` shared object at address `0x8`. Move functions create `RandomGenerator` instances from `Random` and use them to produce unpredictable values. This skill covers the API, usage patterns, security considerations, and attack mitigations for onchain randomness.

---

## Reference files

### usage -- API and Usage Patterns
**Path:** `usage.md`
**Load when:** generating random values in Move, creating a `RandomGenerator`, calling `new_generator`, using `generate_u128`, `generate_u8_in_range`, passing the `Random` object from TypeScript, or writing basic randomness-consuming functions.
**Covers:** the `Random` object (address `0x8`), `RandomGenerator`, the `random.move` API (full function list including `new_generator`, value generation, range generation, `shuffle`, `generate_bytes`), basic implementation examples, TypeScript integration.

### security -- Security and Attack Vectors
**Path:** `security.md`
**Load when:** securing randomness-consuming functions, preventing composition attacks, mitigating PTB attacks, avoiding `RandomGenerator` state leakage, implementing commit-reveal patterns, balancing gas across winning and losing paths, or choosing function visibility for randomness functions.
**Covers:** composition attacks (abort-filtering via public functions), PTB attacks (command chaining after `MoveCall` consuming `Random`), `RandomGenerator` state leakage via `bcs::to_bytes`, compiler lints on public functions accepting `Random` or `RandomGenerator`, two-step commit-reveal pattern, balanced gas usage, entry function restrictions.

---

## Routing guide

| Task | Load |
|------|------|
| Generating random values in Move | usage |
| Creating a RandomGenerator | usage |
| Calling random API functions | usage |
| Passing Random from TypeScript | usage |
| Securing a randomness-consuming function | security |
| Preventing composition or abort-filtering attacks | security |
| Mitigating PTB-based attacks | security |
| Avoiding RandomGenerator state leakage | security |
| Implementing commit-reveal for randomness | security |
| Balancing gas across execution paths | security |
| Choosing function visibility for randomness | security |
| Writing a complete randomness feature | usage + security |
| Reviewing randomness code for vulnerabilities | usage + security |

## Rules

- The `Random` object lives at reserved address `0x8` and is immutable for transactions. Any attempt to modify it causes transaction failure.
- Always create `RandomGenerator` locally within the consuming function using `r.new_generator(ctx)`. Never pass `RandomGenerator` as a `public` function parameter. Passing it to `public(package)` or private functions is acceptable for testing and in-package logic.
- Define randomness-consuming functions as private `entry` functions. The Move compiler lints against `public` functions that accept `Random` or `RandomGenerator` as parameters.
- Sui rejects PTBs containing commands other than `TransferObjects` or `MergeCoins` following a `MoveCall` that consumes `Random`. In other words, a call accepting `Random` must be the last `MoveCall` in a PTB.
- Ensure winning and losing execution paths consume approximately equal total gas (both compute and storage) to prevent attackers from inferring outcomes from gas consumption. Measure gas carefully and test in each published environment before going live.
- Use the two-step commit-reveal pattern when the outcome of randomness must not be observable before a follow-up action completes.

## Common mistakes

- **Making randomness functions `public` instead of private `entry`.** This is a fatal security flaw, not just a mistake. Public functions accepting `Random` enable abort-filtering attacks where an attacker wraps the function and reverts unfavorable outcomes. The compiler lints against this.
- **Accepting `RandomGenerator` as a `public` function parameter.** Callers can predict outputs by serializing the generator's internal state with `bcs::to_bytes(&generator)`. The compiler lints against `public` functions with `RandomGenerator` parameters. Using `RandomGenerator` as a parameter in `public(package)` or private functions is acceptable for testing and in-package logic.
- **Unbalanced gas consumption between branches.** If winning and losing paths consume significantly different total gas (compute + storage), attackers can infer outcomes from gas usage. The success path should cost equal or more gas than the failure path. To achieve this, either perform a simple standard update (e.g., set a bool flag) and claim the result in a follow-up function, or create an equally sized object (e.g., a dynamic field) in the failure path. Gas values must be measured carefully and tested in each published environment before going live.
- **Skipping commit-reveal when outcomes influence subsequent user actions.** If a user can observe and act on a random outcome in the same transaction, they can abort unfavorable results.

© MystenLabs · Apache-2.0 · MystenLabs/skills

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

Все скиллы по теме «Безопасность» →
D20DAO Verifiable Randomness d20dao MCP-сервер D20DAO Verifiable Randomness запрашивает проверяемую случайность: броски кубиков, выбор из списка, перемешивание и другие розыгрыши. Для платного запроса нужны USDC в Circle Agent Wallet. CX Codex +1 aptos-agent-skills aptos-labs Набор скиллов для разработки на Aptos: контракты Move, TypeScript SDK, аудит безопасности и оптимизация газа. ★ 21звёзд репо solana-dev Solana Foundation Скилл solana-dev помогает писать и проверять Solana-программы, собирать dApp и разбираться с транзакциями. Пригодится и для настройки инструментов или миграции старого кода. CX Codex +1 112 300установок move-code-quality davila7 Скилл move-code-quality разбирает пакеты на языке Move по чек-листу качества из Move Book и подсказывает, что поправить под Move 2024 Edition. CX Codex +1 100установок entry-point-analyzer trailofbits Скилл entry-point-analyzer находит внешние функции смарт-контрактов, которые меняют состояние, и группирует их по уровню доступа. Нужен перед аудитом, чтобы очертить поверхность атаки. CX Codex +1 6 400установок blockchain-expert personamanagmentlayer Скилл blockchain-expert для Claude Code разбирает блокчейн, Web3, Solidity, смарт-контракты и DeFi. Помогает проектировать, тестировать и аудировать криптосистемы. CX Codex +1 296установок

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

Весь набор →
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установок zklogin Объясняет устройство zkLogin и помогает интегрировать вход через OAuth в приложения на Sui. Подключается к вопросам о провайдерах OpenID, адресах, сроке сессии и безопасности. CX Codex +1 164установок kiosk Помогает писать, проверять и отлаживать Move-код с Sui Kiosk. Он подключается к задачам с торговлей активами, NFT и расширениями Kiosk. CX Codex +1 162установок sui-bridge Объясняет работу Sui Bridge и помогает находить сведения о переводах между Sui и Ethereum. Подключается к вопросам о поддерживаемых активах, лимитах, финальности и управлении мостом. CX Codex +1 160установок sui-for-ethereum Скилл sui-for-ethereum для Claude Code объясняет переход с Ethereum и Solidity на Sui Move. Подключается при сравнении моделей, переносе токенов и разборе контрактных паттернов. CX Codex +1 159установок

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

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