Lectura de Assets Comprimidos (DAS)

Los NFT comprimidos no tienen cuentas por asset legibles a través de getAccountInfo. Las aplicaciones de producción utilizan la API DAS para obtener metadatos de assets, campos de compresión y pruebas de Merkle para transferencias.

Receta

const asset = await dasRpc("getAsset", { id: "CNFT_ID" });
const proof = await dasRpc("getAssetProof", { id: "CNFT_ID" });

const collection = await dasRpc("getAssetsByGroup", {
  groupKey: "collection",
  groupValue: "COLLECTION_ID",
  page: 1,
  limit: 100,
});

Cuándo recurrir a esto:

• Renderizar galerías de cNFT en wallets
• Obtener pruebas antes de construir transacciones de transferencia
• Verificar el ID del árbol y el índice de la hoja para depuración
• Dashboards de colecciones después de minteos masivos

Ejemplo Funcional

const DAS_RPC = process.env.DAS_RPC_URL!;
 
async function dasRpc<T>(method: string, params: unknown): Promise<T> {
  const res = await fetch(DAS_RPC, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ jsonrpc: "2.0", id: 1, method, params }),
  });
  const json = await res.json();
  if (json.error) throw new Error(json.error.message);
  return json.result as T;
}
 
type DasAsset = {
  id: string;
  compression?: {
    eligible: boolean;
    compressed: boolean;
    leaf_id: number;
    tree: string;
    seq: number;
  };
  content?: { metadata?: { name?: string } };
};
 
type AssetProof = {
  root: string;
  proof: string[];
  node_index: number;
  leaf: string;
  tree_id: string;
};
 
const assetId = "CNFT_ASSET_ID_FROM_PRIOR_QUERY";
 
const asset = await dasRpc<DasAsset>("getAsset", { id: assetId });
console.log("nombre:", asset.content?.metadata?.name);
console.log("árbol:", asset.compression?.tree);
console.log("hoja:", asset.compression?.leaf_id);
 
const proof = await dasRpc<AssetProof>("getAssetProof", { id: assetId });
console.log("nodos de prueba:", proof.proof.length);
console.log("raíz:", proof.root);

import { createSolanaRpc } from "@solana/kit";
 
// RPC estándar para enviar transacciones; DAS para lecturas y pruebas
const txRpc = createSolanaRpc(process.env.RPC_URL!);

Lo que esto demuestra:

• getAsset devuelve metadatos de compression para cNFTs
• getAssetProof suministra hashes hermanos para instrucciones de Bubblegum
• Usa consistentemente el id devuelto por DAS, no solo la clave pública del árbol

Análisis Profundo

Cómo Funciona

• El indexador rastrea eventos de Bubblegum y actualizaciones de cuentas de árbol
• DAS normaliza los assets comprimidos junto con Core y Token Metadata
• getAssetProof debe coincidir con la raíz actual; actualiza antes de construir la transacción
• getAssetsByGroup lista los cNFTs de la colección con paginación

Campos DAS para cNFTs

Notas de TypeScript

// Cachear metadatos de assets por más tiempo que las pruebas
// TTL de pruebas: segundos a minutos durante ventanas de minteo activas

Errores Comunes

• Usar la clave pública de minteo como ID de cNFT: la búsqueda en DAS falla. Solución: usar el id de getAssetsByOwner.
• Prueba obsoleta: la transacción falla con discrepancia de raíz. Solución: volver a obtener la prueba inmediatamente antes de firmar.
• No hay DAS en RPC público: método faltante. Solución: URL del proveedor con DAS habilitado.
• Saltos de paginación: colección incompleta durante el minteo. Solución: paginar hasta obtener una página vacía después de que termine el minteo.
• Ignorar seq: problemas raros de actualización concurrente. Solución: incluir el último seq del asset en el constructor de transferencias cuando sea necesario.

Alternativas

Preguntas Frecuentes

Relacionado

• Lectura de NFTs (API DAS) - lecturas generales de NFTs
• Transferencia de cNFTs - usar prueba en tx
• Cómo Funciona la Compresión - teoría de pruebas

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.