Skip to content

Trust lists and federation ​

A diploma arrives signed, but the signature alone does not answer the question "is the signer really a university?". The answer is in the trust listA signed list of a country's root certificates, issuers and registered relying parties. Today trust in Tamga rests on these lists; a shared ledger comes later.: a signed, versioned list that shows which institutions (issuersThe institution that signs and issues credentials: a university, a professional body, a public institution or a company.) may issue which credential types, which verifiersThe party that checks a presented credential: signature, issuer in the trust list, status and policy. Also called relying party. are registered and which wallet providersThe organisation that offers a wallet, registers its wallet units and signs wallet and key attestations. Each wallet runs its own provider; the network does not run one, it lists them in the trusted list. are recognised.

Two levels ​

ListWhat it containsAddress
List of Trusted Lists (LOTL)The addresses of the country lists and the certificates that sign them, wallet providers, the schema catalogue, shared settingshttps://trust.tamga.network/lotl.jws
Country listThat country's issuers, verifiers and root certificateshttps://trust.tamga.network/tl-tr.jws

This is the EU trust model: the European Commission publishes a LOTL (List of Trusted Lists)The signed list that points to the countries' trust lists, their signers and their recognition status. and each member state publishes its own list. The formats map to the ETSI (European Telecommunications Standards Institute)The European standards body that writes the technical standards for trust lists, signatures and trust services. standards.

A single root key ​

A wallet or a verifier trusts only one thing up front: the fingerprint of the root that signs the LOTL (the trust anchorThe root key or certificate a verifier trusts first; everything else is checked back to it.). You pin the fingerprint in your configuration (https://tamga.network/trust-anchor); the list tells you the rest. Do not interpret the list yourself — the TrustSource interface checks the signature, the version chain and the freshness, and gives you the entries.

ts
import { fetchListTrustSource, verifyJws } from "@tamga-network/trust";

const { source } = await fetchListTrustSource("https://trust.tamga.network", http, {
  rootFingerprints: ["<fingerprint from the trust-anchor page>"],
  verifyJws,
});
const issuer = source.issuer(issuerId); // institution entry: authorised credential types, level, status

Today and tomorrow ​

  • Today: Tamga publishes the Türkiye list on behalf of the national authority, provisionally (operator.status: provisional). The Tamga operator registers issuers and verifiers.
  • Hand-over: when the state, or a body it authorises, publishes its own list, the LOTL points to that list's address and signer. Credentials, wallets and verifiers do not change; institution identifiers (issuer_id) are derived from the certificate, so they stay the same.
  • FederationA model in which each country runs its own trust list and a list of trusted lists brings them together; Tamga can also show external lists.: every Turkic state can run its own list; the LOTL brings them together and introduces them to each other. Mutual recognition (for example of EU lists) comes in through the same door. A ledger becomes the shared record of these entries once at least two independent operators take part.

Details ​