Derivación de PDA en el lado del cliente

Los clientes deben derivar las mismas PDA que las restricciones seeds en la cadena. Utiliza bytes de semilla, orden e ID de programa idénticos.

Receta

import { getAddressEncoder, getProgramDerivedAddress } from "@solana/kit";
 
const addressEncoder = getAddressEncoder();
 
const [pda] = await getProgramDerivedAddress({
  programAddress: programId,
  seeds: ["escrow", addressEncoder.encode(maker), u64ToLeBytes(escrowId)],
});

Cuándo recurrir a esto: Al crear transacciones que pasan cuentas PDA a instrucciones de Anchor.

Ejemplo funcional

import { address, getAddressEncoder, getProgramDerivedAddress } from "@solana/kit";
 
const programId = address("Fg6PaFpoGXkYsidMpWTK6W2BeZ7FEfcYkg476zPFsLnS");
 
// u64 -> 8 bytes little-endian, explícitamente. No confíes en el orden de bytes nativo
// del host a través de BigUint64Array#buffer.
function u64ToLeBytes(value: bigint): Uint8Array {
  const bytes = new Uint8Array(8);
  new DataView(bytes.buffer).setBigUint64(0, value, true);
  return bytes;
}
 
const [escrowPda] = await getProgramDerivedAddress({
  programAddress: programId,
  // getAddressEncoder convierte una dirección base58 en sus 32 bytes crudos.
  // getBytesEncoder NO haría esto; solo pasa bytes.
  seeds: [
    new TextEncoder().encode("escrow"),
    getAddressEncoder().encode(makerAddress),
    u64ToLeBytes(BigInt(escrowId)),
  ],
});
 
// Pasa escrowPda en el mapa de cuentas que coincide con el nombre de IDL "escrow"

Lo que esto demuestra:

• Las cadenas de semillas deben coincidir con los bytes b"escrow"
• Las Pubkeys se codifican como 32 bytes crudos
• Los enteros utilizan la misma endianidad que to_le_bytes de Rust
• El ID del programa es la dirección del programa de Anchor

Análisis en profundidad

@solana/kit 7.0.0

Utiliza los ayudantes de kit para la derivación de PDA y la codificación de direcciones. Comparte los constructores de semillas entre el programa (constantes de Rust) y el cliente (módulo TS) a través de la generación de código o constantes documentadas.

Pruebas

Asegura que la PDA del cliente coincida con los fixtures de prueba de Anchor para cada variante de semilla.

Errores comunes

• Desajuste entre cadena UTF-8 y cadena b - Semillas diferentes. Solución: Utiliza literales de semilla ASCII exactos.
• Semillas de enteros big-endian - Rust usa le en la cadena. Solución: Coincide con to_le_bytes.
• ID de programa incorrecto en el cliente - Deriva la dirección incorrecta. Solución: Lee de los metadatos de IDL o Anchor.toml.
• Bump opcional pasado incorrectamente - Generalmente se omite; el programa valida. Solución: Deja que la restricción en la cadena verifique el bump.
• Confusión entre Base58 y bytes - Errores de codificación. Solución: Utiliza tipos de dirección de kit.

Alternativas

Preguntas frecuentes

Relacionados

• PDAs en Anchor - semillas en la cadena
• Generación de clientes TS - generación de código de cliente
• Derivación de PDA - derivación nativa

Versiones de la pila: Esta página se escribió 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.