Fusion des monnaies dans la bibliothèque

Plutôt que de laisser tout dans une application et un module, la gestion des monnaies a migré vers la bibliothèque nebule.

C’est plus simple pour l’application mais cela a nécessité pas mal de modifications dans la bibliothèque. Cela veut dire aussi que la documentation dispose maintenant d’une partie dédiée.

Premiers essais pour bientôt !

Transaction à terme

Une transaction peut avoir une date d’activation dans le futur. Le jeton concerné est dit consommé à la date de création de la transaction et non à la date d’activation. Mais pour qu’elle soit réellement appliquée, le jeton doit être non désactivé à la date de création de la transaction mais aussi à la date d’activation. Il en est de même avec la suppression.

G̩n̩ration de jetons Рcompl̩ment 2

Complément à l’article Génération de jetons et complément.

Le contenu des objets des jetons va recevoir plusieurs lignes de type clé:valeur. Chaque ligne débute par trois lettre en majuscules définissant le sens sémantique (clé) de la ligne, suivi d’un deux-points ( : ) et de la valeur associée. La valeur est un texte en minuscule sans caractères spéciaux, l’espace des caractères est limité aux lettres minuscules, aux chiffres, à l’espace (sauf au début et à la fin), au point, à la virgule et à l’égal. La valeur est par défaut limité en taille à 1024 caractères sauf mention contraire pour une propriété. Il ne doit pas y avoir d’espace sur une ligne, ni en début et fin de ligne, ni autour du deux-points. Chaque ligne est terminée par un retour chariot type UNIX.

De nouvelle propriétés sont ajoutées :

  • BID : Le jeton fait parti d’un bloc (blockchain). Optionnel.
  • SVC : Le jeton fait référence à un type de service rendu (service). Taille limitée à 1024 caractères. Optionnel.
  • CLB : Le jeton peut être désactivé (cancelable). Par défaut un jeton n’est pas désactivable. Si cette option est présente, quelque soit son contenu, cela active la capacité de désactivation du jeton par la propriété CLD. Cette propriété n’interfère pas avec DTD. La taille est de un caractère maximum. Optionnel.
  • CLD : Le jeton est désactivé (canceled). Cette propriété n’a d’utilité que si CLB est activé. Si cette option est présente, quelque soit son contenu, cela désactive le jeton. La taille est de un caractère maximum. Optionnel.

La propriété CLB permet d’activer le mécanisme de désactivation à la demande piloté par l’option CLD. Mais elle n’a pas d’action sur la propriété de désactivation programmée DTD. Un jeton peut avoir une date de suppression programmée et être non désactivable avant la date de suppression. Activer la propriété CLD de façon forcée dans le contenu du jeton est faisable mais n’a pas de sens. Des jetons peuvent être générés désactivés et activés à posteriori. Un jeton désactivé ne peut pas faire parti d’une transaction.

G̩n̩ration de jetons Рcompl̩ment

Complément à l’article Génération de jetons.

Certaines valeurs dans les jetons sont limitées en taille :

  • NAM : limité à 256 caractères.
  • UNI: limité à 3 caractères.

De nouvelle propriétés sont ajoutées :

  • DTA : l’identifiant de l’entité autorité de temps pour les limites de temps. Optionnel.
  • DTC : Date de création du jeton. Forme texte libre limitée à 128 caractères. Doit pourvoir être interprété comme une date. Optionnel.
  • DTD : Date de suppression programmée du jeton. Forme texte libre limitée à 128 caractères. Doit pourvoir être interprété comme une date pour être fonctionel. Optionnel.
  • COM : Commentaire texte libre limité à 4096 caractères. Optionnel.
  • CPR : Licence du jeton sous forme d’une texte libre limité à 1024 caractères. Optionnel.
  • IDM : Mode de fonctionnement du mécanisme d’inflation/déflation (mode). Les modes sont creation et transaction. Optionnel.
  • IDR : Taux de variation du mécanisme d’inflation/déflation (rate). Égal à 1, taux constant donc pas de variation. Optionnel.
  • IDP : Périodicité d’application du taux de variation du mécanisme d’inflation/déflation (period). Unité exprimée en minutes. Optionnel.

Chaque propriété d’un jeton que l’on retrouve sous forme clé:valeur va être doublé d’un lien. Cependant les liens pouvant être annulés, les propriétés à figer sont écrites dans le jeton. Ainsi, une clé:valeur inscrite dans le jeton est prioritaire sur un lien équivalent.

