ウォレットの概要

1. Zappin ウォレットの特徴

• 残高は Ark 上のビットコインに集約します。 普段使う残高は Ark 残高ひとつです。オンチェーンで受け取ったビットコインも、自動チャージで Ark 残高へ移します。オンチェーン残高は、入金の入口と非常時の出口として扱います。
• Zappin の中の送金は手数料 0 で、すぐ届きます。 投げ銭などの Ark アドレス宛ての送金には手数料がかかりません。
• Lightning で受け取る人は、指定した額をそのまま受け取ります。 受取の手数料はインボイスの額に上乗せしてあり、支払う人が負担します。
• 鍵は利用者の端末にあります。 Zappin や Ark サーバーが資金を預かっているわけではありません。Ark サーバーが応答しなくなっても、VTXO の期限内であれば緊急時の取り出しで自分のオンチェーンウォレットへ取り戻せます（§6）。残高の出どころによって前提があります（§3-6）。

2. 用語

3. お金の流れ

3-1. 入ってくるお金（オンチェーン → Ark）

• オンチェーンで受け取ったお金は、自動チャージ（Onboard）で Ark 残高へ移します。自動チャージは既定でオンです。
• 次の場合は、オンチェーン残高のまま残します。
  • 移せる額（オンチェーン残高から採掘手数料を引いた額）が、自動チャージの最低額（20,000 sat）に届かないとき。次の入金と合わせて最低額に届けば移します
  • 採掘手数料が、利用者が決めた上限を超えているとき。手数料が下がってから移します（§5-4）
  • 利用者が自動チャージをオフにしたとき
  • 緊急時の取り出しを準備したとき。手数料の元手として入金したお金が Ark へ移されないよう、アプリが自動チャージをオフにします。オンには自動で戻りません（§6）

3-2. 出ていくお金（Ark → オンチェーン）

• 外部のオンチェーンアドレスへは、Ark 残高から Offboard で送ります。送金画面でオンチェーンアドレスを読み取る（または入力する）と、この方法で送ります。
• Ark 残高の全額を、自分のオンチェーン残高へ移す操作は用意しません。Zappin をやめるとき・長く保管したいときは、送金画面で外部のウォレットへ全額を送ってください。
• オンチェーン残高から外部へ直接送る機能は、通常の画面にはありません。デバッグ画面のコマンドだけで使えます。緊急時の取り出しで取り戻したお金を外部へ送るときに使います（§6）。
• 例外として、緊急時の取り出し（設定 →「緊急時の取り出し」）では、Ark 残高を自分のオンチェーンウォレットへ移します。サーバーが応答しない・協力しないときのための手段です。手順は §6 にあります。

3-3. Ark 残高どうしの送金

• Ark アドレス宛ての送金は Arkoor で送ります。手数料は 0 で、ラウンドを待たずに届きます。

3-4. Lightning

• 送金: BOLT11 のインボイス・Lightning アドレス・LNURL・BOLT12 オファーに支払います。Lightning アドレス・LNURL・金額の無いオファーには、送る人が金額を決めます。サーバー手数料は送金額に上乗せします。
• 受取: 金額を決めてインボイスを作ります。サーバー手数料をインボイスの額に上乗せするので、支払う人が負担し、受け取る人は指定した額を受け取ります。

3-5. リフレッシュ（自動）

• VTXO には期限があります。寿命は 1008 ブロック（約 1 週間）です。
• 期限を過ぎた VTXO は失われはしませんが、取り戻すにはサーバーの協力が要ります。サーバーが協力すれば、期限の後もリフレッシュ・オンチェーンへの送金・Lightning の送金はできます。できなくなるのは、Ark 残高どうしの送金（Ark アドレス宛て）と、緊急時の取り出しです。
• アプリは、期限が近づいた VTXO を自動でリフレッシュし、新しい期限の VTXO に取り替えます。目安は期限の約 1 日前です。この時期の期限別率は 0% なので（§5-2）、手数料はほとんどの場合、1 回ごとの固定額だけです。
• Arkoor で受け渡しを重ねた VTXO は、期限より前でもリフレッシュの対象になります。受け渡しの連鎖が長いほど、緊急時の取り出しにかかる取引が増えるためです。
• リフレッシュは委譲リフレッシュで行います。スマートフォンのアプリは、ラウンドの間ずっと開いていられないためです。そのかわり、委譲リフレッシュで受け取った VTXO はサーバーの署名だけに頼ります（§3-6）。自分でも署名してリフレッシュしたい人は、デバッグ画面のコマンドで、その都度リフレッシュできます。ラウンドが終わるまで（10 分ほど）アプリを開いたままにする必要があります。
• リフレッシュはアプリを開いている間に行います。アプリを長く開かないと期限を過ぎるおそれがあるので、期限の約 1 日前から通知で知らせます。通知が来たらアプリを開いてください。

