pop-pay

Point One Percent — pop-pay

ウォレットを空にするのに必要なのは、たった0.1%の幻覚だけです。100%の残高が消えてしまいます。

AI エージェントによるコマースのランタイムセキュリティレイヤーです。すぐに使える CLI と MCP サーバーを提供します。カード認証情報は CDP を介してブラウザーの DOM に直接注入されるため、エージェントのコンテキストウィンドウに入ることはありません。エージェントから見えないウォレットを、たった一つの幻覚プロンプトで空にすることはできません。

📄 研究データセットと再現 — このリポジトリでは、「The Illusion of Single-Attacker Rankings」 のオープンデータセットと再現用ハーネスを公開しています。研究については、研究データセットと再現をご覧ください。

インストール

お好みの方法を選択してください。

brew install 100xpercent/tap/pop-pay

curl -fsSL https://raw.githubusercontent.com/100xPercent/pop-pay/main/install.sh | sh

npm install -g pop-pay

npx -y pop-pay <command>

どの方法でインストールしても、同じバイナリ（pop-pay、pop-launch、pop-init-vault、pop-unlock）が利用できます。

@100xpercent/mcp-server-pop-pay としても利用できます。MCP の @scope/mcp-server-<name> 規約に準拠した同一パッケージです。リリースごとに同じバージョンが適用されます。

Python をお使いですか？ pop-pay-python をご覧ください。pip install pop-pay でインストールできます。同じセキュリティモデルと同じボールト形式を採用しており、リリースサイクルは独立しているため、ランタイムを安全に切り替えられます。

クイックスタート（CLI）

1. 暗号化された認証情報ボールトを初期化する

pop-pay init-vault

カード認証情報は暗号化され、~/.config/pop-pay/vault.enc に保存されます（AES-256-GCM）。より強力な保護が必要な場合（シェルアクセス権を持つエージェントをブロックする場合）は、次を実行してください。

pop-pay init-vault --passphrase   # one-time setup
pop-pay unlock                     # run once per session

2. CDP リモートデバッグを有効にして Chrome を起動する

pop-pay launch

これにより、pop-pay が認証情報を注入する Chromium インスタンスが http://localhost:9222 で開きます。エージェントは MCP、ブラウザー自動化、または x402 を介してチェックアウトのフローを進めます。カード情報がブラウザープロセスの外に出ることはありません。

3. エージェントに接続する

CLI はインフラストラクチャを起動します。実際の決済ツール呼び出しはエージェントが行います。次の 2 つの方法に対応しています。

• MCP サーバー — pop-pay を、MCP 対応の任意のクライアント（Claude Code、Cursor、Windsurf、OpenClaw）に追加します。以下の MCP サーバー（任意）をご覧ください。
• x402 HTTP — x402 決済プロトコルを介して API 呼び出しの料金を支払います。

CLI の全リファレンス：pop-pay --help。

MCP サーバー（任意）

MCP クライアントに追加

MCP 対応クライアントで使用できる標準設定：

{
  "mcpServers": {
    "pop-pay": {
      "command": "npx",
      "args": ["-y", "pop-pay", "launch-mcp"],
      "env": {
        "POP_CDP_URL": "http://localhost:9222"
      }
    }
  }
}

claude mcp add --scope user pop-pay -- npx -y pop-pay launch-mcp

openclaw mcp add pop-pay -- npx -y pop-pay launch-mcp

docker-compose up -d

MCP ツール

Claude Code ユーザーへのヒント： エージェントが pop-pay を呼び出すタイミングを判断できるよう、次の内容をプロジェクトの CLAUDE.md に追加してください。 「支払いフォームまたはチェックアウトページが表示されたら、request_virtual_card ツールを使用してください。請求先／連絡先情報のフォームでは、まず request_purchaser_info を使用してください。」

設定

主要な変数は ~/.config/pop-pay/.env にあります。全項目については、ENV_REFERENCE.md を参照してください。

ガードレールモード

LLM モードを有効にするには、Integration Guide §1を参照してください。

プロバイダー

優先順位： Stripe Issuing → BYOC Local → Mock。

セキュリティ

STRIDE 分析の詳細はTHREAT_MODEL.md、エンタープライズ向けの詳細はCOMPLIANCE_FAQ.mdを参照してください。

アーキテクチャ

• TypeScript — MCP サーバー、CDP 注入エンジン、ガードレール、CLI
• Rust（napi-rs） — XOR 分割ソルトの保存、scrypt 鍵導出を担うネイティブセキュリティレイヤー
• Node.js crypto — AES-256-GCM によるボールトの暗号化（OpenSSL バインディング）
• Chrome DevTools Protocol — 生の WebSocket による直接的な DOM 注入

ドキュメント

• 脅威モデル — STRIDE 分析、5 つのセキュリティプリミティブ、10 の攻撃シナリオ
• ガードレールのベンチマーク — 585 件のペイロード、11 の攻撃カテゴリを対象としたモデル横断評価（Anthropic / OpenAI / Gemini）
• コンプライアンス FAQ — PCI DSS、SOC 2、GDPR の詳細
• 環境変数リファレンス — すべての POP_* 環境変数
• 統合ガイド — Claude Code、Node.js SDK、ブラウザーエージェントのセットアップ
• カテゴリのクックブック — POP_ALLOWED_CATEGORIES のパターンと例

研究データセットと再現方法

このリポジトリでは、対応する研究論文で説明されているベンダー横断の攻撃者安定性手法のための、オープンソースのデータセットとハーネスを公開しています。査読者・研究者向けの再現用アーティファクト：

• コーパス（585 件の攻撃ペイロード、11 カテゴリ）：tests/redteam/corpus/
  • attacks.json — カテゴリラベル付きの全ペイロードセット
  • GENERATION.md — コーパス生成プロトコル
  • schema.json — ペイロードのスキーマ
• 実行 JSONL（26,325 行、9 モデル × 585 ペイロード × N=5）：tests/redteam/runs/
  • PRIMARY ホワイトボックス・フィードバックなしの実行：runs/adaptive/2026-04-28T19-50-*
  • 固定パネルの実行：runs/static/
  • プロンプト除去テスト（v3 / strict / paranoid）：runs/ablation/
• マニフェストハッシュ：tests/redteam/runs/MANIFEST.sha256 — すべてのアーティファクトのバイト単位の完全性
• Croissant 1.0 メタデータ（Core + RAI フィールド）：paper-artifacts/croissant.json
• 再現スクリプト（JSONL から論文の表・図を再生成）：
  • python3 paper-artifacts/gen-tables.py --table all — Tab.~bypassk / threat-ablation / cross-vendor
  • python3 paper-artifacts/gen-taxonomy-map.py — Fig.~taxonomy-map
• ライセンス：コーパスは CC BY-SA 4.0、ハーネスは MIT です。

データセットのスキーマ、統計手法（ブートストラップ CI、Holm-Bonferroni、McNemar）、最初からの完全な再収集手順、JSONL 行データ辞書、責任ある情報開示ポリシーについては、**docs/PAPER_REPRODUCTION.md**を参照してください。

ライセンス

MIT