Skip to main content
Neste guia, você implantará um programa real na devnet e o invocará, com todo o fluxo rodando na infraestrutura Helius. Você financiará uma carteira com requestAirdrop, implantará um programa de exemplo pré-construído, e então o chamará com sendTransaction e confirmará o resultado com getSignatureStatuses. Usar um programa pronto mantém o foco no ciclo de implantação e invocação em vez de escrever em Rust.
Pré-requisitos: o Solana CLI e Rust (para construir o programa), Node.js 18+ (para invocá-lo) e uma chave de API Helius. Devnet funciona em todo plano Helius.

1

Aponte o Solana CLI para o seu Helius devnet RPC

Use seu endpoint Helius para cada comando CLI e crie uma carteira se não tiver uma:
solana address imprime a chave pública da sua carteira, que você financiará em seguida.
2

Obtenha SOL na devnet

Implantar custa um pouco de SOL. SOL na devnet é gratuito e serve apenas para testes, então financie seu endereço com o faucet abaixo ou a partir do CLI:
Os faucets da devnet são limitados por taxa, então um airdrop pode falhar. Se isso acontecer, aguarde um momento e tente novamente, ou use o faucet web oficial da devnet como alternativa. Implantar o programa de exemplo precisa de apenas ~1 SOL.
3

Clone e construa o programa de exemplo

Obtenha o programa “Hello, Solana!” do repositório oficial de exemplos de programas da Solana. Ele apenas registra uma saudação quando invocado, o que é aproximadamente o menor programa que ainda prova que o ciclo completo funciona.
program-examples é um workspace Cargo, então cargo build-sbf compila o programa para target/deploy/hello_solana_program.so na raiz do repositório (não dentro da pasta do programa). Permaneça no diretório program-examples para o próximo passo.
4

Implante na devnet através do Helius

O CLI submete a transação de implantação através do seu Helius RPC e imprime o Id do Programa. Copie-o, pois você invocará este programa em seguida.
5

Invoque o programa com sendTransaction

Em uma pasta nova, configure um pequeno cliente TypeScript que construa uma transação, envie-a e a confirme.
invoke.ts
Substitua YOUR_API_KEY e YOUR_PROGRAM_ID, depois execute:
Você receberá uma assinatura e um link do Explorer. Abra o link e expanda Logs de Instrução do Programa para ver a saudação Hello, Solana! do programa.

O que está acontecendo

Tudo é roteado através do seu Helius RPC

solana config set --url aponta cada comando CLI (airdrop, deploy e as verificações de saldo) para seu endpoint Helius devnet. O cliente TypeScript usa o mesmo endpoint, então todo o fluxo roda na infraestrutura Helius.

O ciclo de invocação: enviar e depois confirmar

sendRawTransaction chama o método RPC sendTransaction internamente e retorna uma assinatura imediatamente, antes que a rede tenha processado a transação. É por isso que você consulta getSignatureStatuses até que confirmationStatus atinja confirmed, verificando err para capturar falhas. Este padrão de enviar e depois confirmar é a base de cada transação Solana que você submeterá.

Próximos passos

Como Obter SOL na Devnet

Todas as maneiras de financiar uma carteira devnet, além de dicas de limite de taxa.

sendTransaction

Todos os parâmetros, incluindo skipPreflight, preflightCommitment e retries.

Pouse transações de forma confiável

Quando você for para a mainnet, use Sender para pouso de baixa latência.

Construa um rastreador de portfólio

Outro caminho: obtenha tokens, NFTs e SOL de qualquer carteira, com um feed de atividade ao vivo.