Recarga automática
A Recarga automática monitora um endereço TRON e o reabastece sempre que a energia ou a largura de banda dele cai abaixo de um nível definido por você. Você escolhe o limiar, quanto adicionar a cada vez e a duração do aluguel. Cada recarga é um pedido comum, pago com o seu saldo.Como funciona
- Crie uma regra para um endereço com um limiar, um
add_volumee umaduration. - Verificamos quanta energia (ou largura de banda) o endereço tem disponível uma vez por minuto e logo após cada transferência USDT de saída desse endereço.
- Se o nível estiver abaixo do limiar, compramos
add_volumepara o endereço e cobramos do seu saldo pelo seu preço. - O aluguel termina ao fim da sua duração. Quando o nível volta a cair abaixo do limiar, a regra compra de novo. É assim que a regra mantém o endereço abastecido: não existe uma etapa separada de renovação.
last_read_error_at, e a verificação seguinte tenta de novo.
Criar uma regra não compra nada na hora. A primeira recarga acontece na verificação seguinte, normalmente em até um minuto. A resposta da criação informa se ela vai acontecer (will_refill_now) e quanto o endereço tem neste momento.
A Recarga automática reage depois que o nível cai; ela não se antecipa a uma transferência. Defina o limiar em pelo menos o que a sua próxima transação precisa, para que a transação já esteja coberta quando for enviada.
Energia e largura de banda
Os dois recursos têm endpoints próprios e regras próprias. Um endereço pode ter uma regra de energia e uma regra de largura de banda ao mesmo tempo; cada uma é comparada com o seu próprio limiar.
A energia é alugada por uma hora. Quando ela se esgota ou expira, o nível cai e a regra compra a hora seguinte.
A largura de banda conta tudo com que o endereço pode pagar uma transação: as 600 unidades gratuitas que toda conta recebe por dia, mais qualquer largura de banda em stake ou delegada. Por isso, um limiar de 600 ou menos é atendido só pela cota gratuita, até que o endereço a gaste.
Escolhendo os números
Uma transferência USDT usa cerca de 65.000 de energia quando o destinatário já possui USDT e cerca de 131.000 quando não possui, mais aproximadamente 345 de largura de banda. Por exemplo,threshold_energy: 65000 com add_volume: 131000 compra o equivalente a duas transferências sempre que resta menos do que uma.
Custo
Cada recarga é um pedido comum: o aluguel pela sua tarifa mais a taxa fixa, cobrada em toda recarga.estimated_cost_per_refill_trx nas respostas de listagem e de criação é o preço total de uma recarga para a sua conta, taxa fixa incluída. Para ver esse preço antes de criar uma regra, use o endpoint de cotação: energia, largura de banda. Um add_volume pequeno, recarregado com frequência, paga a taxa fixa muitas vezes; um maior a paga com menos frequência.
Uma regra criada com uma chave de API tem o preço de uma compra feita com essa chave de API; uma regra criada no site tem o preço de uma compra feita no site. estimated_cost_per_refill_trx já reflete isso.
Se o endereço ainda não existe na blockchain, a primeira recarga também o ativa, como em uma compra comum. A ativação é cobrada à parte e não entra em estimated_cost_per_refill_trx; o pedido a mostra em activation_cost_trx.
Não há teto de gasto diário: uma regra compra sempre que o nível está abaixo do limiar e o seu saldo cobre uma recarga.
Pedidos e webhooks
Toda recarga aparece no seu histórico de pedidos (Listar pedidos) comsource: "autorefill". Para listar apenas os pedidos de recarga, chame GET /orders?source=autorefill; para exportá-los como arquivo, use o relatório autorefill.
As regras criadas com uma chave de API enviam webhooks order.updated para os seus pedidos de recarga, assim como os pedidos que você faz pela API. As regras criadas sem chave de API não enviam.
Status da regra
Pausada após falhas. Uma recarga que falha é reembolsada como qualquer pedido que falhou. Após 5 recargas com falha seguidas, a regra é pausada e
stopped_reason informa o motivo da última falha. consecutive_failures mostra quão perto a regra está desse limite; o contador volta a 0 após uma recarga bem-sucedida e quando você retoma a regra. Uma regra pausada nunca é retomada sozinha: corrija a causa e depois defina status: "active".
Parada por saldo. Quando o seu saldo não cobre uma recarga, a regra para com stopped_insufficient_balance. Assim que um depósito eleva o saldo até o preço de uma recarga, a regra volta a active automaticamente. Você também pode definir status: "active" por conta própria; se o saldo ainda for insuficiente, a regra para de novo na verificação seguinte.
Se a sua conta do Telegram estiver vinculada, você recebe uma mensagem na primeira recarga de uma regra e quando uma regra é pausada, parada por saldo ou retomada.
Limites
- Uma regra por endereço e recurso em cada conta. Criar uma segunda regra de energia (ou uma segunda regra de largura de banda) para o mesmo endereço retorna
409 AUTOREFILL_ADDRESS_TAKEN— edite a regra existente. - 20 regras de energia e 20 regras de largura de banda por conta. Regras excluídas não contam. Acima do limite:
409 AUTOREFILL_LIMIT_REACHED. - Sem endereços de contrato, como o contrato do token USDT: a TRON não permite delegar recursos a eles.
- A criação de regras é limitada a 10 requisições por minuto por conta, para cada recurso. Veja Limites de Taxa.
Edição e exclusão
As alterações valem a partir da verificação seguinte. Enquanto uma recarga da regra está sendo comprada,PATCH e DELETE retornam 409 AUTOREFILL_IN_PROGRESS — tente novamente em um minuto. Excluir uma regra não recupera a energia ou a largura de banda já compradas; esses aluguéis seguem até o fim do seu prazo.