azeth_get_active_opinion
Check if you have an active reputation opinion for an agent before submitting a new one to avoid overwriting existing feedback.
Instructions
Check if you have an active reputation opinion for a specific agent.
Use this when: You want to verify whether you have already submitted a reputation opinion for an agent before submitting a new one (which would overwrite the existing one).
The agentId is the ERC-8004 token ID of the agent you want to check. Use azeth_discover_services or azeth_get_registry_entry to find token IDs.
Returns: Whether an active opinion exists and its opinion index on the reputation registry.
This is read-only and safe to call at any time.
Example: { "agentId": "3" }
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | Target chain. Defaults to AZETH_CHAIN env var or "baseSepolia". Accepts "base", "baseSepolia", "ethereumSepolia", "ethereum" (and aliases like "base-sepolia", "eth-sepolia", "sepolia", "eth", "mainnet"). | |
| agentId | Yes | The ERC-8004 token ID of the agent to check your opinion for. |
Implementation Reference
- src/tools/reputation.ts:430-457 (handler)The handler function for azeth_get_active_opinion, which resolves the smart account, checks for an active opinion on-chain, and returns the result.
async (args) => { let client; try { client = await createClient(args.chain); // Validate agentId as uint256 let agentIdBigInt: bigint; try { agentIdBigInt = BigInt(args.agentId); if (agentIdBigInt < 0n) throw new Error('negative'); } catch { return error('INVALID_INPUT', `Invalid agentId "${args.agentId}". Must be a non-negative integer.`); } // Resolve smart account address — the on-chain mapping is keyed by // smart account (msg.sender in the UserOp), not the EOA. const account = await client.resolveSmartAccount(); const result = await client.getActiveOpinion(agentIdBigInt, account); return success({ agentId: args.agentId, hasActiveOpinion: result.exists, opinionIndex: result.exists ? result.opinionIndex.toString() : null, message: result.exists ? `You have an active opinion (index ${result.opinionIndex}) for agent #${args.agentId}. Submitting a new opinion will overwrite it.` : `No active opinion found for agent #${args.agentId}. You can submit one with azeth_submit_opinion.`, }); } catch (err) { - src/tools/reputation.ts:425-428 (schema)The input schema for azeth_get_active_opinion, requiring a string chain and a digit-only agentId.
inputSchema: z.object({ chain: z.string().optional().describe('Target chain. Defaults to AZETH_CHAIN env var or "baseSepolia". Accepts "base", "baseSepolia", "ethereumSepolia", "ethereum" (and aliases like "base-sepolia", "eth-sepolia", "sepolia", "eth", "mainnet").'), agentId: z.string().regex(/^\d+$/).describe('The ERC-8004 token ID of the agent to check your opinion for.'), }), - src/tools/reputation.ts:407-429 (registration)Registration of the azeth_get_active_opinion tool with its description and input schema.
server.registerTool( 'azeth_get_active_opinion', { description: [ 'Check if you have an active reputation opinion for a specific agent.', '', 'Use this when: You want to verify whether you have already submitted a reputation', 'opinion for an agent before submitting a new one (which would overwrite the existing one).', '', 'The agentId is the ERC-8004 token ID of the agent you want to check.', 'Use azeth_discover_services or azeth_get_registry_entry to find token IDs.', '', 'Returns: Whether an active opinion exists and its opinion index on the reputation registry.', '', 'This is read-only and safe to call at any time.', '', 'Example: { "agentId": "3" }', ].join('\n'), inputSchema: z.object({ chain: z.string().optional().describe('Target chain. Defaults to AZETH_CHAIN env var or "baseSepolia". Accepts "base", "baseSepolia", "ethereumSepolia", "ethereum" (and aliases like "base-sepolia", "eth-sepolia", "sepolia", "eth", "mainnet").'), agentId: z.string().regex(/^\d+$/).describe('The ERC-8004 token ID of the agent to check your opinion for.'), }), },