Transferir ARC-20
Construa uma transferencia que coloca cada unidade onde pretende e nao queima nada.
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
-
guides/transfer-arc20 - Normative authority
- Executed source code at a pinned revision
- Networks
- mainnet
- Documentation version
- 2026.08
- Audience
- everyone, holder
- Owner
- bitcoin-universe-docs
- Sources
-
- Atomicals ElectrumX
at
v1.5.2.0 - Atomicals JavaScript CLI
at
1333565efbfe
- Atomicals ElectrumX
at
- Known limitations
-
- A superficie visivel de transferencia da Universe nao constroi alocacoes parciais para destinatarios nem troco colorido a partir de um campo de montante. Use um construtor compativel que trabalhe em outpoints e valores de saida.
Antes de comecar
Seção intitulada “Antes de comecar”- Redes suportadas: mainnet.
- Estado: comportamento de protocolo.
- Precisa de uma carteira ou construtor que trabalhe em outpoints e valores em satoshis, nao num campo de montante.
A forma que funciona
Seção intitulada “A forma que funciona”| Posicao | Conteudo |
|---|---|
| Entrada 0 | O lote colorido |
| Entrada 1 e seguintes | Entradas cardinais para a taxa |
| Saida 0 | O destinatario, dimensionada exatamente para as unidades que envia |
| Saida 1 | Troco colorido, dimensionado exatamente para o resto |
| Saida 2 | Troco cardinal, se existir |
O procedimento
Seção intitulada “O procedimento”- Liste os seus outpoints coloridos e escolha o lote a gastar.
- Decida o montante a enviar. Esse numero e tambem o valor em satoshis da saida 0.
- Calcule o resto: valor do lote menos montante enviado. Esse e o valor em satoshis da saida 1.
- Modele o conjunto exato de entradas e saidas no visualizador de alocacao.
- Confirme que o valor queimado e zero.
- Adicione entradas cardinais para a taxa e uma saida de troco cardinal no fim.
- Modele de novo com as entradas e saidas de taxa incluidas. O valor queimado tem de continuar a ser zero.
- Construa a transacao, preservando a ordem das entradas e das saidas.
- Compare o pedido da carteira com o seu modelo, linha a linha.
- Assine e difunda.
Por que o passo sete existe
Seção intitulada “Por que o passo sete existe”Adicionar uma entrada de taxa ou uma saida de troco muda o conjunto de saidas, e a alocacao percorre as saidas por ordem. Uma transferencia que estava limpa antes de a carteira adicionar troco pode queimar depois.
Os dois vetores que mostram o risco
Seção intitulada “Os dois vetores que mostram o risco”| Case | Coloured inputs | Result per output | Burned | Clean |
|---|---|---|---|---|
A remainder smaller than the change output burns dust-remainder-burns | 1200 units at input 0 | out 0: 1000 sats to 1000 units; out 1: 200 sats to 200 units | none | yes |
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 mesma intencao, o mesmo lote, o mesmo montante enviado. A unica diferenca e o tamanho da saida de troco, e uma delas destroi 200 unidades.
Uma taxa Bitcoin, paga a partir de uma entrada cardinal. Sem par commit e reveal, e sem mineracao, para uma transferencia comum.
Se falhar
Seção intitulada “Se falhar”- A carteira nao o deixa definir valores de saida em satoshis: use outro construtor.
- A carteira reordena as saidas: use outro construtor. A ordem e o significado.
- O valor queimado nao e zero: mude os tamanhos das saidas, nao prossiga.
Depois de difundir
Seção intitulada “Depois de difundir”Confirme, aguarde a indexacao, leia a localizacao do ativo e verifique o valor queimado registado. Veja verificar uma transacao.