apow-cli 0.6.0 → 0.6.1

package/.env.example

@@ -26,7 +26,7 @@ LLM_API_KEY=
 # SQUID_INTEGRATOR_ID=
 
 # Ethereum mainnet RPC (only for `apow fund --chain ethereum`)
-# Default: https://eth.llamarpc.com (free)
+# Default: https://ethereum-rpc.publicnode.com (free)
 # ETHEREUM_RPC_URL=
 
 # Contract addresses (defaults built-in, override only if needed)

package/README.md

@@ -116,7 +116,7 @@ LLM_MODEL=gpt-4o-mini         # Required for minting only; mining uses optimized
 LLM_API_KEY=sk-...             # Required for minting only
 # Bridging (only for `apow fund`)
 # SOLANA_RPC_URL=https://api.mainnet-beta.solana.com
-# ETHEREUM_RPC_URL=https://eth.llamarpc.com    # free, for `--chain ethereum` only
+# ETHEREUM_RPC_URL=https://ethereum-rpc.publicnode.com    # free, for `--chain ethereum` only
 # SQUID_INTEGRATOR_ID=          # free, get at squidrouter.com (deposit address flow only)
 # Contract addresses (defaults built-in, override only if needed)
 # MINING_AGENT_ADDRESS=0xB7caD3ca5F2BD8aEC2Eb67d6E8D448099B3bC03D

package/dist/bridge/debridge.js

