JavaScript/TypeScript SDK для Solana

Solana Kit

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

Пакет	Опис	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 (застарілої версії) і не працює на 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.