Authenticate Wallet
Manage authentication sessions for the StarkFi CLI. StarkFi uses a remote Auth Server with Privy TEE for email-based one-time password (OTP) authentication. A valid session is required before any transactional skill can operate.
Prerequisites
- The StarkFi Auth Server (
starkfi-server) must be running and accessible. - An email address the user has access to (for receiving OTP codes).
Authentication Flow
The login process is a two-step OTP flow:
- Initiate —
auth login <email>sends an OTP code to the email. - Verify —
auth verify <email> <code>completes authentication.
The agent CANNOT guess or auto-fill the OTP code — it must wait for the user to provide it after checking their email.
Rules
- ALWAYS run
npx starkfi@latest statusfirst to check if the user already has an active session. If they do, skip the login flow — just inform them. - After
auth login, you MUST wait for the user to provide their OTP code. Do NOT ask more than once; just say you're waiting. - After
auth verify, you MUST runnpx starkfi@latest statusto confirm the session is active. deployis idempotent — it's safe to run multiple times. It deploys the smart account contract on-chain if not already deployed.- If any other skill reports
Not authenticated, direct the user to this skill.
Commands
# Step 1: Send OTP to email
npx starkfi@latest auth login <email>
# Step 2: Verify OTP code
npx starkfi@latest auth verify <email> <code>
# Check session status
npx starkfi@latest status
# Display wallet address
npx starkfi@latest address
# Deploy smart account on-chain
npx starkfi@latest deploy
# End session
npx starkfi@latest auth logoutParameters
| Parameter | Type | Description | Required |
|---|---|---|---|
email | string | User's email address | Yes |
code | string | One-time password from email | Yes |
Examples
User: "Log me in with user@example.com"
npx starkfi@latest status
# If not authenticated:
npx starkfi@latest auth login user@example.com
# Wait for user to provide OTP code (e.g. "123456")
npx starkfi@latest auth verify user@example.com 123456
npx starkfi@latest statusUser: "What's my wallet address?"
npx starkfi@latest addressUser: "Deploy my account"
npx starkfi@latest deployUser: "Log me out"
npx starkfi@latest auth logoutError Handling
| Error | Action |
|---|---|
Invalid OTP code | Ask the user to check their email and retry auth verify. |
Session expired | Restart from auth login. |
Server unreachable | Ensure starkfi-server is running at the configured URL. |
Rate limit | Wait 60 seconds before retrying. |
Deployment failed | Check balance — send ETH/STRK to the address, or enable gasfree mode first. |
Insufficient balance | For deploy: npx starkfi@latest config set-gasfree on to bypass gas costs. |
Related Skills
- All other skills depend on this skill — if any reports
Not authenticated, use this. - Use
configto enable gasfree mode if the user can't afford deployment gas.