Protocole de Primo Transaction pour Duniter

Une Innovation pour la Gestion des Portefeuilles Entreprise

fred

Qu'est-ce que la Primo Transaction ?

La Primo Transaction est une transaction spéciale effectuée sur la blockchain Duniter qui établit un lien vérifiable entre un ou plusieurs comptes membres et un portefeuille d'entreprise. Ce qui rend cette transaction unique, c'est qu'elle est la première et c'est par l'inclusion dans son commentaire d'un lien IPFS (InterPlanetary File System) qui pointe vers un contrat qu'on peut associer un programme au portefeuille.

Caractéristiques clés :

  1. Lien membre-entreprise : Permet d'associer officiellement des membres Duniter à un portefeuille d'entreprise.
  2. Contrat transparent : Le lien IPFS dans le commentaire donne accès au contrat régissant le fonctionnement du portefeuille.
  3. Logique programmable : Un programme associé peut automatiser certaines opérations du portefeuille.
  4. Évolutivité : Le contrat et le programme peuvent être mis à jour en changeant de portefeuille.

Comment fonctionne la Primo Transaction ?

  1. Création du portefeuille : Un portefeuille d'entreprise est créé sur la blockchain Duniter.
  2. Préparation du contrat et du programme : Les documents sont rédigés et uploadés sur IPFS, générant un CID (Content Identifier) unique.
  3. Exécution de la Primo Transaction : Un membre effectue une transaction vers le portefeuille d'entreprise, incluant dans le commentaire le CID IPFS du contrat et du programme.
  4. Validation : Les nœuds Duniter valident la transaction, établissant ainsi le lien officiel.

L'analyse quotidienne des transactions

Un aspect crucial de ce système est l'analyse quotidienne des transactions par les nœuds Duniter+Astroport. Voici comment cela fonctionne :
  1. Scan automatique : Chaque jour, les nœuds parcourent les transactions des portefeuilles d'entreprise qu'ils gèrent.
  2. Exécution du programme : Le programme associé à chaque portefeuille est exécuté, traitant les transactions selon la logique définie.
  3. Actions automatisées : Selon les règles établies, des actions peuvent être déclenchées automatiquement (distributions, conversions, etc.).
Un excellent exemple de cette automatisation est le script G1PalPay.sh, disponible sur le dépôt GitHub Astroport.ONE. Ce script illustre comment les transactions peuvent être analysées et traitées de manière automatique et sécurisée.

Avantages du système de Primo Transaction

  1. Transparence : Tous les membres peuvent consulter le contrat et le programme associés à un portefeuille d'entreprise.
  2. Flexibilité : Les règles de gestion peuvent évoluer en créant un nouveau portefeuille avec un nouveau contrat.
  3. Automatisation : Réduit la charge de travail manuel et les erreurs potentielles.
  4. Confiance : Renforce la confiance dans les opérations des entreprises sur la blockchain Duniter.
  5. Gouvernance décentralisée : Facilite la mise en place de systèmes de gouvernance transparents pour les entreprises.

Applications potentielles

  1. Coopératives décentralisées : Gestion automatisée des parts et des dividendes.
  2. Cagnottes communes : Distribution automatique des fonds selon des règles prédéfinies.
  3. Systèmes de récompense : Attribution automatique de tokens basée sur des critères spécifiques.
  4. Gestion de trésorerie : Automatisation des paiements récurrents et de la gestion des liquidités.

 

Le système de Primo Transaction apporte une avancée significative dans la gestion des portefeuilles d'entreprise sur la blockchain.

En combinant transparence, flexibilité et automatisation, il ouvre la voie à de nouvelles formes d'organisations décentralisées et de gestion financière dans l'écosystème de la monnaie libre Ğ1.Cette méthode illustre parfaitement comment la technologie blockchain peut être utilisée pour créer des systèmes de confiance sans intermédiaire, tout en offrant une grande flexibilité aux utilisateurs. Alors que nous continuons à explorer les possibilités offertes par ce système, il est clair que la Primo Transaction a le potentiel de transformer profondément la façon dont les entreprises et les organisations opèrent dans l'économie décentralisée.

Protocole de Primo Transaction pour Duniter : Mise à Jour

Version : 0.2 (Draft)

1. Introduction

