Guía de metadatos
11

Una vez que haya creado un modelo de token en la cadena de bloques, puede añadirle metadatos complejos y dinámicos utilizando el esquema ERC-1155JSON.

 Los metadatos no se almacenan en la cadena de bloques porque los archivos son demasiado grandes.

 Sin embargo, es posible descentralizar sus metadatos almacenándolos en IPFS.

El almacenamiento de sus metadatos en sus propios servidores también le da más control sobre lo que se muestra, lo que le permite crear fichas dinámicas que aumentan y suben de nivel en función de la experiencia del usuario.

También tienes la opción de almacenar tus metadatos en los servidores de Enjin, lo que puede ahorrarte tiempo y dinero.

Establecer sus metadatos

Puede establecer sus metadatos a través de la sección "Activos" en su proyecto en el panel de acuñación de Enjin, haciendo clic en el botón "Editar" en el token que desea personalizar.

Editor básico

Si quieres configurar tus metadatos de forma rápida y barata, puedes hacerlo con el "Editor básico".

Tu token URI se personalizará para que apunte a los servidores de Enjin, donde se almacenan los metadatos.

Una vez que se ha realizado una solicitud con éxito, tendrá que aceptar y firmar la transacción en la sección SOLICITUDES de su monedero.

También puedes subir archivos .GIF y .MP4 como imágenes de activos.

Requisitos cuando se utilizan metadatos alojados:

  • 5mb máximo para GIFs/imágenes normales.
  • 15mb como máximo para los vídeos MP4.

Editor avanzado

Si quiere tener un control total sobre sus metadatos, puede elegir el URI utilizando el "Editor avanzado"

Su token URI se personalizará para que apunte a la dirección que ha especificado y podrá personalizar el archivo JSON a su gusto. 

Tenga en cuenta los siguientes requisitos a la hora de alojar sus propios metadatos:

1. El enlace (tanto a los metadatos como a la imagen) debe ser de acceso público para los robots

2. La uri debe ajustarse adecuadamente al archivo solicitado

3. La imagen debe ser la de un archivo de imagen válido (la imagen debe mostrarse)

4. El JSON debe ajustarse a los estándares de JSON RFC, si no se ajusta de ninguna manera, no se cargará.

API

Si desea establecer su metadato de forma programada, puede hacerlo mediante la siguiente consulta a la API.

GraphQL
mutation SetItemUri($identityId: Int!, $itemUriData: SetItemUriInput!) {
CreateEnjinRequest(identity_id: $identityId, type: SET_ITEM_URI, set_item_uri_data: $itemUriData) {
  id
  encodedData
  state
}
}


The ERC-1155 token standard includes optional formatting to allow for ID substitution by clients. If the string {id} exists in any JSON value, it MUST be replaced with the actual token ID, by all client software that follows this standard.

  • El formato de la cadena del ID hexadecimal sustituido DEBE ser alfanumérico en minúsculas: [0-9a-f] sin el prefijo 0x.
  • El formato de la cadena del ID hexadecimal sustituido DEBE tener un cero a la izquierda con una longitud de 64 caracteres hexadecimales si es necesario.

En esta situación, la siguiente dirección:

https://token-cdn-domain/{id}.json

Sería sustituido por:

https://token-cdn-domain/780000000000001e000000000000000000000000000000000000000000000000.json

Creación de un archivo JSON personalizado

Si desea crear su propio archivo de metadatos, tendrá que guardarlo como un archivo .json.

 Una vez que tenga ese archivo .json cargado con acceso público de lectura, puede hacer la solicitud para establecer el URI (Identificador Uniforme de Recursos) del artículo.

 Este es un ejemplo de un esquema simple de metadatos

JSON
{ "name": "item_name",
 "description": "Description line 1.\nDescription line2.",
 "image": "/image.jpg"
}

Para obtener más información sobre cómo crear un archivo JSON más sólido, visite el Github de ERC-1155.

Invalidar sus metadatos

A veces, por cualquier motivo, si sus metadatos no se cargan o tardan en hacerlo, hemos implementado la mutación Invalidar metadatos.

GraphQL
mutation InvalidateTokenMetadata {
 InvalidateTokenMetadata(id: "$id")
}

<inline-code>Id<inline-code> is the token ID of the asset.

Esta mutación instruirá a la Plataforma para invalidar los metadatos y así recuperarlos de nuevo, directamente de su servidor.

Tenga en cuenta que puede tardar unos minutos, después de invalidarlo, para que los nuevos metadatos se carguen.

Además, tenga en cuenta que esta mutación sólo se puede realizar una vez, por cada ficha, cada pocos minutos.

Sólo puedes ejecutar esta mutación en fichas que pertenezcan a una aplicación en la que tengas el papel de acuñador (o superior).

Metadatos específicos URI

Cualquier identificación simbólica puede tener un URI de metadatos que puede ser recuperado llamando a uri(_id) en el contrato ERC-1155.

Si una identificación individual de token no fungible tiene definida una URI de metadatos, las aplicaciones del cliente deben usar esta URI. Si no está definida, las aplicaciones cliente deben llamar a uri(_id) en el identificador de ficha base para recuperar la URI predeterminada para todo el conjunto de fichas no fungibles.

URI por defecto

A Non-Fungible token that defines a Default URI in its base token has the option of using an {id} placeholder in the URI itself. This will get replaced with the distinct ID when accessing NFTs.

Ejemplo
yoursite.com/{id}.json -> yoursite.com/bd4818c04f57a2ebc473d74ee06d6e0600000000000000000000000000000001.json

Imágenes

If the Default URI contains an image property that in turn contains the {id} placeholder, the image URL will be used as the default image for all tokens of this type.

Ejemplo
yoursite.com/images/{id}.jpg -> yoursite.com/images/bd4818c04f57a2ebc473d74ee06d6e0600000000000000000000000000000001.jpg

La propiedad de la imagen también puede ser una URI estática sin el marcador de posición, como se desea.

En GraphiQL, puede establecer la URI para el artículo usando la siguiente mutación:

GraphQL
mutation SetItemUri($identityId: Int!, $itemUriData: SetItemUriInput!) {
 CreateEnjinRequest(identity_id: $identityId, type: SET_ITEM_URI, set_item_uri_data: $itemUriData) {
   id
   encodedData
   state
 }
}

Nota: La configuración de la URI es una transacción en cadena que deberá aprobar en la Cartera Enjin, en la pestaña "Requests" (Solicitudes), para que los metadatos aparezcan en sus activos.

Anterior
siguiente
En esta página