a6868e5836
- Create docs/contracts/HARDHAT_VERSION_INVESTIGATION.md - Explain why contracts/ uses Hardhat 2.22.0 and aitbc-token uses 3.3.0 - Document primary blocker: OpenZeppelin v4 → v5 migration - Document secondary blockers: plugin compatibility - Provide upgrade path if unification is desired later - Recommend maintaining two versions for now
AITBC Contract Documentation
Level: Advanced
Prerequisites: Beginner blockchain concepts, AITBC project documentation, and basic smart contract familiarity
Estimated Time: 20-40 minutes
Last Updated: 2026-04-27
Version: 1.0
🧭 Navigation Path:
🏠 Documentation Home → 📜 Contracts → You are here
breadcrumb: Home → Contracts → Overview
🎯 See Also:
- ⛓️ Blockchain Docs: Blockchain Documentation - Core chain implementation and operations
- 🔒 Security Docs: Security Documentation - Security and verification context
- 📋 Project Overview: Project Documentation - Project-level architecture and workflow
- 🧪 Testing Docs: Testing Documentation - Validation and verification procedures
📚 Available Content
This directory contains documentation for AITBC smart contracts:
- ZK-VERIFICATION.md - End-to-end ZK receipt verification guide
- PNPM_SETUP.md - pnpm package manager configuration and usage
Use ZK-VERIFICATION.md when you need to:
- Understand the off-chain proof generation flow
- Review the on-chain verifier contract interface
- Integrate receipt verification with the coordinator API
- Validate settlement flows that depend on ZK proofs
Use PNPM_SETUP.md when you need to:
- Set up the development environment with pnpm
- Understand package manager configuration
- Troubleshoot dependency issues
- Run build and test commands
🔗 Where to go next
📊 Quality Metrics
- Structure: 10/10 - Clear single-topic landing page.
- Content: 10/10 - Points directly to the contract verification guide.
- Navigation: 10/10 - Links to adjacent blockchain, security, and testing docs.
- Status: Active index page.
Last updated: 2026-04-27
Version: 1.0
Status: Active index for contract documentation