Bitcoin-Script-Lab: Timelocks, Multisig, Taproot auf Regtest

Dieses Lab gibt allen Lernenden einen echten Bitcoin-Core-Knoten auf einer privaten Regtest-Chain und daneben ein JupyterLab mit schlichtem Python. Beim Start schürft der Knoten 101 Blöcke, sendet eine Transaktion, die die Belohnung eines Blocks in sechs Ausgaben aufteilt (eine Zahlung, einen Timelock, ein 2-aus-3-Multisig, eine Taproot-Ausgabe, eine Miniscript-Policy und Wechselgeld), und schürft Block 102. Kurze Skripte zeigen dem Knoten dann feste, signierte Ausgaben dieser Outputs, und er prüft jede vollständig: jedes Mal mit denselben Antworten, weil die Uhr fest eingestellt ist.

Es ist rein technisch: Regtest-Coins gibt es nur in der jeweiligen Kopie, sie haben keinen Wert, die Schlüssel sind öffentliche Beispiele, und im Lab liegt kein privater Schlüssel. Keine Kopie hat einen Weg ins Internet oder zu anderen Lernenden, der Knoten verbindet sich mit keinem anderen Knoten, und es wird nichts hineingeladen.

Was Lernende lernen

Wie eine Transaktion ganze Ausgaben ausgibt und Wechselgeld zahlt und wie Gebühr und Gebührensatz berechnet werden: Die Transaktion des Labs zahlt 626 Sats für 313 virtuelle Bytes. Wie ein Script auf einem Stack läuft, in einer kleinen Maschine, die sie lesen können, und wie eine P2WPKH-Ausgabe einen Schlüssel und eine Signatur prüft. Wie ein CLTV-Timelock eine Ausgabe als non-final ablehnt, bis die Chain hoch genug ist, und wie ein CSV-Timelock Blöcke seit der Bestätigung zählt. Wie ein 2-aus-3-Multisig hinter P2WSH eine einzelne Signatur ablehnt und zwei annimmt, und wie aus einer Ausgabe-Policy erst Miniscript und dann Script wird, geprüft von den Deskriptoren des Knotens. Wie eine Taproot-Ausgabe über den Key Path in 99 virtuellen Bytes oder über ein verborgenes Script in 125 ausgegeben wird und warum das der Privatsphäre hilft. Wie ein Zahlungskanal alte Zustände widerruft und bestraft, wer einen davon sendet. Und wie eine Ersatztransaktion mehr zahlen muss als das, was sie verdrängt, und was Pinning bewirkt. Es passt zu Kursen in Blockchain, IT-Sicherheit und verteilten Systemen; prüfen Sie die genaue Formulierung in der Einheit Ihrer eigenen Prüfungsstelle, hier wird keine zitiert.

Im Browser ausführen

Das Lab startet zwei Dienste. bitcoind ist das Standard-Image von Bitcoin Core, das seine Einstellungen und Skripte schreibt, die Chain aufbaut und eine Zahlung im Mempool liegen lässt. jupyter schreibt btc.py, scriptvm.py, miniscript.py, paychan.py, ein Start-Notebook und kurze Skripte in seinen Arbeitsordner. JupyterLab verlangt kein Token, weil die Tür der Plattform schon weiß, wer es öffnet. Das Terminal neben dem Lab hat weder einen Knoten noch Python, es erreicht beide mit docker exec bitcoind und docker exec jupyter, gefolgt vom Befehl, der darin laufen soll.

  1. Container-Seite öffnen. Öffnen Sie in der Leiste „Entwickeln“ und wählen Sie „Einen Container ausführen“. Die Seite kann jeder öffnen, und das Git-Lab und das SQL-Lab starten ohne Konto. Alle anderen Labs brauchen ein kostenloses Konto: Erstellen Sie eines, melden Sie sich an und klicken Sie dann auf „Starten“.
  2. Lab suchen. Die Karte „Beispiel-Labs“ listet alle Beispiele auf. Suchen Sie Bitcoin Script: Zeitsperren, Multisig und Taproot auf Regtest.
  3. Auf „Starten“ klicken. „Starten“ führt das Lab unverändert mit einem einzigen Klick aus. „Zuerst die Datei bearbeiten“ öffnet die Compose-Datei, damit Sie sie vor dem Start ändern können.
  4. Öffnen. Klicken Sie auf „Terminal öffnen“ und tippen Sie docker exec bitcoind sh steps/cltv.sh. Sie sehen, wie der Knoten eine Ausgabe mit Timelock bei Höhe 102 als non-final ablehnt. Klicken Sie dann in der Lab-Leiste auf den Link JupyterLab, um JupyterLab im Browser zu öffnen, und lesen Sie miniscript.py im Dateieditor.

Was Lernende abgeben sollen

Ein eigenes Notebook, das diese Dateien nutzt, um eine selbst gewählte Frage zu beantworten, zum Beispiel welche Unterzeichnenden eine selbst geschriebene Policy ausgeben können, um wie viel größer eine Ausgabe über den Script Path ist als über den Key Path, oder wer die Coins bekommt, wenn ein alter Kanalzustand gesendet wird und niemand aufpasst, heruntergeladen aus JupyterLab mit File, Download. Dazu ein oder zwei Sätze in eigenen Worten, was sie gefunden haben. Nichts wird automatisch bewertet: Der Satz zeigt, ob es verstanden wurde. Für anspruchsvollere Arbeiten lassen Sie erklären, warum eine P2WSH-Ausgabe jeden Zweig ihres Scripts zeigt und eine Taproot-Ausgabe über den Script Path nur einen.

