starkfi 0.3.1 → 0.3.4

package/MCP.md

@@ -1,6 +1,6 @@
 # Model Context Protocol (MCP) Integration
 
-StarkFi operates as a fully-featured Model Context Protocol (MCP) server. By executing `npx starkfi mcp-start` over the `stdio` transport layer, AI development environments such as Cursor, Claude Desktop, and Antigravity can interact with the Starknet blockchain and execute decentralized finance operations through natural language commands.
+StarkFi operates as a fully-featured Model Context Protocol (MCP) server. By executing `npx starkfi@latest mcp-start` over the `stdio` transport layer, AI development environments such as Cursor, Claude Desktop, and Antigravity can interact with the Starknet blockchain and execute decentralized finance operations through natural language commands.
 
 ## Client Configuration
 
@@ -11,13 +11,13 @@ To integrate StarkFi into your AI environment, configure your MCP client setting
 	"mcpServers": {
 		"starkfi": {
 			"command": "npx",
-			"args": ["-y", "starkfi", "mcp-start"]
+			"args": ["-y", "starkfi@latest", "mcp-start"]
 		}
 	}
 }
 ```
 
-**Authentication Requirement:** The StarkFi CLI must be authenticated locally (via `npx starkfi auth login`) before the MCP server can execute any state-mutating transactions on behalf of the user.
+**Authentication Requirement:** The StarkFi CLI must be authenticated locally (via `npx starkfi@latest auth login`) before the MCP server can execute any state-mutating transactions on behalf of the user.
 
 ## Tool Registry
 
@@ -276,10 +276,10 @@ Atomically closes an active Vesu V2 lending position. Repays all outstanding deb
 
 Views and modifies global CLI behavior: RPC routing, network selection, and Gas Abstraction.
 
-| Parameter | Type   | Required | Description                                                                                                                             |
-| --------- | ------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------- |
-| `action`  | enum   | **Yes**  | One of: `list`, `set-rpc`, `get-rpc`, `set-network`, `set-gasfree`, `set-gas-token`                                                     |
-| `value`   | string | No       | `set-gasfree`: `on`/`off`. `set-gas-token`: symbol (`USDC`, `ETH`) or `off`. `set-rpc`: URL string. `set-network`: `mainnet`/`sepolia`. |
+| Parameter | Type   | Required | Description                                                                                                                               |
+| --------- | ------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
+| `action`  | enum   | **Yes**  | One of: `list`, `reset`, `set-rpc`, `get-rpc`, `set-network`, `set-gasfree`, `set-gas-token`                                                 |
+| `value`   | string | No       | `set-gasfree`: `on`/`off`. `set-gas-token`: symbol (`USDC`, `ETH`) or `reset`. `set-rpc`: URL string. `set-network`: `mainnet`/`sepolia`. |
 
 ---
 

package/README.md

@@ -1,19 +1,23 @@
 <p align="center">
   <a href="https://starkfi.app">
-    <img src="docs/favicon.svg" alt="StarkFi Logo" width="100" height="100"/>
+    <img src="landing/favicon.svg" alt="StarkFi Logo" width="100" height="100"/>
   </a>
 </p>
 
 <h1 align="center">StarkFi</h1>
 
 <p align="center">
-  <strong>The Gas-Abstracted DeFi CLI & Agent.</strong><br>
-  <em>The AI-native DeFi toolkit for Starknet.</em><br>
+  <strong>The AI-native DeFi toolkit for Starknet.</strong><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>
 
+<p align="center">
+  <a href="https://www.npmjs.com/package/starkfi"><img src="https://img.shields.io/npm/v/starkfi?style=flat-square&color=CB3837&logo=npm&logoColor=white" alt="npm version"/></a>
+  <a href="https://www.npmjs.com/package/starkfi"><img src="https://img.shields.io/npm/dm/starkfi?style=flat-square&color=blue" alt="npm downloads"/></a>
+</p>
+
 ```bash
