Innovalyxx Sovereign Edge

Verify a carbon project's MRV claim via Sentinel-2 and MWCM-Oh. Returns signed Ed25519 attestation with Lean 4 proof hash. Compliance: EU AI Act Art. 14, ISO 14064-3. Not a carbon credit certificate. Cost £150 per call.

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "minLength": 1,
      "description": "Unique identifier of the carbon project (e.g., 'CV-SOUTHAMPTON-01')."
    },
    "node_id": {
      "type": "string",
      "minLength": 1,
      "description": "Registry node ID for the asset (e.g., 'TN-KEN-0001')."
    },
    "claimed_ndvi_min": {
      "type": "number",
      "minimum": -1,
      "maximum": 1,
      "description": "Minimum NDVI the agent claims the project has achieved. Used for Lean 4 verification."
    }
  },
  "required": [
    "project_id",
    "node_id",
    "claimed_ndvi_min"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the tool completed without a validation error."
    },
    "tool": {
      "type": "string",
      "description": "Tool name that produced this payload."
    },
    "payment": {
      "type": "object",
      "description": "Settlement receipt after x402 or sandbox payment."
    },
    "report": {
      "type": "object",
      "description": "Project telemetry, claimed NDVI, and seal status."
    },
    "runtime_attestation": {
      "type": "object",
      "description": "Ed25519-signed FACT envelope."
    },
    "lean4_proof_hash": {
      "type": "string",
      "description": "Hash of the Lean 4 compilation used for NDVI bounds."
    },
    "trust_signal": {
      "type": "object",
      "description": "FACT grade and trust signal."
    }
  },
  "description": "FACT-sealed Carbon Vault MRV report after payment."
}

Verify a carbon project's basic NDVI via Sentinel-2. Returns signed Ed25519 NDVI attestation. No Lean 4 proof. Not a carbon credit. Compliance: EU AI Act Art. 14, ISO 14064-3 lite. Cost £5 per call.

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "minLength": 1,
      "description": "Unique identifier of the carbon project (e.g., 'CV-SOUTHAMPTON-01')."
    },
    "claimed_ndvi_min": {
      "type": "number",
      "minimum": -1,
      "maximum": 1,
      "description": "Minimum NDVI the agent claims the project has achieved."
    }
  },
  "required": [
    "project_id",
    "claimed_ndvi_min"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the tool completed without a validation error."
    },
    "tool": {
      "type": "string",
      "description": "Tool name that produced this payload."
    },
    "payment": {
      "type": "object",
      "description": "Settlement receipt after x402 or sandbox payment."
    },
    "project_id": {
      "type": "string",
      "description": "Carbon project identifier."
    },
    "ndvi_estimated": {
      "type": "number",
      "description": "Estimated NDVI from Sentinel-2 / MWCM-Oh optical indices."
    },
    "ndvi_claimed_min": {
      "type": "number",
      "description": "Claimed minimum NDVI echoed from the request."
    },
    "verification_passed": {
      "type": "boolean",
      "description": "True when estimated NDVI meets the claimed minimum."
    },
    "confidence": {
      "type": "number",
      "description": "Confidence in the NDVI estimate (0–1)."
    },
    "attestation": {
      "type": "object",
      "description": "Ed25519-signed innovalyxx.mrv.lite.v1 envelope."
    },
    "schema": {
      "type": "string",
      "description": "Always innovalyxx.mrv.lite.v1."
    },
    "disclaimer": {
      "type": "string",
      "description": "Basic NDVI only. Not a full MRV report."
    }
  },
  "description": "Basic NDVI verification with a signed Ed25519 attestation. No Lean 4 proof."
}

Verify a biodiversity claim for a geographic habitat. Returns signed Ed25519 attestation with Lean 4 NDVI proof vs claimed_score_min. Compliance: EU AI Act Art. 14, TNFD. Not a tradable credit. Cost £150 per call.

{
  "type": "object",
  "properties": {
    "habitat_id": {
      "type": "string",
      "minLength": 1,
      "description": "Habitat or site identifier for the biodiversity audit."
    },
    "species_list": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "description": "Observed or claimed species names used in the Genomic Audit pipeline."
    },
    "claimed_score_min": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Minimum biodiversity score (0–100) the agent claims. Compared against the computed score."
    }
  },
  "required": [
    "habitat_id",
    "species_list",
    "claimed_score_min"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the tool completed without a validation error."
    },
    "tool": {
      "type": "string",
      "description": "Tool name that produced this payload."
    },
    "payment": {
      "type": "object",
      "description": "Settlement receipt after x402 or sandbox payment."
    },
    "verification": {
      "type": "object",
      "description": "Score, claim comparison, and provenance hash."
    },
    "runtime_attestation": {
      "type": "object",
      "description": "Ed25519-signed FACT envelope."
    },
    "lean4_proof_hash": {
      "type": "string",
      "description": "Hash of the Lean 4 proof."
    }
  },
  "description": "Biodiversity verification with Lean 4 NDVI checks."
}