Eine Basis-Lektion zu diesem Lab

Bitcoin Script Basics ist eine kleine Lektion, die in diesem Lab gearbeitet wird. Darin lesen Lernende die Chain und ihre unverbrauchten Ausgaben, lassen ein Script auf einem Stack laufen, versuchen eine Ausgabe mit Timelock, geben ein 2-aus-3-Multisig und eine Taproot-Ausgabe aus und sehen, wie ein alter Zustand eines Zahlungskanals bestraft wird.

Kostenlose persönliche Konten haben sie im Modul Basics, das auf der Startseite liegt, und jede Einrichtung kann sie aus dem Basics-Ordner der Bibliothek kopieren. Sie ist bewusst klein: Sie zeigt einer Lehrkraft, was eine im Lab gearbeitete Lektion ist, und das Lab leistet den Rest. Kopieren Sie sie in ein eigenes Modul, um sie zu ändern. Das Hochschulmodul Bitcoin Script, Taproot und Zahlungskanäle auf Regtest wird im selben Lab bearbeitet.

Der Code auf GitHub

Die Compose-Datei hat kein Dockerfile: Sie startet zwei öffentliche Standard-Images, Bitcoin Core (bitcoin/bitcoin, MIT) und das scipy-notebook der Jupyter Docker Stacks (BSD-3-Clause), jedes auf ein Tag festgelegt und mit eigenem unprivilegiertem Konto, den Knoten mit 192 MB Speicher und JupyterLab mit 512 MB. Keines der Images wird von uns verteilt. Die Datei schreibt beim Start jedes Skript aus festem Text, die Uhr des Knotens ist fest eingestellt und jede Ausgabe wurde im Voraus signiert, daher gibt jede Kopie dasselbe aus und nichts wird heruntergeladen. Die Grenzen sind ehrlich: Im Lab läuft kein Lightning-Knoten, also ist ein Zahlungskanal ein Python-Modell seiner Regeln, und der Policy-Compiler ist ein kleiner eigener, dessen Ergebnis der Knoten prüft. Beim Stoppen des Labs bleibt nichts erhalten, weshalb Lernende ihr Notebook vorher herunterladen.

Als Aufgabe stellen

Schreiben Sie in die Aufgabe, was abzugeben ist.

  1. Lab erstellen. Fügen Sie in Ihrem Modul eine Aufgabe hinzu und wählen Sie die Karte „Container-Lab“, dann „In einem GitHub-Repository“. Geben Sie https://github.com/mitsurutech/lab-bitcoin-lab mit dem Branch main an. Die Compose-Datei ist standardmäßig compose.yaml. Forken Sie das Repository zuerst, wenn Sie es ändern möchten, zum Beispiel für eine eigene Ausgabe oder eine andere Regel für den kleinen Policy-Compiler.
  2. Veröffentlichen und ausprobieren. „Veröffentlichen“ legt den Commit fest, den Sie gesehen haben. Eine spätere Änderung im Repository verändert also kein Lab, das Sie bereits gestellt haben. Starten Sie zuerst Ihre eigene Kopie.
  3. Zuweisen. Weisen Sie es wie jede Aufgabe zu, auf Wunsch mit Fälligkeitsdatum, und schreiben Sie in die Aufgabe, was zu tun ist und was abgegeben werden soll.
  4. Abgaben bewerten. Öffnen Sie die Kopie einer lernenden Person und die abgegebene Arbeit, bewerten Sie sie und geben Sie sie mit einer Begründung zur Überarbeitung zurück, wenn mehr nötig ist.

Dieses Lab ausprobieren, und was es kostet

Mit einem kostenlosen persönlichen Konto können Sie die Grundlagenlektionen in diesem Lab durcharbeiten, mit genug kostenlosem Guthaben pro Monat für die meisten Lektionen und ohne Karte. Für eine Klasse sind die ersten 365 Tage für eine Schule kostenlos, für bis zu 50 Lernende; danach zahlt sie je lernender Person und Jahr, alle Labs inklusive und Lehrkräfte kostenlos.

Häufige Fragen

Sind das echte Bitcoins?
Nein. Regtest ist eine private Test-Chain im Lab jeder lernenden Person. Ihre Coins können das Lab nicht verlassen und haben keinen Wert, und das Lab hat keinen Weg ins Internet. Das Modul handelt davon, wie das System funktioniert, nie von Preisen oder Handel.
Warum nutzt das Terminal docker exec bitcoind und docker exec jupyter?
Das Terminal des Labs enthält einige Clients, aber weder einen Bitcoin-Knoten noch Python. docker exec führt einen Befehl in einem der Container des Labs aus: bitcoind hat den Knoten und bitcoin-cli, jupyter hat Python.
Warum gibt jeder Lauf dasselbe aus?
Die Uhr des Knotens ist fest eingestellt, und er spricht mit keinem anderen Knoten, also haben die Blöcke, die er beim Start schürft, jedes Mal dieselben Hashes. Die Ausgaben, die eine Lektion zeigt, wurden im Voraus signiert und dem Knoten nur mit testmempoolaccept gezeigt, das sie prüft und nichts ändert. Das eine Skript, das weitere Blöcke schürft, ändert die Höhe, und die Lektion sagt das.
Läuft im Lab ein Lightning-Knoten?
Nein. Für dieses Lab ist kein Image festgelegt, das einen solchen Knoten offline auf einer Regtest-Chain betreibt, ohne etwas herunterzuladen. Die Lektion zu Zahlungskanälen nutzt paychan.py, ein kurzes Python-Modell der Zustände, des Widerrufs und der Strafe eines Kanals, und erklärt den echten Mechanismus.