Enterprise-grade 2-of-3 multi-chain consensus verification system for secure cross-chain vault management and atomic swaps.
Deployed November 26, 2025 | 18 Live Contracts | 3 Blockchains | 100% Open Source
Deployment Status
| Chain | Network | Status | Role | Validator |
|---|---|---|---|---|
| Arbitrum | Sepolia Testnet | ✅ DEPLOYED | PRIMARY | 0x3A92fD5b39Ec9598225DB5b9f15af0523445E3d8 |
| Solana | Devnet | ✅ DEPLOYED | MONITOR | 0x2554324ae222673F4C36D1Ae0E58C19fFFf69cd5 |
| TON | Testnet | ✅ DEPLOYED | BACKUP | 0x9662e22D1f037C7EB370DD0463c597C6cd69B4c4 |
Architecture Overview
┌─────────────────────────────────────────────────────────────────────────────────┐
│ TRINITY PROTOCOL v3.5.20 │
│ 2-of-3 Multi-Chain Consensus System │
├─────────────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐ │
│ │ ARBITRUM L2 │ │ SOLANA DEVNET │ │ TON TESTNET │ │
│ │ (PRIMARY) │◄──►│ (MONITOR) │◄──►│ (BACKUP) │ │
│ │ │ │ │ │ │ │
│ │ Security Layer │ │ High-Frequency │ │ Quantum-Safe │ │
│ │ Consensus Core │ │ Validation <5s │ │ Recovery Layer │ │
│ └────────┬─────────┘ └────────┬─────────┘ └────────┬─────────┘ │
│ │ │ │ │
│ └───────────────────────┼───────────────────────┘ │
│ │ │
│ ┌──────────────▼──────────────┐ │
│ │ TRINITY CONSENSUS ENGINE │ │
│ │ Threshold: 2-of-3 Votes │ │
│ │ Emergency: 3-of-3 Votes │ │
│ └──────────────┬──────────────┘ │
│ │ │
│ ┌────────────────────────────────┼────────────────────────────────┐ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌────────────────┐ ┌────────────────┐ ┌────────────────┐ │
│ │ ChronosVault │ │ HTLC Bridge │ │ Exit Gateway │ │
│ │ Optimized │ │ Atomic Swap │ │ L1 Settlement │ │
│ └────────────────┘ └────────────────┘ └────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────────────┘
Arbitrum Sepolia Deployed Contracts (12 Total)
Explorer: https://sepolia.arbiscan.io | Chain ID: 421614
Core Consensus Layer
| Contract | Address | Role |
|---|---|---|
| TrinityConsensusVerifier | 0x59396D58Fa856025bD5249E342729d5550Be151C |
2-of-3 consensus verification |
| EmergencyMultiSig | 0x066A39Af76b625c1074aE96ce9A111532950Fc41 |
3-of-3 emergency operations |
Infrastructure Layer
| Contract | Address | Role |
|---|---|---|
| TrinityKeeperRegistry | 0xAe9bd988011583D87d6bbc206C19e4a9Bda04830 |
Keeper management |
| TrinityGovernanceTimelock | 0xf6b9AB802b323f8Be35ca1C733e155D4BdcDb61b |
Governance with time-delay |
| CrossChainMessageRelay | 0xC6F4f855fc690CB52159eE3B13C9d9Fb8D403E59 |
Cross-chain message verification |
| TrinityRelayerCoordinator | 0x4023B7307BF9e1098e0c34F7E8653a435b20e635 |
Relayer coordination |
Application Layer
| Contract | Address | Role |
|---|---|---|
| HTLCChronosBridge | 0xc0B9C6cfb6e39432977693d8f2EBd4F2B5f73824 |
HTLC atomic swaps |
| HTLCArbToL1 | 0xaDDAC5670941416063551c996e169b0fa569B8e1 |
Arbitrum to L1 bridge |
| ChronosVaultOptimized | 0xAE408eC592f0f865bA0012C480E8867e12B4F32D |
ERC-4626 vault |
Fee & Infrastructure
| Contract | Address | Role |
|---|---|---|
| TrinityExitGateway | 0xE6FeBd695e4b5681DCF274fDB47d786523796C04 |
L1 exit settlement |
| TrinityFeeSplitter | 0x4F777c8c7D3Ea270c7c6D9Db8250ceBe1648A058 |
Fee distribution (40/30/20/10) |
| TestERC20 | 0x4567853BE0d5780099E3542Df2e00C5B633E0161 |
Test token |
Solana Devnet Deployed Programs (3 Programs + CVT Token)
Explorer: https://explorer.solana.com/?cluster=devnet | Chain ID: 2
Programs
| Program | Address | Role |
|---|---|---|
| ChronosVault | CYaDJYRqm35udQ8vkxoajSER8oaniQUcV8Vvw5BqJyo2 |
Main vault program |
| Bridge Program | 6wo8Gso3uB8M6t9UGiritdGmc4UTPEtM5NhC6vbb9CdK |
Cross-chain bridge |
| Vesting Program | 3dxjcEGP8MurCtodLCJi1V6JBizdRRAYg91nZkhmX1sB |
Token vesting |
CVT Token (Native SPL)
| Asset | Address | Purpose |
|---|---|---|
| CVT Mint | 5g3TkqFxyVe1ismrC5r2QD345CA1YdfWn6s6p4AYNmy4 |
SPL token mint |
| CVT Metadata | D5qLqXpJnWDrfpZoePauQv8g22DbM8CbeVZcjeBhdDgF |
Token metadata |
| Deployment Wallet | AjWeKXXgLpb2Cy3LfmqPjms3UkN1nAi596qBi8fRdLLQ |
Authority |
TON Testnet Deployed Contracts (3 Total + Quantum Security)
Explorer: https://testnet.tonscan.org | Chain ID: 3
| Contract | Address | Role |
|---|---|---|
| TrinityConsensus | EQeGlYzwupSROVWGucOmKyUDbSaKmPfIpHHP5mV73odL8 |
Consensus with recovery |
| ChronosVault | EQjUVidQfn4m-Rougn0fol7ECCthba2HV0M6xz9zAfax4 |
Time-locked vault |
| CrossChainBridge | EQgWobA9D4u6Xem3B8e6Sde_NEFZYicyy7_5_XvOT18mA |
HTLC atomic swaps |
Quantum Security: ML-KEM-1024 + CRYSTALS-Dilithium-5 (256-bit entropy)
Cross-Chain Flow: Atomic Swap (HTLC)
┌─────────────────────────────────────────────────────────────────────────────────┐
│ ATOMIC SWAP FLOW (HTLC) │
├─────────────────────────────────────────────────────────────────────────────────┤
│ │
│ User Arbitrum Solana TON │
│ │ │ │ │ │
│ │ 1. Create Swap │ │ │ │
│ ├───────────────────────►│ │ │ │
│ │ │ │ │ │
│ │ 2. Register HTLC │ │ │ │
│ │ ├─────────────────────►│ │ │
│ │ │ Hash Lock │ │ │
│ │ │ │ │ │
│ │ 3. Validator Vote #1 │ │ │ │
│ │ │◄─────────────────────│ │ │
│ │ │ │ │ │
│ │ 4. Validator Vote #2 │ │ │ │
│ │ │◄───────────────────────────────────────────│ │
│ │ │ │ │ │
│ │ 5. 2-of-3 Achieved │ │ │ │
│ │ ├──────────────────────┼────────────────────► │
│ │ │ Execute Swap │ │ │
│ │ │ │ │ │
│ │ 6. Swap Complete │ │ │ │
│ │◄───────────────────────│ │ │ │
│ │
└─────────────────────────────────────────────────────────────────────────────────┘
Chain Roles Explained
Arbitrum (PRIMARY) — Chain ID: 1
- Primary security layer for consensus verification
- Hosts all core Solidity contracts
- Processes 2-of-3 validator votes
- Manages vault deposits/withdrawals
- Executes HTLC atomic swaps
- Gas cost: ~$0.01-0.10 per transaction
Solana (MONITOR) — Chain ID: 2
- High-frequency validation with <5 second SLA
- Monitors all cross-chain operations
- Provides second validator vote
- Hosts CVT token (SPL - Solana Program Library)
- Handles high-throughput: 2000+ TPS
- Fast state verification
TON (BACKUP) — Chain ID: 3
- Quantum-resistant emergency recovery
- Uses ML-KEM-1024 and CRYSTALS-Dilithium-5
- 48-hour delay for emergency recovery operations
- Provides third validator vote
- Fallback for catastrophic scenarios
- NIST Level 5 post-quantum security
Security Requirements
Consensus Thresholds
| Operation Type | Required Votes | Timelock | Validator Count |
|---|---|---|---|
| Standard Operations | 2-of-3 | None | Any 2 chains |
| Emergency Operations | 3-of-3 | None | All 3 chains |
| Recovery Operations | 3-of-3 | 48 hours | All 3 chains |
Cryptographic Standards
| Chain | Algorithm | Standard | Security |
|---|---|---|---|
| Ethereum/Arbitrum | ECDSA secp256k1 | EIP-712 | 256-bit |
| Solana | Ed25519 | SPL | 256-bit |
| TON | ML-KEM-1024 + Dilithium-5 | NIST Post-Quantum | 256-bit (quantum-safe) |
7-Layer Mathematical Defense Layer (MDL)
- Zero-Knowledge Proof Engine — Groth16 proofs
- Formal Verification Pipeline — Lean 4 theorem prover
- MPC Key Management — Shamir Secret Sharing + CRYSTALS-Kyber
- VDF Time-Locks — Wesolowski Verifiable Delay Functions
- AI + Cryptographic Governance — Anomaly detection
- Quantum-Resistant Cryptography — ML-KEM-1024, CRYSTALS-Dilithium-5
- Trinity Protocol 2-of-3 Consensus — Multi-chain Byzantine fault tolerance
Smart Contract Libraries
Located in contracts/ethereum/libraries/
| Library | File | Purpose | Use Case |
|---|---|---|---|
| ProofValidation | ProofValidation.sol |
ZK & Merkle proof verification | Consensus validation |
| CircuitBreakerLib | CircuitBreakerLib.sol |
Rate limiting & emergency stops | DoS protection |
| FeeAccounting | FeeAccounting.sol |
Fee tracking & distribution | 40/30/20/10 split |
| OperationLifecycle | OperationLifecycle.sol |
State machine for operations | Flow control |
| ConsensusProposalLib | ConsensusProposalLib.sol |
Proposal creation & voting | Governance |
| Errors.sol | Errors.sol |
70+ custom error definitions | Gas-efficient errors |
Interfaces
Located in contracts/ethereum/
| Interface | File | Purpose |
|---|---|---|
| ITrinityConsensusVerifier | ITrinityConsensusVerifier.sol |
Consensus verification spec |
| ITrinityBatchVerifier | ITrinityBatchVerifier.sol |
Batch operation verification |
| IChronosVault | IChronosVault.sol |
Vault operations spec |
| IHTLC | IHTLC.sol |
Hash Time-Locked Contract spec |
Contract Dependency Graph
┌─────────────────────────────────────────────────────────────────────────────────┐
│ CONTRACT DEPENDENCY GRAPH │
├─────────────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────────────────────────────────────┐ │
│ │ CORE CONSENSUS LAYER │ │
│ │ ┌───────────────────────┐ ┌───────────────────────┐ │ │
│ │ │ TrinityConsensusVerifier│◄───│ EmergencyMultiSig │ │ │
│ │ │ (2-of-3 validation) │ │ (3-of-3 emergency) │ │ │
│ │ └───────────┬───────────┘ └───────────────────────┘ │ │
│ └──────────────┼───────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────────────────────────┐ │
│ │ INFRASTRUCTURE LAYER │ │
│ │ ┌────────────────┐ ┌────────────────┐ ┌────────────────┐ │ │
│ │ │ KeeperRegistry │ │ Governance │ │ RelayerCoord │ │ │
│ │ │ - Registration │ │ Timelock │ │ - Proof relay │ │ │
│ │ │ - Heartbeats │ │ - Proposals │ │ - Nonce mgmt │ │ │
│ │ └───────┬────────┘ └───────┬────────┘ └───────┬────────┘ │ │
│ └──────────┼───────────────────┼───────────────────┼───────────────────────┘ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌─────────────────────────────────────────────────────────────────────────┐ │
│ │ APPLICATION LAYER │ │
│ │ ┌────────────────┐ ┌────────────────┐ ┌────────────────┐ │ │
│ │ │ ChronosVault │ │ HTLCChronos │ │ TrinityExit │ │ │
│ │ │ Optimized │ │ Bridge │ │ Gateway │ │ │
│ │ │ - ERC-4626 │ │ - Atomic swaps │ │ - L1 exits │ │ │
│ │ │ - Yield vaults │ │ - Hash locks │ │ - Batch claims │ │ │
│ │ └────────────────┘ └────────────────┘ └────────────────┘ │ │
│ └─────────────────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────────────┘
Getting Started
Clone & Install
git clone https://github.com/Chronos-Vault/chronos-vault-contracts.git
cd chronos-vault-contracts
npm install
Compile
npx hardhat compile
Test
npx hardhat test
npx hardhat test test/integration
Deploy to Testnet
npm run deploy:arbitrum-sepolia
npm run deploy:solana-devnet
npm run deploy:ton-testnet
Documentation
- ARCHITECTURE.md — System architecture & design patterns
- TRINITY_PROTOCOL_POSITIONING.md — Protocol specifications
- SECURITY_ARCHITECTURE.md — Security model & threat analysis
- API_REFERENCE.md — Complete function reference
- DEPLOYMENT_GUIDE.md — Deployment procedures
Roadmap
Current (November 2025)
- [x] Arbitrum Sepolia deployment
- [x] Solana Devnet deployment
- [x] TON Testnet deployment
- [x] Full documentation
- [x] GitHub open source release
Q1 2026
- [ ] External security audit
- [ ] SDK for JavaScript/TypeScript
- [ ] SDK for Python
- [ ] Mainnet preparation
Q2 2026
- [ ] Mainnet launch (Arbitrum One, Solana, TON)
- [ ] DEX integrations
- [ ] Institutional partnerships
Contributing
We welcome contributions from developers across all chains:
- Solidity — Gas optimization, ERC standards, audit prep
- Rust — Solana program improvements, Anchor migration
- FunC/Tact — TON enhancements, Jetton integration
- Security — Vulnerability research, exploit testing
Issues & PRs: github.com/Chronos-Vault
License
MIT License — See LICENSE
Trinity Protocol v3.5.20 Deployed November 26, 2025
Multi-Chain Consensus Verification System
Top comments (0)