Busque em todas as páginas da documentação
Toda carteira faz os mesmos dois trabalhos - guardar um keypair e assinar transações com ele - mas diferem enormemente em como esse keypair é armazenado e quem pode disparar uma assinatura. Este tutorial percorre as cinco categorias de carteiras Solana que você vai encontrar, para que serve cada uma e por que um número crescente de equipes adiciona um multisig sobre todas elas.
Uma carteira não é um contêiner para seu SOL. Seu saldo vive on-chain, em uma conta que a rede já conhece. Uma carteira é o software ou hardware que guarda a chave privada dessa conta e a usa para assinar transações em seu nome.
Toda carteira Solana é construída em torno de um keypair - uma chave pública que identifica a conta e uma chave privada que prova propriedade. Se você já leu Keypairs e Endereços, é o mesmo keypair; uma carteira é simplesmente a camada de software que o armazena com segurança e pede sua aprovação antes de assinar.
A maioria das carteiras Solana é não custodial, o que significa que só você guarda a chave privada, e perdê-la significa perder acesso permanentemente - não há reset de senha. Um número menor de carteiras hospedadas em exchanges é custodial, o que significa que a exchange guarda a chave em seu nome e você confia que ela assinará corretamente.
O tipo de carteira que você escolhe é, na verdade, uma decisão sobre onde essa chave privada vive - em um processo de navegador, no seu celular, em um dispositivo físico separado, em um arquivo simples ou distribuída entre vários signatários que precisam concordar. Cada resposta troca conveniência por segurança de forma diferente.
| Termo | Significado em linguagem simples |
|---|---|
Non-custodial | Só você guarda a chave privada; nenhuma empresa pode recuperá-la ou congelá-la por você. |
Custodial | Um terceiro (geralmente uma exchange) guarda a chave privada em seu nome. |
Seed phrase | Uma frase de recuperação de 12-24 palavras que pode regenerar sua chave privada - quem tiver ela controla totalmente a carteira. |
Hot wallet | Carteira cujas chaves vivem em um dispositivo conectado à internet (navegador, celular, desktop). |
Cold wallet | Carteira cujas chaves são geradas e armazenadas em um dispositivo que nunca se conecta à internet. |
Air-gapped | Método de assinatura em que o dispositivo que guarda a chave nunca toca uma rede - transações são movidas via QR code ou USB. |
Multisig | Conta que exige assinaturas de múltiplas chaves aprovadas antes de uma transação ser considerada válida. |
M-of-N | Regra de limiar para um multisig - ex.: "2-of-3" significa que quaisquer 2 dos 3 signatários aprovados devem assinar. |
Os exemplos públicos em devnet ao longo deste guia usam um único arquivo keypair CLI, porque é a forma mais simples de acompanhar. Uso real parece diferente dependendo de quem assina e do que está em jogo.
Um indivíduo guardando uma pequena quantidade de SOL para testes tem necessidades muito diferentes de uma tesouraria de DAO com milhões de dólares em fundos da comunidade. O primeiro pode razoavelmente priorizar conveniência; o segundo não pode permitir que um único laptop comprometido drene a tesouraria.
Como regra geral, conveniência e segurança se movem em direções opostas. Carteiras de navegador são as mais rápidas de usar e as mais fáceis de comprometer via phishing; carteiras hardware são as mais lentas de usar e as mais difíceis de comprometer remotamente. Multisigs adicionam atrito (toda transação precisa de múltiplas aprovações) especificamente para remover o ponto único de falha que qualquer carteira - quente ou fria - ainda tem por si só.
Apps e extensões conectados à internet para uso diário, dApps, trading, NFTs e staking. Convenientes, mas menos seguras para grandes holdings.
Mais populares:
Apps para iOS/Android, frequentemente sobrepostas com carteiras de software quente, já que muitas também têm extensões de navegador. Ótimas para uso em movimento.
Mais populares:
Dispositivos físicos para armazenamento offline de chaves. Maior segurança para holdings de longo prazo; geralmente pareadas com software de carteira quente para assinatura.
Mais populares (menos opções dedicadas):
Ferramentas de linha de comando para desenvolvedores e usuários avançados. Minimalistas, scriptáveis, sem GUI - é o que todo exemplo CLI anterior neste guia usou.
Principais opções (não há muitas "populares" para consumidor):
~/.config/solana/id.json.solana).Um multisig não é uma carteira em que você entra pessoalmente - é uma conta on-chain controlada por um conjunto de signatários aprovados, cada um dos quais normalmente usa um dos tipos de carteira acima (frequentemente uma carteira hardware) para aprovar ou rejeitar uma transação proposta. Nada executa até signatários suficientes concordarem.
Mais populares:
Por que usar multisig? Um único keypair é um ponto único de falha - se aquele dispositivo, seed phrase ou chave for comprometido, tudo que controla se perde. Um multisig remove esse ponto único de falha exigindo, digamos, 2 de 3 ou 3 de 5 signatários aprovados para concordar antes de uma transação executar. Por isso tesourarias de DAO, fundos de empresas e autoridades de upgrade de programas geralmente ficam em multisig em vez da carteira de uma pessoa: nenhum laptop comprometido, signatário phishado ou membro de equipe saindo pode mover fundos ou empurrar um upgrade sozinho.
Notas: A maioria dos usuários individuais fica com carteiras não custodiais de autocustódia das quatro primeiras categorias. Popularidade é impulsionada por base de usuários (Phantom lidera com milhões de usuários), compatibilidade com dApps e recursos nativos Solana. Multisigs importam quando fundos ou autoridade são compartilhados entre mais de uma pessoa - sempre verifique premissas de segurança e use carteiras hardware para os signatários individuais em qualquer coisa com valor significativo. Dados refletem tendências do ecossistema em 2026 e mudam conforme novas carteiras e ferramentas surgem.
Para seguir os exemplos de código neste guia, um keypair CLI no sistema de arquivos basta - é o que solana-keygen já produz.
solana-keygen new --no-bip39-passphrase -o ./dev-keypair.json --force
solana-keygen pubkey ./dev-keypair.jsonEste keypair é um arquivo JSON simples. Trate-o como qualquer outro segredo - nunca faça commit e nunca reutilize um arquivo keypair de devnet para fundos em mainnet.
Qualquer ferramenta feita para usuários reais deve conseguir carregar o mesmo formato de arquivo que o CLI produz, para você testar localmente com o keypair exato que uma carteira assinaria de outra forma.
import { readFileSync } from "node:fs";
import { createKeyPairSignerFromBytes } from "@solana/kit";
const secretKeyBytes = new Uint8Array(
JSON.parse(readFileSync("./dev-keypair.json", "utf-8"))
);
const signer = await createKeyPairSignerFromBytes(secretKeyBytes);
console.log("Loaded signer:", signer.address);Quando você estiver testando um frontend real, um keypair CLI não pode aprovar um popup de navegador - você precisa de uma carteira de extensão como Phantom ou Solflare instalada e apontada para o mesmo cluster devnet que seu código usa.
// Detect an installed browser wallet before prompting for connection
const provider = (window as any).phantom?.solana;
if (!provider?.isPhantom) {
throw new Error("Install Phantom or another Solana wallet extension");
}
const { publicKey } = await provider.connect();
console.log("Connected wallet:", publicKey.toString());Antes de qualquer valor real estar envolvido, a chave de assinatura deve sair de um processo de navegador e ir para um dispositivo hardware, para que uma máquina comprometida não drene a conta silenciosamente.
# Point the CLI at a Ledger-backed keypair path instead of a JSON file
solana config set --keypair "usb://ledger?key=0"
solana balancePara qualquer coisa controlada por mais de uma pessoa - fundo de equipe, tesouraria de DAO, autoridade de upgrade de programa - o destino não é uma única carteira hardware, mas uma conta multisig que vários signatários com carteiras hardware controlam juntos.
# Conceptual - actual commands depend on the multisig tooling (e.g. Squads CLI/SDK)
# 1. Create a multisig with a signer list and threshold (e.g. 2-of-3)
# 2. Set the multisig's vault address as the program's upgrade authority
# or as the recipient of treasury funds
solana program set-upgrade-authority <PROGRAM_ID> --new-upgrade-authority <MULTISIG_VAULT_ADDRESS>// wallet-selection.ts - Solana Kit 7.0.0
import { readFileSync } from "node:fs";
import { createKeyPairSignerFromBytes, address } from "@solana/kit";
// Local dev: load a CLI file system keypair directly
async function loadDevSigner(path: string) {
const bytes = new Uint8Array(JSON.parse(readFileSync(path, "utf-8")));
return createKeyPairSignerFromBytes(bytes);
}
// Production reads: never assume a single signer - a treasury address
// may resolve to a multisig vault rather than a personal wallet
async function describeAuthority(authority: string) {
const knownMultisigVault = address("REPLACE_WITH_YOUR_SQUADS_VAULT");
const isMultisig = address(authority) === knownMultisigVault;
console.log(
isMultisig
? "Authority is a multisig vault - expect multiple approvals before changes land"
: "Authority is a single keypair - one signature is sufficient"
);
}
const devSigner = await loadDevSigner("./dev-keypair.json");
console.log("Dev signer:", devSigner.address);
await describeAuthority(devSigner.address);Esta é a forma na qual a maioria dos projetos reais converge: um keypair simples no sistema de arquivos para desenvolvimento local, uma carteira de navegador ou hardware para qualquer coisa que um humano assina diretamente, e um endereço de vault multisig - não uma chave pessoal - para qualquer coisa que a equipe ou uma DAO controla junto. Seu código de aplicativo basicamente só precisa saber com que tipo de endereço está lidando, já que um vault multisig assina da mesma forma que qualquer outra conta do ponto de vista da rede.
Muitas carteiras abrangem categorias - Phantom, Solflare e Backpack saem como extensão de navegador e app mobile. As categorias descrevem capacidade, não exigência de instalar cinco produtos diferentes.
Nenhum é inerentemente mais seguro - ambos armazenam chave privada em um computador de uso geral conectado à internet. Um arquivo keypair CLI é talvez mais exposto, já que não tem etapa de confirmação em popup; qualquer um é inadequado para grandes quantias comparado a uma carteira hardware.
Carteiras hardware são a forma mais comum de cold wallet - dispositivo dedicado que nunca expõe a chave privada ao seu computador. "Cold" de forma mais ampla só significa offline; uma paper wallet bem gerenciada também é cold, só sem a conveniência de um dispositivo.
Conta on-chain que exige assinaturas de múltiplas chaves aprovadas, não apenas uma, antes de qualquer transação que controla ser considerada válida.
Porque confiar na carteira de uma pessoa significa confiar que o dispositivo dela nunca será comprometido, que ela nunca sairá do projeto e que nunca errará sozinha. Um multisig distribui esse risco entre vários signatários independentes.
É a opção nativa Solana mais usada, mas não a única abordagem - SPL Governance/Realms lida com controle de tesouraria via votação de DAO, e o programa SPL Token suporta definir autoridade de mint ou freeze de um token diretamente para uma conta multisig sem produto de terceiros.
Sim - este é um dos usos mais comuns. Definir a autoridade de upgrade de um programa para um vault multisig significa que nenhum membro da equipe pode empurrar um upgrade unilateralmente.
Nada quebra imediatamente enquanto os signatários restantes ainda atingem o limiar (ex. 2 de 3 ainda disponíveis em setup 2-of-3). Perder signatários suficientes para ficar abaixo do limiar, porém, pode travar a conta permanentemente - escolha limiar e contagem de signatários com cuidado.
Não. Multisigs adicionam atrito real a toda transação e existem especificamente para remover ponto único de falha entre várias pessoas. Para fundos que só você controla, uma carteira hardware bem protegida é o passo adequado acima de uma carteira quente.
Não exatamente - este guia foca em carteiras não custodiais, onde você guarda a chave. Saldo custodial em exchange é controlado pela própria infraestrutura da exchange, que pode incluir multisig interno, mas você nunca guarda chave privada para isso.
Stack versions: This page was written for Agave 4.1.1, Solana CLI 3.0.10, @solana/kit 7.0.0, and Squads V4 (multisig program).
Revisado por Chris St. John·Última atualização: 19 de jul. de 2026