@@ -131,7 +131,7 @@ async function bridgeFromSolana(solanaKeypair, baseAddress, amount, route = expo
 async function bridgeFromEvm(privateKey, baseAddress, amount, route = exports.ROUTES.eth_to_base_eth) {
     const startTime = Date.now();
     const evmAccount = (0, accounts_1.privateKeyToAccount)(privateKey);
-    const rpcUrl = process.env.ETHEREUM_RPC_URL ?? "https://eth.llamarpc.com";
+    const rpcUrl = process.env.ETHEREUM_RPC_URL ?? "https://ethereum-rpc.publicnode.com";
     const ethWalletClient = (0, viem_1.createWalletClient)({
         account: evmAccount,
         chain: chains_1.mainnet,

package/dist/errors.js

@@ -118,11 +118,11 @@ const patterns = [
         }),
     },
     {
-        test: (m) => m.includes("eth.llamarpc") || (m.includes("ETHEREUM_RPC") && m.includes("unreachable")),
+        test: (m) => m.includes("ethereum-rpc.publicnode") || (m.includes("ETHEREUM_RPC") && m.includes("unreachable")),
         classify: () => ({
             category: "setup",
             userMessage: "Ethereum mainnet RPC unreachable",
-            recovery: "Set ETHEREUM_RPC_URL in .env (default: https://eth.llamarpc.com)",
+            recovery: "Set ETHEREUM_RPC_URL in .env (default: https://ethereum-rpc.publicnode.com)",
         }),
     },
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apow-cli",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Mine AGENT tokens on Base L2 with Agentic Proof of Work",
   "keywords": [
     "apow",

package/skill.md

@@ -25,14 +25,7 @@ metadata:
 configure the miner, mint, and mine. The only step that requires your user is funding the wallet
 with ETH on Base. Everything else you handle yourself.
 
-> **IMPORTANT: You need a dedicated RPC endpoint.** The default public RPC (`https://mainnet.base.org`) has aggressive rate limits and **will cause minting and mining to fail**. Before starting, get a free Alchemy endpoint:
->
-> 1. Go to [alchemy.com](https://www.alchemy.com/) and sign up (free, no credit card)
-> 2. Click **Create new app** → Name: `apow-miner` → Chain: **Base** → Network: **Base Mainnet**
-> 3. Copy the **HTTPS** URL: `https://base-mainnet.g.alchemy.com/v2/YOUR_API_KEY`
-> 4. Set `RPC_URL` to this URL in your `.env`
->
-> Alchemy's free tier (300M compute units/month) is more than enough. See [RPC Recommendations](#rpc-recommendations) for alternatives.
+> **RPC:** The CLI uses [Alchemy x402](https://x402.alchemy.com/) by default -- a premium Base RPC that charges per-request via USDC in your mining wallet. No API key, no account, no rate limits. Just fund your wallet with USDC (the `apow fund` command handles this automatically). If no USDC is available, it falls back to the public RPC. To use a custom RPC, set `RPC_URL` in `.env`.
 
 ---
 
@@ -78,10 +71,11 @@ MINING_AGENT_ADDRESS=0xB7caD3ca5F2BD8aEC2Eb67d6E8D448099B3bC03D
 AGENT_COIN_ADDRESS=0x12577CF0D8a07363224D6909c54C056A183e13b3
 EOF
 
-# 3. Fund the wallet (bridge from Solana or send ETH on Base)
-npx apow-cli fund --solana            # interactive bridge SOL → ETH on Base
-# Or: npx apow-cli fund --solana --key <base58>  # direct signing (~20s)
-# Or: ask your user to send ≥0.005 ETH on Base directly
+# 3. Fund the wallet (bridge from any chain, auto-splits into ETH + USDC)
+npx apow-cli fund --chain solana --token sol    # bridge SOL → ETH+USDC on Base
+# Or: npx apow-cli fund --chain solana --token sol --key <base58>  # direct signing (~20s)
+# Or: npx apow-cli fund --chain ethereum --token eth  # bridge from Ethereum mainnet
+# Or: ask your user to send ETH + USDC on Base directly
 
 # 4. Mint + mine (fully autonomous from here)
 npx apow-cli mint
@@ -158,26 +152,32 @@ Your mining wallet needs ETH on Base for gas and the mint fee.
 
 ### Built-in Bridge: `apow fund` (Recommended)
 
-The CLI has a built-in cross-chain bridge for Solana users:
+The CLI accepts deposits in 6 forms across 3 chains, auto-bridges to Base, and auto-splits into ETH (gas) + USDC (x402 RPC):
 
 ```bash
-npx apow-cli fund                           # Interactive: choose funding method
-npx apow-cli fund --solana                  # Deposit address + QR code
-npx apow-cli fund --solana --key <base58>   # Direct Solana signing (~20s)
-npx apow-cli fund --solana --amount 0.01    # Custom ETH target
+npx apow-cli fund                                          # Interactive: choose chain + token
+npx apow-cli fund --chain solana --token sol               # Bridge SOL → ETH+USDC on Base
+npx apow-cli fund --chain solana --token sol --key <b58>   # Direct Solana signing (~20s)
+npx apow-cli fund --chain solana --token usdc              # Bridge Solana USDC → Base
+npx apow-cli fund --chain ethereum --token eth             # Bridge ETH from mainnet
+npx apow-cli fund --chain ethereum --token usdc            # Bridge USDC from mainnet
+npx apow-cli fund --chain base                             # Show address, wait for deposit
+npx apow-cli fund --chain base --no-swap                   # Skip auto-split
 ```
 
-**Three funding paths:**
+**Bridge methods per chain:**
+
+| Chain | Direct signing | Deposit address |
+|-------|---------------|-----------------|
+| Solana | deBridge DLN (~20s, `--key`) | Squid Router (~1-3 min) |
+| Ethereum | deBridge DLN (~20s, uses PRIVATE_KEY on mainnet) | Squid Router (~1-3 min) |
+| Base | N/A (already on Base) | Show address + QR code |
 
-| Path | How it works | Speed | Requires Solana key? |
-|------|-------------|-------|---------------------|
-| Direct signing | deBridge DLN signs + submits via your Solana keypair | ~20 seconds | Yes (`--key`) |
-| Deposit address | Squid Router generates a Solana address; send from any wallet | ~1-3 minutes | No |
-| Manual | Shows your Base address + QR code | Varies | No |
+**Auto-split:** After bridging, the CLI checks ETH and USDC balances. If either is below the minimum (0.003 ETH for gas, 2.00 USDC for x402 RPC), it swaps the needed amount via Uniswap V3 on Base. Use `--no-swap` to skip.
 
-**Direct signing (`--key`):** Provide your base58 Solana secret key. The CLI calls deBridge DLN to create a bridge order, signs the Solana transaction locally, submits it, and polls until ETH arrives on Base. No API key needed.
+**Direct signing (Solana `--key`):** Provide your base58 Solana secret key. The CLI calls deBridge DLN to create a bridge order, signs the Solana transaction locally, submits it, and polls until funds arrive on Base. No API key needed.
 
-**Deposit address (`--solana` without `--key`):** Requires `SQUID_INTEGRATOR_ID` in `.env` (free, apply at [squidrouter.com](https://app.squidrouter.com/)). Generates a one-time Solana deposit address with a QR code. Send SOL from any wallet (Phantom, Backpack, etc.) and the bridge handles the rest.
+**Deposit address (no `--key`):** Requires `SQUID_INTEGRATOR_ID` in `.env` (free, apply at [squidrouter.com](https://app.squidrouter.com/)). Generates a one-time deposit address with a QR code. Send tokens from any wallet and the bridge handles the rest.
 
 ### Manual Funding Options
 
@@ -277,9 +277,10 @@ CHAIN=base
 | `LLM_API_KEY` | For minting | - | API key for minting. Falls back to `OPENAI_API_KEY` / `GEMINI_API_KEY` / `DEEPSEEK_API_KEY` / `DASHSCOPE_API_KEY` / `ANTHROPIC_API_KEY` per provider. Not needed for `ollama` or mining. |
 | `LLM_MODEL` | For minting | `gpt-4o-mini` | Model identifier passed to the provider (minting only) |
 | `MINER_THREADS` | No | All CPU cores | Number of threads for parallel nonce grinding |
-| `RPC_URL` | **Strongly recommended** | `https://mainnet.base.org` | Base JSON-RPC endpoint. **The default public RPC is unreliable. Use Alchemy (free) or another dedicated provider.** |
+| `RPC_URL` | No | Alchemy x402 | Base JSON-RPC endpoint. Default uses Alchemy x402 (premium, paid via USDC). Set to override with a custom endpoint. |
 | `CHAIN` | No | `base` | Network selector; auto-detects `baseSepolia` if RPC URL contains "sepolia" |
-| `SOLANA_RPC_URL` | No | `https://api.mainnet-beta.solana.com` | Solana RPC endpoint (only for `apow fund --solana`) |
+| `SOLANA_RPC_URL` | No | `https://api.mainnet-beta.solana.com` | Solana RPC endpoint (only for `apow fund --chain solana`) |
+| `ETHEREUM_RPC_URL` | No | `https://ethereum-rpc.publicnode.com` | Ethereum mainnet RPC (only for `apow fund --chain ethereum`) |
 | `SQUID_INTEGRATOR_ID` | No | - | Squid Router integrator ID for deposit address flow (free at [squidrouter.com](https://app.squidrouter.com/)) |
 
 ### LLM Provider Recommendations (for Minting)
@@ -635,10 +636,11 @@ The CLI makes only these network calls:
 
 1. **Blockchain RPC** (to user-configured RPC URL, default: `mainnet.base.org`): standard `eth_call`, `eth_sendRawTransaction`, etc.
 2. **LLM API** (to user-configured provider): sends only word-puzzle prompts for SMHL solving, never wallet data
-3. **Bridge APIs** (only when using `apow fund --solana`):
+3. **Bridge APIs** (only when using `apow fund`):
    - **CoinGecko** (`api.coingecko.com`): SOL/ETH price quotes
    - **deBridge DLN** (`dln.debridge.finance`): bridge order creation and status (direct signing flow)
    - **Squid Router** (`v2.api.squidrouter.com`): deposit address generation (deposit address flow)
+   - **Uniswap V3** (on-chain, Base): ETH/USDC swaps for auto-split
    - **Solana RPC** (`api.mainnet-beta.solana.com` or custom): balance checks and tx submission
 
 No private keys are transmitted to bridge providers. deBridge returns a serialized Solana transaction that is signed locally. Squid generates a deposit address, and the user sends SOL themselves.