Verify a circular-economy Skip Passport against the waste-diversion twin. Returns JSON passport with Lean 4 proof hash. Compliance: EU AI Act Art. 14. Cost £10 per call.

{
  "type": "object",
  "properties": {
    "skip_id": {
      "type": "string",
      "minLength": 1,
      "description": "Circular-economy skip / waste-diversion twin identifier."
    },
    "manifest_hash": {
      "type": "string",
      "minLength": 64,
      "maxLength": 66,
      "description": "SHA-256 hex (optional 0x prefix) of the skip manifest."
    }
  },
  "required": [
    "skip_id",
    "manifest_hash"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the tool completed without a validation error."
    },
    "tool": {
      "type": "string",
      "description": "Tool name that produced this payload."
    },
    "payment": {
      "type": "object",
      "description": "Settlement receipt after x402 or sandbox payment."
    },
    "passport": {
      "type": "object",
      "description": "Manifest match and waste-diversion disclaimer."
    },
    "ledger": {
      "type": "object",
      "description": "skip_transactions write status."
    },
    "lean4_proof_hash": {
      "type": "string",
      "description": "Hash of the Lean 4 compilation."
    }
  },
  "description": "Verified Skip Passport result."
}

Verify city planning constraints for a development site. Returns signed Ed25519 attestation and 30-year compliance trail. Compliance: EU AI Act Art. 14, ISO 14064-3. Cost £3,000–£5,000 per call.

{
  "type": "object",
  "properties": {
    "city_id": {
      "type": "string",
      "enum": [
        "birmingham",
        "bristol",
        "edinburgh",
        "glasgow",
        "leeds",
        "leicester",
        "liverpool",
        "london",
        "manchester",
        "newcastle",
        "sheffield",
        "southampton"
      ],
      "description": "City catalog key for planning constraints (e.g., 'southampton')."
    },
    "site_name": {
      "type": "string",
      "minLength": 1,
      "description": "Human-readable development site name."
    },
    "development_ref": {
      "type": "string",
      "minLength": 1,
      "description": "Planning / development reference recorded on the 30-year compliance trail."
    }
  },
  "required": [
    "city_id",
    "site_name",
    "development_ref"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the tool completed without a validation error."
    },
    "tool": {
      "type": "string",
      "description": "Tool name that produced this payload."
    },
    "payment": {
      "type": "object",
      "description": "Settlement receipt after x402 or sandbox payment."
    },
    "certification": {
      "type": "object",
      "description": "City, site, and compliance trail."
    },
    "ledger": {
      "type": "object",
      "description": "monopoly_site_certifications write status."
    },
    "runtime_attestation": {
      "type": "object",
      "description": "Ed25519-signed FACT envelope."
    }
  },
  "description": "City site-certification and 30-year compliance trail."
}

Verify an AI agent's identity (KYA-OS DID) and behavioral trust score. Returns a signed Ed25519 TrustVerification envelope with fail-closed attestation. Compliance: EU AI Act Art. 14, KYA-OS. Cost $0.01 per call.

{
  "type": "object",
  "properties": {
    "agent_did": {
      "type": "string",
      "minLength": 1,
      "description": "Agent DID to verify (KYA-OS URN, e.g., 'urn:aid:innovalyxx:sovereign-edge')."
    },
    "context": {
      "type": "string",
      "description": "Optional verification context (default 'mrv_verification')."
    }
  },
  "required": [
    "agent_did"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the tool completed without a validation error."
    },
    "tool": {
      "type": "string",
      "description": "Tool name that produced this payload."
    },
    "payment": {
      "type": "object",
      "description": "Settlement receipt after x402 or sandbox payment."
    },
    "verified": {
      "type": "boolean",
      "description": "Whether the agent passed the trust threshold."
    },
    "trust_score": {
      "type": "number",
      "description": "Heuristic trust score in [0, 1]."
    },
    "tier": {
      "type": "string",
      "description": "Trust tier label."
    },
    "agent_did": {
      "type": "string",
      "description": "Canonical DID that was scored."
    }
  },
  "description": "Signed TrustVerification envelope for a DID."
}

Verify a completed M2M transaction evidence pack, Lean 4 hash, and settlement. Returns signed JSON with provenance. Compliance: EU AI Act Art. 14, KYA-OS. Cost $0.05 per call.

