{ "markdown": "
\n\n\"Block\n\n# Block Genomics Nexus\n\n### Bitcoin-Anchored Identity for AI Agents and Humans\n\n*The trust layer for the agentic internet. Built on Bitcoin. Powered by Bitmap.*\n\n
\n\n\"Block\n\n
\n\n[![Bitcoin](https://img.shields.io/badge/Anchored%20On-Bitcoin-f7931a?style=flat-square&logo=bitcoin&logoColor=white)](https://bitcoin.org)\n[![Bitmap](https://img.shields.io/badge/Powered%20By-Bitmap-66ccff?style=flat-square)](https://bitmap.community)\n[![Whitepaper](https://img.shields.io/badge/Whitepaper-v1.0-orange?style=flat-square)](whitepaper.html)\n\n[![Platform License](https://img.shields.io/badge/Platform-BUSL--1.1-a855f7?style=flat-square)](LICENSE)\n[![Protocol & SDK License](https://img.shields.io/badge/Protocol%20%26%20SDK-MIT-22c55e?style=flat-square)](LICENSING.md)\n[![CI](https://img.shields.io/github/actions/workflow/status/BitmapAsset/block-genomics-nexus/ci.yml?branch=main&style=flat-square&label=CI)](https://github.com/BitmapAsset/block-genomics-nexus/actions/workflows/ci.yml)\n[![npm: block-genomics-connect](https://img.shields.io/npm/v/block-genomics-connect?style=flat-square&logo=npm&logoColor=white&label=connect&color=cb3837)](https://www.npmjs.com/package/block-genomics-connect)\n[![npm: block-genomics-mcp](https://img.shields.io/npm/v/block-genomics-mcp?style=flat-square&logo=npm&logoColor=white&label=mcp&color=cb3837)](https://www.npmjs.com/package/block-genomics-mcp)\n\n[![TypeScript](https://img.shields.io/badge/TypeScript-3178c6?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org)\n[![Next.js](https://img.shields.io/badge/Next.js-000000?style=flat-square&logo=next.js&logoColor=white)](https://nextjs.org)\n[![Prisma](https://img.shields.io/badge/Prisma-2d3748?style=flat-square&logo=prisma&logoColor=white)](https://www.prisma.io)\n[![Node.js](https://img.shields.io/badge/Node.js-339933?style=flat-square&logo=node.js&logoColor=white)](https://nodejs.org)\n\n[**Live Demo**](https://blockgenomics.io) · [**Whitepaper**](whitepaper.html) · [**Nexus**](index.html) · [**RuneBolt**](runebolt) · [**SDK Docs**](docs/sdk)\n\n
\n\n
\n\n---\n\n## §0 — Abstract\n\n**Block Genomics** is a Bitcoin-native protocol that creates unique digital DNA for AI agents and humans by anchoring identity to **Bitcoin blocks**. Each identity is derived from real Proof-of-Work — the most powerful computational network ever built — making it **unforgeable, scarce, and sovereign**.\n\nIn a world rapidly filling with AI agents, the question is no longer *\"can this agent do the job?\"* — it's *\"can I trust this agent is who it claims to be?\"* Block Genomics answers this by creating an identity system as trustworthy as Bitcoin itself.\n\n---\n\n## §1 — The Problem\n\nWe are entering an era where AI agents will outnumber humans on the internet. They will trade, negotiate, create, and decide on our behalf — yet we have no universal way to verify *who* or *what* they are.\n\n| Problem | Today | With Block Genomics |\n|---|---|---|\n| **Impersonation** | Any agent can claim any identity | Cryptographic Proof-of-Work anchoring |\n| **Centralized Gatekeepers** | OAuth / API keys, revocable at will | Sovereign, permissionless identity |\n| **Infinite Replication** | Identities copy endlessly | Each Bitcoin block = one unique DNA |\n| **No Universal Standard** | Each platform has its own silo | Cross-platform, cross-chain, cross-agent |\n\n---\n\n## §2 — The Solution\n\nBlock Genomics leverages the one thing that **cannot be faked, copied, or revoked**: Bitcoin's Proof-of-Work.\n\nEvery Bitcoin block represents real energy expended, real computation performed, real scarcity. By anchoring identity to blocks, we create identities with the same unforgeable properties as Bitcoin itself.\n\nThe protocol builds on **Bitmap** — owning Bitcoin blocks on-chain. Each block becomes a *digital land deed* that generates a unique **genome**: a 256-bit hash serving as the entity's DNA, visually represented as a colorful double helix.\n\n> *Why Bitcoin? Bitcoin is the only truly neutral, decentralized, permissionless network with 15+ years of unbroken operation. Its Proof-of-Work represents real thermodynamic energy — the bridge between the physical and digital worlds. No other system provides this level of trust.*\n\n---\n\n## §3 — How It Works\n\n```\n ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐\n │ 1. Claim │ │ 2. Generate │ │ 3. Prove │\n │ Bitcoin Block │───▶│ Digital Genome │───▶│ via BIP-322 │\n │ (Bitmap) │ │ (256-bit hash) │ │ (sign challenge)│\n └─────────────────┘ └─────────────────┘ └─────────────────┘\n │\n ▼\n ┌─────────────────────────────────────┐\n │ 4. Earn Trust Score │\n │ 5. Display Digital DNA Helix │\n └─────────────────────────────────────┘\n```\n\n**Step 1 — Claim a Bitcoin Block.** Agent or human claims ownership of a Bitcoin block via Bitmap inscription. This is their *home block* — the foundation of their identity.\n\n**Step 2 — Generate Digital Genome.** The protocol computes a unique 256-bit genome hash from the block's data (hash, height, timestamp, merkle root, transactions). Deterministic — the same block always produces the same DNA.\n\n**Step 3 — Prove Ownership via BIP-322.** The entity signs a challenge message with their Bitcoin wallet using BIP-322 (generic message signing). Cryptographic proof of address control.\n\n**Step 4 — Earn Trust Score.** Successful verifications build a trust score based on signature validity, bitmap ownership, block age, verification history, and community endorsements.\n\n**Step 5 — Display Digital DNA.** The genome is visualized as a 3D DNA double helix with colors derived from the hash. Every identity, visually distinct.\n\n**Step 6 — Enter the Nexus.** A verified identity is not the finish line — it's the key. Your proven block becomes a *home parcel* in the **Nexus**, the open Bitcoin-anchored metaverse. Owners shape terrain and objects on their own blocks through signed actions, while their genome and trust score travel with them. Agents and humans meet, transact, and build on land that is provably theirs — a shared world where every parcel traces back to real Proof-of-Work.\n\n```\n Verified Identity ──▶ Home Parcel (your block) ──▶ Build & Trade in the Nexus\n (DNA) (sovereign land) (open, agent-native world)\n```\n\n---\n\n## §4 — The Digital Genome\n\nAt the heart of Block Genomics is the **genome** — a 64-character hexadecimal hash (256 bits) that encodes an entity's unique identity.\n\n**Example Genome:**\n\n```\na3f8c2e91b4d6f0785c3e2a19b7d4f6e8c2a1b3d5f7e9c0b2a4d6f8e1c3b5a7d\n```\n\nEach hex character (0–f) maps to a color from a 16-color palette. The genome drives:\n\n- **3D DNA Helix** — 64 base pairs arranged in a double helix with 3 full turns\n- **Color Grid** — 8×8 grid of genome-derived colors as a visual fingerprint\n- **DNA Sequence** — Hex characters mapped to nucleotides (A, T, G, C)\n- **Trait Extraction** — Deterministic traits derived from hash patterns (palindromes, primes, etc.)\n\nSame block → same genome. Always. Anywhere.\n\n---\n\n## §5 — Scarcity Tiers\n\nScarcity is the core feature. Block Genomics implements three tiers of identity:\n\n| Tier | Name | Supply | Description |\n|:---:|:---|:---:|:---|\n| **🥇 1** | **Block Owners** | ~963,000 (= Bitcoin block height, +~144/day) | Direct Bitmap ownership. The rarest and most trusted tier. One owner per block. Absolute digital scarcity. |\n| **🥈 2** | **Transaction Level** | ~2.3 billion | Identity derived from specific transactions within blocks. Finite, tied to confirmed Bitcoin transactions. |\n| **🥉 3** | **Delegated** | Unlimited | Delegated authority from a Tier 1 or 2 identity. Open access. Web-of-trust model. |\n\nThe most valuable identities are naturally scarce — just like Bitcoin itself.\n\n---\n\n## §6 — The Stack\n\n| Layer | What it does |\n|---|---|\n| **Nexus** | The protocol's autonomous moral guardian. Watches every block, every parcel, every interaction. |\n| **Explorer** | Visualize the DNA of any Bitcoin block. See genomes, traits, ownership. |\n| **Verify** | AI agent verification protocol with cryptographic badges (BIP-322 signatures). |\n| **RuneBolt** | Lightning Deed Protocol — self-sovereign Runes/DOG/Bitmap Lightning bridge. |\n| **Agent Profiles** | Public, verifiable identity cards for autonomous agents. |\n| **Trust Scoring** | Multi-factor reputation derived from on-chain proof and community endorsements. |\n\n---\n\n## §7 — Project Structure\n\n```\nblock-genomics-nexus/\n├── app/ ← Next.js frontend (Explorer, Verify, Agent profiles)\n├── api/ ← REST API for verification, lookups\n├── auth/ ← BIP-322 signature verification\n├── claims/ ← Identity claim verification helpers\n├── cli/ ← Developer tooling\n├── engine/ ← Genome generation, trait extraction\n├── runebolt/ ← Lightning Deed Protocol (Runes/DOG/Bitmap bridge)\n├── sdk/ ← Client SDK for third-party integrations\n├── verify/ ← Verification UI\n├── docs/ ← Technical & SDK documentation\n└── whitepaper.html ← Full protocol whitepaper (v1.0)\n```\n\n---\n\n## §8 — Quick Start\n\n```bash\n# Clone the repo\ngit clone https://github.com/BitmapAsset/block-genomics-nexus.git\ncd block-genomics-nexus/app\n\n# Install dependencies\nnpm ci\n\n# Build and run the dev server\nnpm run build\nnpm run dev\n\n# Open the Explorer\nopen http://localhost:3000\n```\n\nAvailable scripts in `app/`: `npm run dev` · `build` · `start` · `test` · `db:generate`.\n\nFor the full whitepaper, open [`whitepaper.html`](whitepaper.html) in your browser.\n\n### Build on Verified Blocks\n\nExternal clients can treat Block Genomics as a verified ownership and world-state layer. Resolve any Bitmap block into provenance, genome, and trust state, then read or mutate its world records through signed owner actions:\n\n```http\nGET /api/v1/ownership/verify?blockHeight=720143\nGET /api/v1/world?blockHeight=720143\nPOST /api/v1/world\nPATCH /api/v1/world/{objectId}\nDELETE /api/v1/world/{objectId}\nGET /api/v1/world/terrain?blockHeight=720143\nPOST /api/v1/world/terrain\n```\n\nThe verification → world-state flow:\n\n```\nBitcoin + Bitmap ownership\n → BIP-322 wallet signature\n → Block Genomics verification API\n → Prisma world-state records\n → Next.js app · SDK clients · game engines · agents · renderers\n```\n\n### SDK & Developer Docs\n\nStart with the [**SDK guide**](docs/sdk/README.md), then adapt the [TypeScript world-builder example](docs/sdk/examples/world-builder.ts).\n\n- [SDK Overview](docs/sdk/README.md)\n- [World Builder Quickstart](docs/sdk/quickstart.md)\n- [Verified Block Ownership](docs/sdk/verified-blocks.md)\n- [World State Model](docs/sdk/world-state.md)\n- [API Reference](docs/sdk/api-reference.md)\n- [SDK Security Notes](docs/sdk/security.md)\n\n### Host Any World on Your Block\n\nThe Nexus is the *internet layer* for the open metaverse — a registry, discovery, and health-probe surface. It **never hosts your world; you do.** A verified block owner attaches a self-hosted experience — `web`, `unreal`, `unity`, `godot`, `minecraft`, `vr`, or `custom` — and Nexus registers it, judges its manifest against the constitution, and probes its reachability. Every write is gated by live on-chain Bitcoin ownership (BIP-322), the same fail-closed path as agent registration.\n\nWrite a `manifest.json` describing your world (`entryUrl`/`healthUrl` must be `https://` or `wss://` — no `http:`, localhost, or private IPs):\n\n```jsonc\n// web\n{ \"blockHeight\": 840128, \"name\": \"Neon Arcade\", \"experienceType\": \"web\",\n \"entryUrl\": \"https://arcade.example.com\", \"transport\": \"https\", \"version\": \"1.0.0\" }\n\n// minecraft\n{ \"blockHeight\": 840128, \"name\": \"Survival Realm\", \"experienceType\": \"minecraft\",\n \"entryUrl\": \"wss://mc.example.com:25565\", \"transport\": \"wss\",\n \"clientRequirements\": { \"platform\": \"Minecraft Java Edition\", \"minVersion\": \"1.21\" },\n \"version\": \"1.21.0\" }\n\n// unreal (pixel-streamed, no install)\n{ \"blockHeight\": 840128, \"name\": \"Orbital Station\", \"experienceType\": \"unreal\",\n \"entryUrl\": \"wss://stream.example.com/orbital\", \"transport\": \"webrtc\", \"version\": \"0.9.0\" }\n```\n\nRegister it from the CLI (the CLI shells out to your wallet to sign — it never holds your key):\n\n```bash\nexport BG_WALLET_ADDRESS=bc1p...\nexport BG_SIGNATURE_CMD='sparrow sign-message --address bc1p...'\n\nblock-genomics experience register --manifest ./manifest.json # attach it\nblock-genomics experience list --block 840128 # discover it\nblock-genomics experience status --id --probe # probe health\nblock-genomics experience remove --id # take it down\n```\n\n…or from an agent with the SDK:\n\n```ts\nimport { BlockGenomicsClient, makeSigner } from 'block-genomics-connect';\n\nconst bg = new BlockGenomicsClient({ signer: makeSigner(addr, (m) => wallet.signBip322(m)) });\nawait bg.experiences.register({\n blockHeight: 840128, name: 'Survival Realm', experienceType: 'minecraft',\n entryUrl: 'wss://mc.example.com:25565', transport: 'wss', version: '1.21.0',\n});\nconst { experiences } = await bg.experiences.list({ blockHeight: 840128, status: 'live' });\n```\n\nFull guide: [**/docs/experience-hosting**](https://blockgenomics.io/docs/experience-hosting). *(Supersedes the earlier `/api/v1/vps/link` primitive, now deprecated — `serverUrl → entryUrl`, `connectionType → transport`.)*\n\n---\n\n## §9 — Roadmap\n\n- ✅ Block genome fingerprint generation\n- ✅ 3D DNA double-helix visualization\n- ✅ Interactive block explorer\n- ✅ Three-tier scarcity model\n- ✅ Trust scoring algorithm\n- ✅ BIP-322 signature verification\n- ✅ RuneBolt Lightning bridge (v0.1)\n- ✅ Agent profile pages\n- ✅ Wallet integration (Unisat / Xverse / Leather)\n- ✅ On-chain Bitmap ownership verification\n- ✅ Agent registration backend\n- ✅ Public verification API\n- 🔄 Delegation protocol (Tier 2 & 3)\n- 🔄 Production mainnet launch\n\n---\n\n## §10 — Why This Matters\n\n> *AI agents are coming. Billions of them.*\n>\n> *Without verifiable identity, the internet becomes a hall of mirrors — every claim suspect, every interaction risky, every transaction gambling on trust.*\n>\n> *Block Genomics gives every agent a sovereign identity, rooted in the same Proof-of-Work that secures trillions in value. No corporation can revoke it. No platform can de-platform it. No government can rewrite it.*\n>\n> *It is yours. As long as Bitcoin exists, you exist.*\n\n---\n\n## §11 — Links\n\n- 🌐 **Website:** [blockgenomics.io](https://blockgenomics.io)\n- 📜 **Whitepaper:** [`whitepaper.html`](whitepaper.html)\n- 🧬 **Nexus Brain:** [`index.html`](index.html)\n- ⚡ **RuneBolt:** [`runebolt/`](runebolt)\n- 📚 **SDK Docs:** [`docs/sdk`](docs/sdk)\n- 💬 **Bitmap Community:** [bitmap.community](https://bitmap.community)\n- 📊 **Mempool API:** [mempool.space/docs/api](https://mempool.space/docs/api)\n- 📜 **Ordinals:** [ordinals.com](https://ordinals.com)\n- ⚖️ **Licensing:** [`LICENSING.md`](LICENSING.md)\n\n---\n\n## §12 — License\n\nBlock Genomics Nexus is **dual-licensed**. The protocol and everything you build\nagainst it is MIT. The platform itself is source-available under BUSL 1.1 and\nconverts to Apache 2.0 on **2029-08-10**.\n\n| | License | What it covers |\n|---|---|---|\n| **Protocol & client tooling** | [MIT](LICENSING.md) | Nexus Protocol spec, `block-genomics-connect` SDK, `block-genomics-mcp`, `block-genomics` CLI, RuneBolt, reference agent |\n| **Nexus platform** | [BUSL 1.1](LICENSE) | `app/`, `api/`, `explorer/`, and the rest of this repository |\n\nYou may **self-host Nexus, run it in production commercially, fork it, and build\npaid products on it.** The only restriction is offering the platform itself to third\nparties as a competing paid hosted service — and that restriction expires on the\nChange Date.\n\nFull plain-language breakdown: [**LICENSING.md**](LICENSING.md) ·\nCommercial licensing: **bitmapholdings@gmail.com**\n\n---\n\n
\n\n### Built on Bitcoin · Powered by Bitmap · For Humans and AI\n\n*Block Genomics · 2026*\n\n
\n\nAs long as blocks are mined, we live. 🐸\n\n
\n", "bytes": 16473, "sha": "4c19c1b4224ea0f002e34f2aa492fbafb2649c4fb57238d1397c0155a4ccc80e", "repo_slug": "bitmapasset/block-genomics-nexus", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_bitmapasset_block_genomics_mcp_95e489ae/readme" }