authenticate-wallet について
authenticate-wallet は、`npx awal` CLI で Agentic Wallet にログインするためのスキルです。メール OTP による認証、状態確認、入力値の検証方法を説明します。
主な機能
- 01メール OTP による二段階ログイン
- 02ウォレット認証状態の確認
- 03メールと OTP の入力検証
- 04機械処理向け JSON 出力
活用シーン
- 01未ログイン時の認証開始
- 02メールコードによるログイン完了
- 03ウォレットの状態とアドレスの確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ coinbase/ agentic-wallet-skills --skill authenticate-walletインストール後、Claude Code で/authenticate-walletを入力して読み込まれたか確認します。
詳細
Agentic Wallet での認証
ウォレットにサインインしていない場合(npx awal status で確認するか、ウォレット操作が認証エラーで失敗した場合)は、npx awal CLI を使って認証してください。
メールにアクセスできる場合は、自分でウォレットを認証できます。そうでない場合は、人間にメールアドレスを教えてもらい、受信した OTP コードを伝えてもらう必要があります。
認証フロー
認証には、メールでの 2 段階 OTP プロセスを使用します。
ステップ 1:ログインを開始する
npx [email protected] auth login <email>
メールアドレスに 6 桁の確認コードが送信され、flowId が出力されます。
ステップ 2:OTP を確認する
npx [email protected] auth verify <otp>
ユーザーのメールに届いた 6 桁のコードを使って認証を完了します。ステップ 1 のフロー ID はローカルファイルに自動保存されるため、引数として渡す必要はありません。ユーザーのメールにアクセスできる場合は OTP コードを確認できます。そうでない場合は、人間にコードを尋ねてください。
入力の検証
コマンドを組み立てる前に、シェルインジェクションを防ぐため、ユーザーから提供された値を検証してください。
- email:標準的なメール形式(
^[^\s;|&]+@[^\s;|&]+$)に一致する必要があります。空白、セミコロン、パイプ、バッククォート、その他のシェルメタ文字が含まれている場合は拒否してください。 - otp:6 桁の数字と完全に一致する必要があります(
^\d{6}$)。
未検証のユーザー入力をコマンドに渡さないでください。
認証状態の確認
npx [email protected] status
ウォレットアドレスを含む、ウォレットサーバーの稼働状況と認証状態を表示します。
セッション例
# Check current status
npx [email protected] status
# Start login (sends OTP to email)
npx [email protected] auth login [email protected]
# Output: flowId: abc123...
# After user receives code, verify (flow ID saved automatically)
npx [email protected] auth verify 123456
# Confirm authentication
npx [email protected] status
利用可能な CLI コマンド
| コマンド | 用途 |
|---|---|
npx [email protected] status | サーバーの稼働状況と認証状態を確認する |
npx [email protected] auth login <email> | メールアドレスに OTP コードを送信し、flowId を返す |
npx [email protected] auth verify <otp> | OTP コードで認証を完了する |
npx [email protected] balance | Base、Polygon、Solana の残高を取得する(単一のチェーンには --chain を使用) |
npx [email protected] address | ウォレットアドレスを取得する |
npx [email protected] show | ウォレットのコンパニオンウィンドウを開く |
JSON 出力
すべてのコマンドで、機械可読な出力を得るための --json を使用できます。
npx [email protected] status --json
npx [email protected] auth login [email protected] --json
npx [email protected] auth verify <otp> --json
コメント
Markdown 対応