{
  "type": "object",
  "properties": {
    "transaction_id": {
      "type": "string",
      "minLength": 1,
      "description": "Settled M2M transaction identifier to verify."
    },
    "agent_did": {
      "type": "string",
      "minLength": 1,
      "description": "DID of the agent that initiated or received the settlement."
    },
    "amount_usdc": {
      "type": "number",
      "minimum": 0,
      "description": "Optional claimed settlement amount in USDC for evidence matching."
    }
  },
  "required": [
    "transaction_id",
    "agent_did"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the tool completed without a validation error."
    },
    "tool": {
      "type": "string",
      "description": "Tool name that produced this payload."
    },
    "payment": {
      "type": "object",
      "description": "Settlement receipt after x402 or sandbox payment."
    },
    "verified": {
      "type": "boolean",
      "description": "Whether the evidence pack verified."
    },
    "transaction_id": {
      "type": "string",
      "description": "Transaction that was checked."
    },
    "trust_score": {
      "type": "number",
      "description": "Associated agent trust score."
    }
  },
  "description": "Transaction evidence verification result."
}

Issue a signed trust attestation for an agent DID and optional capabilities. Returns Ed25519 attestation envelope. Compliance: EU AI Act Art. 14, KYA-OS, IETF AID. Cost $0.50 per call.

{
  "type": "object",
  "properties": {
    "agent_did": {
      "type": "string",
      "minLength": 1,
      "description": "Agent DID that will receive the signed trust attestation."
    },
    "capabilities": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional capability strings recorded on the attestation."
    }
  },
  "required": [
    "agent_did"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the tool completed without a validation error."
    },
    "tool": {
      "type": "string",
      "description": "Tool name that produced this payload."
    },
    "payment": {
      "type": "object",
      "description": "Settlement receipt after x402 or sandbox payment."
    },
    "attestation_id": {
      "type": "string",
      "description": "Identifier of the issued attestation."
    },
    "agent_did": {
      "type": "string",
      "description": "DID that received the attestation."
    },
    "tier": {
      "type": "string",
      "description": "Attestation trust tier."
    }
  },
  "description": "Newly issued signed agent attestation."
}

Verify generative-engine optimization for a merchant URL (schema.org, feed, agent-card). Returns JSON GEO score with gaps. Compliance: EU AI Act Art. 50, schema.org. Cost £99 per call.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "minLength": 1,
      "description": "Absolute HTTPS URL of the merchant homepage to audit."
    },
    "product_feed_url": {
      "type": "string",
      "description": "Optional explicit product-feed URL if it is not discoverable from the homepage."
    },
    "agent_card_url": {
      "type": "string",
      "description": "Optional A2A / MCP agent-card URL (defaults to /.well-known/agent-card.json)."
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the tool completed without a validation error."
    },
    "tool": {
      "type": "string",
      "description": "Tool name that produced this payload."
    },
    "payment": {
      "type": "object",
      "description": "Settlement receipt after x402 or sandbox payment."
    },
    "url": {
      "type": "string",
      "description": "Audited URL."
    },
    "geo_score": {
      "type": "number",
      "description": "0–100 weighted checklist score."
    },
    "checks": {
      "type": "object",
      "description": "Per-check pass/fail with weights."
    },
    "gaps": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Failed checks."
    }
  },
  "description": "GEO audit report for a merchant URL."
}

Returns a 0–100 generative-engine visibility score and estimated LLM mention rate for a URL. Cost $0.01 per call. Not HTTP uptime, TLS, or a credit.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "minLength": 1,
      "description": "Absolute HTTPS URL whose generative-engine visibility score and estimated LLM mention rate should be returned."
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the tool completed without a validation error."
    },
    "tool": {
      "type": "string",
      "description": "Tool name that produced this payload."
    },
    "payment": {
      "type": "object",
      "description": "Settlement receipt after x402 or sandbox payment."
    },
    "url": {
      "type": "string",
      "description": "Queried URL."
    },
    "geo_score": {
      "type": "number",
      "description": "0–100 generative-engine visibility score."
    },
    "estimated_llm_mention_rate": {
      "type": "number",
      "description": "Estimated LLM mention rate for the URL."
    }
  },
  "description": "Generative-engine visibility snapshot (geo_score and estimated_llm_mention_rate)."
}

Verify an agent's IATP codebase/config attestation (Ed25519, fail-closed). Returns JSON validity result. Compliance: EU AI Act Art. 14, KYA-OS, IETF AID. Cost $0.02 per call.

