# L1 ADDITION Blockchain - Technical Whitepaper / Livre Blanc Technique

> [!NOTE]
> This document is provided in **English (Primary)** and **French (Secondary)** to accommodate global developers, validators, and institutional partners.
> Ce document est disponible en **Anglais (Primaire)** et **Français (Secondaire)** pour les développeurs, validateurs et partenaires institutionnels mondiaux.

---

# PART 1: ENGLISH VERSION (PRIMARY)

## 1. Executive Summary

The **ADDITION** blockchain is a Layer 1 (L1) decentralized ledger designed from the ground up for the post-quantum era. It natively combines a hard memory-bound Proof of Work consensus (**PoMW**), hybrid post-quantum lattice-based signatures (**ML-DSA-87**), zero-knowledge confidentiality shielding (**ZK-Shield**), a low-latency smart contract virtual machine (**LDCE VM**), a shared Proof-of-Useful-Work cloud compute engine (**PoUW**), and an ephemeral peer-to-peer anonymous private messenger. 

The protocol operates in a purely decentralized, autonomous, permissionless, and non-sovereign manner, without any central coordination or authority.

IMPORTANT : ADDITION resolves the blockchain trilemma (Security, Scalability, Decentralization) by introducing post-quantum security mechanisms without sacrificing throughput (100,000 TPS target) and maintaining absolute decentralization via active ASIC resistance.

---

## 2. Global Network Architecture

In production, the network operates across coordinate layers to ensure performance, security, and global accessibility:

[Clients & Interfaces Layer]
  - Web Interface (BNKS.AI) - Port 5173
  - Physical ATM Simulators
  - Developer CLI Tools - Port 18545
         |
         v (Fetch JSON-RPC)
[HTTP JSON-RPC Gateway - Port 8545]
  - addition_gateway.py <--> gateway_db.json (Session DB)
         |
         v (Local RPC + Token Auth)
[L1 Core Validator Daemon (additiond.exe)]
  - Local Secured RPC - Port 8546
  - Public Network RPC - Port 18545
  - Native C++ Core Engines :
    * PoMW Memory-Hard Consensus
    * ML-DSA-87 (Dilithium5) Signatures
    * ZK-Shield Privacy Pool
    * LDCE Smart Contracts VM
    * PoUW IA Compute Engine
    * TTL-Purged Anonymous Messenger
    * Constant Product AMM
         |
         v
[P2P Gossip Network - Port 28545]
  - Gossip of Blocks & TXs <--> Global ADDITION Peer Nodes

---

## 3. Technology Pillars & Mechanics

### A. PoMW Consensus (Proof-of-Memory-Work)
The `memory_hard_head64` algorithm counters ASIC centralization by enforcing pseudo-random memory reads/writes over a **1 MiB** Scratchpad, shifting the computational bottleneck from raw ALU processing speed to memory bus bandwidth constraints.

[PoMW Mining Algorithm Flow] :
1. Unmined Block Header (64 bytes) --> Keccak-512 Initial Hash.
2. Scratchpad Initialization (1 MiB RAM space).
3. Lookup Mixing Loop (64 iterations) :
   - Compute lookup address A(i) based on current state.
   - Read 64 bytes from Scratchpad at A(i).
   - Apply XOR & non-linear Head64 permutation.
   - Write back 64 permutated bytes to Scratchpad at A(i).
   - Next iteration i+1.
4. Keccak-512 Final Hash.
5. If Hash < Difficulty Target : Block solved and broadcasted to P2P network !
6. Else : Increment Nonce and return to step 1.

#### What is PoMW exactly?

