SKGentis - Quantum Treasury & RWA Tokenization Platform

Document ID: SOP-SKGENTIS-001
Version: 5.0.0 - Hybrid Bot Bait Production Release
Status: ✅ Production Ready
Last Updated: January 6, 2026
Type: Full-Stack Web3 Application
Domain: gentistrust.com
Registry: skgit.skstack01.gentistrust.com

---

🚀 Quick Start

# Clone repository
git clone https://skgit.skstack01.gentistrust.com/smilinTux/SKGentis.git
cd SKGentis/src/skgentis

# Install dependencies
npm install

# Configure environment
cp .env.example .env.local
# Add your VITE_PINATA_JWT and VITE_DEPLOYER_PRIVATE_KEY

# Start development server
npm run dev

# Build for production
npm run build

---

📚 Documentation Index

Document	Description
ARCHITECTURE.md	Complete system architecture with diagrams
WORKFLOWS.md	Step-by-step workflow instructions
DEPLOYMENT_GUIDE.md	Deployment to testnet and mainnet
AUDIT-SYSTEM.md	Audit trail and compliance system
FAQ.md	Frequently asked questions
QUICK_START_SEPOLIA.md	Sepolia testnet quick start

---

🎯 Overview

SKGentis is a private trust RWA (Real-World Asset) tokenization platform with:

• 🔐 Privacy-First: Zero-knowledge proofs for sensitive asset data
• 💰 Dual Token System: SKQNT ($1 fixed) + SKSV (bonding curve)
• 🤖 Bot-Optimized Auctions: Dutch auctions designed for MEV bot engagement
• 📊 Full Audit Trail: Double-entry bookkeeping for compliance
• 🏦 Collateralized Loans: Mint tokens using NFT collateral
• 🔗 Blockchain Native: Ethereum mainnet + Sepolia testnet

---

🏗️ Architecture

System Overview

graph TB
    subgraph Frontend["Frontend - React + TypeScript"]
        UI[User Interface]
        STORES[Zustand Stores]
        SERVICES[Service Layer]
    end
    
    subgraph Backend["Backend - Node.js + PostgreSQL"]
        API[Express API]
        DB[(Database)]
    end
    
    subgraph Blockchain["Ethereum Blockchain"]
        NFT[SK_RWA_Core NFT]
        SKQNT[SKQNT $1 Token]
        SKSV[SKSV Bonding Curve]
        AUCTION[Dutch Auctions]
    end
    
    subgraph Storage["Decentralized Storage"]
        IPFS[Pinata IPFS]
    end
    
    UI --> STORES
    STORES --> SERVICES
    SERVICES --> API
    SERVICES --> Blockchain
    SERVICES --> IPFS
    API --> DB

Token System

graph LR
    NFT[NFT Collateral] -->|Loan| MINT[Token Minting]
    NFT -->|Auction| PAYOUT[Auction Payout]
    MINT --> SKQNT[SKQNT $1.00]
    MINT --> SKSV[SKSV Bonding]
    PAYOUT --> SKQNT
    PAYOUT --> SKSV
    SKQNT --> POOL1[SKQNT/WETH Pool]
    SKSV --> POOL2[SKSV/WETH Pool]

---

✨ Key Features

1. Asset Tokenization

• Submit real-world asset documents (bonds, receipts, certificates)
• Upload to IPFS for decentralized storage
• Zero-knowledge proofs for privacy
• Admin verification workflow
• Automatic NFT minting on approval

2. Dual Token System

SKQNT - Stablecoin

• Fixed $1.00 USD peg
• Used for stable value transfers
• Backed by collateralized assets
• Uniswap V2 liquidity pool

SKSV - Bonding Curve Token

• Dynamic pricing based on supply
• Starts at $0.10 USD (10:1 ratio with SKQNT)
• Price increases with minting
• Optimized for bot trading

3. Collateralized Loans

• Use NFT as collateral
• Mint SKQNT or SKSV tokens
• Up to 100% LTV (Loan-to-Value)
• 100-year term default
• Choose recipient wallet
• Full audit trail

4. Dutch Auctions (Ultimate Bot Bait)

• Price decays over time (1-4 hours)
• Start at 115% premium, end at 88% floor
• 10% early bonus for first 10 buyers
• Payout in SKQNT or SKSV
• Batch randomizer for multiple auctions
• Optimized for MEV bot engagement

5. Comprehensive Audit System

• All operations logged
• Double-entry bookkeeping
• Reconciliation reports
• Loan tracking by token type
• Blockchain transaction links
• Compliance-ready

6. Analytics Dashboard

• Portfolio overview
• Dutch auction performance
• Success rates and trends
• Liquidity metrics
• Bot participation tracking

---

🛠️ Technology Stack

Frontend

• Framework: React 18 + TypeScript
• Build Tool: Vite 5
• State: Zustand
• UI: Material-UI (MUI) v5
• Blockchain: Ethers.js v6
• Charts: Recharts

Backend

• Runtime: Node.js 18+
• Framework: Express.js
• Database: PostgreSQL 14+
• Storage: Pinata IPFS

Smart Contracts

• Language: Solidity 0.8.20+
• Framework: Hardhat
• Standards: ERC721, ERC20
• Networks: Ethereum, Sepolia

---

📦 Smart Contracts

Sepolia Testnet (Chain ID: 11155111)

Contract	Address
SK_RWA_Core (NFT)	0x8A4a40e5a4A4C13176FcCB9FD9213a5e64e92aB7
SKQNT Token	0x5D85802e30F64Decd641a2a9cC557768B634d29E
SKSV Token	0xC80b635B0a820a52f40f15373BF7807Ba35fAf25
Oracle	0x6021707d51be85080dB6D464651C86DC9bA25c4f
BondMinter	0x537f942467127b6c7A3867B1FFB1703F2d127332
DutchAuction	0x9Fe87551Fb3b36aF2A9455A296489460080be1c3

