Skip to content

internet-court/internet-court-skill / vendored/coinbase/agentic-wallet

agentic-wallet

Verified

Crypto wallet operations via the awal CLI — sign in, check balances, send USDC/ETH/POL/SOL, trade tokens, fund the wallet, and use the x402 payment protocol to discover paid services, pay for API calls, monetize an API, or query onchain data. Use whenever the user mentions signing in, login, authentication, wallet status, balance, address, sending money, paying someone, transferring tokens, ENS names, swapping/trading/converting tokens, funding/topping up/onramp, USDC, ETH, POL, SOL, the x402 bazaar, paid APIs, monetizing an endpoint, or querying onchain data on Base.

FileKindSize
LICENSEother1.0 KB
SKILL.mdskill md3.9 KB
references/auth.mdmarkdown3.9 KB
references/balance.mdmarkdown12.8 KB
references/fund.mdmarkdown1.9 KB
references/query-onchain.mdmarkdown8.2 KB
references/send-usdc.mdmarkdown4.1 KB
references/trade.mdmarkdown4.3 KB
references/x402-monetize.mdmarkdown11.1 KB
references/x402-pay.mdmarkdown2.8 KB
references/x402-search.mdmarkdown3.2 KB

references/auth.md

View on GitHub
# Authenticating with the Agentic Wallet

When the wallet is not signed in (detected via `npx awal@2.12.1 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.12.1 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

```bash
npx awal@2.12.1 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

```bash
npx awal@2.12.1 status
```

Displays wallet server health and authentication status including wallet address.

## Example Session

```bash
# Check current status
npx awal@2.12.1 status

# Start login (sends OTP to email)
npx awal@2.12.1 auth login user@example.com
# Output: "Verification code sent!" (flowId only printed with --json)

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

# Confirm authentication
npx awal@2.12.1 status
```

## Signing Out

Sign-out is scriptable via the `logout` command, which clears the authenticated session:

```bash
npx awal@2.12.1 auth logout
```

`npx awal@2.12.1 logout` is an equivalent top-level alias. Both support `--json`.

When the user asks to log out, sign out, disconnect, or switch accounts:

1. Run `npx awal@2.12.1 auth logout` to clear the session.
2. Confirm the result with `npx awal@2.12.1 status` — once logged out, the status will report the wallet as not authenticated.

After sign-out, the locally cached `flowId` is invalidated. To sign back in, restart the flow with `npx awal@2.12.1 auth login <email>`.

## Available CLI Commands

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

## JSON Output

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

```bash
npx awal@2.12.1 status --json
npx awal@2.12.1 auth login user@example.com --json
npx awal@2.12.1 auth verify <otp> --json
```
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexUnverifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall