🏗️ System Architecture

Overview

SEAL360 is built on a multi-layer architecture designed for security, scalability, and decentralization.

Technology Stack

┌─────────────────────────────────────────────────────────────────┐
│                    PRESENTATION LAYER                            │
│  🌐 Frontend: Next.js 14 + React 18 + TailwindCSS              │
│  📱 Mobile: React Native (roadmap 2027)                         │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│                  APPLICATION LAYER (dApp)                        │
│  🔗 Web3: ethers.js v6 + wagmi + RainbowKit                    │
│  🔐 Auth: Supabase Auth + wallet connection                    │
│  📊 State: Zustand + React Query                                │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│                   BACKEND / API LAYER                            │
│  ⚡ API Routes: Next.js API + Edge Functions                   │
│  🗄️ Database: Supabase (PostgreSQL 15)                         │
│  🔔 Webhooks: Alchemy Notify + Custom indexer                  │
│  📧 Email: Resend (transactional emails)                       │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│                BLOCKCHAIN LAYER (Avalanche C-Chain)             │
│  📝 Smart Contracts: Solidity 0.8.28                           │
│  🏗️ Framework: Hardhat + Foundry                               │
│  🔍 Testing: 753 Hardhat + 181 Foundry + 12 Echidna + 4 Manticore = 950 tests │
│  🛡️ Security: Slither + Manual Review                          │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│              INFRASTRUCTURE LAYER                                │
│  ☁️ Hosting: Vercel (frontend) + AWS (nodes)                   │
│  🔗 RPC: Alchemy (primary) + Infura (backup)                   │
│  📦 Storage: IPFS (metadata) + Arweave (audit reports)        │
│  📈 Analytics: Dune Analytics + Custom dashboard               │
└─────────────────────────────────────────────────────────────────┘

Smart Contract Ecosystem

15 Production Contracts

SEAL360 Smart Contract Ecosystem
│
├─── 📦 CORE (3 contracts)
│    ├─ SEAL360Token.sol           → ERC-20 + Flash Loans + Voting
│    ├─ S360StakingRewards.sol     → Staking with dynamic APY
│    └─ S360FeeDistribution.sol    → 3-way fee splitter (33/33/34%)
│
├─── 🏛️ GOVERNANCE (5 contracts)
│    ├─ S360Governor.sol           → OpenZeppelin Governor
│    ├─ S360TimelockController.sol → 48h timelock
│    ├─ S360MultiSigTimelock.sol   → multisig ≥60% (ej.: 3/5 o 4/7) para emergencias
│    ├─ S360Treasury.sol           → DAO-controlled treasury
│    └─ OwnershipMigrationHelper.sol → Safe ownership transfer
│
├─── 💹 PERIPHERY (4 contracts)
│    ├─ S360BondingCurve.sol       → Bancor price discovery
│    ├─ S360BondingCurveDynamic.sol → Dynamic pricing v2
│    ├─ S360Vesting.sol            → Linear vesting with cliff
│    └─ S360TimeVaultRND.sol       → 5-year R&D lockup
│
├─── 🎖️ BADGES (1 contract)
│    └─ S360AchievementBadges.sol  → NFT certification badges
│
└─── 💰 GROWTH (2 contracts)
     ├─ S360GrowthFund.sol         → Marketing & expansion fund
     └─ S360Launchpad.sol          → IDO platform (roadmap)

Total Statistics:

15 production contracts
6 mock contracts (testing only)
5,009 lines of Solidity code
950 automated tests
Coverage: 61.22% overall / 84.41% core contracts

Contract Dependencies

Key Relationships

SEAL360Token → All Contracts
The token is the center - all contracts reference it
FeeDistribution → 3 Destinations
Splits fees to: Treasury (33.33%), Stakers (33.33%), Growth (33.34%)
Governor → Timelock → Treasury
Chain of command for governance decisions
BondingCurve → FeeDistribution
Trading fees flow into the distribution system

Security Architecture

Defense in Depth (7 Layers)

LAYER 7: Post-Launch Monitoring
         └─ Alchemy Notify + Dune Analytics
              ↓
LAYER 6: Access Control
         └─ Ownable2Step + Role-Based Access
              ↓
LAYER 5: Circuit Breakers
         └─ Pausable + Emergency Multisig
              ↓
LAYER 4: Rate Limiting
         └─ Flash Loan Limits + Per-TX Caps
              ↓
