DOCUMENTACION

La capa de conocimiento soberano para inteligencia artificial.

VISION

ChainMemory no es una herramienta de memoria. Es una capa de conocimiento soberano para sistemas de IA.

Todos los modelos de IA actuales sufren la misma limitacion fundamental: cuando una conversacion termina, todo lo aprendido desaparece. El contexto se pierde. Las decisiones se olvidan. El progreso se reinicia a cero. ChainMemory existe para resolver esto permanentemente.

Las memorias que guardas son el mecanismo. El Project State — una vista estructurada, versionada y consolidada del conocimiento de tu proyecto — es el producto. La blockchain es la prueba. Y la interoperabilidad entre cualquier modelo de IA es la consecuencia.

Que permite ChainMemory

• Memoria portable entre modelos — Tu conocimiento funciona con ChatGPT hoy, Claude manana, y cualquier modelo futuro. Sin vendor lock-in, nunca.
• Continuidad verificable — Cada estado de proyecto se ancla on-chain con una prueba criptografica. Podes demostrar que una decision existia en un momento especifico.
• Pista de auditoria de decisiones — Cada decision se rastrea hasta las conversaciones que la produjeron. Procedencia completa, responsabilidad total.
• Identidad persistente para flujos de IA — Tu asistente de IA no arranca de cero en cada sesion. Hereda el conocimiento acumulado de cada interaccion previa.
• Conocimiento soberano — Vos sos dueno de tus datos. No OpenAI, no Anthropic, no Google. Tus memorias viven en tu cuenta, ancladas a una blockchain publica que podes verificar de forma independiente.

QUE ES CHAINMEMORY

ChainMemory es una plataforma de memoria persistente, portable y verificable para inteligencia artificial. Cada conversacion importante, cada decision, cada contexto de proyecto se guarda como una memoria individual, vinculada a un proyecto, y anclada en una blockchain soberana.

Tu IA olvida cada vez que cerras la pestana. ChainMemory resuelve eso. Funciona con ChatGPT, Claude, Gemini, Copilot, Perplexity y cualquier modelo que soporte MCP o API.

INICIO RAPIDO

Guarda tu primera memoria en menos de 2 minutos.

ARQUITECTURA

ChainMemory tiene una arquitectura de 3 capas:

Capa 1: Captura

La extension Chrome, el servidor MCP o llamadas directas a la API capturan contenido de conversaciones con IA. El contenido se procesa, se le asignan tags, y se vincula a un proyecto.

Capa 2: Almacenamiento y Consolidacion

Cada memoria se guarda en la base de datos episodica con su hash SHA-256. El Motor de Consolidacion analiza las memorias con un LLM local y extrae operaciones estructuradas: decisiones, hitos, riesgos, stack tecnologico, dependencias.

Capa 3: Verificacion On-Chain

El estado consolidado de cada proyecto se ancla periodicamente en la blockchain ChainMemory (Chain ID 202604). El hash del estado se registra en el contrato ProjectStateAnchor, creando una prueba inmutable de que ese estado existio en ese momento.

Pipeline
Conversacion IA
      |
  Extension / MCP / API
      |
  Memoria (hash SHA-256)
      |
  Motor de Consolidacion (phi3:mini via Ollama)
      |
  Project State (decisiones, hitos, riesgos, stack)
      |
  Anchor on-chain (tx hash + block number)
      |
  Verificacion publica (/v1/project/:name/state/anchor)

COMO SE COMPARA CHAINMEMORY

ChainMemory opera en el espacio emergente de infraestructura de memoria para IA. Asi se compara con las soluciones existentes:

CONCEPTOS

El modelo Event-Sourcing

ChainMemory sigue una arquitectura event-sourcing. Entender este patron es clave para entender todo el sistema.

En sistemas tradicionales, guardas el estado actual y lo sobreescribis en cada cambio. En event-sourcing, guardas cada cambio como un evento inmutable, y el estado actual se deriva reproduciendo esos eventos.

En ChainMemory:

