Brulures

Une brulure est de la valeur coloree qu un validateur n a pas pu placer dans une sortie eligible. Elle est enregistree comme detruite. La transaction Bitcoin qui l a causee est valide, minee et confirmee.

Il n y a aucune recuperation

Les unites brulees ne vont nulle part. Aucune adresse ne les detient et aucune procedure ne les rend. La prevention est le seul controle.

How coloured value is destroyed. A coloured input of 1200 satoshis is spent. Output zero is 700 satoshis and receives 700 units. The next eligible output is 546 satoshis, which is larger than the 500 units still to place, so it receives nothing and those 500 units are recorded as burned. The Bitcoin transaction is valid and confirms. Making output one 500 satoshis instead would have placed all the value cleanly.

How coloured value is destroyed

A coloured input of 1200 satoshis is spent. Output zero is 700 satoshis and receives 700 units. The next eligible output is 546 satoshis, which is larger than the 500 units still to place, so it receives nothing and those 500 units are recorded as burned. The Bitcoin transaction is valid and confirms. Making output one 500 satoshis instead would have placed all the value cleanly.

Les quatre formes qui causent une brulure

1. La sortie suivante est trop grande

La plus courante. Il reste 500 unites a placer et la sortie suivante fait 546 satoshis. Cela ne tient pas, donc les 500 unites sont detruites.

Prevention. Dimensionnez la sortie de monnaie exactement au reste que vous voulez garder.

2. Il n y a pas assez de sorties

Toutes les sorties ont ete couvertes et il reste de la valeur. Il ne reste rien ou la placer.

Prevention. Incluez toujours une sortie de monnaie coloree lorsque les entrees depassent ce que vous envoyez.

3. La premiere sortie est plus grande que le lot entier

Rien ne peut etre place, donc le lot entier brule.

Prevention. N envoyez jamais un petit lot colore dans une transaction dont la premiere sortie est un gros paiement cardinal.

4. Le repli a reorganise une transaction a plusieurs jetons

Un jeton n a pas pu etre place proprement, donc le constructeur a redemarre tous les jetons depuis la sortie zero et un autre jeton a perdu sa place.

Prevention. Deplacez un jeton par transaction, sauf si vous avez modelise le cas a plusieurs.

Cas executes

Executed ARC-20 allocation vectors from conformance/vectors/arc20-allocation.json

Case	Coloured inputs	Result per output	Burned	Clean
Oversized next output burns the remainder oversized-next-output	1200 units at input 0	out 0: 700 sats to 700 units; out 1: 546 sats to 0 units	500 units of TOKENA	no
Outputs run out before the value does too-few-outputs	1200 units at input 0	out 0: 700 sats to 700 units	500 units of TOKENA	no
First output larger than the whole lot first-output-too-large	500 units at input 0	out 0: 20000 sats to 0 units	500 units of TOKENA	no
A change output larger than the remainder burns it change-output-too-large	1200 units at input 0	out 0: 1000 sats to 1000 units; out 1: 546 sats to 0 units	200 units of TOKENA	no
A non-clean slot triggers the output zero fallback two-tokens-non-clean-fallback	700 units at input 0, 400 units at input 1	out 0: 700 sats to 700 units; out 1: 546 sats to 0 units	400 units of TOKENB	no

Les verifications qui evitent les quatre

1. Calculez l attribution attendue avant de signer, pas apres.
2. Confirmez que le chiffre de brulure est zero.
3. Dimensionnez chaque sortie coloree deliberement, en satoshis.
4. Gardez les entrees de frais cardinales et separees.
5. Deplacez un jeton par transaction, sauf raison contraire.
6. Reverifiez apres toute modification de l ensemble des sorties, y compris la monnaie ajoutee par le portefeuille.

Utilisez le visualiseur d attribution pour les etapes un et deux.

Detecter une brulure apres coup

Un validateur enregistre les brulures par transaction. Lisez la transaction via une source qui les signale, et comparez le total colore d entree a la somme des totaux colores de sortie. Toute difference est une brulure.

Le flux d activite ARC-20 d Universe publie les enregistrements de brulure parmi son activite confirmee. Voir API ARC-20.