フルノードウォレット
Bursaフルノードウォレット
Section titled “Bursaフルノードウォレット”このガイドでは、Bursaフルノードウォレットのリリース資産からのインストール、起動、実行時設定、ソースからのビルド、macOSパッケージの作成、運用上のトラブルシューティングを説明します。
インストール
Section titled “インストール”リリースページから、bursa-wallet-<version>-<os>-<arch>.<ext>形式のウォレット資産をダウンロードします。
| プラットフォーム | 資産 | 動作 |
|---|---|---|
| macOS arm64（Apple Silicon） | .pkg | 署名と公証を済ませています。Bursa.appをインストールします。 |
| Windows amd64、arm64 | .msi | 署名を済ませています。 |
| Linux amd64、arm64 | .tar.gz | ネイティブウィンドウを表示します。 |
| FreeBSD amd64、arm64 | .tar.gz | ヘッドレスで動作します。ブラウザーでインターフェースを開きます。 |
macOSの.pkgとWindowsの.msiは、それぞれ対応するプラットフォームのインストーラーとして実行します。LinuxまたはFreeBSDの.tar.gzは展開して使用します。FreeBSDではネイティブウィンドウを使用できません。
macOSまたはWindowsでは、インストール後にアプリケーション一覧からBursaを起動します。バイナリから起動する場合は、次のコマンドを実行します。
bursa-walletネイティブウィンドウを使用しないビルドは、同じインターフェースをhttp://127.0.0.1:8090で提供します。ブラウザーでこのURLを開いてください。ウォレットはループバックアドレスにだけバインドします。
初回起動ではノードの同期を開始します。既定ではmithrilを使用してスナップショットから同期します。ウォレットは同期の進行状況を表示し、同期中でも読み取り専用で開きます。
環境変数を設定してからbursa-walletを起動します。
| 環境変数 | 既定値 | 動作 |
|---|---|---|
BURSA_NETWORK | preview | Cardanoネットワークを選択し、そのネットワークのデータディレクトリを選択します。 |
BURSA_SYNC | mithril | genesisを指定すると、Mithrilスナップショットを使わずにチェーンを最初から再生します。 |
BURSA_LEAN | false | trueを指定すると、履歴チェーンデータを整理する省容量プロファイルを使用します。 |
BURSA_CONNECTOR | false | trueを指定すると、dAppコネクターのバックエンドを有効にします。 |
BURSA_NETWORK=preview BURSA_SYNC=mithril BURSA_LEAN=false BURSA_CONNECTOR=false bursa-walletウォレットは127.0.0.1:8090でサービスを提供します。ウォレットはインターフェースで変更した設定を初回起動後に保存し、保存済みの値を以後の環境変数より優先します。BURSA_NETWORKは~/.bursa-wallet/<network>/のデータディレクトリも決定し、ウォレットはログをその配下のlogs/bursa-wallet.logに保存します。
ソースからのビルド
Section titled “ソースからのビルド”- Go
1.26以降 - Node
22
リポジトリのルートディレクトリで次のコマンドを実行します。
純粋なGoのヘッドレスビルド
Section titled “純粋なGoのヘッドレスビルド”make walletこのターゲットはWebバンドルを作成し、ui/bursa-walletに既定の純粋なGoバイナリを作成します。このバイナリはループバックでインターフェースを提供し、クロスコンパイルできます。
ネイティブウィンドウビルド
Section titled “ネイティブウィンドウビルド”make wallet-webviewこのターゲットはCGOと各プラットフォームのシステムWebViewを使用します。対象アーキテクチャのマシン上で、CツールチェーンとWebView開発用ヘッダーを用いてビルドしてください。クロスコンパイルには対応していません。
- macOSは
WKWebViewを使用します。 - Windowsは
WebView2を使用します。 - Linuxでは、
webkit2gtkの開発用ヘッダーと、webviewタグのビルドでトレイを表示するためのlibayatana-appindicator3ランタイムが必要です。
Linuxでwebkit2gtk-4.1だけをインストールしている場合、ビルド処理は4.0を要求するWebView部品向けにpkg-config互換設定を作成します。
macOSパッケージ
Section titled “macOSパッケージ”make bundle-macosmake pkg-macosmake bundle-macosはローカルテスト用に署名した.pkgを作成します。make pkg-macosは署名と公証を済ませた.pkgを作成し、Appleのシークレットを必要とします。
トラブルシューティング
Section titled “トラブルシューティング”同期が遅い、または停止したように見える
Section titled “同期が遅い、または停止したように見える”- ウォレットの設定にある診断画面で、ノードの状態、ピア、同期状態を確認します。
- 診断画面からログをエクスポートします。
- 次のパスにあるログを直接確認します。
~/.bursa-wallet/<network>/logs/bursa-wallet.logLinuxでウィンドウが空白になる
Section titled “Linuxでウィンドウが空白になる”make wallet-webviewで作成したビルドでは、空白のウィンドウを防ぐためにwebkit2gtkが必要です。Linuxでは、libayatana-appindicator3も実行時に必要です。webkit2gtkをインストールできない場合は、make walletで純粋なGoのビルドを作成し、ブラウザーでhttp://127.0.0.1:8090を開いてください。
ディスク使用量が大きい
Section titled “ディスク使用量が大きい”初回起動時にBURSA_LEAN=trueを設定して、履歴チェーンデータを整理する省容量プロファイルを選択します。既存のウォレットでは、設定で省容量ストレージを有効にします。
Docs authored by Doc Holiday