Solana Mainnet, Devnet & Testnet Explicados

Mainnet, Devnet e Testnet na Solana servem propósitos diferentes: a Mainnet-Beta tem valor económico real, a Devnet apoia o desenvolvimento de aplicações e a Testnet é utilizada principalmente para testes de validador e protocolo. A Localnet fornece um ambiente local separado para desenvolvimento controlado.

Se já passou algum tempo a ler a documentação da Solana ou a seguir tutoriais, já viu os termos Mainnet-Beta, Devnet e Testnet repetidos em todos os guias. A maioria dos recursos nomeia-os sem responder à pergunta que realmente importa: qual deles deve usar agora e o que acontece se escolher o errado?

A Solana é uma blockchain de Camada 1 de alto desempenho que utiliza um mecanismo de consenso chamado Proof of History (PoH) combinado com Proof of Stake para alcançar um elevado débito de transações. O seu token nativo é o SOL, utilizado para pagar taxas de transação em toda a rede. A Solana opera quatro ambientes de rede distintos e, na terminologia da Solana, cada um destes é chamado de cluster. Mainnet-Beta, Devnet, Testnet e Localnet são todos clusters da Solana, cada um com os seus próprios validadores, histórico de transações e estado de contas.

Ao final deste guia, saberá exatamente para que serve cada cluster, qual deles se adapta à sua situação atual e os comandos precisos, endpoints RPC e passos de carteira necessários para se ligar a qualquer um deles.

Mainnet, Devnet e Testnet na Solana

A Solana opera quatro ambientes de rede paralelos. Cada cluster serve uma fase específica do ciclo de vida de desenvolvimento e implementação, de forma semelhante à forma como as equipas de software tradicionais separam os ambientes de desenvolvimento da produção.

Aqui está uma descrição de uma frase para cada uma:

• Mainnet-Beta é a rede de produção em direto onde o SOL real é utilizado e onde ocorre toda a atividade do mundo real.
• Devnet é a principal sandbox de programadores onde as aplicações são construídas e testadas com SOL gratuito e sem valor.
• Testnet é um ambiente de testes de esforço utilizado por operadores de validadores e engenheiros do protocolo principal antes de as alterações chegarem à Mainnet-Beta.
• Localnet é um cluster privado da Solana que corre inteiramente na sua própria máquina, sem necessidade de ligação à internet.

Pode encontrar a visão geral oficial de todos os clusters da Solana na documentação de clusters da Solana. Começando pela Mainnet-Beta, aqui está o que cada ambiente faz e quando deve ser utilizado.

Solana Mainnet-Beta: A Rede de Produção em Direto

A Mainnet-Beta é a rede de produção em direto da Solana, o ambiente onde ocorre toda a atividade económica real na blockchain Solana. Apesar do "Beta" no seu nome, esta não é uma rede de testes. A designação é um artefacto histórico do lançamento da Solana em 2020 e não implica que a rede esteja incompleta ou seja experimental. A Solana tem operado a Mainnet-Beta como o seu ambiente de produção total desde o lançamento.

Todas as dApps (aplicações descentralizadas) em direto, protocolos de DeFi, marketplaces de NFT e projetos de tokens correm na Mainnet-Beta. Todas as transações reais de SOL que envia ou recebe acontecem aqui.

O SOL na Mainnet-Beta tem valor monetário real. As transações exigem SOL real para pagar taxas, normalmente uma fração de um cêntimo por transação. As implementações de programas custam SOL real e são permanentes e irreversíveis. O endpoint RPC público para a Mainnet-Beta é https://api.mainnet-beta.solana.com.

⚠️ Aviso: Qualquer transação ou implementação de programa na Mainnet-Beta utiliza SOL real e não pode ser revertida. Teste sempre na Devnet antes de implementar na produção.

💡 Dica: Verifique as transações da Mainnet-Beta no Solana Explorer. Utilize o seletor de cluster no canto superior direito para confirmar que está a visualizar o cluster Mainnet-Beta.

Solana Devnet: A Sandbox do Programador

A Devnet é a principal sandbox de programadores da Solana, um cluster público onde pode construir e testar programas sem arriscar um único SOL real. Para a maioria dos programadores Solana, a Devnet é o local onde todo o trabalho de desenvolvimento acontece.

