EN

Token Metadata

Cuenta MetadataV1 — vincula una mint con su nombre, símbolo, URI, regalías, creadores y colección opcional. La base de cada NFT de Solana.

Metaplex Token Metadata 607 bytes

Ejemplo: Mad Lads

(en caché; se actualiza cada hora · solo mainnet)

Key Update Authority Mint Name Length Name Symbol Length Symbol URI Length URI Seller Fee Creators Creators Count Creator #1 Creator #2 Primary Sale Happened Is Mutable Edition Nonce Token Standard Collection Uses Collection Details / Programmable Config
0 1 2 3 4 5 6 7 8 9 A B C D E F
0000 04 15 3b 99 08 f3 7c 3b e2 70 a4 70 1c 9f cf 24
0010 32 fd 5a b6 95 08 1f 6f 30 4c 37 33 eb 7d 07 47
0020 69 e1 37 53 3d dd db 1b 18 14 45 f3 f0 ca 26 fc
0030 d4 9e e9 d0 6e 9b 52 c0 1c c9 20 48 a1 1a c2 1e
0040 85 20 00 00 00 4d 61 64 20 4c 61 64 73 20 23 37
0050 32 36 36 00 00 00 00 00 00 00 00 00 00 00 00 00
0060 00 00 00 00 00 0a 00 00 00 4d 41 44 00 00 00 00
0070 00 00 00 c8 00 00 00 68 74 74 70 73 3a 2f 2f 6d
0080 61 64 6c 61 64 73 2e 73 33 2e 75 73 2d 77 65 73
0090 74 2d 32 2e 61 6d 61 7a 6f 6e 61 77 73 2e 63 6f
00a0 6d 2f 6a 73 6f 6e 2f 37 32 36 36 2e 6a 73 6f 6e
00b0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
00c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
00d0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
00e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
00f0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0100 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0110 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0120 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0130 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 a4
0140 01 01 02 00 00 00 43 5a e4 60 4a 54 61 38 c2 c9
0150 49 32 f2 b9 73 3e 83 8b 45 34 dc aa 86 c1 38 59
0160 d5 8d 1b 89 45 01 01 00 15 3b 99 08 f3 7c 3b e2
0170 70 a4 70 1c 9f cf 24 32 fd 5a b6 95 08 1f 6f 30
0180 4c 37 33 eb 7d 07 47 69 01 64 01 01 01 ff 01 04
0190 01 01 fc b3 1b 4f f9 e6 68 7b eb 35 cb 7c 5d ab
01a0 19 d3 2d 67 a6 8e 57 62 4e cb c3 0f b3 ac 1c 5c
01b0 08 5e 00 00 01 00 01 09 86 22 85 e3 71 0a 90 d5
01c0 1d 9e 47 02 de 9a 9d d5 e9 fd c8 ac 81 d2 d2 ac
01d0 d1 e1 dd c8 24 fe c4 00 00 00 00 00 00 00 00 00
01e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
01f0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0200 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0210 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0220 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0230 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0240 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0250 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
Ver hex completo

Qué es

Una cuenta Token Metadata de Metaplex añade un nombre, símbolo, URI de imagen y regalías de creador a una Mint de SPL — la base de cada NFT de Solana y de la mayoría de los tokens «fungibles-con-metadatos».

Por qué existe

Las cuentas Mint de SPL son solo números: suministro, decimales, autoridades. Para los NFT necesitas un nombre, una imagen, creadores a quienes pagar regalías y una forma de apuntar a un JSON fuera de la cadena. El programa Token Metadata de Metaplex almacena eso on-chain como una cuenta separada derivada de la mint mediante una PDA fija: ["metadata", program_id, mint_pubkey].

Diseño de bytes

El diseño MetadataV1 de 607 bytes está dominado por tres cadenas de longitud variable con relleno y varios campos Option. El relleno se rellena con bytes a cero hasta los máximos fijos.

Offset Tamaño Campo Tipo Notas
0 1 key u8 enum 4 = MetadataV1.
1 32 update_authority Pubkey Puede actualizar campos mientras is_mutable.
33 32 mint Pubkey La Mint de SPL que describen estos metadatos.
65 36 name cadena con relleno Longitud de 4 bytes + hasta 32 bytes UTF-8.
101 14 symbol cadena con relleno Longitud de 4 bytes + hasta 10 bytes UTF-8.
115 204 uri cadena con relleno Longitud de 4 bytes + hasta 200 bytes UTF-8. Apunta al JSON fuera de la cadena.
319 2 seller_fee_basis_points u16 LE Regalía en puntos básicos (500 = 5%).
321 var creators Option<Vec<Creator>> Etiqueta Option de 1 byte + longitud de 4 bytes + entradas Creator de 34 bytes.
… 1 primary_sale_happened bool  
… 1 is_mutable bool Si es false, los campos quedan congelados para siempre.
… 2 edition_nonce Option<u8> Etiqueta Option de 1 byte + nonce de 1 byte.
… 2 token_standard Option<u8> enum NonFungible, Fungible, ProgrammableNonFungible, etc.
… var collection Option<Collection> Mint de colección vinculada.
… var uses Option<Uses> Seguimiento de usos burn/multi/single.

Total: 607 bytes (con relleno a tamaño fijo; los campos variables se rellenan hasta el máximo).

Dónde lo encuentras

Las billeteras y marketplaces resuelven cualquier mint de NFT a su cuenta Token Metadata para renderizar el nombre y la imagen. La mayoría de los tokens fungibles también usan Metaplex (el logo y el nombre de USDC vienen de una cuenta Metadata). Token-2022 introdujo una extensión de metadatos en línea alternativa que evita la cuenta separada, pero Metaplex sigue dominando para NFT.

Errores comunes

  • Cadenas con relleno, no estilo Borsh. name/symbol/uri tienen prefijo de longitud pero siempre se rellenan al tamaño máximo on-chain. Los bytes a cero finales son parte del diseño.
  • is_mutable: false es permanente. Una vez fijado, ningún campo puede cambiarse. Muchas colecciones se vuelven inmutables tras agotar el mint para probar la procedencia.
  • Metaplex usa Option de Borsh (etiqueta de 1 byte), no el COption de SPL (etiqueta de 4 bytes). Las dos codificaciones conviven en Solana — fuente fácil de errores de tres bytes.
  • Las regalías son orientativas. El seller_fee_basis_points on-chain no obliga a los marketplaces a pagar — los pNFT (NFT Programables) añadieron aplicación mediante un ruleset separado.

Fuentes

Ver también

Última verificación: 2026-05-19

Volver a Aprende Prueba el Byte Challenge