L’autorité de temps (DTA) va faire l’objet de travaux particuliers autour de kronos et d’une application dédiée. Elle peut être spécifique pour chaque jeton mais il est plus logique qu’elle soit commune à une monnaie ou dans certains cas à un sac de jetons. La gestion du temps avec une autorité permet de prendre en compte sérieusement les suppression programmées de jeton  (DTC/DTD) ainsi que leur inflation/déflation automatique (IDM/IDR/IDP).

Le mécanisme d’inflation/déflation (IDM/IDR/IDP), si activé, avec un taux de variation inférieur à 1, donc en déflation, permet de forcer les détenteurs de jeton à les utiliser plutôt que de les stocker. Suivant le mode, le mécanisme tient compte du temps passé depuis la dernière transaction ou depuis l’émission du jeton. Les modes sont creation et transaction. Mais une entité peut demander à l’autorité émettrice de la monnaie un échange de jeton ancien contre un jeton plus jeune, si l’autorité émettrice le permet.

Génération de jetons

Avant de générer des monnaies et leurs sacs de jetons, nous devons implémenter la base de la monnaie, c’est à dire le jeton vecteur de valeur.

Il y a deux formes de jetons.

Jeton simple

Le jeton plus simple est un objet virtuel dont l’identifiant (TID) est généré aléatoirement. Ce peut être un simple compteur aussi mais chaque identifiant doit être unique par monnaie, et donc par sac de jetons aussi.

L’utilisation d’un compteur de faible valeur est fortement déconseillé pour le TID.

Par exemple :

4d831b11bbf828b9cfd4752223bb8918cbd634c4b858691736afd8b34f1f0c62

Jeton étendu

La deuxième forme de jeton est donc un objet dont le contenu va donner par son empreinte cryptographique un identifiant de jeton unique (TID). Il n’est dans ce cas pas possible d’avoir un compteur puisque les valeurs de identifiant sont assimilées à des valeurs aléatoires.
Le contenu de ces jetons va recevoir plusieurs lignes de type clé:valeur. Chaque ligne débute par trois lettre en majuscules définissant le sens sémantique (clé) de la ligne, suivi d’un deux-points ( : ) et de la valeur associée. Il ne doit pas y avoir d’espace sur une ligne, ni en début et fin de ligne, ni autour du deux-points. Chaque ligne est terminée par un retour chariot type UNIX.

Les différentes clés reconnues :

  • TYP : le type de jeton. Toujours à la valeur cryptoken. Présence obligatoire en ligne 1.
  • SID : le numéro de série du jeton (serial). De préférence aléatoire mais peut être un compteur à condition d’être unique. Présence obligatoire en ligne 2.
  • FID : l’identifiant de l’entité ayant forgé le jeton (forge). Optionnel.
  • PID : l’identifiant de l’objet du sac de jetons (pool). Optionnel.
  • CID : l’identifiant de l’objet de la monnaie (currency). Optionnel.
  • NAM : le nom de la monnaie. Optionnel.
  • UNI : le nom de l’unité de la monnaie en trois lettres maximum. Optionnel.
  • VAL : la valeur numérique relative du jeton dans l’unité de la monnaie. Optionnel. Par défaut équivalent à 1.

Les clés TYP et SID sont obligatoires, toujours au début et dans cet ordre.
Le début de contenu avec TYP:cryptoken permet de marquer un type de contenu facile à vérifier.
La seconde ligne avec le SID permet d’avoir un contenu unique et donc une empreinte unique pour chaque jeton. La valeur est de préférence aléatoire mais cela peut être un compteur à condition d’être unique. L’utilisation d’un compteur de faible valeur est fortement déconseillé pour le SID.

La génération pseudo aléatoire du SID est faite en partant d’un dérivé de la date avec quelques valeurs locales. Il n’y a pas de contrainte de sécurité sur cette valeur. Puis une boucle interne génère un bon aléa au fur et à mesure de la génération des jetons via une fonction de hash. Le tout ne consomme pas du tout de précieux aléa de bonne qualité.

Les clés FID, PID, CID, NAM et UNI sont indicatives. Une monnaie peut tout à fait réutiliser un sac de jetons d’une autre monnaie sans qu’il y ai conflit dans la gestion des jetons et de leurs transactions. Les valeurs associées peuvent être fausses sans que cela ne pose de problème.

