Nodo completo Zebra
TL;DR
- Zebra (
zebrad) es el nodo completo de Zcash escrito en Rust y mantenido por la Zcash Foundation.
- Valida bloques y transacciones, mantiene el estado de la cadena y se comunica con otros nodos a través de la red peer-to-peer.
- Zebra y zcashd implementaban el mismo protocolo y podían interoperar. Desde la retirada de zcashd, Zebra desempeña la función de consenso.
- Dos formas de ejecutarlo: la imagen Docker de
zfnd/zebra o una compilación desde el código fuente.
- El hardware recomendado es de 4 núcleos de CPU, 16 GB de RAM y 300 GB de disco. El mínimo es de 2 núcleos y 4 GB de RAM, con los mismos 300 GB de disco.
Explicación básica
Zebra es el primer nodo de Zcash escrito íntegramente en Rust. Se encuentra en la red peer-to-peer de Zcash, donde valida y retransmite transacciones y mantiene el estado de la blockchain. Contar con una segunda implementación independiente hace que la infraestructura de red dependa menos de una única base de código.
Zebra y zcashd
El nodo original de Zcash, zcashd, fue desarrollado por la Electric Coin Company a partir de la base de código de Bitcoin. Zebra se escribió desde cero en Rust, un lenguaje seguro para la memoria, con énfasis en la seguridad y la eficiencia.
Ambas implementaciones siguen el mismo protocolo, por lo que podían comunicarse e interoperar. zcashd alcanzó su detención de fin de soporte el 18 de julio de 2026 y ya no se inicia, lo que deja a Zebra y Zakura como las implementaciones de nodos en uso. Consulta Nodos completos para tener una visión más amplia.
Ejecución de Zebra
Puedes ejecutar Zebra mediante la imagen Docker o compilarlo manualmente. Consulta la sección Requisitos del sistema.
Uso de Docker
Para ejecutar la versión más reciente y sincronizarla hasta la punta, ejecuta el siguiente comando:
Code-highlight
docker run zfnd/zebra:latest
Para obtener instrucciones completas, consulta la documentación de Docker.
Compilación de Zebra
La compilación de Zebra requiere Rust, libclang y un compilador de C++.
- Asegúrate de tener instalada la versión estable más reciente de Rust, ya que Zebra se prueba exclusivamente con ella.
- Las dependencias de compilación necesarias incluyen:
- libclang (también conocido como libclang-dev o llvm-dev)
- clang u otro compilador de C++ (como g++ para todas las plataformas o Xcode para macOS)
- protoc (compilador de Protocol Buffers) con la opción --experimental_allow_proto3_optional, introducida en Protocol Buffers v3.12.0 (publicada el 16 de mayo de 2020).
Instalar e iniciar
En Linux x86_64 o aarch64 con glibc 2.34 o posterior (Ubuntu 22.04+, Debian 12+, RHEL 9+, Amazon Linux 2023), puedes omitir las dependencias de compilación e instalar un binario precompilado firmado:
Code-highlight
cargo binstall zebrad
Los mismos binarios se adjuntan a cada versión de GitHub como zebrad-<version>-<target>.tar.gz, cada uno con una suma de comprobación SHA-256, una certificación Sigstore de procedencia de compilación y una firma Cosign. En plataformas más antiguas, usa la imagen Docker o compila desde el código fuente.
Para compilar desde el código fuente, obtén el código y compila el binario de lanzamiento:
Code-highlight
git clone https://github.com/ZcashFoundation/zebra.git
cd zebra
cargo build --release --bin zebrad
Inicia el nodo con:
Code-highlight
target/release/zebrad start
Guía de instalación: zebra.zfnd.org/user/install.html
Configuraciones y funciones opcionales
Inicialización del archivo de configuración
- Genera un archivo de configuración mediante el comando:
Code-highlight
zebrad generate -o ~/.config/zebrad.toml
- El zebrad.toml generado se colocará en el directorio predeterminado de preferencias de Linux. Para conocer las ubicaciones predeterminadas alternativas en otros sistemas operativos, consulta la documentación.
Configuración de barras de progreso
- Configura tracing.progress_bar en tu zebrad.toml para mostrar métricas clave en la terminal mediante barras de progreso. Nota: existe un problema conocido por el que las estimaciones de las barras de progreso pueden llegar a ser excesivamente grandes.
Configuración de minería
Funciones de compilación personalizadas
-
Amplía la funcionalidad de Zebra con funciones adicionales de Cargo, como métricas de Prometheus, monitorización de Sentry, soporte experimental para Elasticsearch y más.
-
Combina varias funciones enumerándolas como parámetros de la opción --features durante la instalación.
-
Algunas funciones de depuración y monitorización están desactivadas en las compilaciones de lanzamiento para optimizar el rendimiento. Para consultar la lista completa de funciones experimentales y para desarrolladores, consulta la documentación de la API.
Requisitos del sistema y configuración de red
Requisitos recomendados
- CPU: 4 núcleos de CPU
- RAM: 16 GB
- Espacio en disco: 300 GB de espacio disponible para compilar binarios y almacenar el estado de la cadena en caché
- Red: conexión de red de 100 Mbps con un mínimo de 300 GB de cargas y descargas al mes
Requisitos mínimos
- CPU: 2 núcleos de CPU
- RAM: 4 GB
- Espacio en disco: 300 GB de espacio disponible en disco
La suite de pruebas de Zebra puede tardar más de una hora en completarse, según las especificaciones de tu equipo. Los sistemas más lentos pueden compilar y ejecutar Zebra. Los límites precisos de rendimiento no se han establecido mediante pruebas.
Requisitos de disco
- Zebra utiliza aproximadamente 300 GB para los datos de Mainnet en caché y 10 GB para los datos de Testnet en caché. Espera que el uso de disco aumente con el tiempo.
- La base de datos se limpia periódicamente, así como al apagarse o reiniciarse. Los cambios se confirman mediante transacciones de base de datos. Los cambios incompletos causados por una finalización forzada o un panic se revierten la próxima vez que se inicia Zebra.
Requisitos de red y puertos
- Zebra utiliza los siguientes puertos TCP para conexiones entrantes y salientes:
- 8233 para Mainnet
- 18233 para Testnet
- Configurar Zebra con una listen_addr específica anuncia esta dirección para conexiones entrantes. Las conexiones salientes son necesarias para la sincronización; las conexiones entrantes son opcionales.
- Es necesario acceder a los seeders DNS de Zcash mediante el resolvedor DNS del sistema operativo (normalmente el puerto 53).
- Zebra puede realizar conexiones salientes en cualquier puerto. zcashd prefiere pares en puertos predeterminados para evitar ser utilizado en ataques DDoS contra otras redes.
Uso típico de red de Mainnet
- Sincronización inicial: se requiere una descarga de 300 GB para la sincronización inicial, y se espera que esta cifra crezca.
- Actualizaciones continuas: cargas y descargas diarias de entre 10 MB y 10 GB, según los tamaños de las transacciones de los usuarios y las solicitudes de pares.
- Zebra inicia una sincronización inicial en cada cambio de versión de la base de datos interna, lo que puede implicar una descarga completa de la cadena durante las actualizaciones de versión.
- Se prefieren pares con una latencia de ida y vuelta de 2 segundos o menos. Si la latencia supera este umbral, abre un ticket en el repositorio de Zebra.
Errores comunes
- Dimensionar el disco para las necesidades actuales. El estado de Mainnet en caché ya ronda los 300 GB y sigue creciendo.
- Esperar RPC de wallet de
zebrad. Las claves y los saldos se encuentran en Zallet, un programa independiente.
- Ejecutar
zebrad por sí solo y esperar que se conecten wallets ligeras. Esa vía necesita un indexador, ya sea lightwalletd o Zaino.
- Tratar una resincronización inesperada como un fallo. Un cambio de versión de la base de datos provoca una por diseño.
Páginas relacionadas
