Tellor Tributes Fetcher

WHAT IT DOES

Tellor Tributes Fetcher provides read-only access to Tellor oracle tribute contracts on EVM-compatible blockchains. It fetches comprehensive tribute data including oracle contract state, tribute contract state, tribute balances, tribute count, tribute details (amount, token, reporter, timestamp), user tribute history, reporting state, reward rates, chain ID, block timestamp, and gas price. All data is read directly from the chain through your connected wallet provider — no funds are ever at risk. The tool aggregates tribute information from Tellor's oracle infrastructure, making it easy to track tribute activity and user participation.

HOW TO USE

Connect your EVM-compatible wallet (MetaMask, WalletConnect, or similar) using the wallet bridge. Select the network that matches the Tellor deployment you wish to inspect (Ethereum Mainnet, Polygon, Arbitrum, Optimism, Avalanche, Base, or others). Paste the oracle contract address and the tribute contract address — the tool does not hardcode any address, giving you full flexibility to inspect official Tellor deployments or fork contracts. Optionally enter a user address to check their tribute balance and history, or enter a specific tribute ID to fetch details for a single tribute. Click "Fetch tributes" to retrieve and display the data, including tribute count, total supply, user balances, user tribute count, and detailed tribute records with amounts, tokens, reporters, and timestamps.

HOW IT WORKS UNDER THE HOOD

The tool uses a multi-step read strategy to assemble a complete tribute data snapshot. First, it connects to the provider and validates the oracle and tribute contract addresses. It then reads the tributeCount and totalSupply from the tribute contract to understand the overall state. If a user address is provided, the tool calls balanceOf and getUserTributes to fetch the user's tribute balance and a list of tribute IDs they are associated with. For each tribute ID, it calls getTribute to retrieve detailed information including the amount, token address, reporter address, and timestamp. The tool displays all results in a clear, readable format with proper decimal handling using ethers.utils.formatUnits. If a specific tribute ID is requested, it fetches and displays that tribute's details directly.

WHAT IT CANNOT SEE

The tool cannot verify that the reported data is accurate; it reads what the contract reports but does not independently validate the data. It cannot detect if the oracle has been manipulated or if there are security vulnerabilities in the oracle contracts; the tool only reads public state. It cannot guarantee that the tributes reflect the actual value of the reported data; tribute values depend on the accuracy of the oracle data submitted by reporters. It cannot predict future tribute amounts or reporting activity; future tributes depend on network activity and reporter participation. It cannot verify that the tribute contracts are the official Tellor deployments; the tool uses the addresses you provide.

PLEASE NOTE

This tool works exclusively with EVM-compatible blockchains where Tellor is deployed. It does not support non-EVM chains. Always verify the oracle and tribute contract addresses against official Tellor documentation before use. The tool is read-only — it never signs transactions or moves funds. It is provided as-is with no warranty of any kind.