Das Sibuna-Handbuch 1.0.0-beta.3 Dokumentation
Sprache: Deutsch
English简体中文한국어日本語EspañolDeutschहिन्दीالعربية

Vorwort

Eine Anfrage kommt mit einer Methode, einem Pfad, einigen Headern und einem Anspruch auf die Aufmerksamkeit des Servers an. Keines dieser Bytes belegt, dass es sich lohnt, sie zu bedienen. Sibuna stellt eine Entscheidung zwischen die Anfrage und den Ursprungsserver: sie zulassen, sie abweisen oder ihren Absender um nachprüfbare Arbeit bitten. Dieses Buch verfolgt diese Entscheidung von ihrem mathematischen Modell bis zu den Bytes im Speicher.

Das System hat zwei Betriebsformen. Gate bietet Proof-of-Work-Zulassung und lokale Flutkontrollen. Shield ergänzt Anwendungsprüfung und Richtlinienentscheidungen. Beide können Richtlinien, Reputation und Vorfallshistorie persistent speichern, lokal auf einem Knoten oder gemeinsam für einen Cluster; diesen Einsatz nennen wir Edge. Eine gültige Sitzung begründet die Zulassung; sie befreit die Anfrage nicht von der Prüfung. Wer dauerhaften Zustand im Cluster teilt, verteilt ihn; aus einem lokalen Ratenzähler wird dadurch kein globales Kontingent.

Die zentrale technische Frage ist nicht, ob ein Hash schnell ist. Sie lautet, ob der gesamte Pfad beschränkt bleibt, wenn ein nicht vertrauenswürdiger Client die Eingabe wählt. Wie viele Bytes kann ein Parser prüfen? Wie viel Speicher kann eine Challenge verbrauchen? Wie viele Verbindungen kann ein Client offen halten? Welche Schreibvorgänge dürfen wiederholt werden? Was bleibt verfügbar, wenn ein Knoten oder die Datenbank verschwindet? Jede Antwort muss sowohl eine Invariante als auch ihre Grenze nennen.

Die Mathematik dient demselben Zweck. Erwartete Kosten sind keine Latenzgarantie. Ein Stichprobenargument für ein festes Commitment ist kein Beweis gegen jeden adaptiven Beweiser. Eine Warteschlange fängt einen Burst ab; einen dauerhaft langsameren Verbraucher kann sie nicht ausgleichen. Wir leiten kleine Modelle her, rechnen Beispiele von Hand durch und fragen dann, wo die Implementierung von ihnen abweicht.

Das Buch ist für drei Arten der Nutzung geschrieben. In der Reihenfolge gelesen, bilden die Teile I bis VII einen Kurs: Jedes Kapitel beginnt mit dem, was wir danach können sollten, rechnet ein Beispiel von Hand durch und endet mit einer Übung und einer Invariante, die wir mit eigenen Worten erklären; ausgewählte Lösungen stehen am Ende des Buchs. Die Teile VIII bis X sind das Nachschlagewerk: Messungen mit ihrer Herkunft, jede Option und jede Topologie, jeder Endpunkt, Status, Fehler und jede Tabelle. Teil XI ist eine zweiseitige Karte für das Terminal. Ein Glossar und ein Literaturverzeichnis schließen das Buch ab.

Teil II stellt Sibuna Funktion für Funktion neben Anubis, SafeLine und die Cloudflare WAF, und Teil VIII präsentiert Sibunas eigene Messungen, von einzelnen Primitiven bis zu Läufen des Gesamtprodukts, und vergleicht Sibuna und Anubis als Gesamtprodukte unter demselben Lastgenerator. Beide Teile sind so geschrieben, dass wir die Aussagen prüfen können: Der Vergleich nennt seine Quellen, und jede Messung nennt die eingecheckte Ergebnisdatei, aus der sie stammt.

Vorausgesetzt werden Grundkenntnisse im Programmieren, Logarithmen und bedingte Wahrscheinlichkeit. Rust wird über Ownership und Datenlayout eingeführt, nicht durch einen Überblick über die Sprache. Die Kapitel lassen sich der Reihe nach lesen: Das Kostenmodell begründet das Protokoll, das Protokoll bestimmt den Zustand, und der Zustand bestimmt den Entwurf von Nebenläufigkeit und Speicherung. Spätere Kapitel machen aus diesen Invarianten Messungen und Betriebsverfahren.

Dies ist ein Buch über eine Implementierung, keine Behauptung, dass Rechenrätsel automatisierten Datenverkehr beseitigen. Clients können Rechenleistung kaufen, Adressen können geteilt werden, und die Syntax von Anwendungen ist reicher, als ein begrenzter Detektor erfassen kann. Das nützliche Ergebnis ist ein System, dessen Kosten und Grenzen sich untersuchen, testen und ändern lassen, ohne sie hinter einem Slogan zu verbergen.

Ausgabe für Sibuna 1.0.0-beta.3, November 2026

Quellcode, Übungen und reproduzierbare Messungen finden sich im Sibuna-Repository.