{
  "type": "object",
  "properties": {
    "attestation": {
      "type": "object",
      "description": "IATP Ed25519 attestation envelope to verify (fail-closed)."
    },
    "agent_did": {
      "type": "string",
      "description": "Optional peer DID that must match the attestation agent_id."
    }
  },
  "required": [
    "attestation"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the tool completed without a validation error."
    },
    "tool": {
      "type": "string",
      "description": "Tool name that produced this payload."
    },
    "payment": {
      "type": "object",
      "description": "Settlement receipt after x402 or sandbox payment."
    },
    "valid": {
      "type": "boolean",
      "description": "Whether the Ed25519 attestation verified."
    },
    "agent_id": {
      "type": "string",
      "description": "Agent id bound in the attestation."
    },
    "error": {
      "type": "string",
      "description": "Failure reason when valid is false."
    }
  },
  "description": "IATP attestation verification (fail-closed)."
}

Retrieve an agent's IATP reputation trust score (0-10) after FACT slashing. Returns JSON score and trust level. Compliance: EU AI Act Art. 14, KYA-OS, IETF AID. Cost $0.01 per call.

{
  "type": "object",
  "properties": {
    "agent_did": {
      "type": "string",
      "minLength": 1,
      "description": "Agent DID whose IATP reputation trust score (0–10) should be returned."
    }
  },
  "required": [
    "agent_did"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the tool completed without a validation error."
    },
    "tool": {
      "type": "string",
      "description": "Tool name that produced this payload."
    },
    "payment": {
      "type": "object",
      "description": "Settlement receipt after x402 or sandbox payment."
    },
    "agent_did": {
      "type": "string",
      "description": "DID that was scored."
    },
    "trust_score": {
      "type": "number",
      "description": "IATP trust score on a 0–10 scale."
    },
    "trust_level": {
      "type": "string",
      "description": "Discrete trust level label."
    }
  },
  "description": "IATP reputation score after FACT slashing."
}

Verify pre-deployment agent behavior against a Worker Remit. Returns JSON maturity (0-100), gaps, and recommendations. Compliance: EU AI Act Art. 14, KYA-OS. Cost $0.50 per call.

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "minLength": 1,
      "description": "Agent identifier to assess against the Worker Remit."
    },
    "intended_role": {
      "type": "string",
      "description": "Stated role of the agent (used for remit matching)."
    },
    "mission": {
      "type": "string",
      "description": "Mission statement the agent claims to follow."
    },
    "allowed_tools": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tools the remit permits."
    },
    "forbidden_tools": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tools the remit forbids."
    },
    "requires_approval": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Actions that must escalate to a human or Gatekeeper."
    },
    "evidence_files": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Optional evidence file objects supplied for the assessment."
    },
    "evidence": {
      "type": "object",
      "description": "Optional structured evidence payload for the ABV engine."
    }
  },
  "required": [
    "agent_id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the tool completed without a validation error."
    },
    "tool": {
      "type": "string",
      "description": "Tool name that produced this payload."
    },
    "payment": {
      "type": "object",
      "description": "Settlement receipt after x402 or sandbox payment."
    },
    "maturity": {
      "type": "number",
      "description": "ABV maturity score 0–100."
    },
    "gaps": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Behavioral gaps against the remit."
    },
    "recommendations": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Remediation recommendations."
    }
  },
  "description": "Pre-deployment ABV maturity assessment."
}

Retrieve the stored ABV maturity score (0-100) for an agent. Returns JSON score. Compliance: EU AI Act Art. 14, KYA-OS. Cost $0.01 per call.

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "minLength": 1,
      "description": "Agent identifier whose stored ABV maturity score (0–100) should be returned."
    }
  },
  "required": [
    "agent_id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the tool completed without a validation error."
    },
    "tool": {
      "type": "string",
      "description": "Tool name that produced this payload."
    },
    "payment": {
      "type": "object",
      "description": "Settlement receipt after x402 or sandbox payment."
    },
    "agent_id": {
      "type": "string",
      "description": "Agent that was queried."
    },
    "maturity": {
      "type": "number",
      "description": "Stored maturity score 0–100."
    }
  },
  "description": "Stored ABV maturity for an agent."
}

Retrieve NIST AI 200-2 TEVV-Athlon mapping for IATP, ABV, FACT, and Lean 4. Returns JSON alignment document. Compliance: NIST AI 200-2, EU AI Act Art. 9, 13, 15. Cost $0.01 per call.

