
Skyocean MVP Development Guideline
This document provides a base guideline for building a functional MVP for the Skyocean platform. The MVP is designed to demonstrate key interoperability features—including ERP data conversion, DKG EDGE node integration, smart contract triggers on a testnet (using Sepolia), simulated customs clearance for the USA and Ghana (our pilot programs), and off-chain payment flows with banks—all integrated via a unified dashboard UI.
Note: While our full Web3 vision encompasses a unified ecosystem that integrates Data Verification & Traceability, Transaction Automation & Community Engagement, and Supply Chain Management, this MVP focuses on a minimal demonstration of these core features. Developers are encouraged to innovate and use alternative methods to achieve these outcomes, while the MVP remains a simplified proof-of-concept for initial validation and investor demonstrations.
1. Project Overview
Objective
- Core Vision: Create an MVP that demonstrates a unified Web3 ecosystem built on three core pillars:
Data Verification & Traceability
Use OriginTrail DKG (v8) to verify and track supply chain data by converting documents (e.g., PDFs) into standardized JSON-LD Knowledge Assets (KAs) that adhere to recognized standards (e.g., GS1/EPCIS).
Transaction Automation & Community Engagement
Leverage blockchain (e.g., Polygon/Sepolia) for trade execution, token-based staking, financing, and other token utilities. Smart contracts will trigger actions (such as releasing funds) when conditions (e.g., document approvals) are met.
Supply Chain Management
Integrate an ERP or SCM module (e.g., ERPNext) to manage the entire trade lifecycle—from order initiation to document management, logistics tracking, and financial processing.
Simplified Explanation:
Combine verified data, automated blockchain transactions, and robust supply chain management into one cohesive platform
that delivers transparency, efficiency, and trust across global trade operations.
MVP Scope:
The MVP will focus on demonstrating the key interoperability aspects (data conversion, smart contract triggers, simulated customs clearance, and off-chain payment flows) rather than implementing every feature of the full Web3 vision. This minimal version will be sufficient to prove the concept, attract funding, and serve as the foundation for future expansion.
2. Architecture & Integration Overview
A. ERP Integration (ERPNext)
- Setup: Deploy a minimal ERPNext instance with an Aviation Trading module. Populate the system with sample trade transactions that include key fields (e.g., transaction ID, part numbers, shipping documents, certification details).
-
Data Mapping & Conversion:
Define how ERPNext fields convert into our canonical JSON-LD schema.
Develop scripts (using Python, Node.js, etc.) that extract data from ERPNext, transform it into JSON-LD, and forward it to the DKG via the EDGE node API.
transaction_id → @id
part_number → productID
certification_status → certificationStatus
B. DKG EDGE Node Integration (DKGv8)
- EDGE Node Setup: Install and configure the DKGv8 EDGE node per the official documentation. Leverage its out-of-the-box customizable UI and built-in PDF-to-JSON-LD conversion feature.
- API & RAG/Mining Integration: Utilize the RAG and mining APIs to query and display live data from the DKG and own paranets. Ensure the EDGE node accepts JSON-LD inputs from your ERP conversion scripts and returns validated KAs with unique identifiers.
C. Blockchain Integration (Sepolia Testnet)
-
Smart Contract Development: Develop and deploy minimal smart contracts on the Sepolia testnet that include:
- A function to lock tokens or funds upon trade initiation.
- A trigger function to release tokens when conditions (e.g., document approvals) are met.
- Event logging to capture and display when shipping documents are complete and the smart contract is executed.
- Trigger Mechanism: Integrate an API endpoint that is called once final document approvals are confirmed. This endpoint will trigger the smart contract function.
D. Customs Clearance & Off-Chain Payment Simulation
-
Customs API Simulation: Develop lightweight REST API endpoints that simulate customs clearance workflows.
Example (USA):
Endpoint:/api/customs/usa/clearance
Accepts a JSON payload representing a trade transaction and returns a simulated clearance status. -
Bank Payment API Simulation: Build a dummy off-chain payment API to mimic bank payment confirmations once smart contract conditions are met.
Example Endpoint:
/api/payments/offchain
Returns a confirmation status for the simulated payment.
3. User Interface (UI) & Experience
A. Dashboard Design
Framework: Build a responsive single-page application (SPA) using React.js that integrates with ERP, DKG, blockchain, customs, and payment APIs.
Key UI Components:
- Trade Overview Panel
- Document Status Panel
- Smart Contract Event Log
- Customs Clearance Module
- Off-Chain Payment Module
- Integration Alerts
UI Suggestions: Leverage customizable UI components provided by DKGv8. Use clear call-to-action buttons for manual document uploads and test triggers. Integrate charts or progress bars to visualize the trade lifecycle.
4. MVP Test Scenarios & Workflow
A. End-to-End Test Scenario
- Trade Initiation: Create a sample transaction in ERPNext. Extract and convert ERP data into JSON-LD.
- Document Upload & Conversion: Upload shipping documents (e.g., commercial invoice, bill of lading, certificate of origin) via the DKG EDGE node UI. The EDGE node converts PDFs into JSON-LD and creates Knowledge Assets.
- Document Verification & Approval: Upon final approval, automatically trigger the smart contract function.
- Smart Contract Trigger & Token Release: The smart contract on Sepolia is triggered to lock/release tokens and/or initiate off-chain payment. Log the event and display it in the UI.
- Customs Clearance Simulation: Send a simulated clearance request to the USA or Ghana customs API. Display the returned clearance status on the dashboard.
- Off-Chain Payment Simulation: Trigger a simulated off-chain payment request to the bank API upon smart contract execution. Display the payment confirmation on the dashboard.
B. Minimal Test Scenario (If Full Integration Is Too Extensive)
Core Demonstration: Create a sample trade record, manually upload shipping documents via the EDGE node UI, demonstrate the document-to-KA conversion, manually trigger a smart contract, and show customs/payment simulations with preconfigured responses.
5. Deployment & Budget Considerations
- Hosting & Infrastructure: Use open-source ERPNext and DKGv8 components to minimize costs. Deploy on a small cloud instance or VPS for demonstration purposes. Utilize testnets (e.g., Sepolia).
- Development Tools: Leverage existing development frameworks.
- Documentation & Version Control: Maintain all integration scripts, UI code, and API endpoints in a version-controlled repository (e.g., GitHub). Ensure comprehensive documentation for each module.
6. Final Steps & Recommendations
6.1 Final Vision
The ultimate goal of the Skyocean platform is to create a unified Web3 ecosystem that seamlessly integrates:
- Data Verification & Traceability: Leveraging OriginTrail DKG (v8) to standardize and verify supply chain documents as JSON-LD Knowledge Assets.
- Transaction Automation & Community Engagement: Utilizing blockchain technology (via smart contracts on testnets like Sepolia) to automate trade execution, token-based staking, financing, and governance.
- Supply Chain Management: Integrating an ERP/SCM module (e.g., ERPNext) to manage the entire trade process—from order initiation to document management, logistics, and financial processing.
In simple terms, we aim to combine verified data, automated blockchain transactions, and robust supply chain management into one cohesive platform that offers transparency, efficiency, and trust across global trade.
6.2 MVP Goals
- ERP to DKG Integration: Extract sample trading data from ERPNext and convert it into JSON-LD Knowledge Assets via the DKG EDGE node.
- Smart Contract Automation on a Testnet: Deploy minimal smart contracts on Sepolia to simulate token locking/release based on document approvals.
- Simulated Interoperability: Develop REST API endpoints to simulate customs clearance (USA and Ghana) and dummy off-chain payment confirmations.
- Unified Dashboard UI: Create a React.js dashboard that integrates and displays data from ERP, DKG, smart contracts, and simulated customs/payment APIs.
6.3 Flexibility in Implementation
Developers are encouraged to innovate as long as they meet the core objectives: data verification, automated blockchain triggers, and basic supply chain management.
6.4 Iterative Testing and Documentation
- Iterative Development: Begin with minimal test scenarios and validate each integration step. Then add in more features.
- Robust Documentation: Maintain version-controlled documentation covering mapping logic, ontology definitions, integration scripts, and API endpoints.
- Comprehensive Logging: Implement detailed logging at every integration step to aid in troubleshooting and performance tuning.
6.5 Stakeholder Communication
- Demonstration and Feedback: Organize regular MVP walkthroughs with internal stakeholders and potential investors. Use the unified dashboard to showcase real document flows, KA creation, smart contract triggers, and simulated customs/payment integrations.
- Clear Value Proposition: Emphasize that the MVP demonstrates the integration of verified data, automated blockchain operations, and supply chain management, even if it’s a minimal representation.
Conclusion
This guideline provides a basic roadmap for developing a functional MVP for the Skyocean platform. By showcasing end-to-end document verification, testnet-based contract triggers, simulated customs/payment flows, and a unified UI, the MVP will validate core functionalities and attract the initial support needed to move toward a full-scale Web3 solution. Developers are encouraged to adapt and refine these guidelines as necessary, focusing on delivering a compelling demonstration of the platform’s core capabilities.