Le protocole de Primo Transaction est une méthode conçue pour établir un lien de confiance vérifiable entre un compte membre Duniter et un portefeuille externe (par exemple, un portefeuille d’entreprise). Il permet également d’associer des métadonnées riches, des contrats ou des programmes automatisés à ce portefeuille en tirant parti de la blockchain Ğ1 et du système de fichiers décentralisé IPFS.

2. Objectifs

  • Créer un lien de confiance : Établir une connexion auditable entre des membres de la Toile de Confiance (WoT) et des portefeuilles dédiés.
  • Associer des données : Lier des contrats, des statuts, des programmes ou d’autres types de données à un portefeuille.
  • Automatisation : Faciliter les opérations automatisées sur les portefeuilles d’entreprise.
  • Transparence et Flexibilité : Assurer une gestion claire et adaptable des actifs numériques et des droits associés.

3. Spécifications du protocole

3.1 Format de la Primo Transaction

Une Primo Transaction est une transaction standard sur la blockchain Duniter qui suit une convention spécifique :

  • Émetteur :<adresse_membre> – L’adresse d’un compte membre de la WoT qui initie la transaction.
  • Destinataire :<adresse_portefeuille_externe> – L’adresse du portefeuille à “certifier” ou auquel on souhaite lier des informations.
  • Montant :1 Ğ1 (ou tout autre petit montant convenu) – Ce montant symbolique ancre la transaction dans la blockchain.
  • Commentaire : Le commentaire est structuré pour être lisible par des programmes automatisés et contient un lien vers des données externes.
3.2 Enrichissement via le nom de fichier sur IPFS

Une évolution clé du protocole réside dans l’utilisation du nom de fichier stocké sur IPFS pour enrichir le contexte de la transaction. Le commentaire de la transaction contient le hash IPFS (CID), et ce hash pointe vers un fichier dont le nom est lui-même porteur de sens.

/ipfs/QmSgnkNyApL1yQ28sWBVEtj1uMuyxSdQwn1ADSjrKoJeGw/STATUTS_COPYLARADIO_UPLANET_00000000.md

Ici, le nom du fichier STATUTS_COPYLARADIO_UPLANET_00000000.md fournit des informations cruciales :

  • STATUTS : Indique la nature du document (les statuts d’une organisation).
  • COPYLARADIO : Nom de l’entité concernée.
  • UPLANET : Nom de la sous-entité concernée.
  • 00000000 : Un numéro de version identifiant unique.
  • .md (Markdown) : L’extension du fichier informe sur son format (MIME-type), ce qui permet à une application de savoir comment l’interpréter et l’afficher ou l’exécuter correctement.

Cette approche transforme une simple transaction en un véritable certificat de publication, où le contenu, sa nature et son format sont publiquement vérifiables.

On pourra étendre le protocole en utilisant des formats json, et des programmes (bash, python, ...), 
ou des applications en insérant un index.html qui peut contenir une redirection vers un lien /ipns/ 

echo "<html><head><meta http-equiv=\"refresh\" content=\"0; url=/ipns/$objectkey\"></head></html>" \
> index.html



Un pont de confiance minimaliste

Cette méthode constitue un “pont” de confiance simple et efficace. Sans modifier le cœur du protocole Duniter, elle permet de transférer les propriétés de confiance d’un compte membre de la WoT à n’importe quelle clé publique. Une simple transaction de 1 Ğ1 depuis un compte certifié suffit à “adouber” une clé et à y attacher un contexte riche et vérifiable.

Nous utilisons la blockchain Ğ1 comme registre de propriété immuable, et nous superposons des couches de données dynamiques via son jumelage IPFS, NOSTR et le format UPlanet.

  • La Blockchain Ğ1 est le “notaire” : elle enregistre la naissance d’un bien et ses transferts de propriété.
  • IPFS est la “carte d’identité” du bien : elle contient ses métadonnées statiques.
  • NOSTR est le “journal de bord” : il enregistre l’état et l’usage du bien en temps réel.
  • La UMAP est son “domicile” : elle ancre le bien dans un contexte géographique et social.
  • MULTIPASS : Le Portefeuille de Revenus Opérationnels. C’est le “compte courant”, là où les loyers ou les like arrivent et d’où la PAF est prélevée en priorité.
  • ZenCard : Le Portefeuille de Capital. C’est le “compte d’épargne” ou le “compte capital” du Sociétaire, là où ses parts sont stockées. C’est la réserve de sécurité pour payer la PAF.
  • UPassport : Le Titre de Propriété. Ce n’est pas un portefeuille, mais le “certificat d’actionnaire” numérique qui prouve le statut de Sociétaire et débloque les avantages (exemption de loyer).

