Authenticate Wallet
VerifiedSign in to the wallet. Use when you or the user want to log in, sign in, connect, or set up the wallet, or when any wallet operation fails with authentication or "not signed in" errors. This skill is a prerequisite before sending, trading, or funding.
$ Add to .claude/skills/ About This Skill
# 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
```bash npx awal@latest auth login <email> ```
This sends a 6-digit verification code to the email and outputs a `flowId`.
Step 2: Verify OTP
```bash npx awal@latest 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.
Checking Authentication Status
```bash npx awal@latest status ```
Displays wallet server health and authentication status including wallet address.
Example Session
```bash # Check current status npx awal@latest status
# Start login (sends OTP to email) npx awal@latest auth login [email protected] # Output: flowId: abc123...
# After user receives code, verify npx awal@latest auth verify abc123 123456
# Confirm authentication npx awal@latest status ```
Available CLI Commands
| Command | Purpose | | -------------------------------------------- | -------------------------------------- | | `npx awal@latest status` | Check server health and auth status | | `npx awal@latest auth login <email>` | Send OTP code to email, returns flowId | | `npx awal@latest auth verify <flowId> <otp>` | Complete authentication with OTP code | | `npx awal@latest balance` | Get USDC wallet balance | | `npx awal@latest address` | Get wallet address | | `npx awal@latest show` | Open the wallet companion window |
JSON Output
All commands support `--json` for machine-readable output:
```bash npx awal@latest status --json npx awal@latest auth login [email protected] --json npx awal@latest auth verify <flowId> <otp> --json ```
Use Cases
- Authenticate a USDC payments wallet before sending or trading crypto
- Check wallet balance and address after signing in via email OTP
- Recover from 'not signed in' errors during automated wallet operations
- Open the wallet companion window for visual transaction monitoring
- Verify authentication status before executing a sequence of financial transactions
Pros & Cons
Pros
- +Simple two-step OTP flow that agents can complete autonomously if they have email access
- +Supports --json output for reliable machine-parseable responses
- +Session persists across CLI calls so re-authentication is rarely needed
Cons
- -Requires human to provide OTP code if the agent cannot access the user's email
- -Wallet functionality is limited to USDC — no multi-currency support
- -CLI runs via npx on every invocation which adds cold-start latency
FAQ
What does Authenticate Wallet do?
What platforms support Authenticate Wallet?
What are the use cases for Authenticate Wallet?
100+ free AI tools
Writing, PDF, image, and developer tools — all in your browser.
Next Step
Use the skill detail page to evaluate fit and install steps. For a direct browser workflow, move into a focused tool route instead of staying in broader support surfaces.