Uma leitura em camadas do ciclo de atribuição e resolução de ARK, das APIs do dARK, da blockchain privada, da preservação distribuída de metadados e da arquitetura multissítio.
Como o fluxo funciona
A atribuição começa com a reserva de uma identidade. Continua com o envio da URL e dos metadados, sua preservação descentralizada e a publicação do ARK.
O Minter atribui uma nova identidade dentro de um NAAN habilitado.
A URL e os metadados são enviados; o dARK os preserva em vários nós e registra o ARK.
A API confirma o estado Publicado; o Resolver oferece URL e metadados, e o Minter recebe alterações posteriores.
Se o recurso muda de plataforma, a instituição atualiza o destino e mantém o mesmo ARK.
Autoridades e NAAN
dARK chama de autoridade uma instituição —ou seu representante definido pela governança— habilitada a registrar identificadores. Cada autoridade se vincula a um ou mais NAANs, os prefixos que representam seus espaços institucionais de identificação.
Na primeira etapa da LA Referencia, os nós nacionais atuam como autoridades designadas. Uma etapa posterior permitirá que as próprias instituições façam minting por meio da API.
A governança reconhece a instituição ou o nó nacional que a representa.
Cada prefixo delimita os espaços institucionais nos quais pode operar.
O Minter valida a autoridade e o NAAN antes de reservar ou atualizar um ARK.
O ciclo no Minter
O estado permite que quem envia a informação acompanhe o progresso do minting. O percurso principal vai de Reservado a Rascunho e, por fim, a Publicado. Selecione cada estado para ver o que acontece.
O Minter gerou o identificador e mantém sua reserva enquanto aguarda a URL e os metadados.
O Minter recebeu as informações e os processos internos preparam sua preservação e registro.
Os metadados foram preservados e o registro foi confirmado na blockchain para sua resolução pública.
O Minter recebeu uma nova URL ou versão dos metadados e repete o processo de preservação e registro.
A autoridade responsável desativou o ARK. É uma operação irreversível e o registro não pode ser modificado.
Por trás dos estados
A reserva e o envio de informações são feitos pelo Minter. Em seguida, os processos internos preservam os metadados, registram o ARK e atualizam seu estado.
APIs do dARK
Minter e Resolver são as duas interfaces de uso. Por trás delas, Admin, os workers, dark-core-lib e Store coordenam as operações com blockchain e IPFS.
Permite reservar, completar e atualizar ARKs, além de consultar seu estado.
Permite abrir o destino atual, consultar informações e recuperar os metadados preservados.
Admin registra autoridades na blockchain. Minter mantém o estado local, coordena a preservação e publica o registro por meio dos contratos. Resolver consulta a cadeia e, quando se solicitam metadados, recupera-os pela Store API.
Tecnologia base · Blockchain
A blockchain privada do dARK registra as autoridades, suas permissões e cada criação ou atualização de um ARK. O mesmo histórico ordenado é mantido entre os nós validadores, oferecendo confiança e rastreabilidade ao serviço. Um nó blockchain é um equipamento que guarda uma cópia do registro e participa da rede; os nós validadores também participam da confirmação dos blocos.
Não é Proof of Work. Diferentemente das criptomoedas que fazem participantes anônimos competir para resolver cálculos, o dARK identifica previamente seus validadores e usa seu acordo para incorporar operações ao registro.
Referência externa: documentação do Hyperledger Besu sobre QBFT ↗.
Tecnologia base · IPFS
Os metadados são preservados em dois níveis. L1 reúne em um JSON os metadados básicos e os dados internos de que o dARK precisa para gerir o ARK, e inclui o CID de L2 para manter o vínculo com o registro original. L2 conserva o registro de metadados original. O CID de L1 fica associado ao ARK na blockchain.
Arquitetura multissítio
O modelo distribui aplicações, nós blockchain e armazenamento entre sedes conectadas por redes privadas. Cada sede fornece infraestrutura ao mesmo serviço dARK, de modo que a rede pode continuar mesmo que temporariamente apenas uma sede permaneça operacional.
A arquitetura foi concebida para distribuir as sedes entre infraestruturas públicas e privadas de diferentes países. Essa diversidade permite manter cópias e serviços disponíveis diante da perda temporária de uma sede e favorece a sobrevivência das informações ao longo do tempo. A Store API trabalha com os nós de armazenamento locais e a propagação remota ocorre dentro do único cluster IPFS global.
Como funciona o Resolver do dARK
O Resolver consulta o registro e responde de três formas. Selecione cada opção para conhecer seu percurso.
dARK na resolução global de ARK
O registro global de ARK mantém uma regra N2T —Name to Thing— para cada NAAN. Nos espaços administrados pelo dARK, essa regra direciona a consulta ao Resolver do dARK. N2T indica qual serviço responde; não armazena os metadados.
GET /api/v1/arks/ark:/12345/abc123Consulta o endereço registrado e abre o recurso em seu repositório atual.
GET /api/v1/arks/ark:/12345/abc123?infoApresenta a informação pública associada ao ARK.
GET /api/v1/arks/ark:/12345/abc123?metadataRecupera a versão original dos metadados preservados.
O resultado
O dARK coordena atribuição, preservação descentralizada, registro verificável e resolução pública por meio de serviços especializados.
Documentação técnica
O dARK está em evolução contínua. A documentação descreve os componentes, contratos, APIs, estados, preservação de metadados e operação da infraestrutura. A versão estável e o código completo estarão disponíveis para a comunidade no fim de 2026.