# Innovalyxx Sovereign Edge – memory.read

> Innovalyxx Sovereign Edge – memory.read 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-17).

Reads encrypted memory entries for a given entity, returning stored verification, preference, context, or history records to authorized callers via wallet-signed authentication.

## Facts

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

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-read-b627b7bf -d '<json body>'
```

Example prompt: Fetch up to 50 encrypted memory entries in the 'verification' category for entity 'site-001-AU' — my signer wallet is 0xABCDEF1234567890ABCDEF1234567890ABCDEF12 and here's my EIP-191 signature over the read message.

## When to prefer this

Use this endpoint when an autonomous agent or authorized grantee needs to retrieve encrypted, categorized memory entries for a specific entity within the Innovalyxx Sovereign Edge trust infrastructure. Prefer this over generic key-value stores when wallet-based ownership and EIP-191 signed access control are required, or when the memory is linked to MRV verification, biodiversity, site certification, or agent trust workflows on Base.

## Known failure modes

- Missing or invalid wallet_signature causes authentication failure
- entity_id not found returns empty entries array or 404-equivalent
- owner_wallet mismatch with signer_wallet on owner path causes authorization rejection
- limit out of range (below 1 or above 500) causes validation error
- Insufficient USDC balance or x402 payment failure blocks the call
- Caller not granted read access to the entity returns permission denied
- Malformed 0x address (not exactly 42 chars) fails schema validation

## 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 with ok status, the tool name, count of returned entries, a list of memory entry objects, the category filtered on, the entity_id queried, the role the caller accessed as (owner or grantee), a read timestamp, and a payment receipt object confirming the $0.01 USDC per-call charge.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "maximum": 500,
   "minimum": 1,
   "description": "Maximum entries to return (1–500, default 100)."
  },
  "category": {
   "enum": [
    "verification",
    "preference",
    "context",
    "history"
   ],
   "type": "string",
   "description": "Optional category filter. Omit to return every category the caller may read."
  },
  "actor_did": {
   "type": "string",
   "description": "Optional DID of the caller."
  },
  "entity_id": {
   "type": "string",
   "minLength": 1,
   "description": "Stable identifier of the entity whose encrypted memory should be returned."
  },
  "owner_wallet": {
   "type": "string",
   "maxLength": 42,
   "minLength": 42,
   "description": "Optional owner address. Required (and must match signer) for owner self-read."
  },
  "signer_wallet": {
   "type": "string",
   "maxLength": 42,
   "minLength": 42,
   "description": "0x-prefixed address of the caller. Owner path when it matches owner_wallet."
  },
  "wallet_signature": {
   "type": "string",
   "description": "EIP-191 signature over the deterministic read message (owner or grantee role)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "tool": "memory.read",
  "count": 1,
  "entries": [],
  "payment": {},
  "read_at": "read_at",
  "category": "category",
  "entity_id": "entity_id",
  "accessed_as": "accessed_as"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/innovalyxx-sovereign-edge-memory-read-b627b7bf/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)