malbeclabs · juan-malbeclabs · Jun 9, 2026 · Jun 9, 2026 · Jun 9, 2026 · Jun 9, 2026
diff --git a/.DS_Store b/.DS_Store
diff --git a/.gitignore b/.gitignore
@@ -17,3 +17,9 @@ dist/
 .devcontainer/
 smartcontract/.vscode/settings.json
 site/
+
+.DS_Store
+**/.DS_Store
+
+__pycache__/
+**/__pycache__/
diff --git a/docs/DZ Mainnet-beta Connection.md b/docs/DZ Mainnet-beta Connection.md
@@ -1,3 +1,7 @@
+---
+description: Connect a Solana Mainnet-Beta validator and up to three backups to DoubleZero in IBRL mode, including identity proof and the connection request.
+---
+
 # Validator Mainnet-Beta Connection in IBRL Mode
 !!! warning "By connecting to DoubleZero I agree to the [DoubleZero Terms of Service](https://doublezero.xyz/terms-protocol)"
 

diff --git a/docs/DZ Testnet Connection.md b/docs/DZ Testnet Connection.md
@@ -1,3 +1,7 @@
+---
+description: Connect a Solana Testnet validator to DoubleZero in IBRL mode, including the testnet evaluation agreement and connection steps.
+---
+
 # Validator Testnet Connection in IBRL Mode
 ??? warning "By connecting to DoubleZero testnet I agree to the terms of the Evaluation Agreement set forth here (click to expand)"
     <span style="font-size:14px;">DoubleZero Testnet</span>

diff --git a/docs/Edge Subscriber Connection.md b/docs/Edge Subscriber Connection.md
@@ -1,3 +1,7 @@
+---
+description: Set up an edge subscriber to receive DoubleZero shred feeds, including client setup and firewall rules for GRE, BGP, PIM, and shred traffic.
+---
+
 # Edge Subscriber Connection
 !!! warning "By connecting to DoubleZero I agree to the [DoubleZero Terms of Use](https://doublezero.xyz/terms-protocol). Please note that the data is for your internal purposes only and may not be retransmitted (see Section 2(e))."
 

diff --git a/docs/New Tenant.md b/docs/New Tenant.md
@@ -1,3 +1,7 @@
+---
+description: Get in touch to bring a new distributed system or protocol onto the DoubleZero network.
+---
+
 # New Tenant
 
 If you would like your distributed system to leverage the DoubleZero network, we’re happy to assist with any technical questions you may have.

diff --git a/docs/Other Multicast Connection.md b/docs/Other Multicast Connection.md
@@ -1,3 +1,7 @@
+---
+description: Connect to DoubleZero in multicast mode to publish or subscribe to one or more feeds.
+---
+
 # Other Multicast Connection
 !!! warning "By connecting to DoubleZero I agree to the [DoubleZero Terms of Service](https://doublezero.xyz/terms-protocol)"
 

diff --git a/docs/Permissioned Connection.md b/docs/Permissioned Connection.md
@@ -1,3 +1,7 @@
+---
+description: Permissioned onboarding for non-validators and RPCs connecting to DoubleZero Mainnet-Beta and Testnet in IBRL mode.
+---
+
 # Non-Validator Permissioned Connection to DoubleZero in IBRL Mode
 !!! warning "By connecting to DoubleZero I agree to the [DoubleZero Terms of Service](https://doublezero.xyz/terms-protocol)"
 

diff --git a/docs/Shelby Permissioned Connection.md b/docs/Shelby Permissioned Connection.md
@@ -1,3 +1,7 @@
+---
+description: Permissioned connection guide for Shelby Testnet users connecting to DoubleZero in IBRL mode.
+---
+
 # Connection to DoubleZero in IBRL Mode for Shelby Testnet Users
 !!! warning "By connecting to DoubleZero I agree to the [DoubleZero Terms of Service](https://doublezero.xyz/terms-protocol)"
 

diff --git a/docs/Validator Multicast Connection.md b/docs/Validator Multicast Connection.md
@@ -1,3 +1,7 @@
+---
+description: Configure a connected validator to publish leader shreds to the DoubleZero multicast edge feed.
+---
+
 # Validator Multicast Connection
 !!! warning "By connecting to DoubleZero I agree to the [DoubleZero Terms of Service](https://doublezero.xyz/terms-protocol)"
 