-npx starkfi --help
+npx starkfi@latest --help
 ```
 
 ---
@@ -33,35 +37,36 @@ Most DeFi tools are built for humans clicking buttons. StarkFi is built for **ag
 ## 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    │   │
-│  └─────────────────────────────────────┘  └─────────────────────┘   │
-└──────────────────────────────────────────────────────────────────────┘
+┌──────────────────────────────────────────────────────────────────────────┐
+│                              StarkFi                                     │
+│                                                                          │
+│  ┌──────────┐     ┌─────────────────────┐     ┌───────────────────────┐  │
+│  │   CLI    │     │    MCP Server       │     │    Agent Skills       │  │
+│  │  (30+    │     │    (27 tools)       │     │    (10 workflows)     │  │
+│  │ commands)│     │ stdio transport     │     │   npx starkfi@latest  │  │
+│  └────┬─────┘     └──────────┬──────────┘     └──────────┬────────────┘  │
+│       │                      │                           │               │
+│       └──────────────────────┼───────────────────────────┘               │
+│                              ▼                                           │
+│  ┌──────────────────────────────────────────────────────────────────┐    │
+│  │                      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     │      │
+│  └──────────────────────────────────────┘  └──────────────────────┘      │
+└──────────────────────────────────────────────────────────────────────────┘
                               │
                               ▼
                     ┌──────────────────┐
@@ -92,8 +97,8 @@ StarkFi leverages **all core Starkzap modules**:
 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"
+npx starkfi@latest trade 100 USDC ETH --slippage 1
+npx starkfi@latest multi-swap "100 USDC>ETH, 50 USDT>ETH"
 ```
 
 ### ⚛️ Atomic Transaction Batching
@@ -101,7 +106,7 @@ npx starkfi multi-swap "100 USDC>ETH, 50 USDT>ETH"
 Bundle multiple DeFi operations into a single Starknet multicall. Minimum 2 operations.
 
 ```bash
-npx starkfi batch \
+npx starkfi@latest batch \
   --swap "100 USDC ETH" \
   --stake "50 STRK karnot" \
   --supply "200 USDC Prime" \
@@ -113,10 +118,10 @@ npx starkfi batch \
 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
+npx starkfi@latest stake 100 -v karnot
+npx starkfi@latest rewards -v karnot --compound
+npx starkfi@latest unstake intent -v karnot -a 50
+npx starkfi@latest unstake exit -v karnot
 ```
 
 ### 🏦 Lending & Borrowing (Vesu V2)
@@ -124,24 +129,25 @@ npx starkfi unstake exit -v karnot
 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 \
+npx starkfi@latest lend-supply 100 -p Prime -t STRK
+npx starkfi@latest 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
+npx starkfi@latest lend-status                                                # Auto-scan all pools
+npx starkfi@latest lend-status -p Prime --collateral-token STRK --borrow-token USDC  # Specific position
+npx starkfi@latest 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.
+Users pay gas fees in their preferred ERC-20 token via AVNU Paymaster — no native STRK or ETH required. Alternatively, developers can sponsor gas entirely.
 
 ```bash
 # Pay gas in USDC instead of STRK
-npx starkfi config set-gas-token USDC
+npx starkfi@latest config set-gas-token USDC
 
 # Developer pays all gas (gasfree mode)
-npx starkfi config set-gasfree on
+npx starkfi@latest config set-gasfree on
 ```
 
 | Mode                  | Who Pays  | Gas Tokens                 | Description                       |
@@ -154,8 +160,8 @@ npx starkfi config set-gasfree on
 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
+npx starkfi@latest trade 100 USDC ETH --simulate
+# → mode: SIMULATION, estimatedFee: 0.054 STRK ($0.0024), callCount: 4
 ```
 
 ### 📊 Portfolio Dashboard
@@ -163,7 +169,7 @@ npx starkfi trade 100 USDC ETH --simulate
 Consolidated view of all DeFi positions in one call.
 
 ```bash
-npx starkfi portfolio
+npx starkfi@latest portfolio
 # → Token Balances (USD), Staking Positions, Lending Positions, Total Value
 ```
 
@@ -175,7 +181,7 @@ StarkFi exposes **27 MCP tools** via stdio transport, enabling AI assistants to
 
 ```bash
 # Start the MCP server
