コンテンツにスキップ

フルノードウォレット

このガイドは、Bursa フルノードウォレットのインストール、起動モード、実行時設定、ソースからのビルド、macOS パッケージ作成、運用時の問題解決を扱います。

Bursa リリースページから、対象プラットフォームのウォレットをダウンロードします。リリースファイルの名前は次の形式です。

bursa-wallet-<version>-<os>-<arch>.<ext>
プラットフォームファイルインストールの動作
macOS arm64 (Apple Silicon).pkgApple の署名と公証が付いたインストーラーが Bursa.app をインストールします。
Windows amd64 または arm64.msiWindows の署名付きインストーラーです。
Linux amd64 または arm64.tar.gzアーカイブを展開し、ネイティブウィンドウ版を実行します。
FreeBSD amd64 または arm64.tar.gzアーカイブを展開し、ヘッドレス版をブラウザーで使用します。ネイティブウィンドウ版は提供されません。

Linux または FreeBSD では、展開して同梱の bursa-wallet を実行します。

ターミナルウィンドウ
tar xzf bursa-wallet-<version>-<os>-<arch>.tar.gz
./bursa-wallet

macOS または Windows パッケージをインストール後、アプリケーションメニューから Bursa を起動するか、実行ファイルを直接実行します。

ターミナルウィンドウ
bursa-wallet

ネットワークを指定するには、-n または --network を使用します。

ターミナルウィンドウ
bursa-wallet -n mainnet
bursa-wallet --network musashi

指定できるネットワークは mainnet、preprod、preview、musashi、dijkstra です。選択順序は、コマンドラインフラグ、BURSA_NETWORK、preview です。コマンドラインフラグは BURSA_NETWORK より優先されます。未知のネットワーク名を指定した場合や、フラグ解析後に余分な位置引数が残った場合は、ウォレットは起動しません。

デスクトップ版はネイティブウィンドウを開きます。ヘッドレス版はループバック(通常は 127.0.0.1:8090)でインターフェイスを提供し、起動時に完全な認証済み URL を表示します。Bursa が表示する URL 全体をブラウザーで開いてください。ブラウザーは URL の #session=... フラグメントの値を X-Bursa-Session ヘッダーで /session に送信し、そのウォレットプロセス内だけで有効な制御セッションを確立します。ブラウザーは以後の保護された API リクエストにも同じヘッダーを使用し、フラグメントをブラウザー履歴から削除します。ページを再読み込みするとメモリ内の capability が失われるため、完全な URL を開き直すか、デスクトップウォレットを再起動してください。

初回起動時に組み込みノードを同期します。既定の mithril モードは、選択したネットワークにアグリゲーター設定がある場合に Mithril スナップショットを使用します。設定がない場合は Mithril ブートストラップを省略し、ジェネシスから同期します。musashi と dijkstra には Mithril のスナップショットとアグリゲーター設定がありません。BURSA_SYNC=genesis を指定した場合もジェネシスから同期します。データは ~/.bursa-wallet/<network>/ に保存します。

初期設定に使用する環境変数は、初回起動前に設定します。

変数既定値動作
BURSA_NETWORKpreviewコマンドラインフラグを指定しない場合に、mainnet、preprod、preview、musashi、dijkstra のいずれかを指定して、Cardano ネットワークとそのデータディレクトリを選択します。
BURSA_SYNCmithrilgenesis を指定すると、Mithril スナップショットではなくチェーンの起点から再実行します。musashi と dijkstra には Mithril アグリゲーター設定がないため、mithril を指定してもジェネシスから同期します。
BURSA_LEANfalse過去のチェーンデータを削除してディスク使用量を減らす lean ストレージを有効にします。
BURSA_CONNECTORfalsedApp コネクターバックエンドを有効にします。

初回実行後、インターフェイスで設定した値は永続化されます。保存された設定値は、環境変数より優先されます。

コネクターのペアリングは拡張機能の公開鍵に結び付きます。拡張機能のフィンガープリント(確認コード)と、Bursa の設定画面の確認コードが一致することを確認してからペアリングを承認します。各要求では、新しい単一使用の challenge と HTTP メソッド、パス、本文全体をまとめて署名し、X-Bursa-Challenge と X-Bursa-Signature ヘッダーで送信します。X-Bursa-Token による bearer 認証は無効です。イベントストリームは単一使用で短時間だけ有効な ticket を接続ごとに必要とし、再接続時は新しい ticket を取得します。ペアリングを解除または置換すると、以前のペアリングに属する保留中の要求と認可状態、challenge は直ちに無効になります。

Go 1.26 以降と Node 22 をインストールし、リポジトリのルートでビルドコマンドを実行します。

ヘッドレスウォレットのビルド

Section titled “ヘッドレスウォレットのビルド”

Web バンドルと既定の pure-Go バイナリをビルドします。

ターミナルウィンドウ
make wallet

出力先は ui/bursa-wallet です。このビルドはループバック上でインターフェイスを提供し、クロスコンパイルに対応します。

ネイティブウィンドウ版のビルド

Section titled “ネイティブウィンドウ版のビルド”

ネイティブウィンドウ版をビルドします。

ターミナルウィンドウ
make wallet-webview

CGO、C ツールチェーン、対象プラットフォームの webview 開発ヘッダーが必要です。

  • macOS: WKWebView
  • Windows: WebView2
  • Linux: ビルド用の webkit2gtk 開発ヘッダーと、実行時用の libayatana-appindicator3。webview タグ付きビルドでトレイを使用するには両方が必要です。

Windows MSI ビルドで WebView2 Evergreen bootstrapper をバンドルする場合は、その bootstrapper に有効な Authenticode 署名が必要です。WEBVIEW2_SHA256 を指定しない場合、署名者は Microsoft Corporation でなければなりません。WEBVIEW2_SHA256 を指定すると受け入れるファイルをハッシュで固定できますが、有効な Authenticode 署名の検証は引き続き必要です。

webview 版は異なるアーキテクチャへのコンパイルに対応しません。対象のアーキテクチャを持つマシンでビルドします。Linux では webkit2gtk-4.1 を使用できます。上流のバインディングが 4.0 を要求する場合、Makefile が pkg-config シムを提供します。

ローカルテスト用パッケージを作成します。

ターミナルウィンドウ
make bundle-macos

このターゲットはアドホック署名の .pkg を作成します。署名と公証を行うリリースパッケージは次で作成します。

ターミナルウィンドウ
make pkg-macos

pkg-macos には Apple の署名および公証用の秘密情報が必要です。

同期が遅い、または停止しているように見える

Section titled “同期が遅い、または停止しているように見える”
  1. Settings → Diagnostics を開き、ノードの状態、ピアの状態、同期状況を確認します。
  2. 診断ログをエクスポートするか、~/.bursa-wallet/<network>/logs/bursa-wallet.log を直接確認します。

Linux の webview ウィンドウが空白になる

Section titled “Linux の webview ウィンドウが空白になる”

webview 版には webkit2gtk と開発ヘッダーをインストールします。別途、webview タグ付きビルドを実行する前に、実行時用の libayatana-appindicator3 もインストールします。webview のないシステムでは、pure-Go ブラウザー版を使用してループバックアドレスを開いてください。

初回実行時に lean ストレージを有効にします。

ターミナルウィンドウ
BURSA_LEAN=true bursa-wallet

lean ストレージは過去のチェーンデータを期限切れにして、ディスク使用量を減らします。


Doc Holiday logo

Docs authored by Doc Holiday