diff --git a/docs/Validator Rewards.md b/docs/Validator Rewards.md
@@ -1,3 +1,7 @@
+---
+description: Register and configure validator publisher rewards so validators publishing shreds to DoubleZero Edge are paid each epoch.
+---
+
 # Validator Rewards
 !!! warning "By connecting to DoubleZero, I agree to the [DoubleZero Terms of Use](https://doublezero.xyz/terms-protocol)"
 

diff --git a/docs/architecture.es.md b/docs/architecture.es.md
@@ -1,8 +1,10 @@
-# Arquitectura
-!!! warning "This translation was generated using artificial intelligence and has not been reviewed by a human translator. It may contain inaccuracies or errors and should not be relied upon."
+---
+description: Descripción general de los actores y componentes que conforman la arquitectura de red de DoubleZero.
+---
 
+# Arquitectura
 
-¿Qué compone los diferentes actores y componentes de la red DoubleZero?
+¿Cuáles son los diferentes actores y componentes de la red DoubleZero?
 
 <figure markdown="span">
   ![Image title](images/figure8.png){ width="800" }
@@ -11,40 +13,40 @@
 
 ## Contribuidores
 
-La red DoubleZero está formada por contribuciones de conectividad y procesamiento de paquetes de una creciente comunidad de proveedores de infraestructura de red distribuida en ciudades de todo el mundo. Los contribuidores aportan enlaces de fibra óptica y recursos de procesamiento de información al protocolo para proporcionar la red de malla descentralizada.
+La red DoubleZero está compuesta por contribuciones de conectividad y procesamiento de paquetes provenientes de una comunidad creciente de proveedores de infraestructura de red distribuida en ciudades de todo el mundo. Los contribuidores aportan enlaces de cable de fibra óptica y recursos de procesamiento de información al protocolo para proporcionar la red mesh descentralizada.
 
 ### Contribuidores de Ancho de Banda de Red
 
-Los contribuidores de red deben proporcionar ancho de banda dedicado entre dos puntos, operar dispositivos compatibles con DoubleZero (DZDs) en cada extremo y una conexión a internet en cada extremo. Los contribuidores de red también deben ejecutar el software DoubleZero en cada DZD para proporcionar servicios como multicast, búsqueda de usuarios y servicios de filtrado en el borde.
+Los contribuidores de red deben proporcionar ancho de banda dedicado entre dos puntos, operar dispositivos compatibles con DoubleZero (DZDs) en cada extremo y una conexión a internet en cada extremo. Los contribuidores de red también deben ejecutar el software de DoubleZero en cada DZD para proporcionar servicios como multicast, búsqueda de usuarios y servicios de filtrado en el borde.
 
-Los enlaces físicos de la red DoubleZero se proporcionan en forma de cables de fibra óptica, comúnmente denominados servicios de longitud de onda. Los contribuidores de red comprometen enlaces de red subutilizados, propios o arrendados de proveedores de infraestructura, entre dos o más centros de datos. Estos enlaces se terminan en ambos extremos por Dispositivos DoubleZero, que son recintos físicos de conmutación de red que ejecutan instancias del software Agente DoubleZero.
+Los enlaces físicos de la red DoubleZero se proporcionan en forma de cables de fibra óptica, comúnmente denominados servicios de longitud de onda. Los contribuidores de red comprometen enlaces de red infrautilizados, propios o arrendados a proveedores de infraestructura, entre dos o más centros de datos. Estos enlaces se terminan en ambos extremos mediante DoubleZero Devices, que son gabinetes físicos de conmutación de red que ejecutan instancias del software DoubleZero Agent.
 
 #### DoubleZero Exchange (DZX / Sitio de Interconexión)
 
-Los Exchanges DoubleZero (DZXs) son puntos de interconexión en la red de malla donde se unen diferentes enlaces de contribuidores. Los DZXs están ubicados en las principales áreas metropolitanas del mundo donde se producen intersecciones de red. Los contribuidores de red deben interconectar sus enlaces a la red de malla DoubleZero más amplia en los DZXs geográficamente más cercanos a los extremos de sus enlaces.
+Los DoubleZero Exchanges (DZXs) son puntos de interconexión en la red mesh donde se conectan entre sí los enlaces de diferentes contribuidores. Los DZXs se encuentran ubicados en las principales áreas metropolitanas del mundo donde se producen intersecciones de red. Los contribuidores de red deben interconectar sus enlaces en la red mesh más amplia de DoubleZero en los DZXs geográficamente más cercanos a los puntos finales de sus enlaces.
 
 ### Contribuidores de Recursos Computacionales
 
