JavaScript/TypeScript SDK для Solana

Solana Kit

@solana/kit — рекомендуемый TypeScript SDK для разработки на Solana. Вы собираете клиент из компонуемых плагинов, добавляете React-биндинги по мере необходимости и подключаете сгенерированные программные клиенты для вызываемых on-chain программ.

Пакет	Описание	GitHub
@solana/kit	Основной SDK: RPC, транзакции, кодеки, подписанты	Исходный код
@solana/react	React-биндинги: `ClientProvider` и хуки	Исходный код
@solana/kit-plugin-rpc	RPC-подключение + отправка транзакций	Исходный код
@solana/kit-plugin-signer	Плагины для плательщика комиссий, идентификации и подписи	Исходный код
@solana/kit-plugin-wallet	Подключение Wallet Standard + React-хуки	Исходный код

Программные клиенты

Сгенерированные клиенты, предоставляющие билдеры инструкций и клиентские плагины (например, tokenProgram() → client.token).

Пакет	Описание	GitHub
@solana-program/system	Взаимодействие с System Program	Исходный код
@solana-program/token	Взаимодействие с Token Program	Исходный код
@solana-program/token-2022	Взаимодействие с программой Token-2022	Исходный код
@solana-program/memo	Взаимодействие с программой Memo	Исходный код
@solana-program/compute-budget	Взаимодействие с программой Compute Budget	Исходный код

Подпись и управление ключами

Для совместимого с kit подписания на бэкенде с поддержкой нескольких систем управления ключами:

Пакет	Описание	GitHub
@solana/keychain	Единая подпись: Memory, Vault, Privy, Turnkey, AWS KMS, Fireblocks, GCP KMS, CDP, Para, Dfns, Crossmint, Openfort, Utila, Fordefi	Исходный код

Смотрите документацию Keychain и Выбор бэкенда для руководства по настройке и модели хранения.

Solana Web3.js v3

@solana/web3.js v3 — рекомендуемая версия web3.js. Она заново реализует классический API на основе классов — Connection, Keypair, Transaction, PublicKey — поверх внутренних компонентов @solana/kit, поэтому работает с примитивами Kit и клиентами программ, описанными выше. Используйте её, если вы обновляете существующее приложение на web3.js или предпочитаете API на основе классов.

Большинство методов, которые в устаревшем SDK были синхронными, например Keypair.generate() и transaction.sign(), теперь асинхронные.

npm install @solana/web3.js@3

Пакет	Описание	GitHub
@solana/web3.js	Основной SDK	Исходный код

@solana/spl-token зависит от @solana/web3.js (legacy) и не работает с v3. Вместо него используйте @solana-program/token или @solana-program/token-2022; их сгенерированные инструкции и планы инструкций напрямую работают с Transaction.add() из v3.

Solana Web3.js (устаревшая версия)

@solana/web3.js (устаревшая версия, 1.x) — оригинальный TypeScript SDK для Solana. Он находится в режиме поддержки и получает только критические исправления. Существующие кодовые базы могут перейти на web3.js v3 или мигрировать на Kit.