Seal, address,
and trade
encrypted
agent memory.

1// SPDX-License-Identifier: MIT
2pragma solidity ^0.8.27;
3 
4/// @title  IERC7689 — Noema bearer memory standard
5/// @notice Minimum surface a contract must expose to publish, query,
6///         and settle access to encrypted agent memory shards on Base.
7interface IERC7689 {
8    struct Noema {
9        bytes32 embeddingCommit;   // poseidon leaf in the publisher's tree
10        bytes32 ciphertextHash;    // keccak256 of the sealed payload
11        address publisher;
12        uint64  licenseTerms;      // packed: redistribute · derive · ttl
13        uint128 minBurn;           // floor price per query, in $NOEMA
14        uint16  kMax;              // max top-k publisher will return
15        uint8   proofKind;         // 1=ZK_GROTH16, 2=TEE_SGX, 3=TEE_SEV
16    }
17 
18    event Committed(bytes32 indexed noemaId, address indexed publisher);
19    event QueryEmitted(bytes32 indexed queryId, address indexed consumer, uint16 k);
20    event Settled(bytes32 indexed queryId, bytes32 root, uint128 paid);
21 
22    /// @notice publish a single sealed shard
23    function commit(Noema calldata n) external returns (bytes32 noemaId);
24 
25    /// @notice burn $NOEMA to bind a query for top-k recall
26    function query(bytes calldata embedding, uint16 k, uint128 burn)
27        external returns (bytes32 queryId);
28 
29    /// @notice deliver top-k + proof of kNN selection
30    function respond(bytes32 queryId, bytes32[] calldata topK, bytes calldata proof)
31        external;
32}