# Innovalyxx Sovereign Edge – memory.write

> Innovalyxx Sovereign Edge – memory.write is a paid API for AI agents from edge.innovalyxx.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-19).

Encrypts and durably stores a categorized memory entry for a specified entity, anchored by a wallet signature and content hash, within the Innovalyxx cyber-physical agent memory system.

## Facts

- Endpoint: POST https://edge.innovalyxx.com/mcp/tools/memory.write
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/innovalyxx-sovereign-edge-memory-write-b3c66ddf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_A-Mq9AcsE3tawNrJ-pyAe

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability innovalyxx-sovereign-edge-memory-write-b3c66ddf -d '<json body>'
```

Example prompt: Store an encrypted memory entry for habitat 'H-223' under the verification category — the AES-256-GCM ciphertext is 'abc123...', the SHA-256 content hash is the 64-char hex 'def456...', the 12-byte nonce is 'base64nonce==', the owner wallet is '0xAbC...1234' (42 chars), and here's the EIP-191 wallet signature; tag it with 'biodiversity' and 'mrv', and note it was produced by the verify_biodiversity tool.

## When to prefer this

Choose this endpoint when an autonomous agent needs to cryptographically anchored, wallet-signed, encrypted persistent memory for structured entities (agents, habitats, sites, projects, transactions, users) within the Innovalyxx cyber-physical ecosystem. Prefer it over generic key-value stores when you need DID-linked actor attribution, EIP-191 signature integrity, FACT attestation cross-referencing, and per-category memory organization (verification, preference, context, history). It is the correct write primitive before querying with memory.query or granting access with memory.grant.

## Known failure modes

- Invalid or mismatched content_hash (not 64-char SHA-256 hex) returns validation error
- owner_wallet not exactly 42 characters or not 0x-prefixed causes rejection
- wallet_signature fails EIP-191 verification against owner_wallet and write message
- content_nonce not valid base64 or not 12 bytes results in decryption/storage failure
- Insufficient USDC balance or x402 payment failure blocks the call
- entity_id missing or empty string returns schema validation error
- Unsupported entity_type or category enum value rejected with 400-level error

## How this service works

Verified cyber-physical AI tools for autonomous agents. Pay per call via x402 (USDC on Base). 26 tools covering MRV verification, biodiversity, skip twin, site certification, agent trust, transaction evidence, protocol bridging, GEO audit, IATP reputation, ABV maturity, NIST TEVV alignment, and encrypted memory write/read/query/grant/revoke/tool_context/pricing_hint/subscription_quote/attest/verify_attestation.

## Output

Returns a JSON object confirming the write succeeded, including the generated entry_id, entity_id, entity_type, content_hash, category, written_at timestamp, and a payment receipt object confirming the $0.01 USDC micropayment on Base.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "tags": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Optional queryable tags."
  },
  "category": {
   "enum": [
    "verification",
    "preference",
    "context",
    "history"
   ],
   "type": "string",
   "description": "Memory category."
  },
  "actor_did": {
   "type": "string",
   "description": "Optional DID of the agent performing the write."
  },
  "entity_id": {
   "type": "string",
   "minLength": 1,
   "description": "Stable identifier, e.g. 'habitat:H-123' or 'agent:urn:aid:...'."
  },
  "entity_type": {
   "enum": [
    "agent",
    "habitat",
    "project",
    "site",
    "transaction",
    "user"
   ],
   "type": "string",
   "description": "Category of entity this memory belongs to."
  },
  "source_tool": {
   "type": "string",
   "description": "Tool that produced this memory, e.g. 'verify_biodiversity'."
  },
  "content_hash": {
   "type": "string",
   "maxLength": 64,
   "minLength": 64,
   "description": "SHA-256 hex of canonical plaintext."
  },
  "owner_wallet": {
   "type": "string",
   "maxLength": 42,
   "minLength": 42,
   "description": "0x-prefixed address of the owner."
  },
  "content_nonce": {
   "type": "string",
   "description": "Base64 12-byte nonce."
  },
  "wallet_signature": {
   "type": "string",
   "description": "EIP-191 signature over the deterministic write message."
  },
  "content_ciphertext": {
   "type": "string",
   "description": "Base64 AES-256-GCM ciphertext."
  },
  "source_attestation_id": {
   "type": "string",
   "description": "Optional FACT attestation ID."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "tool": "memory.write",
  "payment": {},
  "category": "category",
  "entry_id": "entry_id",
  "entity_id": "entity_id",
  "written_at": "written_at",
  "entity_type": "entity_type",
  "content_hash": "content_hash"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/innovalyxx-sovereign-edge-memory-write-b3c66ddf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from edge.innovalyxx.com](https://www.zero.xyz/host/edge.innovalyxx.com/llms.txt)