Authenticating with the Agentic Wallet

When the wallet is not signed in (detected via npx awal@2.10.0 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.10.0 auth login <email>

This sends a 6-digit verification code to the email. The flowId is saved automatically; it is only printed to stdout when --json is passed.

Step 2: Verify OTP

npx awal@2.10.0 auth verify <otp>

Use the 6-digit code from the user's email to complete authentication. The flow ID from step 1 is saved automatically to a local file — you do not pass it as an argument. 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.