apow-cli 0.1.4 → 0.3.0

package/.env.example

@@ -1,7 +1,8 @@
 # Wallet
 PRIVATE_KEY=
 
-# RPC
+# RPC — The public default works but is unreliable for sustained mining.
+# We strongly recommend a free Alchemy endpoint: https://www.alchemy.com/ (no credit card)
 RPC_URL=https://mainnet.base.org
 
 # LLM Provider (openai / anthropic / gemini / ollama / claude-code / codex)
@@ -19,6 +20,10 @@ LLM_API_KEY=
 # Ollama (only if LLM_PROVIDER=ollama)
 # OLLAMA_URL=http://127.0.0.1:11434
 
+# Solana bridging (only needed for `apow fund --solana`)
+# SOLANA_RPC_URL=https://api.mainnet-beta.solana.com
+# SQUID_INTEGRATOR_ID=
+
 # Contract addresses (defaults built-in, override only if needed)
 # MINING_AGENT_ADDRESS=0xB7caD3ca5F2BD8aEC2Eb67d6E8D448099B3bC03D
 # AGENT_COIN_ADDRESS=0x12577CF0D8a07363224D6909c54C056A183e13b3

package/README.md

@@ -16,6 +16,16 @@ Or run directly:
 npx apow-cli
 ```
 
+## Important: RPC Endpoint
+
+> **The default public RPC (`mainnet.base.org`) is unreliable for mining.** It rate-limits aggressively and will cause frequent transaction failures. **We strongly recommend getting a free Alchemy endpoint** before you start:
+>
+> 1. Sign up at [alchemy.com](https://www.alchemy.com/) (free, no credit card)
+> 2. Create an app → Chain: **Base** → Network: **Base Mainnet**
+> 3. Copy the HTTPS URL → set `RPC_URL` in your `.env`
+>
+> Alchemy's free tier gives you 300M compute units/month — more than enough for mining. See [RPC Recommendations](skill.md#rpc-recommendations) for other free options.
+
 ## For AI Agents
 
 Any AI agent can go from zero to actively mining in 5 steps — no human interaction except funding the wallet.
@@ -28,14 +38,15 @@ npx apow-cli wallet new
 # 2. Write .env (no interactive prompts)
 cat > .env << 'EOF'
 PRIVATE_KEY=0x<from step 1>
-RPC_URL=https://mainnet.base.org
+RPC_URL=https://mainnet.base.org  # UNRELIABLE — get a free Alchemy URL (see above)
 LLM_PROVIDER=openai
 LLM_MODEL=gpt-4o-mini
 LLM_API_KEY=<your key>
 EOF
 
-# 3. Ask your user to fund the wallet with ≥0.005 ETH on Base
-#    This is the ONLY step that requires human action
+# 3. Fund the wallet (bridge from Solana or send ETH on Base)
+npx apow-cli fund --solana            # bridge SOL → ETH on Base
+# Or ask your user to send ≥0.005 ETH on Base directly
 
 # 4. Mint a mining rig NFT (solves SMHL challenge via LLM)
 npx apow-cli mint
@@ -66,7 +77,8 @@ If you prefer to do it yourself:
 # 1. Interactive setup — wallet, RPC, LLM config
 npx apow-cli setup
 
-# 2. Fund your wallet with ETH on Base (≥0.005 ETH)
+# 2. Fund your wallet (bridge from Solana or send ETH directly)
+npx apow-cli fund
 
 # 3. Mint a mining rig NFT
 npx apow-cli mint
@@ -80,6 +92,7 @@ npx apow-cli mine
 | Command | Description |
 |---------|-------------|
 | `apow setup` | Interactive setup wizard — configure wallet, RPC, and LLM |
+| `apow fund` | Fund your wallet — bridge SOL → ETH on Base, or show deposit address |
 | `apow wallet new` | Generate a new mining wallet |
 | `apow wallet show` | Show configured wallet address |
 | `apow wallet export` | Export your wallet's private key |
@@ -94,10 +107,13 @@ Create a `.env` file or use `apow setup`:
 
 ```bash
 PRIVATE_KEY=0x...              # Your wallet private key
-RPC_URL=https://mainnet.base.org
+RPC_URL=https://mainnet.base.org  # UNRELIABLE — strongly recommend a free Alchemy URL instead (see above)
 LLM_PROVIDER=openai            # openai | anthropic | gemini | ollama | claude-code | codex
 LLM_MODEL=gpt-4o-mini
 LLM_API_KEY=sk-...
+# Solana bridging (only for `apow fund --solana`)
+# SOLANA_RPC_URL=https://api.mainnet-beta.solana.com
+# 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
 # AGENT_COIN_ADDRESS=0x12577CF0D8a07363224D6909c54C056A183e13b3

