Learn-skills.dev authenticate-wallet

Authenticate the fibx CLI wallet via email OTP (Privy) or private key import. Required before any wallet operation (balance, send, trade, aave).

install

source · Clone the upstream repo

git clone https://github.com/NeverSight/learn-skills.dev

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/NeverSight/learn-skills.dev "$T" && mkdir -p ~/.claude/skills && cp -r "$T/data/skills-md/ahmetenesdur/fibx-agentic-wallet-skills/authenticate-wallet" ~/.claude/skills/neversight-learn-skills-dev-authenticate-wallet-90337c && rm -rf "$T"

manifest: data/skills-md/ahmetenesdur/fibx-agentic-wallet-skills/authenticate-wallet/SKILL.md

source content

Wallet Authentication

Manage the authentication session for the

fibx

CLI. Supports two methods: email OTP (via Privy server wallets) and private key import (local wallet).

Prerequisites

No active session required — this skill creates one

Rules

For email login, NEVER ask the user for a private key.
For private key import, ALWAYS warn the user first: "Your private key will be stored locally in an encrypted session file. Shall I proceed?"
You MUST complete
```
auth login
```
before
```
auth verify
```
. They are sequential steps.
After successful
```
auth verify
```
or
```
auth import
```
, ALWAYS run
```
npx fibx@latest status
```
to confirm the session is active.
NEVER store or log private keys, OTP codes, or session tokens in conversation history.

Commands

Email OTP Login (2-step)

# Step 1: Send OTP to email
npx fibx@latest auth login <email>

# Step 2: Verify OTP code
npx fibx@latest auth verify <email> <code>

Private Key Import

npx fibx@latest auth import

INTERACTIVE COMMAND: This opens a prompt for the user to paste their private key. The agent CANNOT pass the key as a CLI argument. Instruct the user to enter it in the terminal prompt, or run it via the agent's terminal tool and let the user type the key.

Session Management

# Check current session status
npx fibx@latest status

# End session
npx fibx@latest auth logout

Parameters

Parameter	Type	Description	Required
`email`	string	User's email address	Yes (email OTP)
`code`	string	One-time password received via email	Yes (verify step)

Examples

User: "Log me in with user@example.com"

npx fibx@latest auth login user@example.com
# Wait for user to provide the OTP code (e.g. "123456")
npx fibx@latest auth verify user@example.com 123456
npx fibx@latest status

User: "Import my private key"

# Warn user first, then:
npx fibx@latest auth import
npx fibx@latest status

User: "Log me out"

npx fibx@latest auth logout

Error Handling

Error	Action
`Invalid code`	Ask the user to check their email and retry `verify` .
`Rate limit`	Wait 60 seconds before retrying.
`Session expired`	Restart from `auth login` .
`Not authenticated`	Run the full login flow before other skills.