Authenticate Wallet

What This Skill Does

• This skill authenticates the Payments Wallet using the npx awal CLI
• It guides the user through a two-step email OTP process, including initiating login and verifying the OTP
• This skill is essential for any agent interacting with the Payments Wallet that requires authentication.

When to Use

• Wallet is not signed in
• Wallet operations fail with authentication errors
• Initiate login with email
• Verify OTP code received via email
• Check wallet authentication status
• Recover access to a wallet.

Key Features

• Uses a two-step email OTP process for authentication
• Validates user-provided values to prevent shell injection
• Provides clear instructions for initiating login and verifying OTP
• Offers a command to check the current authentication status
• Supports email-based authentication
• Provides example session for clarity.

Authenticating with the Payments Wallet

When the wallet is not signed in (detected via npx awal status or when wallet operations fail with authentication errors), use the npx awal CLI to authenticate.

If you have access to email, you can authenticate the wallet yourself, otherwise you'll need to ask your human to give you an email address and to tell you the OTP code they receive.

Authentication Flow

Authentication uses a two-step email OTP process:

Step 1: Initiate login

npx awal@2.0.3 auth login <email>

This sends a 6-digit verification code to the email and outputs a flowId.

Step 2: Verify OTP

npx awal@2.0.3 auth verify <flowId> <otp>

• Use the flowId from step 1 and the 6-digit code from the user's email to complete authentication
• If you have the ability to access the user's email, you can read the OTP code, or you can ask your human for the code.

Input Validation

Before constructing the command, validate all user-provided values to prevent shell injection:

• email: Must match a standard email format (^[^\s;|&]+@[^\s;|&]+$)
• Reject if it contains spaces, semicolons, pipes, backticks, or other shell metacharacters. flowId: Must be alphanumeric (^[a-zA-Z0-9_-]+$). otp: Must be exactly 6 digits (^\d{6}$).

Do not pass unvalidated user input into the command.

Checking Authentication Status

npx awal@2.0.3 status

Displays wallet server health and authentication status including wallet address.

Example Session

Check current status

npx awal@2.0.3 status

Start login (sends OTP to email) npx awal@2.0.3 auth login user@example.com Output: flowId: abc123...

After user receives code, verify npx awal@2.0.3 auth verify abc123 123456

Confirm authentication npx awal@2.0.3 status

Available CLI Commands

JSON Output

All commands support --json for machine-readable output:

npx awal@2.0.3 status --json npx awal@2.0.3 auth login user@example.com --json npx awal@2.0.3 auth verify <flowId> <otp> --jsonAuthenticating with the Payments Wallet

When the wallet is not signed in (detected via npx awal status or when wallet operations fail with authentication errors), use the npx awal CLI to authenticate.

If you have access to email, you can authenticate the wallet yourself, otherwise you'll need to ask your human to give you an email address and to tell you the OTP code they receive.

Authentication Flow

Authentication uses a two-step email OTP process:

Step 1: Initiate login

npx awal@2.0.3 auth login <email>

This sends a 6-digit verification code to the email and outputs a flowId.

Step 2: Verify OTP

npx awal@2.0.3 auth verify <flowId> <otp>

• Use the flowId from step 1 and the 6-digit code from the user's email to complete authentication
• If you have the ability to access the user's email, you can read the OTP code, or you can ask your human for the code.

Input Validation

Before constructing the command, validate all user-provided values to prevent shell injection:

• email: Must match a standard email format (^[^\s;|&]+@[^\s;|&]+$)
• Reject if it contains spaces, semicolons, pipes, backticks, or other shell metacharacters. flowId: Must be alphanumeric (^[a-zA-Z0-9_-]+$). otp: Must be exactly 6 digits (^\d{6}$).

Do not pass unvalidated user input into the command.

Checking Authentication Status

npx awal@2.0.3 status

Displays wallet server health and authentication status including wallet address.

Example Session

Check current status

npx awal@2.0.3 status

Start login (sends OTP to email) npx awal@2.0.3 auth login user@example.com Output: flowId: abc123...

After user receives code, verify npx awal@2.0.3 auth verify abc123 123456

Confirm authentication npx awal@2.0.3 status

Available CLI Commands

JSON Output

All commands support --json for machine-readable output:

npx awal@2.0.3 status --json npx awal@2.0.3 auth login user@example.com --json npx awal@2.0.3 auth verify <flowId> <otp> --json