Versión final publicada · los parámetros de consenso se congelaron el 14 de julio y forman parte de la versión de mainnet publicada
← Volver a brisvia.com

Sumate a la red

Correr un nodo Brisvia

Un nodo valida la cadena por sí mismo y ayuda a que la red siga siendo descentralizada. No necesitás minar, y correr un nodo no genera BRVA — es la forma de verificar Brisvia de manera independiente y mantenerla sana. Estas son las maneras de correr uno, de la más fácil a la más avanzada.

Qué hace un nodo

Un nodo completo descarga y verifica por su cuenta cada bloque y transacción contra las reglas del consenso, y los retransmite a otros nodos. Algunas distinciones rápidas:

Nodo completovalida toda la cadena por vos
Nodo públicoun nodo completo que además acepta conexiones entrantes
Minerohace trabajo RandomX para encontrar bloques
Poolcoordina el trabajo entre mineros

Correr un nodo no genera BRVA por sí solo. El nodo en sí no necesita ninguna dirección de cobro, clave privada ni frase de recuperación — Brisvia Desktop maneja su billetera por separado.

La forma más fácil — Brisvia Desktop

La aplicación de escritorio incluye un nodo completo, una billetera y un minero en un solo programa. Para la mayoría de la gente, con esto alcanza.

1. Descargásolo desde brisvia.com/downloads
2. Verificácomprobá el SHA-256 (y la firma en Windows)
3. Instalá y abrídejá que el nodo interno arranque y sincronice
4. Mantenelo abiertomientras esté abierto y sincronizado, funciona como un nodo completo que valida

Correr Brisvia Desktop te da un nodo completo que valida. Solo se vuelve un nodo accesible públicamente si el puerto TCP 9342 puede llegar a tu computadora desde internet — muchas conexiones hogareñas están detrás de un router, firewall o CGNAT y no aceptan conexiones entrantes por defecto.

Avanzado — compilar y correr Brisvia Core

Para operadores y desarrolladores que quieren un nodo independiente. Brisvia Core es un fork de Bitcoin Core v30.2; la pieza extra es RandomX. Todavía no hay un binario ya compilado, así que se compila desde el código. Las guías de compilación por plataforma están en el repositorio.

1 · Clonar con submódulos (RandomX es un submódulo fijado)

git clone --recursive https://github.com/brisvia/brisvia.git cd brisvia

2 · Compilar RandomX y luego Brisvia Core

cmake -S src/randomx -B src/randomx/build -DARCH=native cmake --build src/randomx/build -j"$(nproc)" cmake -B build cmake --build build -j"$(nproc)"

`-DARCH=native` optimiza RandomX para esta máquina — ideal para correr acá, pero el binario resultante puede no funcionar en otros procesadores.

3 · Un archivo de configuración mínimo (se llama bitcoin.conf, en tu carpeta de datos)

server=1 listen=1 port=9342 rpcport=9338 rpcbind=127.0.0.1

No hace falta rpcuser/rpcpassword para uso local — bitcoin-cli usa la cookie de RPC que se crea dentro de la carpeta de datos.

4 · Arrancar el nodo

./build/bin/bitcoind -chain=brisvia -datadir="$HOME/brisvia-mainnet" -daemon

5 · Detenerlo correctamente (dejá que cierre sus bases — no lo mates)

./build/bin/bitcoin-cli -chain=brisvia -datadir="$HOME/brisvia-mainnet" stop

Verificá que está sincronizando

./build/bin/bitcoin-cli -chain=brisvia -datadir="$HOME/brisvia-mainnet" getblockchaininfo
chaintiene que ser brisvia
blocksaltura validada (debe subir)
initialblockdownloadpasa a false cuando termina de sincronizar
verificationprogressse acerca a 1

Mirá los peers con getconnectioncount (o getpeerinfo para el detalle). El nodo encuentra peers solo, a través de los nodos semilla fijos que trae el programa.

Hacé tu nodo público (opcional, ayuda a la red)

Un nodo que valida no necesita esto — pero aceptar conexiones entrantes en el puerto TCP 9342 te permite ayudar a otros nodos. Necesitás dos cosas:

Firewall de la computadorapermitir entrada TCP 9342 (UFW: sudo ufw allow 9342/tcp; firewalld / Firewall de Windows tienen su forma)
Router del hogarredirigir TCP 9342 a la IP local de tu PC. No redirijas el 9338.

Probá desde otra red (no tu propia red local). Sos público recién cuando getpeerinfo muestra peers entrantes. Que escuche localmente, que tenga conexiones salientes, o que el firewall de la PC esté abierto no lo demuestran — el router, el CGNAT, tu proveedor, una IP pública cambiante o un firewall IPv6 aparte pueden seguir bloqueándolo.

Seguridad

Nunca expongas el puerto RPC (9338) a internetni siquiera con contraseña — no está hecho para tráfico público
No confundas los puertos9342 = P2P (red), 9338 = RPC (control local)
Mantené el RPC en localhostrpcbind=127.0.0.1, autenticación por cookie
Correr un nodo nunca necesita tu semillano hace falta dirección ni las 12 palabras

Problemas comunes

¿Cero peers? Esperá unos minutos; confirmá networkactive=true en getnetworkinfo; revisá el reloj del sistema; confirmá que corrés con -chain=brisvia y no con una carpeta de testnet; mirá debug.log. Usá addnode solo como diagnóstico temporal — el programa ya trae nodos semilla fijos.

¿No entran conexiones? Revisá listen=1, el firewall, el reenvío de puertos, el CGNAT, tu IP pública, y IPv4 vs IPv6.

¿El RPC no responde? Mismo -chain y -datadir, el proceso está corriendo, existe la cookie, y usás el puerto local 9338. No lo abras a internet.

¿Cadena equivocada? Mainnet es chain=brisvia, P2P 9342, RPC 9338, génesis aa6bc268…af7baf7. Los parámetros completos en la página de Integración.

Más