nano-sdk v2: preparando las herramientas antes de que llegue node V29
Si construyes cualquier cosa sobre Nano (un monedero, un explorador, un servicio de datos de mercado), tarde o temprano acabas hablando con un nodo. nano-sdk es la biblioteca TypeScript que hace agradable esa conversación: llamadas RPC tipadas, temas WebSocket validados y esquemas de respuesta que coinciden con lo que el nodo devuelve de verdad. Esta semana Exxenoz ha publicado la primera beta de la versión 2, y hay un detalle que pesa más que cualquier función incluida: Nano node V29 aún no se ha publicado. El SDK simplemente se está adelantando.
La línea divisoria, trazada con antelación
La beta traza una línea de compatibilidad clara: la versión 2 hablará con Nano node V29, la versión 1 se queda en V28.2. Esa división importa más que cualquier función nueva, y se traza a propósito, antes de tiempo. El SDK ya valida el nuevo campo topo_height en el historial de cuentas y la información de bloques, las prioridades de bootstrap reestructuradas y las capacidades de pares de V29, de modo que cuando el nodo por fin se publique, las herramientas ya estarán en su sitio. Es la diferencia entre actualizarse a la vez que un nodo y salir corriendo después.
nano-sdk 2.x → Nano node V29.0 nano-sdk 1.x → Nano node V28.2
Lo que V29 desbloqueará para los creadores
Lo interesante no está en el changelog, sino en lo que los cambios preparan:
Telemetría
p50 · p90 · p99
Rango bruto
hasta 10^30
Delegadores
paginación por cursor
- Telemetría v2. Los nodos V29 informarán de los percentiles de latencia de confirmación (p50, p90, p99), su motor de base de datos y su estado de bootstrap. La supervisión de nodos pasa de la adivinanza a los paneles: detecta un nodo infradimensionado por su curva de latencia antes de que los usuarios lo noten.
- Paginación indexada de delegadores. Las listas de delegadores podrán obtenerse con cursores de continuación reales en lugar de volcar miles de entradas de golpe. Para cualquier servicio que muestre páginas de representantes, es la diferencia entre escalar y quedarse atascado.
- Consultas de representantes más inteligentes. Un parámetro de umbral de peso (
threshold) permite filtrar los representantes pequeños al sondear. Menos ruido, menos viajes de ida y vuelta. - Números más seguros. Los importes brutos de Nano llegan a 10^30, muy por encima del rango de enteros seguros de JavaScript. El nuevo
UInt64Stringvalida cadenas decimales en todo el rango sin signo de 64 bits, corrigiendo esa clase de error de desbordamiento que corrompe silenciosamente las estadísticas por encima de los 9 billardos.
A quién le importa ya
Es una beta dirigida a un nodo aún no publicado, así que el orden importa:
El orden de las cosas
- 01
Quedarse
Los servicios en producción se quedan en 1.x y V28.2 hasta que V29 salga y se estabilice.
- 02
Probar
Levantar un entorno de desarrollo contra una versión de desarrollo de V29 y ejercitar las nuevas rutas de paginación y telemetría.
- 03
Reportar
Abrir issues mientras los mantenedores están más receptivos. Un feedback temprano en la beta vale diez quejas después de una versión estable.
Una beta que llega antes que el nodo le da ventaja a todo el ecosistema.
El ecosistema de herramientas de Nano llevaba años disperso: pequeños helpers, bibliotecas a medio mantener, esquemas que se alejan de lo que los nodos devuelven realmente. Un SDK tipado que trata la compatibilidad de nodos como un contrato de primera clase es lo que acaba con eso. La v2 es una beta para una versión de nodo que aún no existe, pero una beta en la dirección correcta.
La versión está firmada por Exxenoz.
SDK for the Nano cryptocurrency with typed and runtime-validated RPC and WebSocket APIs, a built-in WebSocket client, safe amount arithmetic, and cryptographic utilities.
Pruébala contra una versión de desarrollo de V29 y reporta lo que se rompa.