# ChainMemory Documentation

> Complete technical documentation for ChainMemory — the dedicated public blockchain (Chain ID 202604) where AI agents store decisions, learning events, and interactions as permanent, cryptographically verifiable memories. Covers the Chrome extension, MCP server, REST API, blockchain concepts, and security models.

ChainMemory provides three integration methods: a Chrome Extension for browser-based saving, an MCP Server for Claude/Cursor integration, and a REST API for programmatic access. All memories are cryptographically hashed, Merkle-batched, and anchored on-chain. Content never goes on-chain — only hashes and metadata.

## Getting Started

- [Vision](https://docs.chainmemory.ai/#vision): Project vision — sovereign knowledge layer for AI
- [What is ChainMemory](https://docs.chainmemory.ai/#intro): Overview of the protocol and what it solves
- [Why ChainMemory](https://docs.chainmemory.ai/#why-chainmemory): Before/after scenarios showing the problem and solution
- [Quickstart](https://docs.chainmemory.ai/#quickstart): End-to-end guide: Store → Retrieve → Verify → Prove (Extension, MCP, or API)
- [Create Account](https://docs.chainmemory.ai/#account-create): Sign up, get API key, create first project
- [Architecture](https://docs.chainmemory.ai/#architecture): 3-tier memory model (Redis → SQLite → Blockchain)
- [Comparison](https://docs.chainmemory.ai/#comparison): ChainMemory vs traditional approaches

## Core Concepts

- [Event-Sourcing Model](https://docs.chainmemory.ai/#concept-event-sourcing): Append-only log, no destructive updates
- [What is a Memory](https://docs.chainmemory.ai/#concept-memory): Structure, fields, hash, tags, importance levels
- [Projects](https://docs.chainmemory.ai/#concept-project): Logical containers for memories with isolation
- [Project State](https://docs.chainmemory.ai/#concept-state): Consolidated view with milestones, risks, stack, decisions
- [Evidence Chain](https://docs.chainmemory.ai/#concept-evidence): How each memory links to the previous via event_hash
- [Conflict Resolution](https://docs.chainmemory.ai/#concept-conflicts): How concurrent writes are handled
- [State Governance](https://docs.chainmemory.ai/#concept-governance): Rules for state transitions and validation
- [Hash & Verification](https://docs.chainmemory.ai/#concept-hash): SHA-256 domain-separated hashing scheme
- [Privacy Model](https://docs.chainmemory.ai/#concept-privacy): Content never on-chain, only hashes and metadata

## Chrome Extension

- [Installation](https://docs.chainmemory.ai/#ext-install): Install from Chrome Web Store, configure API key
- [Save Memories](https://docs.chainmemory.ai/#ext-save): One-click save from ChatGPT, Claude, Gemini, Perplexity
- [Inject Context](https://docs.chainmemory.ai/#ext-inject): Load previous memories into new AI conversations
- [Project Brain (State Viewer)](https://docs.chainmemory.ai/#ext-project-brain): Visual dashboard of consolidated project state
- [Supported Platforms](https://docs.chainmemory.ai/#ext-platforms): Compatible AI platforms and versions

## MCP Server

- [Configuration](https://docs.chainmemory.ai/#mcp-setup): Setup in Claude Desktop, Cursor, or any MCP client
- [Tools](https://docs.chainmemory.ai/#mcp-tools): Available MCP tools: remember, recall, seal, inject, stats, profile
- [Workflow](https://docs.chainmemory.ai/#mcp-workflow): Recommended workflows for agentic memory

## REST API

- [Authentication](https://docs.chainmemory.ai/#api-auth): Bearer token, API key generation
- [Memories API](https://docs.chainmemory.ai/#api-memories): GET/POST /v1/memories — store and retrieve
- [Projects API](https://docs.chainmemory.ai/#api-projects): GET /v1/projects — list and manage
- [Injection API](https://docs.chainmemory.ai/#api-inject): POST /v1/inject — context injection
- [Verification API](https://docs.chainmemory.ai/#api-verify): GET /v1/verify-memory — verify on-chain integrity
- [Errors](https://docs.chainmemory.ai/#api-errors): Error codes and rate limits (30 req/min Faucet, 120 req/min Pro)
- [Feature Equivalence](https://docs.chainmemory.ai/#api-equivalence): Extension vs MCP vs API capability matrix

## Network

- [Network Data](https://docs.chainmemory.ai/#network-info): Chain ID 202604, RPC, block explorer, live stats
- [Contracts](https://docs.chainmemory.ai/#network-contracts): Deployed contract addresses and ABIs
- [Connect MetaMask](https://docs.chainmemory.ai/#network-metamask): Add ChainMemory network to MetaMask

## Advanced

- [AI Identity Protocol](https://docs.chainmemory.ai/#identity-protocol): Soulbound Tokens for AI agents, on-chain identity, memory attribution, Trust Score roadmap
- [Multi-Agent Systems](https://docs.chainmemory.ai/#multiagent): Multiple AIs sharing Project State, agent handoff patterns (Claude→Cursor→GPT), conflict resolution across agents
- [MCP Advanced Workflows](https://docs.chainmemory.ai/#mcp-advanced): Claude Desktop architecture sessions, Cursor code-with-memory, Windsurf agentic memory, system prompt patterns

## Security & Reference

- [Auditing Guide](https://docs.chainmemory.ai/#auditing-guide): How to audit memory integrity and chain state
- [What ChainMemory Prevents](https://docs.chainmemory.ai/#prevents): Attack vectors and protection mechanisms
- [Trust Model](https://docs.chainmemory.ai/#trust-model): 8 guarantees table, 3 trust levels (cryptographic/operational/zero-trust)
- [Threat Model](https://docs.chainmemory.ai/#threat-model): 10 attack vectors with severity and detection/prevention
- [Independent Verification](https://docs.chainmemory.ai/#independent-verify): Verify on-chain anchors with Ethers.js/Web3.js without using ChainMemory API

## Optional

- [FAQ](https://docs.chainmemory.ai/#faq): Frequently asked questions
- [Changelog](https://docs.chainmemory.ai/#changelog): Version history and updates

## Public Endpoints

- Landing & Explorer: https://chainmemory.ai
- JSON-RPC: https://rpc.chainmemory.ai
- REST API: https://api.chainmemory.ai
- Faucet: https://faucet.chainmemory.ai
- Network Stats: https://api.chainmemory.ai/v1/stats
- Documentation: https://docs.chainmemory.ai
- Full docs for LLMs: https://docs.chainmemory.ai/llms-full.txt