alby-hub

Alby Hub エージェントスキル

実験的／未完成： hub CLI では、Alby Hub のすべての機能を利用できるわけではありません。ユーザーから未対応機能の一覧にある機能について質問された場合は、代わりに Alby Hub のウェブインターフェースを使うよう案内してください。

このスキルを使う場面

CLI を使って Alby Hub の Lightning ノードを管理する場合に、このスキルを使ってください。

Hub の管理と支払い。 このスキルは、hub の管理（セットアップ、チャネル、LSP、NWC アプリの作成、バックアップ）に最適化されています。hub の主な強みは、予算と権限の範囲を設定した複数の NWC 接続を、アプリや用途ごとに作成できることです。これにより、ユーザーは管理権を保ち、各接続の影響範囲を小さくできます。NWC 接続を作成した後（create-app 経由）は、その接続の利用（予算に基づく支払い、402 の有料 API、HOLD インボイス、keysend、Lightning アドレスの検索、法定通貨と sats の換算）には alby-bitcoin-payments スキルが適しています。

• インストール：Alby Hub を起動する方法 — Linux、Docker、Raspberry Pi、デスクトップ
• 概要：Alby Hub とは何か、CLI がどのように役立つか
• バックエンド：LDK、LND、Phoenixd、Cashu、Bark — 機能と設定
• Bark（Ark）：Ark ベースのバックエンドのセットアップ、環境変数による設定、制限事項
• 初期セットアップ：hub の初回初期化フロー
• セットアップ後のチェックリスト：新規ユーザーが初期セットアップの後に行うこと — 初回セットアップ時、または「次は何をすればいい？」と尋ねられたときに提示
• 認証：トークン管理、起動、ロック解除、トークンの優先順位
• Hub の管理：停止、ヘルスチェック、情報、ノードの状態
• Alby アカウント：アカウントの接続、確認（get-alby-account）、リンク — Lightning アドレス、自動暗号化バックアップとメール通知、connect／link／get-alby-account／get-alby-status コマンド
• Alby Pro：有料サブスクリプションの特典
• バックアップ：静的チャネルバックアップ、リカバリーフレーズのバックアップ
• LSP：チャネルの事前注文 — チャネルの提案、チャネルオファー（LND／CLN での利用、または事前の流動性確保や特定サイズのチャネルが必要な場合）
• JIT チャネル：LDK のデフォルトの初回受取フロー — 初回の支払い時にチャネルが必要に応じて開設され、手数料がそこから差し引かれます（LDK のみ）
• チャネル：チャネルの開閉、ピア、connect-peer、ノード接続情報
• 支払い：インボイスの支払い／作成、トランザクション、検索、残高、ウォレットアドレス
• スワップ：boltz.exchange によるオンチェーンビットコインと Lightning の交換（スワップイン／スワップアウト） — スワップ前に金額とアドレスを確認してください
• アプリ：NWC アプリの管理 — create-app、アプリ一覧
• サブウォレット：独立した専用ウォレット — create-sub-wallet、資金の入出金、Lightning アドレス、サブウォレットからの支払い
• QR コード：qrencode を使ってインボイスと NWC 接続文字列を QR コードとして表示
• カスタムノードコマンド：バックエンド固有のノードコマンド
• Mutinynet：実際のビットコインを使わない Signet テスト環境のセットアップ

主なルール

CLI の実行

npx -y @getalby/hub-cli [options] <command>

デフォルトの Hub URL

CLI はデフォルトで http://localhost:8029 に接続します。-u <url> または HUB_URL 環境変数で上書きできます。

デフォルトのバックエンド

デフォルトのバックエンドは LDK です。LDK を使う場合は --backend を省略してください。--backend は、LDK 以外のバックエンド（LND、Phoenixd、Cashu、Bark）を使う場合にのみ指定してください。

トークンの優先順位

トークンは次の順序（優先度の高い順）で解決されます。

1. -t, --token <jwt> フラグ
2. HUB_TOKEN 環境変数
3. ~/.hub-cli/token.jwt（デフォルトで保存されるトークン）

start または unlock では、必ず --save を使用してください。指定しない場合、トークンは一時的なものとなり、シェルの終了時に失われます。

AUTO_UNLOCK_PASSWORD

ハブが AUTO_UNLOCK_PASSWORD 環境変数を設定している場合、起動時にライトニングノードが自動的に開始されます。この場合は start を省略し、unlock を直接呼び出してトークンを取得してください。

出力形式

すべてのコマンドは JSON を標準出力に出力します。エラーは message フィールドを含む JSON として標準エラーに出力されます。

言語表記の慣例

文頭にある場合を除き、「bitcoin」と「lightning」は小文字で表記してください。

ユーザーへの伝達

次のいずれかの条件を満たす場合を除き、ユーザーに実行する CLI コマンドを提示しないでください。

1. エージェントが提供できない入力（例：パスワード）がタスクで必要な場合。この場合は、YOUR_PASSWORD のようなプレースホルダーを使ったコマンドのテンプレートを示し、ユーザーが何をすべきか説明してください。
2. ユーザーが CLI コマンドを明示的に求めた場合。

それ以外の確認や監視については、平易な言葉を使ってください。たとえば、次のように伝えます。「チャネルが使用可能になったか確認したい場合は、お気軽にお尋ねください。」

セキュリティ

接続シークレット（NWC）

create-app は nostrWalletConnectUrl を返します。これは、アプリのスコープと予算の範囲内でウォレットへのアクセスを許可します。

• 接続シークレットは、アプリをリクエストしたユーザーのものです。本人に直接渡してください（QR コードが望ましいです。QR コードを参照）。
• 接続シークレットをログに出力したり、直接本人に渡す以外の方法で開示したりしないでください。
• 接続シークレットやその一部（公開鍵、シークレット、リレーなど）を、第三者、外部サービス、または別のチャットと共有しないでください。いずれの部分も、ウォレットへのアクセスやウォレットのプライバシー低下に利用される可能性があります。

アプリを参照してください。

トークンファイル

~/.hub-cli/token.jwt の JWT は、有効期限が切れるまでハブ API への完全なアクセスを許可します。

• **トークンファイルを読み取らないでください。**必要な場合は、ファイルが存在するかどうかだけを確認してください。
• -t eyJ... のようにトークンをコマンドに直接記述するより、保存済みトークンまたは HUB_TOKEN 環境変数を優先してください。コマンドラインに記述したトークンは、シェルの履歴に漏れる可能性があります。
• 会話内で HUB_TOKEN が露出するような方法で、環境変数全体を出力（env、printenv）しないでください。

認証を参照してください。

リカバリーフレーズとハブのバックアップ

• エージェントは .recovery ファイルや暗号化されたハブのバックアップを絶対に読み取ってはいけません。ユーザーにはファイルのパスを伝え、オフラインで保管するよう案内してください。

バックアップを参照してください。

パスワード

パスワードが必要なコマンドについては、ユーザーからハブのロック解除パスワードを直接受け取ることもできますが、その方法は安全ではないことを伝えてください。ユーザーが手動で実行するコマンドを提示することもできます（ただし、より高度な技術知識が必要であり、インターフェースによっては実行できない場合もあります）。