O SOL da Devnet tem valor monetário real zero. É uma moeda de teste gratuita obtida através de uma faucet e não pode ser transferida para a Mainnet-Beta ou trocada por SOL real. O endpoint RPC público para a Devnet é https://api.devnet.solana.com.

A Devnet reinicia periodicamente, o que significa que os programas implementados e os saldos das contas podem ser apagados sem aviso prévio. Os programadores devem tratar o estado da Devnet como temporário e nunca depender dele para dados de produção.

Obter SOL Grátis na Devnet

Uma faucet é um serviço que distribui SOL de teste gratuito na Devnet ou Testnet. O método mais rápido é o comando de Airdrop do CLI da Solana. Note que, neste contexto, "Airdrop" refere-se a um comando de ferramenta de programador para solicitar tokens de teste, e não a uma distribuição de tokens de marketing.

Execute este comando para solicitar 2 SOL na Devnet:

solana airdrop 2

O Airdrop via CLI está limitado a 2 SOL por pedido e aplica restrições de frequência. Se o comando solana airdrop devolver um erro de limite de taxa, aguarde alguns minutos e tente novamente, ou utilize uma destas faucets baseadas na web:

• faucet.solana.com (faucet oficial da Solana)
• solfaucet.com (faucet da comunidade)

💡 Dica: Visualize as suas transações da Devnet no Solana Explorer selecionando "Devnet" no seletor de clusters.

Os NFTs de teste cunhados na Devnet não têm valor real e existem apenas dentro do cluster Devnet. Não são os mesmos ativos que os NFTs na Mainnet-Beta.

A Devnet é o ambiente certo para a vasta maioria dos programadores Solana. Se está apenas a começar, comece por aqui. Para uma visão comparativa de como a Devnet se compara à Testnet e à Mainnet-Beta em todas as dimensões principais, consulte a tabela de comparação completa da rede abaixo.

Solana Testnet: Testes de Validador e Protocolo

A Testnet é o ambiente de rede da Solana para operadores de validadores e engenheiros do protocolo principal, não para programadores de aplicações que constroem dApps ou programas. Compreender esta distinção poupa muita confusão.

Os validadores são os nós que processam e confirmam transações na rede Solana. A Testnet existe especificamente para que os operadores de validadores possam testar novo software de nós e atualizações de protocolo antes que essas alterações sejam aplicadas à Mainnet-Beta. A equipa de engenharia principal da Solana utiliza a Testnet para testar o desempenho e novas funcionalidades sob condições realistas.

A Testnet é intencionalmente menos estável do que a Devnet. Interrupções e reinícios são mais comuns porque a rede foi concebida para ser levada ao limite até falhar. O endpoint RPC público é https://api.testnet.solana.com.

O SOL da Testnet tem valor monetário real zero, idêntico ao SOL da Devnet.

💡 Recomendação: Se estiver a construir uma dApp, um programa ou um token na Solana, utilize a Devnet, e não a Testnet. A Testnet não foi concebida para o desenvolvimento de aplicações e a sua instabilidade torna-a uma má escolha para testar o seu código.

Localnet: O Seu Validador de Teste Local

A Localnet, também chamada de validador de teste local, corre inteiramente na sua própria máquina e não requer ligação à internet. É o quarto tipo de cluster da Solana, embora a maioria dos guias o omita.

Inicie a Localnet com este comando:

solana-test-validator

Uma vez em execução, a Localnet está acessível em http://localhost:8899. Ao contrário da Devnet, a Localnet não é uma rede pública partilhada. Apenas a sua máquina local pode vê-la, e ela reinicia cada vez que reinicia o processo do validador.

A Localnet é ideal para iterações rápidas e privadas durante o desenvolvimento inicial. Como não há latência de rede, o Feedback das interações do programa é imediato. O fluxo de trabalho de desenvolvimento padrão é construir e testar localmente na Localnet primeiro, depois implementar na Devnet para testes partilhados e, finalmente, implementar na Mainnet-Beta para produção.

A Devnet difere da Localnet de uma forma fundamental: a Devnet é uma rede pública partilhada que qualquer pessoa pode aceder, o que significa que os seus programas implementados são visíveis para outros desenvolvedores e os seus testes correm contra o estado da rede partilhada.

