---
id: ssh2-authenticate-wallet
name: "authenticate-wallet"
url: https://skills.yangsir.net/skill/ssh2-authenticate-wallet
author: coinbase
domain: web3
tags: ["web3-authentication", "crypto-wallets", "blockchain-identity", "oauth", "decentralized-apps-(dapps)"]
install_count: 2400
rating: 4.30 (36 reviews)
github: https://github.com/coinbase/agentic-wallet-skills
---

# authenticate-wallet

> 用于用户或系统登录数字钱包。此功能确保安全认证，以便进行区块链交互或访问Web3应用。

**Stats**: 2,400 installs · 4.3/5 (36 reviews)

## Before / After 对比

### 简化Web3钱包认证，提升用户登录体验

## Readme

# 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@2.0.3 auth login <email>
```

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

### Step 2: Verify OTP

```bash
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

```bash
npx awal@2.0.3 status
```

Displays wallet server health and authentication status including wallet address.

## Example Session

```bash
# 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

| Command                                      | Purpose                                |
| -------------------------------------------- | -------------------------------------- |
| `npx awal@2.0.3 status`                     | Check server health and auth status    |
| `npx awal@2.0.3 auth login <email>`         | Send OTP code to email, returns flowId |
| `npx awal@2.0.3 auth verify <flowId> <otp>` | Complete authentication with OTP code  |
| `npx awal@2.0.3 balance`                    | Get USDC wallet balance                |
| `npx awal@2.0.3 address`                    | Get wallet address                     |
| `npx awal@2.0.3 show`                       | Open the wallet companion window       |

## JSON Output

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

```bash
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
```


---
*Source: https://skills.yangsir.net/skill/ssh2-authenticate-wallet*
*Markdown mirror: https://skills.yangsir.net/api/skill/ssh2-authenticate-wallet/markdown*