JavaScript/TypeScript SDK para Solana

Solana Kit

@solana/kit é o SDK TypeScript recomendado para desenvolver na Solana. Você monta um cliente a partir de plugins combináveis, adiciona bindings React quando necessário e importa clientes de programa gerados para os programas on-chain que você utiliza.

Pacote	Descrição	GitHub
@solana/kit	SDK principal: RPC, transações, codecs, signatários	Fonte
@solana/react	Bindings React: `ClientProvider` e hooks	Fonte
@solana/kit-plugin-rpc	Conexão RPC + envio de transações	Fonte
@solana/kit-plugin-signer	Plugins de pagador de taxas, identidade e signatário	Fonte
@solana/kit-plugin-wallet	Conexão Wallet Standard + hooks React	Fonte

Clientes de programa

Clientes gerados que expõem construtores de instruções e plugins de cliente (por exemplo tokenProgram() → client.token).

Pacote	Descrição	GitHub
@solana-program/system	Interagir com o System Program	Fonte
@solana-program/token	Interagir com o Token Program	Fonte
@solana-program/token-2022	Interagir com o programa Token-2022	Fonte
@solana-program/memo	Interagir com o programa Memo	Fonte
@solana-program/compute-budget	Interagir com o programa Compute Budget	Fonte

Assinatura e Gestão de Chaves

Para assinatura backend compatível com kit em múltiplos backends de gestão de chaves:

Pacote	Descrição	GitHub
@solana/keychain	Assinatura unificada: Memory, Vault, Privy, Turnkey, AWS KMS, Fireblocks, GCP KMS, CDP, Para, Dfns, Crossmint, Openfort, Utila, Fordefi	Fonte

Consulte a documentação do Keychain e Escolhendo um backend para orientações sobre configuração e modelo de custódia.

Solana Web3.js v3

@solana/web3.js v3 é a versão recomendada do web3.js. Ele reconstrói a API clássica baseada em classes — Connection, Keypair, Transaction, PublicKey — sobre os componentes internos do @solana/kit, de modo que funciona com as primitivas do Kit e com os clientes de programa acima. Use-o se estiver atualizando uma aplicação web3.js existente ou preferir a API baseada em classes.

A maioria dos métodos que eram síncronos no SDK legado, como Keypair.generate() e transaction.sign(), agora são assíncronos.

npm install @solana/web3.js@3

Pacote	Descrição	GitHub
@solana/web3.js	SDK principal	Fonte

@solana/spl-token depende de @solana/web3.js (legado) e não funciona na v3. Use @solana-program/token ou @solana-program/token-2022; as instruções geradas e os planos de instruções desses pacotes funcionam diretamente com o Transaction.add() da v3.

Solana Web3.js (legado)

@solana/web3.js (legado, 1.x) é o SDK TypeScript original para Solana. Está em modo de manutenção e recebe apenas correções críticas. As bases de código existentes podem atualizar para o web3.js v3 ou migrar para o Kit.