RPC-Endpunkte einrichten
Die App hat kein Backend. Sie fragt die Netzwerke direkt ab — deshalb braucht jedes Netzwerk eine Datenquelle: entweder eine offizielle öffentliche API oder die RPC-Adresse eines Nodes, den Sie bereitstellen. Diese Seite zeigt, wie man eine einrichtet und was zu tun ist, wenn sie nicht antwortet.
Endpunkt eintragen
- Einstellungen (⚙ oben auf dem Startbildschirm) → Netzwerke.
- Netzwerk auswählen. Der Untertitel nennt bereits die verwendete Quelle — oder dass es nicht eingerichtet ist.
- RPC-Node einrichten / Endpunkt ändern antippen und die URL eingeben. Sie muss
mit
http://oderhttps://beginnen. - Verlangt der Node eine Authentifizierung, tragen Sie Benutzername und Passwort im selben Dialog ein.
- Verbindung testen antippen: Die App holt die Blockhöhe und zeigt entweder OK oder den genauen Fehler.
- Zurücksetzen stellt den Standard wieder her: die offizielle URL bei Netzwerken, die eine haben, ein leeres Feld bei den übrigen.
Wo die Zugangsdaten liegen
RPC-Benutzername und -Passwort werden in den Android Keystore / iOS Keychain geschrieben, mit einem Eintrag pro Netzwerk. Sie erscheinen nie in den Einstellungen, nie in der Sicherungsdatei, nie in Protokollen und nie im App-Bundle.
- Das Passwort wird nie erneut angezeigt. Den Dialog erneut zu öffnen und das Feld leer zu lassen behält die gespeicherten Zugangsdaten.
- Zugangsdaten löschen entfernt sie aus dem sicheren Speicher.
- Eine exportierte Sicherung enthält nur die RPC-URLs — nie ein Passwort, nie einen Benutzernamen.
Eigenen Node betreiben
Diese Netzwerke sind Bitcoin- oder Dash-Forks: Das RPC wird in der Konfigurationsdatei des Daemons eingerichtet. Die nötigen Schlüssel sind überall dieselben.
server=1
rpcuser=<Benutzername>
rpcpassword=<langes zufälliges Passwort>
rpcbind=0.0.0.0 # im Netz lauschen, nicht nur auf localhost
rpcallowip=<vertrauenswürdige-IP>/32 # einschränken, wer das RPC aufrufen darf
# rpcport=... # Standard des Netzwerks belassen, sofern nicht nötig
Daemon, Konfigurationsdatei, Standardport und die von der App aufgerufene Methode, je Netzwerk:
| Netzwerk | Daemon | Konfigurationsdatei | Standard-RPC-Port | Abgefragte Methode |
|---|---|---|---|---|
| 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 |
Die in dieser Tabelle fehlenden Netzwerke — Cosanta, Neoxa und Flux — werden über einen öffentlichen Explorer oder eine API gelesen, nicht über einen RPC-Node. Für sie ist kein RPC-Port zu öffnen; Sie ändern immer nur eine URL.
HTTPS und Reverse Proxy
Ein Daemon spricht unverschlüsseltes HTTP, und die App akzeptiert das in allen vierzehn Netzwerken: Kein Masternode-Daemon liefert TLS, und der überwachte Node ist oft nur im lokalen Netz erreichbar, wo ein öffentlich vertrauenswürdiges Zertifikat keinen Sinn ergibt. Über HTTP läuft allerdings alles im Klartext — die Antworten des Daemons und vor allem das RPC-Passwort, falls vorhanden. Sobald die Verbindung nicht vertrauenswürdig ist, stellen Sie einen TLS-Reverse-Proxy vor das RPC — Caddy, Nginx oder Traefik — und geben der App die URL des Proxys. Mit Caddy sind das zwei Zeilen, und das Zertifikat kommt automatisch:
rpc.beispiel.de {
reverse_proxy 127.0.0.1:9998
}
Die Basic-Authentifizierung kann statt vom Daemon auch vom Proxy übernommen werden. In beiden Fällen überträgt die App die Zugangsdaten über TLS, nie im Klartext.
http:// verwendet, und eine Meldung in dem
Moment, in dem Sie eine solche speichern. Nutzen Sie Klartext nur über eine vertrauenswürdige
Verbindung — lokales Netz, VPN oder SSH-Tunnel. Bei Beldex haben Sie als Einzigem keine Wahl:
Seine öffentliche API existiert nur über unverschlüsseltes HTTP.
Besonderheiten je Netzwerk
Netzwerke, die sofort funktionieren
Beldex, Firo, Cosanta und Neoxa bringen eine offizielle öffentliche Quelle mit und brauchen keinerlei Einrichtung. Zwei Dinge sind trotzdem gut zu wissen:
- Beldex ist das einzige Netzwerk, in dem Sie mehrere Endpunkte stapeln können. Sie werden der Reihe nach versucht — eine zweite URL ist damit ein automatisches Failover.
- Firo bietet zwei Modi. Der öffentliche Explorer funktioniert sofort, gibt aber den
numerischen PoSe-Wert nicht aus: Ein bestrafter Node wirkt gesund, bis er gesperrt wird. Ihr
eigener
firodgibt ihn aus — und fällt auf den öffentlichen Explorer zurück, wenn Ihr Node ausfällt.
Netzwerke, die Ihren eigenen Node verlangen
PIVX, Dash, Syscoin, Divi, Raptoreum, SmartCash, SwiftCash, BitCore, Flux und Terracoin starten nicht eingerichtet. Das ist Absicht, kein Versäumnis — und es gibt zwei verschiedene Gründe. Bei den ersten acht gibt es keinen offiziellen öffentlichen Endpunkt, der die Masternode-Liste ausgibt, und wir lassen das Feld lieber leer, als Ihren Datenverkehr über ein kommerzielles Gateway zu leiten, das Sie nie ausgewählt haben. Flux und Terracoin sind der andere Fall: Eine offizielle Quelle existiert und antwortet einwandfrei, aber ihr Betreiber erlaubt einer App die Abfrage nicht — beide wurden am 2026-08-25 aus den Voreinstellungen entfernt.
- Die Authentifizierung ist überall erforderlich, außer bei PIVX, wo sie optional ist:
Ein öffentlicher Node verlangt sie vielleicht nicht, Ihr eigener
pivxdschon. - Gateways mit API-Schlüssel (NOWNodes, GetBlock und ähnliche) funktionieren
nicht: Die App sendet keinen
api-key-Header. Schlüssellose öffentliche Gateways können passen, sofern sie die Listenmethoden erlauben — viele bedienen nur Blockabfragen. - Ihre Explorer sind ausgefallen oder bewusst geschlossen. Kennen Sie einen vertrauenswürdigen öffentlichen Endpunkt, fügen Sie ihn einfach ein.
- Flux braucht keine Zugangsdaten — die API ist öffentlich und nur lesend — und jeder
FluxNode liefert dieselbe API auf Port 16127, über reines HTTP: Geben Sie
http://ihre-ip:16127ein. Die beiden Nachbarports sind Sackgassen — 16126 ist die Weboberfläche, 16128 dieselbe API hinter einem selbstsignierten Zertifikat, das das Telefon ablehnt.
Ein Netzwerk mit Warnhinweis
Sicherheit
- Setzen Sie nie ein unauthentifiziertes RPC ins offene Internet. Ein offenes RPC ist
ein Node — mitunter eine Wallet — auf Gedeih und Verderb dessen, der ihn findet. Nutzen Sie
rpcallowip, eine Firewall, ein VPN oder einen authentifizierten Reverse Proxy. - Verwenden Sie ein langes Zufallspasswort. Das RPC ist eine Maschinenschnittstelle; niemand muss es zweimal tippen.
- Geben Sie nie einen privaten Schlüssel im Feld zum Hinzufügen eines Nodes ein. Überwachung braucht nur öffentliche Daten. In mehreren Netzwerken weist die App einen privaten Schlüssel allein anhand des Formats zurück, bevor irgendeine Anfrage das Gerät verlässt.
- Zugangsdaten bleiben auf dem Gerät, im Schlüsselspeicher des Systems — nie in den Einstellungen, nie in einer Sicherung, nie in einem Protokoll.
Fehlersuche
| Symptom | Wahrscheinliche Ursache | Abhilfe |
|---|---|---|
| Netzwerk direkt nach der Einrichtung offline | URL vom Smartphone aus nicht erreichbar, falscher Port, oder der Daemon synchronisiert noch. | Verbindung testen nutzen: Es nennt den genauen Fehler. Port mit der Tabelle oben abgleichen. |
401 Unauthorized |
Falsche rpcuser/rpcpassword. |
Beide im Dialog neu eingeben. Ein leeres Passwortfeld behält das alte — im Zweifel zuerst die Zugangsdaten löschen. |
403 Forbidden |
Ein öffentlicher Node oder ein Proxy filtert die Anfrage. | Manche öffentlichen RPCs lehnen Anfragen ohne User-Agent ab; die App sendet
einen, ein zwischengeschalteter Proxy kann ihn entfernen. |
| Verbindung abgelehnt / Zeitüberschreitung | rpcbind noch auf localhost, rpcallowip zu eng, oder eine
Firewall. |
rpcbind=0.0.0.0 setzen, eigene Adresse erlauben, Port öffnen. |
| TLS-/Zertifikatsfehler | Selbstsigniertes Zertifikat am Reverse Proxy. | Zertifikat einer anerkannten Stelle verwenden — Caddy besorgt es automatisch. |
Method not found (-32601) |
Der Daemon ist älter als der von der App aufgerufene Befehl. | Daemon aktualisieren. Bei Syscoin 4.1.x heißt der Befehl etwa
masternodelist statt masternode_list. |
| Ein Node steht auf „abgemeldet“ | Er fehlt tatsächlich in der Liste des Netzwerks. | Kennung prüfen und ob das Collateral ausgegeben wurde. Ein Quellenausfall erzeugt diesen Zustand nie. |
Immer noch festgefahren? Schicken Sie uns das Netzwerk, den genauen Fehler aus Verbindung testen und die Daemon-Version — siehe Support. Senden Sie niemals Zugangsdaten.