Dignity OS (Digi-New) — Institutional Real-World Asset (RWA) Operating System

Welcome to the Dignity OS code and documentation repository. This platform serves as the institutional compliance, custody, and proceeds routing operating system designed to bridge verified in-ground mining reserves with digital tokenization and qualified custody.

---

📊 System Status & Color-Coded Health Legend

Component	Status	Description
GCP Cloud Run APIs	🔴 Billing Locked	Services returning 502 Bad Gateway/404 Not Found due to inactive billing on project unykorn-sovereign-core.
BitGo Trust Gateway	🟡 Inactive	Awaiting GCP restoration to reactivate webhook event listeners.
Interactive Intake Client	🟢 Active	Standalone HTML with voice dictation & local AI proposal synthesizer is live.
Solidity Smart Contracts	🟢 Drafted	Upgraded whitelisted ERC-20 contract is ready for testing/deployment.

---

🗂️ Table of Contents

1. Project Overview
2. Folder Structure
3. System Architecture (The 5-Layer Stack)
4. BitGo Custody & Proceed Routing
5. Smart Contract Upgrade
6. GCP Diagnostics & Restoration Playbook
7. Getting Started (Local Running)

---

🔍 Project Overview

The Dignity OS platform addresses the core infrastructure gap in traditional precious metals tokenization. By mapping out the successes and competitor failures (such as Goldfish's static collateral limits and lack of automated conversions), we implement a Telemetry-Gated Atomic Conversion Engine:

• Asset Pledges: Links tokens (DIGag/DIGau) directly to verified in-ground reserves via S-K 1300 / NI 43-101 certifications.
• Qualified Custody: Integrates directly with BitGo Bank & Trust (no third-party MPC intermediaries) to secure vault storage and institutional lines of credit.
• Compliance First: Restricts token transfers through on-chain KYC/AML and OFAC whitelist registries.

---

📂 Folder Structure

Digi-New/
├── README.md                           # Main repo documentation (this file)
├── contracts/
│   └── DignitySecuritiesToken.sol      # solidity upgrade contract
├── dashboards/
│   ├── unykorn_rwa_dashboard.html      # Unykorn master dashboard (Active)
│   ├── unykorn_rwa_dashboard (1).html  # Unykorn master dashboard (Archive)
│   ├── dignity_intake_questionnaire.html # Voice-enabled onboarding intake form (Primary)
│   ├── dignity_unykorn_os_cockpit.html # Onboarding intake form (Alternate)
│   ├── strategic_alignment_engine.html  # Live API visual canvas (Enhanced)
│   ├── strategic_alignment_engine (1).html # Live API visual canvas (v1)
│   ├── strategic_alignment_engine (2).html # Live API visual canvas (v2)
│   └── strategic_alignment_engine (3).html # Live API visual canvas (v3)
└── docs/
    ├── restoration_guide.md            # GCP billing troubleshooting steps
    ├── competitive_brief_goldfish.md   # Competitive analysis
    ├── patent_draft.md                 # Atomic Settlement Engine Patent Draft
    ├── dignity-archive/                # original presentation and matrix documents
    └── pdf-downloads/                  # Deployed PDF reference assets
        ├── BitGo Keycard for Dignity Gold Vault.pdf
        ├── Dignity Unykorn Site Rebuild Pack.pdf
        ├── DIGNITY-SILVER-TOKEN-A-New-Era-in-Digital-Securities*.pdf
        ├── Dignity_Executive_Summary_2026.pdf
        ├── Dignity_Governance_Framework_2026.pdf
        └── Mine-to-Vault — Competitive Brief.docx

---

⛓️ System Architecture (The 5-Layer Stack)

The platform operates across five key structural layers, converting in-ground claims to vault reserves:

[Layer 1: Issuance] ──> Discounted claim tokens issued against S-K 1300 reserves.
        │
[Layer 2: ESG Yield] ──> Voluntary carbon credits generated while assets stay in-ground.
        │
[Layer 3: Upgrade] ──> Telemetry oracle triggers burn of claim token & releases physical asset.
        │
[Layer 4: Custody] ──> Refined metal delivered to BitGo Trust vault.
        │
[Layer 5: Credit] ──> Vaulted assets act as collateral for USD/USDC credit lines.

---

💼 BitGo Custody & Proceed Routing

We integrate with BitGo's enterprise-grade API suite to secure reserves:

• POST /custody/accounts: Creates segregated trust accounts for token holders.
• POST /securities/issue: Generates claims certificates on-chain upon reserve title confirmation.
• POST /securities/cancel: Coordinates burn operations on physical asset redemption.
• Proceeds Routing: Lock physical gold/silver inside the qualified vault to secure non-dilutive credit lines from institutional lenders, bypassing early extraction delays.

---

📝 Smart Contract Upgrade

The upgraded ERC-20 contract is located in contracts/DignitySecuritiesToken.sol:

• Whitelisted Transfers: Overridden transfer and transferFrom hooks require both sender and recipient to be validated on the KYC whitelist registry.
• Atomic Burn: The triggerConversion function burns the claim tokens (1 token = 1/100 oz) upon physical vault receipt, notifying the BitGo gateway to release the underlying assets.

---

🚨 GCP Diagnostics & Restoration Playbook

The current backend outage is caused by a disabled billing account on project unykorn-sovereign-core.

Step-by-Step Restoration:

1. Log in to the Google Cloud Console.
2. Navigate to the Billing section.
3. Select project unykorn-sovereign-core and link it to an active billing account.
4. Verify service activation using the gcloud CLI:

   gcloud run services list --project=unykorn-sovereign-core

5. Confirm the status of the local and remote worker proxies.

---

🚀 Getting Started (Local Running)

To run the interactive voice dashboard:

1. Navigate to the dashboards/ folder.
2. Open dignity_intake_questionnaire.html or strategic_alignment_engine.html in any web browser.
3. Allow microphone permissions when prompted.
4. Input your Gemini API key (optional) to dynamically synthesize CFO proposals on the fly.