クイックスタート

ZeroDev プロジェクト、オーナー秘密鍵、Polygon Amoy 用の JPYC ファセットさえあれば、kawasekit でエージェントが JPYC を Polygon Amoy 上で決済するところまで 10 分以内に辿り着けます。

このウォークスルーは動く構成までの最短ルートです。より深いサンプル (エージェントペイウォール、観測性) は同じプリミティブの上に積まれています。

前提

Node 22+
pnpm 11+
使い捨ての Ethereum 秘密鍵 — testnet 用に新規生成してください。実資金を持つオーナーキーは絶対に使わないこと
ZeroDev のプロジェクト ID
Polygon Amoy POL (公式ファセット)
Polygon Amoy JPYC (JPYC ファセット)

手順

リポジトリをクローン

git clone https://github.com/k0yote/kawasekit
cd kawasekit
pnpm install
pnpm --filter kawasekit build

.env をスキャフォールド
Terminal window
```
pnpm cli init
cp .env.example .env
```
.env を開き、OWNER_PRIVATE_KEY (使い捨て鍵) と ZERODEV_PROJECT_ID を埋めてください。
スマートアカウントアドレスを計算
Terminal window
```
pnpm cli account create --chain polygonAmoy
```
以下のような出力が出ます:
```
Chain:                  Polygon Amoy testnet (80002)
Owner (EOA):            0x2f5eb6A1...
Smart account address:  0xdbe30607...
```
この時点ではスマートアカウントは counterfactual アドレスです — オーナーキーから決定論的に導出されますが、まだオンチェーンに deploy されていません。最初の UserOp が paymaster 経由で deploy します。
スマートアカウントへ JPYC を入金

ステップ 3 のスマートアカウントアドレス宛に Polygon Amoy JPYC を送金:
- https://faucet.jpyc.co.jp/
このチュートリアルでは 1 JPYC あれば十分です。
セッションキーを発行

セッションキーはエージェントが保持するキーです。オーナーが revocation を制御し、セッションキーはオンチェーンの daily-limit ポリシーで制限されます。
Terminal window
```
pnpm cli session-key issue \
  --chain polygonAmoy \
  --ephemeral-session \
  --max-per-tx 1 \
  --max-per-day 10 \
  --output envelope.json
```
--ephemeral-session を付けると、この実行用に session-key 秘密鍵を新規生成します。秘密鍵はコマンドの最後に表示されます — 必要ならその場で保存してください (ディスクには保存されません)。
スマートアカウント経由で JPYC を送金

オーナーはスマートアカウント経由で直接 JPYC を送金できます (session-key を使うフローはエージェント example にあります):
Terminal window
```
pnpm cli transfer \
  --chain polygonAmoy \
  --amount 0.001
```
bundler tx hash と Polygonscan のリンクが出力されます。リンクを開いて、kawasekit 経由の初の JPYC 送金が Polygon Amoy で確定する様子を確認してください。

いま何が起きたか

kawasekit cli account create はオーナーキーから Kernel v3.1 スマートアカウントを counterfactual に導出しました。オンチェーンへの書き込みはまだ無し。
kawasekit cli session-key issue は session-key envelope (エージェントがオーナーキーを見ずにスマートアカウントクライアントを復元するための可搬な JSON ドキュメント) を作成しました。
kawasekit cli transfer はスマートアカウントから JPYC.transfer() を呼ぶ sponsored UserOp をブロードキャストしました。ガスは ZeroDev の paymaster が POL で支払っています。

同じプリミティブが以下に組み合わさります:

x402 ペイウォール — エージェントペイウォールを参照。
観測性 — kawasekit/observability/prometheus を任意の kawasekit surface に配線するとダッシュボードが埋まります。観測性を参照。

次のステップ

エージェントペイウォール example を試す — エージェントが天気 API をコール単位で支払うデモ。
CLI リファレンスで全コマンドを確認。
mainnet 移行前に脅威モデルを読む。

mainnet への移行

ネットワークに触れるコマンドは --chain polygonAmoy (testnet) か --chain polygon (mainnet) を取ります。mainnet ブロードキャストはさらに KAWASEKIT_ALLOW_MAINNET=1 を環境変数に設定する必要があります。実 JPYC + 実 POL を消費する意図があるときだけ設定してください。スケール前に 0.001 JPYC で gradual rollout する想定です。

v0.1.0 リリースノートには初の mainnet ブロードキャスト tx URL がトレーサビリティのために記録される予定です。