Skip to content
Snippets Groups Projects

Compare revisions

Changes are shown as if the source revision was being merged into the target revision. Learn more about comparing revisions.

Source

Select target project
No results found

Target

Select target project
  • websites/duniter_website_fr_v2
  • developerfred/duniter_website_fr_v2
  • LukeMarlin/duniter_website_fr_v2
  • Gobtous/duniter_website_fr_v2
  • tuxmain/duniter_website_fr_v2
  • vincentux/duniter_website_fr_v2
  • joss-rendall/duniter_website_fr_v2
  • aya/duniter_website_fr_v2
8 results
Show changes
Hide whitespace changes
Inline Side-by-side
Showing
with 141 additions and 406 deletions
content/wiki/_index.md
View file @ 53e109c3
+++
aliases = [ "wiki",]
date = 2017-03-27
weight = 3
aliases = ["fr/wiki",]
# date = 2024-06-26
weight = 2
title = "Wiki"
insert_anchor_links = "right"
[taxonomies]
authors = [ "cgeek", "matiou",]
tags = [ "blockchain", "TRM", "yunohost",]
# [taxonomies]
# authors = ["HugoTrentesaux", "cgeek", "matiou",]
# tags = ["blockchain", "TRM", "yunohost",]
[extra.translations]
en = "wiki/"
+++
# Wiki
Cette page regroupe des informations importantes concernant Duniter à des fins d'indexation.
Bienvenue sur le wiki de Duniter ! Vous trouverez ici toutes les informations techniques et explications détaillées à propos du projet Duniter. Pour trouver rapidement une ressource, utilisez la **barre de navigation** en haut de page 👆. Sinon, laissez-vous guider par le texte.
## Documentation de Duniter
Elle sert également de base de connaissances pour ses contributeurs.
Duniter est le logiciel qui fait fonctionner la monnaie Ğ1. Vous trouverez la documentation développeur et utilisateur dans le dossier [Documentation Duniter](@/wiki/doc/_index.md) ainsi que la documentation d'une partie de l'écosystème.
## Monnaie
<div class="center-content"><a class="w3-button w3-blue w3-round" href="/wiki/doc/">Doc v1</a></div>
* [Licence Ğ1](@/wiki/g1/licence-g1.md) (devenir membre Ğ1 + règles de la monnaie + règles de la Toile de Confiance)
## Documentation de Duniter-v2s
## Plateformes d’échange
Duniter est actuellement réécrit avec le framework Substrate. C'est une évolution du logiciel originel qui fait fonctionner la monnaie Ğ1. Vous trouverez la documentation développeur et utilisateur dans le dossier [Documentation Duniter-v2s](@/wiki/doc-v2/_index.md) ainsi que la documentation d'une partie de l'écosystème.
Exemple de plateformes d'échange compatible avec les crypto-monnaies Duniter comme la Ğ1 (connexion blockchain)
<div class="center-content"><a class="w3-button w3-orange w3-round" href="/wiki/doc-v2/">Doc v2</a></div>
* [ğannonce](https://gannonce.duniter.org/), site web
## Monnaie Libre
Simple groupe d'annonces sur le réseau privateur Facebook
La monnaie libre est un concept introduit en 2010 par la théorie relative de la monnaie (TRM). Elle admet une définition précise que vous pourrez explorer dans la section [Monnaie Libre](@/wiki/monnaie-libre/_index.md) de ce forum. De plus en plus de personnes utilisent le mot "monnaie libre" pour désigner les monnaies locales ou les cryptomonnaies. Nous ne traitons pas ces sujets ici, et nous concentrons sur la définition précise donnée par la TRM.
* [Ḡcoin, annonces en monnaie libre](https://www.facebook.com/groups/217329018743538/)
<div class="center-content"><a class="w3-button w3-indigo w3-round" href="/wiki/monnaie-libre/">Monnaie libre</a></div>
Dépôt media regroupant les logos, banières et autres outils de communication visuels :
## Monnaie Ğ1
* [Communication G1](https://git.duniter.org/communication/G1)
* [Logos Logiciels](https://git.duniter.org/communication/logos)
La monnaie Ğ1 (G-une, ou "june") est la première monnaie libre au sens donné par la TRM. C'est une expérimentation grandeur nature qui compte plus de 6000 membres créateurs. Vous trouverez toutes les informations techniques sur ğ1 dans la section [Monnaie Ğ1](@/wiki/g1/_index.md). Pour les informations pratiques relatives à son utilisation, veuillez plutôt consulter le site [https://monnaie-libre.fr/](https://monnaie-libre.fr/).
<div class="center-content"><a class="w3-button w3-green w3-round" href="/wiki/g1/">Ğ1</a></div>
## Écosystème logiciel
## Toile de confiance
### Logiciel Duniter
La toile de confiance de la monnaie ğ1, rendue possible par le logiciel Duniter, est une innovation intéressante permettant de répondre au besoin d'un système d'identification pair-à-pair. Elle constitue un élément central du projet Duniter/Ğ1 mais est indépendante de la notion de monnaie libre. C'est pour ces raisons que vous trouverez les informations qui s'y rapportent dans une section dédiée : [Toile de confiance](@/wiki/toile-de-confiance/_index.md).
Cœur du réseau Duniter, application P2P qui synchronise et modifie la blockchain commune.
<div class="center-content"><a class="w3-button w3-lime w3-round" href="/wiki/toile-de-confiance/">Toile de confiance</a></div>
## Fondations théoriques
## Guide de contribution
* [Le projet OpenUDC](https://github.com/Open-UDC/open-udc), précurseur de Duniter
Le projet vous plaît et vous souhaitez y consacrer du temps ou y apporter votre savoir-faire ? Un [guide de contribution](@/wiki/contribuer/_index.md) est disponible pour vous aiguiller dans ce vaste projet !
## À propos
Pour les informations relatives à ce site, voir la section [à propos](@/wiki/about/_index.md).
content/wiki/about/_index.md
View file @ 53e109c3
+++
title = "À propos"
date = 2017-03-27
updated = 2020-07-26
# date = 2017-03-27
# updated = 2020-07-26
weight = 6
[taxonomies]
authors = [ "cgeek",]
# [taxonomies]
# authors = ["cgeek",]
# category = ["Meta",]
[extra.translations]
en = "wiki/about/"
+++
# À propos
......@@ -19,10 +22,11 @@ L'intégralité de ce site est sous licence [CC-BY-SA](https://creativecommons.o
Ce site a été réalisé en [Zola](https://www.getzola.org/) avec [w3.css](https://www.w3schools.com/w3css/) et [Forkawesome](https://forkaweso.me/Fork-Awesome/).
Le code source du site est par ailleurs intégralement disponible sur le dépôt [git.duniter.org/websites/website_fr](https://git.duniter.org/websites/website_fr) avec les instructions permettant de le reproduire.
Le code source du site est par ailleurs intégralement disponible sur le dépôt [https://git.duniter.org/websites/duniter_website_fr_v2/](https://git.duniter.org/websites/duniter_website_fr_v2/) avec les instructions permettant de le reproduire.
## Images utilisées sur ce site
Les logos officiels des logiciels sont disponibles sur ce dépôt : [https://git.duniter.org/communication/g1](https://git.duniter.org/communication/g1).
Certains logos ou images sont la production d'autres personnes, vous trouverez leur origine sur la page [Crédits](@/wiki/about/credits.md).
## Qui sommes-nous ?
......@@ -32,3 +36,9 @@ Plus de détails sur nous dans la page [Qui sommes-nous ?](@/wiki/about/qui-somm
## Nous contacter
Pour nous contacter, rendez-vous sur [la page de contact](@/wiki/about/contact.md)
## Nous financer
Barre de financement en ğ1 pour le mois courant :
<iframe frameborder="0" name="iframe" src="https://txmn.tk/g1/barre-de-financement/iframe.php?pubkey=78ZwwgpgdH5uLZLbThUQH7LKwPgjMunYfLiCfUCySkM8&target=793&unit=relative&title=Duniter Project&display_pubkey=true&display_qrcode=true&display_graph=true" width="100%" height="1100px">
content/wiki/about/contact.md
View file @ 53e109c3
+++
aliases = [ "contact",]
title = "Contact"
date = 2017-03-27
aliases = ["fr/contact",]
weight = 6
title = "Contact"
[taxonomies]
authors = [ "cgeek",]
tags = ["xmpp", "forum", "contact"]
authors = ["cgeek",]
category = ["Meta",]
+++
# Contact
......
content/wiki/about/credits.md
View file @ 53e109c3
+++
aliases = [ "credits",]
date = 2017-03-29
title = "Crédits"
date = 2017-03-29
aliases = ["fr/credits",]
[taxonomies]
authors = [ "cgeek",]
authors = ["cgeek",]
category = ["Meta",]
[extra.translations]
en = "wiki/about/credits/"
+++
# Crédits
......
content/wiki/about/qui-sommes-nous.md
View file @ 53e109c3
+++
aliases = [ "qui-sommes-nous",]
title = "Qui sommes-nous ?"
date = 2017-03-27
aliases = ["fr/qui-sommes-nous",]
weight = 9
title = "Qui sommes-nous ?"
[taxonomies]
authors = [ "cgeek",]
authors = ["cgeek",]
category = ["Meta",]
+++
# Qui sommes-nous ?
......
content/wiki/contribuer/_index.md
View file @ 53e109c3
+++
aliases = [ "contribuer__old",]
date = 2017-03-27
weight = 4
title = "Contribuer"
# date = 2017-03-27
aliases = ["contribuer__old",]
weight = 5
[taxonomies]
authors = [ "cgeek", ]
tags = [ "blockchain", "TRM", "yunohost",]
# [taxonomies]
# authors = ["cgeek", ]
# tags = ["blockchain", "TRM", "yunohost",]
[extra.translations]
en = "wiki/contribute/"
+++
# Contribuer
......@@ -37,6 +40,25 @@ La meilleure façon de faire prendre de la valeur à Ğ1 est de la faire adopter
Dans tous les cas, vous pouvez aller faire un tour sur le [Wiki](@/wiki/_index.md) afin de réperer les sujets pouvant vous intéresser.
Sur le forum :
- [Recensement des compétences informatiques](https://forum.duniter.org/t/recensement-des-competences-informatiques/9271)
- [L’équipe: qui travaille sur quoi](https://forum.duniter.org/t/lequipe-qui-travaille-sur-quoi/9076) (obsolète)
#### Vous êtes traducteurs / maîtrisez plusieurs langues
Nous avons de gros besoins de traduction. Voici quelques liens utiles :
- (post forum) [Listing traducteurs/trices](https://forum.duniter.org/t/listing-traducteurs-trices/9862)
- (groupe forum) [translators](https://forum.duniter.org/g/Translators)
- (catégorie forum) [english translations](https://forum.duniter.org/c/communication/translation-en/69)
- [https://weblate.duniter.org/](https://weblate.duniter.org/) instance weblate pour la traduction de logiciels
- (telegram) [groupe G1Trad](https://t.me/G1Trad)
#### Vous êtes chercheur / universitaire
La monnaie libre, la ğ1, et Duniter, sont tous les trois des sujets de recherche. Suivant que vous soyez dans un laboratoire d'économie, de sciences sociales, de mathématiques, ou interdisciplinaire, certains sujets peuvent vous intéresser. Veuillez consulter [la page dédiée](@/wiki/contribuer/recherche-universitaire.md) pour découvrir les différents sujets et laboratoires intéressés.
### Vous avez trouvé un bug !
N'hésitez surtout pas à le rapporter ! Cela permet aux logiciels d'évoluer et évitera à d'autres de tomber dessus.
......@@ -45,7 +67,7 @@ Instructions sur la page [Wiki > Rapporter un bug](@/wiki/contribuer/rapporter-u
### Financer les développments
Si vous disposez de quelques Ğ1, vous pouvez **[faire un don](@/wiki/financements.md)** aux développeurs.
Si vous disposez de quelques Ğ1, vous pouvez **[faire un don](@/faq/duniter/financements.md)** aux développeurs.
Et si vous n'en avez pas, vous pouvez aussi [en obtenir](@/wiki/g1/obtenir-des-g1.md).
Et si vous n'en avez pas, vous pouvez aussi [en obtenir](@/faq/g1/obtenir-des-g1.md).
content/wiki/contribuer/ameliorer-le-site.md
View file @ 53e109c3
+++
aliases = [ "ameliorer-le-site",]
title = "Améliorer le site"
date = 2017-03-31
aliases = ["fr/ameliorer-le-site",]
weight = 9
title = "Améliorer le site"
[taxonomies]
authors = [ "cgeek",]
authors = ["cgeek",]
category = ["Meta",]
+++
# Améliorer le site
......
content/wiki/contribuer/blockchain-nodejs/_index.md
View file @ 53e109c3
+++
aliases = [ "blockchain-nodejs",]
date = 2017-04-08
title = "[archive] Contribuer à Duniter"
# date = 2017-04-08
aliases = ["fr/blockchain-nodejs",]
weight = 9
title = "Contribuer à Duniter"
[taxonomies]
authors = [ "cgeek",]
# [taxonomies]
# authors = ["cgeek",]
+++
{% note(type="warning") %}
Duniter est en cours de réécriture dans le framework Substrate. Ce guide n'est plus d'actualité.
{% end %}
# Contribuer à Duniter
## Concepts généraux
......@@ -22,7 +26,7 @@ authors = [ "cgeek",]
* [Fonctionnement des branches du dépot git duniter](@/wiki/contribuer/blockchain-nodejs/git-branches.md)
* [Fuites mémoire](@/wiki/contribuer/blockchain-nodejs/fuites-memoire.md)
* [Les modules C/C++](@/wiki/contribuer/blockchain-nodejs/les-modules-c-cpp.md)
* [Guide du validateur](https://git.duniter.org/nodes/typescript/duniter/blob/dev/doc/validator-guide.md)
* [(broken) Guide du validateur](https://git.duniter.org/nodes/typescript/duniter/blob/dev/doc/validator-guide.md)
* [Livraisons](@/wiki/contribuer/blockchain-nodejs/livraisons.md)
* [Livraisons (ancien)](@/wiki/contribuer/blockchain-nodejs/livraisons-old.md)
* [Du Rust dans NodeJs graçe a Neon](@/wiki/contribuer/blockchain-nodejs/binding-node-rust.md)
......
content/wiki/contribuer/blockchain-nodejs/architecture-duniter.md
View file @ 53e109c3
+++
aliases = [ "architecture-duniter",]
title = "Architecture"
date = 2017-10-09
aliases = ["fr/architecture-duniter",]
weight = 10
title = "Architecture"
[taxonomies]
authors = [ "vit",]
authors = ["vit",]
[extra.translations]
en = "wiki/contribute/archive/architecture/"
+++
# Architecture
......
content/wiki/contribuer/blockchain-nodejs/archives.md
View file @ 53e109c3
+++
aliases = [ "archives",]
title = "Archives"
date = 2017-11-16
aliases = ["fr/archives",]
weight = 20
title = "Archives"
[taxonomies]
authors = [ "inso",]
authors = ["inso",]
+++
# Archives
......
content/wiki/contribuer/blockchain-nodejs/binding-node-rust.md
View file @ 53e109c3
+++
aliases = [ "binding-node-rust",]
title = "Du Rust dans NodeJs graçe a Neon"
date = 2018-05-04
aliases = ["fr/binding-node-rust",]
weight = 9
title = "Du Rust dans NodeJs graçe a Neon"
[taxonomies]
authors = [ "elois",]
authors = ["elois",]
+++
# Du Rust dans NodeJs graçe a Neon
......
content/wiki/contribuer/blockchain-nodejs/fuites-memoire.md
View file @ 53e109c3
+++
aliases = [ "fuites-memoire",]
title = "Fuites mémoire"
date = 2017-05-11
aliases = ["fr/fuites-memoire",]
weight = 9
title = "Fuites mémoire"
[taxonomies]
authors = [ "cgeek",]
authors = ["cgeek",]
+++
# Fuites mémoire
......
content/wiki/contribuer/blockchain-nodejs/git-branches.md
View file @ 53e109c3
+++
aliases = [ "git-branches",]
title = "Fonctionnement des branches du dépot git Duniter"
date = 2017-09-22
aliases = ["fr/git-branches",]
weight = 9
title = "Fonctionnement des branches du dépot git Duniter"
[taxonomies]
authors = [ "elois",]
authors = ["elois",]
+++
# Fonctionnement des branches du dépot git Duniter
......
content/wiki/contribuer/blockchain-nodejs/les-modules-c-cpp.md
View file @ 53e109c3
+++
aliases = [ "les-modules-c-cpp",]
title = "Les modules C/C++"
date = 2017-05-22
aliases = ["fr/les-modules-c-cpp",]
weight = 9
title = "Les modules C/C++"
[taxonomies]
authors = [ "cgeek",]
authors = ["cgeek",]
+++
# Les modules C/C++
......
content/wiki/contribuer/blockchain-nodejs/livraisons-old.md
View file @ 53e109c3
+++
aliases = [ "livraisons-old",]
aliases = ["livraisons-old",]
date = 2017-05-10
weight = 9
title = "Livraisons (ancienne page)"
[taxonomies]
authors = [ "cgeek",]
authors = ["cgeek",]
+++
# Livraisons (ancienne page)
......
content/wiki/contribuer/blockchain-nodejs/livraisons.md
View file @ 53e109c3
+++
aliases = [ "livraisons",]
aliases = ["livraisons",]
date = 2018-06-02
weight = 9
title = "Livraisons"
[taxonomies]
authors = [ "cgeek",]
authors = ["cgeek",]
+++
# Livraisons
......@@ -48,7 +48,7 @@ Ces livrables possèdent un script pour produire le livrable, mais nécessitent
### Duniter Server ARM
Suivre le tutoriel suivant : [https://duniter.org/en/wiki/duniter/create_arm_release/](https://duniter.org/en/wiki/duniter/create_arm_release/) (anglais)
Suivre le tutoriel suivant : [https://duniter.org/wiki/duniter/create_arm_release/](https://duniter.org/wiki/duniter/create_arm_release/) (anglais)
### Duniter Desktop Windows
......
content/wiki/contribuer/blockchain-nodejs/preuve-de-travail.md deleted 100644 → 0
View file @ f25ff531
+++
aliases = [ "preuve-de-travail",]
date = 2017-05-02
weight = 9
title = "Preuve de travail"
[taxonomies]
authors = [ "cgeek", "elois",]
+++
# Preuve de travail
## À quoi sert la preuve de travail ?
La preuve de travail permet de synchroniser un réseau pair à pair (p2p) de machines devant partager une base de données commune.
Dans duniter, cette base de données commune est notre grand livre de comptes commun qui consigne toutes les transactions de la monnaie ainsi que les actes de la toile de confiance (certifications, adhésions, renouvellements, révocations, etc). Elle est inscrite dans une « blockchain ».
Comment fait-on lorsque plusieurs machines souhaitent ajouter en même temps une nouvelle donnée (une nouvelle transaction par exemple) ?
De plus, comment fait-on pour nous mettre d'accord sur le temps qui s'est écoulé ? Ce qui est essentiel pour savoir s'il est temps de créer le dividende universel ainsi que pour gérer les délais d'expiration des adhésions et certifications.
Eh bien la preuve de travail permet de résoudre ces deux problèmes en même temps.
Voici comment :
1. N'importe quelle machine peut écrire une nouvelle donnée (= un nouveau bloc), mais pour avoir le droit de l'écrire il faut résoudre un défi qui demande du *travail* à la machine, ce défi doit être suffisamment difficile pour qu'il n'y ait pas deux machines qui le résolvent en même temps. Il n'y a donc qu'une seule machine qui peut écrire en même temps, celle qui résout le défi demandé, bien.
2. La résolution de ce défi demande un certain temps de calcul qui est fonction de la puissance de calcul du réseau, nous avons donc là un moyen de définir l'écoulement du temps selon un référentiel commun. Il suffit ensuite de choisir une convention, par exemple `1 bloc = 5 min` puis d'adapter la difficulté du défi pour que le réseau trouve bien en moyenne un bloc toutes les 5 min.
## Seuls les membres peuvent calculer
Duniter a une différence fondamentale avec toutes les autres crypto-monnaies basées sur la preuve de travail : seuls les membres de la toile de confiance ont le droit d'ajouter des blocs à la blockchain (le grand livre de comptes commun).
Chaque bloc est signé avec la clé privée du membre qui l'a ajouté, cela permet d'affecter une difficulté personnalisée a chaque membre ce qui change absolument tout, sans ce mécanisme la Ğ1 serait tout aussi asymétrique et non-libre que le bitcoin !
La difficulté personnalisée est en effet indispensable pour empêcher la course au calcul, ainsi que pour empêcher un supercalculateur de prendre le contrôle de toute la blockchain et donc de la monnaie.
De plus, la difficulté personnalisée impose une rotation dans l'écriture des blocs qui permet a tous d'avoir la possibilité d'écrire dans la blockchain, même avec une brique internet ou un raspberry pi, ce qui rend les monnaies duniter considérablement plus économes en énergie !
## Comment marche la preuve de travail ?
### L'empreinte (le hash)
Exemple d'empreinte valide :
```
00000276902793AA44601A9D43099E7B63DBF9EBB55BCCFD6AE20C729B54C653
```
On peut voir que cette empreinte démarre par 5 zéros : réaliser une telle empreinte demande beaucoup de *travail* de la part d'un ordinateur, d'où le fait qu'on appelle l'opération consistant à réaliser une telle empreinte « *preuve de travail* ».
### La difficulté commune
Afin de nous donner une mesure commune du temps, nous avons besoin d'une difficulté commune qui assure que la blockchain avance à un rythme régulier (1 bloc toutes les `avgGenTime` secondes, `avgGenTime` étant l'un des 20 paramètres qui décrivent une monnaie duniter).
Cette difficulté peut commencer à une valeur arbitraire (`70` dans le code `v1.5.x`) puis agit comme un ressort, si l'intervalle entre deux blocs est inférieur à `avgGenTime` la difficulté commune augmente et inversement si l'intervalle entre deux blocs est supérieur à `avgGenTime`, la difficulté commune diminue.
#### Comment s'applique la difficulté
La valeur numérique de la difficulté correspond directement à une plage d'empreintes possibles parmi toutes les empreintes possibles. Dans duniter `v1.5.x` l'empreinte d'un bloc c'est le hash hexadécimal sha256 du bloc. Ce qui veut dire que chaque caractère de l'empreinte n'a que 16 valeurs possibles : les chiffres de 0 à 9 et les lettres de A à F.
Pour interpréter une difficulté il faut effectuer la division euclidienne de cette difficulté par 16. Exemple avec `70` :
70 // 16 = **4** reste **6**. Donc les empreintes valides sont celles qui commencent par **4** zéros et dont le 5<sup>ème</sup> caractère est inférieur ou égal à 9 (car on commence à `F` (index 0), puis on descend ... `E(1), D(2), C(3), B(4), A(5), 9(6)`). On écrit alors que les empreintes valides commencent par : `0000[0-9]`
> Oui mais l'empreinte d'un bloc sera toujours la même pour un bloc donné et n'a aucune raison de commencer par une suite particulière, donc comment fait-on pour trouver un bloc qui a comme par hasard une empreinte qui respecte la difficulté ?
Bien vu, il faut effectivement faire varier le contenu du bloc pour obtenir une empreinte différente, c'est le rôle du Nonce.
Lorsque qu'un membre veut ajouter un nouveau bloc à la blockchain, il fixe le contenu de ce bloc, puis rajoute un champ Nonce qu'il fait varier jusqu'à tomber par hasard sur une empreinte qui respecte la difficulté.
### Le Nonce
Il s'agit du champ du document `Block` permettant de faire varier l'empreinte finale du bloc, empreinte qui définit le niveau de la preuve de travail.
Exemples de valeurs de Nonce :
* 10100000112275
* 10300000288743
* 10400000008538
* 10700000079653
* 10300000070919
En réalité ces valeurs de `Nonce` suivent toutes un même schéma `XYY00000000000`. Le Nonce ne correspond pas aux nombres d'essais, mais plutôt à un espace de Nonce possible. La décomposition est la suivante :
* X correspond au numéro de pair. Par exemple celui qui a plusieurs nœuds avec la même clé personnelle et qui sont donc tous capables de calculer, chacun de ces nœuds va réaliser sa preuve avec un X différent, afin de ne pas calculer la même preuve justement. Car potentiellement, ils réalisent exactement le même prochain bloc (puisque l'émetteur est le même, le contenu possiblement identique, seul le Nonce peut varier), donc il faut avoir un Nonce qui les différencie pour qu'ils ne fassent pas exactement les mêmes calculs.
* Y correspond au numéro de cœur du processeur. On peut voir par exemple que quelqu'un possède au moins 7 cores dans son CPU ici, car on lit le Nonce `107[...]`. Un serveur avec 99 cores pourrait réaliser une preuve `199[...]` par exemple.
Le reste du Nonce, la partie derrière XYY, est l'espace de Nonce du nœud pour chaque core du CPU. Ce qui fait donc un espace de 11 chiffres (`00000000000`) pour trouver un Nonce correct pour chaque core du CPU de la machine (CPU au sens large, ce peut-être un bi-CPU, on considère le nombre de cores résultants pour la PoW).
### La difficulté personnalisée
Nous avons expliqué plus haut que la difficulté personnalisée est **le nouveau concept fondamental** qui différencie les monnaies duniter des autres crypto-monnaies basées sur la « *preuve de travail* », comme le bitcoin par exemple.
Voici donc comment est calculée la difficulté personnalisée d'un membre :
La difficulté personnalisée d'un membre résulte de l'assemblage de deux contraintes distinctes qui ont des rôles complémentaires : le **facteur d'exclusion** et le **handicap**.
Soient `powMin` la difficulté commune, `exFact` le facteur d'exclusion d'un membre et `handicap` son handicap. La difficulté personnalité `diff` de ce membre est :
```
diff = powMin*exFact + handicap
```
#### Le facteur d'exclusion `exFact` d'un membre
Les membres qui n'ont jamais écrit de bloc ou qui n'ont pas écrit de bloc depuis longtemps ont un facteur d'exclusion de `1`. Leur difficulté personnalisée sera donc égale à la somme `powMin + handicap`.
Avant de lire la formule donnée plus bas vous devez comprendre le rôle de ce facteur d'exclusion : lorsqu'un membre ajoute un bloc à la blockchain, son facteur d'exclusion saute subitement de 1 vers une valeur très élevée afin de faire grimper exponentiellement sa difficulté et l'exclure ainsi du calcul des prochains blocs et donc l'empêcher de prendre le contrôle de la blockchain.
Le facteur d'exclusion du membre va ensuite chuter rapidement à chaque nouveau bloc dont il n'est pas l'auteur puis retomber à 1 au bout d'un nombre de blocs qui est en fait une proportion du nombre de membres calculant (un tiers dans le cas de la Ğ1, ce qui signifie que s'il y a 15 membres calculant vous êtes exclus pendant 5 blocs).
> heu attend c'est quoi le nombre de membres calculant ?
Très bonne question, il s'agit du nombre de membres que l'on considère comme étant actuellement en train de calculer le prochain bloc. En réalité il n'y a aucun moyen de savoir combien de membres sont réellement en train de calculer le prochain bloc car d'une part il est impossible d'avoir une vue complète du réseau et d'autre part il existe des moyens de se rendre invisible du réseau. Il nous faut pourtant bien choisir une méthode, car sans considérer le nombre de membres calculant, il est impossible de calibrer la difficulté personnalisée.
La méthode actuellement utilisée par Duniter est de regarder l'historique des X derniers blocs et considérer que le nombre de membres calculant c'est le nombre de membres ayant écrit au moins 1 bloc sur les X derniers blocs sans compter le tout dernier bloc.
> Et comment on choisit X ?
Gràce au concept de **fenêtre courante**, X correspond alors à la taille de la fenêtre courante, voici comment cela fonctionne :
On nomme `issuersFrame` la taille de la fenêtre courante et `issuersCount` le nombre de membres ayant calculé au moins 1 bloc dans la fenêtre courante.
Au commencement d'une blockchain, le tout premier bloc que l'on nomme le bloc #0 décrète que `issuersFrame=1` et `issuersCount=0`. Hé oui le tout dernier bloc étant exclu, il n'y a pour l'instant aucun membre dans la fenêtre courante.
Ensuite, à chaque nouveau bloc, on mesure la variation de `issuersCount`, dès le second bloc (le bloc #1), l'auteur du bloc #0 entre dans la fenêtre courante, on écrira donc dans le bloc #1 `issuersCount=1`.
`issuersFrame` varie alors de la façon suivante : si `issuersCount` augmente de X (et X = 1 au maximum), alors `issuersFrame` augmentera de 1 unité pendant 5X blocs. Et inversement : si `issuersCount` diminue de Y (et Y = 2 au maximum : décalage de fenêtre + perte d’un auteur), alors issuersFrame diminuera de 1 unité pendant 5Y blocs. Les effets étant cumulatifs dans le temps. Ce qui fait que si un nouvel auteur apparaît au bloc `T` et un autre disparaît à `T+1`, `issuersFrame` augmentera de 1 unité à `T+1` puis diminuera de 1 unité à `T+2`, pour se stabiliser.
Techniquement ce calcul est formalisé par les règles [BR_G05](https://github.com/duniter/duniter/blob/master/doc/Protocol.md#br_g05---headissuersframe) et [BR_G06](https://github.com/duniter/duniter/blob/master/doc/Protocol.md#br_g06---headissuersframevar) du protocole DUP.
> Revenons à notre difficulté personnalisée !
Nous avons dit que le facteur d'exclusion `exFact` augmente brutalement dès que le membre considéré trouve un bloc puis qu'il diminue rapidement pour retomber à `1` au bout d'un nombre de blocs égal au tiers des calculateurs. Et bien, c'est parti voici comment est calculé `exFact` :
Soient `nbPreviousIssuers` la valeur du champ `issuersCount` du dernier bloc trouvé par le membre et `nbBlocksSince` le nombre de blocs trouvés par le reste du réseau depuis que le membre considéré a trouvé son dernier bloc.
```
exFact = MAX [ 1 ; FLOOR (0.67 * nbPreviousIssuers / (1 + nbBlocksSince)) ]
```
La fonction FLOOR est une simple troncature, ainsi pour que `exFact` soit excluant il faut que le rapport `(0.67 * nbPreviousIssuers / (1 + nbBlocksSince))` soit supérieur ou égal à 2. On voit bien que si `nbBlocksSince` est supérieur au tiers des calculateurs = `0.33*nbPreviousIssuers` alors le rapport sera inférieur à 2 et donc le membre ne sera pas exclu du calcul du prochain bloc.
À l'inverse, si le membre considéré est l'auteur du dernier bloc alors `nbBlocksSince=0` et le facteur d'exclusion vaut donc `0.67 * nbPreviousIssuers`, c'est d'autant plus grand que le nombre de calculateurs est élevé. Je vous laisse imaginer la difficulté vertigineuse que vous atteindrez en trouvant un bloc s'il y a des centaines de membres calculant !
Vous atteindrez une difficulté telle que même le plus grand des supercalcuteurs serait bloqué, et c'est bien le but du facteur d'exclusion : empecher les supercalculateurs et fermes de calcul de prendre le contrôle de la blockchain et donc de la monnaie.
En revanche, a tout instant t les deux tiers des membres calculant non exclus ont tous un facteur d'exclusion égal à `1`, mais tous n'ont pas la même puissance de calcul, et donc si la difficulté personnalisée se limitait au facteur d'exclusion c'est toujours le tiers des membres calculant les plus puissants qui écriraient des blocs et deux tiers restants seraient presque toujours exclus, en particulier les machines très modestes type raspberry n'auraient aucune chance.
#### Le handicap
Le handicap est le second paramètre de la difficulté personnalisée. Plus subtil, il permet néanmoins d'améliorer considérablement le mécanisme de rotation en donnant un handicap aux membres ayant une machine puissante afin de donner leur chance aux machines les plus modestes et de diminuer le coût écologique de la monnaie.
Le calcul du handicap se base sur le nombre médian de blocs écrits par chaque membre au sein de la fenêtre courante. En gros, l'idée est de donner un handicap à la moitié haute de la fenêtre courante pour donner plus de chance à la moitié basse.
Soient `nbPersonalBlocksInFrame` le nombre de blocs écrits par le membre considéré dans la fenêtre courante et `medianOfBlocksInFrame` le nombre médian de blocs écrits par les membres au sein de la fenêtre courante.
Voici la formule :
```
handicap = FLOOR(LN(MAX(1;(nbPersonalBlocksInFrame + 1) / medianOfBlocksInFrame)) / LN(1.189))
```
Démystifions cette formule, `(nbPersonalBlocksInFrame + 1) / medianOfBlocksInFrame)` est simplement le rapport entre le nombre de blocs calculés par le membre et la médiane. Par exemple si le membre a calculé `9` blocs dans la fenêtre courante alors que la médiane vaut `5`, ce rapport vaudra `(9+1)/5 = 2`.
On s'assure via la fonction MAX que ce rapport vaut au moins `1`.
Ensuite on prend le logarithme népérien de ce rapport pour éviter que le handicap devienne excluant lorsque la fenêtre courante devient très grande, c'est ce qui fait la subtilité du handicap, son rôle n'est pas d'exclure mais de niveler la difficulté de chacun en fonction de sa puissance pour que tout le monde ait a peu près les mêmes chances de calculer.
Si l'on veut que le handicap s'applique dés la médiane il faudrait ensuite diviser par `LN(1)`, le problème c'est qu'on a déjà nivellé la rapport à `1` avec la fonction MAX, donc si l'on divisait par `LN(1)` tous les membres calculant auraient un handicap >= `1`, qui plus est, est-il bien juste de donner un handicap à un membre qui est tout juste à la médiane ?
C'est pourquoi, au lieu de prendre `1`, on prend `1.189`, ce qui veut dire qu'il faut être `18,9 %` au-dessus de la médiane pour subir un handicap (si l'on néglige le +1 dans la formule qui devient effectivement négligeable pour un grand nombre de calculateurs).
Mais pourquoi `18,9%` me direz-vous ?
C'est 16^(1/16), le facteur de difficulté entre 2 niveaux de la preuve de travail dont le hash est en hexadécimal.
En conclusion, ce qu'il faut retenir c'est l'idée d'indexer le handicap sur le logarithme du rapport à la médiane, et de ne l'appliquer que pour les membres dont le rapport à la médiane dépasse le rapport entre 2 niveaux de difficulté de la preuve de travail.
content/wiki/contribuer/blockchain-nodejs/preuve-de-travail.md 0 → 120000
View file @ 53e109c3
../../../blog/2017-05-02-preuve-de-travail.md
\ No newline at end of file
content/wiki/contribuer/blockchain-nodejs/tutoriel-dev/_index.md
View file @ 53e109c3
+++
aliases = [ "tutoriel-dev",]
date = 2017-10-31
weight = 1
title = "Tutoriel de développement"
aliases = ["tutoriel-dev",]
weight = 1
# date = 2017-10-31
[taxonomies]
authors = [ "cgeek",]
# [taxonomies]
# authors = ["cgeek",]
+++
# Tutoriel de développement
......
content/wiki/contribuer/blockchain-nodejs/tutoriel-dev/chapitre-1-presentation.md
View file @ 53e109c3
+++
aliases = [ "chapitre-1-presentation",]
aliases = ["chapitre-1-presentation",]
date = 2017-10-31
weight = 1
title = "1. Présentation générale - Tutoriel de développement"
[taxonomies]
authors = [ "cgeek",]
authors = ["cgeek",]
+++
# 1. Présentation générale - Tutoriel de développement
......