• Las memorias son eventos — Cada memoria es un registro inmutable de algo que paso: se tomo una decision, se identifico un riesgo, se eligio una tecnologia, se alcanzo un hito.
• El Project State es una vista materializada — El Motor de Consolidacion procesa todos los eventos-memoria y produce un snapshot estructurado: el Project State. No se almacena directamente — se computa desde el log de eventos.
• La blockchain es la autoridad de tiempo — Cuando un Project State se ancla on-chain, la blockchain certifica que esta vista materializada especifica existia en ese block height exacto.

Patron
Memoria #1 (evento) ─┐
Memoria #2 (evento) ─┤
Memoria #3 (evento) ─┼──→ Motor de Consolidacion ──→ Project State v1 ──→ Anchor (bloque 120000)
Memoria #4 (evento) ─┤
Memoria #5 (evento) ─┘

Memoria #6 (evento) ─┐
Memoria #7 (evento) ─┼──→ Motor de Consolidacion ──→ Project State v2 ──→ Anchor (bloque 123539)
Memoria #8 (evento) ─┘

Esto significa que siempre podes reconstruir cualquier version del Project State reproduciendo las memorias hasta ese punto. El log de eventos es la fuente de verdad. El estado es una capa de conveniencia. El anchor es la prueba.

Que es una memoria

Una memoria es la unidad fundamental de ChainMemory. Es un fragmento de informacion extraido de una conversacion con IA que se considera valioso para el futuro del proyecto.

Cada memoria contiene:

