{"uid":"cap_S6Pu3Fi8NaTyUYT8C-uoG","slug":"mercator-verify-address-evidence-39810867","name":"MERCATOR Verify Address Evidence","description":"MERCATOR Verify provides evidence-backed verification and decision support for autonomous agents. Use its specialized tools when an agent needs trustworthy evidence before taking a downstream action.","url":"https://mercator-entity-evidence.fly.dev/v1/address-evidence","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"enum":["ethereum","base","solana"],"type":"string","description":"REQUIRED. The chain is never inferred from the address: the same bytes are a valid address on every EVM chain, and on two of them a different contract."},"domain":{"type":"string","description":"Domain of the entity or protocol the contract is claimed to belong to"},"address":{"type":"string","description":"REQUIRED FOR A TRANSACT DECISION. The candidate target you found and intend to interact with. Supplying it asks whether the evidence supports THAT address; it is never treated as evidence itself. Omit it and the answer is always transact=false with reason candidate_address_required, plus the addresses the entity publishes as context — this service verifies the claim you bring and never chooses a transaction target for you."},"purpose":{"type":"string","description":"Optional. What you intend to call this contract for: \"staking\", \"bridge\", \"governance\". Supplying it asks the second question — the address is theirs, and is it the contract you meant — and a source that says it is a different kind of contract then fails closed. Omitting it does not skip the purpose gate: the entity's own source must still say what the contract is, or the answer is transact=false with reason contract_purpose_unverified."},"protocol":{"type":"string","description":"Optional protocol or product name, when the docs name it differently"}}},"responseSchema":{"type":"json","example":{"chain":"base","notes":[],"proxy":{"note":"canonical interaction target is the proxy; the implementation is context only and is expected to change across upgrades without changing this answer","is_proxy":true,"proxy_type":"eip1967","proxy_address":"0x0000000000000000000000000000000000000001","implementation_addresses":["0x0000000000000000000000000000000000000002"]},"action":{"means":"there is sufficient provenance evidence that this chain and address is the intended contract target","reason":"an entity-controlled source and an independent chain source state the same chain and address","transact":true,"does_not_mean":"this is not a safety, audit or malice assessment; the contract may still be unaudited, upgradeable to hostile code, or able to take your funds"},"entity":"example-protocol.org","status":"PASS","address":"0x0000000000000000000000000000000000000001","context":[],"billable":true,"evidence":[{"url":"https://example-protocol.org/contracts","basis":"entity_published","excerpt":"Base: 0x0000000000000000000000000000000000000001","operator":"example-protocol.org","source_id":"entity_page","retrieved_at":"2026-09-01T12:00:00Z","states_chain":"base","states_address":"0x0000000000000000000000000000000000000001"},{"url":"https://base.blockscout.com/api/v2/addresses/0x0000000000000000000000000000000000000001","basis":"explorer_verified","excerpt":"\"hash\":\"0x0000000000000000000000000000000000000001\",\"is_contract\":true","operator":"blockscout.com","source_id":"blockscout_base","retrieved_at":"2026-09-01T12:00:00Z","states_chain":"base","states_address":"0x0000000000000000000000000000000000000001"}],"protocol":"","agreement":"2_of_2","conflicts":[],"confidence":0.9,"chain_caip2":"eip155:8453","billing_note":"","basis_meaning":{"entity_published":"the entity's own site or documentation states this chain and address; it is the entity's published claim about itself, not proof of control","explorer_verified":"an independent chain explorer confirms a contract exists at this chain and address and reports its on-chain metadata; it does not say whose it is"},"evidence_basis":["entity_published","explorer_verified"],"checked_address":null,"sources_consulted":["entity_page","blockscout_base"],"independent_origins":2,"checked_address_supported":null}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_zgTxN5PXi50j5yEE5BZGr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Verifies whether a candidate blockchain contract address on a given chain is genuinely owned/published by a named entity, returning evidence-backed transact/no-transact decision support for autonomous agents.","exampleAgentPrompt":"Before I stake my ETH, verify that 0xae78736Cd615f374D3085123A210448E74Fc6393 on Ethereum is the official rocketpool.net staking contract — I need evidence it's genuinely published by them and is intended for staking.","exampleUseCases":[{"title":"DeFi staking contract verification","prompt":"I'm about to stake tokens using address 0x0000000000000000000000000000000000000001 on Base — can you verify this is the real staking contract published by example-protocol.org and not an imposter?"},{"title":"Bridge contract check before cross-chain transfer","prompt":"Before my agent initiates a cross-chain transfer, verify that 0xAbC1234567890000000000000000000000000001 on Ethereum is the official bridge contract belonging to hop.exchange — the purpose is bridging."},{"title":"Governance contract validation for DAO vote","prompt":"I want to cast a vote through 0xDeF9876543210000000000000000000000000001 on Base — check whether this is the real governance contract published by compound.finance before my agent submits the transaction."}],"resultDescription":"A JSON object containing: a boolean transact decision with a reason and plain-language meaning, a status (PASS/FAIL), a confidence score (0-1), an evidence array (each with URL, excerpt, basis, operator, retrieved timestamp, stated chain, and stated address), agreement summary across sources, any conflicts, proxy information (whether the contract is a proxy, its type and implementation addresses), the canonical entity name, chain CAIP-2 identifier, and contextual notes. The response makes clear what the evidence does and does not guarantee (e.g. not a safety or audit assessment).","failureModes":["address not provided — transact=false with reason candidate_address_required, plus context addresses published by entity","contract purpose cannot be verified from entity sources — transact=false with reason contract_purpose_unverified","conflicting evidence between entity-published sources and chain explorers — transact=false with conflicts array populated","entity domain has no discoverable published contract addresses — low confidence or FAIL status","unsupported chain value outside ethereum/base/solana enum — validation error","network timeout or upstream explorer unavailability — service error response","entity publishes address for a different chain than requested — conflict and transact=false"],"whenToPreferThis":"Use this endpoint when an autonomous agent needs trustworthy, evidence-backed confirmation that a specific blockchain address is the correct contract for a named protocol or entity before executing any on-chain action. It is specifically designed for agentic pre-transaction verification workflows on Ethereum, Base, or Solana, where the agent has already found a candidate address and needs to cross-reference it against entity-published and independent chain-explorer sources. Prefer this over generic blockchain explorers when you need a structured transact/no-transact decision with cited evidence rather than raw on-chain data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:37:59.001Z","isFirstParty":false}