ParitrDocs

Was ist Paritr?

Paritr ist eine eigenstaendige Kryptowaehrung nach Bitcoin-Vorbild. Das Netzwerk besteht aus zwei Teilen:

• Full Nodes – unabhaengige Server, die die gesamte Blockchain speichern, alle Regeln pruefen, Transaktionen weiterleiten und per Proof of Work neue Bloecke erzeugen. Jeder kann eine Node betreiben.
• Web-Plattform – dein Wallet im Browser. Der private Schluessel wird lokal erzeugt und verlaesst deinen Browser nie. Die Plattform ist im Hintergrund mit einer Node verbunden, um Guthaben zu lesen und signierte Transaktionen einzureichen.

Funktionsweise der Blockchain

Bloecke und Proof of Work

Jeder Block traegt einen 80 Byte grossen Header aus Version, Hash des Vorgaengers, Merkle-Wurzel aller Transaktionen, Zeitstempel, Schwierigkeit (nBits) und einem Zaehler (Nonce). Die Kennung eines Blocks ist SHA256(SHA256(header)). Der Arbeitsnachweis nutzt dagegen scrypt mit 2 MiB Arbeitsspeicher je Hash (N = 2048, r = 8, p = 1). Gueltig ist ein Block, wenn dieser scrypt-Hash kleiner oder gleich der Zielmarke ist. Miner variieren den Nonce so lange, bis das zutrifft.

Die Speicherbindung ist Absicht: Reines SHA256d laesst sich mit fertiger Spezialhardware (ASICs) millionenfach beschleunigen, die fuer Bitcoin ohnehin existiert. Ein Bruchteil davon wuerde die Schwierigkeit hier so weit anheben, dass normale Rechner chancenlos waeren. scrypt macht die Speicherlatenz zum Flaschenhals statt der Rechenwerke – genau der Ansatz, der ASICs jahrelang von CryptoNight ferngehalten hat.

Kontenmodell

Statt UTXO nutzt Paritr ein Konto-/Nonce-Modell: Jede Adresse hat einen Kontostand und einen fortlaufenden Zaehler. Jede Transaktion traegt die naechste Nonce des Absenders – doppelte oder uebersprungene Nonces werden abgelehnt. Das schuetzt vor Wiedereinreichung (Replay) und erlaubt sehr schlanke Wallets.

Ueber das Netzwerk treffen Transaktionen desselben Absenders aber nicht zwangslaeufig in Reihenfolge ein. Kommt Nonce n+1 vor n an, wird sie deshalb nicht verworfen, sondern kurzzeitig zwischengespeichert und automatisch nachgerueckt, sobald die Luecke geschlossen ist.

Signaturen und Adressen

Signiert wird mit ECDSA auf der Kurve secp256k1. Die Adresse ist Base58Check(0x37 ‖ RIPEMD160(SHA256(pubkey))) und beginnt daher immer mit C. Die Node prueft, dass die Absenderadresse zum mitgelieferten oeffentlichen Schluessel passt.

Konsens und Reorganisation

Nodes vergleichen nicht die Laenge einer Kette, sondern die insgesamt hineingesteckte Arbeit. Eine fremde Kette wird nur uebernommen, wenn sie mehr Arbeit enthaelt und jeder einzelne Block alle Regeln erfuellt. Bei einer Reorganisation wandern Transaktionen verwaister Bloecke zurueck in die Warteschlange (Mempool), Shares zurueck in den Share-Speicher.

Umgestellt wird dabei nur der abweichende Teil: Die Bloecke ab dem Verzweigungspunkt werden rueckabgewickelt, danach wird ausschliesslich der neue Ast geprueft und angewendet. Der Aufwand haengt so von der Tiefe der Reorganisation ab – nicht von der Laenge der gesamten Kette.

Ein zugestellter Block, der nicht direkt an die eigene Spitze passt, wird nicht verworfen, sondern als Seitenast zwischengespeichert. Sobald genug Folgebloecke eintreffen und der Ast mehr Arbeit enthaelt, wird umgeschwenkt. Ohne diesen Schritt koennte eine Node, die selbst keine ausgehenden Verbindungen aufbauen kann, dauerhaft auf ihrer eigenen Gabelung verharren – die Bloecke und Belohnungen der Gegenseite gingen dann verloren.

Wie sich Nodes finden

1. Fest hinterlegte Seed-Nodes im Programmcode.
2. DNS-Seeds: aufgeloeste Adressen werden als Kandidaten genutzt – aber nur fuer Hosts, die nicht ohnehin schon als Seed-URL hinterlegt sind. Sonst entstehen tote Eintraege, weil die A-Records hinter einem Reverse-Proxy oder CDN auf dessen Edge-Adressen zeigen, unter denen der RPC-Port gar nicht offen ist.
3. Gossip: Beim Handshake tauschen Nodes ihre Peer-Listen aus.
4. Rueckweg: Meldet eine Gegenstelle keine oeffentliche Adresse, wird ein Kandidat aus ihrer Absender-IP und dem gemeldeten RPC-Port gebildet und geprueft.
5. Entdopplung: Ist dieselbe Node ueber mehrere Adressen bekannt (Seed-URL, Port-Variante, aufgeloeste IP), wird fuer Relay und Sync nur die beste davon verwendet und weitergegeben.
6. Headers-First-Sync: Erst alle Header pruefen, dann die Bloecke laden.
7. Der Genesis-Block wird auf jeder Node deterministisch identisch berechnet.