{
  "type": "object",
  "properties": {
    "format": {
      "type": "string",
      "enum": [
        "json"
      ],
      "description": "Response format. Only 'json' is supported."
    }
  },
  "required": [
    "format"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the tool completed without a validation error."
    },
    "tool": {
      "type": "string",
      "description": "Tool name that produced this payload."
    },
    "payment": {
      "type": "object",
      "description": "Settlement receipt after x402 or sandbox payment."
    },
    "framework": {
      "type": "string",
      "description": "Framework identifier."
    },
    "dashboard": {
      "type": "object",
      "description": "Stage counts and comment-period fields."
    },
    "comment_period": {
      "type": "object",
      "description": "NIST comment window."
    }
  },
  "description": "NIST AI 200-2 TEVV-Athlon mapping document."
}

Issue a TEVV-Athlon assessment report from stored IATP reputation and ABV maturity. Returns JSON alignment scores. Compliance: NIST AI 200-2, EU AI Act Art. 9, 13, 15. Cost $0.50 per call.

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "minLength": 1,
      "description": "Agent identifier to score against the NIST AI 200-2 TEVV-Athlon mapping."
    }
  },
  "required": [
    "agent_id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the tool completed without a validation error."
    },
    "tool": {
      "type": "string",
      "description": "Tool name that produced this payload."
    },
    "payment": {
      "type": "object",
      "description": "Settlement receipt after x402 or sandbox payment."
    },
    "agent_id": {
      "type": "string",
      "description": "Agent that was assessed."
    },
    "report": {
      "type": "object",
      "description": "Alignment scores and narrative."
    }
  },
  "description": "TEVV-Athlon assessment report for one agent."
}

Store a client-encrypted memory entry for an entity. Server never sees plaintext (PBKDF2/AES-256-GCM). Requires wallet signature. Returns JSON receipt. Compliance: GDPR Art. 5, 32. Cost $0.01 per call.

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

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the tool completed without a validation error."
    },
    "tool": {
      "type": "string",
      "description": "Tool name that produced this payload."
    },
    "payment": {
      "type": "object",
      "description": "Settlement receipt after x402 or sandbox payment."
    },
    "entry_id": {
      "type": "string",
      "description": "UUID of the persisted memory_entries row."
    },
    "content_hash": {
      "type": "string",
      "description": "SHA-256 hex of the caller plaintext."
    },
    "entity_id": {
      "type": "string",
      "description": "Entity the memory was written for."
    },
    "entity_type": {
      "type": "string",
      "description": "Entity type."
    },
    "category": {
      "type": "string",
      "description": "Memory category."
    },
    "written_at": {
      "type": "string",
      "description": "UTC timestamp of the write."
    }
  },
  "description": "Receipt for a stored encrypted memory entry."
}

Retrieve client-encrypted memory entries for an entity. Returns ciphertext, nonce, and content_hash - never plaintext. Requires wallet signature. Compliance: GDPR Art. 15, 32. Cost $0.01 per call.

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

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the tool completed without a validation error."
    },
    "tool": {
      "type": "string",
      "description": "Tool name that produced this payload."
    },
    "payment": {
      "type": "object",
      "description": "Settlement receipt after x402 or sandbox payment."
    },
    "entity_id": {
      "type": "string",
      "description": "Entity that was queried."
    },
    "category": {
      "type": "string",
      "description": "Category filter, if provided."
    },
    "count": {
      "type": "integer",
      "description": "Number of entries returned."
    },
    "entries": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Ciphertext rows (never plaintext)."
    },
    "accessed_as": {
      "type": "string",
      "description": "owner, system, or grantee."
    },
    "read_at": {
      "type": "string",
      "description": "UTC timestamp of the read."
    }
  },
  "description": "Encrypted memory entries the caller is allowed to read."
}

Grant another wallet time-bounded access to specified memory entries. Returns grant receipt; immutable consent row written. Compliance: GDPR Art. 7, 32. Cost $0.01 per call.