Comparação da Rede Solana: Mainnet vs Devnet vs Testnet vs Localnet

A tabela abaixo compara os quatro ambientes de rede Solana em sete dimensões para ajudar a escolher o cluster certo para a sua situação.

Orientação para decisão:

Os desenvolvedores de aplicações que constroem dApps ou programas devem usar a Devnet para todos os testes. Os operadores de validadores pertencem à Testnet. Para iteração local rápida, a Localnet é a opção mais veloz. Apenas implemente na Mainnet-Beta quando o seu programa estiver totalmente testado e pronto para produção.

Para instruções de implementação passo a passo nos clusters, consulte a secção de implementação de programas abaixo.

RPC Solana Endpoints para cada rede

Um endpoint RPC é o URL que a sua aplicação, CLI ou carteira utiliza para enviar pedidos a um cluster Solana. RPC significa Remote Procedure Call (Chamada de Procedimento Remoto), mas a definição prática é tudo o que precisa: é o endereço para o qual as suas ferramentas apontam para ler e escrever numa rede específica.

Os endpoints RPC públicos têm taxas limitadas e não são adequados para aplicações de produção de alto tráfego. Para utilização da Mainnet-Beta em produção, fornecedores de RPC de terceiros como Helius, QuickNode e Alchemy oferecem limites de taxa mais elevados e ferramentas adicionais. Para todo o trabalho de desenvolvimento e teste na Devnet, o endpoint público é suficiente.

Tanto a Solana CLI como a biblioteca @solana/web3.js aceitam estes URLs diretamente. As secções seguintes mostram exatamente como configurar cada ferramenta.

Como alternar entre redes Solana usando a CLI

A Solana CLI principal (o comando solana, não a Anchor CLI ou a biblioteca web3.js) controla a qual cluster as suas ferramentas se ligam. Toda a configuração da rede passa por solana config.

Siga estes passos para verificar e alterar o seu cluster ativo:

1. Verifique a sua configuração de rede atual.

Este comando mostra o seu URL RPC atual, confirmando a qual cluster está ligado.

solana config get

2. Mudar para a Devnet.

solana config set --url devnet

3. Mudar para a Testnet.

solana config set --url testnet

4. Mudar para a Mainnet-Beta.

solana config set --url mainnet-beta

5. Mudar para a Localnet.

solana config set --url localhost

6. Solicitar um Airdrop de SOL na Devnet após a mudança.

solana airdrop 2

Os nomes curtos (devnet, testnet, mainnet-beta) mapeiam diretamente para os endpoints RPC públicos listados na referência de endpoints RPC da Solana acima. Usar solana config set --url devnet é equivalente a passar o URL completo https://api.devnet.solana.com.

Se solana config get mostrar um URL de cluster inesperado, outra ferramenta ou script pode ter atualizado a sua configuração. Execute o comando solana config set --url apropriado para o corrigir antes de fazer qualquer outra coisa.

⚠️ Aviso: Execute sempre solana config get antes de implementar um programa ou enviar uma transação. Implementar na Mainnet-Beta quando pretendia a Devnet custará SOL real e não pode ser desfeito.

Ligar a redes Solana com web3.js

A biblioteca @solana/web3.js é a biblioteca oficial de JavaScript e TypeScript para interagir com clusters Solana. Fornece uma função de conveniência chamada clusterApiUrl() que devolve o URL RPC público para um cluster nomeado.

Utilize o seguinte código para se ligar a cada rede:

import { Connection, clusterApiUrl } from '@solana/web3.js';

// Ligar à Devnet
const connection = new Connection(clusterApiUrl('devnet'), 'confirmed');

// Ligar à Mainnet-Beta
const connection = new Connection(clusterApiUrl('mainnet-beta'), 'confirmed');

// Ligar à Testnet
const connection = new Connection(clusterApiUrl('testnet'), 'confirmed');

Codificar o URL RPC diretamente é igualmente válido e dá-lhe mais controlo:

// Utilizar um URL RPC explícito
const connection = new Connection('https://api.devnet.solana.com', 'confirmed');

