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

sui-ts-sdk-backend — скилл для Claude Code: установка

Скилл sui-ts-sdk-backend для Claude Code помогает писать серверный код и агентов, которые работают с Sui через TypeScript SDK. Подключается для настройки клиента, подписания транзакций и запуска их сериями.

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

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

Что делает sui-ts-sdk-backend

Скилл описывает серверные сценарии для Sui на TypeScript без CLI: создание ключей, запрос средств из faucet и подключение клиента. В справочных файлах разобраны транзакции, публикация Move-пакетов, спонсирование и подпись через KMS или multisig.

Для выполнения примеров нужен @mysten/sui версии 2; скилл предписывает использовать SuiGrpcClient по умолчанию и проверять результат транзакции. Версия @mysten/sui.js 1 устарела и не используется. Для AWS KMS и GCP KMS названы отдельные пакеты-подписанты: @mysten/aws-kms-signer и @mysten/gcp-kms-signer.

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

  • создать ключ и подключить сервер к Sui
  • подписать и выполнить транзакцию из backend
  • опубликовать или обновить Move-пакет из TypeScript
  • настроить спонсирование пользовательских транзакций
  • запускать транзакции сериями через executors

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

  • Настрой подключение backend к Sui и создай ключ программно.
  • Покажи, как подписать транзакцию и дождаться её выполнения.
  • Собери поток транзакций с ParallelTransactionExecutor.

Как установить sui-ts-sdk-backend

1Через Skills CLI (Vercel)

npx skills add MystenLabs/skills --skill sui-ts-sdk-backend -a claude-code

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

~/.claude/skills/sui-ts-sdk-backend/SKILL.md

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

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

Вопросы о sui-ts-sdk-backend

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

Выполни npx skills add MystenLabs/skills --skill sui-ts-sdk-backend -a claude-code. Файл скилла будет доступен по пути ~/.claude/skills/sui-ts-sdk-backend/SKILL.md.

Что делает sui-ts-sdk-backend?

Скилл описывает работу серверов и агентов с Sui через TypeScript SDK: от подключения и подписания транзакций до публикации пакетов, спонсирования и multisig.

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

Для примеров используется @mysten/sui версии 2. Подпись через AWS KMS и GCP KMS описана с пакетами @mysten/aws-kms-signer и @mysten/gcp-kms-signer.

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

SKILL.md · Apache-2.0
---
name: sui-ts-sdk-backend
description: >
  Sui TypeScript SDK for backend services and autonomous agents. Use when
  building a backend, agent, or service that interacts with Sui programmatically
  without CLI — keypair creation, faucet funding, client setup, transaction
  building and signing, package publishing from code, sponsored transactions,
  running transactions at scale with executors, cloud KMS signing (AWS/GCP),
  and multisig workflows. Also use when the user asks how to bootstrap a Sui
  agent, build a backend signer service, or run high-throughput transaction
  pipelines.

  For frontend dApp development with wallets, see the `frontend-apps` skill.
  For SDK selection (TS vs Rust vs community), see the `sui-sdks` skill.
  For PTB semantics and command reference, see the `ptbs` skill.
  For Move smart contract development, see the `sui-move` skill.
---

# Sui TypeScript SDK — Backend & Agent Patterns

