# 📦 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)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fairway.global/learn/blockchain-and-digital-identity/importing-trust-registries-to-cardano-with-oracles.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.