Saltar para o conteúdo principal

​
O que é um WU

Um WU é a unidade de uso do Node API. A cota do seu plano e o seu limite de leitura são contados em WU. Uma chamada custa WU de acordo com o tamanho da resposta do nó: quanto mais dados o nó retorna, mais trabalho ele fez. A maioria das chamadas — uma conta, seus recursos, uma chamada de contrato, montar ou transmitir uma transação — custa 1 WU. Toda chamada respondida informa o seu custo: o cabeçalho de resposta X-Node-API-WU no HTTP, os metadados finais x-node-api-wu no gRPC. O painel mostra o seu uso por dia.

​
A fórmula

  • KB — o tamanho da resposta do nó em kilobytes (bytes ÷ 1024), antes da compactação. O gzip economiza tráfego, não WU.
  • round — para o inteiro mais próximo; metades são arredondadas para cima.
  • factor — depende do tipo de chamada:
As mesmas regras valem para /walletsolidity/* e para o gRPC, em que a resposta é medida em protobuf e os equivalentes gRPC desses métodos (GetNowBlock2, GetBlockByNum2, GetBlock, …) contam como os mesmos tipos de chamada. Com fator 1, respostas de até cerca de 34 KB custam 1 WU.

​
Blocos recentes

Um bloco a até 20 da ponta da rede — mais ou menos o último minuto — custa um valor fixo de 3 WU, e seus recibos 2 WU, seja qual for o tamanho. Um bloco que ainda não foi produzido custa o que a sua resposta (vazia) custa: 1 WU. Blocos mais antigos e seus recibos são cobrados pela fórmula. Os intervalos (getblockbylimitnext, getblockbylatestnum) são sempre cobrados pela fórmula, sobre a resposta inteira, e retornam no máximo 10 blocos por chamada.

​
Exemplos medidos

​
O que não custa nada

  • Recusas. Uma requisição recusada com um code de erro (veja Limites e erros) não é cobrada e não traz X-Node-API-WU.
  • Um método que o nó não tem — 404 method_not_found, com X-Node-API-WU: 0. Ainda assim conta como uma chamada no seu limite por segundo, então um loop de erros de digitação é desacelerado, não cobrado.
  • Nenhuma resposta do nó — 502 node_error.
Um erro retornado pelo próprio nó é uma resposta: o java-tron informa a maioria dos erros em JSON ({"Error": "…"}), muitas vezes com status 200, e eles são cobrados pelo tamanho como qualquer resposta — no mínimo 1 WU.

​
Estimando o seu uso

  • Acompanhar todos os blocos da rede — o cabeçalho (1 WU) mais os recibos do bloco recente (2 WU) — custa 3 WU por bloco: cerca de 86400 WU por dia, ou cerca de 2.6M WU em 30 dias.
  • Uma transferência USDT montada e transmitida pelo nó custa 2 WU.
  • Ler blocos antigos é a parte cara: um bloco antigo de 600–800 KB custa 13–17 WU.
A cota é gasta em WU; os limites por segundo são contados por classe de chamada — WU de leitura por segundo, requisições de blocos por segundo, transações enviadas por segundo. Veja Limites e erros e os números de cada plano em Planos e cobrança.