Para aplicações Mainnet-Beta em produção, substitua o URL público pelo seu endpoint RPC privado de um fornecedor de terceiros. A função clusterApiUrl() devolve apenas endpoints públicos.

A Solana web3.js é uma biblioteca separada do cliente TypeScript da Anchor Framework. Ambas podem ser usadas em conjunto no mesmo projeto, mas servem camadas diferentes da stack. Após a ligação, pode verificar as suas transações no Solana Explorer, selecionando o cluster correspondente no seletor no canto superior direito. Consulte a referência da biblioteca Solana web3.js) para obter a API completa.

Implementar Programas Solana entre Redes

Um programa Solana é o termo da Solana para código executável na blockchain que processa instruções de clientes (equivalente a um Smart Contract no Ethereum). Os programas são específicos do cluster.

Um programa implementado na Devnet não existe na Mainnet-Beta. Cada cluster mantém o seu próprio estado completamente independente, e deve implementar o seu programa separadamente em cada rede onde deseja que ele corra. Este é o motivo mais comum pelo qual os desenvolvedores não conseguem encontrar o seu programa após a implementação: implementaram na Devnet mas estão à procura na Mainnet-Beta, ou vice-versa.

Configurar o Anchor para Implementação

A Anchor Framework é uma estrutura de desenvolvimento de programas Solana amplamente utilizada. A configuração do cluster de destino vive no seu ficheiro Anchor.toml na secção [provider]:

[provider]
cluster = "devnet"
wallet = "~/.config/solana/id.json"

Para implementar na Mainnet-Beta, altere o valor de cluster para "mainnet-beta" e execute:

anchor deploy

Atualize sempre o Anchor.toml antes de executar anchor deploy. A Anchor CLI (anchor) é uma ferramenta separada da Solana CLI (solana). Ambas podem estar em uso durante o mesmo fluxo de trabalho. Consulte a documentação da Anchor Framework para as opções de configuração completas.

Fluxo de Trabalho de Implementação Recomendado

Siga esta sequência antes de qualquer lançamento na Mainnet-Beta:

1. Construa e teste localmente usando a Localnet.
2. Implemente e teste na Devnet.
3. (Opcional, para programas relacionados com validadores) Teste na Testnet.
4. Implemente na Mainnet-Beta apenas quando o programa estiver totalmente validado.

⚠️ Aviso: Antes de implantar em Mainnet-Beta, verifique a configuração do seu cluster em Anchor.toml ou execute solana config get. Uma implantação em Mainnet-Beta custa SOL real e não pode ser desfeita.

SOL Real vs. Teste: Compreender o Valor Através das Redes

SOL em Mainnet-Beta tem valor monetário real. SOL em Devnet e Testnet tem valor monetário real zero; é moeda de teste gratuita sem taxa de câmbio e sem percurso de conversão para Mainnet-Beta.

Aqui está a análise completa:

• SOL Mainnet-Beta: valor monetário real, negociável em exchanges, necessário para pagar taxas de transação.
• SOL Devnet: gratuito, obtido via faucet, sem valor de câmbio, não pode ser transferido para Mainnet-Beta.
• SOL Testnet: gratuito, obtido via faucet, sem valor de câmbio, não pode ser transferido para Mainnet-Beta.

⚠️ Aviso: SOL Devnet e Testnet não podem ser convertidos para SOL real nem transferidos para Mainnet-Beta. Não tente negociar ou vender SOL Devnet ou Testnet. Não tem valor fora do seu respetivo cluster.

O rótulo "Beta" em Mainnet-Beta causou confusão persistente desde o lançamento de Solana em 2020. Mainnet-Beta não é um produto beta em qualquer sentido significativo; processou milhares de milhões de dólares em transações de DeFi e NFT e é a única rede onde ocorre atividade Solana no mundo real. O nome é uma convenção histórica que a Solana manteve.

Se o seu Saldo Phantom aparecer como zero após uma mudança de rede, a secção de mudança de redes na carteira Phantom acima explica como restaurar a sua vista Mainnet-Beta.

Este artigo é de natureza educativa e técnica. Não constitui aconselhamento financeiro nem endosso de qualquer investimento em criptomoeda.

Recursos relacionados com a Arquitetura Solana