• Contenido — El texto de la conversacion o nota
• Hash — SHA-256 del contenido, inmutable
• Proyecto — A que proyecto pertenece
• Tags — Clasificacion (decision, bug, arquitectura, idea)
• Numero — Secuencial dentro de tu cuenta (#1, #2...)
• Fuente — Desde donde se guardo (extension, MCP, API)
• Timestamp — Momento exacto de creacion

Proyectos

Un proyecto agrupa memorias relacionadas. Cada proyecto tiene su propia linea de tiempo, estado consolidado, y ancla on-chain independiente.

Ejemplos de proyectos: mi-saas, tesis-ml, chainmemory, app-mobile.

Project State

El Project State es el resultado del Motor de Consolidacion: un LLM local (phi3:mini via Ollama) analiza todas las memorias del proyecto y extrae informacion estructurada.

El estado incluye 6 categorias:

• context — Resumen y objetivos del proyecto
• decisions — Decisiones tomadas (con estado: vigente/reemplazada/en evaluacion)
• milestones — Hitos del proyecto (completados y pendientes)
• risks — Riesgos identificados con severidad
• stack — Tecnologias y herramientas
• dependencies — Relaciones externas

El estado es incremental: cada consolidacion parte del estado anterior y aplica solo las operaciones nuevas. La cadena de versiones (v1 → v2 → v3) mantiene integridad via hash chain.

Cadena de evidencia

Cada decision, hito y riesgo en el Project State lleva un campo evidence — un array de referencias a memorias que justifican su existencia.

JSON
{
  "id": "d001",
  "title": "Usar consenso Clique PoA",
  "statement": "Blockchain soberana usa Proof of Authority para anclaje rapido y economico",
  "status": "vigente",
  "evidence": ["#12", "#45", "#67"]
}

Esto crea una cadena de procedencia completa:

• La decision d001 existe porque las memorias #12, #45 y #67 la respaldan
• Cada memoria tiene un hash SHA-256 que prueba que su contenido no cambio
• El Project State que contiene esta decision tiene un state_hash anclado on-chain
• El ancla on-chain tiene un tx_hash y block number que prueban cuando se registro

Desde una sola decision, podes rastrear el camino completo: decision → memorias de respaldo → hashes de contenido → hash del estado → prueba on-chain. Esto es lo que hace que las decisiones de ChainMemory sean auditables e inalterables.

Resolucion de conflictos

Cuando dos memorias contienen informacion contradictoria, el Motor de Consolidacion aplica una estrategia de resolucion deterministica:

Precedencia temporal

La memoria mas reciente tiene prioridad. Si la Memoria #20 dice "Usaremos PostgreSQL" y la Memoria #40 dice "Cambiamos a ClickHouse", el motor marca la decision de PostgreSQL como reemplazada y crea una nueva decision activa para ClickHouse.

Supersesion explicita

El motor detecta patrones de lenguaje que indican cambio de direccion: "en vez de", "reemplazando", "decidimos cambiar", "ya no usamos". Cuando se detecta, la decision anterior se marca explicitamente como reemplazada con referencia a la nueva.

Ciclo de vida de estados

Flujo de estados
vigente ──→ reemplazada    (sustituida por una decision mas nueva)
vigente ──→ en evaluacion  (bajo revision, aun no confirmada)
en evaluacion ──→ vigente  (confirmada tras evaluacion)
en evaluacion ──→ rechazada (descartada)

Acumulacion de evidencia

Cuando multiples memorias refuerzan la misma decision, el motor las agrega al array de evidencia en lugar de crear duplicados. Una decision con evidencia de 5 memorias es mas solida que una con una sola referencia.

Gobernanza del estado

El ciclo de vida del Project State esta gobernado por reglas claras:

Quien puede consolidar?

Solo el dueno del proyecto (la cuenta que lo creo) puede disparar una consolidacion. Esto asegura que la extraccion de conocimiento estructurado siempre este controlada por el dueno de los datos.

Cuando ocurre la consolidacion?

• Manual — Via la herramienta MCP chainmemory_seal, la API, o la vista Project Brain de la extension
• Automatica — Despues de un numero configurable de nuevas memorias (default: cada 10 nuevas memorias)

Se puede revertir?

Cada consolidacion crea una nueva version (v1, v2, v3...). Las versiones anteriores siguen accesibles. No podes borrar una version, pero siempre podes consolidar de nuevo para producir un estado corregido. La cadena de versiones es append-only.

Snapshots

Cada version del Project State es un snapshot. La combinacion de numero de version + state_hash + ancla on-chain crea un checkpoint verificable. Podes obtener cualquier version historica via GET /v1/project/:name/state?version=2.

Hash y verificacion

Cada memoria genera un hash SHA-256 de su contenido. Este hash es la huella digital unica e inmutable de esa memoria. El contenido no se puede modificar sin cambiar el hash.

El state hash es un hash del estado consolidado completo (todas las decisiones, hitos, riesgos, etc.). Este state hash se ancla en la blockchain mediante una transaccion en el contrato ProjectStateAnchor.

Verificacion publica

La verificacion en ChainMemory es publica y sin permisos. Cualquier persona puede:

1. Llamar a GET /v1/project/:name/state/anchor (no requiere API key)
2. Obtener el state_hash y el tx_hash de la transaccion
3. Verificar en el explorer que la transaccion existe
4. Leer el contrato directamente en la blockchain para confirmar que el hash coincide

Esto demuestra que el estado del proyecto existia exactamente asi en el momento del anclaje. No se puede falsificar retroactivamente.

Modelo de privacidad

Una preocupacion comun con sistemas basados en blockchain es la exposicion de datos. ChainMemory aborda esto con una separacion estricta:

Que se guarda donde

El registro on-chain contiene solamente: identificador del proyecto (hasheado), numero de version del estado, hash del estado, y timestamp. Desde una transaccion de blockchain, es imposible reconstruir el contenido de ninguna memoria o los detalles de ninguna decision.

Este diseno significa que ChainMemory puede proveer verificacion criptografica sin comprometer la privacidad. La blockchain prueba que un estado existio, no que contenia.

EXTENSION CHROME

Instalacion

1. Ir a la Chrome Web Store
2. Click en "Agregar a Chrome"
3. El icono de ChainMemory aparece en la barra de extensiones
4. Click en el icono y crea tu cuenta o inicia sesion
5. Selecciona o crea un proyecto

Guardar memorias

Desde cualquier chat de IA soportado, la extension detecta automaticamente la conversacion activa. Tenes dos formas de guardar:

Boton flotante

Un boton dorado aparece en la esquina del chat. Un clic extrae el contenido de la conversacion, lo procesa, y lo guarda como memoria.

Popup de la extension

Click en el icono de ChainMemory en la barra del navegador. Selecciona el proyecto destino, agrega tags opcionales, y confirma.

Cada memoria guardada recibe:

• Hash SHA-256 unico del contenido
• Numero secuencial dentro de tu cuenta (#1, #2, #3...)
• Tags para organizacion (decision, arquitectura, bug, etc.)
• Vinculacion al proyecto activo
• Timestamp del momento de guardado

Inyectar contexto

La funcion mas poderosa: antes de iniciar una nueva conversacion con cualquier IA, ChainMemory puede inyectar automaticamente el contexto relevante de tus memorias previas.

Esto significa que tu nueva conversacion arranca con el conocimiento acumulado de conversaciones anteriores. Tu IA sabe que decidiste, que tecnologias usas, cuales son tus prioridades.

Como funciona

1. Abri un nuevo chat en cualquier plataforma soportada
2. La extension detecta el campo de texto
3. Selecciona las memorias o el estado del proyecto a inyectar
4. El contexto se inserta automaticamente como primer mensaje

Project Brain

Project Brain es la vista consolidada de tu proyecto. El Motor de Consolidacion analiza todas tus memorias y extrae:

• Decisiones — Que se decidio y por que (estado: vigente, reemplazada, en evaluacion)
• Hitos — Logros completados y pendientes con fechas
• Riesgos — Amenazas identificadas con severidad y estado
• Stack tecnologico — Herramientas y tecnologias del proyecto
• Dependencias — Relaciones externas
• Contexto — Resumen ejecutivo del proyecto

Este estado tiene un fingerprint verificable anclado on-chain. Podes demostrar que tu proyecto tenia exactamente ese estado en un momento dado.

Plataformas soportadas

La extension funciona con cualquier chat de IA basado en web:

• ChatGPT (chat.openai.com)
• Claude (claude.ai)
• Gemini (gemini.google.com)
• Perplexity (perplexity.ai)
• Copilot (copilot.microsoft.com)

Si la plataforma tiene un campo de texto y muestra conversaciones, ChainMemory puede capturar el contenido.

SERVIDOR MCP

Configuracion

El servidor MCP permite a Claude Desktop, Cursor y otras herramientas compatibles acceder a ChainMemory como herramienta nativa.

Instalacion

Agrega esta configuracion a tu archivo claude_desktop_config.json:

JSON
{
  "mcpServers": {
    "chainmemory": {
      "command": "npx",
      "args": ["-y", "@chainmemory/mcp"],
      "env": {
        "CHAINMEMORY_API_KEY": "tu-api-key"
      }
    }
  }
}

Herramientas disponibles

Una vez configurado, tu IA tiene acceso a estas herramientas:

Flujo de trabajo

API REST

Autenticacion

Todas las llamadas a la API requieren autenticacion mediante API Key en el header:

HTTP
Authorization: Bearer tu-api-key

Base URL: https://api.chainmemory.ai/v1

Memorias

bash
curl -X POST https://api.chainmemory.ai/v1/memories \
  -H "Authorization: Bearer tu-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Decidimos usar PostgreSQL en vez de MongoDB",
    "project": "mi-proyecto",
    "tags": ["decision", "arquitectura"],
    "source": "manual"
  }'

javascript
const res = await fetch('https://api.chainmemory.ai/v1/memories', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer tu-api-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    content: 'Decidimos usar PostgreSQL en vez de MongoDB',
    project: 'mi-proyecto',
    tags: ['decision', 'arquitectura'],
    source: 'api'
  })
});
const memory = await res.json();
// { id: 207, hash: '0x4f2a...', memory_number: 42 }

