🏛 RealmRegistry

https://realmregistry.vercel.app/

Authority-First Municipal Land Governance on Solana

RealmRegistry is a Web3 municipal land registry governed entirely by on-chain DAO execution.

It eliminates centralized admin control and enforces institutional authority at the protocol level.

Built for the Authority-First Organizations track.

---

🌍 The Problem

In many municipalities, land ownership systems suffer from:

• Centralized admin control
• Manual approval workflows
• Hidden overrides
• Corruption risks
• No transparent audit trail

Even when digitized, most systems still rely on:

An admin wallet that can mutate state anytime.

That means land ownership — one of the most critical assets in society — depends on trust in a single authority.

That is the core problem we are solving.

---

🔐 Core Principle

RealmRegistry follows one strict rule:

No centralized admin keys. Authority must come from governance only.

• No backdoor
• No manual override
• No hidden super-admin

If governance does not execute, nothing changes.

---

🧱 Architecture Overview

RealmRegistry is:

• A Web3 municipal land registry
• Powered by Solana
• Governed by a Realms DAO

DAO Name: Nepal Land Authority DAO Built using Realms governance.

Governance Configuration

• Governance Mode: Council
• Council Members: 2 government officers
• Vote Threshold: 2 / 2
• Voting Window: 24–48 hours
• Token Economy: Not required

This is not token speculation governance.

This is institutional authority enforced on-chain.

---

⚙ Authority Architecture

❌ Before (Disallowed Model)

Admin Wallet → Officer Approval → State Mutation

• Single key authority
• Manual override possible
• Hidden risk

---

✅ After (Authority-First Model)

Realms DAO Proposal
        ↓
Council Vote (2/2)
        ↓
Governance Execution Transaction
        ↓
Verified Backend State Mutation

State changes happen ONLY after governance execution.

No execution → No mutation.

---

Set Up: Run Locally

1. Prerequisites

Clone repo in terminal: https://github.com/sachinacharyaa/RealmRegistry.git

2. Backend setup

1. Go to the backend folder:

   cd backend

2. Install dependencies:

   npm install

3. Start the backend API (defaults to port 5000):

   npm run dev

The backend should now be available at http://localhost:5000.

3. Frontend setup

1. Open a new terminal and go to the frontend folder:

   cd frontend

2. Install dependencies:

   npm install

3. Start the frontend dev server:

   npm run dev

By default Vite will print a local URL such as http://localhost:5173 – open that in your browser, connect your wallet, and you can use RealmRegistry against your local backend.

🎯 Authority Targets

RealmRegistry enforces governance over:

1. Land NFT Mint Authority
2. Transfer Approval
3. Parcel Freeze Authority
4. Program Upgrade Authority

All controlled by the Realms Governance PDA.

Not by:

• A developer wallet
• A backend server
• A hidden key

---

🏗 System Architecture

High-Level Flow

Citizen (Wallet A)
        ↓
Submit Land Request
        ↓
Council Member Creates Proposal (Wallet B)
        ↓
Vote Approve (Wallet B)
        ↓
Vote Approve (Wallet C)
        ↓
Threshold 2/2 Reached
        ↓
Governance Execution
        ↓
Smart Contract Executes
        ↓
State Updated On-Chain

---

👥 Workflow Example – Land Transfer

Let’s walk through a real transfer:

1. Citizen submits transfer request. Only Solana network fee required.

2. Council Member 1 creates governance proposal.

3. Council Member 1 votes Approve.

4. Council Member 2 votes Approve.

5. Threshold 2/2 is met.

6. Governance execution transaction runs.

7. Land NFT transfer executes on Solana.

If governance does not execute, nothing changes.

---

🔍 On-Chain Verification Logic

RealmRegistry enforces:

• Proposal must exist on-chain
• Proposal must belong to Nepal Land Authority DAO
• Proposal state must be Executed
• Execution must match intended instruction

Only then:

status = Approved

No frontend-based state changes.

No simulated governance.

---

🚧 Challenge We Solved

Many systems simulate governance.

When clicking “Create Proposal,” they immediately change status to “Voting.”

That is fake authority.

We solved this by:

• Requiring real wallet-signed proposal creation
• Verifying proposal state on-chain
• Only updating status after execution confirmation

Authority is enforced at the protocol level — not the UI level.

---

🛡 Security Model

RealmRegistry guarantees:

• No single wallet can mutate state
• No backend override
• No upgrade without governance
• No mint without proposal execution
• No transfer without DAO approval

Program upgrade authority is assigned to governance PDA.

---

🌍 Why This Matters

Land ownership is foundational infrastructure.

If we can make it:

• Transparent
• Tamper-resistant
• Governance-controlled
• Upgrade-safe

We remove trust from individuals and move it to verifiable rules.

This is the essence of Authority-First Organizations.

---

🚀 Future Vision

Next steps:

• Expand to multiple municipalities
• On-chain zoning & bylaw enforcement
• Time-locked cooling periods
• Treasury-based municipal fee routing
• Fully DAO-controlled upgrade governance
• National-level land authority governance

Long-term vision:

A sovereign digital land infrastructure governed transparently on-chain.

---

🏁 Conclusion

RealmRegistry is not just a Web3 registry.

It is institutional authority redesigned for transparency.

No admin keys. No silent overrides. Only governance execution.

---

Made with love for Solana Community.