Technical Documentation
Demo ID: demo-2025-005 Version: 1.0.0 Last Updated: August 2025
Overview
Natural Chain is a blockchain-based application for capturing natural gas-related environmental data on the Bitcoin SV blockchain. It ensures data integrity and supports carbon credit creation through tokenization and immutable record-keeping.
Features
Immutable blockchain records for natural gas lifecycle data
Token-based system for carbon credit creation and tracking
Web-based dashboard for monitoring and data entry
Real-time transparency and audit logging
Integration with Bitcoin SV blockchain for secure anchoring
System Architecture
Frontend (TypeScript, React)
User interface for environmental data capture and visualization
Token and carbon credit management dashboard
Real-time updates of blockchain status related to data entries
Backend (Node.js, Express)
REST APIs for data submission, token issuance, and queries
Blockchain integration to anchor data on BSV network
Database management for metadata and off-chain information
Quick Start
Prerequisites
Node.js and npm installed
Familiarity with BSV blockchain basics
Running Locally
npm i
npm run devOpen http://localhost:3000 in a browser to access the application.
Usage Guide
Capture natural gas lifecycle data including extraction, transportation, and usage metrics
Generate and manage tokens representing carbon credits based on certified data
Monitor and audit all records through an intuitive web interface and blockchain verification
API Endpoints
Data submission and retrieval endpoints
Token issuance and transfer APIs
Blockchain proof verification services
(See src/routes directory for detailed API code)
Security Features
Blockchain immutability guarantees data integrity
Tokenization prevents fraudulent issuing of carbon credits
Secure authentication and authorization for data access
Testing & Validation
Unit and integration tests for API and blockchain interaction
Manual testing for UI workflows and token lifecycle
Performance & Scalability
Scalable backend architecture with Node.js and MongoDB
Efficient blockchain integration for frequent anchoring
Designed for extensibility with other environmental data sources
Troubleshooting & Support
Check logs for API and blockchain errors
Validate blockchain connectivity and transaction status
Use issue tracker on GitHub for reporting
Resources
Business Documentation: business-natural-chain.md
Repository: GitHub - bsv-blockchain-demos/natural-chain
Demo URL: Natural Chain Site
For business context and detailed workflows, see the business document.
Last updated