Queimas
Como o valor ARC-20 e destruido, as quatro formas que o causam, e as verificacoes que evitam cada uma delas.
Protocol behavior Verified 2026-08-31
Describes the Atomicals protocol itself at the pinned reference revision. It does not promise that any product exposes it.
- Page ID
-
protocol/arc20/burns - Normative authority
- Executed source code at a pinned revision
- Networks
- mainnet
- Documentation version
- 2026.08
- Audience
- everyone, holder, developer
- Owner
- bitcoin-universe-docs
- Sources
-
- Atomicals ElectrumX
at
v1.5.2.0
- Atomicals ElectrumX
at
- Known limitations
-
- Uma queima confirmada e permanente. Nada nesta documentacao consegue reverter uma.
Uma queima e valor colorido que um validador nao conseguiu colocar em nenhuma saida elegivel. Fica registado como destruido. A transacao Bitcoin que a causou e valida, minerada e confirmada.
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.
As quatro formas que causam uma queima
Seção intitulada “As quatro formas que causam uma queima”1. A proxima saida e demasiado grande
Seção intitulada “1. A proxima saida e demasiado grande”A mais comum. Faltam colocar 500 unidades e a proxima saida tem 546 satoshis. Nao cabe, por isso as 500 unidades sao destruidas.
Prevencao. Dimensione a saida de troco exatamente para o resto que pretende manter.
2. Nao ha saidas suficientes
Seção intitulada “2. Nao ha saidas suficientes”Todas as saidas foram cobertas e ainda sobra valor. Nao resta nada onde o colocar.
Prevencao. Inclua sempre uma saida de troco colorida quando as entradas excedem o que esta a enviar.
3. A primeira saida e maior do que o lote inteiro
Seção intitulada “3. A primeira saida e maior do que o lote inteiro”Nada pode ser colocado, por isso o lote inteiro queima.
Prevencao. Nunca envie um lote colorido pequeno para uma transacao cuja primeira saida e um pagamento cardinal grande.
4. O recuo reorganizou uma transacao com varios tokens
Seção intitulada “4. O recuo reorganizou uma transacao com varios tokens”Um token nao pode ser colocado de forma limpa, por isso o construtor reiniciou todos os tokens a partir da saida zero e outro token perdeu o seu lugar.
Prevencao. Mova um token por transacao, a menos que tenha modelado o caso com varios.
Casos executados
Seção intitulada “Casos executados”| 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 |
As verificacoes que evitam as quatro
Seção intitulada “As verificacoes que evitam as quatro”- Calcule a atribuicao esperada antes de assinar, nao depois.
- Confirme que o valor queimado e zero.
- Dimensione cada saida colorida deliberadamente, em satoshis.
- Mantenha as entradas de taxa cardinais e separadas.
- Mova um token por transacao, a menos que tenha uma razao para nao o fazer.
- Verifique de novo apos qualquer alteracao ao conjunto de saidas, incluindo troco adicionado pela carteira.
Use o visualizador de alocacao para os passos um e dois.
Detetar uma queima depois do facto
Seção intitulada “Detetar uma queima depois do facto”Um validador regista as queimas por transacao. Leia a transacao atraves de uma fonte que as reporte e compare o total colorido de entrada com a soma dos totais coloridos de saida. Qualquer diferenca e uma queima.
O feed de atividade ARC-20 da Universe publica registos de queima entre a sua atividade confirmada. Veja API ARC-20.