solders e solana-py

solders fornece primitivos Solana rápidos e tipados em Python; solana-py (import solana) envolve JSON-RPC, helpers de transação e assinaturas websocket. Juntos formam a stack Python off-chain padrão contra nós RPC Agave 4.1.1.

Receita

Cartão de receita de referência rápida - pronto para copiar e colar.

pip install solders solana
 
from solders.pubkey import Pubkey
from solders.keypair import Keypair
from solana.rpc.api import Client
 
client = Client("https://api.devnet.solana.com")
payer = Keypair()
balance = client.get_balance(payer.pubkey()).value

Quando usar isso:

• Construir bots ou backends que leem estado da chain e enviam transações.
• Precisar de performance nível Rust para serialização e manipulação de chaves em Python.
• Evitar tooling JS pesado quando sua equipe já roda serviços Python.
• Prototipar scripts de ops que espelham workflows Solana CLI 3.0.10.

Exemplo de Trabalho

import asyncio
from solders.keypair import Keypair
from solders.pubkey import Pubkey
from solders.system_program import TransferParams, transfer
from solders.hash import Hash
from solders.message import Message
from solders.transaction import VersionedTransaction
from solana.rpc.async_api import AsyncClient
from solana.rpc.types import TxOpts
 
RPC = "https://api.devnet.solana.com"
RECIPIENT = Pubkey.from_string("11111111111111111111111111111111")
 
async def main():
    payer = Keypair()
    async with AsyncClient(RPC) as client:
        bh_resp = await client.get_latest_blockhash()
        blockhash = Hash.from_string(str(bh_resp.value.blockhash))
 
        ix = transfer(
            TransferParams(
                from_pubkey=payer.pubkey(),
                to_pubkey=RECIPIENT,
                lamports=1_000,
            )
        )
        msg = Message.new_with_blockhash([ix], payer.pubkey(), blockhash)
        tx = VersionedTransaction(msg, [payer])
 
        sim = await client.simulate_transaction(tx)
        if sim.value.err:
            raise RuntimeError(sim.value.err)
 
        sig = await client.send_transaction(
            tx,
            opts=TxOpts(skip_preflight=True, preflight_commitment="confirmed"),
        )
        print("signature:", sig.value)
 
asyncio.run(main())

O que isso demonstra:

• solders constrói instruções, mensagens e transações versionadas.
• AsyncClient busca blockhashes e submete transações.
• Simulação detecta falhas antes de gastar taxa.
• VersionedTransaction é o padrão moderno em clusters Agave 4.x.

Deep Dive

Como Funciona

• solders faz bind a implementações Rust de tipos Solana (Pubkey, Keypair, Instruction, sysvars).
• solana-py implementa JSON-RPC 2.0 sobre HTTP/WebSocket com tipos compatíveis com solders.
• Serialização cruza a fronteira Python/Rust em caminhos quentes como assinatura e empacotamento de mensagem.
• Nenhum pacote compila programas on-chain - combine com Anchor 0.32.1 para trabalho de programa.

Responsabilidades dos Pacotes

Notas Python

# tipos solders são imutáveis - reconstrua em vez de mutar
from solders.instruction import Instruction, AccountMeta
 
# Prefira encodings explícitos em chamadas RPC
client.get_account_info(pubkey, encoding="base64")
 
# Async para leituras concorrentes em bots
async with AsyncClient(RPC) as client:
    await asyncio.gather(
        client.get_balance(pk1),
        client.get_balance(pk2),
    )

Armadilhas

• Misturar exemplos web3.js com solders - nomes de campos e formas de transação diferem. Correção: siga APIs de mensagem solders ponta a ponta.
• Matemática float de lamports - 0.1 * 1e9 introduz erros de arredondamento. Correção: apenas lamports inteiros.
• Blockhashes obsoletos em loops longos - transações expiram após ~60-90s. Correção: atualize blockhash a cada tentativa.
• get_program_accounts sem limite - pode causar OOM no processo. Correção: filtros memcmp e indexadores externos.
• Commitment padrão finalized - lento demais para bots. Correção: use confirmed ou processed explicitamente por chamada.

Alternativas

FAQs

Relacionado

• Noções Básicas de Python para Solana - intro da seção
• Construindo Transações em Python - assinatura e envio
• AnchorPy - clientes IDL Anchor
• Noções Básicas de RPC - conceitos JSON-RPC

Versões da stack: Esta página foi escrita para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, anchor-lang 0.32.1, Rust 1.91.1, @solana/kit 7.0.0, Surfpool 0.12.0 e LiteSVM 0.6.x.