Cryptographic proof of content authenticity using blockchain technology
Contract Address: 0x5B77EC60D5a81c07E3601f5d268e86de6CD24d84
Truth Stamped is an open-source solution for combating AI deepfakes and synthetic content. Instead of trying to detect fake content, we enable creators to prove authenticity through immutable blockchain timestamps and cryptographic signatures.
- AI-generated deepfakes are indistinguishable from authentic content
- Detection systems are in an endless arms race with generators
- Watermarks can be stripped or manipulated
- No universal way to verify content origin
Shift from "detect bad" to "verify good"
- Content creators hash their authentic content at creation
- Hash is signed and timestamped on blockchain (Base)
- Anyone can verify authenticity by checking the blockchain
- Unsigned content defaults to "unverified"
- ✅ Simple CLI: One command to stamp, one to verify
- ✅ Cryptographically Secure: SHA-256 hashing + ECDSA signatures
- ✅ Immutable: Blockchain provides tamper-proof timestamps
- ✅ Low Cost: ~$0.001 per stamp on Base L2
- ✅ Open Source: MIT licensed, transparent, verifiable
- ✅ Live on Testnet: Deployed and functional on Base Sepolia
- Node.js >= 18.0.0
- Testnet ETH on Base Sepolia (Get from faucet)
# Clone the repository
git clone https://github.com/ebenbaruk/truth-stamped.git
cd truth-stamped/cli
# Install dependencies
npm install
# Build the CLI
npm run buildnode dist/index.js initnode dist/index.js stamp photo.jpgnode dist/index.js verify photo.jpgnode dist/index.js list┌─────────────┐
│ Creator │
└──────┬──────┘
│ 1. Capture content
│ 2. Generate SHA-256 hash
│ 3. Sign with private key
▼
┌─────────────────┐
│ CLI Tool │
└──────┬──────────┘
│ 4. Submit to Base blockchain
▼
┌─────────────────┐
│ Smart Contract │
│ Base Sepolia │
│ │
│ Stores: │
│ - Content hash │
│ - Creator │
│ - Timestamp │
│ - Signature │
└─────────────────┘
▲
│ 5. Anyone can verify
│
┌──────┴──────┐
│ Verifier │
└─────────────┘
- Journalists: Prove authenticity of field photography
- Content Creators: Protect original work from AI impersonation
- News Organizations: Verify authenticity of submitted content
- General Public: Check if viral content is authentic
- Blockchain: Base Sepolia (Testnet) / Base (Mainnet ready)
- Smart Contract: Solidity 0.8.20
- CLI: TypeScript/Node.js 18+
- Storage: On-chain hashes, off-chain content
- Cost: ~$0.001 per stamp
truth-stamped/
├── smart-contract/ # Solidity smart contracts
│ ├── src/ # Contract source
│ ├── test/ # Test suite (12 tests)
│ └── script/ # Deployment scripts
├── cli/ # TypeScript CLI tool
│ ├── src/ # CLI source code
│ │ ├── commands/ # CLI commands
│ │ └── utils/ # Utilities
│ └── test-*.js # Test scripts
├── DEPLOYMENT.md # Deployment information
├── CONTRIBUTING.md # Contribution guide
└── README.md # This file
- Status: Live and functional
- Contract:
0x5B77EC60D5a81c07E3601f5d268e86de6CD24d84 - Network: Base Sepolia (Chain ID: 84532)
- Deployer:
0x5A9B097272a089df401D6dA8aCBb543e24bEeCF3
See DEPLOYMENT.md for detailed deployment information.
- Status: Planned after security audit
- Contract: Not deployed yet
✅ Production Ready on Base Sepolia Testnet
- ✅ Smart contract deployed and verified
- ✅ CLI tool fully functional
- ✅ All tests passing (12/12)
- ✅ End-to-end workflow tested
- ✅ Documentation complete
- ✅ Open source released
Run the complete test workflow:
cd cli
node test-workflow.js # Test contract interaction
node test-stamp.js # Test stamping operationOr test individual CLI commands:
# Verify a file
node dist/index.js verify ../test-image.txt
# List stamps by address
node dist/index.js list --address 0x5A9B097272a089df401D6dA8aCBb543e24bEeCF3Initialize wallet for Truth Stamped
node dist/index.js init [--import]Stamp content on the blockchain
node dist/index.js stamp <file> [--metadata <text>] [--network <mainnet|sepolia>]Verify content on the blockchain
node dist/index.js verify <file>
node dist/index.js verify --hash <hash>List all stamps by your wallet
node dist/index.js list [--address <addr>] [--network <mainnet|sepolia>]We welcome contributions! Please see our Contributing Guide for details.
Areas for contribution:
- Web interface for verification
- Browser extension
- Mobile app
- Additional blockchain support
- Documentation improvements
- ✅ Smart contract on Base Sepolia
- ✅ CLI tool with all core features
- ✅ Documentation and examples
- ✅ Production ready on testnet
- Security audit
- Deploy to Base mainnet
- NPM package publication
- Web verification interface
- Browser extension
- Mobile SDK
- Multi-chain support (Ethereum, Polygon)
- Integration guides
- Trust networks and reputation
- Bulk operations API
- Hardware wallet support
- Camera/device integration
- ✅ Private keys stored locally (encrypted)
- ✅ Industry-standard cryptography (SHA-256, ECDSA)
- ✅ Open source for transparency and auditing
- 🔜 Professional security audit planned
Security Considerations:
- Never share your private key
- Always verify contract addresses
- Test on Sepolia before mainnet
- Keep your wallet password secure
Base Sepolia (Testnet):
- Contract deployment: ~0.003 ETH (free testnet ETH)
- Stamp content: ~$0.001 equivalent
- Verify content: Free (read-only)
Base Mainnet (Production):
- Expected: ~$0.001 per stamp
- Verification: Always free
MIT License - see LICENSE for details
- Live Contract: View on Basescan
- Deployment Info: DEPLOYMENT.md
- Smart Contract: smart-contract/
- CLI Source: cli/
- Issues: GitHub Issues
Need help? Have questions?
- 📖 Read the documentation
- 🐛 Report bugs via GitHub Issues
- 💬 Start a Discussion
- 🔗 View the live contract
To use Truth Stamped on Base Sepolia, get free testnet ETH:
Made with transparency, for authenticity 🔐
Built on Base - Bringing the next billion users onchain