Résumé exécutif
Une proposition de trésorerie est une proposition de gouvernance dont le contenu exécutable autorise une action de trésorerie sur la chaîne (généralement un transfert, une subvention ou un appel de contrat). Dans Livepeer, les propositions de trésorerie sont appliquées au niveau du protocole (sur la chaîne)protocole (sur la chaîne): une fois que le quorum et les seuils sont atteints et que le délai d’attente expire, les actions encodées s’exécutent de manière déterministe.
Cette page définit la structure des charges utiles des propositions de trésorerie, leurs sémantiques d’exécution et les principaux modes de défaillance.
Une proposition de trésorerie est un tuple d’actions exécutables :
Chaque action est définie comme :
Où :
- Cibleest le contrat ou l’adresse appelée
- Valeurest le montant du jeton natif attaché (le cas échéant)
- Donnéesest le calldata encodé en ABI spécifiant le sélecteur de fonction et les arguments
La proposition passe par la gouvernance et s’exécute après le délai de blocage.
2. Autorisation de gouvernance
Soient les variables de mise en garde :
- = mise en garde du votant
- = mise en garde totale
Pouvoir de vote :
Condition de quorum :
Condition seuil (exemple) :
Seules les propositions respectant les conditions de gouvernance entrent dans la file d’attente du timelock.
3. Sémantique de la file d’attente du timelock
Une fois approuvée, la proposition est placée dans un timelock avec un délai.
Le timelock fournit :
- Fenêtre d’exécution prévisible
- Temps de réaction pour les parties prenantes
- Atténuation des changements soudains ou malveillants
L’exécution n’est possible qu’après l’expiration du délai.
4. Sémantique d’exécution
Après l’expiration du timelock, les tentatives d’exécution tentent d’appliquer chaque action de manière atomique au sein de la transaction d’exécution.
Deux propriétés importantes :
- Déterminisme : l’exécution est strictement définie par les données de calldata
- Atomicité : si une action échoue, la transaction est annulée, sauf si le modèle d’exécution tolère explicitement un échec partiel
Les propositions de trésorerie doivent donc être rédigées en tenant compte de la correction des données de calldata et du modèle d’échec.
5. Transfert de trésorerie en tant que cas canonique
Une action courante est un transfert de trésorerie.
Si le solde de la trésorerie est et le montant de l’allocation est:
Le solde du destinataire augmente de selon les règles de transfert de l’actif.
6. Modes de défaillance
L’exécution d’une proposition de trésorerie peut échouer pour plusieurs raisons.
6.1 Erreur de calldata
Un sélecteur de fonction incorrect ou une encodage ABI mal formé provoque un rejet.
6.2 Solde du trésor insuffisant
Le montant transféré dépasse les réserves du trésor.
6.3 Réversion du contrat cible
Le contrat appelé rejette l’appel en raison de contrôles d’accès, d’un état mis en pause ou de la validation des paramètres.
6.4 Sémantique du transfert d’actif
Certains contrats de jetons peuvent :
- Renvoyer false au lieu de reverting
- Appliquer les frais de transfert
- Appliquer les listes d’autorisation
Les auteurs de propositions doivent vérifier le comportement de l’actif cible.
6.5 Configuration du timelock
Si les conditions de délai du timelock ou de fenêtre d’exécution sont mal configurées, les propositions peuvent devenir non exécutables.
7. Liste de prévention des risques
Avant de soumettre une proposition de trésorerie :
- Vérifier les adresses et contrats cibles via le registre
- Confirmer que le codage ABI est correct
- Confirmer que le solde de la trésorerie est suffisant
- Simuler l’exécution si possible
- Assurez-vous que le calldata est auditable et minimement limité
8. Flux d’exécution des propositions
9. Séparation entre le protocole et le réseau
Protocole (sur la chaîne) :
- Définition du contenu de la proposition
- Comptage des votes et autorisation
- File d’attente de timelock
- Exécution déterministe
- Transferts du trésor
Réseau (hors chaîne) :
- Rédaction et examen
- Livraison des subventions et exécution opérationnelle par les bénéficiaires
Les propositions de trésorerie sont appliquées par la logique du protocole ; les résultats nécessitent une livraison hors chaîne.
Références
Last modified on March 1, 2026