{
  "type": "object",
  "properties": {
    "grantor_wallet": {
      "type": "string",
      "minLength": 42,
      "maxLength": 42,
      "description": "0x-prefixed owner wallet issuing the grant."
    },
    "grantee_wallet": {
      "type": "string",
      "minLength": 42,
      "maxLength": 42,
      "description": "0x-prefixed wallet that will be allowed to read."
    },
    "grantee_did": {
      "type": "string",
      "description": "Optional DID stored for audit alongside the grantee wallet."
    },
    "entity_id": {
      "type": "string",
      "minLength": 1,
      "description": "Entity whose memory the grant covers."
    },
    "entity_type": {
      "type": "string",
      "enum": [
        "agent",
        "habitat",
        "project",
        "site",
        "transaction",
        "user"
      ],
      "description": "Entity type of the granted memory."
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "verification",
          "preference",
          "context",
          "history"
        ]
      },
      "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)."
    },
    "wallet_signature": {
      "type": "string",
      "description": "EIP-191 signature of the grantor over the grant message."
    }
  },
  "required": [
    "grantor_wallet",
    "grantee_wallet",
    "entity_id",
    "entity_type",
    "categories",
    "wallet_signature"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the tool completed without a validation error."
    },
    "tool": {
      "type": "string",
      "description": "Tool name that produced this payload."
    },
    "payment": {
      "type": "object",
      "description": "Settlement receipt after x402 or sandbox payment."
    },
    "grant_id": {
      "type": "string",
      "description": "UUID of the grant."
    },
    "grantor_wallet": {
      "type": "string",
      "description": "Issuing owner wallet."
    },
    "grantee_wallet": {
      "type": "string",
      "description": "Wallet that received access."
    },
    "entity_id": {
      "type": "string",
      "description": "Granted entity."
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Granted categories."
    },
    "expires_at": {
      "type": "string",
      "description": "Expiry timestamp, if set."
    },
    "consent_hash": {
      "type": "string",
      "description": "SHA-256 of the canonical consent payload."
    },
    "granted_at": {
      "type": "string",
      "description": "UTC timestamp of the grant."
    }
  },
  "description": "Newly created memory grant receipt."
}

Revoke a previously issued memory grant immediately. Returns JSON revocation receipt. Compliance: GDPR Art. 7, 17. Cost $0.01 per call.

{
  "type": "object",
  "properties": {
    "grantor_wallet": {
      "type": "string",
      "minLength": 42,
      "maxLength": 42,
      "description": "0x-prefixed wallet of the original grantor."
    },
    "grant_id": {
      "type": "string",
      "minLength": 1,
      "description": "UUID of the grant to revoke."
    },
    "wallet_signature": {
      "type": "string",
      "description": "EIP-191 signature of the grantor over the revoke message."
    }
  },
  "required": [
    "grantor_wallet",
    "grant_id",
    "wallet_signature"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the tool completed without a validation error."
    },
    "tool": {
      "type": "string",
      "description": "Tool name that produced this payload."
    },
    "payment": {
      "type": "object",
      "description": "Settlement receipt after x402 or sandbox payment."
    },
    "grant_id": {
      "type": "string",
      "description": "UUID of the revoked grant."
    },
    "revoked_at": {
      "type": "string",
      "description": "UTC timestamp of revocation."
    },
    "note": {
      "type": "string",
      "description": "Present when the grant was already revoked."
    }
  },
  "description": "Revocation receipt for a memory grant."
}

Retrieve non-sensitive metadata on prior tool invocations for an entity (count, timestamps, last hash). Never returns ciphertext. Compliance: GDPR Art. 5, 15. Cost $0.01 per call.

{
  "type": "object",
  "properties": {
    "entity_id": {
      "type": "string",
      "minLength": 1,
      "description": "Entity whose prior tool invocations should be summarised."
    },
    "tool_name": {
      "type": "string",
      "minLength": 1,
      "description": "Tool name to look up, e.g. 'verify_biodiversity' or 'request_mrv_report'."
    },
    "owner_wallet": {
      "type": "string",
      "minLength": 42,
      "maxLength": 42,
      "description": "0x-prefixed owner wallet. Only that owner's rows are counted."
    },
    "wallet_signature": {
      "type": "string",
      "description": "EIP-191 signature over the tool-context message."
    }
  },
  "required": [
    "entity_id",
    "tool_name",
    "owner_wallet",
    "wallet_signature"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the tool completed without a validation error."
    },
    "tool": {
      "type": "string",
      "description": "Tool name that produced this payload."
    },
    "payment": {
      "type": "object",
      "description": "Settlement receipt after x402 or sandbox payment."
    },
    "entity_id": {
      "type": "string",
      "description": "Queried entity."
    },
    "tool_name": {
      "type": "string",
      "description": "Queried source_tool."
    },
    "prior_invocations": {
      "type": "integer",
      "description": "Matching memory writes."
    },
    "first_verified_at": {
      "type": "string",
      "description": "Oldest matching created_at."
    },
    "last_verified_at": {
      "type": "string",
      "description": "Newest matching created_at."
    },
    "last_content_hash": {
      "type": "string",
      "description": "SHA-256 of the last write's plaintext."
    },
    "hash_chain_intact": {
      "type": "boolean",
      "description": "Reserved; always true until anchors land."
    },
    "recommended_action": {
      "type": "string",
      "description": "fresh_verification, delta_verification, or stale_verification."
    },
    "metadata_only": {
      "type": "boolean",
      "description": "Always true."
    },
    "queried_at": {
      "type": "string",
      "description": "UTC timestamp of this query."
    }
  },
  "description": "Non-sensitive metadata about prior tool invocations. Never ciphertext."
}

