Saltar para o conteúdo principal
POST
Mover Pacotes

Mover Pacotes

Move todos os pacotes ativos e pausados da sua conta no endereço para um novo endereço, com todas as transferências restantes. Um único pacote não pode ser movido separadamente. Use quando a carteira que envia as transferências mudar.
  • Os pacotes que estavam funcionando continuam funcionando no novo endereço. Os pacotes pausados continuam pausados lá — retome-os com o novo endereço quando precisar.
  • As 24 horas pagas continuam correndo durante a mudança, como numa pausa. Se elas tiverem acabado quando os pacotes começarem no novo endereço, uma transferência é cobrada na hora; caso contrário, nada é cobrado.
  • A mudança em si é gratuita, e não há limite de quantas vezes você pode mover.
  • Se o novo endereço ainda não estiver ativado na rede TRON, ele é ativado por conta da sua conta, como numa compra.
  • As transferências do endereço antigo deixam de ser atendidas e contadas depois da resposta.
O novo endereço deve ter nenhum pacote de transferência de nenhuma conta e nenhum Smart Mode ativo.
A chamada responde em cerca de 15 segundos ou mais — defina o tempo limite do seu cliente em 60 segundos. A entrega ao endereço antigo é interrompida primeiro, e as transferências já enviadas dele são contadas. Uma transferência do endereço antigo depois da resposta não recebe energia. Espere a resposta antes de trocar a carteira.

Corpo da requisição

string
obrigatório
Endereço TRON em que os pacotes estão agora
string
obrigatório
Endereço TRON para o qual mover os pacotes. Deve ser diferente de address e não pode ser um contrato inteligente

Resposta

string
O novo endereço — onde os pacotes estão agora.
string
O endereço de onde os pacotes foram movidos.
array
Os pacotes movidos — os mesmos objetos de Listar Pacotes, com address definido como o novo endereço. status é active para os pacotes que estavam funcionando (paused_at é null) e paused para os que estavam pausados.

Exemplo

Aqui o pacote estava funcionando e as 24 horas pagas não tinham acabado, então nada foi cobrado: subscription_used e remaining são os mesmos de antes da mudança.
Response

Webhooks

Mover pacotes em funcionamento os pausa no endereço antigo, os move e os retoma no novo, então cada pacote envia três eventos nesta ordem:
  1. package.paused com o address antigo;
  2. package.moved com o novo address e o antigo em previous_address;
  3. package.resumed com o novo address.
Mover pacotes pausados envia apenas package.moved. Os eventos são enviados nesta ordem, mas entregues de forma independente, então podem chegar em outra — compare o timestamp do envelope ou leia o estado atual em Listar Pacotes.

Erros

Retornados no formato padrão, em detail.error.code. Estes vêm antes de qualquer alteração ou cobrança — os pacotes continuam funcionando no endereço antigo: Estes vêm da interrupção da entrega no endereço antigo. Nada foi movido, e os pacotes continuam funcionando no endereço antigo. Se o novo endereço foi ativado antes do erro, essa ativação continua cobrada — o endereço permanece ativado para uma mudança posterior: Estes vêm depois que a entrega ao endereço antigo foi interrompida. A mensagem diz onde os pacotes estão agora: ADDRESS_BUSY e MOVE_AFTER_PAUSE também podem vir nesta etapa, quando outra operação no endereço se intrometeu. Os pacotes ficam então pausados no endereço antigo; repita a mudança para transferi-los — eles chegam pausados.
Depois de qualquer erro, Listar Pacotes mostra onde está cada pacote e em que status.