python
import requests

res = requests.post(
    'https://api.chainmemory.ai/v1/memories',
    headers={'Authorization': 'Bearer tu-api-key'},
    json={
        'content': 'Decidimos usar PostgreSQL en vez de MongoDB',
        'project': 'mi-proyecto',
        'tags': ['decision', 'arquitectura'],
        'source': 'api'
    }
)
memory = res.json()
# {'id': 207, 'hash': '0x4f2a...', 'memory_number': 42}

Parametros

Proyectos

Respuesta
{
  "project": "chainmemory",
  "version": 3,
  "state": {
    "context": { "summary": "...", "goals": [...] },
    "decisions": [
      {
        "id": "d001",
        "title": "Usar Clique PoA",
        "statement": "Consenso PoA para blockchain soberana",
        "status": "vigente",
        "evidence": ["#12", "#45"]
      }
    ],
    "milestones": [...],
    "risks": [...],
    "stack": [...]
  },
  "state_hash": "a7b3c9f2...",
  "anchor": {
    "status": "anchored",
    "tx_hash": "0xce55a800...",
    "block_number": 123539
  }
}

Inyeccion

Verificacion

Respuesta
{
  "project": "chainmemory",
  "projectId": "0x77f7d980...",
  "version": 3,
  "state_hash": "a7b3c9f2...",
  "anchor": {
    "status": "anchored",
    "tx_hash": "0xce55a800a2a4e30b...",
    "block_number": 123539,
    "contract": "0xa7A8BA51950255b3e223a6745597C67009Fe7875"
  }
}

