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 respuestaX-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
codede error (consulta Límites y errores) no se cobra y no llevaX-Node-API-WU. - Un método que el nodo no tiene —
404 method_not_found, conX-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.
{"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.