-Aparte de los contribuidores de red, los contribuidores de recursos son un grupo descentralizado de participantes de la red que realizan diversas tareas de mantenimiento y monitoreo necesarias para sostener la integridad técnica y la funcionalidad continua de la red DoubleZero. Específicamente, ellos (i) rastrean las transacciones y pagos de los usuarios; (ii) calculan las tarifas para los contribuidores de red; (iii) registran los resultados de (i) y (ii); (iv) administran, estrictamente de forma no discrecional, los contratos inteligentes que controlan la tokenómica del protocolo; (v) transmiten attestations a la blockchain aplicable; y (vi) publican datos de telemetría sobre la calidad y utilización de los enlaces para proporcionar métricas de rendimiento transparentes y en tiempo real para todos los contribuidores de red.
+De forma separada a los contribuidores de red, los contribuidores de recursos son un grupo descentralizado de participantes de la red que realizan diversas tareas de mantenimiento y monitoreo necesarias para mantener la integridad técnica y el funcionamiento continuo de la red DoubleZero. Específicamente, ellos (i) rastrean las transacciones y pagos de los usuarios; (ii) calculan las tarifas para los contribuidores de red; (iii) registran los resultados de (i) y (ii); (iv) administran, estrictamente de forma no discrecional, los contratos inteligentes que controlan la tokenomía del protocolo; (v) retransmiten atestaciones a la blockchain correspondiente; y (vi) publican datos de telemetría sobre la calidad y utilización de los enlaces para proporcionar métricas de rendimiento transparentes y en tiempo real para todos los contribuidores de red.
 
 ## Componentes
 
-### Daemon DoubleZero
+### DoubleZero Daemon
 
-El software Daemon DoubleZero se ejecuta en servidores que necesitan comunicarse a través de la red DoubleZero. El daemon interactúa con la pila de red del kernel del host para crear y gestionar interfaces de túnel, tablas de enrutamiento y rutas.
+El software DoubleZero Daemon se ejecuta en servidores que necesitan comunicarse a través de la red DoubleZero. El daemon interactúa con la pila de red del kernel del host para crear y gestionar interfaces de túnel, tablas de enrutamiento y rutas.
 
-### Activador
+### Activator
 
-El servicio Activador, alojado por uno o más miembros contribuidores de recursos computacionales de la comunidad DoubleZero, monitorea los eventos de contrato que requieren asignaciones de direcciones IP y cambios de estado, y gestiona esos cambios en nombre de la red.
+El servicio Activator, alojado por uno o más miembros contribuidores de recursos computacionales de la comunidad DoubleZero, monitorea eventos de contratos que requieren asignaciones de direcciones IP y cambios de estado, y gestiona dichos cambios en nombre de la red.
 
-### Controlador
+### Controller
 
-El servicio Controlador, alojado por uno o más contribuidores de recursos computacionales de la comunidad DoubleZero, sirve como la interfaz de configuración para que los Agentes de Dispositivos DoubleZero representen su configuración actual basada en eventos de contratos inteligentes.
+El servicio Controller, alojado por uno o más contribuidores de recursos computacionales de la comunidad DoubleZero, sirve como la interfaz de configuración para los DoubleZero Device Agents, permitiéndoles renderizar su configuración actual basándose en eventos de contratos inteligentes.
 
-### Agente
+### Agent
 
-El software Agente se ejecuta directamente en los Dispositivos DoubleZero y aplica los cambios de configuración a los dispositivos según lo interpretado por el servicio Controlador. El software Agente consulta al Controlador para detectar cambios de configuración, calcula las diferencias entre la versión canónica on-chain del estado del Dispositivo y la configuración activa en el dispositivo, y aplica los cambios necesarios para reconciliar la configuración activa.
+El software Agent se ejecuta directamente en los DoubleZero Devices y aplica cambios de configuración a los dispositivos según lo interpretado por el servicio Controller. El software Agent consulta al Controller en busca de cambios de configuración, calcula las diferencias entre la versión canónica en cadena del estado del dispositivo y la configuración activa en el dispositivo, y aplica los cambios necesarios para reconciliar la configuración activa.
 
-### Dispositivo
+### Device
 
-El recinto físico del dispositivo que proporciona el enrutamiento y la terminación de enlaces para la red DoubleZero. Los DZDs ejecutan el software Agente DoubleZero y se configuran basándose en los datos leídos del servicio Controlador.
+El gabinete de dispositivo físico que proporciona el enrutamiento y la terminación de enlaces para la red DoubleZero. Los DZDs ejecutan el software DoubleZero Agent y se configuran basándose en los datos leídos del servicio Controller.