authenticate-wallet

Q: How do I install authenticate-wallet?

Run npx skills add https://github.com/coinbase/agentic-wallet-skills --skill authenticate-wallet in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/authenticate-wallet/ (personal) or .claude/skills/authenticate-wallet/ (project).

by coinbase OfficialAI & Agents

Sign 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.

Installs: 2.4K
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/coinbase/agentic-wallet-skills --skill authenticate-wallet

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads authenticate-wallet automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Authenticating with the Agentic 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.10.0 auth login <email>

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

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.

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.
otp: Must be exactly 6 digits (^\d{6}$).

Do not pass unvalidated user input into the command.

Checking Authentication Status

npx awal@2.10.0 status

Displays wallet server health and authentication status including wallet address.

Example Session

# Check current status
npx awal@2.10.0 status

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

# After user receives code, verify (flow ID saved automatically)
npx awal@2.10.0 auth verify 123456

# Confirm authentication
npx awal@2.10.0 status

Available CLI Commands

Command	Purpose
`npx awal@2.10.0 status`	Check server health and auth status
`npx awal@2.10.0 auth login <email>`	Send OTP code to email, returns flowId
`npx awal@2.10.0 auth verify <otp>`	Complete authentication with OTP code
`npx awal@2.10.0 balance`	Get balances across Base, Polygon, and Solana (use `--chain` for a single chain)
`npx awal@2.10.0 address`	Get wallet address
`npx awal@2.10.0 show`	Open the wallet companion window

JSON Output

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

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

FAQ

What does the authenticate-wallet skill do?

How do I install authenticate-wallet?

Run npx skills add https://github.com/coinbase/agentic-wallet-skills --skill authenticate-wallet in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/authenticate-wallet/ (personal) or .claude/skills/authenticate-wallet/ (project).

Which AI agents can use authenticate-wallet?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is authenticate-wallet safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains authenticate-wallet?

It is published by coinbase in coinbase/agentic-wallet-skills, and it is an official skill from the maker of the technology it covers. It has 2,438 recorded installs.