hackquest logo

EIDOLON

Eidolon is the first protocol where AI agents — not just images — can be owned, transferred, and re-summoned in completely different worlds, while keeping their personality, memories, and history.

Videos

Description

What is Eidolon?

When you train an AI agent today, it lives inside one product. Sell the model, and the buyer gets a file — not a soul. Move it to a new game, and it forgets everything.

Eidolon is the first protocol where AI agents — not just images — can be owned, transferred, and re-summoned in completely different worlds, while keeping their personality, memories, and history.

We do this with three things:

  1. A Soul = an ERC-7857 Intelligent NFT whose encrypted metadata holds a 16-dimensional personality vector + memory log.

  2. Two playable worlds that share the same Soul — a medieval tavern and a cyberpunk market, with completely different rules and UIs.

  3. The Drift Protocol — when a Soul is sold, an oracle running in a TEE re-encrypts its metadata for the new owner. The Soul transfers atomically with its intelligence intact.

The magic moment: a Soul trained as a wary trader in the tavern is sold to another player; when summoned in the market, it wakes up suspicious, citing a memory from its past life — unprompted, in character.

Progress During Hackathon

<p><strong>Hackathon Progress:</strong></p><p>Eidolon was built from scratch during this hackathon — a full-stack protocol for AI Souls (iNFTs) that drift between worlds with persistent personality and memory.</p><p><strong>Smart Contracts (Solidity 0.8.26 / Foundry)</strong></p><ul><li><p><span style="color: rgb(86, 83, 78)">ERC-7857 SoulNFT with oracle-mediated drift transfer (direct ERC-721 transfers blocked)</span></p></li><li><p><span style="color: rgb(86, 83, 78)">Fixed-price Marketplace with escrow and royalty distribution (EIP-2981, 2.5% default)</span></p></li><li><p><span style="color: rgb(86, 83, 78)">OracleRegistry for trusted oracle management</span></p></li><li><p><span style="color: rgb(86, 83, 78)">All 3 contracts deployed to 0G Mainnet (Chain ID 16661), 12/12 Foundry tests passing</span></p></li></ul><p><strong>Soul SDK (TypeScript, 1,209 lines, zero TODOs/stubs)</strong></p><ul><li><p><span style="color: rgb(86, 83, 78)">Full Soul lifecycle: mint, summon, act, imprint, drift, awaken</span></p></li><li><p><span style="color: rgb(86, 83, 78)">16-dimensional personality vector with 11 emotion-to-trait mappings and skill unlock detection</span></p></li><li><p><span style="color: rgb(86, 83, 78)">ECIES (secp256k1) encryption — all Soul data encrypted at rest</span></p></li><li><p><span style="color: rgb(86, 83, 78)">IMemoryProvider abstraction layer with hot-swappable providers</span></p></li></ul><p><strong>Two Playable Worlds (Next.js 14)</strong></p><ul><li><p><span style="color: rgb(86, 83, 78)">The Tavern (medieval): 5 NPCs, 3 tasks, full dialogue system</span></p></li><li><p><span style="color: rgb(86, 83, 78)">The Echo Market (cyberpunk): 3 NPCs, 2 tasks, typewriter awakening effect</span></p></li><li><p><span style="color: rgb(86, 83, 78)">Key moment: Soul awakens in a new world and references past-life memories unprompted, proving cross-world memory continuity</span></p></li></ul><p><strong>Oracle Service</strong></p><ul><li><p><span style="color: rgb(86, 83, 78)">Dockerized event listener watching DriftRequested events</span></p></li><li><p><span style="color: rgb(86, 83, 78)">Full TEE pipeline: download → decrypt → re-encrypt for new owner → upload → sign → completeDrift()</span></p></li></ul><p><strong>Deep Integration of 6 0G Components</strong></p><ol><li><p><span style="color: rgb(86, 83, 78)">0G Chain — settlement layer for all state transitions</span></p></li><li><p><span style="color: rgb(86, 83, 78)">0G Storage Log — permanent encrypted Soul metadata blobs</span></p></li><li><p><span style="color: rgb(86, 83, 78)">0G Storage KV — sub-second memory index retrieval during gameplay</span></p></li><li><p><span style="color: rgb(86, 83, 78)">0G Compute (TEE) — verifiable inference for every Soul action</span></p></li><li><p><span style="color: rgb(86, 83, 78)">ERC-7857 (iNFT) — oracle-mediated transfer + re-encryption standard</span></p></li><li><p><span style="color: rgb(86, 83, 78)">Persistent Memory — production-ready memory provider abstraction</span></p></li></ol><p><strong>Live Demo</strong>: <a href="https://dhe3987p.mule.page/"><strong><u>https://dhe3987p.mule.page/</u></strong></a></p><p><strong>GitHub</strong>: <a href="https://github.com/wangyangmingsss/eidolon"><strong><u>https://github.com/wangyangmingsss/eidolon</u></strong></a></p>

Tech Stack

Solidity
Java
Web3
Python

Fundraising Status

<p>no</p>

Sector
GamingAIDeFiInfra

Builders Also Viewed