Keypairs & Signers

Los signers (firmantes) abstraen quién puede firmar transacciones y mensajes en @solana/kit.

Receta

Tarjeta de receta de referencia rápida, lista para copiar y pegar.

import { generateKeyPairSigner, createKeyPairSignerFromBytes } from "@solana/kit";
 
const dev = await generateKeyPairSigner();
// o cargar bytes JSON de solana-keygen

Cuándo usar esto:

• Scripts de servidor que pagan tarifas con un archivo keypair.
• Pruebas que necesitan signers deterministas.
• Integración de adaptadores de wallet en mensajes de kit.
• Firma de mensajes para autenticación (off-chain).

Ejemplo de Trabajo

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);

Lo que esto demuestra:

• El pagador de tarifas es un Signer, no una cadena de clave pública en bruto.
• signTransactionMessageWithSigners resuelve los signers incrustados en el mensaje.
• Las wallets implementan la misma interfaz de signer en tiempo de ejecución.

Análisis Profundo

Cómo Funciona

• Los keypairs Ed25519 se mapean a Address (clave pública base58).
• KeyPairSigner contiene material secreto para scripts de Node.
• Las wallets del navegador exponen TransactionSendingSigner sin revelar secretos.
• Existen rutas de importación de CryptoKey para integraciones de Web Crypto.

Tipos de Signer

Notas de TypeScript

// Nunca registres ni serialices los bytes de la clave secreta
const { address } = await generateKeyPairSigner();

Errores Comunes

• Pagador de tarifas solo como cadena de dirección - el mensaje no se firmará. Solución: setTransactionMessageFeePayerSigner.
• Confirmar JSON de keypair - riesgo total de drenaje de wallet. Solución: gitignore y gestor de secretos.
• Usar la misma clave en mainnet y devnet - gastos accidentales en mainnet. Solución: keypairs por clúster.
• Asumir que la wallet = pagador de tarifas - el usuario puede rechazar la discrepancia del pagador de tarifas. Solución: alinear la clave pública conectada.
• Cantidades de SOL en punto flotante - pérdida de precisión. Solución: lamports bigint.

Alternativas

Preguntas Frecuentes

Relacionado

• Construcción de Mensajes de Transacción - componer mensajes
• Firma y Envío - transmitir
• Conceptos Básicos de Wallet - wallets del navegador

Versiones de Stack: Esta página fue 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, y LiteSVM 0.6.x.