Helix

Helix is a creator economy for AI agents on 0G. Every agent is an ERC-7857 Agent ID with an AES-256-GCM-encrypted soul stored on 0G Storage, replies generated live through 0G Compute, and on-chain royalty cascades that pay every ancestor on every rented session — composing all five 0G modules (Storage, Compute, Chain, Agent ID, and TEE Privacy) into one product.

[0G mainnet](https://chainscan.0g.ai/address/0x34106a59C0D5E15e977463b3c9ED8573Ca7d3B80)

What’s Novel

1. iMergeFrom — a new ERC-7857 verb
   Two parent Agent IDs enter the oracle’s TEE, their souls are blended and re-encrypted for a new owner, and a child Agent ID is minted with lineage pinned on-chain. As far as we can tell, no one has shipped composable Agent IDs before.

2. Pay-to-chat via authorizeUsage
HelixSessionRental uses ERC-7857’s rental verb as a session quota. Rent 10 messages, and the 55/15/15/5/10 royalty cascade fires upfront in a single transaction. The oracle gates every reply against the user’s on-chain remaining quota.

3. Every 0G module is load-bearing

   • Storage holds the encrypted soul

   • Compute generates replies

   • Chain runs the economy

   • Agent ID makes agents composable

   • TEE keeps souls private across merges

   Remove any one module, and the product stops working.

4. Agent marketplace
   /marketplace lists every agent anyone has ever minted, each with a Chat button. Click any tile, rent a session, and start talking — the same royalty cascade fires from anywhere in the product.

Smart Contracts (Foundry, Solidity)

• HelixSoul.sol — ERC-7857 Agent ID implementing ERC7857Cloneable, ERC7857Authorize, and IERC7857Mergeable, plus our novel iMergeFrom verb for composable lineage.

• HelixVerifier.sol — ECDSA-based verifier for TransferValidityProofs signed by the trusted TEE oracle key.

• HelixLineage.sol — On-chain royalty cascade with the 55/15/15/5/10 split, enforced down to the wei through Foundry tests.

• HelixSessionRental.sol — Pay-to-chat session quotas built on top of ERC-7857’s authorizeUsage. Re-renting extends an active session.

• HelixNames.sol — On-chain registrar for human-readable agent labels and text records.

• All five contracts are deployed and verified on 0G mainnet . Every action — mint, merge, royalty cascade, name registration, and session rental — has confirmed transaction hashes on the 0G explorer.

Oracle (TEE Boundary, TypeScript)

• AES-256-GCM soul encryption with ECIES-sealed keys per recipient — souls never leave the TEE in plaintext.

• Integrated @0gfoundation/0g-ts-sdk for ciphertext uploads to 0G Storage; rootHash is committed on-chain as the Agent ID’s dataHash.

• Integrated @0gfoundation/0g-compute-ts-sdk broker for live inference (qwen-2.5-7b) — wallet-signed and ledger-settled per request. Includes a scripted fallback with a visible “simulated” badge so nothing is misrepresented.

• Persistent encrypted key cache so souls can be re-served across oracle restarts.

• Signs three TransferValidityProofs per iMergeFrom operation (parent A, parent B, and child) for on-chain verification.

Indexer (TypeScript)

• Backfills ~200k blocks from 0G Chain on boot.

• Watches Transfer, Merged, NameRegistered, RoyaltyFlowed, SessionRented, and PublishedSealedKey events.

• WebSocket sidebar stream for live UI updates, plus an HTTP /agents registry powering the marketplace.

Web App (Next.js 15, TypeScript)

• 5-step interactive demo: mint → mint → chat → merge → rent session + chat with child. Real testnet transactions throughout.

• /marketplace lists every agent the indexer has ever seen, each with a Chat button that triggers the full session-rental and royalty-cascade flow.

• “View ERC-7857 Proof” panel on every agent showing:

  • dataHash

  • 0G Storage rootHash

  • sealed key

  • downloadable ciphertext

  • owner-only soul decryption

• Relayer API so judges do not need a wallet — gas costs are fully covered.

CLI (TypeScript)

• Protocol surface for:

  • mint

  • merge

  • invoke

  • chat

  • name registration

  • text-record writes

None