Pour aider à la lisibilité, on établira un protocole concernant les commentaires de transactions

Format proposé :Uv1:<TYPE>:<CID_IPFS>

  • Av1 (3 caractères) : Préfixe identifiant. “Av1 : protocole de Gestion d’Actifs Coopératifs, version 1”.
  • <TYPE> (4-6 caractères) : Un code court pour la catégorie du bien.
    • TOOL : Outil partagé (perceuse, imprimante 3D…).
    • VEHI : Véhicule (vélo, voiture…).
    • SPAC : Espace (salle de réunion, atelier…).
    • DIGI : Actif numérique (nom de domaine, licence logicielle…).
    • BOOK : Livre ou document.
    • USER pour un sociétaire, NODE pour une machine…
  • <CID_IPFS> (le reste des caractères) : Le hash IPFS pointant vers la “carte d’identité” du bien.

Exemple de commentaire :Uv1:TOOL:QmXo2b...c9Z7d

Ce document est un projet et est sujet à modifications et améliorations basées sur les retours de la communauté Duniter et les tests d’implémentation.

Le Modèle Économique de la SCIC CopyLaRadio : Rôles et Flux Financiers

L’objectif de notre système est de créer un bilan comptable vivant et transparent, où chaque transaction est une preuve. Pour cela, nous séparons rigoureusement les flux de capital (investissement) des flux de revenus (exploitation), en utilisant des portefeuilles dédiés.

Les Acteurs : Qui fait Quoi ?

  1. L’Armateur (L’Hébergeur) :

    • Son Rôle : Fournit l’infrastructure physique. Il met à disposition l’espace, l’électricité et la connexion internet pour qu’un nœud (un “Astroport”) puisse fonctionner.
    • Sa Contribution : Un coût réel et mesurable en euros.
    • Sa Rétribution : Il reçoit la PAF (Participation Aux Frais), une somme en Ẑen destinée à couvrir ses dépenses réelles. C’est une charge d’exploitation pour la coopérative.
  2. Le Capitaine (Le Mainteneur) :

    • Son Rôle : Fournit l’expertise technique. Il installe, configure, surveille et maintient le nœud et les services qui y tournent (MULTIPASS, ZenCard, etc.). Il est le garant du bon fonctionnement.
    • Sa Contribution : Du temps et de la compétence.
    • Sa Rétribution : Il reçoit une rémunération pour son service, fixée à 2x la PAF. C’est également une charge d’exploitation pour la coopérative. Il est aussi le collecteur des loyers de son “essaim”.
  3. Le Locataire (L’Usager) :

    • Son Rôle : Utilise les services de la coopérative.
    • Sa Contribution : Paie un “loyer” en Ẑen pour son MULTIPASS (1Ẑ/sem) ou sa ZenCard (4Ẑ/sem).
    • Son Gain : L’accès à une infrastructure numérique souveraine. Ses paiements constituent le chiffre d’affaires de la coopérative.
  4. Le Sociétaire (Le Co-propriétaire) :

    • Son Rôle : Investit dans la coopérative pour en devenir co-propriétaire.
    • Sa Contribution : Fait un apport au capital en achetant une part sociale (ex: 50€/an ou 540€/3ans).
    • Son Gain : Des parts de la coopérative (représentées par des Ẑen sur sa ZenCard), un droit de vote, et des avantages (pas de loyer à payer). Son apport augmente les capitaux propres de la coopérative.

Le Cheminement des Ẑen : Une Comptabilité en Temps Réel

Utilisons les cas de Fred et Phil pour tracer les flux.

Portefeuilles Clés :

  • UPLANETNAME.G1 : La “Banque Centrale”. Reçoit les Ğ1 du monde extérieur, émet les Ẑen.
  • UPLANETNAME : Le “Compte Courant”. Gère les revenus des locations.
  • UPLANETNAME.SOCIETY : Le “Compte Capital”. Gère les parts des sociétaires.

