Skip to content

Architecture decision records (ADR) ​

An ADR is the permanent record of a decision that has been taken in Tamga Network and has become binding: what the problem was, which options were considered, what was decided and what follows from it. A closed decision changes only through a new ADR; the old record is not deleted but marked as superseded.

Trust

NoDecisionDateStatus
0001Besu QBFT ledger2026-07-29Accepted
0004Institutional identity: X.5092026-08-06Accepted
0009Chainless beta and chain threshold2026-09-24Accepted
0015Single trust interface2026-09-27Accepted
0024Participant registration data2026-09-29Accepted
0026Registration certificates2026-09-29Accepted
0034HAIP 1.0 conformance2026-10-01Accepted
0036Trust federation2026-10-01Accepted
0038Sandbox: the test network2026-10-03Accepted
0046Embedded disclosure policy2026-10-09Accepted
0051The chain is a projection of the signed lists2026-10-17Accepted
0052Besu local permissioning2026-10-19Accepted
0053Competing candidates in the list anchor registry2026-10-19Accepted
0054On-chain schema namespaces, cross-state references and quota scope2026-10-19Accepted
0055Governance: upgrade delay and registry administration proposals2026-10-19Accepted
0056Misuse-resistant defaults in the package APIs2026-10-19Accepted
0063The on-chain status list registry accepts the list's own bit size2026-10-23Accepted
0066ETSI TS 119 612 XML list view2026-10-29Accepted
0068Registration certificate policy and status list2026-10-29Accepted
0073Making chain–list equivalence achievable: migration mode, hard revocation, schema versions, relying party identity, status mapping2026-11-04Accepted
0074Projection scope 0.8: every trust record in the signed lists on chain2026-11-04Accepted
0075Ownership of the verifier domain-name identity and re-registration after revocation2026-11-04Accepted
0077The chain is set up with the Cancun rule set2026-11-12Accepted
0079Authorisation for another state's national schema: consent of the state that owns the schema2026-11-12Accepted
0081Removing test records from the list2026-11-12Accepted
0084List is the source, chain is a witness2026-11-15Accepted
0085Continuous projection to the chain2026-11-15Accepted
0087Access certificate revocation list2026-11-15Accepted
0088Credentials of a suspended issuer2026-11-16Accepted
0090A separate host for CRLs: crl.tamga.network, http and https2026-11-18Accepted

Credentials

NoDecisionDateStatus
0006Credential format: SD-JWT VC2026-09-03Accepted
0007Schema registry2026-09-09Accepted
0008Where the status list lives2026-09-09Accepted
0010Credential type identifier (URN)2026-09-24Accepted
0014Events category2026-09-27Accepted
0021E-mail and phone credentials2026-09-29Accepted
0028Health credentials2026-09-29Proposed
0029Schemas in the development stage2026-09-30Accepted
0039Verified driving licence information2026-10-03Accepted
0048No suspension for identity service credentials; mdoc status list as CWT2026-10-13Accepted

Services

NoDecisionDateStatus
0016Access to hosted issuance2026-09-27Accepted
0017Access to verification results2026-09-27Accepted
0019Institution Console2026-09-28Accepted
0020The authentic source is the institution2026-09-29Accepted
0033App store review code2026-10-01Accepted
0041Institution test accounts in the sandbox2026-10-04Accepted

Structure of an ADR ​

SectionContent
ContextThe situation and constraints that call for the decision
DecisionNumbered decision items (K1, K2, …)
Options consideredAlternatives, their pros and cons, why they were not chosen
ConsequencesAffected documents, code and operations
InvariantsBinding rules that follow from the decision (e.g. ADR-0017/HV1); collected on the binding rules page
StatusProposed → Accepted → (if needed) Superseded; date of acceptance

Process ​

  1. It is written as a proposal (status: Proposed).
  2. Project management accepts it; the date is recorded and the decision gets a D-* code.
  3. The affected specifications and Tamga ARF documents are updated in the same piece of work.