Keypairs e signers

Signers abstraem quem pode assinar transações e mensagens no @solana/kit.

Receita

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

import { generateKeyPairSigner, createKeyPairSignerFromBytes } from "@solana/kit";
 
const dev = await generateKeyPairSigner();
// ou carregue bytes JSON do solana-keygen

Quando usar:

• Scripts de servidor que pagam taxas com arquivo keypair.
• Testes que precisam de signers determinísticos.
• Conectar wallet adapters em mensagens kit.
• Assinatura de mensagens para auth (off-chain).

Exemplo prático

import {
  generateKeyPairSigner,
  createTransactionMessage,
  setTransactionMessageFeePayerSigner,
  setTransactionMessageLifetimeUsingBlockhash,
  appendTransactionMessageInstruction,
  signTransactionMessageWithSigners,
  createSolanaRpc,
} from "@solana/kit";
import { getTransferSolInstruction } from "@solana-program/system";
 
const rpc = createSolanaRpc("https://api.devnet.solana.com");
const payer = await generateKeyPairSigner();
const recipient = await generateKeyPairSigner();
 
const { value: bh } = await rpc.getLatestBlockhash().send();
 
let msg = createTransactionMessage({ version: 0 });
msg = setTransactionMessageFeePayerSigner(payer, msg);
msg = setTransactionMessageLifetimeUsingBlockhash(bh, msg);
msg = appendTransactionMessageInstruction(
  getTransferSolInstruction({ source: payer, destination: recipient.address, amount: 1_000n }),
  msg
);
 
const signed = await signTransactionMessageWithSigners(msg);

O que isso demonstra:

• Fee payer é um Signer, não string de public key bruta.
• signTransactionMessageWithSigners resolve signers embutidos na mensagem.
• Carteiras implementam a mesma interface de signer em runtime.

Mergulho profundo

Como funciona

• Keypairs Ed25519 mapeiam para Address (public key base58).
• KeyPairSigner mantém material secreto para scripts Node.
• Carteiras browser expõem TransactionSendingSigner sem revelar segredos.
• Caminhos de import CryptoKey existem para integrações Web Crypto.

Tipos de signer

Notas TypeScript

// Nunca logue ou serialize bytes de chave secreta
const { address } = await generateKeyPairSigner();

Erros comuns

• Fee payer apenas como string de endereço - mensagem não assina. Correção: setTransactionMessageFeePayerSigner.
• Commitar keypair JSON - risco de drenagem total da carteira. Correção: gitignore e secrets manager.
• Mesma chave no mainnet e devnet - gastos acidentais no mainnet. Correção: keypairs por cluster.
• Assumir wallet = fee payer - usuário pode rejeitar mismatch. Correção: alinhe pubkey conectada.
• Valores SOL float - perda de precisão. Correção: lamports bigint.

Alternativas

FAQs

Relacionados

• Construindo mensagens de transação - compor mensagens
• Assinatura e envio - broadcast
• Noções básicas de carteira - carteiras browser

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.