Étape 1 : Augmentation de Capital (Les Sociétaires)

Cas de Phil :

  1. Phil achète une part de 540€ sur OpenCollective. Cet argent arrive sur le compte en banque de la SCIC.
  2. La SCIC constate cet apport. Sa trésorerie UPLANETNAME.G1émet 540 Ẑen. C’est une augmentation de capital.
  3. Le portefeuille UPLANETNAME.SOCIETY transfère ces 540 Ẑen sur la ZenCard de Phil. Phil est désormais sociétaire, et sa part est inscrite sur la blockchain. Son MULTIPASS et sa ZenCard sont marqués /U.SOCIETY pour être exemptés de loyer.

Cas de Fred :

  1. Fred apporte du matériel d’une valeur de 4500€. C’est un apport en nature.
  2. La coopérative valide cette valeur et l’inscrit comme un actif à son bilan.
  3. La trésorerie UPLANETNAME.G1émet 4500 Ẑen pour représenter cette augmentation de capital.
  4. Le portefeuille UPLANETNAME.SOCIETY transfère ces 4500 Ẑen sur la ZenCard de Fred.

Étape 2 : Le Cycle d’Exploitation (Les Locataires et les Frais)

C’est un cycle quotidien, géré par les scripts.

  1. Le Loyer Entre (NOSTRCARD.refresh.sh) :

    • Un Locataire a rechargé son compte via OpenCollective. Le portefeuille UPLANETNAME a crédité son MULTIPASS en Ẑen.
    • Chaque semaine, le script débite le loyer du MULTIPASS du Locataire.
    • Ce montant est crédité sur le MULTIPASS du Capitaine responsable de ce Locataire. Le MULTIPASS du Capitaine agit comme son portefeuille de revenus opérationnels.
  2. La PAF Sort (ZEN.ECONOMY.sh) :

    • Chaque jour, ce script calcule les charges du nœud géré par le Capitaine (PAF pour l’Armateur + 2xPAF pour le Capitaine lui-même).
    • Il débite ce montant du MULTIPASS du Capitaine.
    • Il crédite la PAF correspondante au portefeuille de l’Armateur (NODE).

Étape 3 : L’Alignement des Intérêts (Le Génie du Système)

Que se passe-t-il si un Capitaine n’a pas assez de revenus locatifs sur son MULTIPASS pour payer la PAF ?

C’est là que le système montre sa robustesse : le script ira prélever les Ẑen manquants sur sa ZenCard, c’est-à-dire sur ses parts de capital.

Exemple avec Fred :

  • Fred est Capitaine et Armateur de son matériel.
  • Il gère 10 Locataires qui lui rapportent 10 Ẑen/semaine sur son MULTIPASS.
  • Mais la PAF de son infrastructure est de 15 Ẑen/semaine.
  • Son MULTIPASS est à 0, mais il doit encore 5 Ẑen.
  • Le script ZEN.ECONOMY.sh prélèvera ces 5 Ẑen sur sa ZenCard.

Conséquence pour l’administration fiscale :
C’est parfaitement clair. L’activité de Fred en tant que Capitaine est déficitaire. Pour couvrir ses charges d’exploitation, il doit puiser dans son propre capital. C’est un compte courant d’associé automatisé. Il “prête” de l’argent à son activité. S’il trouve plus de locataires, son activité deviendra rentable et il pourra reconstituer son capital.

Ce mécanisme garantit que la coopérative n’est jamais en déficit. C’est le sociétaire-opérateur qui assume le risque de son exploitation, ce qui l’incite à développer son “essaim” pour le rendre rentable.


Ce système offre une lisibilité comptable parfaite :

  • Les Apports au Capital sont des transactions uniques et identifiables, issues du wallet UPLANETNAME.SOCIETY.
  • Le Chiffre d’Affaires est la somme des “loyers” collectés par les Capitaines.
  • Les Charges d’Exploitation sont la somme des PAF versées aux Armateurs et aux Capitaines.
  • Le Résultat (Bénéfice/Perte) est la différence entre les deux.

Tout est tracé, public et automatisé. C’est un livre de comptes vivant qui ne ment jamais.