# Innovalyxx Sovereign Edge – memory.query

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

Query encrypted agent memory entries by owner wallet, entity, category, tags, and time range with EIP-191 signature authentication

## Facts

- Endpoint: POST https://edge.innovalyxx.com/mcp/tools/memory.query
- 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-query-4746aab9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Bb6tZ8r3V3Fjj07DidhX0

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-query-4746aab9 -d '<json body>'
```

Example prompt: Search my encrypted agent memory at Innovalyxx Sovereign Edge for the last 50 'verification' category entries belonging to wallet 0xABCDEF1234567890ABCDEF1234567890ABCDEF12, filtered to anything tagged 'carbon-credit', created after 2024-01-01 — sign the request with my EIP-191 wallet signature.

## When to prefer this

Use this endpoint when an autonomous agent needs to retrieve its own previously stored encrypted memory entries from the Innovalyxx Sovereign Edge platform, especially when filtering by entity type, category, tags, or time range. It is ideal for agents that persist verification, context, or preference state across sessions and need to resume or audit that state. Requires EIP-191 wallet signature for authentication, making it appropriate for wallet-sovereign agent architectures on Base/USDC payment rails.

## Known failure modes

- Invalid or mismatched wallet_signature causes authentication rejection
- owner_wallet not exactly 42 characters returns validation error
- entity_id_prefix shorter than 3 characters rejected
- offset exceeding 10000 returns error
- limit outside 1–200 range rejected
- Invalid ISO 8601 date strings for since/until cause parse errors
- Payment failure via x402 (insufficient USDC balance) blocks the call
- No matching entries returns empty entries array with count 0

## 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, paginated memory entries array, count of returned entries, total matching entries, active filters, payment metadata, the timestamp of the query, and the access role (e.g. 'owner').

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 50,
   "maximum": 200,
   "minimum": 1,
   "description": "Page size (1–200, default 50)."
  },
  "since": {
   "type": "string",
   "description": "ISO 8601 lower bound on created_at (inclusive)."
  },
  "until": {
   "type": "string",
   "description": "ISO 8601 upper bound on created_at (inclusive)."
  },
  "offset": {
   "type": "integer",
   "default": 0,
   "maximum": 10000,
   "minimum": 0,
   "description": "Page offset (0–10000, default 0)."
  },
  "category": {
   "enum": [
    "verification",
    "preference",
    "context",
    "history"
   ],
   "type": "string",
   "description": "Optional memory category filter."
  },
  "tags_all": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Return rows whose tags contain every item in this list."
  },
  "tags_any": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Return rows whose tags overlap this list."
  },
  "entity_id": {
   "type": "string",
   "description": "Optional exact entity identifier."
  },
  "entity_type": {
   "enum": [
    "agent",
    "habitat",
    "project",
    "site",
    "transaction",
    "user"
   ],
   "type": "string",
   "description": "Optional entity type filter."
  },
  "owner_wallet": {
   "type": "string",
   "maxLength": 42,
   "minLength": 42,
   "description": "0x-prefixed owner address. Signature must recover to this wallet."
  },
  "entity_id_prefix": {
   "type": "string",
   "minLength": 3,
   "description": "Optional entity_id prefix (minimum 3 characters)."
  },
  "wallet_signature": {
   "type": "string",
   "description": "EIP-191 signature over the exact canonical filter set."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "tool": "memory.query",
  "count": 1,
  "limit": 1,
  "total": 1,
  "offset": 1,
  "entries": [],
  "filters": {},
  "payment": {},
  "queried_at": "queried_at",
  "accessed_as": "owner"
 }
}
```

## More

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