EIDOLON

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.

Hackathon Progress:

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.

Smart Contracts (Solidity 0.8.26 / Foundry)

• ERC-7857 SoulNFT with oracle-mediated drift transfer (direct ERC-721 transfers blocked)

• Fixed-price Marketplace with escrow and royalty distribution (EIP-2981, 2.5% default)

• OracleRegistry for trusted oracle management

• All 3 contracts deployed to 0G Mainnet (Chain ID 16661), 12/12 Foundry tests passing

Soul SDK (TypeScript, 1,209 lines, zero TODOs/stubs)

• Full Soul lifecycle: mint, summon, act, imprint, drift, awaken

• 16-dimensional personality vector with 11 emotion-to-trait mappings and skill unlock detection

• ECIES (secp256k1) encryption — all Soul data encrypted at rest

• IMemoryProvider abstraction layer with hot-swappable providers

Two Playable Worlds (Next.js 14)

• The Tavern (medieval): 5 NPCs, 3 tasks, full dialogue system

• The Echo Market (cyberpunk): 3 NPCs, 2 tasks, typewriter awakening effect

• Key moment: Soul awakens in a new world and references past-life memories unprompted, proving cross-world memory continuity

Oracle Service

• Dockerized event listener watching DriftRequested events

• Full TEE pipeline: download → decrypt → re-encrypt for new owner → upload → sign → completeDrift()

Deep Integration of 6 0G Components

1. 0G Chain — settlement layer for all state transitions

2. 0G Storage Log — permanent encrypted Soul metadata blobs

3. 0G Storage KV — sub-second memory index retrieval during gameplay

4. 0G Compute (TEE) — verifiable inference for every Soul action

5. ERC-7857 (iNFT) — oracle-mediated transfer + re-encryption standard

6. Persistent Memory — production-ready memory provider abstraction

Live Demo: https://dhe3987p.mule.page/

GitHub: https://github.com/wangyangmingsss/eidolon

no