-npx starkfi mcp-start
+npx starkfi@latest mcp-start
 ```
 
 ### Tool Categories
@@ -208,13 +214,13 @@ Add to your AI assistant's MCP config (Cursor, Claude, etc.):
 	"mcpServers": {
 		"starkfi": {
 			"command": "npx",
-			"args": ["-y", "starkfi", "mcp-start"]
+			"args": ["-y", "starkfi@latest", "mcp-start"]
 		}
 	}
 }
 ```
 
-For the complete tool registry and schemas, see [MCP Documentation](MCP.md).
+For the complete tool registry and schemas, see [MCP Documentation](https://docs.starkfi.app/docs/mcp).
 
 ---
 
@@ -234,7 +240,7 @@ StarkFi ships with **10 agent skills** — structured instruction sets that teac
 npx skills add ahmetenesdur/starkfi
 ```
 
-See [Skills Documentation](skills/README.md) for details.
+See [Skills Documentation](https://docs.starkfi.app/docs/skills) for details.
 
 ---
 
@@ -248,27 +254,27 @@ See [Skills Documentation](skills/README.md) for details.
 ### 1. Authenticate
 
 ```bash
-npx starkfi auth login user@example.com
-npx starkfi auth verify user@example.com <OTP_CODE>
+npx starkfi@latest auth login user@example.com
+npx starkfi@latest auth verify user@example.com <OTP_CODE>
 ```
 
 ### 2. Deploy Account
 
 ```bash
-npx starkfi deploy
+npx starkfi@latest deploy
 ```
 
 ### 3. Check Balance
 
 ```bash
-npx starkfi balance
+npx starkfi@latest balance
 ```
 
 ### 4. Start Trading
 
 ```bash
-npx starkfi trade 10 STRK ETH --simulate    # Preview first
-npx starkfi trade 10 STRK ETH               # Execute
+npx starkfi@latest trade 10 STRK ETH --simulate    # Preview first
+npx starkfi@latest trade 10 STRK ETH               # Execute
 ```
 
 ---
@@ -322,7 +328,7 @@ npx starkfi trade 10 STRK ETH               # Execute
 | `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-status [-p <pool> --collateral-token <t> [--borrow-token <t>]]`                                                          | Position status (auto-scan if no args) |
 | `lend-close -p <pool> --collateral-token <t> --borrow-token <t>`                                                               | Close position atomically |
 
 ### Configuration
@@ -330,6 +336,7 @@ npx starkfi trade 10 STRK ETH               # Execute
 | Command                                 | Description                    |
 | --------------------------------------- | ------------------------------ |
 | `config list`                           | Show current configuration     |
+| `config reset`                          | Reset all settings to defaults |
 | `config set-rpc <url>`                  | Set custom RPC endpoint        |
 | `config get-rpc`                        | Show current RPC               |
 | `config set-network <mainnet\|sepolia>` | Switch network                 |
@@ -372,7 +379,7 @@ See [`server/README.md`](server/README.md) for setup instructions.
 | **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/)               |
+| **Auth Server** | [Hono](https://hono.dev/) v4.12.7 + [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                                               |
@@ -381,19 +388,34 @@ See [`server/README.md`](server/README.md) for setup instructions.
 
 ## Error Handling
 
-StarkFi implements a robust error handling system with a custom `StarkfiError` class and **26 specific error codes** organized by domain:
+StarkFi implements a robust error handling system with a custom `StarkfiError` class and **25 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` |
+| Domain         | Error Codes                                                                                                                                         |
+| -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Auth**       | `AUTH_REQUIRED`, `AUTH_FAILED`, `SESSION_EXPIRED`                                                                                                   |
+| **Wallet**     | `WALLET_NOT_DEPLOYED`, `WALLET_NOT_FOUND`, `INSUFFICIENT_BALANCE`                                                                                   |
+| **Network**    | `NETWORK_ERROR`, `RATE_LIMITED`, `TX_FAILED`, `TX_NOT_FOUND`, `PAYMASTER_ERROR`                                                                     |
+| **Validation** | `INVALID_CONFIG`, `INVALID_ADDRESS`, `INVALID_AMOUNT`                                                                                               |
+| **DeFi**       | `SWAP_FAILED`, `NO_ROUTE_FOUND`, `SLIPPAGE_EXCEEDED`, `STAKING_FAILED`, `LENDING_FAILED`, `POOL_NOT_FOUND`, `EXIT_NOT_READY`, `VALIDATOR_NOT_FOUND` |
+| **System**     | `SIMULATION_FAILED`, `BATCH_LIMIT_EXCEEDED`, `UNKNOWN`                                                                                              |
 
 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.
 
+### Readable Starknet Errors
+
+Raw Starknet JSON-RPC errors (hex-encoded Cairo strings like `u256_sub Overflow`) are automatically parsed into human-readable messages:
+
+| Raw Error | Displayed Message |
+|-----------|------------------|
+| `u256_sub Overflow` | Insufficient balance — you don't have enough tokens (including gas fees) |
+| `ERC20: insufficient allowance` | Token approval required — not enough allowance for this operation |
+| `UNAUTHORIZED` | Unauthorized — session may have expired, try: starkfi auth login |
+| `argent/multicall-failed` | One or more calls in the transaction failed |
+| `dusty-collateral-balance` | Collateral amount is below the pool's minimum (dust limit). Please increase the amount. |
+| `dusty-debt-balance` | Borrow amount is below the pool's minimum (dust limit). Please increase the amount. |
+
+This applies to both CLI output (`formatError`) and MCP responses (`withErrorHandling`).
+
 ---
 
 ## Development

package/dist/commands/auth/login.js

@@ -7,14 +7,15 @@ export function registerLoginCommand(program) {
         .command("login <email>")
         .description("Send OTP to email for Privy wallet authentication")
         .action(async (email) => {
+        const spinner = createSpinner("Sending OTP...").start();
         try {
-            const spinner = createSpinner("Sending OTP...").start();
             await apiLogin(email);
             spinner.succeed("OTP sent");
             console.log(success(`Check your email (${email}) for the code.`));
             console.log(`Run: starkfi auth verify ${email} <code>`);
         }
         catch (error) {
+            spinner.fail("Login failed");
             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,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"}
+{"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,MAAM,OAAO,GAAG,aAAa,CAAC,gBAAgB,CAAC,CAAC,KAAK,EAAE,CAAC;QACxD,IAAI,CAAC;YACJ,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,IAAI,CAAC,cAAc,CAAC,CAAC;YAC7B,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/batch/batch.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../../src/commands/batch/batch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8EzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuG3D"}

package/dist/commands/batch/batch.js

@@ -2,13 +2,14 @@ import { requireSession } from "../../services/auth/session.js";
 import { initSDKAndWallet } from "../../services/starkzap/client.js";
 import { buildBatch } from "../../services/batch/batch.js";
 import { simulateTransaction } from "../../services/simulate/simulate.js";
-import { createSpinner, formatResult, formatError } from "../../lib/format.js";
+import { createSpinner, formatError } from "../../lib/format.js";
+import { outputResult } from "../../lib/cli-helpers.js";
 import { ErrorCode, StarkfiError } from "../../lib/errors.js";
-/** Collect repeatable options into array. */
+// Collect repeatable options into array.
 function collect(value, previous) {
     return previous.concat([value]);
 }
-/** Parse "100 USDC ETH" into a typed BatchOperation. */
+// Parse "100 USDC ETH" into a typed BatchOperation.
 function parseOperation(type, raw) {
     const parts = raw.trim().split(/\s+/);
     switch (type) {
@@ -119,12 +120,7 @@ Minimum 2 operations required. Each flag can be repeated.`)
                     calls: sim.callCount,
                     ...(sim.revertReason ? { revertReason: sim.revertReason } : {}),
                 };
-                if (opts.json) {
-                    console.log(JSON.stringify(simResult, null, 2));
-                }
-                else {
-                    console.log(formatResult(simResult));
-                }
+                outputResult(simResult, opts);
                 return;
             }
             spinner.start();
@@ -138,12 +134,7 @@ Minimum 2 operations required. Each flag can be repeated.`)
                 txHash: tx.hash,
                 explorer: tx.explorerUrl,
             };
-            if (opts.json) {
-                console.log(JSON.stringify(txResult, null, 2));
-            }
-            else {
-                console.log(formatResult(txResult));
-            }
+            outputResult(txResult, opts);
         }
         catch (error) {
             spinner.fail("Batch failed");

package/dist/commands/batch/batch.js.map

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

package/dist/commands/chain/tx-status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tx-status.d.ts","sourceRoot":"","sources":["../../../src/commands/chain/tx-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuC9D"}
+{"version":3,"file":"tx-status.d.ts","sourceRoot":"","sources":["../../../src/commands/chain/tx-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoC9D"}

package/dist/commands/chain/tx-status.js

@@ -1,39 +1,34 @@
 import { requireSession } from "../../services/auth/session.js";
 import { createSDK } from "../../services/starkzap/client.js";
 import { ConfigService } from "../../services/config/config.js";
-import { createSpinner, formatResult, formatError } from "../../lib/format.js";
+import { formatActualFee } from "../../lib/format.js";
 import { explorerUrl } from "../../lib/config.js";
+import { runCommand, outputResult } from "../../lib/cli-helpers.js";
 export function registerTxStatusCommand(program) {
     program
         .command("tx-status")
         .description("Check transaction status by hash")
         .argument("<hash>", "Transaction hash (0x...)")
         .action(async (hash) => {
-        const spinner = createSpinner("Checking transaction...").start();
-        try {
+        await runCommand("Checking transaction...", "Transaction found", "Failed to get transaction status", async () => {
             const session = requireSession();
             const configService = ConfigService.getInstance();
             const rpcUrl = configService.get("rpcUrl");
             const sdk = createSDK(session.network, rpcUrl);
             const provider = sdk.getProvider();
             const receipt = await provider.getTransactionReceipt(hash);
-            spinner.succeed("Transaction found");
-            const actualFee = "actual_fee" in receipt ? String(receipt.actual_fee) : "N/A";
+            const rawFee = "actual_fee" in receipt ? receipt.actual_fee : null;
+            const actualFee = formatActualFee(rawFee);
             const blockNumber = "block_number" in receipt ? String(receipt.block_number) : "pending";
-            console.log(formatResult({
+            return {
                 hash,
                 status: JSON.stringify(receipt.statusReceipt),
                 actualFee,
                 blockNumber,
                 network: session.network,
                 explorer: explorerUrl(hash, session.network),
-            }));
-        }
-        catch (error) {
-            spinner.fail("Failed to get transaction status");
-            console.error(formatError(error));
-            process.exit(1);
-        }
+            };
+        }, (result) => outputResult(result, {}));
     });
 }
 //# sourceMappingURL=tx-status.js.map

package/dist/commands/chain/tx-status.js.map

@@ -1 +1 @@
-{"version":3,"file":"tx-status.js","sourceRoot":"","sources":["../../../src/commands/chain/tx-status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACvD,OAAO;SACL,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,kCAAkC,CAAC;SAC/C,QAAQ,CAAC,QAAQ,EAAE,0BAA0B,CAAC;SAC9C,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,EAAE;QAC9B,MAAM,OAAO,GAAG,aAAa,CAAC,yBAAyB,CAAC,CAAC,KAAK,EAAE,CAAC;QAEjE,IAAI,CAAC;YACJ,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;YACjC,MAAM,aAAa,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;YAClD,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAuB,CAAC;YACjE,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAE/C,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;YAE3D,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;YAErC,MAAM,SAAS,GAAG,YAAY,IAAI,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YAC/E,MAAM,WAAW,GAChB,cAAc,IAAI,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAEtE,OAAO,CAAC,GAAG,CACV,YAAY,CAAC;gBACZ,IAAI;gBACJ,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,aAAa,CAAC;gBAC7C,SAAS;gBACT,WAAW;gBACX,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,QAAQ,EAAE,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC;aAC5C,CAAC,CACF,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;YACjD,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"}
+{"version":3,"file":"tx-status.js","sourceRoot":"","sources":["../../../src/commands/chain/tx-status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAEpE,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACvD,OAAO;SACL,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,kCAAkC,CAAC;SAC/C,QAAQ,CAAC,QAAQ,EAAE,0BAA0B,CAAC;SAC9C,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,EAAE;QAC9B,MAAM,UAAU,CACf,yBAAyB,EACzB,mBAAmB,EACnB,kCAAkC,EAClC,KAAK,IAAI,EAAE;YACV,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;YACjC,MAAM,aAAa,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;YAClD,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAuB,CAAC;YACjE,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAE/C,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;YAE3D,MAAM,MAAM,GAAG,YAAY,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;YACnE,MAAM,SAAS,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;YAC1C,MAAM,WAAW,GAChB,cAAc,IAAI,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAEtE,OAAO;gBACN,IAAI;gBACJ,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,aAAa,CAAC;gBAC7C,SAAS;gBACT,WAAW;gBACX,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,QAAQ,EAAE,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC;aAC5C,CAAC;QACH,CAAC,EACD,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC,CACpC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/commands/config/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2I5D"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/commands/config/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+I5D"}

package/dist/commands/config/config.js

@@ -2,6 +2,7 @@ import { ConfigService } from "../../services/config/config.js";
 import { success, formatResult, warn } from "../../lib/format.js";
 import { GASLESS_SUPPORTED_TOKENS } from "../../services/starkzap/config.js";
 export function registerConfigCommand(program) {
+    const configService = ConfigService.getInstance();
     const configCmd = program.command("config").description("Manage starkfi configuration");
     configCmd
         .command("set-rpc")
@@ -9,7 +10,6 @@ export function registerConfigCommand(program) {
         .argument("<url>", "RPC endpoint URL")
         .addHelpText("after", "\nExample:\n  $ starkfi config set-rpc https://starknet-mainnet.g.alchemy.com/v2/<key>")
         .action((url) => {
-        const configService = ConfigService.getInstance();
         configService.set("rpcUrl", url);
         console.log(success(`RPC URL set to: ${url}`));
     });
@@ -18,10 +18,9 @@ export function registerConfigCommand(program) {
         .description("Show the current RPC URL")
         .addHelpText("after", "\nExample:\n  $ starkfi config get-rpc")
         .action(() => {
-        const configService = ConfigService.getInstance();
         const rpcUrl = configService.get("rpcUrl");
         console.log(formatResult({
-            rpcUrl: rpcUrl || "default (StarkZap preset)",
+            rpcUrl: rpcUrl || "default (Starkzap preset)",
         }));
     });
     configCmd
@@ -34,7 +33,6 @@ export function registerConfigCommand(program) {
             console.log(warn("Network must be 'mainnet' or 'sepolia'"));
             process.exit(1);
         }
-        const configService = ConfigService.getInstance();
         configService.set("network", network);
         console.log(success(`Network set to: ${network}`));
     });
@@ -49,7 +47,6 @@ export function registerConfigCommand(program) {
             console.log(warn("Mode must be 'on' or 'off'"));
             process.exit(1);
         }
-        const configService = ConfigService.getInstance();
         configService.set("gasfreeMode", mode === "on");
         if (mode === "on") {
             // Gasfree and Gasless are mutually exclusive
@@ -67,7 +64,6 @@ export function registerConfigCommand(program) {
         .argument("<token>", `Token symbol or 'reset' (supported: ${GASLESS_SUPPORTED_TOKENS.join(", ")})`)
         .addHelpText("after", `\nExamples:\n  $ starkfi config set-gas-token ETH\n  $ starkfi config set-gas-token USDC\n  $ starkfi config set-gas-token reset    # revert to STRK`)
         .action((token) => {
-        const configService = ConfigService.getInstance();
         if (["off", "reset", "default"].includes(token.toLowerCase())) {
             configService.delete("gasToken");
             console.log(success("Gas token reset to default: STRK"));
@@ -88,7 +84,6 @@ export function registerConfigCommand(program) {
         .description("Show all configuration settings")
         .addHelpText("after", "\nExample:\n  $ starkfi config list")
         .action(() => {
-        const configService = ConfigService.getInstance();
         const all = configService.getAll();
         if (Object.keys(all).length === 0) {
             console.log("  No custom settings. Using defaults.\n");
@@ -107,5 +102,13 @@ export function registerConfigCommand(program) {
             feeMode: feeModeSummary,
         }));
     });
+    configCmd
+        .command("reset")
+        .description("Reset all configuration to defaults")
+        .addHelpText("after", "\nExample:\n  $ starkfi config reset")
+        .action(() => {
+        configService.clear();
+        console.log(success("All settings reset to defaults."));
+    });
 }
 //# sourceMappingURL=config.js.map