Retrieve a signed, non-binding recommendation of verification-call cost from memory. Returns JSON hint; 402 list price unchanged. Compliance: GDPR Art. 5. Cost $0.01 per call.

{
  "type": "object",
  "properties": {
    "entity_id": {
      "type": "string",
      "minLength": 1,
      "description": "Entity the recommendation is scoped to."
    },
    "tool_name": {
      "type": "string",
      "minLength": 1,
      "description": "Live verification tool to price, e.g. 'verify_biodiversity'."
    },
    "owner_wallet": {
      "type": "string",
      "minLength": 42,
      "maxLength": 42,
      "description": "0x-prefixed owner wallet. Signature must recover to this address."
    },
    "wallet_signature": {
      "type": "string",
      "description": "EIP-191 signature over the pricing-hint message."
    },
    "context_signature": {
      "type": "string",
      "description": "Optional unused field reserved for a future composed context signature."
    }
  },
  "required": [
    "entity_id",
    "tool_name",
    "owner_wallet",
    "wallet_signature"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the tool completed without a validation error."
    },
    "tool": {
      "type": "string",
      "description": "Tool name that produced this payload."
    },
    "payment": {
      "type": "object",
      "description": "Settlement receipt after x402 or sandbox payment."
    },
    "entity_id": {
      "type": "string",
      "description": "Scoped entity."
    },
    "tool_name": {
      "type": "string",
      "description": "Verification tool being priced."
    },
    "owner_wallet": {
      "type": "string",
      "description": "Wallet the hint was issued to."
    },
    "list_price_usd": {
      "type": "number",
      "description": "Convention list price in USD."
    },
    "recommended_action": {
      "type": "string",
      "description": "fresh_verification, delta_verification, or stale_verification."
    },
    "discount_factor": {
      "type": "number",
      "description": "1.00 / 0.33 / 0.66."
    },
    "suggested_price_usd": {
      "type": "number",
      "description": "list_price_usd times discount_factor."
    },
    "prior_invocations": {
      "type": "integer",
      "description": "Matching memory writes."
    },
    "issued_at": {
      "type": "string",
      "description": "UTC timestamp of the hint."
    },
    "hint_hash": {
      "type": "string",
      "description": "SHA-256 of the canonical hint body."
    },
    "binding": {
      "type": "boolean",
      "description": "Always false. Does not change any 402."
    },
    "note": {
      "type": "string",
      "description": "How to realize the discount."
    },
    "metadata_only": {
      "type": "boolean",
      "description": "Always true."
    }
  },
  "description": "Signed, non-binding price recommendation. Never ciphertext."
}

Retrieve a signed, non-binding monthly subscription quote for a wallet. Returns JSON quote; x402 prepaid funding. Compliance: GDPR Art. 5, 7. Cost $0.01 per call.

{
  "type": "object",
  "properties": {
    "owner_wallet": {
      "type": "string",
      "minLength": 42,
      "maxLength": 42,
      "description": "0x-prefixed wallet the quote is issued to."
    },
    "wallet_signature": {
      "type": "string",
      "description": "EIP-191 signature over the subscription-quote message."
    },
    "tier": {
      "type": "string",
      "enum": [
        "basic",
        "pro",
        "enterprise"
      ],
      "description": "Plan to quote: basic, pro, or enterprise. Defaults to pro."
    }
  },
  "required": [
    "owner_wallet",
    "wallet_signature"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the tool completed without a validation error."
    },
    "tool": {
      "type": "string",
      "description": "Tool name that produced this payload."
    },
    "payment": {
      "type": "object",
      "description": "Settlement receipt after x402 or sandbox payment."
    },
    "tier": {
      "type": "string",
      "description": "basic, pro, or enterprise."
    },
    "monthly_usd": {
      "type": "number",
      "description": "Quoted monthly prepaid amount."
    },
    "includes_tools": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tools covered by the tier."
    },
    "verification_calls_included": {
      "type": "integer",
      "description": "Included verification calls; null means unlimited."
    },
    "delta_discount": {
      "type": "boolean",
      "description": "Whether the tier applies the delta factor."
    },
    "list_prices_usd": {
      "type": "object",
      "description": "Convention list prices used by pricing_hint."
    },
    "discount_factors": {
      "type": "object",
      "description": "fresh / delta / stale factors."
    },
    "current_balance_usd": {
      "type": "number",
      "description": "Prepaid balance; 0 until funding lands."
    },
    "issued_at": {
      "type": "string",
      "description": "UTC timestamp of the quote."
    },
    "quote_hash": {
      "type": "string",
      "description": "SHA-256 of the canonical quote body."
    },
    "note": {
      "type": "string",
      "description": "Prepaid-credit funding is a later prompt."
    },
    "binding": {
      "type": "boolean",
      "description": "Always false."
    }
  },
  "description": "Signed, non-binding monthly subscription quote."
}