**PoMW** (Proof-of-Memory-Work) solves the central vulnerability of traditional Proof of Work (such as Bitcoin's SHA-256): the industrial monopolization of mining by specialized ASIC chips.

Here are its primary technical mechanics:

1. ASIC Centralization Resistance :
   In Bitcoin, hashing requires virtually zero memory. Specialized ASICs calculate billions of hashes per second for a fraction of the cost, obsoleting standard computer processors (CPUs). PoMW requires a 1 MiB Scratchpad in RAM, forcing the processor to perform 64 iterations of Lookup Mixing at unpredictable memory addresses.
2. The Memory Bandwidth Bottleneck :
   Because lookup addresses are pseudo-random, the processing core must constantly wait for the hardware memory bus (cache L3/RAM) to retrieve data. This physically bounds the mining speed to the memory bandwidth, rendering high-cost ASICs ineffective. A standard, widely available computer CPU remains fully competitive.
3. Responsive Target Tuning :
   The network continually quantifies memory bandwidth solving speeds across all nodes. The difficulty target is adjusted every single block, keeping block times exceptionally stable at under 5 seconds for instant payment confirmations.

---

### B. Post-Quantum Lattice Signatures (ML-DSA-87)
ADDITION immunizes the ledger against quantum computer attacks by adopting lattice-based cryptography standard **ML-DSA-87** (Dilithium5) for all transaction validation.

[Génération et validation des signatures] :
1. Dilithium5 Key Generation --> Public Key (PK) + Private Key (SK).
2. L1 Public Wallet Address Derivation : Double SHA3-512 Hashing of PK -> 40-character hex string.
3. Transaction Signing :
   - Raw Transaction (From, To, Amount, Nonce) -> Transaction Hash (Keccak-256).
   - Sign with Private Key (SK) via ML-DSA-87.
   - Signed Transaction (Data + Signature + PK) sent to network.
4. Verification :
   - Validator runs verify_message(PK, TXHash, Signature).
   - If Valid : Transaction admitted to mempool.
   - If Invalid : Transaction instantly dropped.

---

### C. ZK-Shield & Privacy Pools
The privacy pool hides transaction graphs by allowing users to shield public ADD into private note commitments, spent via zero-knowledge proofs and nullifier tracking.

[ZK-Shield Shielding Protocol] :
1. Shielding Phase (privacy_mint_zk) :
   - Deposit ADD from Public Address.
   - Generate Note Commitment: Commitment = H(Amount, Secret, Owner_Key).
   - Generate ZK Range Proof (proves amount is positive).
   - Submit Shielding Transaction and append Commitment to ZK-Shield Merkle Tree.
2. Anonymous Spending Phase (privacy_spend_zk) :
   - Generate Merkle membership proof of target note.
   - Generate unique Nullifier: Nullifier = H(Note_Secret, Note_Index).
   - On-Chain Double-Spend Check: Search Nullifier. If present -> Reject !
   - Verify ZK-STARK Proof (validates balance & ownership without revealing identity).
   - Withdrawal to transparent address OR ZK Shielded note transfer.

---

## 4. Physical Specifications & Network Performance

* Transaction Throughput : 10,000 TPS (Measured locally in stress tests) / 100,000 TPS (Target with future sharding scale).
* Block Time : Solved and sealed in < 5 seconds (real-time dynamic retargeting).
* Network Fees : Dynamic adjustments (Anti-spam base fee threshold of 1 Satoshi = 0.00000001 ADD).
* Signature Scheme : 100% Post-Quantum secure (ML-DSA-87). Signature times < 1.5 ms.
* Anonymization : Instant zero-knowledge shielding (ZK-Shield). Proof times < 200 ms.
* Smart Contracts : Sub-millisecond execution (< 0.1 ms) for high-frequency AMM/DEX swaps (LDCE Engine).
* Messaging : Quantum-Resistant Ephemeral Messenger (Purge TTL) definitive automated disk erasure.
* Utility Compute : PoUW AI Cloud Engine decentralized job allocation in < 1s via consensus jury protocols.

#### Transaction Fee System Economics

Like Bitcoin, ADDITION L1 does not enforce a hard-coded absolute minimum fee inside its consensus rules. A transaction with a zero fee is theoretically valid. However, to prevent distributed denial of service (DDoS) and mempool spam attacks, validators run a dynamic C++ Mempool Relay Filter:

1. The Internal Satoshi Unit :
   All fee accounting is calculated in the smallest unit of account: Satoshis of ADD (1 sat = 1e-8 ADD).
2. Understanding 'Min Fee: 1' :
   The value Min Fee: 1 displayed in the system stats represents 1 Satoshi (which equals 0.00000001 ADD), NOT 1.00 ADD! It acts as a base anti-spam threshold: it is virtually cost-free for honest users but imposes massive costs on automated spam programs.
3. Comparison to Bitcoin (BTC) :
   - On Bitcoin : Bitcoin nodes enforce a relay fee filter (typically 1000 sat/vByte). If a user proposes a fee lower than this relay filter, nodes drop the transaction, preventing it from ever reaching miners' mempools.
   - On ADDITION L1 : ADDITION uses a similar dynamic filter managed by an AI-optimized routing estimator. If the mempool is quiet, the filter drops to 1 Satoshi. During high transaction activity, the filter increases dynamically (e.g. to 100 or 1000 satoshis, still under 0.00001 ADD) to filter out spam and prioritize active, legitimate users in a competitive fee market.

---

## 5. Comparative Technical Benchmark: ADDITION vs 12 Major Crypto-Assets

* ADDITION (ADD) :
  - Layer 1 | PoMW Consensus | Signature ML-DSA-87 + SHA3 | Quantum Resistant: Yes | Block: < 5s | Throughput: 10,000 (Stress Test) | ZK-Shield | Smart Contracts: LDCE VM | AI & PoUW: Yes

* Bitcoin (BTC) :
  - Layer 1 | PoW (SHA-256) | Signature ECDSA | Quantum Resistant: No | Block: 10 min | Throughput: 7 | Privacy: None | Smart Contracts: None | AI & PoUW: No

* Ethereum (ETH) :
  - Layer 1 | PoS | Signature ECDSA + BLS | Quantum Resistant: No | Block: 12s | Throughput: 15 - 30 | Privacy: None | Smart Contracts: EVM | AI & PoUW: No

* Solana (SOL) :
  - Layer 1 | PoH + PoS | Signature Ed25519 | Quantum Resistant: No | Block: 400ms | Throughput: 2500 - 65000 | Privacy: None | Smart Contracts: Sealevel | AI & PoUW: No

* XRP (Ripple) :
  - Layer 1 | RPCA Consensus | Signature ECDSA/Ed25519 | Quantum Resistant: No | Block: 3 - 5s | Throughput: 1500 | Privacy: None | Smart Contracts: None | AI & PoUW: No

* Monero (XMR) :
  - Layer 1 | PoW (RandomX) | Signature Ed25519 | Quantum Resistant: No | Block: 2 min | Throughput: 10 - 100 | Privacy: RingCT + Stealth | Smart Contracts: None | AI & PoUW: No

* Zcash (ZEC) :
  - Layer 1 | PoW (Equihash) | Signature ECDSA | Quantum Resistant: No | Block: 75s | Throughput: 26 | Privacy: zk-SNARKs | Smart Contracts: None | AI & PoUW: No

* Cardano (ADA) :
  - Layer 1 | PoS | Signature Ed25519 | Quantum Resistant: No | Block: 20s | Throughput: 250 | Privacy: None | Smart Contracts: Plutus | AI & PoUW: No

* BNB Chain (BNB) :
  - Layer 1/L2 | PoSA Consensus | Signature ECDSA | Quantum Resistant: No | Block: 3s | Throughput: 2200 | Privacy: None | Smart Contracts: EVM | AI & PoUW: No

* TRON (TRX) :
  - Layer 1 | dPoS Consensus | Signature ECDSA | Quantum Resistant: No | Block: 3s | Throughput: 2000 | Privacy: None | Smart Contracts: TVM | AI & PoUW: No

* Dogecoin (DOGE) :
  - Layer 1 | PoW (Scrypt) | Signature ECDSA | Quantum Resistant: No | Block: 1 min | Throughput: 33 | Privacy: None | Smart Contracts: None | AI & PoUW: No

* Stellar (XLM) :
  - Layer 1 | SCP Consensus | Signature Ed25519 | Quantum Resistant: No | Block: 3 - 5s | Throughput: 1000 - 3000 | Privacy: None | Smart Contracts: SSC | AI & PoUW: No

* Chainlink (LINK) :
  - Oracle L2 | PoS Consensus | Signature ECDSA | Quantum Resistant: No | Block: N/A | Throughput: N/A | Privacy: None | Smart Contracts: Multi-Chain | AI & PoUW: No

NOTE : Although some blockchains integrate high-performance privacy mechanisms (like Monero or Zcash) or very fast block times (like Solana), ADDITION is the only Layer 1 to natively combine global quantum resistance (ML-DSA-87), zero-knowledge proofs (ZK-Shield), and a decentralized useful compute cloud AI engine (PoUW).

---

## 6. Tokenomics, Monetary Emission & Value Proposition

### A. Emission Algorithm & Time to Mine All Coins

The total supply of ADDITION is strictly capped at **50,000,000 ADD** (equal to 5e15 Satoshis). Block emissions utilize a degressive schedule with regular halvings, combined with a **Tail Emission** to guarantee long-term miner incentives.

* Emission Constants :
  - Initial block reward: 50 ADD.
  - Halving interval: 210,000 blocks.
  - Tail Emission: 1 ADD constant block reward.

* Degressive Reward Calculations :
  - Period 0 (Blocks 1 to 210k): 50 ADD/block -> 10,500,000 ADD emitted.
  - Period 1 (Blocks 210k to 420k): 25 ADD/block -> 5,250,000 ADD emitted.
  - Period 2 (Blocks 420k to 630k): 12.5 ADD/block -> 2,625,000 ADD emitted.
  - Period 3 (Blocks 630k to 840k): 6.25 ADD/block -> 1,312,500 ADD emitted.
  - Period 4 (Blocks 840k to 1.05M): 3.125 ADD/block -> 656,250 ADD emitted.
  - Period 5 (Blocks 1.05M to 1.26M): 1.5625 ADD/block -> 328,125 ADD emitted.
  - Period 6 and beyond (After block 1,260,000): The shifted reward divisions fall below 1 ADD. The protocol immediately locks in the Tail Emission, fixing the block reward permanently at 1 ADD per block to prevent mining rewards from ever falling to zero.

* Timeframe to Mine All Coins :
  - Total cumulative emissions by block 1,260,000: 20,671,875 ADD.
  - Supply remaining to reach the cap: 29,328,125 ADD.
  - At the constant Tail Emission rate of 1 ADD/block, it requires exactly 29,328,125 additional blocks, establishing a total network lifetime of 30,588,125 blocks to hit the strict maximum supply cap of 50,000,000 ADD.

The calendar timeframe to mine all coins depends on the block time setting of the network :
1. Performance / Local Stress Test Mode (5-second block time) :
   30,588,125 blocks * 5 seconds = 152,940,625 seconds = approx 4.85 years (4 years and 10 months).
2. Nominal Production Mode (60-second block time) :
   30,588,125 blocks * 60 seconds = 1,835,287,500 seconds = approx 58.2 years.

---

### B. What Gives ADDITION Value? (The Value Proposition)

The economic valuation of ADD is backed by five technological and macroeconomic pillars:

1. Strict Supply Scarcity :
   With a hard cap of 50,000,000 ADD, ADD is extremely scarce (only 2.3 times the supply of Bitcoin), protecting holders against inflationary devaluation.
2. Permanent Blockchain Security :
   Unlike Bitcoin (whose block reward will eventually fall to zero, raising security concerns if transaction fee volume is insufficient), ADDITION's 1 ADD Tail Emission guarantees that validators are always financially incentivized to secure the chain.
3. Inherent Post-Quantum Protection :
   In the coming years, commercial quantum computers will be capable of breaking the ECDSA cryptography backing Bitcoin and Ethereum. ADDITION is the only Layer 1 natively secured by NIST-standard lattice signatures (ML-DSA-87). ADD is a flight to safety, preserving assets against quantum compromises.
4. Energy Backed by Real Computational Utility (PoUW) :
   ADDITION's miners do not burn electricity on useless calculations. Mining runs Proof-of-Useful-Work (PoUW), allocating raw power to solve heavy machine learning tasks and decentralized storage validations, backing the value of ADD to real-world computing demand.
5. Decentralized Financial Sanctuary (ZK-Shield) :
   In a world of total financial surveillance, the ZK-Shield anonymous privacy pool allows users to execute anonymous, untraceable note transfers via nullifier validations, providing an uncompromised financial sanctuary.

---

# PART 2: FRENCH VERSION (VERSION FRANÇAISE - SECONDAIRE)

## 1. Résumé Exécutif

La blockchain **ADDITION** est un grand livre décentralisé de couche 1 (L1) conçu dès sa fondation pour l'ère post-quantique. Elle combine un consensus de preuve de travail à mémoire dure (**PoMW**), des signatures cryptographiques hybrides post-quantiques (**ML-DSA-87**), une confidentialité forte par preuves à divulgation nulle de connaissance (**ZK-Shield**), un moteur de smart contracts décentralisé à faible latence (**LDCE**), un cloud de calcul utile partagé (**PoUW**), et une messagerie anonyme éphémère. Le protocole fonctionne de manière purement décentralisée, autonome, sans permission (*permissionless*) et sans autorité centrale.

IMPORTANT : ADDITION résout le trilemme de la blockchain (Sécurité, Évolutivité, Décentralisation) en introduisant des mécanismes de sécurité post-quantique sans sacrifier le débit (TPS ciblé de 100 000) et en maintenant une décentralisation totale grâce à la résistance active aux ASICs.

---

## 2. Schéma Global de l'Architecture Réseau

Une fois lancé en production, le réseau est structuré en plusieurs couches coordonnées pour garantir la performance, l'accessibilité globale et la sécurité cryptographique :

[Couche Clients & Interfaces]
  - Interface Web BNKS.AI - Port 5173
  - Simulateurs d'ATM Physiques
  - Ligne de Commande Tiers - Port 18545
         |
         v (Fetch JSON-RPC)
[Couche Passerelle HTTP JSON-RPC - Port 8545]
  - addition_gateway.py <--> gateway_db.json (Session DB)
         |
         v (Liaison Locale avec Token)
[Couche L1 Nœud Principal (additiond.exe)]
  - RPC Local Sécurisé - Port 8546
  - RPC Réseau Public - Port 18545
  - Moteurs Core C++ Natifs :
    * Consensus PoMW Memory-Hard
    * Signatures ML-DSA-87
    * ZK-Shield / Privacy Pool
    * Smart Contracts VM
    * Calcul IA Partagé (PoUW)
    * Anonymous Messenger TTL
    * AMM Constant Product
         |
         v
[Couche P2P Global - Port 28545]
  - Gossip de Blocs & TXs <--> Autres Nœuds ADDITION Mondiaux

---

## 3. Schémas de Fonctionnement des Piliers Technologiques

### A. Consensus PoMW (Proof-of-Memory-Work)
L'algorithme de consensus `memory_hard_head64` est conçu pour résister aux accélérateurs matériels ASICs en forçant des lectures pseudo-aléatoires sur un scratchpad mémoire de **1 MiB**, limitant ainsi le goulot d'étranglement au bus de transfert mémoire (Memory Bandwidth Bound).

[Algorithme de minage PoMW] :
1. En-tête du bloc à miner (64 octets) --> Hachage initial Keccak-512.
2. Initialisation du Scratchpad (1 MiB de données en RAM).
3. Boucle de Lookup Mixing (64 itérations) :
   - Calcul de l'adresse de lecture A(i) basée sur l'état courant.
   - Lecture de 64 octets sur le Scratchpad à A(i).
   - Opération XOR & permutation non linéaire (Head64).
   - Écriture des 64 octets permutés à l'adresse A(i).
   - Passage à l'itération suivante.
4. Hachage final Keccak-512.
5. Si le Hash < Cible de Difficulté : Bloc validé et propagé sur le réseau P2P !
6. Sinon : Incrémentation du Nonce et retour à l'étape 1.

#### Qu'est-ce que le PoMW exactement ?

La Preuve de Travail Mesurable (PoMW) résout le problème majeur des blockchains traditionnelles (comme le SHA-256 de Bitcoin) : la centralisation industrielle du minage par les machines ASICs (puces électroniques spécialisées).

Voici les fondements techniques de son fonctionnement :

1. Le Problème du PoW Traditionnel :
   Sur Bitcoin, le hachage ne demande aucune mémoire vive. Des constructeurs ont développé des puces ASICs qui calculent des hashes à une vitesse extrême pour un coût infime, rendant les ordinateurs et processeurs (CPU) grand public obsolètes et centralisant le contrôle du réseau.

2. La Mémoire Dure (Memory-Hard) comme Solution :
   Le PoMW d'ADDITION exige que chaque calcul de hachage s'effectue sur un Scratchpad de 1 MiB résidant en mémoire vive (RAM). La puce de calcul doit exécuter une boucle de 64 itérations de Lookup Mixing :
   - Elle calcule une adresse de mémoire dynamique basée sur le hachage courant.
   - Elle effectue une opération de lecture physique sur la RAM à cette adresse.
   - Elle applique une permutation non linéaire Head64 puis réécrit la donnée.

3. Le Goulot d'Étranglement Physique (Memory Bandwidth Bound) :
   Comme les adresses d'accès mémoire sont pseudo-aléatoires et imprévisibles, le processeur du mineur subit des temps de latence matériels incompressibles en attendant que la mémoire physique lui retourne les données. Ainsi, même un ASIC à 10 000 $ reste bridé par la bande passante physique de sa mémoire vive. Un processeur d'ordinateur de bureau standard (CPU) devient tout à fait compétitif pour sécuriser le réseau.

4. Pourquoi "Mesurable" ? :
   La vitesse de traitement des accès mémoire par les nœuds est quantifiée et évaluée en permanence par le réseau. La difficulty s'ajuste dynamiquement de manière ultra-réactive pour garantir un temps de bloc cible de moins de 5 secondes, ce qui assure une fluidité maximale et des transactions validées quasi instantanément.

---

### B. Cycle de Signature Post-Quantique Hybride (ML-DSA-87)
ADDITION protège les fonds des utilisateurs contre la menace de l'informatique quantique en intégrant des signatures de réseau basées sur des structures algébriques (Lattice-based cryptography), standardisées sous le nom de **ML-DSA-87** (Dilithium5).

[Génération et validation des signatures] :
1. Génération de clés Dilithium5 --> Clé Publique (PK) + Clé Privée (SK).
2. Dérivation de l'adresse publique L1 : Double Hachage SHA3-512 de la clé publique (PK) -> Adresse de 40 caractères hex.
3. Signature de transaction :
   - Données de la transaction (From, To, Amount, Nonce) -> Hachage de la TX (Keccak-256).
   - Signature avec Clé Privée (SK) via ML-DSA-87.
   - Transaction signée complète (Données + Signature + PK) transmise aux validateurs.
4. Validation :
   - Le validateur exécute verify_message(PK, TXHash, Signature).
   - Si valide : Transaction intégrée dans le mempool.
   - Si invalide : Transaction rejetée instantanément.

---

### C. Pipeline ZK-Shield & Privacy Pool (Confidentialité Anonyme)
L'anonymisation dans ADDITION repose sur un Privacy Pool confidentiel basé sur des preuves à divulgation nulle de connaissance (Zero-Knowledge). L'utilisateur peut masquer ses flux en découpant des fonds en notes anonymes sécurisées par des clés nullifiers.

[Mécanisme de masquage ZK-Shield] :
1. Phase de Shielding (privacy_mint_zk) :
   - Dépôt de ADD depuis une adresse publique.
   - Génération de la Note confidentielle : Commitment = H(Montant, Secret, Clé_Proprio).
   - Génération de la ZK Range Proof (preuve que le montant est positif).
   - Soumission de la transaction de Shielding et ajout du Commitment dans l'arbre de Merkle.
2. Phase de Dépense Anonyme (privacy_spend_zk) :
   - Génération de la preuve de possession de la note dans l'arbre de Merkle.
   - Génération du Nullifier unique : Nullifier = H(Secret_Note, Index_Note).
   - Vérification anti-double dépense : Le Nullifier est recherché sur le registre. S'il est présent -> Rejet !
   - Validation de la ZK-STARK Proof (vérification du solde sans révéler l'identité ni la note d'origine).
   - Retrait vers adresse transparente OR note ZK confidentielle.

---

## 4. Spécifications Physiques & Performances Réseau

* Débit Global : 10 000 TPS (Mesuré en stress-test local) / 100 000 TPS (Mise à l'échelle cible).
* Temps de Bloc : Bloc résolu et scellé en < 5 secondes en local (retargeting dynamique).
* Frais de Réseau : Ajustement en temps réel (Frais minimum anti-spam de 1 Satoshi = 0.00000001 ADD).
* Sécurité Signature : Sécurité post-quantique à 100% (ML-DSA-87). Temps de calcul signature < 1,5 ms.
* Anonymisation : Masquage immédiat des ADD (ZK-Shield). Génération de preuves < 200 ms.
* Smart Contracts : VM LDCE (Low-latency Contract Engine) exécution quasi instantanée (< 0,1 ms).
* Messagerie : Quantum Anonymous Messenger (Purge TTL) destruction automatique au TTL.
* Calcul Partagé : PoUW IA Engine attribution de tâches complexes en < 1s par consensus de jurys.

#### Logique Économique des Frais (Fees) sur ADDITION L1

Comme sur la blockchain Bitcoin, ADDITION n'impose pas de frais minimums absolus inscrits de manière rigide au niveau du consensus de la blockchain. Une transaction à frais nuls est théoriquement constructible. Cependant, pour se prémunir contre les attaques de déni de service (DDoS) et de spams, les validateurs exécutent un filtre dynamique dans le mempool (C++ Relay Filter) :

1. L'unité interne en Satoshis :
   Toutes les valeurs financières de frais sont comptabilisées en unités indivisibles de Satoshis d'ADD (1 sat = 1e-8 ADD).
2. Signification du "Min Fee: 1" :
   La métrique Min Fee: 1 affichée dans le tableau de bord correspond à 1 Satoshi (soit 0.00000001 ADD), et non pas à 1.00 ADD ! C'est la plus petite unité de compte possible de la blockchain. Elle agit comme une barrière anti-spam : la transaction n'est pas gratuite, mais son coût réel est virtuellement nul pour un utilisateur standard.
3. Comparaison avec Bitcoin (BTC) :
   - Sur Bitcoin : Il n'y a pas de minimum en consensus, mais les nœuds appliquent un filtre par défaut (ex: 1000 sat/vByte). Si vous proposez des frais inférieurs, les nœuds rejettent la transaction de leur mempool de relais. Elle n'est pas transmise et n'arrive jamais aux mineurs.
   - Sur ADDITION L1 : C'est exactement le même principe, mais géré par un optimiseur de routage IA dynamique. Le démon additiond.exe calcule en continu l'encombrement du mempool. Si le réseau est vide, la barrière de relais s'abaisse à 1 satoshi (quasi gratuit). Si le réseau subit une forte congestion de transactions, la limite minimale conseillée augmente dynamiquement (ex: 100 ou 1000 satoshis, ce qui reste inférieur à 0.00001 ADD) afin de filtrer le spam et de donner la priorité aux transactions légitimes, créant un marché de frais compétitif et fluide.

---

## 5. Tableau Comparatif & Benchmark : ADDITION vs Cryptomonnaies Majeures

* ADDITION (ADD) :
  - Layer 1 | Consensus PoMW | Signature ML-DSA-87 + SHA3 | Résistance Quantique : Oui | Bloc : < 5s | Débit Réel : 10 000 (Mesuré local) | ZK-Shield | Smart Contracts : LDCE VM | IA PoUW : Oui

* Bitcoin (BTC) :
  - Layer 1 | Consensus PoW (SHA-256) | Signature ECDSA | Résistance Quantique : Non | Bloc : 10 min | Débit Réel : 7 | Confidentialité : Aucune | Smart Contracts : Non | IA PoUW : Non

* Ethereum (ETH) :
  - Layer 1 | Consensus PoS | Signature ECDSA + BLS | Résistance Quantique : Non | Bloc : 12s | Débit Réel : 15 - 30 | Confidentialité : Aucune | Smart Contracts : EVM | IA PoUW : Non

* Solana (SOL) :
  - Layer 1 | Consensus PoH + PoS | Signature Ed25519 | Résistance Quantique : Non | Bloc : 400ms | Débit Réel : 2500 - 65000 | Confidentialité : Aucune | Smart Contracts : Sealevel | IA PoUW : Non

* XRP (Ripple) :
  - Layer 1 | Consensus RPCA | Signature ECDSA/Ed25519 | Résistance Quantique : Non | Bloc : 3 - 5s | Débit Réel : 1500 | Confidentialité : Aucune | Smart Contracts : Non | IA PoUW : Non

* Monero (XMR) :
  - Layer 1 | Consensus PoW (RandomX) | Signature Ed25519 | Résistance Quantique : Non | Bloc : 2 min | Débit Réel : 10 - 100 | Confidentialité : RingCT + Clés Furtives | Smart Contracts : Non | IA PoUW : Non

* Zcash (ZEC) :
  - Layer 1 | Consensus PoW (Equihash) | Signature ECDSA | Résistance Quantique : Non | Bloc : 75s | Débit Réel : 26 | Confidentialité : zk-SNARKs | Smart Contracts : Non | IA PoUW : Non

* Cardano (ADA) :
  - Layer 1 | Consensus PoS | Signature Ed25519 | Résistance Quantique : Non | Bloc : 20s | Débit Réel : 250 | Confidentialité : Aucune | Smart Contracts : Plutus | IA PoUW : Non

* BNB Chain (BNB) :
  - Layer 1/L2 | Consensus PoSA | Signature ECDSA | Résistance Quantique : Non | Bloc : 3s | Débit Réel : 2200 | Confidentialité : Aucune | Smart Contracts : EVM | IA PoUW : Non

* TRON (TRX) :
  - Layer 1 | Consensus dPoS | Signature ECDSA | Résistance Quantique : Non | Bloc : 3s | Débit Réel : 2000 | Confidentialité : Aucune | Smart Contracts : TVM | IA PoUW : Non

* Dogecoin (DOGE) :
  - Layer 1 | Consensus PoW (Scrypt) | Signature ECDSA | Résistance Quantique : Non | Bloc : 1 min | Débit Réel : 33 | Confidentialité : Aucune | Smart Contracts : Non | IA PoUW : Non

* Stellar (XLM) :
  - Layer 1 | Consensus SCP | Signature Ed25519 | Résistance Quantique : Non | Bloc : 3 - 5s | Débit Réel : 1000 - 3000 | Confidentialité : Aucune | Smart Contracts : SSC | IA PoUW : Non

* Chainlink (LINK) :
  - Oracle L2 | Consensus PoS | Signature ECDSA | Résistance Quantique : Non | Bloc : N/A | Débit Réel : N/A | Confidentialité : Aucune | Smart Contracts : Multi-Chain | IA PoUW : Non

NOTE : Bien que certaines blockchains intègrent des mécanismes de confidentialité performants (comme Monero ou Zcash) ou des temps de bloc très rapides (comme Solana), ADDITION est la seule couche 1 à combiner nativement la résistance quantique globale (ML-DSA-87), la preuve à divulgation nulle (ZK-Shield), et un moteur de calcul décentralisé d'intelligence artificielle utile (PoUW).

---

## 6. Tokenomics, Modèle d'Émission & Proposition de Valeur

### A. Algorithme d'Émission & Temps pour Miner tous les Coins

L'approvisionnement maximal d'ADDITION est rigoureusement plafonné à 50 000 000 ADD (soit 5e15 Satoshis). L'émission monétaire suit une courbe dégressive par Halvings successifs, combinée à une Tail Emission (émission de queue) pour pérenniser la sécurité du réseau.

* Paramètres de base :
  - Récompense initiale de bloc : 50 ADD.
  - Intervalle de Halving : 210 000 blocs.
  - Émission de queue (Tail Emission) : 1 ADD constant.

* Calcul de la dégressivité :
  - Période 0 (blocs 1 à 210 000) : 50 ADD/bloc -> 10 500 000 ADD émis.
  - Période 1 (blocs 210 001 à 420 000) : 25 ADD/bloc -> 5 250 000 ADD émis.
  - Période 2 (blocs 420 001 à 630 000) : 12,5 ADD/bloc -> 2 625 000 ADD émis.
  - Période 3 (blocs 630 001 à 840 000) : 6,25 ADD/bloc -> 1 312 500 ADD émis.
  - Période 4 (blocs 840 001 à 1 050 000) : 3,125 ADD/bloc -> 656 250 ADD émis.
  - Période 5 (blocs 1 050 001 à 1 260 000) : 1,5625 ADD/bloc -> 328 125 ADD émis.
  - Période 6 et au-delà (à partir du bloc 1 260 000) : La récompense théorique divisée par 2 tombe sous la barre des 1 ADD. Le protocole active sa Tail Emission : la récompense se stabilise définitivement à 1 ADD par bloc.

* Durée de vie théorique du minage complet :
  - Émission cumulée au bloc 1 260 000 : 20 671 875 ADD.
  - Reste à émettre jusqu'à la limite absolue : 29 328 125 ADD.
  - Au rythme constant de 1 ADD par bloc (Tail Emission), il faudra exactement 29 328 125 blocs supplémentaires, soit un total de 30 588 125 blocs pour atteindre le plafond de 50 000 000 ADD.

Selon la configuration temporelle du réseau, la durée réelle pour miner l'intégralité des coins varie :
1. Mode Performance / Stress-test local (Bloc de 5 secondes) :
   30 588 125 blocs * 5 s = 152 940 625 secondes = environ 4,85 ans (4 ans et 10 mois).
2. Mode Nominal de Production (Bloc de 60 secondes) :
   30 588 125 blocs * 60 s = 1 835 287 500 secondes = environ 58,2 ans.

---

### B. Pourquoi ADDITION a-t-elle de la Valeur ? (Proposition de Valeur)

La valeur économique de l'ADD repose sur cinq piliers techniques et macroéconomiques solides qui en font un actif hautement compétitif par rapport aux autres cryptomonnaies :

1. Rareté absolue garantie par le code :
   Avec un cap de 50 000 000 ADD, l'ADD is extremely scarce (only 2.3 times the supply of Bitcoin), protecting holders against inflationary devaluation.
   
2. Sécurité à très long terme (Tail Emission) :
   Contrairement à Bitcoin (dont la récompense de bloc finira par tomber à zéro, menaçant la rémunération des mineurs et la sécurité du réseau), ADDITION conserve une émission résiduelle perpétuelle de 1 ADD par bloc. Cela assure que les validateurs seront toujours rémunérés pour sécuriser la blockchain, même dans 100 ans.

3. La Souveraineté Post-Quantique :
   D'ici quelques années, les ordinateurs quantiques seront capables de casser la cryptographie ECDSA de Bitcoin et d'Ethereum. ADDITION est la seule Layer 1 nativement immunisée grâce aux signatures ML-DSA-87 (Dilithium5). Posséder des ADD, c'est posséder le seul actif financier qui conservera son intégrité et sa valeur dans le monde de demain.

4. Adossement à une ressource réelle : Le calcul IA (PoUW) :
   Le consensus de minage d'ADDITION n'est pas une perte d'énergie stérile. Les mineurs effectuent de la Preuve de Calcul Utile (PoUW) en résolvant des tâches d'intelligence artificielle ou de stockage distribué. La valeur de l'ADD est donc adossée à une ressource concrète et recherchée dans le monde réel : la puissance de calcul brute.

5. Le Refuge de la Confidentialité Totale (ZK-Shield) :
   Dans un contexte géopolitique de surveillance financière constante et de traçabilité totale, le pool de confidentialité ZK-Shield permet de crypter des fonds et de les échanger de manière anonyme et indétectable, conférant à l'ADD une valeur de refuge financier inégalée.

---

## 7. Manuel Exhaustif de toutes les Commandes RPC du Démon

Le démon additiond.exe accepte les commandes RPC textuelles suivantes sur ses interfaces TCP :

* getinfo - Affiche les informations globales et dynamiques en temps réel sur l'état de la blockchain.
* protocol_status - Affiche l'état de performance et les métriques de conformité (100 000 TPS).
* fee_info - Affiche l'état des frais minimaux dynamiques conseillés, calculés par l'optimiseur de routage IA.
* monetary_info - Affiche l'état de l'émission monétaire, l'approvisionnement maximal d'ADD (50 000 000 ADD).
* crypto_selftest - Lance un auto-test unitaire des algorithmes cryptographiques post-quantiques (ML-DSA-87).
* quit / exit - Arrête proprement le démon L1 et sauvegarde l'état complet.
* createwallet - Génère un nouveau portefeuille post-quantique réel ML-DSA-87.
* getbalance <adresse> - Retourne le solde confirmé d'ADD résidant sur l'adresse L1 spécifiée.
* getbalance_instant <adresse> - Calcule le solde instantané de l'adresse (blockchain + mempool).
* tx_build <provenance> <clé_publique_hex> <destination> <montant> <frais> <nonce> - Construit une transaction brute non signée.
* sign_message <clé_privée_hex> <message_hex_utf8> - Signe un message via ML-DSA-87.
* verify_message <clé_publique_hex> <message_hex_utf8> <signature_hex> - Vérifie une signature.
* sendtx_signed <provenance> <clé_publique_hex> <destination> <montant> <frais> <nonce> <signature_hex> - Soumet une transaction signée au mempool.
* sendtx_signed_hash <provenance> <clé_publique_hex> <destination> <montant> <frais> <nonce> <signature_hex> - Soumet la transaction et retourne son hachage unique.
* tx_status <hachage_tx> - Interroge l'état d'une transaction (pending, block height, unknown).
* mine [adresse_récompense] [nombre_threads] - Lance le mineur PoMW pour forger le prochain bloc (récompense de 50 ADD).
* benchmark_objective <nombre_blocs> <txs_par_bloc> - Lance un benchmark de stress de performances matérielles.
* stake <adresse> <montant> - Verrouille une quantité d'ADD en staking L1.
* unstake <adresse> <montant> - Déverrouille une quantité d'ADD préalablement stakée.
* staked <adresse> - Retourne le montant total d'ADD actuellement verrouillé en staking.
* stake_claimable <adresse> - Calcule les récompenses d'intérêts de staking accumulées.
* stake_claim <adresse> - Réclame et crédite toutes les récompenses de staking.
* privacy_status - Affiche l'état de configuration du pool confidentiel ZK-Shield.
* privacy_mint_zk - Verrouille des ADD publics et génère une note privée anonymisée (ZK-Shield).
* privacy_spend_zk - Dépense une note privée anonyme pour la transférer ou la convertir en ADD publics.
* token_create <symbole> <propriétaire> <max_supply> <initial_mint> - Déploie un nouveau jeton personnalisé.
* token_mint <symbole> <appelant> <destinataire> <montant> - Émet une nouvelle quantité de jetons.
* token_transfer <symbole> <provenance> <destination> <montant> - Effectue un transfert de jetons.
* token_balance <symbole> <propriétaire> - Retourne le solde de jetons spécifiques d'une adresse.
* token_info <symbole> - Affiche les métriques de base du jeton.
* swap_pool_create <token_a> <token_b> <frais_bps> - Déploie un pool de liquidité AMM Constant Product.
* swap_add_liquidity - Ajoute des jetons au pool de liquidité.
* swap_remove_liquidity - Brûle des LP tokens et restitue la liquidité.
* swap_quote - Calcule la quantité de jetons de sortie estimée pour un swap.
* swap_exact_in - Exécute une transaction de swap directe entre deux jetons.
* swap_quote_route - Calcule le prix estimé à travers un chemin d'échange multi-paires.
* swap_best_route - Utilise l'algorithme d'optimisation de routage IA pour trouver le meilleur chemin.
* pm_send_ttl - Envoie un message anonyme chiffré qui s'auto-détruira définitivement après expiration.
* pm_inbox - Interroge la boîte de réception des enveloppes de messages anonymes.
* pm_status - Affiche le statut d'un message (en attente, expiré, lu).
* pm_fetch - Récupère et déchiffre l'enveloppe de message anonyme.
* pm_destroy - Supprime immédiatement et définitivement un message.
* pouw_compute_submit_job - Soumet une tâche de calcul lourd au cloud décentralisé PoUW.
* pouw_compute_job_status - Affiche l'état d'avancement d'une tâche PoUW.
* addpeer <ip:port> - Connecte le nœud à une nouvelle adresse IP de pair.
* delpeer <ip:port> - Déconnecte et supprime l'adresse IP du pair.
* peers - Affiche la liste des adresses IP des pairs connectés.
* sync - Force une synchronisation immédiate avec les pairs du réseau P2P.
