# Innovalyxx Sovereign Edge – memory.grant

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

Grants a specified wallet address cryptographically auditable read access to selected memory categories of an entity, with optional expiry and DID binding.

## Facts

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

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-grant-efaeff2d -d '<json body>'
```

Example prompt: Grant wallet 0xAbCdEf1234567890AbCdEf1234567890AbCdEf12 read access to the 'verification' and 'context' memory categories for project entity proj_42, valid until 2026-01-01, signed by my owner wallet 0x1234567890AbCdEf1234567890AbCdEf12345678 with my EIP-191 signature.

## When to prefer this

Use this endpoint when an autonomous agent needs to formally delegate, with cryptographic audit trail, read access to specific memory categories of an entity to another wallet or agent. It is the right choice when consent provenance, expiry control, and DID binding are required — for example in multi-agent workflows, habitat monitoring, MRV verification chains, or cross-organization data sharing where a consent_hash and grant_id must be recorded on-chain or in audit logs.

## Known failure modes

- Invalid or mismatched EIP-191 signature returns an authorization error
- Grantor wallet does not own the entity's memory, returning a forbidden error
- Grantee or grantor wallet address is not exactly 42 characters (0x + 40 hex) returns a validation error
- Empty or invalid categories array returns a schema validation error
- expires_at more than 730 days in the future is rejected
- Payment not satisfied via x402/USDC returns a 402 Payment Required response
- Unknown entity_type enum value returns a validation 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 grant was created, including a unique grant_id, a consent_hash for audit purposes, the granted_at and expires_at timestamps, the grantee and grantor wallet addresses, and the list of authorized memory categories.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "entity_id": {
   "type": "string",
   "minLength": 1,
   "description": "Entity whose memory the grant covers."
  },
  "categories": {
   "type": "array",
   "items": {
    "enum": [
     "verification",
     "preference",
     "context",
     "history"
    ],
    "type": "string"
   },
   "minItems": 1,
   "description": "Non-empty list of categories the grantee may read."
  },
  "expires_at": {
   "type": "string",
   "description": "Optional ISO 8601 expiry (max 730 days from now)."
  },
  "entity_type": {
   "enum": [
    "agent",
    "habitat",
    "project",
    "site",
    "transaction",
    "user"
   ],
   "type": "string",
   "description": "Entity type of the granted memory."
  },
  "grantee_did": {
   "type": "string",
   "description": "Optional DID stored for audit alongside the grantee wallet."
  },
  "grantee_wallet": {
   "type": "string",
   "maxLength": 42,
   "minLength": 42,
   "description": "0x-prefixed wallet that will be allowed to read."
  },
  "grantor_wallet": {
   "type": "string",
   "maxLength": 42,
   "minLength": 42,
   "description": "0x-prefixed owner wallet issuing the grant."
  },
  "wallet_signature": {
   "type": "string",
   "description": "EIP-191 signature of the grantor over the grant message."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "tool": "memory.grant",
  "payment": {},
  "grant_id": "grant_id",
  "entity_id": "entity_id",
  "categories": [],
  "expires_at": "expires_at",
  "granted_at": "granted_at",
  "consent_hash": "consent_hash",
  "grantee_wallet": "grantee_wallet",
  "grantor_wallet": "grantor_wallet"
 }
}
```

## More

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