package/dist/abi/MiningAgent.json

@@ -182,5 +182,22 @@
                 "type": "uint256"
             }
         ]
+    },
+    {
+        "type": "function",
+        "name": "tokenURI",
+        "stateMutability": "view",
+        "inputs": [
+            {
+                "name": "tokenId",
+                "type": "uint256"
+            }
+        ],
+        "outputs": [
+            {
+                "name": "",
+                "type": "string"
+            }
+        ]
     }
 ]

package/dist/bridge/debridge.js

@@ -0,0 +1,128 @@
+"use strict";
+// deBridge DLN bridge — direct signing flow (Option A).
+// SOL → native ETH on Base in ~20 seconds via DLN market makers.
+// No API key needed.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bridgeViaDeBridge = bridgeViaDeBridge;
+exports.pollOrderStatus = pollOrderStatus;
+const solana = __importStar(require("./solana"));
+const DLN_API = "https://dln.debridge.finance/v1.0";
+const SOLANA_CHAIN_ID = "7565164";
+const BASE_CHAIN_ID = "8453";
+const NATIVE_SOL = "11111111111111111111111111111111"; // System Program = native SOL
+const NATIVE_ETH = "0x0000000000000000000000000000000000000000";
+/**
+ * Create and submit a deBridge DLN order: SOL → ETH on Base.
+ * Returns after the Solana tx is confirmed. Call pollOrderStatus() to wait for fulfillment.
+ */
+async function bridgeViaDeBridge(solanaKeypair, baseAddress, solAmount) {
+    const startTime = Date.now();
+    const lamports = Math.floor(solAmount * 1e9);
+    const srcPublicKey = solanaKeypair.publicKey.toBase58();
+    // Step 1: Get serialized bridge transaction from DLN
+    const params = new URLSearchParams({
+        srcChainId: SOLANA_CHAIN_ID,
+        srcChainTokenIn: NATIVE_SOL,
+        srcChainTokenInAmount: lamports.toString(),
+        dstChainId: BASE_CHAIN_ID,
+        dstChainTokenOut: NATIVE_ETH,
+        dstChainTokenOutRecipient: baseAddress,
+        senderAddress: srcPublicKey,
+        srcChainOrderAuthorityAddress: srcPublicKey,
+        dstChainOrderAuthorityAddress: baseAddress,
+    });
+    const response = await fetch(`${DLN_API}/dln/order/create-tx?${params}`);
+    if (!response.ok) {
+        const body = await response.text();
+        throw new Error(`deBridge API error (${response.status}): ${body}`);
+    }
+    const data = await response.json();
+    if (data.errorCode || data.error) {
+        throw new Error(`deBridge error: ${data.error || data.message || JSON.stringify(data)}`);
+    }
+    const orderId = data.orderId;
+    const txData = data.tx?.data;
+    if (!txData) {
+        throw new Error("deBridge API returned no transaction data");
+    }
+    // Step 2: Sign and submit on Solana
+    const txSignature = await solana.signAndSendTransaction(txData, solanaKeypair);
+    return {
+        orderId,
+        txSignature,
+        status: "submitted",
+        timeMs: Date.now() - startTime,
+    };
+}
+/**
+ * Poll deBridge order status until fulfilled, cancelled, or timeout.
+ * Default timeout: 5 minutes.
+ */
+async function pollOrderStatus(orderId, onUpdate, timeoutMs = 300_000) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        try {
+            const response = await fetch(`${DLN_API}/dln/order/${orderId}/status`);
+            if (response.ok) {
+                const data = await response.json();
+                const status = data.status || data.orderStatus || "unknown";
+                if (onUpdate)
+                    onUpdate(status);
+                if (status === "Fulfilled" ||
+                    status === "ClaimedUnlock" ||
+                    status === "SentUnlock") {
+                    return {
+                        status: "fulfilled",
+                        ethReceived: data.fulfilledDstAmount
+                            ? (Number(data.fulfilledDstAmount) / 1e18).toFixed(6)
+                            : undefined,
+                    };
+                }
+                if (status === "Cancelled" || status === "CancelledByMaker") {
+                    throw new Error(`Bridge order was cancelled: ${status}`);
+                }
+            }
+        }
+        catch (err) {
+            if (err instanceof Error && err.message.includes("cancelled"))
+                throw err;
+            // Transient fetch error — keep polling
+        }
+        await new Promise((r) => setTimeout(r, 5000));
+    }
+    throw new Error("Bridge order timed out after 5 minutes. Check deBridge explorer for order: " +
+        orderId);
+}

package/dist/bridge/solana.js

