Derivação de PDA no Lado do Cliente

Clientes devem derivar as mesmas PDAs que as restrições de seeds on-chain. Use bytes de seed, ordem e program ID idênticos.

Receita

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

Quando usar isso: Construindo transações que passam contas PDA para instruções Anchor.

Exemplo prático

import { address, getAddressEncoder, getProgramDerivedAddress } from "@solana/kit";
 
const programId = address("Fg6PaFpoGXkYsidMpWTK6W2BeZ7FEfcYkg476zPFsLnS");
 
// u64 -> 8 bytes little-endian, explicitamente. Não confie na ordem de bytes nativa
// do host via 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 converte um Address base58 em seus 32 bytes brutos.
  // getBytesEncoder NÃO faria isso - ele apenas passa os bytes.
  seeds: [
    new TextEncoder().encode("escrow"),
    getAddressEncoder().encode(makerAddress),
    u64ToLeBytes(BigInt(escrowId)),
  ],
});
 
// Passe escrowPda no mapa de contas correspondendo ao nome "escrow" no IDL

O que isso demonstra:

• Strings de seed devem corresponder aos bytes de b"escrow"
• Pubkeys codificadas como 32 bytes brutos
• Inteiros usam a mesma endianness que to_le_bytes do Rust
• Program ID é o endereço do programa Anchor

Aprofundamento

@solana/kit 7.0.0

Use helpers do kit para derivação de PDA e codificação de endereço. Compartilhe construtores de seed entre o programa (constantes Rust) e o cliente (módulo TS) via codegen ou constantes documentadas.

Testes

Afirme que a PDA do cliente corresponde aos fixtures de teste do Anchor para cada variante de seed.

Armadilhas

• Mismatch de string UTF-8 vs b-string - Seeds diferentes. Correção: Use literais de seed ASCII exatos.
• Seeds inteiras big-endian - Rust usa le on-chain. Correção: Combine to_le_bytes.
• Program ID incorreto no cliente - Deriva endereço incorreto. Correção: Leia dos metadados do IDL ou Anchor.toml.
• Bump opcional passado incorretamente - Geralmente omita; o programa valida. Correção: Deixe a restrição on-chain verificar o bump.
• Confusão base58 vs bytes - Erros de codificação. Correção: Use tipos de endereço do kit.

Alternativas

FAQs

Relacionados

• PDAs no Anchor - seeds on-chain
• Geração de Clientes TS - codegen de cliente
• Derivação de PDA - derivação nativa

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.