Ueber dieselben Verbindungen laufen drei Arten von Nachrichten: Bloecke, Transaktionen und Shares. Alle ausgehenden Aufrufe werden von einer festen Zahl Hintergrund-Worker abgearbeitet. Eine langsame oder boesartige Gegenstelle kann den Node dadurch weder ausbremsen noch ueber unbegrenzt viele Verbindungen ueberlasten.

Emission und Tail-Emission

Jeder neue Block erzeugt frische Coins – die Subvention. Sie startet bei 10 PAR und halbiert sich alle 1.600.000 Blöcke, also etwa alle drei Jahre.

Warum ohne Obergrenze?

Ein Netzwerk mit harter Obergrenze finanziert seine Sicherheit irgendwann ausschliesslich ueber Transaktionsgebuehren. Bleiben die aus, sinkt die Rechenleistung – und mit ihr der Schutz vor Angriffen. Die Tail-Emission loest das: Sie garantiert eine planbare Mindestbelohnung, ohne dass die Geldmenge aus dem Ruder laeuft.

Entscheidend ist naemlich nicht die absolute Menge, sondern die jaehrliche Inflationsrate. Weil die Umlaufmenge waechst, die Neuemission je Jahr aber konstant bleibt, faellt diese Rate dauerhaft gegen null – ohne sie jemals ganz zu erreichen. Den aktuellen Wert zeigt der Endpunkt /supply.

Shares: Bezahlung nach Leistung

Das Problem kleiner Nodes

Bei klassischem Mining bekommt nur die Node etwas, die den Block findet. Eine kleine Node mit 1 % der Rechenleistung findet im Schnitt jeden hundertsten Block – und geht dazwischen leer aus. Genau deshalb schliessen sich Miner ueberall zu zentralen Pools zusammen.

Die Loesung: Shares direkt im Protokoll

Paritr baut den Pool in die Blockchain selbst ein. Beim Schürfen entstehen neben dem seltenen Blocktreffer laufend Shares: gültige Arbeitsnachweise, die ein Hundertstel der Blockschwierigkeit erfüllen. Sie kosten keine zusätzliche Rechenzeit, denn es ist derselbe Hash-Durchlauf – nur mit einer zweiten, leichteren Zielmarke.

1. Die Node findet einen Share und verteilt ihn per Gossip an ihre Peers.
2. Jede Node prüft ihn sofort: Arbeitsnachweis, Elternblock, Dublette.
3. Die nächste Node, die einen Block findet, bindet bis zu 64 gesammelte Shares in ihren Block ein.
4. Alle Shares der letzten 120 Blöcke bilden das Messfenster, nach dem die Belohnung verteilt wird.

Warum niemand fremde Shares unterschlagen kann

Ein Finder könnte versucht sein, fremde Shares einfach wegzulassen, um mehr für sich zu behalten. Das lohnt sich nicht: Liegen keine fremden Shares vor, fällt der gesamte 95 %-Pool ohnehin an den Finder – er hat also keinen Nachteil davon, sie aufzunehmen, wohl aber die garantierten 5 % Inklusions-Anreiz plus alle Gebühren sicher. Gleichzeitig ist die Verteilung für jede Node exakt nachrechenbar: Ein Block mit falscher Coinbase wird schlicht abgelehnt.

Und Shares lassen sich nicht stehlen: Die Auszahlungsadresse steckt über einen Merkle-Nachweis im gehashten Header. Wer sie austauscht, zerstört den Arbeitsnachweis. Bereits bestätigte Shares können zudem kein zweites Mal eingebunden werden.

Mining und Belohnungen

Ablauf

1. Eingereichte Transaktionen sammeln sich im Mempool, eingehende Shares im Share-Speicher der Node.
2. Die Node baut einen Kandidaten-Block: zuerst die zu bestätigenden Shares, daraus der Verteilschlüssel und die Coinbase-Ausgänge, danach die Transaktionen mit der höchsten Gebühr.
3. Der Nonce wird variiert, bis der Header-Hash unter der Zielmarke liegt. Zwischentreffer unter der leichteren Share-Marke werden als Shares veröffentlicht.
4. Der Finder hängt den Block an und verteilt ihn an alle bekannten Peers.

Liegt keine Transaktion vor, entsteht ein leerer Block mit nur den Coinbase-Ausgängen. Das Netzwerk rechnet dadurch ununterbrochen weiter.

Wer bekommt wie viel?

