> For the complete documentation index, see [llms.txt](https://docs.fairway.global/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fairway.global/learn/blockchain-and-digital-identity/importing-trust-registries-to-cardano-with-oracles.md).

# 📦 Importing Trust Registries to Cardano with Oracles

#### Overview

**Trust registries** are curated databases of verified **credential issuers** (e.g., universities, licensing bodies, regulated businesses). They serve as the foundation for **trust decisions** in any system that verifies identities or credentials.

By using **blockchain oracles**, these registries can be made accessible to smart contracts on Cardano, enabling secure, on-chain validation of issuers and their credentials.

***

#### 🧠 What is a Trust Registry?

A **trust registry** is an authoritative list of credential issuers that are considered valid for a specific purpose.

Examples:

* 🇪🇺 EU Register of Higher Education Institutions
* 🇸🇪 Swedish Companies Registration Office
* 🇺🇸 US National Provider Identifier (NPI) Registry for healthcare
* 🌍 Sector-based accreditation lists (e.g., ISO-certified auditors)

These registries include:

* **Issuer ID** (e.g., a DID or legal registration number)
* **Issuer type** (university, company, government agency)
* **Registry scope** (jurisdiction, sector)
* **Timestamped inclusion or expiration**

***

#### 🛠️ How Oracle Integration Works

1. **Source Registry Data**
   * Trusted entities (government portals, public APIs, CSV/JSON dumps) are used as sources.
2. **Standardize & Encode**
   * Each entry is formatted with required metadata (e.g., `issuer_id`, `type`, `valid_until`) in a canonical JSON format.
3. **Oracle Publishing**
   * The data is signed by the Oracle and uploaded to Cardano as a transaction or oracle feed (can be native asset or datum-based).
4. **Smart Contract Query**
   * Contracts query the oracle by submitting an issuer ID and receive back a `true/false` or proof of inclusion.
5. **Decision Logic**
   * Based on this check, smart contracts allow or deny the action (e.g., credential acceptance, access, reward, or payment).

***

#### 🔍 Example Workflow

> Use Case: A Cardano-based job board verifies that only accredited universities can issue degree credentials.

<table><thead><tr><th width="72.60546875">Step</th><th>Action</th></tr></thead><tbody><tr><td>1️⃣</td><td>Credential contains <code>issuer_id: did:example:university123</code></td></tr><tr><td>2️⃣</td><td>Smart contract queries the Oracle with this ID</td></tr><tr><td>3️⃣</td><td>Oracle confirms issuer is in <code>education_registry_v2</code></td></tr><tr><td>4️⃣</td><td>Contract proceeds to accept the credential as valid</td></tr></tbody></table>

***

### 📈 Tokenomics-Based Validation of Issuers

Trust registries can also be enhanced by **on-chain consensus and staking mechanisms**. This introduces decentralized governance to the issuer validation process.

#### 🔐 Token-Curated Trust Registries

Instead of only relying on a central authority, a **community of stakers** can participate in validating issuers.

Key mechanics:

<table><thead><tr><th width="234.40234375">Mechanism</th><th>Description</th></tr></thead><tbody><tr><td>🗳️ <strong>Staked Curators</strong></td><td>Individuals or orgs stake tokens to validate a new issuer into the registry</td></tr><tr><td>✅ <strong>Onboarding Vote</strong></td><td>A DID issuer is proposed and voted into the registry by stakers</td></tr><tr><td>📉 <strong>Slashing for Misconduct</strong></td><td>If an issuer is later proven to issue fraudulent credentials, the curator’s stake can be slashed</td></tr><tr><td>🎯 <strong>Reputation Scoring</strong></td><td>Issuers earn trust scores based on usage &#x26; verification history</td></tr><tr><td>🎁 <strong>Reward System</strong></td><td>Verified issuers and curators are rewarded per successful credential verification</td></tr></tbody></table>

***

#### 🔁 Sample Flow

<table><thead><tr><th width="73.2421875">Step</th><th>Action</th></tr></thead><tbody><tr><td>1️⃣</td><td>Curator stakes 10,000 $FWT to vouch for a new university</td></tr><tr><td>2️⃣</td><td>Smart contract records the new issuer + curator</td></tr><tr><td>3️⃣</td><td>Employer verifies a credential issued by this university</td></tr><tr><td>4️⃣</td><td>The transaction confirms the issuer’s status via oracle</td></tr><tr><td>5️⃣</td><td>Curator receives a small portion of the verification fee</td></tr><tr><td>❗</td><td>If fraud is reported, the stake is slashed and issuer removed</td></tr></tbody></table>

***

### ✅ Benefits

<table><thead><tr><th width="152.15234375">Category</th><th>Benefit</th></tr></thead><tbody><tr><td>🔒 Security</td><td>Oracles validate issuer lists based on trusted sources</td></tr><tr><td>🧠 Composability</td><td>Smart contracts make dynamic trust decisions without off-chain logic</td></tr><tr><td>🌍 Openness</td><td>Any type of registry (gov, sector, community-curated) can be plugged in</td></tr><tr><td>🔁 Incentives</td><td>Staking and rewards drive high-quality participation in registry governance</td></tr><tr><td>🚀 Scalability</td><td>Registries can be updated and expanded without forking or manual upgrades</td></tr></tbody></table>

***

### 🔄 Registry Types That Can Be Oracle-Enabled

* **National ID Issuers** (Gov-backed identity schemes)
* **Accredited Universities** (Higher education regulators)
* **Business Registries** (Chambers of Commerce, Company Registration Offices)
* **Healthcare Providers** (NPI registries or regional health boards)
* **Tax Authorities** (Valid employer/employee databases)
* **Fintech KYC Providers** (Trusted e-KYC firms)