@@ -0,0 +1,129 @@
+"use strict";
+// Solana wallet utilities — key parsing, balance checks, transaction signing.
+// Uses dynamic import() for @solana/web3.js to avoid bloating startup.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSolanaRpcUrl = getSolanaRpcUrl;
+exports.parseSolanaKey = parseSolanaKey;
+exports.getSolanaBalance = getSolanaBalance;
+exports.getAddressBalance = getAddressBalance;
+exports.signAndSendTransaction = signAndSendTransaction;
+const DEFAULT_SOLANA_RPC = "https://api.mainnet-beta.solana.com";
+const BASE58_ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
+function base58Decode(str) {
+    const bytes = [];
+    for (const char of str) {
+        const idx = BASE58_ALPHABET.indexOf(char);
+        if (idx === -1)
+            throw new Error(`Invalid base58 character: ${char}`);
+        let carry = idx;
+        for (let j = 0; j < bytes.length; j++) {
+            carry += bytes[j] * 58;
+            bytes[j] = carry & 0xff;
+            carry >>= 8;
+        }
+        while (carry > 0) {
+            bytes.push(carry & 0xff);
+            carry >>= 8;
+        }
+    }
+    // Preserve leading zeros
+    for (const char of str) {
+        if (char !== "1")
+            break;
+        bytes.push(0);
+    }
+    return new Uint8Array(bytes.reverse());
+}
+function getSolanaRpcUrl() {
+    return process.env.SOLANA_RPC_URL || DEFAULT_SOLANA_RPC;
+}
+/** Parse a base58-encoded Solana secret key (64 bytes) or seed (32 bytes). */
+async function parseSolanaKey(input) {
+    const { Keypair } = await Promise.resolve().then(() => __importStar(require("@solana/web3.js")));
+    const trimmed = input.trim();
+    // Try JSON array format first (Solana CLI keygen output)
+    if (trimmed.startsWith("[")) {
+        try {
+            const arr = JSON.parse(trimmed);
+            const keypair = Keypair.fromSecretKey(new Uint8Array(arr));
+            return { keypair, publicKey: keypair.publicKey.toBase58() };
+        }
+        catch {
+            throw new Error("Invalid Solana key: looks like JSON but could not parse.");
+        }
+    }
+    // Base58 secret key (Phantom, Backpack export format)
+    const decoded = base58Decode(trimmed);
+    if (decoded.length === 64) {
+        const keypair = Keypair.fromSecretKey(decoded);
+        return { keypair, publicKey: keypair.publicKey.toBase58() };
+    }
+    if (decoded.length === 32) {
+        // 32-byte seed
+        const keypair = Keypair.fromSeed(decoded);
+        return { keypair, publicKey: keypair.publicKey.toBase58() };
+    }
+    throw new Error(`Invalid Solana key: expected 64 bytes (secret key) or 32 bytes (seed), got ${decoded.length}. Provide the full base58-encoded secret key from your wallet.`);
+}
+/** Get SOL balance for a public key (in SOL, not lamports). */
+async function getSolanaBalance(publicKeyBase58) {
+    const { Connection, PublicKey } = await Promise.resolve().then(() => __importStar(require("@solana/web3.js")));
+    const connection = new Connection(getSolanaRpcUrl(), "confirmed");
+    const lamports = await connection.getBalance(new PublicKey(publicKeyBase58));
+    return lamports / 1e9;
+}
+/** Get SOL balance for any address (used to detect deposits). */
+async function getAddressBalance(address) {
+    const { Connection, PublicKey } = await Promise.resolve().then(() => __importStar(require("@solana/web3.js")));
+    const connection = new Connection(getSolanaRpcUrl(), "confirmed");
+    const lamports = await connection.getBalance(new PublicKey(address));
+    return lamports / 1e9;
+}
+/** Deserialize, sign, and submit a base64-encoded Solana transaction. */
+async function signAndSendTransaction(serializedTxBase64, keypair) {
+    const { Connection, VersionedTransaction } = await Promise.resolve().then(() => __importStar(require("@solana/web3.js")));
+    const connection = new Connection(getSolanaRpcUrl(), "confirmed");
+    const txBuffer = Buffer.from(serializedTxBase64, "base64");
+    const tx = VersionedTransaction.deserialize(txBuffer);
+    tx.sign([keypair]);
+    const signature = await connection.sendTransaction(tx, {
+        skipPreflight: false,
+        preflightCommitment: "confirmed",
+    });
+    const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash("confirmed");
+    await connection.confirmTransaction({ signature, blockhash, lastValidBlockHeight }, "confirmed");
+    return signature;
+}

package/dist/bridge/squid.js

