jaw-sdk-best-practices

JAW SDK のベストプラクティス

プログラム可能な権限を備えた、EVM チェーン上のパスキー認証スマートアカウントで JAW SDK を使用してアプリケーションを構築するためのガイドです。

使用する場面

次の場合に、これらのガイドラインを参照してください。

• @jaw.id/wagmi、@jaw.id/core、または @jaw.id/ui のインストールやセットアップ
• JAW コネクターまたはプロバイダーの設定（API キー、モード、ペイマスター、ENS）
• パスキー認証を使用したウォレットの接続／切断
• JAW スマートアカウントを介したトランザクションの送信（単一またはバッチ）
• メッセージまたは型付きデータへの署名（EIP-191、EIP-712、ERC-7871）
• 権限の付与、照会、取り消し（ERC-7715）
• サブスクリプション支払いまたは定期的な課金の実装
• ペイマスターを使用したガス代のスポンサー設定（ERC-7677）
• オンボーディング中のユーザーへの ENS サブネームの発行
• Sign-In With Ethereum（SIWE）の実装
• ヘッドレス統合、サーバーサイド操作、または AI エージェントウォレットの構築
• Account クラスの直接使用（UI なし）
• EIP-7702 を介した EOA のスマートアカウントへのアップグレード（既存のアドレスを維持）
• EIP-7702 用の埋め込みウォレットプロバイダー（Privy、Turnkey など）との統合
• ステーブルコイン決済フロー（USDC によるガス代、バッチ払い）の構築
• CrossPlatform と AppSpecific の認証モードの選択
• AppSpecific モード用のカスタム UI ハンドラーの実装
• パスキー認証スマートアカウントを使用した React Native／Expo アプリの構築
• JAW SDK を使用するコードのレビューやデバッグ

主な事実

• パッケージ： @jaw.id/wagmi（React）、@jaw.id/core（バニラ JS／サーバー）、@jaw.id/ui（AppSpecific モードの UI）
• API キー： 必須です。https://dashboard.jaw.id で取得してください。
• EIP-1193 互換： MetaMask や任意のウォレットとそのまま置き換えられます。
• スマートアカウント： パスキー署名者、ガス代不要のトランザクション、バッチ操作、権限を備えた ERC-4337
• EIP-7702： Account.fromLocalAccount(config, localAccount, { eip7702: true }) を使用すると、EOA はアドレスを維持したままスマートアカウントにアップグレードできます。
• EntryPoint： v0.8 のみ（ペイマスター用）

ルール一覧

1. セットアップと設定

• <rules/installation.md> - パッケージのインストール、ピア依存関係、wagmi と core の選択
• <rules/configuration.md> - すべての設定オプション：apiKey、appName、ens、mode、paymasters、preference
• <rules/auth-modes.md> - CrossPlatform と AppSpecific の各モード、およびそれぞれの使い分け

2. Wagmi 統合（React）

• <rules/wagmi-setup.md> - Wagmi コネクターのセットアップ、プロバイダー、JAW で標準の wagmi フックを使用する方法
• <rules/connect-disconnect.md> - useConnect、useDisconnect、capabilities を使用した接続
• <rules/reown-appkit.md> - WagmiAdapter を介して既存の Reown AppKit プロジェクトに JAW を追加する方法

3. 基本操作

• <rules/transactions.md> - トランザクションの送信、バッチ呼び出し、ガス代の見積もり、ステータスの確認
• <rules/signing.md> - Personal sign、型付きデータ、統合型の wallet_sign、クロスチェーン署名

4. 権限と支払い

• <rules/permissions.md> - 権限の付与、照会、取り消し（ERC-7715）
• <rules/subscription-payments.md> - 権限を使用した定期的なサブスクリプション支払い
• <rules/stablecoin-payments.md> - ヘッドレス USDC 決済、バッチ払い、ERC-20 によるガス代

5. アイデンティティと認証

• <rules/ens-identity.md> - ENS サブネームの発行、プロフィールの解決、テキストレコード
• <rules/siwe.md> - Sign-In With Ethereum（SIWE）の実装
• <rules/gas-sponsoring.md> - ペイマスターのセットアップ、スポンサー方針、マルチチェーン設定

6. EIP-7702

• <rules/eip7702-upgrade.md> - EOA のスマートアカウントへのアップグレード、プロバイダー統合、認証署名

7. 高度なトピック

• <rules/account-api.md> - AI エージェント、サーバーサイド、埋め込みウォレット向けのヘッドレス Account クラス
• <rules/react-native.md> - React Native（Expo bare）：パスキーアダプター、ネイティブ依存関係、AASA／assetlinks、ストレージ
• <rules/custom-ui-handler.md> - AppSpecific モード用カスタム UIHandler の構築
• <rules/provider-api.md> - プロバイダーの RPC メソッドとパターンの直接参照

8. リファレンス

• <rules/error-handling.md> - EIP-1193 のエラーコード、一般的なエラー、デバッグ
• <rules/typescript-types.md> - 主要な TypeScript インターフェースと型のパターン

使用方法

詳しいガイダンスについては、各ルールファイルをお読みください。各ファイルには以下が記載されています。 正しい使用例、避けるべきよくある間違い、重要な要件。