Guarde um arquivo no XRP Ledger
A imagem do seu token ou qualquer outro arquivo, gravado no mesmo ledger do token e lido de volta com conferência da impressão digital.
O aplicativo para Windows que grava seus arquivos no ledger.
Os cubos mostram os fragmentos de um arquivo real à medida que são lidos do ledger. Quando cada bloco é conferido pela impressão digital, o arquivo aparece ao lado.
Links para metadados se perdem
Quando um NFT, um MPT, um DID ou uma credencial guarda a imagem e a descrição fora do ledger, a entrada do ledger contém apenas um link. O arquivo fica no IPFS, no servidor do próprio emissor ou em um bucket do S3.
- IPFS sem pinningO pinning deixa de ser pago e o arquivo some do IPFS.
- Um servidor encerradoA empresa encerra as atividades ou muda, e o endereço passa a responder com erro.
- Um bucket encerradoA conta de armazenamento é encerrada, e os arquivos vão junto.
Essa entrada continua no ledger, mas o arquivo por trás do link pode se perder. Com o xrpl-file, o arquivo é gravado no mesmo ledger, em transações que não podem ser alteradas nem excluídas, e qualquer pessoa pode conferi-lo pela impressão digital sem confiar em um servidor. O link do xrpl-file tem 84 bytes, e o campo URI de um NFT comporta 256.
Do arquivo ao link e de volta
-
Dividido em fragmentos
O arquivo é dividido em pedaços de 1000 bytes cada, chamados de fragmentos.
-
Gravado em transações
Cada fragmento é gravado em uma transação própria, no campo memo.
-
Com impressão digital
A cada 1024 fragmentos forma-se um bloco, e o hash do bloco entra em uma lista de blocos. Uma última transação, o manifesto, guarda a impressão digital da lista inteira. O hash dessa transação é o link.
-
Lido e verificado
Quem tem o link obtém os fragmentos de um nó do XRP Ledger, monta o arquivo e confere cada bloco com a impressão digital. Um arquivo que não bate com a impressão digital não é exibido. O servidor deste site não participa disso.
Quanto custa
Um arquivo entra no ledger com cerca de uma transação por quilobyte, enviada de uma conta de publicação do aplicativo. Uma conta pode publicar quantos arquivos você quiser, e quando você não precisar mais dela, o aplicativo a fecha. Há dois tipos de custo. As taxas são gastas. A reserva da conta fica retida enquanto a conta existe, e a maior parte volta quando a conta é fechada.
A tabela de preços não está disponível agora. Os valores também estão no arquivo de dados price.json.
Permanente e público
Não pode ser excluído
O que é gravado no ledger fica lá. Ninguém pode excluir nem alterar, nem você nem nós.
Qualquer pessoa pode ler
Qualquer pessoa pode ler o arquivo. Os dados do ledger são abertos a todos, e o link não é segredo.
Publique apenas o que você aceita mostrar ao mundo inteiro para sempre: nada de senhas, dados pessoais ou imagens que você não tem o direito de compartilhar.
Para desenvolvedores
A especificação descreve o formato. O repositório tem uma biblioteca .NET e um leitor para o navegador.
Exibir um arquivo na sua página
Adicione o script e o elemento. O script está fixado na versão 1.2.0 e é conferido pelo valor integrity: se o arquivo mudar, o navegador não o executa.
Do npm, pelo 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 e height definem o tamanho, loading diz quando a leitura começa, theme escolhe a paleta clara ou escura e node indica o nó de onde o arquivo é lido. A lista completa está no README: Incorporar um arquivo.