Stone.proof is a modular, decentralized mineral traceability platform built on Base Layer 2. It empowers supply chain actors to register, validate, and trade mineral assets with integrity, verifiable origin, and strict access control.
Built for security, scale, and enterprise reliability.
The mineral industry faces significant challenges with traceability, transparency, and trust across its supply chain. A lack of verifiable data and secure tracking systems has led to widespread fraud, misreporting, and illicit trade of minerals—undermining both industry integrity and national economies. These issues hinder responsible sourcing and erode confidence among stakeholders, from miners and refiners to regulators and buyers.
Stone.proof addresses this critical gap by leveraging blockchain technology to ensure end-to-end traceability, immutable recordkeeping, and transparent transactions across the mineral supply chain. By fostering trust and accountability, stone.proof empowers industries and governments to combat mineral fraud, enhance compliance, and ultimately strengthen economic growth.
- Overview
- Key Features
- Role-Based Portals
- Access Control
- Smart Contracts
- Project Structure
- Tech Stack
- How It Works
- Demo (Coming Soon)
- License
- Author
StoneProof addresses the challenges of transparency and accountability in the mineral supply chain. By leveraging smart contracts and role-gated interfaces, it enables authorized users to manage mineral data securely, with all actions tracked immutably on-chain.
Each participant operates within a dedicated portal based on their assigned role. Wallet verification and role enforcement happen in real time using Base-native tooling.
-
Multi-Role Architecture
Isolated portals for each actor in the supply chain with strict wallet-based role verification. -
ERC721-Based Mineral Tokenization
Minerals are registered and minted as unique NFTs, embedding proof of origin, status, and ownership. -
Validation Workflow
Supervisory roles (Auditors, Inspectors) validate minerals before trade, ensuring data integrity. -
Real-Time Role Control
Admin-controlled role assignment and revocation reflected instantly in the frontend portals. -
Base Layer 2 Optimized
Low gas fees and high throughput for scalable, on-chain logistics.
| Portal | Role(s) | Capabilities |
|---|---|---|
| Miner Portal | MINER | Register minerals, view registered tokens |
| Refinery Portal | REFINER | Refine, tag, and forward processed batches |
| Warehouse Portal | REFINER | Track mineral storage and prepare for sale |
| Buyer Portal | BUYER | View and acquire validated minerals |
| Transporter Portal. | TRANSPORTER. | Transfer minerals from origin to destination. |
| Supervision Portal | AUDITOR, INSPECTOR, SUPER_ADMIN | Validate minerals, resolve disputes, audit records |
Only wallet addresses with valid roles may access their respective portals. All others are automatically blocked or redirected.
Access is enforced using on-chain roles through the RolesManager smart contract.
- Role-based checks occur during wallet connection.
- Frontend portals are protected using Wagmi-based guards.
- Super Admins can grant or revoke roles directly on-chain.
- Unauthorized access attempts are handled gracefully in the UI.
| Path & Contract | Purpose |
|---|---|
| 📁 core | |
├── RolesManager.sol |
Manages role assignments and wallet-based access control |
├── SupplychainValidator.sol |
Handles validation workflows by auditors and inspectors |
└── PrivacyGuard.sol |
Provides privacy and data masking mechanisms where required |
| 📁 governance | |
└── DisputeResolution.sol |
Handles dispute resolution for contested validations |
| 📁 interfaces | |
├── ILogisticsManager.sol |
Interface for logistics operations |
├── IMineralRegistry.sol |
Interface for mineral registration |
├── IMineralWarehouse.sol |
Interface for warehouse management |
├── IRolesManager.sol |
Interface for role control |
├── ISupplychainValidator.sol |
Interface for supply chain validation |
├── ITokenization.sol |
Interface for tokenization module |
└── ITransactionLog.sol |
Interface for on-chain transaction logs |
| 📁 logs | |
└── TransactionLog.sol |
Emits/stores event logs for traceability |
| 📁 modules | |
├── LogisticsManager.sol |
Orchestrates mineral shipment and routing |
├── MineralRegistry.sol |
Registers and tracks raw minerals |
└── MineralWarehouse.sol |
Manages storage and inventory states |
| 📁 tokens | |
└── Tokenization.sol |
ERC721-based tokenization of mineral assets |
| 📁 utils | |
├── DataTypes.sol |
Shared structs and data formats |
├── Errors.sol |
Common error definitions |
└── Events.sol |
Shared event declarations |
-
Blockchain & Contracts
- Solidity (OpenZeppelin-based)
- Hardhat
- Base Layer 2 Network
- Hardhat Deploy
-
Frontend & Wallet Integration
- Next.js 14 (App Router)
- Wagmi + Viem
- WalletConnect
- Base OnchainKit
-
UI/UX
- TailwindCSS
- Shadcn/UI Components
- Lucide Icons
- Framer Motion Animations
- User connects wallet via Wagmi + WalletConnect.
- Portal access is granted or denied based on wallet role.
- Actions per role:
- Miners register minerals → mint ERC721 tokens.
- Refiners update batch status and forward materials.
- Inspectors and Auditors validate asset status or reject invalid data.
- Buyers purchase approved assets.
- Transporter transfer mineral from origin to destination
- Super Admin can asign or revoke roles as needed.
All actions are tracked on-chain for accountability and traceability.
Deployment to Base Sepolia testnet is underway. A live demo link will be added shortly. Judges and reviewers will be able to:
- Connect MetaMask or WalletConnect
- Navigate through portal-specific flows
- View token metadata and role-based actions in real-time
MIT License © 2025 StoneProofLabs Contributors
Built by: StoneProofLabs
Contact: [email protected]
[GitHub] (https://github.com/StoneProofLabs)
[LinkedinPage] (https://www.linkedin.com/company/stone-proof-labs)
[Twitter] (https://x.com/StoneProofLabs)
Stone.proof is built to restore trust in mineral transactions through blockchain transparency.