Bitcoin Script ラボ:regtest ノードでタイムロック、マルチシグ、Miniscript、Taproot

このラボでは、生徒ひとりひとりに、プライベートな regtest チェーンで動く本物の Bitcoin Core ノードと、その横に普通の Python の JupyterLab を渡します。起動すると、ノードは101個のブロックを掘り、ブロックの報酬を6つの出力に分けるトランザクションを1つ送り (支払い、タイムロック、2-of-3 マルチシグ、Taproot の出力、Miniscript のポリシー、おつり)、ブロック102を掘ります。そのあと短いスクリプトが、それらの出力を使う、固定の署名ずみの支払いをノードに見せ、ノードが1つずつきちんと確かめます。時計が固定なので、答えは毎回同じです。

扱うのは技術だけです。regtest のコインはそれぞれのコピーの中にしかなく価値はありません。鍵は公開された例で、ラボに秘密鍵はありません。どのコピーもインターネットにも、ほかの生徒にもつながらず、ノードはほかのノードに接続せず、何もダウンロードされません。

生徒が学ぶこと

トランザクションが出力を丸ごと使っておつりを払うこと、その手数料と手数料率の計算です。ラボのトランザクションは313仮想バイトで626 sat を払います。読み通せるおもちゃの機械で、スクリプトがスタックでどう動くか、P2WPKH の出力が鍵と署名をどう確かめるかを学びます。CLTV のタイムロックが、チェーンが十分な高さになるまで支払いを non-final として拒否すること、CSV のタイムロックが承認からのブロックを数えることも学びます。P2WSH の 2-of-3 マルチシグが署名1つを拒否して2つを受け入れること、使用ポリシーが Miniscript になり、さらに Script になって、ノード自身のディスクリプターで確かめられることも学びます。Taproot の出力がキーパスなら99仮想バイト、隠れたスクリプト1つなら125仮想バイトで使えることと、それがプライバシーに役立つ理由も学びます。支払いチャネルが古い状態を失効させ、それを流した人を罰すること、置き換えのトランザクションが押し出すものより多く払わなければならないこと、ピンニングが何をするかも学びます。ブロックチェーン、セキュリティ、分散システムの講座に向いています。正確な文言は、お使いの資格団体の単元で確認してください。ここには引用していません。

ブラウザーで実行する

ラボは2つのサービスを起動します。bitcoind は既存の Bitcoin Core のイメージで、設定とスクリプトを書き出し、チェーンを作り、支払いを1つメモリプールに残します。jupyter は btc.py、scriptvm.py、miniscript.py、paychan.py、はじめのノートブック、短いスクリプトを作業フォルダーに書き出します。JupyterLab はトークンを求めません。プラットフォームの入口が、開いている人をすでに知っているからです。ラボの横のターミナルにはノードも Python もないので、docker exec bitcoind と docker exec jupyter に続けて、中で実行するコマンドを書きます。

  1. コンテナーのページを開く. バーの「つくる」を開き、「コンテナーを実行」を選びます。ページは誰でも開けて、Git ラボと SQL ラボはアカウントなしで起動できます。ほかのラボには無料アカウントが必要です。アカウントを作成してサインインし、「起動」を押します。
  2. ラボを探す. 「サンプルラボ」のカードにすべてのサンプルが並んでいます。Bitcoin Script:regtest でのタイムロック、マルチシグ、Taprootを探します。
  3. 「起動」を押す. 「起動」はそのまま1回の操作で実行します。「先にファイルを編集」は compose ファイルを開くので、起動する前に変更できます。
  4. 開く. 「ターミナルを開く」を押し、docker exec bitcoind sh steps/cltv.sh と入力すると、タイムロックの支払いが高さ102で non-final として拒否される様子が見えます。次に、ラボのバーにある JupyterLab のリンクを押してブラウザーで JupyterLab を開き、ファイルエディターで miniscript.py を読みます。

生徒に提出してもらうもの

これらのファイルを使って、自分で選んだ問いに答える自分のノートブックを提出してもらいます。たとえば、自分で書いたポリシーをどの署名者が使えるか、スクリプトパスの支払いはキーパスよりどれだけ大きいか、古いチャネルの状態が流されて誰も見張っていないときコインは誰のものになるか、などです。JupyterLab の File、Download でダウンロードします。そこに、分かったことを自分の言葉で1、2文書いてもらいます。自動では採点されません。この文が、理解できたかどうかを示します。さらに力を見たいときは、P2WSH の支払いはスクリプトのすべての枝を見せるのに、Taproot のスクリプトパスの支払いは1つしか見せないのはなぜかを説明してもらいます。