@@ -0,0 +1,128 @@
+"use strict";
+// Squid Router bridge — deposit address flow (Options B+C).
+// SOL → ETH on Base via Chainflip multi-hop (~1-3 minutes).
+// Requires SQUID_INTEGRATOR_ID (free, apply at squidrouter.com).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDepositAddress = getDepositAddress;
+exports.pollBridgeStatus = pollBridgeStatus;
+const SQUID_API = "https://v2.api.squidrouter.com/v2";
+const SOLANA_CHAIN_ID = "solana";
+const BASE_CHAIN_ID = "8453";
+const NATIVE_SOL_ADDRESS = "So11111111111111111111111111111111111111112"; // Wrapped SOL mint
+const NATIVE_ETH_ADDRESS = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";
+function getIntegratorId() {
+    const id = process.env.SQUID_INTEGRATOR_ID;
+    if (!id) {
+        throw new Error("SQUID_INTEGRATOR_ID is required for the deposit address flow.\n" +
+            "Get one free at https://app.squidrouter.com/\n" +
+            "Or use direct signing instead: apow fund --solana --key <base58>");
+    }
+    return id;
+}
+/**
+ * Get a Squid deposit address for SOL → ETH on Base bridging.
+ * User sends SOL to this address from any wallet; Squid handles the rest.
+ */
+async function getDepositAddress(baseAddress, solAmount) {
+    const integratorId = getIntegratorId();
+    const lamports = Math.floor(solAmount * 1e9).toString();
+    // Step 1: Get route quote
+    const routeResponse = await fetch(`${SQUID_API}/route`, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "x-integrator-id": integratorId,
+        },
+        body: JSON.stringify({
+            fromChain: SOLANA_CHAIN_ID,
+            toChain: BASE_CHAIN_ID,
+            fromToken: NATIVE_SOL_ADDRESS,
+            toToken: NATIVE_ETH_ADDRESS,
+            fromAmount: lamports,
+            toAddress: baseAddress,
+            quoteOnly: false,
+            enableBoost: true,
+            prefer: ["CHAINFLIP_DEPOSIT_ADDRESS"],
+        }),
+    });
+    if (!routeResponse.ok) {
+        const body = await routeResponse.text();
+        throw new Error(`Squid route API error (${routeResponse.status}): ${body}`);
+    }
+    const routeData = (await routeResponse.json());
+    if (routeData.error) {
+        throw new Error(`Squid route error: ${routeData.error.message || JSON.stringify(routeData.error)}`);
+    }
+    // Step 2: Request deposit address from route
+    const depositResponse = await fetch(`${SQUID_API}/deposit-address`, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "x-integrator-id": integratorId,
+        },
+        body: JSON.stringify({
+            routeData: routeData.route,
+        }),
+    });
+    if (!depositResponse.ok) {
+        const body = await depositResponse.text();
+        throw new Error(`Squid deposit-address API error (${depositResponse.status}): ${body}`);
+    }
+    const depositData = (await depositResponse.json());
+    const estimatedReceive = routeData.route?.estimate?.toAmount
+        ? (Number(routeData.route.estimate.toAmount) / 1e18).toFixed(6)
+        : "unknown";
+    return {
+        depositAddress: depositData.depositAddress,
+        requestId: depositData.requestId || routeData.requestId,
+        expectedReceive: estimatedReceive,
+        expiresAt: depositData.expiresAt,
+    };
+}
+/**
+ * Poll Squid bridge status until complete, failed, or timeout.
+ * Default timeout: 10 minutes (Chainflip can be slow).
+ */
+async function pollBridgeStatus(requestId, onUpdate, timeoutMs = 600_000) {
+    const integratorId = getIntegratorId();
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        try {
+            const params = new URLSearchParams({
+                requestId,
+                bridgeType: "chainflipmultihop",
+            });
+            const response = await fetch(`${SQUID_API}/status?${params}`, {
+                headers: { "x-integrator-id": integratorId },
+            });
+            if (response.ok) {
+                const data = (await response.json());
+                const status = data.squidTransactionStatus || data.status || "unknown";
+                if (onUpdate)
+                    onUpdate(status);
+                if (status === "success" ||
+                    status === "completed" ||
+                    status === "destination_executed") {
+                    return {
+                        status: "fulfilled",
+                        ethReceived: data.toChain?.amount
+                            ? (Number(data.toChain.amount) / 1e18).toFixed(6)
+                            : undefined,
+                    };
+                }
+                if (status === "failed" || status === "refunded") {
+                    throw new Error(`Bridge failed with status: ${status}`);
+                }
+            }
+        }
+        catch (err) {
+            if (err instanceof Error &&
+                (err.message.includes("failed") || err.message.includes("refunded"))) {
+                throw err;
+            }
+            // Transient fetch error — keep polling
+        }
+        await new Promise((r) => setTimeout(r, 5000));
+    }
+    throw new Error("Bridge timed out after 10 minutes. Check Squid explorer: https://axelarscan.io/");
+}