La clé VAL donne une indication de valeur par rapport à la valeur d’une unité de la monnaie qui utilise le jeton. C’est une valeur numérique. Par défaut, si non présent, la valeur est à interpréter comme équivalente à 1.

Un jeton ne peut en aucun cas contenir son propre identifiant TID.

Par exemple :

TYP:cryptoken
SID:5f3ad5265bb3306b3266e1935d067d9ec15965d0a970554bc6161eb3328907a9
FID:f0f7cf5c921320b97daedeb7c53f2417921c747c77b696f8a25ff29277661d2f
PID:37aa32a2cec224ae908226eb1c600fbeacd5faf1f84b2e292c0be808c0296333
CID:daf832e3042cc849efcd5b6531df835a9c5f6251b2101e20972f9a9db2a8ae24
NAM:poux
UNI:pou
VAL:100

Sacs de jetons

La notion de sac de jetons (tokens pool) est créée dans le code afin de gérer des grandes quantités de jetons.

Il apparaît qu’une monnaie peut ne pas avoir de jetons ou billets générés de façon centralisé. Ou au contraire elle peut avoir ses jetons ou billets générés par une autorité centrale. Mais lorsqu’il faut générer une grande quantité de jetons, il n’est pas facile de le faire via une page web puisqu’il faut générer du contenu pour les billets te un certain nombre de liens par jetons/billets dans tous les cas. Le fait de travailler par sac de jetons permet aussi de simplifier l’émission et le retrait d’un grand nombre de jetons.

Soit chaque jeton est lié à un sac par un lien, et donc les sacs peuvent grossir. Soit l’objet de référence n’est pas virtuel et contient la liste des jetons qu’il reconnaît, dans ce cas le sac est définitivement figé. Mais même avec un sac figé il est peut-être possible de bannir individuellement un jeton.

Le jeton est un simple marqueur support pour l’échange de valeur. C’est typiquement un objet virtuel. La valeur d’un jeton est unique et commune à tous les jetons du sac.

Le billet est aussi un marqueur  support pour l’échange de valeur, mais il n’est pas un objet virtuel. Son contenu, et éventuellement les liens autours, contient une valeur numérique multiple ou sous-multiple d’une valeur de référence commune au sac de billets. La référence est défini par la monnaie à laquelle est raccroché le sac et non à une valeur attachée au sac.

Enfin, une monnaie peut se voir attachée un ou plusieurs sacs de jetons.

Co-valorisation

La relation habituelle entre plusieurs monnaies différentes peut être faite via des échanges de valeurs par équivalence. Ces échanges se font généralement soit via des taux de changes flottants ou soit plus spécifiquement via des taux fixes unitaires.

Les monnaies temps, c’est à dire dont la valeur est du temps, sont parfois vues comme non convertible vers d’autres monnaies. Mais si une monnaie temps est officiellement non convertible il n’en demeure pas moins qu’elle véhicule de la valeur et donc peut faire l’objet d’un marchandage parallèle avec une autre monnaie.

En passant, avoir un taux de change variable entre deux monnaies continuées de jetons à valeur fixe et non sécables est à considérer comme impossible parce que cela va entraîner des pertes sur l’une ou l’autre des monnaies. Et ces pertes ne sont pas prévisibles parce que le taux de change futur n’est pas prévisible. Dans ce cas le taux de change ne peut être que fixe.

Dans le cas particulier de deux monnaies ayant un taux de change fixe, la variation de valeur de l’une va entraîner automatiquement une variation de valeur de l’autre. Le simple fait que chaque administrateurs des deux monnaies les marques convertibles à taux fixe l’une vers l’autre les lient presque comme si c’était une monnaie unique mais avec deux types de supports de valeurs concurrents. Ne faut-il pas gérer le taux fixe comme une relation d’approbation explicite ?

Un fonctionnement proche de la relation d’approbation c’est la relation centralisée. La création d’une monnaie se fait par un administrateur central qui ne désigne pas de rôles de gestion directe mais approuve des succursales avec un administrateur propre qui désigne à son niveau des rôles de gestion. Dans ce cas les propriétés de la monnaie commune sont gérées ou figées par l’administrateur central et la gestion ‘de terrain’ se fait par les succursales. On doit donc pouvoir définir explicitement une monnaies centrale et des relations de subordination et de reconnaissance commune (élargie) des différents supports de valeur.