proof-of-strike 0.1.0

package/README.md

@@ -0,0 +1,68 @@
+# proof-of-strike —— 一撃の証明
+
+毎週ひとつだけ現れる世界共通のモンスターを、HTTP 402 だけで殴り倒す協力型ゲーム。
+
+**攻撃力は掘ったハッシュの深さと、ウォレットが積んだ年月で決まる。払った額では強くならない。**
+
+```bash
+npx proof-of-strike init    # 財布を用意する（初回だけ）
+npx proof-of-strike play    # 敵を見て、掘って、殴る
+```
+
+覚える命令はこの二つだけ。`play` が今週の敵を出し、攻撃するか訊き、
+在庫が無ければ掘り、署名して殴り、結果まで出す。
+
+決済は **Base Sepolia のテスト USDC**（一撃 0.0001）。金銭的価値はなく、額そのものに意味もない。
+
+## 仕組み
+
+EIP-3009 の `authorization nonce` は、支払者が自由に決められて、チェーンに永久に残り、
+誰も見ていない32バイト。そこに proof-of-work を書き込む。
+
+```
+depth = sha256("atk:v1" ‖ weekSeed ‖ chainId ‖ payer ‖ nonce) の先頭ゼロビット数
+dmg   = ⌊100 × depth² × 属性 × crit × (1−DEF/100) × levelMul × 0.9^(n−1)⌋
+```
+
+掘るほど強いが効果は**対数**。GPU 農場と数秒だけ掘った人の差は 4.3 倍しかつかない。
+
+## 一段ずつ回す
+
+`play` は下の命令を順に呼んでいるだけで、中で別のことはしていない。
+
+```bash
+boss                        # 今週の戦況（引数なしで戦闘画面）
+boss grind                  # nonce を掘る（1本掘れたら終わり）
+boss grind --for 10m        # 時間を使い切って、より深いものを狙う
+boss grind --element VOID   # 弱点を狙う。当たれば2倍、当たりは1/6
+boss stash                  # 掘り溜めた在庫
+boss attack                 # いちばん深いもので殴る
+boss replay 2026-W35        # チェーンから週を再現する
+```
+
+## 鍵の置き場
+
+`init` は `~/.boss/key` に 0600 で置く。**Base Sepolia のテストネット専用**で、
+本物の資産を持つ財布の鍵を置く用途は想定していない。
+
+環境変数 `STRIKE_PRIVATE_KEY` があればそちらが優先で、ファイルは作らない。
+引数では渡せない —— シェルの履歴と `ps` に残るため。
+
+鍵を渡さずに署名する道もある。
+
+```bash
+boss attack --signer-cmd './my-signer'
+```
+
+EIP-712 の `domain` / `types` / `message` 一式を渡すので、署名器の側で組み直して照合できる。
+
+## 検証
+
+すべての攻撃は Base Sepolia の `AuthorizationUsed` として残る。
+仕様は https://proof-of-strike.com/spec に全部ある。**サーバーを見ずに週を再計算できる。**
+
+```bash
+boss replay 2026-W35
+```
+
+curl でも配っている: `curl -fsSL https://proof-of-strike.com/boss.mjs -o boss.mjs`