Ethereum Mainnet (Chain ID: 1)

Contract	Address
SK_RWA_Core (NFT)	0x2b5C41E79b2ad581b7889FE5eDa8924EF5B77E48
SKQNT Token	0x56bbD192652573051e293C19530fDf774E3b1b8F
SKSV Token	0xEB20bCAB3dffaB82C04B2Ec26db606C4F1a16c56
Oracle	0x16693e55f1eEB25e47A4eDb5ca63DC32891B5953
BondMinter	0xC7f3168d7F9dd8C4988eC70e3B9292c9c55536eA
DutchAuction	0x5D85802e30F64Decd641a2a9cC557768B634d29E

---

🔧 Configuration

Environment Variables

Create .env.local in src/skgentis/:

# Network Configuration
VITE_DEFAULT_NETWORK=sepolia
VITE_DEFAULT_CHAIN_ID=11155111

# Pinata IPFS
VITE_PINATA_JWT=your_pinata_jwt_here

# Deployer Wallet (for admin operations)
VITE_DEPLOYER_PRIVATE_KEY=your_private_key_here

# RPC Endpoints
VITE_SEPOLIA_RPC_URL=https://sepolia.infura.io/v3/YOUR_KEY
VITE_MAINNET_RPC_URL=https://mainnet.infura.io/v3/YOUR_KEY

# Backend API
VITE_API_BASE_URL=http://localhost:3003

Backend Configuration

Create .env in src/skgentis/backend/:

# Database
DATABASE_URL=postgresql://user:password@localhost:5432/skgentis

# Server
PORT=3003
NODE_ENV=development

# CORS
CORS_ORIGIN=http://localhost:5173

---

🚦 Workflows

1. Submit Asset

sequenceDiagram
    User->>Frontend: Upload document
    Frontend->>IPFS: Store document
    IPFS-->>Frontend: Return CID
    Frontend->>Backend: Submit asset
    Backend-->>User: Asset pending

2. Approve & Mint NFT

sequenceDiagram
    Admin->>Frontend: Approve asset
    Frontend->>IPFS: Generate metadata
    Frontend->>Blockchain: Mint NFT
    Blockchain-->>Frontend: Return tokenId
    Frontend->>Backend: Update asset

3. Create Loan

sequenceDiagram
    User->>Frontend: Select NFT collateral
    User->>Frontend: Choose SKQNT/SKSV
    Frontend->>Blockchain: Mint tokens
    Blockchain-->>User: Tokens received
    Frontend->>Audit: Log transaction

4. Launch Auction

sequenceDiagram
    User->>Frontend: Configure auction
    Frontend->>Blockchain: Approve NFT
    Frontend->>Blockchain: Create auction
    Bot->>Blockchain: Purchase at current price
    Blockchain-->>Bot: NFT + tokens

---

📊 Database Schema

Key Tables

submissions - Asset submissions

• id, asset_type, mode, status, value, metadata, token_id, tx_hash

loans - Collateralized loans

• id, asset_id, amount, ltv_percent, output_token, status, tx_hash

auctions - Dutch auctions

• id, asset_id, start_price, floor_price, duration, status, tokens_sold

---

🔐 Security

Role-Based Access Control

• User: Submit assets, create loans, launch auctions
• Trustee: View analytics, audit trail
• Admin: Approve assets, manage system

Smart Contract Roles

• DEFAULT_ADMIN_ROLE: Contract administration
• MINTER_ROLE: Token minting permission
• PAUSER_ROLE: Emergency pause
• ORACLE_ROLE: Oracle updates

---

🚀 Deployment

Development

# Start frontend
cd src/skgentis
npm run dev

# Start backend
cd src/skgentis/backend
npm start

# Start PostgreSQL
docker-compose up -d postgres

Production

# Build frontend
npm run build

# Deploy to server
ansible-playbook deploy-prod.yml

# Verify deployment
curl https://gentistrust.com/health

---

📈 Monitoring

Audit Trail

• All operations logged to useAuditStore
• Double-entry bookkeeping
• Reconciliation reports

Analytics

• Portfolio metrics
• Auction performance
• Bot engagement tracking

Blockchain

• Transaction hashes logged
• Etherscan links
• Gas usage tracking

---

🤝 Contributing

1. Fork the repository
2. Create feature branch (git checkout -b feature/amazing-feature)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push to branch (git push origin feature/amazing-feature)
5. Open Pull Request

---

📝 License

Copyright (C) 2025 S&K Holding QT (Quantum Technologies)

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

---

🆘 Support

• Documentation: docs/
• Issues: Forgejo Issues
• Email: support@gentistrust.com

---

🎯 Roadmap

Q1 2026

• Hybrid Bot Bait system
• SKQNT/SKSV tokens
• Dutch auctions
• Comprehensive audit trail
• Mobile app (React Native)

Q2 2026

• Multi-chain support (Polygon, Arbitrum)
• Advanced analytics (ML-powered)
• DAO governance
• API gateway (GraphQL)

---

🏆 Achievements

• ✅ Production-ready codebase
• ✅ Comprehensive documentation
• ✅ Full audit trail
• ✅ Bot-optimized auctions
• ✅ Dual token system
• ✅ Zero-knowledge proofs
• ✅ Mainnet deployment

---

Built with ❤️ by the SKGentis Team

Empowering private trust through blockchain technology