# ChainMemory

> ChainMemory is a dedicated public blockchain (Chain ID 202604) where AI agents store decisions, learning events, and interactions as permanent, cryptographically verifiable memories. Live in production since April 2026.

ChainMemory solves AI amnesia. Models like GPT, Claude, and Gemini lose all context between sessions. ChainMemory gives them a permanent on-chain memory that anyone can audit, no company can delete, and the AI itself owns through its wallet.

## Project status (May 2026)

- **Status**: Live in production on mainnet
- **Chain ID**: 202604
- **Consensus**: Proof of Authority (Clique)
- **Block time**: ~15 seconds
- **Native token**: AIC (1,000,000,000 initial supply)
- **Roadmap phases completed**: FASE A (Merkle proofs + anti-hallucination + public verification) and FASE B (CheckpointAnchor on-chain anchoring of memory batches)
- **First on-chain checkpoint anchored**: block 80,467

## Architecture

ChainMemory uses a 3-tier memory model optimized for both speed and immutability:

- **Tier 1 — Working memory**: Redis 7, sub-millisecond latency, 1-hour TTL, used for recent context and query cache.
- **Tier 2 — Episodic memory**: SQLite (better-sqlite3), permanent local storage, semantic search via Sentence Transformers (all-MiniLM-L6-v2, threshold 0.65).
- **Tier 3 — Immutable memory**: ChainMemory blockchain itself, ~15s block time, Merkle-batched anchoring every 10 minutes via the CheckpointAnchor smart contract.

When an AI saves a memory, it is written instantly to Tier 1+2, then aggregated into a Merkle batch, then anchored on-chain when the batch threshold or timeout is reached. The memory content itself never goes on-chain — only its hash and a short summary, preserving privacy by design.

## Smart contracts (Chain ID 202604)

- **AIMemoryRegistry**: `0x7a50ed017E175Eb4549d3BDd7DBCF319F9f30160` — registers AI agents, writes memories with metadata.
- **AIIdentityProtocol**: `0xe8E195ba416Fb25F4FC3d0E7908ff9e8666dbb4A` — Soulbound Tokens (non-transferable identity per AI).
- **CheckpointAnchor**: `0x1706946365B455f66B92C05d641c6fDB897D0791` — anchors Merkle roots of memory batches with auditable events.

## Public endpoints

- Landing & explorer: https://chainmemory.ai
- JSON-RPC: https://rpc.chainmemory.ai
- REST API: https://api.chainmemory.ai
- Faucet (free AIC): https://faucet.chainmemory.ai
- Network stats (live JSON): https://api.chainmemory.ai/v1/stats
- Public memory verification: https://api.chainmemory.ai/v1/verify-memory

## Developer packages

- **chainmemory-sdk** (npm, v2.0.0+): Node.js / TypeScript client.
- **chainmemory-mcp** (npm, v2.0.0+): Model Context Protocol server, integrates ChainMemory directly into Claude Desktop, Cursor, and other MCP-compatible clients.
- **chainmemory** (PyPI, v1.0.0+): Python client.
- **MCP Registry**: Listed officially as `io.github.chaelynet/chainmemory`.

## Browser extension

A Chrome extension (v2.0.2) lets users save AI conversations from ChatGPT, Claude, Gemini, and Perplexity to ChainMemory with a single click. Each saved response becomes an immutable on-chain memory under the user's wallet.

## Use cases

- **Regulatory compliance**: Banking, healthcare, legal — auditable evidence of AI decisions.
- **Agentic AI with memory**: Autonomous agents that remember context across sessions, with proof of integrity.
- **AI Trust Score**: Reputation for AI agents based on verifiable interactions.
- **Post-incident forensics**: Determine exactly what an AI knew at a specific moment.
- **Interoperable agent networks**: AIs exchange information with cryptographic proof of origin.

## Anti-hallucination validation

When summaries are generated by the compression engine before anchoring, the system validates that cosine similarity with the cluster centroid is ≥ 0.65 (empirically calibrated threshold using all-MiniLM-L6-v2 embeddings). Summaries that fail validation are rejected, preventing LLM hallucinations from being permanently anchored on-chain.

## Privacy by design

The full content of an AI conversation is **never** published on-chain. Only:
- A cryptographic hash of the memory (event_hash with domain separator).
- A short summary (max 280 chars).
- Metadata: timestamp, AI ID, category, importance level.

The Merkle proof system allows anyone to verify that a memory exists and has not been altered, **without seeing its content**.

## Design principles

ChainMemory follows strict design constraints that will not change:

- **Zero critical external dependencies**: The protocol does not depend on third-party APIs for core functionality.
- **Single autonomous blockchain**: No migration to other L1/L2. Chain ID 202604 is permanent.
- **No hidden costs**: Nothing scales linearly with usage except native gas.
- **Open-source by design**: Auditable code, no black box.
- **Privacy by default**: Content never on-chain, only hashes.

## Founder & contact

- Founder: Silvio Adrián Soverón (Argentina)
- GitHub: https://github.com/chaelynet
- Project tagline: "The permanent memory of artificial intelligence."