Codigos de error

RED

Datos de la red

Contratos desplegados

El Token AIC es la moneda nativa de la red (no es un contrato ERC-20). Se usa para pagar el gas de transacciones al anclar estados y registrar memorias.

Conectar MetaMask

Para agregar ChainMemory a MetaMask:

1. Ir a chainmemory.ai/network
2. Click en "Add ChainMemory to MetaMask"
3. Confirmar en MetaMask

O agregala manualmente con los datos de la tabla anterior.

Faucet

El faucet entrega AIC gratis para que puedas interactuar con la blockchain:

• URL: faucet.chainmemory.ai
• Cantidad: 1 AIC por claim
• Cooldown: 72 horas entre claims
• Requisito: Resolver un challenge simple (anti-bot)

GUIA DE AUDITORIA

Una de las capacidades mas poderosas de ChainMemory es permitir auditorias verificables de decisiones de proyecto asistidas por IA — sin exponer el contenido privado de las conversaciones.

Dos niveles de auditoria

Nivel 1 — Auditoria externa (sin acceso del dueno)

Cualquiera puede verificar que un estado de proyecto fue anclado en un momento especifico, sin ver que contiene. Es como ver un sello notarial cerrado — sabes que existe, no sabes que dice adentro.

Lo que un auditor externo ve (publico, on-chain):

Nivel 1 — Endpoint publico
GET /v1/project/nova-logistics/state/anchor

Respuesta:
{
  "project": "nova-logistics",
  "projectId": "0x77f7d980...",     // hasheado — nombre original no se revela
  "version": 5,
  "state_hash": "a7b3c9f2e1...",   // prueba que el estado existio, no revela contenido
  "anchor": {
    "status": "anchored",
    "tx_hash": "0xce55a800...",
    "block_number": 125000,
    "contract": "0xa7A8BA51...e7875"
  }
}

Nivel 2 — Auditoria con disclosure selectivo (el dueno comparte datos)

El dueno del proyecto elige que compartir con el auditor. El auditor verifica los datos compartidos contra la prueba on-chain. Esta es la auditoria poderosa: demostras que los datos son autenticos sin intermediarios.

El dueno controla exactamente que se revela:

Proceso de auditoria paso a paso

Ejemplo: NovaTech, una startup construyendo un SaaS de logistica. Despues de 4 meses usando ChatGPT y Claude alternadamente, el CTO necesita demostrar trazabilidad del proyecto a inversores.

bash
curl -H "Authorization: Bearer cto-api-key" \
  https://api.chainmemory.ai/v1/project/nova-logistics/state
    

bash
cat state.json | sha256sum
# a7b3c9f2e1d4...
    

bash
curl https://api.chainmemory.ai/v1/project/nova-logistics/state/anchor
# Retorna: state_hash: "a7b3c9f2e1d4..."
    

Garantias de privacidad durante la auditoria

La garantia critica: el dueno siempre controla el disclosure.

• Los inversores ven decisiones e hitos — no las conversaciones crudas de IA que las produjeron
• La blockchain prueba autenticidad sin revelar contenido
• El texto de memorias (contenido real de conversaciones) solo es visible si el dueno lo exporta explicitamente
• El registro on-chain contiene solo hashes — aunque la blockchain sea publica, el conocimiento de tu proyecto permanece privado
• Ningun tercero, incluyendo ChainMemory mismo, puede forzar el disclosure del contenido de memorias

QUE PREVIENE CHAINMEMORY

Entender contra que protege ChainMemory es tan importante como entender que hace.

Perdida de contexto

