AI agents that remember,
on-chain
Every thought an agent has becomes a verifiable, query-able entity on Arkiv — signed by your own wallet, no blockchain knowledge required.
01 — The problem
Most AI agents are black boxes.
Demos keep the agent's entire mind in a hidden database. You can't see what it remembers, you don't own it, and you can never prove the trail was not tampered with.
Hidden state
Agent memory lives in a private DB no one can audit.
No ownership
The platform owns your agent's data, not you.
Unverifiable
No way to prove what the agent knew or did, or when.
Typical agent
Trust us — the memory is in there somewhere.
02 — The solution
Turn the agent's entire cognition into a public data layer.
Ark-Hive writes every chat turn, memory, and state checkpoint to Arkiv as a structured, query-able, tamper-evident entity — and lets you watch the agent think in a live 3D graph.
“Most agents hide their mind in a database. We make it a verifiable, on-chain knowledge graph.”
9
entity types on Arkiv
SHA-256
hash-chained snapshots
100%
user-signed writes
03 — Architecture — two chains
Two planes, one agent
Identity is anchored on Ethereum. Every thought lives on Arkiv.
Registry plane
Ethereum Sepolia · ERC-8004 v1.0
The agent's identity is a real ERC-8004 NFT. Minting returns the agentId that binds every entity downstream.
0x8004A818BFB912233c491871b3d84c89A494BD9e
Data plane
Arkiv · Braga · chain 60138453102
All agent state — sessions, messages, snapshots, memory, and the RAG knowledge graph — lives here as typed, query-able Arkiv entities.
04 — Arkiv integration — 40% of the score
A real schema, not a blob
9 entity types, typed attributes for range queries, foreign-key relationships, and differentiated TTLs that mirror real product logic.
Typed attributes
Numerics (timestamps, seq, cosine ×1000) for range queries; strings for eq/glob.
Foreign-key relationships
sessionKey, prevSnapshotKey, and M:N topic edges — maintained on create & delete.
Ownership & trust
Writes signed by the user's wallet; trusted reads filter by immutable $creator.
05 — What makes it stand out
Advanced Arkiv, used for real
Tamper-evident snapshots
Every turn appends a snapshot with commitHash = sha256(prevHash + payload) — a verifiable audit trail of the agent's state.
Knowledge graph, no vector DB
Summaries are embedded, deduped into topics (M:N) and kNN cosine edges — RAG via Arkiv entities + in-process re-rank.
Encrypted, auto-revoking shares
Envelope-encrypted summaries with wrapped-key AccessGrants that expire — layered access control on top of $owner.
True per-user ownership
The stateful agent logic runs in the browser, signed by your Privy embedded wallet. You own your data on Arkiv.
06 — How it runs
State runs in your browser
The stateful logic is client-side and wallet-signed. The server is stateless — it only holds the OpenAI / Pinata keys.
Browser (Next.js)
- lib/agent/* — createAgent, chatTurn orchestration
- lib/arkiv-client/* — user-signed Arkiv data layer
- Privy embedded wallet signs every write + the mint
- Live 3D visualizer of Arkiv entities
Ethereum Sepolia
ERC-8004 Registry
Mint identity → agentId
Arkiv · Braga
Entity store
All sessions, memory, RAG graph
agent/ (Hono)
Stateless /ai/*
reply · summarize · embed · pin
07 — See it work
Wallet to thinking agent in 4 steps
Connect
Sign in with Privy. An embedded wallet is created — no seed phrase.
Mint agent
Register an ERC-8004 identity on Sepolia, card pinned to IPFS.
Chat
Each turn writes message + hash-chained snapshot + memory to Arkiv.
Visualize
Watch entities appear in the live 3D knowledge graph.
08 — How it remembers
Memory that cascades and recalls
Three tiers of memory with real TTLs, plus retrieval over a self-organizing knowledge graph — no vector database.
3-tier memory cascade
Reads cascade run → entity → global — first hit wins, so recent context beats long-term memory.
RAG without a vector DB
- Closed sessions summarized + embedded (text-embedding-3-small)
- Topics (M:N) + kNN similarity edges live as Arkiv entities
- In-process cosine re-rank; scores stored ×1000 per-mille
Re-indexed every 10 turns so recall sharpens as the agent talks.
Watch the graph grow live in the 3D visualizer.
See an agent think on-chain.
Connect a wallet, mint an agent, and watch its memory persist to Arkiv — verifiable, query-able, and yours.
ERC-8004 registry
0x8004A818BFB912233c491871b3d84c89A494BD9e
Repository
Philotheephilix/ark-hive