Whitepaper · 16
Apêndices
A lista de interfaces permanece no repositório do padrão.
Apêndice A: Referência de interfaces
A lista de interfaces permanece no repositório do padrão.
O que permanece lá
A especificação, as fontes das interfaces e o esquema de metadados do lote.
O que um leitor público pode saber
O A-REX Core estende uma base multitoken com a identidade de um lote, a linhagem quando um lote é dividido ou processado, uma superfície de execução, um pipeline de regras e atestações de emissores confiáveis.
O que este capítulo retém
Assinaturas, nomes de erro, layouts de armazenamento e o esquema.
Como solicitar o texto
Empresas que queiram implementar o A-REX, emitir lotes com ele ou auditá-lo usam a página de acesso antecipado. Cada solicitação é revisada à mão. Leitores aprovados recebem acesso somente leitura ao repositório do padrão e à implementação de referência.
Termos já escritos
O acesso é para avaliação, implementação e feedback. O material permanece confidencial até ser publicado. Os termos escritos dizem que o padrão será publicado sob CC0 e que o acesso antecipado não concede exclusividade.
Escopo das páginas seguintes
O glossário, a bibliografia e as perguntas seguintes explicam termos. São o vocabulário público.
Documentos nomeados, não copiados
A seção do padrão neste site lista os mesmos documentos.
Limite
Uma página que permitisse copiar uma interface fica fora deste capítulo.
Apêndice B: Glossário
| Termo | Significado |
|---|---|
| Lote | Um identificador de token ERC-1155 com um registro Batch: um lote de uma commodity em uma unidade, com origem e data de produção comuns. |
| Reagrupamento | Uma transform cujas saídas têm a mesma commodity e a mesma unidade das entradas e cujas quantidades são conservadas (divisão, união). Aberta aos titulares na implementação de referência quando as saídas ficam com o titular (to == from); um reagrupamento para outra conta exige TRANSFORMER_ROLE. |
| Processamento | Uma transform que altera a commodity, a unidade ou a quantidade. Exige TRANSFORMER_ROLE na implementação de referência. |
| Linhagem | O grafo formado pelos eventos BatchTransformed e por parentsOf. |
| Hook | Um contrato que implementa IARexHook, registrado em um token e avaliado em ordem em toda operação. |
| Código de rejeição | Um bytes32 retornado por check de um hook; 0 significa permitido; convenção keccak256("NAMESPACE:NAME"). |
| Elegibilidade | Permissão, no nível da conta, para enviar ou receber, respondida por hooks sinalizados com HOOK_ELIGIBILITY; exposta como canSend/canReceive do ERC-7943. |
| Saldo congelado | Unidades que uma conta detém, mas não pode mover (setFrozenTokens); pode exceder o saldo. |
| Transferência forçada | Movimentação de unidades por ENFORCER_ROLE sem o consentimento do titular (ERC-7943). |
| Atestação | (batch, topic) → (issuer, reference, validity) registrada por um emissor confiável para aquele tópico. |
| Tópico | Um bytes32 que identifica o assunto de uma atestação; aberto; mapeia-se para tópicos de declaração do ERC-735 e para identificadores de esquema do EAS. |
| Referência de origem | originRef: uma referência às evidências de origem, ou uma referência aleatória; nunca coordenadas nem um valor calculado a partir de uma localização. |
| Referência a montante | Um item da lista upstream dos metadados que indica um lote de outro token do qual os bens foram recebidos ou processados; uma afirmação do emissor a jusante, a ser confrontada com o token a montante. |
| Compromisso de metadados | metadataHash, keccak256 do documento canônico off-chain em uri. |
| Status | Valor uint8 de ciclo de vida; 0 ativo, 255 baixado (terminal); 1..254 definidos pelo emissor. |
| CTE / KDE | Evento crítico de rastreamento / elemento-chave de dados (FSMA 204). |
| DDS | Declaração de devida diligência (EUDR). |
| EPCIS | GS1 Electronic Product Code Information Services, o vocabulário de eventos para rastreabilidade (versão 2.0). |
| UNTP | UN Transparency Protocol (UN/CEFACT): credenciais verificáveis para passaportes de produto, eventos de rastreabilidade e conformidade; versão 0.7.0. |
| DPP | Passaporte Digital de Produto. No ESPR da UE, é emitido pelo fabricante do produto final; o ESPR exclui alimentos, rações e plantas e animais vivos. |
| Pegada declarada | Uma pegada de carbono de produto calculada por um terceiro identificado e copiada para os metadados (extensions.pact_pcf, PACT 3.0.3; ADR-018, Proposto). Nunca é calculada pelo token. |
| Descritor de regra | arex.module/1: o documento JSON que uma regra ou um módulo adicional publica para se descrever aos consumidores (informativo, Proposto). |
| Perfil de política | As regras versionadas de uma jurisdição ou organização sobre quem pode usar uma capacidade do padrão e em que condições (ADR-019, Proposto). |
| CPR / CPR-e | Cédula de Produto Rural, o recebível de safra do Brasil; forma eletrônica registrada em entidades autorizadas. |
| EWR | Recibo de armazém eletrônico nos termos do U.S. Warehouse Act. |
| MLETR | Lei Modelo da UNCITRAL sobre Registros Eletrônicos Transferíveis. |
| ERC-7943 (uRWA) | Interface Universal de Ativos do Mundo Real: congelamento, transferência forçada, elegibilidade; Final em maio de 2026. |
| ERC-3643 (T-REX) | Padrão de token permissionado para valores mobiliários sobre ERC-20; Final em dezembro de 2023. |
| ERC-7201 | Layout de armazenamento com namespace para contratos atualizáveis. |
Apêndice C: Bibliografia
Padrões e especificações
- Radomski, W. et al. "EIP-1155: Multi Token Standard." Ethereum Improvement Proposals, 2018.
- Vogelsteller, F., Buterin, V. "EIP-20: Token Standard." 2015.
- "ERC-165: Standard Interface Detection." 2018.
- "ERC-3643: T-REX — Token for Regulated EXchanges." Final, 15 de dezembro de 2023. https://eips.ethereum.org/EIPS/eip-3643
- "ERC-7943: uRWA — Universal Real World Asset Interface." Final, 27 de maio de 2026. https://eips.ethereum.org/EIPS/eip-7943
- "ERC-7201: Namespaced Storage Layout." 2023.
- "ERC-735: Claim Holder." 2017 (rascunho).
- Documentação do Ethereum Attestation Service.
- GS1. "EPCIS and CBV Standard 2.0." 2022. GS1 US. "EPCIS Recommendations for FSMA 204 Critical Tracking Events." 2024.
- UN/CEFACT. "Recommendation No. 20: Codes for Units of Measure Used in International Trade."
- IETF RFC 8785. "JSON Canonicalization Scheme (JCS)." 2020.
- UN/CEFACT. "UN Transparency Protocol", versão 0.7.0 (tag
v0.7.0), 2026. - WBCSD. "PACT Technical Specifications for Product Footprint Data Exchange", versão 3.0.3, 2025.
- W3C. "Verifiable Credentials Data Model v2.0"; "Securing Verifiable Credentials using JOSE and COSE"; "Bitstring Status List." W3C CCG. "did:web Method Specification."
- Documentação do OpenZeppelin Contracts 5.x; anúncio da parceria entre a OpenZeppelin e a T-REX Network, julho de 2026.
Regulamentação e legislação
- FDA. "Requirements for Additional Traceability Records for Certain Foods." Regra final, Federal Register 87(219), 2022; "Compliance Date Extension," Federal Register, 7 de agosto de 2025.
- Regulamento (UE) 2023/1115 (Desmatamento); Regulamento (UE) 2025/2650 (alteração); comunicado de imprensa do Conselho da UE, 18 de dezembro de 2025.
- Regulamento (UE) 2023/1114 (MiCA); Diretrizes da ESMA sobre a qualificação de criptoativos como instrumentos financeiros, dezembro de 2024.
- European Data Protection Board. "Guidelines 02/2025 on processing of personal data through blockchain technologies," versão 2.0, 7 de julho de 2026.
- SEC. Release No. 33-11412, 17 de março de 2026. SEC v. W.J. Howey Co., 328 U.S. 293 (1946).
- GENIUS Act, Public Law 119-27 (2025); regulamentação de implementação, Federal Register, 18 de agosto de 2026.
- Uniform Commercial Code, 2022 Amendments, Article 12 (Controllable Electronic Records).
- U.S. Warehouse Act; 7 CFR Part 869 (Electronic Warehouse Receipts).
- UNCITRAL. "Model Law on Electronic Transferable Records." 2017. Reino Unido, Electronic Trade Documents Act 2023.
- Comisión Nacional de Valores (Argentina). Resolución General 1150/2026. Ley 9.643 (warrants).
- Brasil. Lei 8.929/1994, Lei 13.986/2020 (CPR); Lei 11.076/2004 (CDA/WA); Resolução CVM 88 e Consulta Pública SDM 05/2025.
- Verra. "Verra Addresses Crypto Instruments and Tokens." 2022; VCS Program Guide.
- Diretiva (UE) 2024/825 (empoderamento dos consumidores para a transição ecológica).
- Regulamento (UE) 2024/1781 (Ecodesign para Produtos Sustentáveis, ESPR), Artigo 1(2).
Pesquisa e indústria
- Zhang, P., Schmidt, D. C. "Blockchain Applications in Food Supply Chain Management: A Systematic Review." Journal of Food Engineering, 279, 2020.
- Caro, M. P. et al. "Blockchain-based Traceability in Agri-Food Supply Chain Management." IEEE, 2018.
- FAO. "The State of Food and Agriculture." 2023.
- World Bank. "Future of Food: Harnessing Digital Technologies to Improve Food System Outcomes." 2022.
- ERC3643 Association. "History of ERC-3643"; anúncio da iniciativa de padronização do ISO TC 307.
- Chainlink. "Automated Compliance Engine (ACE): Technical Overview." 2025–2026.
Apêndice D: Modelos
Os exemplos trabalhados de um hook, uma implantação e um documento de metadados permanecem nos repositórios.
Por que permanecem lá
Esses exemplos bastam para copiar uma implementação. Este capítulo público explica termos e consequências.
Onde vivem
Eles acompanham o repositório do padrão e a implementação de referência, para leitores cujo pedido de acesso antecipado foi aprovado.
Apêndice E: Perguntas Frequentes
O A-REX é um ERC? Ainda não. A especificação está escrita em formato ERC e será submetida após uma implantação em produção, implementações independentes e uma auditoria. Nenhum número foi atribuído; os nomes no código não usam o prefixo ERC.
É obrigatório usar o ARexToken? A referência é uma implementação. As interfaces pertencem ao texto normativo.
É obrigatório usar os hooks de referência? São demonstrações. Os leitores com acesso podem lê-los no repositório de referência.
Um hook pode bloquear uma transferência forçada? Pode retornar um código para OP_FORCED_TRANSFER, e o token reverterá. Os hooks de referência não o fazem; um hook que trate de enforcement (por exemplo, exigindo uma referência de ordem) pode.
Onde ficam as coordenadas? Em armazenamento off-chain restrito, referenciado a partir dos metadados (para o EUDR, o Sistema de Informação da UE), nunca on-chain, nem mesmo como hash ou geohash.
Como representar uma safra futura? producedAt = 0; condicione as transferências com ExpiryHook(allowPreHarvestTransfers).
A quantidade é conservada em transform? Não pelo padrão; a referência permite que qualquer titular faça o reagrupamento para a sua própria conta quando ela é conservada e exige TRANSFORMER_ROLE nos demais casos, ou quando as saídas vão para outra conta.
Um token de lote é um Passaporte Digital de Produto? Não. O ESPR exclui alimentos, rações e plantas e animais vivos, e um passaporte é do fabricante. O mapeamento UNTP permite que um emissor publique evidências assinadas sobre um lote, que o passaporte de um fabricante pode usar.
O token é um valor mobiliário? O padrão não decide. A oferta é que decide. Consulte assessoria jurídica; a superfície de enforcement está presente qualquer que seja a resposta.