Ai-West-Africa/aiwa-consentchain

A secure, end-to-end pipeline for immutably logging Mandinka audio submissions to the Polygon blockchain. This system integrates WordPress (Forminator), Google Cloud Storage (GCS), HashiCorp Vault, and custom smart contracts to ensure each recording is hashed, stored, and transparently verified on-chain. # AiWA ConsentChain Secure, blockchain-based logging of West African Language oral submissions using WordPress, GCS, Vault, and Polygon. ## 🔍 Overview AiWA RecordChain is an auditable, end-to-end pipeline that captures, verifies, and immutably logs audio submissions for the AiWA (Ai West Africa) language preservation project. Built for long-term data integrity and ethical transparency, this system ensures every oral history is: - Collected via WordPress (Forminator) - Uploaded to Google Cloud Storage (GCS) - Hashed (SHA-256) for integrity - Logged immutably to the Polygon blockchain (Mumbai → Mainnet) - Secured using HashiCorp Vault for secrets management All data is cross-linked back to WordPress as a Custom Post Type with associated metadata. --- ## 🧱 Architecture - **Frontend**: WordPress + Forminator - **Storage**: Google Cloud Storage (GCS) - **Blockchain**: Custom Solidity contract deployed to Polygon - **Secrets**: Managed via HashiCorp Vault (AppRole auth) - **Plugin**: All custom logic lives in a dedicated WordPress plugin --- ## ✅ Phase 1 Scope (Testnet MVP) - Deploy MandinkaRecordingLog.sol to Polygon Mumbai - Trigger contract logging from Forminator hook - Store SHA-256 hashes + GCS URI + Tx hash in WordPress - Fetch RPC, GCP, and wallet secrets from Vault via Human Made plugin --- ## 📂 Repository Structure wp-content/plugins/aiwa-recordchain/ ├── contracts/ # Solidity contracts (e.g., MandinkaRecordingLog.sol) ├── src/ │ ├── blockchain.php # Web3 calls to Polygon │ ├── gcs.php # GCS upload logic │ ├── hash.php # SHA-256 hash generation │ ├── vault.php # Vault integration │ └── form-handler.php # Hook from Forminator submission ├── cron/ # Tx confirmation polling logic ├── assets/ ├── aiwa-recordchain.php # Main plugin loader ├── README.md ├── .gitignore └── LICENSE.md --- ## 🛡 License > Ai WEST AFRICA (AiWA) CONFIDENTIAL © 2023–2025 Ai West Africa (AiWA), a project of Cellular Vibrations and MaximillianGroup. All Rights Reserved. See `LICE …