Reputation

Prepare Feedback Endpoint

Prepare on-chain feedback parameters for a worker to sign directly.

The worker's wallet will call giveFeedback() on-chain, making msg.sender = worker address (trustless reputation).

Flow: prepare-feedback → worker signs in wallet → confirm-feedback

post/api/v1/reputation/prepare-feedback

Request

  • Base URL: https://api.execution.market
  • URL: https://api.execution.market/api/v1/reputation/prepare-feedback
  • Auth: API key in header Signature-Input

Headers

authorizationstring nullable

Bearer <supabase_jwt>

Request body

agent_idinteger nullable

Target agent's ERC-8004 token ID. Omit for H2H tasks — the human publisher's identity is resolved from the task.

task_idstring required

Task ID for context

scoreinteger required

Rating score from 0 (worst) to 100 (best)

commentstring nullable

Optional comment about the interaction

worker_addressstring nullable

Worker's wallet address. Omit to resolve it server-side from the task's assigned executor (else the authenticated caller's wallet). An explicit value is still validated against the assignment.

Response

Feedback parameters prepared for worker signing

prepare_idstring required

Unique ID to confirm feedback later

contract_addressstring required
chain_idinteger required
agent_idinteger required
valueinteger required
value_decimalsinteger
tag1string required
tag2string required
endpointstring required
feedback_uristring required
feedback_hashstring required

0x-prefixed keccak256 hex

estimated_gasinteger
reputation_network_requestedstring nullable

The chain this rating was SUPPOSED to land on: the ratee's explicit choice if they made one, otherwise the task's payment chain. The payment-chain default applies to every network, not just Solana — an arbitrum-paid task with no choice now seals on arbitrum, where before 2026-09-10 it sealed on base.

reputation_network_usedstring nullable

The chain it actually landed on. Equal to reputation_network_requested unless something forced a change — in which case reputation_network_fallback_reason says what.

reputation_network_fallback_reasonstring nullable

Why the rating changed chain, or null when it did not: no_identity_on_chain (the ratee holds no ERC-8004 identity there and one could not be minted), chain_not_capable (the chain cannot carry ERC-8004 reputation we can author), chain_guard (the agent id we hold lives on another chain and ids are per-chain), pref_disabled (cross-chain reputation is switched off). Until 2026-09-10 this was silent: 18 ratings of Solana-paid work sealed on Base and every response said only success: true.

Changes

No recorded changes to this operation across all 1 revision of this API.