このラボの基本レッスン

Bitcoin Script Basics は、このラボで進める小さなレッスンです。生徒はチェーンとその未使用の出力を読み、スタックでスクリプトを動かし、タイムロックの支払いを試し、2-of-3 マルチシグと Taproot の出力を使い、古い支払いチャネルの状態が罰せられるのを見ます。

無料の個人アカウントでは「ホーム」にある Basics モジュールに入っていて、どの学校もライブラリーの Basics フォルダーからコピーできます。あえて小さくしてあり、ラボで進めるレッスンがどういうものかを先生に見せる役目です。あとはラボが受け持ちます。変更したいときは、自分のモジュールにコピーしてください。大学向けモジュール「regtest で学ぶ Bitcoin Script、Taproot、支払いチャネル」も、同じラボで進めます。

GitHub のコード

compose ファイルには Dockerfile がありません。公開されている既存のイメージを2つ使います。Bitcoin Core (bitcoin/bitcoin、MIT) と、Jupyter Docker Stacks の scipy-notebook (BSD-3-Clause) で、どちらもタグに固定し、権限のない専用アカウントで動かします。メモリはノードが 192 MB、JupyterLab が 512 MB です。どちらのイメージも私たちは再配布していません。起動のたびに固定の文章からスクリプトをすべて書き出し、ノードの時計は固定で、支払いはどれも前もって署名してあるので、どのコピーも同じ結果を表示し、何もダウンロードされません。限界もあります。ラボでは Lightning ノードは動かないので、支払いチャネルはその規則を書いた Python のモデルです。ポリシーのコンパイラーは私たち自身の小さなもので、その出力をノードが確かめます。ラボを止めると何も残らないので、生徒は先にノートブックをダウンロードします。

課題として出す

何を提出するかを課題に書いておきます。

  1. ラボを作る. モジュールで課題を追加し、「コンテナーラボ」のカードを選んでから「GitHub リポジトリ」を選びます。https://github.com/mitsurutech/lab-bitcoin-lab とブランチ main を指定します。compose ファイルは既定の compose.yaml です。変更したい場合は、たとえば自分の支払いを足すときや、おもちゃのコンパイラーに別のポリシーを渡すときは、先にリポジトリをフォークしてください。
  2. 公開して試す. 「公開」すると、確認したコミットに固定されるので、あとでリポジトリを変更しても、すでに出したラボは変わりません。まず自分のコピーを起動してください。
  3. 配布する. ほかの課題と同じように配布します。期限を付けることもでき、課題には何をするか、何を提出するかを書いておきます。
  4. 提出物を採点する. 生徒のコピーを開いて提出された内容を確認し、採点します。足りない場合は理由を書いて差し戻します。

このラボを試す、そして費用

無料の個人アカウントで、このラボの基本レッスンに取り組めます。毎月、ほとんどのレッスンに足りる無料クレジットがあり、カードは要りません。クラスで使う場合、学校は最初の365日間、生徒50人まで無料で、その後は生徒1人あたりの年額です。すべてのラボが含まれ、教職員は無料です。

よくある質問

これは本物のビットコインですか。
いいえ。regtest は、生徒ひとりひとりのラボの中にあるプライベートなテスト用チェーンです。そのコインは外に出られず価値もなく、ラボはインターネットにつながりません。このモジュールは仕組みを学ぶもので、価格や売買は一切扱いません。
ターミナルで docker exec bitcoind と docker exec jupyter を使うのはなぜですか。
ラボのターミナルにはいくつかのクライアントが入っていますが、Bitcoin のノードも Python もありません。docker exec は、ラボ自身のコンテナーの中でコマンドを実行します。bitcoind にはノードと bitcoin-cli があり、jupyter には Python があります。
実行するたびに同じ結果になるのはなぜですか。
ノードの時計は固定で、ほかのノードと通信しないので、起動時に掘るブロックは毎回同じハッシュになります。レッスンで見せる支払いは前もって署名してあり、testmempoolaccept でノードに見せるだけです。これは支払いを確かめるだけで、何も変えません。ブロックをさらに掘るスクリプトだけは高さを変え、そのことはレッスンに書いてあります。
ラボで Lightning ノードは動きますか。
いいえ。何もダウンロードせずに regtest でオフラインに動くイメージが、このラボには固定されていません。支払いチャネルのレッスンでは、チャネルの状態、失効、罰を書いた短い Python のモデル paychan.py を使い、本物の仕組みを説明します。