Guarda un archivo en el XRP Ledger
La imagen de tu token o cualquier otro archivo, escrito en el mismo ledger que el token y leído con comprobación de su huella digital.
La aplicación para Windows que escribe tus archivos en el ledger.
Los cubos muestran los fragmentos de un archivo real a medida que se leen del ledger. Cuando cada bloque se ha comprobado con su huella digital, el archivo aparece a su lado.
Los enlaces a los metadatos se pierden
Cuando un NFT, un MPT, un DID o una credencial guarda su imagen y su descripción fuera del ledger, la entrada del ledger solo contiene un enlace. El archivo está en IPFS, en el servidor propio del emisor o en un bucket de S3.
- IPFS sin pinningSe deja de pagar el pinning y el archivo desaparece de IPFS.
- Un servidor cerradoLa empresa cierra o se muda, y la dirección responde con un error.
- Un bucket cerradoSe cierra la cuenta de almacenamiento y los archivos desaparecen con ella.
Esa entrada permanece en el ledger, pero el archivo al que apunta su enlace puede perderse. Con xrpl-file, el archivo se escribe en el mismo ledger, en transacciones que no se pueden modificar ni eliminar, y cualquiera puede comprobarlo con su huella digital sin confiar en un servidor. El enlace de xrpl-file ocupa 84 bytes, y el campo URI de un NFT admite 256.
De un archivo a un enlace, y de vuelta
-
Dividido en fragmentos
El archivo se divide en trozos de 1000 bytes cada uno, llamados fragmentos.
-
Escrito en transacciones
Cada fragmento se escribe en su propia transacción, en el campo memo.
-
Con huella digital
Cada 1024 fragmentos forman un bloque, y el hash del bloque pasa a una lista de bloques. Una última transacción, el manifiesto, contiene la huella digital de toda la lista. El hash de esa transacción es el enlace.
-
Leído y comprobado
Quien tenga el enlace obtiene los fragmentos de un nodo del XRP Ledger, monta el archivo y comprueba cada bloque con su huella digital. Un archivo que no coincide con su huella no se muestra. El servidor de este sitio no interviene.
Cuánto cuesta
Un archivo entra en el ledger con aproximadamente una transacción por kilobyte, enviada desde una cuenta de publicación de la aplicación. Una cuenta puede publicar tantos archivos como quieras, y cuando ya no la necesitas, la aplicación la cierra. Hay dos tipos de coste. Las comisiones se gastan. La reserva de la cuenta queda retenida mientras la cuenta existe, y la mayor parte se recupera al cerrarla.
La tabla de precios no está disponible ahora mismo. Las cifras también están en el archivo de datos price.json.
Permanente y público
No se puede eliminar
Lo que se escribe en el ledger se queda allí. Nadie puede eliminarlo ni modificarlo, ni tú ni nosotros.
Cualquiera puede leerlo
Cualquiera puede leer el archivo. Los datos del ledger están abiertos a todos, y el enlace no es un secreto.
Publica solo lo que te alegre mostrar al mundo entero para siempre: ninguna contraseña, ningún dato personal, ninguna imagen que no tengas derecho a compartir.
Para desarrolladores
La especificación describe el formato. El repositorio incluye una biblioteca de .NET y un lector para el navegador.
Mostrar un archivo en tu página
Añade el script y el elemento. El script está fijado a la versión 1.2.0 y se comprueba con su valor integrity: si el archivo cambia, el navegador no lo ejecuta.
Desde npm, a través de jsDelivr
<script src="https://cdn.jsdelivr.net/npm/xrpl-file-element@1.2.0/xrpl-file-element.js"
integrity="sha384-3Ng6D0oyDdNcgbs1hTua5zQaHdn4E/3o7gnxr0ecp2jVh2kP2KbJymnO++iWWvP+"
crossorigin="anonymous" defer></script>
<xrpl-file src="xrpl-file://mainnet/9B1A9E33DBD9B445BFE2854D4D489DC860869D873AD36DA30A69DD19DDBC0DF5"></xrpl-file>width y height fijan el tamaño, loading indica cuándo empieza la lectura, theme elige la paleta clara u oscura y node indica el nodo desde el que se lee. La lista completa está en el README: Incrustar un archivo.