azeth_prove_reputation
Prove net USD payment relationship between two L2 accounts on Ethereum L1 using storage proofs. Build and simulate the proof; optionally broadcast the transaction.
Instructions
Prove an L2 net-USD payment relationship on L1 via MPT storage proof against TrustL2Reader.
Use this when: you want L2 (Base Sepolia) payment reputation between two accounts recognized on Ethereum L1 (feeds ReputationModule.getTotalNetPaidUSD cross-chain aggregation). Builds the proof from the current rollup anchor and SIMULATES it. Only submits an L1 transaction when broadcast=true.
Returns: status (simulated | broadcast | already-proven), the proven usdDelta and direction, anchor block, and txHash when broadcast.
Note: broadcast=false (default) is read-only and needs no private key. broadcast=true requires AZETH_PRIVATE_KEY whose EOA holds L1 ETH for gas (plain L1 transaction — permissionless, no guardian/bundler involved). Proof building requires an archive L2 RPC (AZETH_ARCHIVE_RPC_URL_BASE_SEPOLIA).
Example: { "payer": "0x1111…", "payee": "0x2222…", "broadcast": false }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | L2 chain whose reputation to prove. Defaults to AZETH_CHAIN env var or "baseSepolia". Accepts "base", "baseSepolia" (and aliases like "base-sepolia"). Must be an L2 registered on TrustL2Reader. | |
| payee | Yes | Payee address (counterparty that was paid). | |
| payer | Yes | Payer address (the account whose net USD payments should be recognized on L1). | |
| broadcast | No | When true, submit the proof transaction on L1 (requires AZETH_PRIVATE_KEY with L1 ETH for gas). Default false = build + simulate only. |