Smart Contract Timestamping

WHAT IT DOES

Smart Contract Timestamping gives legal professionals, developers, and individuals a powerful tool for timestamping documents on-chain with immutable proof of existence. It reads live on-chain data including timestamp records, document hashes, block timestamps, transaction data, verification status, and contract state. You can timestamp documents, verify timestamps, manage timestamp configurations, and export timestamp records. The tool shows you in real time the document hash, timestamp count, verification status, block timestamp, signer, and active status—so you can prove when a document existed at a specific point in time.

HOW TO USE

Connect your EVM wallet (must be the contract owner or authorized address). Enter the timestamp contract address, document hash (keccak256), document name/description, optional metadata JSON, and record ID for lookup. Use "Check timestamp state" to see the timestamp count, last timestamp time, active status, and verification status for a specific hash or record ID. Click "Timestamp document" to create an immutable timestamped proof of the document's existence. Use "Verify timestamp" to check if a document hash has been timestamped and view its details. "Update config" changes active status and max size. "Export timestamp" downloads the record as JSON. Each action generates a transaction you review and sign in your wallet.

TECHNICAL APPROACH

This tool interacts with smart contract timestamping contracts using ethers v5.7.2. It calls timestamp(), verifyTimestamp(), getTimestamp(), getTimestampById(), getTimestampCount(), getTimestampConfig(), updateConfig(), and getLastTimestampTime() on the timestamp contract to manage and query timestamp state. Documents are timestamped by storing their keccak256 hash on-chain with the block timestamp and optional metadata. Verification checks the hash against the stored record and returns the signer and timestamp. 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 the content or authenticity of off-chain documents. It cannot guarantee that the timestamp matches the actual creation time of the document. It cannot detect if the document was altered after timestamping (the hash would change). It cannot verify the identity of the document signer beyond the on-chain address. It cannot see off-chain document content or metadata not stored on-chain. The tool provides proof of existence and timestamping, but it does not guarantee that the document itself is authentic or that the timestamp reflects the actual creation time.

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 timestamp contract address, document hash, and metadata 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.