Glossaire

Les mots des pages 1 à 5, dans l'ordre alphabétique. Chaque entrée dit l'essentiel en deux ou trois phrases et renvoie à la page qui développe. Les chiffres et leurs sources sont dans les pages, pas ici.

  • ABI : La description publique des fonctions d'un contrat, leurs noms, leurs arguments et ce qu'elles renvoient. C'est elle qui permet à cast de parler au coffre. → page 3
  • adresse : L'identifiant d'un compte sur la chaîne, une suite de caractères commençant par 0x. Une adresse simple est tenue par une clé privée et ne porte aucun code ; un contrat est une adresse qui porte du code. → page 5
  • attestation : Le fait, pour l'oracle, d'avoir finalisé le hash d'une hauteur Bitcoin après assez de votes identiques. En v2, l'attestation du bloc engagé déclenche le sweep suivant. → page 2
  • attestor : Un robot, tenu par une adresse propre, qui lit un bloc Bitcoin sur des sources indépendantes qui doivent concorder, puis vote son hash dans l'oracle. Leur liste est fixe ; au pilote, le builder les opère tous ; en v3, des attestors extérieurs sont à l'étude. → page 5
  • bloc (Bitcoin) : Un paquet de transactions Bitcoin, trouvé par un mineur, empilé sur le précédent. Chaque bloc a une hauteur et un hash ; c'est ce hash qui sert de hasard au tirage. → page 2
  • bloc (Robinhood Chain) : La même notion sur Robinhood Chain, la chaîne où vivent les contrats NetNat. Les pages citent un numéro de bloc Robinhood pour dater une lecture ou la création d'un contrat. → page 5
  • bloc engagé : Le bloc Bitcoin, désigné par sa hauteur, sur lequel un tirage est engagé au moment du sweep, avant qu'il n'existe. L'engagement est irrévocable : si le bloc tarde, le tirage attend, il n'est jamais rejoué sur un autre bloc. → page 2
  • Blockscout : Un explorateur de Robinhood Chain, un site qui montre les blocs, les adresses et le code vérifié des contrats. RobinScan en est un autre. → page 5
  • bonus de présence : Le supplément de tickets accordé à un déposant pour chaque tirage où il était présent, jusqu'à un plafond. Un retrait total le remet à zéro ; un retrait partiel le conserve. → page 2
  • builder : Celui qui construit et opère NetNat Capital au pilote : il fait tourner le keeper et les attestors, et reçoit une part de la commission. → page 5
  • CAP_ADMIN : La seule adresse à pouvoir relever le plafond de dépôt, jamais le baisser, après un délai d'attente. Elle ne touche ni aux dépôts, ni aux pots, ni aux tirages, ni à l'oracle. → page 5
  • cast : L'outil en ligne de commande de Foundry qui lit la chaîne, sans wallet ni clé. Toutes les vérifications des pages 3 et 5 s'appuient sur lui. → page 3
  • chaîne (blockchain) : Le registre public et partagé où sont inscrits les contrats, les soldes et les transactions. Ici, Robinhood Chain ; Bitcoin est une autre chaîne, utilisée seulement pour son hasard.
  • clé privée : Le secret qui contrôle une adresse et signe ses transactions. Lire la chaîne n'en demande aucune ; chaque attestor vote avec la sienne. → page 3
  • code source vérifié (Exact Match) : Un code source publié sur un explorateur et reconnu identique, octet pour octet, au code déployé à l'adresse. C'est ainsi qu'on lit ce que fait réellement un contrat. → page 5
  • coffre (vault) : Le contrat NetNatVault, qui reçoit les dépôts, prélève le surplus, engage le bloc Bitcoin et paie les lots. Il garde le principal et ne le vend jamais. → page 1
  • commission : La part du pot prélevée après la prime du keeper et partagée entre NATStaking, le trésor et le builder. Au pilote, elle est nulle pendant un délai après le déploiement ; en v2, elle s'applique dès le premier tirage, à un taux plus élevé. → page 2
  • confirmation (Bitcoin) : Un bloc miné au-dessus d'un bloc donné. Les attestors attendent plusieurs confirmations avant de voter, par précaution contre une réorganisation. → page 2
  • contrat (smart contract) : Un programme déployé sur la chaîne à une adresse fixe, qui applique ses règles sans intervention humaine. Les contrats NetNat sont listés à la page 5. → page 5
  • Contrats immuables : La formule qui résume les pouvoirs sur NetNat : pas de proxy, pas de mise à jour, pas de pause, pas de clé maîtresse. Un seul pouvoir privilégié existe, celui de CAP_ADMIN. → page 5
  • déballer / emballer (unwrap, wrap) : Emballer, c'est convertir du sNET en wsNET ; déballer, l'inverse. Le nombre de wsNET ne bouge pas, c'est sa valeur en sNET qui monte. → page 1
  • décimales : Le nombre de chiffres après la virgule qu'un jeton distingue. Le NAT n'en a aucune, ses quantités sont des entiers ; les autres jetons en ont un nombre propre. → page 5
  • DEPLOY.md : Le mode d'emploi du déploiement et de l'exploitation du pilote, document de référence du builder. La page 5 cite ses sections.
  • dépôt / retrait : Déposer, c'est confier du wsNET au coffre ; retirer, c'est reprendre son principal, à tout moment, sans délai ni pénalité. → page 1
  • epoch : Un cycle complet du protocole : un sweep, un tirage. Le coffre numérote les tirages à partir de zéro ; epochId est le numéro du prochain. → page 3
  • ETH : La monnaie native de Robinhood Chain, qui paie le gas de chaque transaction. C'est aussi la contrepartie du NAT dans la pool Uniswap v4. → page 5
  • événement (event) : Une trace qu'un contrat écrit dans les journaux de la chaîne quand quelque chose se produit : un tirage réglé, une proposition de plafond, un vote divergent. On la lit après coup ; au pilote, c'est le résultat officiel d'un tirage. → page 3
  • finalisation (d'une hauteur) : Le moment où l'oracle fixe le hash d'une hauteur, dès que le seuil de votes identiques est atteint. Une hauteur finalisée ne se réécrit jamais. → page 2
  • fraîcheur (de l'oracle) : L'exigence d'un vote récent dans l'oracle avant tout sweep. Sans oracle frais, pas de sweep. → page 2
  • gas : Le coût d'exécution d'une opération sur la chaîne, payé en ETH par celui qui l'envoie. Les robots le paient à chaque appel. → page 5
  • graine (seed) : Le nombre dont découlent tous les lots d'un tirage : l'empreinte keccak256 du hash Bitcoin, de l'adresse du coffre et du numéro du tirage, mis bout à bout. Elle se recalcule à la main. → page 3
  • hash (empreinte) : Un résumé de taille fixe d'une donnée, tel qu'un seul octet changé donne un résultat sans rapport. Le hash d'un bloc Bitcoin est son identité ; personne ne peut le prévoir avant que le bloc existe. → page 2
  • hauteur (Bitcoin) : Le numéro d'ordre d'un bloc Bitcoin depuis le premier. Le coffre engage un tirage sur une hauteur ; l'oracle donne le hash de cette hauteur. → page 2
  • horodatage (timestamp) : La date et l'heure d'un bloc, comptées en secondes. Le coffre note l'horodatage de chaque sweep. → page 3
  • immuable (immutable) / proxy : Un contrat immuable garde à jamais le code déployé. Un proxy est un contrat qui renvoie ses appels vers un autre, remplaçable, dont l'adresse est rangée dans une case de stockage normalisée (EIP-1967) ; les contrats NetNat n'en ont pas, et cela se vérifie. → page 5
  • jeton (token) : Un actif inscrit sur la chaîne et transférable d'une adresse à une autre : NET, sNET, wsNET, USDG, NAT.
  • keccak256 : La fonction d'empreinte des contrats, qui transforme n'importe quelle donnée en un hash de taille fixe. La graine et chaque lot en sortent. → page 3
  • keeper : Le robot qui appelle les étapes du cycle, sweep, tranches et règlement, pour que ça tourne. Chacune est ouverte à tous ; celui du builder les appelle, et la prime revient à qui règle. → page 5
  • liste figée : La liste des participants et de leurs tickets, arrêtée au sweep et jamais modifiée ensuite. Un dépôt ou un retrait après le sweep ne compte que pour le tirage suivant ; un gagnant qui a retiré est payé quand même. → page 2
  • lot : Une part du pot net attribuée à un ticket tiré au sort. Un tirage en compte plusieurs, un gros et des petits, tirés indépendamment ; une même adresse peut en gagner plusieurs. → page 2
  • mempool.space : Un site public qui affiche les blocs Bitcoin, leur hauteur et leur hash. Le hash retenu par l'oracle est celui que vous y lisez, tel quel. → page 3
  • modulo : Le reste d'une division entière. Chaque lot ramène un grand nombre « modulo le poids total » pour obtenir un numéro de ticket. → page 3
  • multisig : Une adresse contrôlée par plusieurs clés, dont un nombre minimum doit signer. Le trésor et le builder du pilote sont des adresses simples ; un multisig pourrait recevoir leurs fonds plus tard. → page 5
  • NAT : Le jeton des lots, sans décimale, ponté sur Robinhood Chain depuis une autre chaîne. NetNat n'en crée jamais : tout NAT distribué a été acheté sur le marché. → page 1
  • NATStaking : Le contrat où arrivent les lots, stakés par défaut, et où un détenteur de NAT peut staker pour recevoir une part de la commission, en NAT ou en wsNET selon sa préférence. Aucun blocage : on retire quand on veut. → page 1
  • NET : Le jeton de NetNet Capital. Le staker donne du sNET ; le vendre paie la taxe NetNet. → page 1
  • NetNat Capital : Le protocole décrit par ces pages : une loterie sans perte pour les détenteurs de NET, dont le hasard vient de Bitcoin. À ne pas confondre avec NetNet. → page 1
  • NetNet (Capital) : Le projet qui émet NET et fait tourner son staking, son rebase, sa taxe et son Wrap Desk. NetNat s'appuie dessus sans en faire partie. → page 1
  • nonce : Un nombre à usage unique qu'on peut ajouter à une graine pour qu'elle ne se répète jamais. En ajouter un à la graine de NetNat est une décision reportée. → page 1
  • on-chain (lu on-chain) : Se dit d'une donnée lue directement sur la chaîne, avec cast ou un explorateur, et non recopiée d'un document. Les pages marquent ainsi la source de chaque valeur relue. → page 3
  • oracle : Le contrat BTCOracle, qui enregistre les votes des attestors et finalise le hash de chaque hauteur Bitcoin. Il ne fait que rapporter ; personne ne peut changer sa liste d'attestors. → page 5
  • packed (encodage) : La mise bout à bout des données, sans remplissage ni en-tête, avant d'en prendre l'empreinte. La graine se calcule ainsi ; l'encodage standard donnerait un autre nombre. → page 3
  • paire / pool : Une réserve de deux jetons sur laquelle on échange l'un contre l'autre. Le NET se vend contre USDG sur une paire Uniswap v2 ; le NAT s'achète contre ETH sur une pool Uniswap v4. → page 5
  • pilote / v2 / v3 : Le pilote est le premier déploiement, en cours, à petit plafond, celui que les pages décrivent. v2 est le redéploiement prévu avant l'ouverture publique, avec de nouveaux contrats et de nouveaux paramètres ; v3, à l'étude, élargirait les attestors. → page 1
  • plafond de dépôt : Le total de principal que le coffre accepte, compté en sNET. Il ne peut que monter, par CAP_ADMIN, après un délai. → page 5
  • poids total : La somme des tickets de la liste figée. Vos chances sont vos tickets divisés par ce poids. → page 2
  • pot brut / pot net : Le pot brut est le NAT acheté pour un tirage. Le pot net est ce qui reste après la prime du keeper et la commission ; il est partagé en lots. → page 2
  • poussière : Le reste d'un arrondi. En NAT, celle des lots va au pot suivant, jamais nulle part. En sNET, c'est l'écart minime entre ce qui est déposé et ce qui est enregistré. → page 2
  • prime du keeper : Une petite part du pot, plafonnée, versée à qui règle le tirage, quel qu'il soit. Elle est prélevée avant la commission. → page 2
  • principal : Ce que vous avez déposé, compté en sNET au jour du dépôt. Il n'est jamais vendu, prêté ni déplacé, et reste retirable à tout moment. → page 1
  • quorum : Le nombre minimal d'attestors dont les votes identiques finalisent une hauteur ; c'est le seuil. Tant qu'il n'est pas atteint, rien n'est finalisé. → page 5
  • rebase : La distribution périodique du staking NetNet, qui fait monter la valeur du sNET détenu. C'est elle qui crée le surplus. → page 1
  • reçu de création : Le reçu de la transaction qui a créé un contrat : il donne l'adresse créée et le bloc de création. Les pages s'en servent pour dater les contrats. → page 5
  • règlement (settle) : L'étape qui clôt un tirage une fois le hash attesté : calcul de la graine, tirage des lots, paiement. Ouverte à tous. → page 2
  • réorganisation (reorg) : Le remplacement des derniers blocs Bitcoin par une autre suite de blocs. Attendre des confirmations s'en protège. → page 2
  • réserve de gas : En v2, un contrat dédié qui reçoit une petite part du surplus, convertie en ETH, pour rembourser le gas des robots. Il n'existe pas au pilote. → page 1
  • Robinhood Chain : La chaîne où sont déployés les contrats NetNat et où vivent NET, USDG et NAT. Les pages y lisent tout. → page 5
  • RobinScan : L'explorateur de Robinhood Chain vers lequel pointent les liens de la page 5, où le code source des contrats est vérifié. → page 5
  • robot : Un programme qui envoie des transactions sans intervention humaine : le keeper et les attestors. Ils ne décident rien, ils déclenchent et rapportent. → page 5
  • routeur (NatRouter) : Le contrat qui vend le NET sur la paire v2 taxée et achète le NAT sur Uniswap v4 pour le compte du coffre. → page 5
  • RPC : Le point d'accès public par lequel cast interroge Robinhood Chain. Son adresse est donnée en tête des pages 3 et 5.
  • seuil (threshold) : Le nombre de votes identiques nécessaires pour finaliser une hauteur, fixé à la création de l'oracle. → page 5
  • sNET : Du NET staké chez NetNet. Sa quantité augmente à chaque rebase ; c'est l'unité dans laquelle le coffre compte le principal. → page 1
  • Sourcify : Un registre public de codes sources vérifiés, un autre lieu où le code des contrats NetNat se vérifie. → page 5
  • SPEC : La spécification de NetNat Capital, le document qui fixe chaque règle du protocole. Les pages citent ses sections entre parenthèses, avec le signe § ; le glossaire, lui, ne fait que renvoyer aux pages.
  • staker / déstaker (stake, unstake) : Staker du NET, c'est le confier au staking NetNet contre du sNET ; déstaker, l'inverse. Staker du NAT dans NATStaking donne droit à une part de la commission. → page 1
  • surplus : La différence entre la valeur en sNET du wsNET du coffre et le total des principaux, créée par le rebase. C'est la seule chose que le coffre vend. → page 1
  • sweep : Le balayage qui prélève le surplus, fige la liste des participants et engage un bloc Bitcoin, environ toutes les 8 h. Au pilote, un compte à rebours l'autorise ; en v2, c'est l'attestation du bloc engagé au sweep précédent. → page 1
  • taxe NetNet : Le prélèvement appliqué par NetNet à chaque vente de NET sur sa paire. NetNat la paie à chaque sweep et ne cherche pas à la contourner. → page 1
  • ticket : L'unité de chance au tirage : votre principal, majoré du bonus de présence. Les tickets sont rangés bout à bout dans l'ordre de la liste figée. → page 2
  • tirage : Le cycle qui va du sweep qui l'ouvre aux lots payés. Chaque tirage a son numéro, son bloc engagé, sa liste figée et son pot. → page 2
  • tirage à vide / tirage blanc : Un tirage à vide est un tirage au pot nul, faute de surplus suffisant : il suit tout le chemin, avec des montants à zéro. En v2, le premier tirage, avant tout dépôt, sera normalement blanc. Ni l'un ni l'autre n'est une anomalie. → page 2
  • tranche (slice) : Un achat partiel de NAT, espacé des autres, pour ménager un marché peu profond. Au pilote, leur nombre est fixe ; en v2, il s'adapte au montant. → page 1
  • trésor : L'adresse qui reçoit une part de la commission, figée dans le coffre et distincte du builder. → page 5
  • Uniswap v2 / v4 : Deux versions d'un même échange décentralisé sur Robinhood Chain. La v2 porte la paire NET/USDG, taxée, seule utilisée pour vendre le NET ; la v4 porte la pool NAT/ETH, où le NAT s'achète par tranches. → page 5
  • USDG : Un dollar numérique émis par Paxos, pivot de la conversion entre NET et NAT. → page 1
  • vote : L'acte d'un attestor qui inscrit dans l'oracle le hash d'une hauteur, depuis sa propre adresse. Un vote divergent sur une hauteur finalisée laisse une trace et ne change rien. → page 2
  • wallet (portefeuille) : Le logiciel qui tient une clé privée et signe pour une adresse. Aucun n'est nécessaire pour vérifier un tirage. → page 3
  • Wrap Desk : L'outil de NetNet qui emballe le sNET en wsNET, et le déballe. Le site y renvoie pour préparer un dépôt. → page 1
  • wsNET : Du sNET emballé : le nombre de jetons ne bouge plus, c'est leur valeur en sNET qui monte à chaque rebase. C'est le seul actif que le coffre accepte. → page 1