FAQ

General

Is ChainMemory free?

Yes. The Faucet plan is free and includes memory storage, context injection, and Project Brain (the Project State viewer). The faucet gives you free AIC to interact with the blockchain.

Are my memories private?

Yes. Your memories are only accessible with your API key. The only public data are the on-chain hashes (which reveal nothing about content) and the verification endpoints, which expose hashes and metadata. The encrypted content is stored on-chain and readable there, but never the plaintext.

What if the AI generated incorrect content in a memory?

Memories capture what was said in the conversation. If the AI generated incorrect information and you saved it, that memory will reflect the error. You can archive it, or quarantine it with POST /v1/memories/:id/trust so it is excluded from context and injection. The Project State does not change on its own: if an item was built on that memory, correct it with a new operation.

Can I use ChainMemory with local models?

Yes, via the REST API. Any application that makes HTTP calls can save and retrieve memories. You can also configure the MCP server with local or self-hosted models.

Who builds the Project State?

Your AI client. Through update_project_state (MCP) or POST /v1/project/:name/state/ops it proposes operations — add a decision, close a risk — citing the memories that support them. The server validates them, applies them with a deterministic builder and anchors the resulting hash on-chain. No server-side model reads your memories.

What happens if my AI says contradictory things across sessions?

Nothing resolves them automatically. Both memories stay, and the client that consolidates decides: it adds the newer decision and marks the older one with supersede_decision. Superseded decisions remain in the state with a "superseded" status, so you always have the full history. See Conflict Resolution for details.

Can I export my data?

Yes. All your memories and project states are accessible via the REST API. You can fetch them in JSON format and process them however you need.

Plans, Limits & Quotas

Memories are never deleted: past your plan's retention window they are archived, and their on-chain hash exists forever. Upgrading restores full access to your history. Gift AIC accumulates monthly, never expires, and unlocks according to the protocol calendar.