On-Chain Community Benefit Agreement Tracker

WHAT IT DOES

This tool connects to your EVM wallet and scans community benefit agreement contracts across different EVM chains to track commitment details, milestone completion status, impact metrics, and compliance data. It reads beneficiary addresses, benefit distribution schedules, agreement fulfillment status, and milestone progress from on-chain agreement registries. The tool provides a clear overview of each agreement's current state, allowing stakeholders to monitor whether commitments are being met and benefits are being delivered as promised.

HOW TO USE

Connect your Web3 wallet using the Connect button. In the Agreement Configurations textarea, enter each community benefit agreement contract you want to query in the format name:contract:chain—one per line. For example, "CBA:0x4b8a4D1F6a2Ff6b9A6B0F4A9A8F0A9A8F0A9A8F0:1" for a CBA contract on Ethereum mainnet or "CommunityAgreement:0x...:137" for an agreement registry on Polygon. Enter the agreement ID or beneficiary address you wish to look up in the Agreement ID field. Click "Track Agreement" to fetch agreement data and milestone status from each configured contract. Results appear in the Results card with a summary of agreements found, milestones completed, and fulfillment status, followed by a detailed breakdown of each agreement's data.

TECHNICAL MECHANISM: MULTI-CONTRACT AGREEMENT AND MILESTONE DETECTION

The tool uses ethers.js to interact with community benefit agreement contracts through a tiered ABI detection system. For agreement data, it attempts getAgreement(address) when the lookup value is an address, and getAgreement(uint256) or agreement(uint256) when it's a numeric ID. Each function returns beneficiary, amount, timestamp, and fulfillment status. For milestone tracking, it attempts getMilestones(uint256) which returns an array of milestone completion indicators. The tool calculates completed milestones by filtering for non-zero values. All operations are executed through the connected provider with proper error handling for each contract.

WHAT IT CANNOT SEE

This tool cannot verify off-chain benefit delivery or impact—it only reads on-chain agreement records and cannot validate whether benefits were actually delivered to communities. It cannot validate that reported milestone completions are accurate—the tool trusts the contract's recorded status and cannot independently verify milestones. It cannot assess the quality or effectiveness of delivered benefits—the tool only tracks completion status, not outcomes. It relies on agreement contract interfaces and may not support all CBA frameworks—if a contract uses a non-standard interface, agreements may not be detected. It cannot ensure compliance with regulatory or legal requirements for community benefit agreements—the tool does not validate legal compliance.

PLEASE NOTE

This is a read-only tool—it never signs transactions or requests write permissions. All data is fetched on-demand and stored only in memory; nothing is persisted across page reloads. The tool supports EVM chains only—Ethereum, Polygon, BSC, Arbitrum, Optimism, Avalanche, Base, and Fantom. Always verify that the contract addresses you enter are correct and correspond to the agreement contracts you intend to query. The example addresses shown are placeholders—replace them with actual contract addresses from the relevant community benefit agreement frameworks.