{"id":44672384,"url":"https://github.com/bettergovph/govchain","last_synced_at":"2026-02-15T02:13:05.399Z","repository":{"id":318345897,"uuid":"1069513309","full_name":"bettergovph/govchain","owner":"bettergovph","description":"A foundational blockchain platform designed to store and manage government datasets with complete transparency.","archived":false,"fork":false,"pushed_at":"2025-12-14T20:52:39.000Z","size":1566,"stargazers_count":15,"open_issues_count":3,"forks_count":6,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-17T08:57:30.694Z","etag":null,"topics":["blockchain","website"],"latest_commit_sha":null,"homepage":"https://govchain.bettergov.ph","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bettergovph.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-04T04:38:24.000Z","updated_at":"2025-12-14T20:52:43.000Z","dependencies_parsed_at":"2025-10-06T17:46:14.359Z","dependency_job_id":null,"html_url":"https://github.com/bettergovph/govchain","commit_stats":null,"previous_names":["bettergovph/govchain"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bettergovph/govchain","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bettergovph%2Fgovchain","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bettergovph%2Fgovchain/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bettergovph%2Fgovchain/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bettergovph%2Fgovchain/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bettergovph","download_url":"https://codeload.github.com/bettergovph/govchain/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bettergovph%2Fgovchain/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29465435,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-15T01:01:38.065Z","status":"online","status_checked_at":"2026-02-15T02:00:07.449Z","response_time":118,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blockchain","website"],"created_at":"2026-02-15T02:13:04.828Z","updated_at":"2026-02-15T02:13:05.393Z","avatar_url":"https://github.com/bettergovph.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OpenGovChain: Decentralized Government Transparency Platform\n\n[![Status](https://img.shields.io/badge/Status-Pre--launch-yellow.svg)]()\n\nA base blockchain platform for government transparency - tokenless by default, extensible with custom modules for tokenomics, governance, and blockchain utilities.\n\n## 🎯 Mission\n\nOpenGovChain is a foundational blockchain platform designed to store and manage government datasets with complete transparency. Built on Cosmos SDK, it provides a base layer that agencies can extend with custom modules for tokenomics, governance, financial transactions, and other blockchain utilities based on their specific needs.\n\n## 🌟 Key Features\n\n### Flexible \u0026 Extensible Architecture\n- **Tokenless by Default**: No economic barriers to start - anyone can participate\n- **Optional Tokenomics**: Easily add custom tokens, staking, or economic models when needed\n- **Modular Design**: Built on Cosmos SDK for easy extension and customization\n- **Public Good Focus**: Core platform designed for transparency, not profit\n\n### Government Data Management\n- **Immutable Records**: Government datasets stored permanently on blockchain\n- **IPFS Integration**: Efficient file storage with content addressing\n- **Rich Metadata**: Comprehensive dataset information and categorization\n- **Query Capabilities**: Search by agency, category, and file type\n\n### Decentralized \u0026 Extensible Network\n- **Cosmos SDK**: Built on proven, modular blockchain technology\n- **Validator Network**: Volunteer nodes secure the network (can be extended with staking)\n- **IBC Compatible**: Connect to other Cosmos chains and ecosystems\n- **Open Source**: Fully transparent and auditable code\n- **Extensible**: Add governance, smart contracts, DeFi, or custom modules\n\n## 🏗️ Architecture\n\nOpenGovChain combines three powerful technologies:\n\n1. **Cosmos Blockchain** - Immutable registry of dataset metadata and provenance\n2. **IPFS** - Distributed file storage with content addressing\n3. **ChromaDB Vector DB** - AI-powered semantic search\n\n### System Components\n\n```\n┌─────────────┐     ┌──────────────┐     ┌─────────────┐\n│             │────▶│   Indexer    │────▶│  Blockchain │\n│  (Web UI)   │     │ (REST API)   │     │ (Metadata)  │\n└─────────────┘     └──────────────┘     └─────────────┘\n       │                    │                    │\n       ▼                    ▼                    ▼\n┌─────────────┐     ┌──────────────┐     ┌─────────────┐\n│    IPFS     │     │   ChromaDB   │     │    IPFS     │\n│  (Storage)  │◀───│  (Vectors)   │     │  (Storage)  │\n└─────────────┘     └──────────────┘     └─────────────┘\n```\n\n## 🚀 Quick Start\n\nThis repository only includes the setup script for creating a new chain and a sample web application to browse and interact with the chain.\n\nFor running a node, please check https://github.com/bettergovph/govchaind\n\n### Prerequisites\n\n- Ubuntu 20.04+ / macOS / WSL2\n- 8 GB RAM minimum\n- 50 GB free disk space\n\n### Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/bettergovph/govchain.git\ncd govchain\n\n# Install prerequisites\nchmod +x scripts/install-prerequisites.sh\n./scripts/install-prerequisites.sh\n\n# Restart terminal or reload shell\nsource ~/.bashrc\n```\n\n### Run Local Development Environment\n\n```bash\n# Terminal 1: Start blockchain\ncd ~/govchain-blockchain\n\nignite chain build # Build/rebuild the blockchain binary\nignite chain serve\n\n# Terminal 2: Start IPFS\nipfs init\nipfs daemon\n```\n\n### Run Web Application Manually\n\n```bash\n# Terminal 3: Start indexer (optional)\ncd indexer-node\nnpm install\nnpm start\n\n# Terminal 4: Start web application\ncd web\nnpm install\nnpm run dev\n```\n\n### Run Web Application using Docker\n\n```bash\ndocker compose up -d\n```\n\nVisit `http://localhost:3000` to access the web interface.\n\n## 📚 Documentation\n- [Getting Started](docs/blockchain/GETTING_STARTED.md)\n- [Chain README](docs/blockchain/README.md)\n- [Technical Implementation](docs/blockchain/TECHNICAL_IMPLEMENTATION.md) - Development guide\n- [Volunteer Node Guide](docs/blockchain/VOLUNTEER_NODE_GUIDE.md) - Run a node\n- [Extensibility Guide](docs/EXTENSIBILITY.md) - **NEW!** Add governance, tokens, and custom features\n- [Blockchain Explorer](docs/BLOCKCHAIN_EXPLORER.md) - Explorer documentation\n\n## 🛠️ Development\n\n### Project Structure\n\n```\ngovchain/\n├── indexer-node/          # Vector search service\n│   └── src/               # Node.js application\n├── web/                   # Next.js frontend\n│   ├── src/app/           # Next.js app router\n│   └── src/components/    # React components\n├── scripts/               # Helper scripts\n└── docs/                  # Documentation\ngovchain-blockchain/   # Cosmos blockchain (created by init script)\n├── x/datasets/        # Custom datasets module\n├── proto/             # Protocol buffers\n└── cmd/               # CLI binaries\n```\n\n### Key Technologies\n\n- **Blockchain**: Cosmos SDK with entry-based storage\n- **Storage**: IPFS (Kubo)\n- **Search**: ChromaDB vector database, OpenAI embeddings\n- **Backend**: Node.js, Next.js API routes\n- **Frontend**: Next.js with React and TypeScript\n\n## 🌟 Features\n\n### ✅ Dataset Management\n- Upload datasets to IPFS\n- Register metadata on blockchain\n- Automatic checksum verification (SHA-256)\n- Immutable audit trail\n\n### ✅ Data Discovery\n- Semantic search with natural language\n- Filter by agency, category, date\n- Find similar datasets\n- Browse by category\n\n### ✅ Data Retrieval\n- Download from any IPFS gateway\n- Verify file integrity via blockchain\n- Multiple redundant copies\n- No single point of failure\n\n### ✅ Transparency \u0026 Trust\n- Immutable dataset history\n- Public verification\n- Track data replication\n- Open-source codebase\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n## 🔒 Security\n\n- **Blockchain**: Tendermint BFT consensus, 2/3+ validator agreement\n- **Data Integrity**: SHA-256 checksums, content-addressed storage\n- **Access**: Public read access, verified agency uploads\n- **Privacy**: No personal data on-chain\n\nReport security issues to: volunteers@bettergov.ph\n\n## 🌐 Community\n\n- **Website**: https://bettergov.ph\n- **GitHub**: https://github.com/bettergovph/govchain\n- **Discord**: https://discord.gg/bettergovph\n\n## 🔧 Extensibility\n\nOpenGovChain is a **base platform** that agencies can extend with additional modules:\n\n### ✅ Native Extensions (Built-in to Cosmos SDK)\n- **Governance Module** (`x/gov`): On-chain voting, proposals, and democratic decision-making\n- **Token Economics** (`x/bank`, `x/staking`, `x/mint`): Custom tokens, staking, rewards\n- **IBC Integration**: Cross-chain communication with 50+ Cosmos chains\n- **Financial Transactions** (`x/bank`, `x/feegrant`): Payments, transfers, fee grants\n- **Custom Modules**: Build agency-specific features using Cosmos SDK framework\n\n### 🔧 Available Integrations (Require Setup)\n- **Smart Contracts** (CosmWasm): Deploy Rust-based contracts (widely adopted, battle-tested)\n- **Advanced DeFi**: Integrate third-party modules (e.g., Umee lending, Osmosis DEX)\n\n### ⚙️ Requires Custom Development\n- **Escrow Services**: Custom module development\n- **Complex Loan Management**: Build or integrate third-party modules\n- **Agency-Specific Features**: Custom module development\n\n### Cosmos SDK Ecosystem\nLeverage the modular Cosmos SDK:\n- `x/gov` - On-chain governance ✅\n- `x/staking` - Proof of Stake consensus ✅\n- `x/bank` - Token transfers ✅\n- `x/distribution` - Reward distribution ✅\n- `x/authz` - Authorization grants ✅\n- `x/feegrant` - Fee allowances ✅\n- CosmWasm - Smart contract platform (integration required)\n- IBC - Inter-blockchain communication ✅\n\n## 💡 Why OpenGovChain?\n\n### Traditional Government Data Portals:\n- ❌ Can be censored or taken offline\n- ❌ Can be tampered with\n- ❌ Have single points of failure\n- ❌ Require trust in centralized operators\n- ❌ Limited to basic data storage\n\n### OpenGovChain:\n- ✅ Cannot be censored (distributed worldwide)\n- ✅ Cannot be tampered with (cryptographic verification)\n- ✅ Cannot go offline (redundant copies)\n- ✅ Requires no trust (open-source, verifiable)\n- ✅ Extensible with governance, tokens, and custom features\n- ✅ Built on proven Cosmos SDK technology\n\n## 🚀 For Agencies\n\n### Start Simple, Extend as Needed\n\n1. **Deploy Base Platform**: Start with tokenless data transparency\n2. **Add Governance**: Enable community voting and proposals\n3. **Introduce Tokens**: Add economic incentives when ready\n4. **Build Custom Features**: Extend with agency-specific modules\n5. **Connect to Ecosystem**: Use IBC to interact with other chains\n\n### Example Use Cases\n\n**Basic Deployment**:\n- Government dataset transparency\n- Immutable record keeping\n- Public data access\n\n**With Governance**:\n- Citizen voting on budget allocations\n- Proposal-based policy changes\n- Democratic decision-making\n\n**With Tokenomics**:\n- Incentivize data contributions\n- Reward validators and participants\n- Enable marketplace features\n\n**With Financial Modules**:\n- Government disbursements\n- Transparent fund tracking\n- Loan and grant management\n- Procurement and payments\n\n---\n\n**Built with ❤️ for democratic accountability in the digital age**\n\n## 📜 License\n\nThis project is open source and available under the MIT License. See LICENSE file for details.\n\n---\n\n**OpenGovChain by BetterGov.ph**: A foundational blockchain platform for government transparency - extend it to meet your needs.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbettergovph%2Fgovchain","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbettergovph%2Fgovchain","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbettergovph%2Fgovchain/lists"}