Supply Chain Traceability

WHAT IT DOES

Supply Chain Traceability gives manufacturers, logistics providers, auditors, and consumers a comprehensive tool for tracking products through the supply chain. It reads live on-chain data including product records, batch information, location history, custody transfers, timestamp data, signer addresses, and contract state. You can register products, update custody, record location changes, verify product authenticity, and export traceability records. The tool shows you in real time the product ID, name, batch, current location, custodian, record count, verification status, and active status—so you can ensure supply chain transparency and prove product provenance.

HOW TO USE

Connect your EVM wallet (must be the contract owner or authorized address). Enter the traceability contract address, product ID, product name, batch ID, current location, custodian address, and metadata JSON. Use "Check trace state" to see the product count, last update time, active status, and verification status for a specific product ID. Click "Register product" to create a new product record. Use "Update custody" to transfer custody to a new custodian. "Record location" updates the product's current location. "Verify product" checks if a product exists and displays its full history. "Export trace" downloads the records as JSON. Each action generates a transaction you review and sign in your wallet.

TECHNICAL APPROACH

This tool interacts with supply chain traceability contracts using ethers v5.7.2. It calls registerProduct(), updateCustody(), recordLocation(), verifyProduct(), getProductRecord(), getProductCount(), getTraceConfig(), updateConfig(), and getLastUpdateTime() on the traceability contract to manage and query supply chain state. Products are registered with an ID, name, batch, and metadata. Custody transfers and location updates create immutable records while preserving the product's history. 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 product authenticity or guarantee that physical goods match on-chain records. It cannot detect if the physical product has been tampered with or replaced. It cannot verify the identity of the custodian beyond the on-chain address. It cannot see off-chain product content or metadata not stored on-chain. It cannot guarantee that the supply chain records are complete or that all transfers were recorded. The tool provides supply chain tracking based on on-chain data, but it does not guarantee that the physical product matches the records 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 traceability contract address, product ID, and custodian 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.