3-6. 自分で鍵を持つことの前提

VTXO をサーバーの協力なしに取り戻せるかどうかは、その VTXO をどう受け取ったかで違います（Second の資料による）。

4. ラウンドを待つ操作

ラウンド（本番では 10 分ごと）を待つのは、デバッグ画面のコマンドで自分で署名してリフレッシュするときだけです（§3-5）。委譲リフレッシュは、ラウンドへの参加をサーバーに任せるので、アプリは待ちません。オンチェーンへの送金（Offboard）はラウンドを待たず、その場でサーバーとやり取りして送ります。

5. 手数料

§5-1・§5-2 の値は、更新日時点の本番の Ark サーバーの設定です。手数料は変更される場合があります。

5-1. 一覧

金額の単位は sat です。「額」は、その操作で動かす金額（送金額・移す額・VTXO の額）です。

• 手数料率: オンチェーンへ送るときにサーバーが使う手数料率（sat/vB）です。
• 送り先の大きさ: 送り先アドレスの種類で決まります。P2TR（bc1p で始まるアドレス）なら 34 vB です。
• 期限別率: 使う VTXO の期限までの残りブロック数で決まります（§5-2）。

5-2. 期限別率

期限が近い VTXO ほど率が下がります。1 ブロックは約 10 分です。

5-3. 計算例（オンチェーンへ送金）

テスト用のネットワーク（signet）で、P2TR アドレスへ送った 1 件です。手数料率は 5 sat/vB、使った VTXO は期限まで残り 39〜42 ブロックでした。

5-4. 自動で払う手数料

利用者が操作しなくても払う手数料は、次の 2 つです。

自動チャージのサーバー手数料は移す額で決まり、採掘手数料の高騰とは関係しないので、上限の対象にしません。

6. 緊急時の取り出し（緊急 Exit）の手順

緊急時の取り出しは、Ark サーバーが応答しない・協力しないときに、自分のお金を自力で取り戻すための最後の手段です。完了まで 24 時間以上かかることがあり、手数料も高くなりやすく、始めると取り消せません。Ark サーバーが動いているなら、送金画面からオンチェーンへ送るほうが速くて安く済みます。

• 期限までに終える必要があります。 VTXO の期限までに、取り出しの取引がすべて承認されていなければなりません。期限が近いと間に合わないので、サーバーが応答しなくなったら早めに始めてください。
• 手数料の元手がオンチェーン残高に要ります。 取り出しの採掘手数料（CPFP）はオンチェーン残高から払います。

1. 準備する（設定 →「緊急時の取り出し」）。取り出す予定の額・推定手数料・必要なオンチェーン残高が出ます。準備ではお金は動きません。このときアプリは自動チャージをオフにします。
2. 足りない分をオンチェーンで入金する。受取画面のオンチェーンアドレスか、準備結果の「＋ オンチェーン残高を追加」から入金し、承認されるまで待ちます。
3. 開始する。
4. アプリを開いたまま進める。取り出しはアプリを開いている間だけ進みます。ブロックの承認と待ち時間（タイムロック）を経て進みます。途中で手数料が足りなくなったら、オンチェーン残高を追加します。
5. 受け取る。受け取れるようになったら「受け取る」を押します。お金は自分のオンチェーンウォレットに入ります。
6. その後
   • 外部のウォレットへ送る: 設定 →「デバッグ」のコマンドで、オンチェーン残高から送ります。
   • Ark へ戻す: Ark サーバーが動いていれば、自動チャージをオンに戻すと Ark 残高へ移ります。

7. できないこと