Data Provenance Tracker

WHAT IT DOES

Data Provenance Tracker gives organizations, auditors, and developers a comprehensive tool for tracking data provenance and ownership history on-chain. It reads live on-chain data including data origin records, ownership history, transfer logs, timestamp data, signer addresses, contract state, and provenance chains. You can register data with its origin, transfer ownership, verify provenance, update configurations, and export provenance records. The tool shows you in real time the data ID, owner, hash, name, record count, verification status, timestamp, and active status—so you can maintain complete data lineage and prove data authenticity.

HOW TO USE

Connect your EVM wallet (must be the contract owner or authorized address). Enter the provenance contract address, data ID (identifier), data hash, data name, originator address, and metadata JSON. Use "Check provenance state" to see the record count, last update time, active status, and verification status for a specific data ID. Click "Register data" to create a new provenance record. Use "Transfer ownership" to update the data owner. "Verify provenance" checks if a data ID exists and displays its lineage. "Update config" changes active status and max size. "Export provenance" downloads the records as JSON. Each action generates a transaction you review and sign in your wallet.

TECHNICAL APPROACH

This tool interacts with data provenance contracts using ethers v5.7.2. It calls registerData(), transferOwnership(), verifyProvenance(), getDataRecord(), getRecordCount(), getProvenanceConfig(), updateConfig(), and getLastUpdateTime() on the provenance contract to manage and query provenance state. Data is registered with an ID, hash, name, originator, and metadata, creating an immutable record on-chain. Transfers update the owner while preserving the provenance chain. All RPC calls are wrapped in a robust error handler that extracts the actual failure reason from Ethers error objects, digging three levels deep to avoid showing "[object Object]" when a transaction reverts. Transaction costing uses receipt.effectiveGasPrice post-EIP-1559 rather than tx.gasPrice, which overstates actual spend.

WHAT IT CANNOT SEE

This tool cannot verify off-chain data origin or guarantee that provenance records are complete. It cannot detect if the data was altered before registration. It cannot verify the identity of the data originator beyond the on-chain address. It cannot see off-chain data content or metadata not stored on-chain. It cannot guarantee that the provenance chain is complete or that all transfers were recorded. The tool provides provenance tracking based on on-chain data, but it does not guarantee that the data origin is authentic or that the records are complete.

PLEASE NOTE

This tool supports EVM‑compatible chains only (Ethereum, Goerli, Sepolia, Arbitrum, Optimism, Polygon). Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, and XRP are not supported. This is a read‑write tool that requires signing transactions—always verify the provenance contract address, data ID, and owner before approving. No contract addresses are hardcoded; you paste the contracts you are managing. The tool is free and open under the BotGentz PLAYBOOK‑C specification.