> **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 [sdk.mystenlabs.com](https://sdk.mystenlabs.com). When extending or updating this skill, only pull from this source. Do not use third-party blogs, tutorials, or unofficial documentation.

This skill covers using the Sui TypeScript SDK (`@mysten/sui` v2) for backend services and autonomous agents that cannot use the Sui CLI. It provides the end-to-end programmatic workflow: creating keypairs, funding addresses, connecting to networks, building and signing transactions, publishing packages, sponsoring transactions for users, running at scale, and signing with cloud KMS or multisig.

All patterns in this skill are derived from:
  https://sdk.mystenlabs.com

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

---

## Reference files

### bootstrap — Keypair, Faucet, and Client Setup
**Path:** `bootstrap.md`
**Load when:** creating a keypair programmatically, funding an address from the faucet without CLI, configuring a `SuiGrpcClient` or `SuiGraphQLClient`, or bootstrapping an agent's first connection to Sui.
**Covers:** keypair creation (random, mnemonic, import/export, Bech32 `suiprivkey` format), all three key types (Ed25519, Secp256k1, Secp256r1), programmatic faucet requests, client instantiation and network selection, client extensions, the complete bootstrap sequence.

### transactions — Building, Coins, and Execution
**Path:** `transactions.md`
**Load when:** building transactions with `tx.coin()` or `tx.balance()`, handling address balances vs coin objects, signing and executing from a backend keypair, checking results, waiting for indexing, or handling gasless transactions.
**Covers:** `tx.coin()` and `tx.balance()` (the recommended coin access pattern), address balances vs coin objects, splitting and merging coins, signing with keypairs directly, result handling (`FailedTransaction` checks), `waitForTransaction`, gasless stablecoin transfers.

### publishing — Programmatic Package Publish and Upgrade
**Path:** `publishing.md`
**Load when:** publishing a Move package from TypeScript without CLI, upgrading a published package programmatically, or constructing Publish/Upgrade PTB commands.
**Covers:** building Move bytecode, constructing Publish commands in PTBs, executing publish transactions, extracting package ID and UpgradeCap from results, programmatic upgrades with UpgradeCap, upgrade policies.

### sponsorship — Sponsored Transactions
**Path:** `sponsorship.md`
**Load when:** sponsoring transactions for users, building a gas station backend, using the `@mysten-incubation/sponsor` SDK, or implementing address-balance or coin-based sponsorship flows.
**Covers:** `@mysten-incubation/sponsor` package, client-builds flow (recommended), backend validation and co-signing, config endpoint pattern, coin-based vs address-balance sponsorship, `useGasCoin: false` for token transfers, result handling (Rejected vs FailedTransaction vs success).

### executors — Running Transactions at Scale
**Path:** `executors.md`
**Load when:** running many transactions from one address, building a high-throughput pipeline, managing gas pools, or needing parallel or serial transaction execution without manual gas management.
**Covers:** `SerialTransactionExecutor` (queuing, gas merging, object caching), `ParallelTransactionExecutor` (concurrent execution, gas pool, conflict detection), configuration options, best practices for unresolved object IDs.

### signing — Cloud KMS and Multisig
**Path:** `signing.md`
**Load when:** signing with AWS KMS or GCP KMS, setting up multisig wallets, combining partial signatures, mixing keypair types (Ed25519 + zkLogin + passkey), or building a custody/signer service.
**Covers:** Signer interface (shared across all signer types), AWS KMS signer (`@mysten/aws-kms-signer`), GCP KMS signer (`@mysten/gcp-kms-signer`), `MultiSigPublicKey` setup (threshold, weights), `MultiSigSigner`, combining partial signatures, hybrid multisig (keypairs + zkLogin + passkeys).

---

## Routing guide

| Task | Load |
|------|------|
| Bootstrapping an agent from scratch | bootstrap |
| Creating a keypair without CLI | bootstrap |
| Getting testnet SUI without CLI | bootstrap |
| Connecting to Mainnet/Testnet/Devnet | bootstrap |
| Building a transaction with coin access | transactions |
| Signing and executing from a backend | transactions |
| Handling address balances vs coin objects | transactions |
| Publishing a Move package from TypeScript | publishing |
| Upgrading a package programmatically | publishing |
| Sponsoring transactions for users | sponsorship |
| Building a gas station backend | sponsorship |
| Running many transactions efficiently | executors |
| Building a high-throughput pipeline | executors |
| Signing with AWS or GCP KMS | signing |
| Setting up multisig | signing |
| Building a custody service | signing |
| Full backend service from scratch | **all reference files** |
| Agent onboarding end-to-end | bootstrap + transactions |

---

## Rules

- Always use `@mysten/sui` v2 (`@mysten/sui/grpc`, `@mysten/sui/keypairs/ed25519`, etc.). Never use the deprecated `@mysten/sui.js` v1.
- Always use `SuiGrpcClient` as the default client. Use `SuiGraphQLClient` only when you need flexible relational queries.
- Always check `result.$kind` after transaction execution. A result that is not `Rejected` can still be `FailedTransaction` (executed on-chain but aborted — gas is still consumed).
- Always call `await client.waitForTransaction({ result })` before reading state that depends on a transaction's effects.
- Use `tx.coin()` and `tx.balance()` as the primary way to access funds. They automatically resolve from both address balances and coin objects. Specify `type` for non-SUI tokens.
- For transfers, prefer `balance::send_funds` over `transferObjects`. It deposits directly into the recipient's address balance, avoiding versioned coin objects on the receiving side.
- For sponsored transactions where the sender needs to transfer their own tokens, set `useGasCoin: false` on `tx.coin()` / `tx.balance()` calls to source from the sender's balance instead of the sponsor's gas coin.
- For scale, use `SerialTransactionExecutor` or `ParallelTransactionExecutor` instead of manual gas management loops.
- For production backends, use AWS KMS or GCP KMS signers instead of storing raw private keys.

## Common mistakes

- **Storing raw private keys in environment variables for production.** Use AWS KMS or GCP KMS signers. Raw keys are acceptable for development/testing only.
- **Not waiting for indexing after a transaction.** Read APIs may not immediately reflect transaction effects. Always `waitForTransaction` before dependent reads.
- **Assuming `result` means success.** Check `result.$kind !== 'FailedTransaction'`. A `FailedTransaction` was executed on-chain (gas consumed) but the Move call aborted.
- **Using `splitCoins(tx.gas, ...)` when the sender is not the gas owner.** In sponsored transactions, `tx.gas` belongs to the sponsor. If the sender needs to transfer their own tokens, use `tx.coin()` with `useGasCoin: false` to source from the sender's balance instead.
- **Running multiple `ParallelTransactionExecutor` instances on the same address.** This causes gas coin conflicts. Use a single executor per address.
- **Building transactions with fully-specified object refs when using executors.** Use unresolved object IDs (`tx.object('0x...')`) so the executor can leverage its object cache.

© MystenLabs · Apache-2.0 · MystenLabs/skills

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

Все скиллы по теме «Бэкенд и API» →
aws-sdk-js-v3-usage aws Скилл aws-sdk-js-v3-usage задаёт правила и паттерны работы с AWS SDK v3 в коде на JavaScript и TypeScript. Помогает писать вызовы сервисов AWS без устаревшего синтаксиса v2. CX Codex +1 9 000установок aws-sdk-python-usage aws Скилл aws-sdk-python-usage задаёт правила кодинга на Python с библиотеками boto3 и botocore. Он подсказывает агенту, когда брать client или resource, как настраивать пагинацию и перехватывать ошибки AWS. CX Codex +1 8 800установок aws-sdk-java-v2-rds giuseppe-trisciuoglio Скилл aws-sdk-java-v2-rds помогает управлять базами данных Amazon RDS через AWS SDK for Java 2.x. Пригодится при настройке инстансов, снэпшотов и групп параметров в коде на Java. CX Codex +1 3 900установок aws-sdk-java-v2-kms giuseppe-trisciuoglio Скилл aws-sdk-java-v2-kms для Claude Code помогает писать код для AWS KMS через AWS SDK for Java 2.x. Он включается при работе с ключами, шифрованием, подписями и интеграцией со Spring Boot. CX Codex +1 3 900установок tigris-sdk-guide tigrisdata Скилл tigris-sdk-guide подсказывает агенту, какой SDK или CLI выбрать для Tigris: родной для TypeScript, Go и Python, AWS-совместимый для Ruby и PHP. CX Codex +1 3 800установок rivet-sdk официальный anthropics Справочный скилл по Zoom Rivet SDK для настройки OAuth и приёма вебхуков на Node.js или в AWS Lambda. CX Codex +1 2 200установок

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

Весь набор →
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-move Скилл deepbook-move для Claude Code помогает писать и отлаживать Move-контракты с DeepBook V3. Он подключается к вопросам о пулах, ордерах, обменах, флеш-займах и правах BalanceManager. CX Codex +1 181установок deepbook-predict Объясняет интеграцию DeepBook Predict с рынками прогнозов на Sui. Помогает создавать и закрывать позиции, разбирать расчёт и работу пула ликвидности. CX Codex +1 181установок zklogin Объясняет устройство zkLogin и помогает интегрировать вход через OAuth в приложения на Sui. Подключается к вопросам о провайдерах OpenID, адресах, сроке сессии и безопасности. CX Codex +1 164установок kiosk Помогает писать, проверять и отлаживать Move-код с Sui Kiosk. Он подключается к задачам с торговлей активами, NFT и расширениями Kiosk. CX Codex +1 162установок onchain-randomness Скилл onchain-randomness для Claude Code настраивает работу с генератором случайных чисел в смарт-контрактах Sui Move. Защищает функции от атак композиции и утечек состояния. CX Codex +1 162установок sui-bridge Объясняет работу Sui Bridge и помогает находить сведения о переводах между Sui и Ethereum. Подключается к вопросам о поддерживаемых активах, лимитах, финальности и управлении мостом. CX Codex +1 160установок

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

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