Pular para o conteúdo

AccountDelete

[Fonte]

Adicionado pela emenda DeletableAccounts

{
"TransactionType": "AccountDelete",
"Account": "rWYkbWkCeg8dP6rXALnjgZSjjLyih5NXm",
"Destination": "rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe",
"DestinationTag": 13,
"Fee": "2000000",
"Sequence": 2470665,
"Flags": 2147483648
}
CampoTipo JSON[Tipo Interno][]Descrição
DestinationString - AddressAccountIDO endereço de uma conta para receber qualquer XAH restante após a exclusão da conta remetente. Deve ser uma conta ativa no ledger e não pode ser a conta remetente.
DestinationTagNumberUInt32(Opcional) Tag de destino arbitrária que identifica um destinatário hospedado ou outras informações para o destinatário do XAH restante da conta excluída.

Como medida adicional de dissuasão contra spam no ledger, a transação AccountDelete exige um custo de transação muito maior que o usual: em vez do mínimo padrão de 0,00001 XAH, o AccountDelete deve destruir pelo menos o valor da reserva do proprietário, atualmente 2 XRP. Isso desencoraja a criação excessiva de novas contas, pois o requisito de reserva não pode ser totalmente recuperado ao excluir a conta.

O custo da transação sempre se aplica quando uma transação é incluída em um ledger validado, mesmo que a transação falhe ao excluir a conta. (Consulte Casos de Erro.) Para reduzir bastante as chances de pagar o alto custo de transação caso a conta não possa ser excluída, envie a transação com fail_hard habilitado.

Além dos erros que podem ocorrer em todas as transações, as transações AccountDelete podem resultar nos seguintes códigos de resultado:

Código de ErroDescrição
temDISABLEDOcorre se a emenda DeletableAccounts não estiver habilitada.
temDST_IS_SRCOcorre se o Destination corresponder ao remetente da transação (campo Account).
tecDST_TAG_NEEDEDOcorre se a conta Destination exigir uma tag de destino, mas o campo DestinationTag não tiver sido fornecido.
tecNO_DSTOcorre se a conta Destination não for uma conta ativa no ledger.
tecNO_PERMISSIONOcorre se a conta Destination exigir autorização de depósito e o remetente não estiver pré-autorizado.
tecTOO_SOONOcorre se o número de Sequence do remetente for muito alto. O número de Sequence da transação mais 256 deve ser menor que o [Índice do Ledger][] atual. Isso evita a repetição de transações antigas caso esta conta seja recriada após ser excluída.
tecHAS_OBLIGATIONSOcorre se a conta a ser excluída estiver vinculada a objetos que não podem ser excluídos no ledger. (Isso inclui objetos criados por outras contas, como escrows e, por exemplo, NFTs cunhados, mesmo que pertençam a outra conta.)
tefTOO_BIGOcorre se a conta remetente estiver vinculada a mais de 1000 objetos no ledger. A transação pode ser bem-sucedida em uma nova tentativa se alguns desses objetos forem excluídos separadamente antes.