Je Block gibt es höchstens 32 Empfänger; Kleinstbeträge unter 0,00001 PAR sowie Rundungsreste gehen an den Finder. Dadurch entspricht die Summe aller Ausgänge exakt Subvention plus Gebühren – jede Node rechnet das mit reiner Ganzzahlarithmetik nach. Die aggregierten Kennzahlen zeigt der Bereich Mining › Netzwerk & Emission sowie der Endpunkt /mining/distribution.

Reifezeit

Frisch geschürfte Coins sind zunächst gesperrt und erst nach 10 weiteren Blöcken ausgebbar. In der Uebersicht steht bis dahin Ausstehend, danach Verifiziert. Das schützt vor Umkehrungen, falls sich die Kette kurzfristig reorganisiert.

Konsens-Parameter

Diese Werte sind fest im Protokoll verankert und auf jeder Node identisch. Sie lassen sich weder ueber die Konfiguration noch ueber die Weboberflaeche aendern.

Node installieren

Eine Paritr-Node laeuft ueberall dort, wo Python 3.9 oder neuer verfuegbar ist. Getestete Plattformen:

Mindestanforderungen

• Python 3.9 oder neuer
• 2 GB RAM, 2 GB freier Speicher (waechst mit der Kette)
• Dauerhafte Internetverbindung
• Erreichbarer TCP-Port (Standard 5050) – empfohlen, aber nicht zwingend

Alle Dateien im Überblick

Die Installationsskripte laden alles Weitere selbst nach – einzeln brauchst du die Dateien nur für eine manuelle Einrichtung.

Linux: Ubuntu, Debian und ARM

Das Skript funktioniert identisch auf x86_64-Servern und auf ARM-Geraeten (Raspberry Pi 4/5, Oracle Ampere, AWS Graviton, ...). Die Architektur wird automatisch erkannt.

Windows

Unter Windows uebernimmt install.ps1 die Einrichtung. Als Serverprozess kommt waitress zum Einsatz; der Autostart laeuft ueber eine geplante Aufgabe.

Manuelle Installation (macOS, andere Systeme)

Hardware-Auslastung steuern

Wie viel Leistung deine Node fuers Mining einsetzt, ist frei einstellbar – bequem ueber die Regler im Bereich Mining der Web-Plattform oder direkt auf dem Server.

Ueber die Web-Plattform

Mining › Meine Mining-Node › Hardware-Auslastung: Die beiden Regler zeigen live die zu erwartende Gesamtlast an. Aenderungen greifen sofort nach „Einstellungen uebernehmen“ – ein Neustart ist nicht noetig. Voraussetzung ist ein hinterlegter Admin Secret Key.

Auf dem Server

Erreichbarkeit herstellen

Deine Node findet das Netzwerk auch hinter einem Router von allein. Damit andere Nodes sie erreichen und die Web-Plattform sie direkt ansprechen kann, sollte der Port erreichbar sein.

1. Dem Server im Router eine feste lokale IP-Adresse zuweisen.
2. Portweiterleitung einrichten: 5050/TCP auf diese IP.
3. Bei wechselnder oeffentlicher IP einen DynDNS-Namen einrichten und ihn beim Installieren als --public-url angeben.
4. Erreichbarkeit pruefen: curl http://DEINE-ADRESSE:5050/status

Node mit dem Wallet verbinden

Erst durch das Verbinden kannst du deine Node in der Web-Plattform ueberwachen und steuern. Die Verbindung gilt nur fuer dein Konto.

Betrieb und Wartung

Linux

Windows

Konfigurationsdatei

Nach Handaenderungen an config.json den Dienst neu starten. Aenderungen ueber die Web-Plattform oder manage greifen dagegen sofort.

Datensicherung

Sichern musst du nur config.json (enthaelt den Admin Secret Key). Die Blockchain selbst laedt eine neue Node automatisch aus dem Netzwerk. Dein Guthaben liegt in der Blockchain – nicht auf der Node.

Sicherheit

• Privater Schluessel: Wird im Browser erzeugt und nur mit deinem Passwort verschluesselt (AES-256-GCM) gespeichert. Ohne Schluessel und Passwort gibt es keinen Zugriff auf dein Guthaben – und keine Wiederherstellung durch Dritte. Sichere ihn unter Konto › Schluessel sichern.
• Admin Secret Key: Gehoert zur Node, nicht zum Wallet. Er erlaubt keine Ueberweisungen, sondern nur das Steuern der Node.
• Node-Rechte: Der systemd-Dienst laeuft ohne erweiterte Rechte und darf nur in sein eigenes Verzeichnis schreiben.
• CORS: Ueber rpc_cors_origins laesst sich der Zugriff auf die eigene Plattform begrenzen, statt * zu erlauben.
• Server-Proxy: Die Plattform ruft nur freigegebene Endpunkte auf und verweigert Anfragen in private Netze (SSRF-Schutz).

Haeufige Probleme

Schnittstellenreferenz

Jede Node bietet eine offene JSON/REST-Schnittstelle. Admin-Endpunkte erwarten den Header X-Admin-Secret.

Beispiel