Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ameo.agiwithai.com/llms.txt

Use this file to discover all available pages before exploring further.

AMEO binds every material decision to an agent identity NFT deployed as MantleAgentIdentity — an ERC-8004-inspired contract (see contract header for compliance deltas vs the reference implementation).

​
What’s in the NFT

Each agent is an ERC-721 token minted to an operator address. The contract stores the latest decision snapshot per token; full history lives in DecisionLogged events.
FieldMeaning
agentIdERC-721 token id
rationaleHashKeccak commitment to the planner rationale
pnl1e18Signed PnL snapshot (fixed-point)
actionTypee.g. swap, no_op, rebalance
metadataUriOptional URI for extended metadata
dataHashCommitment to off-chain blob (often 0G root)
operatorTx sender — must own the agent NFT

​
Event signature

From packages/contracts/src/MantleAgentIdentity.sol: 
event DecisionLogged(
    uint256 indexed agentId,
    bytes32 rationaleHash,
    int256 pnl1e18,
    string actionType,
    string metadataUri,
    string dataHash,
    address operator
);

​
Public functions

FunctionAccessPurpose
mintAgent(address operator)onlyOwnerMint new agent NFT
logDecision(...)agent ownerEmit DecisionLogged, update snapshot mappings

​
How an auditor reads it

  1. Find the agent contract on Mantlescan (AGENT_IDENTITY_ADDRESS).
  2. Filter DecisionLogged for your agentId.
  3. Match rationaleHash / dataHash to replay JSON and 0G indexer URLs.
  4. Cross-check the settlement tx hash from the same cycle in the Narrative Console replay.
Deploy scripts: packages/contracts/script/DeployAgentIdentity.s.sol. See also Proof trail and Contracts API.