Busca en todas las páginas de la documentación
Los metadatos de los NFT combinan campos en la cadena (nombre, uri) con JSON y archivos multimedia fuera de la cadena. Las opciones de almacenamiento (Arweave, IPFS, HTTPS centralizado) afectan la permanencia, el costo y la confianza.
{
"name": "Mi NFT",
"symbol": "MNFT",
"description": "Activo de ejemplo",
"image": "ar://HASH",
"attributes": [{ "trait_type": "Rareza", "value": "Oro" }],
"properties": { "files": [{ "uri": "ar://HASH", "type": "image/png" }] }
}# Sugar upload -> ruta típica de Arweave bundlr
sugar uploadCuándo usar esto:
animation_url y external_url.# Directorio por elemento: assets/0.json, assets/0.png, ...
sugar validate
sugar upload # sube imágenes + metadatos a Arweave a través de Bundlr
sugar deploy// Después de la subida, la uri JSON en los metadatos en cadena apunta a la puerta de enlace de Arweave o ar://
const metadata = {
name: "Elemento #0",
symbol: "DEMO",
description: "Almacenado en Arweave",
image: "https://arweave.net/TX_ID",
attributes: [
{ trait_type: "Fondo", value: "Azul" },
{ trait_type: "Ojos", value: "Láser" },
],
};
// Campo uri en cadena -> misma ubicación JSON// Fetch del cliente con caché desactivada en la revelación
const res = await fetch(uri.replace("ar://", "https://arweave.net/"));
const json = await res.json();Lo que esto demuestra:
image requerido para la visualización en galería.attributes potencia los filtros de rasgos y las herramientas de rareza.uri que apunta al JSON.image, animation_url, properties.files.| Almacenamiento | Permanencia | Modelo de costo |
|---|---|---|
| Arweave | Alta | Pago inicial por MB |
| IPFS + anclaje | Depende del anclaje | Tarifas de anclaje continuas |
| HTTPS | Baja (mutable) | Alojamiento de servidor |
// Validar el esquema JSON en CI antes de la subida
// Hashear archivos y comparar con el compromiso en cadena si se usa el patrón NFT verificablesugar validate y comprobaciones de hash.ar:// roto - algunos clientes carecen de puerta de enlace. Solución: proporcionar un fallback https://arweave.net en la interfaz de usuario.| Alternativa | Usar Cuando | No Usar Cuando |
|---|---|---|
| Arweave a través de Bundlr | Arte NFT de producción | Solo prueba rápida y desechable |
| IPFS NFT.Storage | Preferencia por el ecosistema IPFS | Necesidad de la garantía de permanencia de Arweave |
| SVG en cadena (pequeño) | Arte generativo diminuto | Archivos multimedia grandes |
Nombre/uri en cadena; imagen y atributos típicamente JSON fuera de cadena.
Arweave: permanencia con pago único. IPFS: CID con responsabilidad de anclaje.
Capa de subida que financia transacciones de Arweave - usada por Sugar.
Mínimo name, image para la mayoría de los mercados; attributes para rasgos.
Campo opcional para medios interactivos de video/html.
Sí, si la autoridad de actualización en cadena puede cambiar la uri a un nuevo JSON.
Revocar la autoridad de actualización después de establecer la uri final; usar almacenamiento permanente.
Pre-renderizar todas las imágenes o SVG en cadena; JSON por índice con rasgos coincidentes.
sugar validate comprueba pares json/imagen y problemas de esquema.
DAS resuelve content.links.image a partir de metadatos indexados.
El servidor puede intercambiar la imagen - socava la narrativa de permanencia del NFT.
Específicos del mercado - comúnmente unos pocos MB para imágenes.
Versiones de la pila: 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.
Revisado por Chris St. John·Última actualización: 16 jul 2026