# CoinCoin (CCOIN)
## Whitepaper Ufficiale — Versione 1.0
### *A Pure Proof-of-Work Store-of-Value on EVM Layer-2: "Una Moneta per Ogni Persona sulla Terra"*

**Data:** Settembre 2026  
**Autore:** CoinCoin Foundation & Founder  
**Ticker Ufficiale:** `CCOIN`  
**Standard Tecnico:** ERC-20 + ERC-918 (Mineable Token Standard)  
**Rete di Riferimento:** EVM Layer-2 (Base / Arbitrum)  
**Licenza:** Open Source (MIT)

---

## Indice dei Contenuti
1. [Abstract](#1-abstract)
2. [Visione Filosofica & Simbolismo](#2-visione-filosofica--simbolismo)
3. [Il Problema del Web3 Odierno](#3-il-problema-del-web3-odierno)
4. [La Soluzione CoinCoin: Fair Mining su Layer-2](#4-la-soluzione-coincoin-fair-mining-su-layer-2)
5. [Architettura Tecnica & Mining Engine (ERC-918)](#5-architettura-tecnica--mining-engine-erc-918)
6. [Tokenomica & Modello Matematico di Emissione](#6-tokenomica--modello-matematico-di-emissione)
7. [Protezione Crittografica & Resistenza al Front-Running](#7-protezione-crittografica--resistenza-al-front-running)
8. [Conformità Normativa, Legale & Safe Harbor (MiCA)](#8-conformità-normativa-legale--safe-harbor-mica)
9. [Roadmap di Sviluppo](#9-roadmap-di-sviluppo)
10. [Specifiche di Protocollo](#10-specifiche-di-protocollo)

---

## 1. Abstract

**CoinCoin (CCOIN)** è un protocollo di riserva di valore decentralizzato, programmato su un Layer-2 EVM ad alta efficienza energetica e a bassissime commissioni. A differenza della stragrande maggioranza dei token moderni distribuiti tramite vendite speculative (ICO/IDO) o airdrop passivi manipolati da bot (*helicopter money*), CoinCoin implementa un meccanismo di coniazione **esclusivamente basato su Proof-of-Work (PoW)** gestito on-chain tramite lo standard **ERC-918**.

La supply totale è rigidamente fissata a **9.999.999.999 CCOIN**, cifra simbolica ancorata al picco demografico stimato delle Nazioni Unite per il XXI secolo: *"una moneta ideale per ogni essere umano che potrà mai calcare la Terra"*. 

Il **3%** (300.000.000 CCOIN) è allocato al fondatore per lo sviluppo dell'infrastruttura, il mantenimento e la liquidità di scambio iniziale. Il restante **97%** (9.699.999.999 CCOIN) può essere generato unicamente attraverso l'attività di mining computazionale da parte della comunità globale, con blocchi da **9 minuti** e un ciclo di **Halving al 50% ogni 199.999 blocchi** (~3,42 anni).

---

## 2. Visione Filosofica & Simbolismo

La genesi di Bitcoin nel 2009 ha introdotto per la prima volta nella storia la scarsità digitale assoluta. Tuttavia, nel corso dell'ultimo decennio, il mondo crypto si è allontanato dalle sue radici ideali, trasformandosi prevalentemente in un casinò speculativo dominato da venture capitalist, distribuzioni diseguali e insider trading.

CoinCoin nasce con l'intento opposto:
* **Una Moneta per Ogni Persona:** Il tetto massimo di `9.999.999.999` non rappresenta la presunzione di distribuire istantaneamente un token a ogni abitante, bensì il **limite morale e matematico** verso cui la rete converge nel lungo periodo.
* **La Simmetria del 9:** 
  * Cap: $9.999.999.999$
  * Tempo di blocco: $9\text{ minuti}$
  * Allocazione fondatore: $3\%$ (il divisore perfetto: $3 \times 3 = 9$)
  * Quota comunitaria: $97\%$
  * Il numero 9 rappresenta il compimento, la totalità e la maturità di un ciclo.
* **Valore Generato dallo Sforzo:** Nessun bene ha valore durevole se regalato senza motivo. La moneta acquisisce valore intrinseco e rispetto perché ogni singola unità prodotta richiede tempo di calcolo, elettricità e attenzione umana.

---

## 3. Il Problema del Web3 Odierno

L'ecosistema crypto contemporaneo soffre di tre patologie strutturali:

1. **Il Fallimento dell'Helicopter Money (Airdrop & Faucet):**  
   Quando un progetto distribuisce token gratuiti tramite airdrop, subisce l'assalto di farm automatizzate (*Sybil attack*), dove singoli programmatori controllano migliaia di portafogli virtuali. Il risultato è la rapida svalutazione della moneta (*dumping*) e zero fidelizzazione reale della community.
2. **La Trappola delle ICO / Vendite Private:**  
   La raccolta di capitali tramite vendita di token introduce aspettative speculative di profitto, configurando il token come strumento finanziario (*security*) e attirando l'attenzione sanzionatoria dei regolatori internazionali (SEC, ESMA).
3. **Le Barriere d'Accesso del Mining Industriale:**  
   Il mining di Bitcoin su Layer-1 richiede oggi enormi capannoni industriali e macchinari ASIC da milioni di dollari, escludendo completamente i singoli cittadini e gli utenti comuni.

---

## 4. La Soluzione CoinCoin: Fair Mining su Layer-2

CoinCoin unisce la purezza distributiva di Bitcoin con la modernità dei Layer-2 di Ethereum:

```mermaid
graph LR
    subgraph "Consenso e Sicurezza (Ereditati)"
        ETH[Ethereum L1] --- L2[Base / Arbitrum L2]
    end

    subgraph "Distribuzione (CoinCoin Engine)"
        L2 --> SC[Smart Contract CoinCoin]
        Miner[Minatore con PC/Laptop] -->|Trova Nonce PoW| SC
        SC -->|Conia 24.250 CCOIN| Miner
    end
```

* **Zero Costi di Nodi di Rete:** I blocchi della blockchain sono convalidati dall'infrastruttura sicura di Ethereum e del Layer-2.
* **Gas Fee Quasi Nulle (< $0,01):** Risolvere un blocco e inviare la transazione costa frazioni di centesimo.
* **Mining Democratico per CPU:** La sfida crittografica è pensata per essere risolvibile da normali computer domestici o persino dal browser web, senza costringere gli utenti all'acquisto di hardware dedicato.
* **Accesso Universale tramite Smart Wallet:** Gli utenti possono detenere e gestire i propri CCOIN anche senza trascrivere 12 parole su carta, usando l'impronta digitale o il FaceID del proprio smartphone (standard ERC-4337 / Passkeys).

---

## 5. Architettura Tecnica & Mining Engine (ERC-918)

Lo Smart Contract `CoinCoin.sol` implementa l'interfaccia **ERC-20** arricchita con le logiche native dello standard **ERC-918 (Mineable Token Standard)**.

### 5.1 La Sfida Crittografica
Il contratto espone una variabile pubblica `challengeNumber` di 32 byte.  
Per minare un blocco, il client deve trovare un valore intero a 256 bit (`nonce`) tale per cui:

$$\text{uint256}\Big(\text{keccak256}\big(\text{challengeNumber}, \text{msg.sender}, \text{nonce}\big)\Big) \le \text{miningTarget}$$

Dove:
* `challengeNumber`: È il seme crittografico del blocco corrente, aggiornato ad ogni blocco estratto con:  
  $\text{keccak256}(\text{digest}, \text{blockhash}(\text{block.number} - 1), \text{block.timestamp})$.
* `msg.sender`: L'indirizzo del wallet del minatore (garantisce l'immunità al furto di soluzione).
* `miningTarget`: Il limite numerico superiore che definisce la difficoltà. Minore è il target, maggiore è la difficoltà.

### 5.2 Algoritmo di Ricalcolo della Difficoltà
Il protocollo adegua dinamicamente `miningTarget` ogni **160 blocchi** (pari a circa 24 ore di tempo standard a 9 minuti per blocco):

$$\text{TARGET\_INTERVAL\_TIME} = 160 \times 540\text{ secondi} = 86.400\text{ secondi (1 giorno)}$$

Sia $\Delta t$ il tempo reale trascorso per estrarre gli ultimi 160 blocchi. Per prevenire sbalzi improvvisi, il protocollo applica un fattore di smorzamento (*damping*) limitato tra $\frac{1}{4}\times$ e $4\times$:

$$\Delta t_{\text{effettivo}} = \min\Big(\max\Big(\Delta t, \frac{\text{TARGET\_INTERVAL\_TIME}}{4}\Big), \text{TARGET\_INTERVAL\_TIME} \times 4\Big)$$

Il nuovo target viene calcolato proporzionalmente:

$$\text{miningTarget}_{\text{nuovo}} = \frac{\text{miningTarget}_{\text{vecchio}} \times \Delta t_{\text{effettivo}}}{\text{TARGET\_INTERVAL\_TIME}}$$

Se la potenza di calcolo della rete aumenta ($\Delta t$ diminuisce), il target scende, rendendo più difficile l'estrazione successiva.

---

## 6. Tokenomica & Modello Matematico di Emissione

### 6.1 Parametri Fondamentali

| Parametro | Valore | Note |
| :--- | :--- | :--- |
| **Max Supply Totale** | $9.999.999.999$ CCOIN | Immutabile a livello di bytecode |
| **Quota Fondatore (3%)** | $300.000.000$ CCOIN | Coniata una tantum all'atto del deploy |
| **Quota Mining (97%)** | $9.699.999.999$ CCOIN | Sigillata nel contratto, rilasciata solo via PoW |
| **Tempo Target per Blocco** | $9\text{ minuti}$ | 160 blocchi/giorno — 58.440 blocchi/anno |
| **Intervallo di Halving** | $199.999\text{ blocchi}$ | $\sim 3,42\text{ anni}$ per Era |
| **Ricompensa Iniziale ($R_0$)** | $24.250\text{ CCOIN}$ | Dimezzata ogni $199.999$ blocchi |

### 6.2 Curva di Halving (Serie Geometrica)
Sia $e = \lfloor \frac{\text{epochCount}}{199.999} \rfloor$ l'indice dell'Era corrente. La ricompensa di blocco $R(e)$ è definita da:

$$R(e) = \frac{R_0}{2^e} = \frac{24.250}{2^e}\text{ CCOIN}$$

L'emissione cumulativa complessiva tende asintoticamente al limite teorico:

$$\sum_{e=0}^{\infty} \Big(199.999 \times \frac{24.250}{2^e}\Big) = 199.999 \times 24.250 \times \sum_{e=0}^{\infty} 2^{-e} = 4.849.975.750 \times 2 \approx \mathbf{9.699.951.500}\text{ CCOIN}$$

La minima differenza frazionaria residua viene assorbita con l'esaurimento esatto del cap di 9.699.999.999, garantendo che **la coniazione si arresti tassativamente al raggiungimento del tetto massimo**.

```mermaid
xychart-beta
    title "Evoluzione della Supply Totale nel Tempo (Miliardi di CCOIN)"
    x-axis ["Lancio", "Era 1 (Anno 3.4)", "Era 2 (Anno 6.8)", "Era 3 (Anno 10.2)", "Era 4 (Anno 13.6)", "Era 5 (Anno 17)"]
    y-axis "Miliardi di CCOIN" 0 --> 10
    line [0.30, 5.15, 7.57, 8.78, 9.39, 9.70]
```

---

## 7. Protezione Crittografica & Resistenza al Front-Running

Nelle reti blockchain pubbliche, le transazioni in attesa sono visibili all'interno della *mempool*. In un sistema di mining ingenuo, un bot monitorerebbe la mempool per intercettare il nonce vincente inviato da un minatore onesto e lo reinvierebbe istantaneamente pagando una commissione prioritaria più alta, rubando la ricompensa di blocco.

CoinCoin neutralizza questo vettore di attacco alla radice introducendo l'indirizzo del minatore all'interno dell'hash preimage:

$$\text{digest} = \text{keccak256}\big(\text{challengeNumber}, \mathbf{msg.sender}, \text{nonce}\big)$$

Poiché `msg.sender` è verificato dal runtime della Ethereum Virtual Machine in modo incorruttibile:
1. Una soluzione valida calcolata dal portafoglio di `Alice` produrrà un digest valido **soltanto ed esclusivamente** se la transazione proviene dal portafoglio di `Alice`.
2. Se un bot `Bob` tenta di rubare il nonce di `Alice`, la sua transazione calcolerà $\text{keccak256}(\text{challenge}, \text{Bob}, \text{nonce}) > \text{target}$, fallendo istantaneamente e facendo perdere a `Bob` le commissioni di gas.

---

## 8. Conformità Normativa, Legale & Safe Harbor (MiCA)

CoinCoin è stato architettato per rispettare i più rigorosi criteri normativi internazionali, in particolare il regolamento dell'Unione Europea **MiCA (Markets in Crypto-Assets - Regolamento UE 2023/1114)** e la giurisprudenza statunitense sul Test di Howey:

1. **Assenza di Vendita Iniziale / No ICO:** Il protocollo non ha raccolto alcun fondo monetario da investitori o dal pubblico. Nessun token è stato venduto in cambio di valuta fiat o altre criptovalute.
2. **Nessuna Promessa di Rendimento:** La documentazione ufficiale, il codice sorgente e le comunicazioni pubbliche escludono in modo esplicito qualsiasi garanzia o aspettativa di apprezzamento economico, profitto passivo, dividendo o riacquisto (*buyback*).
3. **Estrazione via Lavoro Oggettivo (Proof-of-Work):** I token entrano in circolazione unicamente come compenso per un'attività computazionale verificabile. In base alla classificazione MiCA, il token rientra tra i **Crypto-asset generici / Utility** estratti decentralmente, sollevandolo dai gravosi obblighi riservati agli Asset-Referenced Token (ART) e agli E-Money Token (EMT).
4. **Nessun Potere di Censura o Freeze:** Lo Smart Contract non contiene funzioni amministrative di congelamento fondi (*blacklist*), pause arbitrarie o diritti speciali di coniazione post-deploy.

---

## 9. Roadmap di Sviluppo

```mermaid
flowchart TD
    F1["Fase 1: Genesi & Architettura (Completata)"] --> F2["Fase 2: Testnet Pubblica & Web App (In Corso)"]
    F2 --> F3["Fase 3: Lancio Base Mainnet & Mining Comunitario"]
    F3 --> F4["Fase 4: Ecosistema & Transizione AppChain (Futuro)"]

    F1 -.->|Q3 2026| F1A["Smart contract, test suite 100%, whitepaper v1.0"]
    F2 -.->|Q4 2026| F2A["Deploy Base Sepolia, Web Miner in browser, verifica Basescan"]
    F3 -.->|Q1 2027| F3A["Apertura Blocco Genesi, pool liquidità iniziale DEX, community hub"]
    F4 -.->|Orizzonte Lungo| F4A["Se >100.000 minatori: migrazione L3 o catena autonoma sovrana"]
```

---

## 10. Specifiche di Protocollo

| Voce | Specifica Tecnica |
| :--- | :--- |
| **Token Name** | `CoinCoin` |
| **Ticker** | `CCOIN` |
| **Decimals** | 18 |
| **Contratto Base** | OpenZeppelin ERC20, ERC20Permit (v5.0.2) |
| **Interfaccia Mining** | ERC-918 Mineable Token Standard |
| **EVM Target** | Cancun (Solidity `0.8.24`, optimizer attivo a 200 runs) |
| **Hard Cap Totale** | $9.999.999.999 \times 10^{18}$ |
| **Allocazione Fondatore** | $300.000.000 \times 10^{18}$ (3%) |
| **Allocazione Mining** | $9.699.999.999 \times 10^{18}$ (97%) |
| **Target Blocco** | 540 secondi (9 minuti) |
| **Halving Blocks** | 199.999 blocchi |
| **Reward Iniziale** | $24.250 \times 10^{18}$ CCOIN |
| **Intervallo Difficoltà** | 160 blocchi |
| **Algoritmo Hash** | `keccak256(challenge, minerAddress, nonce)` |
