Saltar al contenido principal

Qué es un WU

Un WU es la unidad de uso de Node API. La cuota de tu plan y su límite de lectura se cuentan en WU. Una llamada cuesta WU según el tamaño de la respuesta del nodo: cuantos más datos devuelve el nodo, más trabajo ha hecho. La mayoría de las llamadas — una cuenta, sus recursos, una llamada a un contrato, construir o transmitir una transacción — cuestan 1 WU. Cada llamada respondida te indica su coste: el encabezado de respuesta X-Node-API-WU por HTTP y los metadatos finales x-node-api-wu por gRPC. El panel muestra tu uso por día.

La fórmula

  • KB — el tamaño de la respuesta del nodo en kilobytes (bytes ÷ 1024), antes de la compresión. gzip ahorra tráfico, no WU.
  • round — al entero más cercano; las mitades se redondean hacia arriba.
  • factor — depende del tipo de llamada:
Las mismas reglas se aplican a /walletsolidity/* y a gRPC, donde la respuesta se mide en protobuf y los equivalentes gRPC de estos métodos (GetNowBlock2, GetBlockByNum2, GetBlock, …) cuentan como los mismos tipos de llamada. Con el factor 1, las respuestas de hasta unos 34 KB cuestan 1 WU.

Bloques recientes

Un bloque a 20 o menos de la cabeza de la red — aproximadamente el último minuto — cuesta un precio fijo de 3 WU, y sus recibos 2 WU, sea cual sea su tamaño. Un bloque que aún no se ha producido cuesta lo que cuesta su respuesta (vacía): 1 WU. Los bloques más antiguos y sus recibos se cobran según la fórmula. Los rangos (getblockbylimitnext, getblockbylatestnum) se cobran siempre según la fórmula, sobre la respuesta completa, y devuelven como máximo 10 bloques por llamada.

Ejemplos medidos

Qué no cuesta nada

  • Los rechazos. Una solicitud rechazada con un code de error (consulta Límites y errores) no se cobra y no lleva X-Node-API-WU.
  • Un método que el nodo no tiene — 404 method_not_found, con X-Node-API-WU: 0. Aun así cuenta como una llamada para tu límite por segundo, de modo que un bucle de erratas se frena, no se factura.
  • Ninguna respuesta del nodo — 502 node_error.
Un error que devuelve el propio nodo es una respuesta: java-tron informa de la mayoría de los errores como JSON ({"Error": "…"}), a menudo con el estado 200, y se cobran por tamaño como cualquier respuesta — al menos 1 WU.

Estimar tu uso

  • Seguir cada bloque de la cadena — el encabezado (1 WU) más los recibos del bloque reciente (2 WU) — son 3 WU por bloque: unos 86400 WU al día, o unos 2.6M WU en 30 días.
  • Una transferencia USDT construida y transmitida a través del nodo cuesta 2 WU.
  • Leer bloques antiguos es la parte cara: un bloque antiguo de 600–800 KB cuesta 13–17 WU.
La cuota se gasta en WU; los límites por segundo se cuentan por clase de llamada — WU de lectura por segundo, solicitudes de bloques por segundo, envíos de transacciones por segundo. Consulta Límites y errores y las cifras de cada plan en Planes y facturación.