starkfi 0.1.0 → 0.3.0

package/README.md

@@ -1,83 +1,453 @@
-# StarkFi
+<p align="center">
+  <a href="https://starkfi.app">
+    <img src="docs/favicon.svg" alt="StarkFi Logo" width="100" height="100"/>
+  </a>
+</p>
 
-A minimalist command-line interface and AI Agent toolkit for DeFi operations on **Starknet**.
-Powered by [StarkZap](https://github.com/keep-starknet-strange/starkzap) SDK, [Fibrous](https://fibrous.finance) aggregation, and [AVNU](https://docs.avnu.fi) Paymaster.
+<h1 align="center">StarkFi</h1>
 
-## Overview
+<p align="center">
+  <strong>The Gas-Abstracted DeFi CLI & Agent.</strong><br>
+  <em>The AI-native DeFi toolkit for Starknet.</em><br>
+  A production-grade CLI and MCP server that gives both developers and AI agents full access to swaps, multi-swap, atomic batch transactions, staking, lending, portfolio management, and gasless transactions — all powered by the <a href="https://github.com/keep-starknet-strange/starkzap">Starkzap SDK</a>.
+</p>
 
-StarkFi provides a unified interface for Starknet interactions, designed for both human CLI usage and AI agent workflows (via MCP).
+```bash
+npx starkfi --help
+```
+
+---
+
+## Why StarkFi?
+
+Most DeFi tools are built for humans clicking buttons. StarkFi is built for **agents**.
+
+- 🤖 **27 MCP tools** — Any AI assistant (Cursor, Claude, Antigravity) can execute DeFi operations autonomously
+- ⚡ **Atomic Batching** — Combine swap + stake + lend + send into a single multicall transaction
+- 💸 **Gas Abstraction Built-In** — Pay gas in STRK, ETH, USDC, USDT, or DAI via AVNU Paymaster, or let the developer sponsor gas entirely (gasfree mode)
+- 📊 **Full Portfolio** — Unified view of balances, staking positions, and lending positions with USD values
+- 🧪 **Simulate Everything** — Dry-run any transaction to estimate fees before broadcasting
+
+---
+
+## Architecture
+
+```
+┌──────────────────────────────────────────────────────────────────────┐
+│                           StarkFi                                    │
+│                                                                      │
+│  ┌─────────────┐     ┌─────────────────────────────────────────┐     │
+│  │   CLI (25+   │     │         MCP Server (27 tools)           │     │
+│  │   commands)  │     │  AI agents connect via stdio transport  │     │
+│  └──────┬───────┘     └──────────────┬──────────────────────────┘     │
+│         │                            │                               │
+│         └────────────┬───────────────┘                               │
+│                      ▼                                               │
+│  ┌──────────────────────────────────────────────────────────────┐    │
+│  │                    Service Layer                              │    │
+│  │                                                               │    │
+│  │  ┌─────────┐  ┌─────────┐  ┌──────┐  ┌─────────┐           │    │
+│  │  │ Fibrous │  │ Staking │  │ Vesu │  │  Batch  │           │    │
+│  │  │  Swap   │  │Lifecycle│  │  V2  │  │Multicall│           │    │
+│  │  └────┬────┘  └────┬────┘  └──┬───┘  └────┬────┘           │    │
+│  │       │            │          │            │                 │    │
+│  │  ┌────┴────────────┴──────────┴────────────┴────┐           │    │
+│  │  │          Starkzap SDK (starkzap v1.0.0)       │           │    │
+│  │  │  Wallet · TxBuilder · Tokens · Paymaster      │           │    │
+│  │  └───────────────────┬───────────────────────────┘           │    │
+│  └──────────────────────┼───────────────────────────────────────┘    │
+│                         ▼                                            │
+│  ┌─────────────────────────────────────┐  ┌─────────────────────┐   │
+│  │  Auth Server (Hono + Privy TEE)     │  │  AVNU Paymaster     │   │
+│  │  Email OTP · Wallet · Sign · Gas    │  │  Gas Abstraction    │   │
+│  └─────────────────────────────────────┘  └─────────────────────┘   │
+└──────────────────────────────────────────────────────────────────────┘
+                              │
+                              ▼
+                    ┌──────────────────┐
+                    │  Starknet (L2)   │
+                    └──────────────────┘
+```
+
+---
+
+## Starkzap Modules Used
+
+StarkFi leverages **all core Starkzap modules**:
+
+| Module                               | Usage in StarkFi                                                                                           |
+| ------------------------------------ | ---------------------------------------------------------------------------------------------------------- |
+| **Wallets**                          | `PrivySigner` + `ArgentXV050Preset` for email-based wallet management via Privy TEE                        |
+| **Gasless Transactions (Paymaster)** | Paymaster integration with 5 gas tokens (STRK, ETH, USDC, USDT, DAI) + developer-sponsored gasfree mode    |
+| **Staking**                          | Multi-token staking lifecycle (STRK, WBTC, tBTC, SolvBTC, LBTC) — stake, claim, compound, unstake (2-step) |
+| **TxBuilder**                        | Atomic multicall batching — combine swap + stake + supply + send in one transaction                        |
+| **ERC-20 Tokens**                    | Token presets, balance queries, transfers, approvals                                                       |
+
+---
+
+## Features
+
+### 🔄 Intelligent Swap Routing (Fibrous)
+
+DEX-aggregated swaps with optimal routing. Single swaps, multi-swap (up to 3 pairs), and batch routing.
+
+```bash
+npx starkfi trade 100 USDC ETH --slippage 1
+npx starkfi multi-swap "100 USDC>ETH, 50 USDT>ETH"
+```
+
+### ⚛️ Atomic Transaction Batching
+
+Bundle multiple DeFi operations into a single Starknet multicall. Minimum 2 operations.
+
+```bash
+npx starkfi batch \
+  --swap "100 USDC ETH" \
+  --stake "50 STRK karnot" \
+  --supply "200 USDC Prime" \
+  --send "10 STRK 0xAddr"
+```
+
+### 🥩 Multi-Token Staking Lifecycle
+
+Full staking lifecycle across multiple validators with STRK, WBTC, tBTC, SolvBTC, and LBTC support.
+
+```bash
+npx starkfi stake 100 -v karnot
+npx starkfi rewards -v karnot --compound
+npx starkfi unstake intent -v karnot -a 50
+npx starkfi unstake exit -v karnot
+```
+
+### 🏦 Lending & Borrowing (Vesu V2)
+
+Supply collateral, borrow assets, monitor health factors, and atomically close positions.
+
+```bash
+npx starkfi lend-supply 100 -p Prime -t STRK
+npx starkfi lend-borrow -p Prime \
+  --collateral-amount 200 --collateral-token STRK \
+  --borrow-amount 50 --borrow-token USDC
+npx starkfi lend-status -p Prime --collateral-token STRK --borrow-token USDC
+npx starkfi lend-close -p Prime --collateral-token STRK --borrow-token USDC
+```
+
+### 💸 Gas Abstraction
+
+All transactions are gasless by default. Users pay gas fees in their preferred ERC-20 token via Paymaster.
+
+```bash
+# Pay gas in USDC instead of STRK
+npx starkfi config set-gas-token USDC
+
+# Developer pays all gas (gasfree mode)
+npx starkfi config set-gasfree on
+```
+
+| Mode                  | Who Pays  | Gas Tokens                 | Description                       |
+| --------------------- | --------- | -------------------------- | --------------------------------- |
+| **Gasless** (default) | User      | STRK, ETH, USDC, USDT, DAI | User pays in ERC-20 via Paymaster |
+| **Gasfree**           | Developer | —                          | Developer sponsors all gas        |
+
+### 🧪 Simulation / Dry-Run
+
+Estimate fees and validate any transaction before broadcasting.
+
+```bash
+npx starkfi trade 100 USDC ETH --simulate
+# → mode: SIMULATION, estimatedFee: 0.000142 ETH ($0.52), callCount: 4
+```
+
+### 📊 Portfolio Dashboard
+
+Consolidated view of all DeFi positions in one call.
+
+```bash
+npx starkfi portfolio
+# → Token Balances (USD), Staking Positions, Lending Positions, Total Value
+```
+
+---
+
+## AI Integration (MCP)
+
+StarkFi exposes **27 MCP tools** via stdio transport, enabling AI assistants to execute DeFi operations.
+
+```bash
+# Start the MCP server
+npx starkfi mcp-start
+```
+
+### Tool Categories
+
+| Category          | Tools                                                                                                                                          | Count |
+| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ----- |
+| **Auth & Config** | `get_auth_status`, `config_action`                                                                                                             | 2     |
+| **Wallet**        | `get_balance`, `get_portfolio`, `deploy_account`, `send_tokens`, `get_tx_status`                                                               | 5     |
+| **Trade**         | `get_swap_quote`, `swap_tokens`, `get_multi_swap_quote`, `multi_swap`, `batch_execute`                                                         | 5     |
+| **Staking**       | `list_validators`, `list_pools`, `get_staking_info`, `get_stake_status`, `stake_tokens`, `unstake_tokens`, `claim_rewards`, `compound_rewards` | 8     |
+| **Lending**       | `list_lending_pools`, `get_lending_position`, `supply_assets`, `withdraw_assets`, `borrow_assets`, `repay_debt`, `close_position`              | 7     |
+
+### Example — AI Agent Workflow
+
+```
+User: "Swap 100 USDC to STRK and stake half on Karnot"
+
+Agent:
+  1. get_swap_quote(amount: "100", from: "USDC", to: "STRK")   → 500 STRK
+  2. swap_tokens(amount: "100", from: "USDC", to: "STRK")       → txHash: 0x...
+  3. stake_tokens(amount: "250", validator: "karnot", token: "STRK") → txHash: 0x...
+```
+
+### MCP Configuration
 
-- **Optimal Trading:** Aggregated token swaps via Fibrous.
-- **Gas Abstraction:** Default (STRK), Gasfree (developer-sponsored), or Gasless (user pays in USDC/ETH).
-- **Staking Management:** Full lifecycle support for delegation pools (stake, compound, unstake).
-- **Lending & Borrowing:** Supply, withdraw, borrow, and repay via Vesu V2 lending protocol.
-- **AI Integration:** Built-in Model Context Protocol (MCP) server.
+Add to your AI assistant's MCP config (Cursor, Claude, etc.):
+
+```json
+{
+	"mcpServers": {
+		"starkfi": {
+			"command": "npx",
+			"args": ["-y", "starkfi", "mcp-start"]
+		}
+	}
+}
+```
+
+For the complete tool registry and schemas, see [MCP Documentation](MCP.md).
+
+---
+
+## Agent Skills
+
+StarkFi ships with **10 agent skills** — structured instruction sets that teach AI coding assistants how to use StarkFi without custom prompting.
+
+| Category         | Skills                                                       |
+| ---------------- | ------------------------------------------------------------ |
+| **Auth**         | `authenticate-wallet`                                        |
+| **Wallet Data**  | `balance`, `portfolio`                                       |
+| **Transactions** | `send`, `trade`, `multi-swap`, `batch`, `staking`, `lending` |
+| **Utility**      | `config`                                                     |
+
+```bash
+# Install skills for your AI assistant
+npx skills add ahmetenesdur/starkfi
+```
+
+See [Skills Documentation](skills/README.md) for details.
+
+---
 
 ## Quick Start
 
-### 1. Authentication
+### Prerequisites
+
+- **Node.js** v18+
+- **StarkFi Auth Server** running (required for Privy email OTP and Paymaster proxy)
+
+### 1. Authenticate
 
 ```bash
-# Via Email OTP (requires starkfi-server)
 npx starkfi auth login user@example.com
-npx starkfi auth verify user@example.com <code>
+npx starkfi auth verify user@example.com <OTP_CODE>
+```
+
+### 2. Deploy Account
 
-# Or via Private Key (local execution)
-npx starkfi auth import
+```bash
+npx starkfi deploy
 ```
 
-### 2. Core Commands
+### 3. Check Balance
 
 ```bash
-# Authentication & Wallet
-npx starkfi auth login <email>         # Email OTP login
-npx starkfi auth verify <email> <code> # Verify OTP
-npx starkfi auth import                # Import private key
-npx starkfi auth logout                # Clear session
-npx starkfi address                    # Show active address
-npx starkfi deploy                     # Deploy account on-chain
+npx starkfi balance
+```
+
+### 4. Start Trading
+
+```bash
+npx starkfi trade 10 STRK ETH --simulate    # Preview first
+npx starkfi trade 10 STRK ETH               # Execute
+```
+
+---
+
+## Command Reference
+
+### Session & Wallet
+
+| Command                                                   | Description                      |
+| --------------------------------------------------------- | -------------------------------- |
+| `auth login <email>`                                      | Start email OTP authentication   |
+| `auth verify <email> <code>`                              | Complete authentication          |
+| `auth logout`                                             | Terminate session                |
+| `status`                                                  | Check auth status and API health |
+| `address`                                                 | Display Starknet address         |
+| `deploy`                                                  | Deploy smart account on-chain    |
+| `balance [--token <symbol>] [--json]`                     | Query token balances             |
+| `send <amount> <token> <recipient> [--simulate] [--json]` | Transfer tokens                  |
+| `portfolio [--json]`                                      | Full DeFi portfolio              |
+
+### Trading (Fibrous)
+
+| Command                                                             | Description                 |
+| ------------------------------------------------------------------- | --------------------------- |
+| `trade <amount> <from> <to> [--slippage <%>] [--simulate] [--json]` | Swap tokens                 |
+| `multi-swap "<pairs>" [--slippage <%>] [--simulate] [--json]`       | Multi-pair swap (2-3 pairs) |
+
+### Batching (Multicall)
+
+| Command                                                                     | Description                  |
+| --------------------------------------------------------------------------- | ---------------------------- |
+| `batch [--simulate] --swap "..." --stake "..." --supply "..." --send "..."` | Atomic multicall (min 2 ops) |
+
+### Staking
+
+| Command                                                                       | Description            |
+| ----------------------------------------------------------------------------- | ---------------------- |
+| `validators [--json]`                                                         | List active validators |
+| `pools <validator> [--json]`                                                  | Show delegation pools  |
+| `stake <amount> --validator <name> [--token <symbol>] [--simulate]`           | Stake tokens           |
+| `stake-status [validator] [--json]`                                           | Staking dashboard      |
+| `rewards --validator <name> [--token <symbol>] <--claim\|--compound>`         | Manage rewards         |
+| `unstake <intent\|exit> --validator <name> [--token <symbol>] [--amount <n>]` | Unstake (2-step)       |
+
+### Lending (Vesu V2)
+
+| Command                                                                                                                        | Description               |
+| ------------------------------------------------------------------------------------------------------------------------------ | ------------------------- |
+| `lend-pools [name]`                                                                                                            | List lending pools        |
+| `lend-supply <amount> -p <pool> -t <token>`                                                                                    | Supply assets             |
+| `lend-withdraw <amount> -p <pool> -t <token>`                                                                                  | Withdraw assets           |
+| `lend-borrow -p <pool> --collateral-amount <n> --collateral-token <t> --borrow-amount <n> --borrow-token <t> [--use-supplied]` | Borrow                    |
+| `lend-repay <amount> -p <pool> -t <token> --collateral-token <t>`                                                              | Repay debt                |
+| `lend-status -p <pool> --collateral-token <t> [--borrow-token <t>]`                                                            | Position status           |
+| `lend-close -p <pool> --collateral-token <t> --borrow-token <t>`                                                               | Close position atomically |
+
+### Configuration
 
-# Assets & Trading
-npx starkfi balance [token]                   # Show token balances
-npx starkfi send <amount> <token> <recipient> # Transfer tokens
-npx starkfi trade <amount> <from> <to>        # Swap tokens via Fibrous
+| Command                                 | Description                    |
+| --------------------------------------- | ------------------------------ |
+| `config list`                           | Show current configuration     |
+| `config set-rpc <url>`                  | Set custom RPC endpoint        |
+| `config get-rpc`                        | Show current RPC               |
+| `config set-network <mainnet\|sepolia>` | Switch network                 |
+| `config set-gas-token <token\|reset>`   | Set gas payment token          |
+| `config set-gasfree <on\|off>`          | Toggle developer-sponsored gas |
+| `tx-status <hash>`                      | Check transaction status       |
 
-# Staking
-npx starkfi validators                        # List all validators
-npx starkfi pools <validator>                 # List delegation pools
-npx starkfi staking-stats                     # Full staking dashboard
-npx starkfi stake <amount> --pool <pool>      # Stake tokens
-npx starkfi rewards --pool <pool> [--claim|--compound] # Manage rewards
-npx starkfi unstake <intent|exit> --pool <pool> [--amount <amount>] # Unstake
+---
 
-# Network & Config
-npx starkfi tx-status <hash>                  # Check tx receipt
-npx starkfi config list                       # View configuration
-npx starkfi config set-rpc <url>              # Set custom RPC
-npx starkfi config set-network <network>      # Set network (mainnet/sepolia)
-npx starkfi config set-gasfree <on|off>       # Toggle AVNU-sponsored gas
-npx starkfi config set-gas-token <token|off>  # Pay gas in ERC-20 (USDC, etc)
+## Auth Server
 
-# Lending (Vesu V2)
-npx starkfi lend-pools                                   # List Vesu lending pools
-npx starkfi lend-pools Genesis                           # Filter by name
-npx starkfi lend-supply 100 -p Genesis -t STRK           # Supply assets to earn interest
-npx starkfi lend-withdraw 50 -p Genesis -t STRK          # Withdraw supplied assets
-npx starkfi lend-borrow -p Genesis --collateral-amount 1 --collateral-token ETH --borrow-amount 500 --borrow-token USDC
-npx starkfi lend-repay 250 -p Genesis -t USDC --collateral-token ETH  # Repay debt
-npx starkfi lend-status -p Genesis --collateral-token ETH --debt-token USDC
+StarkFi includes a dedicated **authentication server** (`server/`) built for secure, non-custodial wallet management.
+
+### Route Groups
+
+| Route        | Purpose                                           |
+| ------------ | ------------------------------------------------- |
+| `/auth`      | Email OTP login and verification via Privy        |
+| `/wallet`    | Wallet creation and address retrieval             |
+| `/sign`      | Transaction signing via Privy TEE (non-custodial) |
+| `/paymaster` | Paymaster proxy for gas abstraction               |
+
+### Security
+
+- **CORS** with configurable allowlist (`ALLOWED_ORIGINS`)
+- **Secure headers** via `hono/secure-headers`
+- **Body size limit** (1MB)
+- **Request ID tracking** for observability
+- **Graceful shutdown** (SIGTERM/SIGINT with 5s force-kill)
+
+See [`server/README.md`](server/README.md) for setup instructions.
+
+---
+
+## Tech Stack
+
+| Layer           | Technology                                                                       |
+| --------------- | -------------------------------------------------------------------------------- |
+| **Core SDK**    | [Starkzap](https://github.com/keep-starknet-strange/starkzap) v1.0.0             |
+| **CLI**         | [Commander.js](https://github.com/tj/commander.js) v14.0.3                       |
+| **MCP**         | [@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/sdk) v1.27.1 |
+| **Schema**      | [Zod](https://zod.dev/) v4.3.6                                                   |
+| **Auth Server** | [Hono](https://hono.dev/) v4.12.2 + [Privy TEE](https://privy.io/)               |
+| **DEX Routing** | [Fibrous](https://fibrous.finance/) Aggregator                                   |
+| **Lending**     | [Vesu](https://vesu.io/) V2 Protocol                                             |
+| **Gas**         | [AVNU](https://avnu.fi/) Paymaster                                               |
+
+---
+
+## Error Handling
+
+StarkFi implements a robust error handling system with a custom `StarkfiError` class and **26 specific error codes** organized by domain:
+
+| Domain         | Error Codes                                                                       |
+| -------------- | --------------------------------------------------------------------------------- |
+| **Auth**       | `SESSION_EXPIRED`, `SESSION_NOT_FOUND`, `AUTH_FAILED`, `UNAUTHORIZED`             |
+| **Wallet**     | `WALLET_NOT_FOUND`, `WALLET_NOT_DEPLOYED`, `INSUFFICIENT_BALANCE`                 |
+| **Network**    | `NETWORK_ERROR`, `RPC_ERROR`, `API_ERROR`, `TX_FAILED`, `TX_REVERTED`             |
+| **Validation** | `INVALID_ADDRESS`, `INVALID_AMOUNT`, `INVALID_TOKEN`, `INVALID_CONFIG`            |
+| **DeFi**       | `SWAP_FAILED`, `STAKING_FAILED`, `LENDING_FAILED`, `POOL_NOT_FOUND`               |
+| **System**     | `CONFIG_ERROR`, `SDK_ERROR`, `UNKNOWN_ERROR`, `SIMULATION_FAILED`, `BATCH_FAILED` |
+
+All network operations include **automatic retry with exponential backoff** (500ms base, max 2 retries). Parallel operations use a **sliding-window concurrency pool** to prevent RPC rate-limiting.
+
+---
+
+## Development
+
+### Setup
+
+```bash
+git clone https://github.com/ahmetenesdur/starkfi.git
+cd starkfi
+pnpm install
 ```
 
-## AI Native (MCP)
+### Build
 
-StarkFi includes a built-in MCP server, exposing all DeFi capabilities to AI editors like Cursor and Claude.
+```bash
+pnpm build           # Compile TypeScript → dist/
+```
+
+### Dev Mode
 
 ```bash
-npx starkfi mcp-start
+pnpm dev -- --help   # Run with tsx (hot-reload)
+```
+
+### Lint & Format
+
+```bash
+pnpm lint            # ESLint
+pnpm format          # Prettier
 ```
 
-> See [MCP.md](MCP.md) for editor configuration and the complete tool registry.
+### Auth Server
+
+```bash
+cd server
+pnpm install
+cp .env.example .env    # Configure environment
+pnpm dev
+```
+
+---
+
+## Contributing
+
+Contributions are welcome! Here's how to get started:
+
+1. **Fork** the repository and create a feature branch
+2. **Install** dependencies: `pnpm install`
+3. **Make** your changes following the existing code style (TypeScript strict mode, ESLint + Prettier)
+4. **Build** and verify: `pnpm build && pnpm lint`
+5. **Submit** a pull request with a clear description
+
+For bug reports and feature requests, please [open an issue](https://github.com/ahmetenesdur/starkfi/issues).
 
 ## License
 
-MIT
+[MIT](LICENSE) — ahmetenesdur

package/dist/commands/auth/login.js

@@ -1,5 +1,5 @@
 import { apiLogin } from "../../services/api/client.js";
-import { createSpinner, success } from "../../lib/format.js";
+import { createSpinner, success, formatError } from "../../lib/format.js";
 import { getOrCreateAuthCommand } from "../../lib/command.js";
 export function registerLoginCommand(program) {
     const authCmd = getOrCreateAuthCommand(program);
@@ -15,7 +15,7 @@ export function registerLoginCommand(program) {
             console.log(`Run: starkfi auth verify ${email} <code>`);
         }
         catch (error) {
-            console.error("Login failed:", error instanceof Error ? error.message : error);
+            console.error(formatError(error));
             process.exit(1);
         }
     });

package/dist/commands/auth/login.js.map

@@ -1 +1 @@
-{"version":3,"file":"login.js","sourceRoot":"","sources":["../../../src/commands/auth/login.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACpD,MAAM,OAAO,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAEhD,OAAO;SACL,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,mDAAmD,CAAC;SAChE,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,EAAE;QAC/B,IAAI,CAAC;YACJ,MAAM,OAAO,GAAG,aAAa,CAAC,gBAAgB,CAAC,CAAC,KAAK,EAAE,CAAC;YAExD,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC;YAEtB,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,qBAAqB,KAAK,iBAAiB,CAAC,CAAC,CAAC;YAClE,OAAO,CAAC,GAAG,CAAC,4BAA4B,KAAK,SAAS,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YAC/E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;IACF,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../../../src/commands/auth/login.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACpD,MAAM,OAAO,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAEhD,OAAO;SACL,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,mDAAmD,CAAC;SAChE,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,EAAE;QAC/B,IAAI,CAAC;YACJ,MAAM,OAAO,GAAG,aAAa,CAAC,gBAAgB,CAAC,CAAC,KAAK,EAAE,CAAC;YAExD,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC;YAEtB,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,qBAAqB,KAAK,iBAAiB,CAAC,CAAC,CAAC;YAClE,OAAO,CAAC,GAAG,CAAC,4BAA4B,KAAK,SAAS,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;IACF,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/auth/verify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../../src/commands/auth/verify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0E5D"}
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../../src/commands/auth/verify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuE5D"}

package/dist/commands/auth/verify.js

@@ -1,6 +1,6 @@
 import { apiVerify } from "../../services/api/client.js";
 import { saveSession } from "../../services/auth/session.js";
-import { createSpinner, success, formatResult } from "../../lib/format.js";
+import { createSpinner, success, formatResult, formatError } from "../../lib/format.js";
 import { STARKFI_API_URL_DEFAULT } from "../../lib/config.js";
 import { createSDK, connectWallet, resolveFeeModeConfig } from "../../services/starkzap/client.js";
 import { ConfigService } from "../../services/config/config.js";
@@ -56,7 +56,7 @@ export function registerVerifyCommand(program) {
             }
         }
         catch (error) {
-            console.error("Verification failed:", error instanceof Error ? error.message : error);
+            console.error(formatError(error));
             process.exit(1);
         }
     });

package/dist/commands/auth/verify.js.map

@@ -1 +1 @@
-{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../../src/commands/auth/verify.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../../src/commands/auth/verify.ts"],"names":[],"mappings":"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"}

package/dist/commands/batch/batch.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerBatchCommand(program: Command): void;
+//# sourceMappingURL=batch.d.ts.map

package/dist/commands/batch/batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../../src/commands/batch/batch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6EzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+G3D"}