ChainBETs Smart Contracts - Technische Dokumentation

Version: Production V2.5 (Migration-Ready V3) Netzwerk: Arbitrum Sepolia (Testnet) / Arbitrum One (Mainnet) Solidity: 0.8.20 - 0.8.24 Stand: 2026-02-28

---

Übersicht

Die ChainBETs Smart Contracts bilden eine pari-mutuelle Lotterie-Plattform auf Arbitrum (L2). Das System folgt dem Option-B Architekturmuster: strikte Trennung von Funds und Logik.

Kernprinzipien:

• Nur ein Contract hält USDT (ReserveVault) - alle anderen sind reine State-Contracts
• Merkle-basierte Claims für Gewinner und Affiliates (gas-effizient)
• EIP-712 Meta-Transaktionen für gaslose UX (BuyPermit + ClaimPermit)
• Chainlink VRF für verifizierbare Zufallszahlen
• SAFE Multisig als Owner aller Contracts

---

Dokumentation

Architektur

#	Dokument	Beschreibung
01	Systemarchitektur	Contract Landscape, Option-B Pattern, Interaktionsdiagramm

Contracts (je ein Dokument pro Contract)

#	Contract	Version	Dokument	Beschreibung
02	ReserveVault	V2	ReserveVaultV2	Einziger USDT-Holder, Emergency Mode
03	GameManager	V3	GameManagerV3	Ticket-Kauf, EIP-712 BuyPermit, RNG
04	GameTreasury	V2	GameTreasuryV2	Accounting, Fee Splits, Rollover
05	Settlement	V5	SettlementV5	Tägliche Abrechnung, Merkle Roots
06	PrizeVault	V3	PrizeVaultV3	Gewinn-Claims, Wallet Recovery
07	AffiliateVault	V2	AffiliateVaultV2	Affiliate-Provisionen
08	CharityVault	V2	CharityVaultV2	Charity Fund Management
09	ClaimRouter	V2	ClaimRouterV2	Batch Claims via Relayer
10	VRFReceiver	V3	VRFReceiverV3	Chainlink VRF Integration

Querschnittsthemen

#	Dokument	Beschreibung
11	Sicherheit & Access Control	Defense Layers, Threat Model, Emergency Procedures
12	Merkle Claim System	Tree-Konstruktion, Proof-Verifikation, Batch Claims
13	EIP-712 Signaturen	BuyPermit, ClaimPermit, Domain Separators
14	Settlement Lifecycle	Day Lifecycle, No-Winner Handling, Settlement Guard
15	Deployment & Migration	Deploy-Sequenz, Wiring, Validierung
16	Testing & Akzeptanz	Teststruktur, Szenarien, Akzeptanzkriterien

---

Quick Navigation

Für Auditoren

1. Architektur & Contract Landscape - Gesamtüberblick
2. Sicherheit & Access Control - Threat Model, Defense Layers
3. ReserveVaultV2 - Einziger Fund Holder (kritischster Contract)
4. Merkle Claim System - Claim-Verifizierung
5. Settlement Lifecycle - Invarianten & Edge Cases

Für Entwickler

1. GameManagerV3 - Ticket-Kauf Flow
2. EIP-712 Signaturen - Signatur-Integration
3. ClaimRouterV2 - Batch Claim Integration
4. Deployment & Migration - Deploy & Wiring

Contract Files

contracts/contracts/
├── ReserveVaultV2.sol          # Fund Holder
├── GameManagerV3.sol           # Ticket Purchase + RNG
├── GameTreasuryV2.sol          # Accounting Layer
├── SettlementV5.sol            # Daily Settlement
├── PrizeVaultV3.sol            # Winner Claims
├── AffiliateVaultV2.sol        # Affiliate Claims
├── CharityVaultV2.sol          # Charity Funds
├── ClaimRouterV2.sol           # Batch Relayer Claims
├── VRFReceiverV3.sol           # Chainlink VRF
└── MockUSDT.sol                # Test Token

---

Verwandte Dokumentation

Bereich	Link
Mobile App	/app/
BO-Engine	(in Arbeit)
Landing Page	doku.itsolution.co.at