Configurar los endpoints RPC
La aplicación no tiene backend. Consulta las redes directamente, así que cada red necesita una fuente de datos: o una API pública oficial, o la dirección RPC de un nodo que tú indiques. Esta página explica cómo configurarla y qué hacer cuando no responde.
Indicar un endpoint
- Ajustes (⚙ en la parte superior del inicio) → Redes.
- Elige la red. Su subtítulo ya indica la fuente que usa, o que no está configurada.
- Pulsa Configurar el nodo RPC / Cambiar endpoint e introduce la URL. Debe
empezar por
http://ohttps://. - Si el nodo exige autenticación, rellena el usuario y la contraseña en el mismo diálogo.
- Pulsa Probar la conexión: la aplicación recupera la altura de la cadena y muestra «OK» o el error exacto.
- Restablecer vuelve al valor por defecto: la URL oficial en las redes que la tienen, el campo vacío en las demás.
Dónde viven las credenciales
El usuario y la contraseña RPC se escriben en el Keystore de Android / Llavero de iOS, con una entrada por red. Nunca aparecen en los ajustes, ni en el archivo de copia de seguridad, ni en los registros, ni en el paquete de la aplicación.
- La contraseña no se vuelve a mostrar. Reabrir el diálogo y dejar el campo vacío conserva las credenciales guardadas.
- Borrar las credenciales las elimina del almacén seguro.
- Una copia de seguridad exportada contiene solo las URL RPC: nunca una contraseña, nunca un usuario.
Montar tu propio nodo
Estas redes son forks de Bitcoin o de Dash: el RPC se configura en el archivo de configuración del demonio. Las claves útiles son las mismas en todas partes.
server=1
rpcuser=<usuario>
rpcpassword=<contraseña larga y aleatoria>
rpcbind=0.0.0.0 # escuchar en la red, no solo en localhost
rpcallowip=<ip-de-confianza>/32 # restringir quién puede llamar al RPC
# rpcport=... # deja el valor por defecto salvo necesidad
Demonio, archivo de configuración, puerto por defecto y método que llama la aplicación, red por red:
| Red | Demonio | Archivo de configuración | Puerto RPC por defecto | Método consultado |
|---|---|---|---|---|
| Beldex | beldexd |
beldex.conf |
29095 | get_master_nodes |
| Firo | firod |
firo.conf |
8888 | Insight REST · protx |
| PIVX | pivxd |
pivx.conf |
51473 | listmasternodes |
| Dash | dashd |
dash.conf |
9998 | protx · masternodelist |
| Syscoin | syscoind |
syscoin.conf |
8370 | protx_list |
| Divi | divid |
divi.conf |
51473 | listmasternodes |
| Terracoin | terracoind |
terracoin.conf |
13332 | masternodelist full |
| Raptoreum | raptoreumd |
raptoreum.conf |
10226 | protx |
| SmartCash | smartcashd |
smartcash.conf |
9679 | smartnodelist full |
| SwiftCash | swiftcashd |
swiftcash.conf |
8543 | listswiftnodes |
| BitCore | bitcored |
bitcore.conf |
9469 | masternodelist full |
Las redes ausentes de esta tabla —Cosanta, Neoxa y Flux— se leen a través de un explorador o una API pública, no de un nodo RPC. No hay ningún puerto RPC que abrir para ellas: solo cambias una URL.
HTTPS y proxy inverso
Un demonio expone HTTP en claro, y la aplicación lo acepta en las catorce redes: ningún demonio de masternode sirve TLS, y el nodo que vigilas suele ser accesible solo en tu red local, donde un certificado públicamente reconocido no tiene sentido. Por HTTP, eso sí, todo circula en claro: las respuestas del demonio y, sobre todo, la contraseña RPC si la hay. En cuanto el enlace no sea de confianza, pon un proxy inverso TLS delante del RPC —Caddy, Nginx o Traefik— y dale a la aplicación la URL del proxy. Con Caddy son dos líneas y el certificado es automático:
rpc.ejemplo.com {
reverse_proxy 127.0.0.1:9998
}
También puedes hacer que la autenticación Basic la lleve el proxy en lugar del demonio. En ambos casos, la aplicación envía las credenciales por TLS, nunca en claro.
http://, y una alerta en el momento de
guardarla. Reserva el claro para un enlace de confianza: red local, VPN o túnel SSH. Beldex es
la única red donde no tienes elección: su API pública solo existe en HTTP sin cifrar.
Particularidades por red
Redes que funcionan de inmediato
Beldex, Firo, Cosanta y Neoxa vienen con una fuente pública oficial y no requieren configuración alguna. Aun así, conviene saber dos cosas:
- Beldex es la única red donde puedes apilar varios endpoints. Se prueban en orden, así que una segunda URL es un failover automático.
- Firo ofrece dos modos. El explorador público funciona de inmediato, pero no expone la
puntuación PoSe numérica: un nodo penalizado parece sano hasta que lo expulsan. Tu propio
firodsí la expone, y recurre al explorador público si tu nodo cae.
Redes que exigen tu propio nodo
PIVX, Dash, Syscoin, Divi, Raptoreum, SmartCash, SwiftCash, BitCore, Flux y Terracoin arrancan sin configurar. Es una decisión deliberada, no un olvido, y hay dos motivos distintos. En las ocho primeras no existe ningún endpoint público oficial que exponga su lista de masternodes, y preferimos dejar el campo vacío antes que encaminar tu tráfico por una pasarela comercial que nunca elegiste. Flux y Terracoin son el otro caso: existe una fuente oficial que responde perfectamente, pero su operador no autoriza que una app la consulte; ambas se retiraron de los valores por defecto el 2026-08-25.
- La autenticación es obligatoria en todas menos en PIVX, donde es opcional: un nodo
público puede no pedirla, tu
pivxdpropio sí. - Las pasarelas con clave de API (NOWNodes, GetBlock y similares) no
funcionarán: la aplicación no envía ninguna cabecera
api-key. Las pasarelas públicas sin clave pueden servir, siempre que permitan los métodos de listado de masternodes; muchas solo sirven consultas de bloques. - Sus exploradores están caídos o cerrados a propósito. Si conoces un endpoint público de confianza, basta con pegarlo.
- Flux no necesita credenciales — su API es pública y de solo lectura — y cada FluxNode
sirve esa misma API en el puerto 16127, en HTTP sin cifrar: introduce
http://tu-ip:16127. Los dos puertos vecinos son callejones sin salida: el 16126 es la interfaz web y el 16128 la misma API tras un certificado autofirmado que el teléfono rechaza.
Una red que merece un aviso
Seguridad
- No expongas nunca un RPC sin autenticación a internet. Un RPC abierto es un nodo —y a
veces un monedero— a merced de quien lo encuentre. Usa
rpcallowip, un cortafuegos, una VPN o un proxy inverso autenticado. - Usa una contraseña larga y aleatoria. El RPC es una interfaz para máquinas: nadie tiene que teclearla dos veces.
- No introduzcas nunca una clave privada en el campo de añadir nodo. La supervisión solo necesita datos públicos. En varias redes la aplicación rechaza una clave privada por su formato, antes de que ninguna petición salga del dispositivo.
- Las credenciales se quedan en el dispositivo, en el almacén seguro del sistema: nunca en los ajustes, nunca en una copia de seguridad, nunca en un registro.
Resolución de problemas
| Síntoma | Causa probable | Solución |
|---|---|---|
| La red aparece fuera de línea justo tras configurarla | URL inalcanzable desde el móvil, puerto equivocado o demonio aún sincronizando. | Usa Probar la conexión: indica el error exacto. Compara el puerto con la tabla de arriba. |
401 Unauthorized |
rpcuser / rpcpassword incorrectos. |
Vuelve a introducir ambos. Dejar la contraseña vacía conserva la anterior: en caso de duda, borra antes las credenciales. |
403 Forbidden |
Un nodo público o un proxy filtrando la petición. | Algunos RPC públicos rechazan las peticiones sin User-Agent; la aplicación
envía uno, pero un proxy intermedio puede quitarlo. |
| Conexión rechazada / tiempo agotado | rpcbind aún en localhost, rpcallowip demasiado estricto o un
cortafuegos. |
Pon rpcbind=0.0.0.0, autoriza tu dirección, abre el puerto. |
| Error de TLS o de certificado | Certificado autofirmado en el proxy inverso. | Usa un certificado de una autoridad reconocida: Caddy lo obtiene automáticamente. |
Method not found (-32601) |
El demonio es anterior al comando que llama la aplicación. | Actualiza el demonio. En Syscoin 4.1.x, por ejemplo, el comando se llama
masternodelist y no masternode_list. |
| Un nodo aparece como «dado de baja» | Realmente no está en la lista de la red. | Comprueba el identificador y que el colateral no se haya gastado. Una caída de la fuente nunca produce este estado. |
¿Sigues atascado? Envíanos la red, el error exacto que muestra Probar la conexión y la versión del demonio: consulta soporte. No envíes nunca credenciales.