Issue an Ed25519-signed portable attestation for a memory entry. Returns envelope for offline verify; server does not store it. Compliance: GDPR Art. 5, 32. Cost $0.01 per call.

{
  "type": "object",
  "properties": {
    "entry_id": {
      "type": "string",
      "minLength": 1,
      "description": "UUID of the memory entry to attest. Must belong to owner_wallet."
    },
    "owner_wallet": {
      "type": "string",
      "minLength": 42,
      "maxLength": 42,
      "description": "0x-prefixed owner wallet. Only the owner can attest."
    },
    "wallet_signature": {
      "type": "string",
      "description": "EIP-191 signature over the attest message (entry, owner, content hash)."
    }
  },
  "required": [
    "entry_id",
    "owner_wallet",
    "wallet_signature"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the tool completed without a validation error."
    },
    "tool": {
      "type": "string",
      "description": "Tool name that produced this payload."
    },
    "payment": {
      "type": "object",
      "description": "Settlement receipt after x402 or sandbox payment."
    },
    "envelope": {
      "type": "object",
      "description": "Signed innovalxx.memory.attestation.v1 envelope."
    },
    "envelope_hash": {
      "type": "string",
      "description": "SHA-256 of the canonical full envelope."
    },
    "note": {
      "type": "string",
      "description": "Caller keeps the envelope; platform does not store it."
    }
  },
  "description": "Portable Ed25519 memory attestation envelope. Never ciphertext."
}

Verify a memory attestation envelope against the platform key registry. Returns JSON validity result; also verifiable offline. Compliance: GDPR Art. 5, 32. Cost $0.01 per call.

{
  "type": "object",
  "properties": {
    "envelope": {
      "type": "object",
      "description": "Portable innovalxx.memory.attestation.v1 envelope to verify."
    }
  },
  "required": [
    "envelope"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the tool completed without a validation error."
    },
    "tool": {
      "type": "string",
      "description": "Tool name that produced this payload."
    },
    "payment": {
      "type": "object",
      "description": "Settlement receipt after x402 or sandbox payment."
    },
    "valid": {
      "type": "boolean",
      "description": "Whether the Ed25519 signature verified."
    },
    "reason": {
      "type": "string",
      "description": "Present when valid is false."
    },
    "platform_key_id": {
      "type": "string",
      "description": "Key id from the envelope."
    },
    "platform_key_is_current": {
      "type": "boolean",
      "description": "True when platform_key_id matches the live FACT key."
    },
    "entry_id": {
      "type": "string",
      "description": "Attested entry UUID."
    },
    "content_hash": {
      "type": "string",
      "description": "Attested content hash."
    },
    "entity_id": {
      "type": "string",
      "description": "Attested entity."
    },
    "attested_at": {
      "type": "string",
      "description": "UTC timestamp from the envelope."
    },
    "verification_mode": {
      "type": "string",
      "description": "Always ed25519 on success."
    },
    "verification_note": {
      "type": "string",
      "description": "Offline verification reminder."
    }
  },
  "description": "Stateless verification of a memory attestation envelope."
}

Query owner memory entries by entity_type, category, tags, or time range. Returns ciphertext plus metadata - never plaintext. Requires wallet signature. Compliance: GDPR Art. 15, 20. Cost $0.01 per call.

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

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True when the tool completed without a validation error."
    },
    "tool": {
      "type": "string",
      "description": "Tool name that produced this payload."
    },
    "payment": {
      "type": "object",
      "description": "Settlement receipt after x402 or sandbox payment."
    },
    "filters": {
      "type": "object",
      "description": "Validated filters that were applied."
    },
    "count": {
      "type": "integer",
      "description": "Entries on this page."
    },
    "total": {
      "type": "integer",
      "description": "Matching row count before pagination."
    },
    "offset": {
      "type": "integer",
      "description": "Page offset."
    },
    "limit": {
      "type": "integer",
      "description": "Page size."
    },
    "entries": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Ciphertext rows owned by the signer (never plaintext)."
    },
    "accessed_as": {
      "type": "string",
      "description": "Always owner in Prompt 5."
    },
    "queried_at": {
      "type": "string",
      "description": "UTC timestamp of the query."
    }
  },
  "description": "Owner-scoped encrypted memory query page."
}