LAYER 3: Reentrancy Protection
         └─ ReentrancyGuard on 22 functions
              ↓
LAYER 2: Input Validation
         └─ require() + custom errors
              ↓
LAYER 1: Audits + Tests
         └─ Slither + 950 tests passing

Protection Mechanisms

Layer	Mechanism	Coverage
Reentrancy	ReentrancyGuard	22 functions
Access Control	Ownable2Step	13 contracts
Emergency Stop	Pausable	6 contracts
Rate Limiting	Per-TX caps	All trading
Flash Loans	0.09% fee + 1.08M limit	SEAL360Token
Governance	48h timelock	All proposals
Multisig	≥60% signers (ej.: 3/5 o 4/7)	Solo emergencias

Data Flow

Transaction Lifecycle

USER → WALLET → RPC → BLOCKCHAIN → INDEXER → DATABASE → FRONTEND
 ↓       ↓       ↓         ↓          ↓          ↓         ↓
[Sign] [MetaMask] [Alchemy] [Avalanche] [Webhook] [Supabase] [UI]

Step by Step:

User initiates (e.g., stake 10,000 S360)
Wallet signs transaction
RPC broadcasts to Avalanche
Smart contract executes logic
Event emitted on-chain
Indexer captures via webhook
Database updates user stats
Frontend refreshes (real-time)

Total Time: < 3 seconds
Gas Cost: ~$0.02 AVAX

Fee Distribution Flow

┌─────────────────────────────────────────────────────────────┐
│                    FEE COLLECTION SOURCES                    │
├─────────────────────────────────────────────────────────────┤
│ 1. Bonding Curve (2% per trade)                            │
│ 2. Flash Loans (0.09% per loan)                            │
│ 3. Launchpad (5% commission)                               │
│ 4. Audit Services (50% in S360)                            │
└─────────────────────────────────────────────────────────────┘
                           ↓
┌─────────────────────────────────────────────────────────────┐
│                S360FeeDistribution.sol                      │
│              (Automated 3-Way Splitter)                     │
└─────────────────────────────────────────────────────────────┘
                           ↓
        ┌──────────────────┼──────────────────┐
        ↓                  ↓                   ↓
┌──────────────┐  ┌──────────────┐  ┌──────────────┐
│   TREASURY   │  │   STAKERS    │  │ GROWTH FUND  │
│   33.33%     │  │   33.33%     │  │   33.34%     │
└──────────────┘  └──────────────┘  └──────────────┘
        ↓                  ↓                   ↓
   Governance      Passive Income       Marketing
   Operations      for Holders          + Expansion

Mathematical Precision

No token loss due to rounding:

// Example: 100.000000000000000007 S360
 
uint256 toTreasury = (amount * 3333) / 10000;  // 33.330...002
uint256 toStakers  = (amount * 3333) / 10000;  // 33.330...002
uint256 toGrowth   = amount - toTreasury - toStakers; // Remainder
 
// Total = 100.000000000000000007 ✅ (exact match, 0 loss)

Tested in: SecurityCritical.v3.3.2.test.cjs → TEST 6 (v2.4.0)

Network Configuration

Avalanche C-Chain (Mainnet)

{
  chainId: 43114,
  name: "Avalanche C-Chain",
  rpcUrl: "https://api.avax.network/ext/bc/C/rpc",
  explorer: "https://snowtrace.io",
  nativeCurrency: {
    name: "Avalanche",
    symbol: "AVAX",
    decimals: 18
  }
}

Fuji Testnet

{
  chainId: 43113,
  name: "Avalanche Fuji Testnet",
  rpcUrl: "https://api.avax-test.network/ext/bc/C/rpc",
  explorer: "https://testnet.snowtrace.io",
  faucet: "https://faucet.avax.network"
}

Why Avalanche?

Feature	Avalanche	Ethereum	BNB Chain
Finality	< 1 second	12-15 seconds	3 seconds
Gas Cost	~$0.01	$5-50	$0.10-1
TPS	4,500+	15-30	300+
EVM Compatible	✅ Yes	✅ Native	✅ Yes
Subnet Capability	✅ Yes	❌ No	❌ No

Decision: Avalanche provides 10x faster transactions and 100x lower costs than Ethereum, while maintaining full EVM compatibility.

Next Steps

Getting Started Bonding Curve