Cada conversacion de IA hoy es efimera. Cerras la pestana y todo lo discutido — decisiones, elecciones de arquitectura, hallazgos de investigacion — desaparece. ChainMemory captura esto como memorias permanentes y recuperables. Tu proxima sesion arranca donde termino la anterior.

Vendor lock-in

Si el conocimiento de tu proyecto existe solo dentro del historial de conversaciones de ChatGPT, estas atrapado. ChainMemory almacena conocimiento independientemente de cualquier proveedor de IA. Cambia de ChatGPT a Claude a Gemini sin perder una sola decision o contexto.

Manipulacion retroactiva

Sin prueba criptografica, cualquiera podria afirmar "decidimos X" cuando la decision real fue Y. El anclaje on-chain de ChainMemory crea un registro a prueba de manipulacion. El state hash en el bloque 123539 prueba exactamente cual era el estado del proyecto en ese momento. No se puede alterar despues del hecho.

Fragmentacion de conocimiento

Equipos que usan IA terminan con conocimiento critico disperso en docenas de conversaciones desconectadas, en diferentes herramientas, con diferentes modelos. ChainMemory consolida todo en un unico Project State estructurado — sin importar que IA o herramienta produjo la conversacion original.

Dependencia de una sola IA

Cuando un proveedor de IA se cae, cambia su API, o depreca una funcionalidad, proyectos que dependen exclusivamente de ese proveedor pierden continuidad. La arquitectura cross-model de ChainMemory asegura que tu conocimiento acumulado es accesible desde cualquier sistema de IA compatible.

Deriva invisible de decisiones

En proyectos de largo plazo, las decisiones evolucionan durante meses. Sin un sistema que rastree que cambio, cuando, y por que, los equipos pierden el hilo de su propio razonamiento. El ciclo de vida de decisiones del Motor de Consolidacion (vigente → reemplazada) con cadenas de evidencia hace cada evolucion rastreable.

FAQ

Generales

ChainMemory es gratis?

Si. El plan Faucet es gratuito e incluye almacenamiento de memorias, inyeccion de contexto, y Project Brain. El faucet te da AIC gratis para interactuar con la blockchain.

Mis memorias son privadas?

Si. Tus memorias solo son accesibles con tu API key. Lo unico publico son los hashes on-chain (que no revelan contenido) y el endpoint de verificacion (que solo expone metadata, nunca contenido).

Que pasa si la IA genero contenido incorrecto en una memoria?

Las memorias capturan lo que se dijo en la conversacion. Si la IA genero informacion incorrecta y vos la guardaste, esa memoria reflejara el error. Podes archivar memorias incorrectas y el Motor de Consolidacion priorizara las mas recientes.

Puedo usar ChainMemory con modelos locales?

Si, via API REST. Cualquier aplicacion que haga llamadas HTTP puede guardar y recuperar memorias. Tambien podes configurar el servidor MCP con modelos locales via Ollama.

Que es el Motor de Consolidacion?

Es un pipeline que analiza tus memorias usando un LLM local (phi3:mini) y extrae informacion estructurada: decisiones, hitos, riesgos, stack. El resultado es el Project State, cuyo hash se ancla on-chain.

Que pasa si mi IA dice cosas contradictorias entre sesiones?

El Motor de Consolidacion maneja contradicciones via precedencia temporal: las memorias mas nuevas reemplazan a las mas viejas. Las decisiones reemplazadas permanecen en el estado con status "reemplazada", asi siempre tenes el historial completo. Ver Resolucion de conflictos para mas detalles.

Puedo exportar mis datos?

Si. Todas tus memorias y estados de proyecto son accesibles via la API REST. Podes obtenerlos en formato JSON y procesarlos como necesites.

Limites y cuotas

Changelog

v3.0.9 (Junio 2026)

• Fix: Project Brain muestra decisiones y riesgos correctamente (schema Fase 2)
• Fix: Numeracion de memorias muestra numero secuencial del usuario

v3.0.0 (Mayo 2026)

• Project Brain: visualizacion del estado consolidado
• Motor de Consolidacion: pipeline completo con phi3:mini
• Anclaje on-chain de Project State
• API de verificacion publica

v2.0.0 (Abril 2026)

• Servidor MCP para Claude Desktop y Cursor
• Inyeccion de contexto automatica
• Soporte para 5 plataformas de IA