Os conceitos de implantação conectam-se ao modelo de conta Solana para programadores, enquanto o desempenho de Mainnet-Beta depende da arquitetura descrita em porquê Solana é rápida e barata. Apenas SOL mainnet tem valor de mercado: a página de preços SOL) e o mercado Spot SOL/USDT) aplicam-se a SOL mainnet, não a tokens Devnet, Testnet ou Localnet.

FAQ: Mainnet, Devnet e Testnet na Solana

A Solana Mainnet-Beta é a rede real Mainnet?

Sim. Mainnet-Beta é a rede de produção ativa totalmente operacional da Solana. O rótulo "Beta" é uma convenção de nomenclatura histórica desde o lançamento da Solana em 2020 e não indica que a rede é experimental ou incompleta. Todas as transações SOL reais, dApps, protocolos de DeFi e projetos de NFT operam em Mainnet-Beta.

O SOL Devnet tem valor real?

Não. O SOL Devnet não tem valor monetário real. É moeda de teste gratuita dispensada por uma torneira (faucet) e existe apenas no cluster Devnet. Não pode ser transferido para Mainnet-Beta, trocado por SOL real, nem utilizado em qualquer exchange.

Posso usar SOL Devnet na Mainnet?

Não. Devnet e Mainnet-Beta são redes completamente separadas, sem estado partilhado. SOL existe independentemente em cada cluster. Não existe mecanismo para transferir SOL Devnet para Mainnet-Beta.

Porque é que não vejo o meu SOL na minha carteira?

A carteira pode estar ligada a Devnet ou Testnet em vez de Mainnet-Beta. Verifique a configuração de rede atual e o endereço da carteira utilizando a sua documentação de suporte mais recente e, em seguida, religue a Mainnet-Beta. Verifique o endereço num explorador de blocos correspondente antes de assumir que qualquer Saldo se moveu.

Qual é a diferença entre Devnet e Testnet na Solana?

Devnet é projetada para programadores de aplicações que criam dApps e programas. É estável, tem uma torneira (faucet) funcional e é o ambiente recomendado para todo o trabalho de desenvolvimento. Testnet é projetada para operadores de validadores e engenheiros de protocolo principais para testar software novo sob stress. É intencionalmente menos estável e não adequada para desenvolvimento de aplicações.

O que é um cluster Solana?

Um cluster Solana é um ambiente de rede, o termo que Solana usa para o que outras blockchains chamam de rede ou cadeia. Mainnet-Beta, Devnet, Testnet e Localnet são todos clusters Solana. Cada cluster é uma rede independente com os seus próprios validadores, histórico de transações e estado de conta.

Qual é a diferença entre Localnet e Devnet?

Localnet é executado inteiramente na sua própria máquina e não requer ligação à internet, tornando-o o ambiente de teste mais rápido disponível. Devnet é uma rede pública partilhada a que qualquer pessoa pode aceder. Use Localnet para iteração local rápida, depois implante para Devnet para testar num ambiente partilhado antes de passar para Mainnet-Beta.

Porque é que a minha transação falhou na Solana?

Se a sua transação falhou inesperadamente, verifique primeiro se está ligado ao cluster correto. Execute solana config get na CLI ou verifique o indicador de rede na sua carteira. Uma causa comum de falhas de transação é estar ligado à rede errada. Por exemplo, tentar interagir com um programa Mainnet-Beta enquanto a sua CLI ou carteira está apontada para Devnet fará com que a transação falhe.

Resumo: Qual Rede Solana Deve Utilizar?

A rede correta depende inteiramente do que está a fazer. Aqui está a decisão mapeada para cada caso de uso:

• Construir ou testar um programa ou dApp Solana → Usar Devnet
• Desenvolvimento e iteração local rápida → Usar Localnet
• Executar ou testar um nó validador → Usar Testnet
• Lançar uma aplicação de produção para utilizadores reais → Implantar em Mainnet-Beta
• Usar SOL real para transações, DeFi, ou NFTs → Mainnet-Beta (o padrão)

Em caso de dúvida, comece em Devnet. É o ambiente mais seguro, estável e acessível para qualquer pessoa que comece no desenvolvimento Solana.

Para referência adicional, consulte a documentação oficial dos clusters Solana) e verifique qualquer transação no Solana Explorer.