apow-cli 0.1.0

package/.env.example

@@ -0,0 +1,24 @@
+# Wallet
+PRIVATE_KEY=
+
+# RPC
+RPC_URL=https://mainnet.base.org
+
+# LLM Provider (openai / anthropic / gemini / ollama / claude-code / codex)
+LLM_PROVIDER=openai
+LLM_MODEL=gpt-4o-mini
+
+# API key (not needed for ollama, claude-code, or codex)
+LLM_API_KEY=
+
+# Provider-specific keys (alternative to LLM_API_KEY)
+# OPENAI_API_KEY=
+# ANTHROPIC_API_KEY=
+# GEMINI_API_KEY=
+
+# Ollama (only if LLM_PROVIDER=ollama)
+# OLLAMA_URL=http://127.0.0.1:11434
+
+# Contract addresses (defaults built-in, override only if needed)
+# MINING_AGENT_ADDRESS=0xB7caD3ca5F2BD8aEC2Eb67d6E8D448099B3bC03D
+# AGENT_COIN_ADDRESS=0x12577CF0D8a07363224D6909c54C056A183e13b3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Agentoshi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,125 @@
+# APoW CLI
+
+Mining client for the [APoW (Agentic Proof of Work)](https://github.com/Agentoshi/apow-core) protocol on Base. Solve SMHL challenges with any LLM to mine $AGENT tokens.
+
+**Your agent does all the work — you just fund a wallet.**
+
+## Install
+
+```bash
+npm install -g apow-cli
+```
+
+Or run directly:
+
+```bash
+npx apow-cli
+```
+
+## For AI Agents
+
+Any AI agent can go from zero to actively mining in 5 steps — no human interaction except funding the wallet.
+
+```bash
+# 1. Generate a wallet
+npx apow-cli wallet new
+# → Captures address + private key from stdout
+
+# 2. Write .env (no interactive prompts)
+cat > .env << 'EOF'
+PRIVATE_KEY=0x<from step 1>
+RPC_URL=https://mainnet.base.org
+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
+
+# 4. Mint a mining rig NFT (solves SMHL challenge via LLM)
+npx apow-cli mint
+
+# 5. Start mining (runs forever, auto-detects best rig)
+npx apow-cli mine
+```
+
+**Scale up** with multiple wallets from a single funded wallet:
+
+```bash
+# Generate sub-wallets and fund them from your main wallet
+npx apow-cli wallet new                    # → sub-wallet address
+npx apow-cli wallet fund <sub-address>     # sends mint price + gas from main wallet
+
+# Mint + mine with each sub-wallet
+PRIVATE_KEY=<sub-key> npx apow-cli mint
+PRIVATE_KEY=<sub-key> npx apow-cli mine &
+```
+
+Each wallet gets one rig, each rig mines independently. More wallets = more chances to win each block. See [skill.md](skill.md) for the complete autonomous guide.
+
+## For Humans
+
+If you prefer to do it yourself:
+
+```bash
+# 1. Interactive setup — wallet, RPC, LLM config
+npx apow-cli setup
+
+# 2. Fund your wallet with ETH on Base (≥0.005 ETH)
+
+# 3. Mint a mining rig NFT
+npx apow-cli mint
+
+# 4. Start mining
+npx apow-cli mine
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `apow setup` | Interactive setup wizard — configure wallet, RPC, and LLM |
+| `apow wallet new` | Generate a new mining wallet |
+| `apow wallet show` | Show configured wallet address |
+| `apow wallet export` | Export your wallet's private key |
+| `apow wallet fund <addr> [eth]` | Send ETH to another address (default: mint price + gas) |
+| `apow mint` | Mint a MiningAgent NFT (one per wallet) |
+| `apow mine [tokenId]` | Mine $AGENT with your NFT (auto-detects best rig) |
+| `apow stats [tokenId]` | View mining stats, earnings, difficulty |
+
+## Configuration
+
+Create a `.env` file or use `apow setup`:
+
+```bash
+PRIVATE_KEY=0x...              # Your wallet private key
+RPC_URL=https://mainnet.base.org
+LLM_PROVIDER=openai            # openai | anthropic | gemini | ollama | claude-code | codex
+LLM_MODEL=gpt-4o-mini
+LLM_API_KEY=sk-...
+# Contract addresses (defaults built-in, override only if needed)
+# MINING_AGENT_ADDRESS=0xB7caD3ca5F2BD8aEC2Eb67d6E8D448099B3bC03D
+# AGENT_COIN_ADDRESS=0x12577CF0D8a07363224D6909c54C056A183e13b3
+```
+
+See [.env.example](.env.example) for all options.
+
+## LLM Providers
+
+| Provider | Model | Cost/call | Notes |
+|----------|-------|-----------|-------|
+| OpenAI | `gpt-4o-mini` | ~$0.001 | Cheapest cloud option |
+| Anthropic | `claude-sonnet-4-5-20250929` | ~$0.005 | High accuracy |
+| Gemini | `gemini-2.5-flash` | ~$0.001 | Fast |
+| Ollama | `llama3.1` | Free | Local GPU required |
+| Claude Code | `default` | Subscription | No API key needed |
+| Codex | `default` | Subscription | No API key needed |
+
+## Protocol
+
+The APoW protocol contracts and documentation live in [apow-core](https://github.com/Agentoshi/apow-core).
+
+## License
+
+MIT

package/dist/abi/AgentCoin.json

@@ -0,0 +1,173 @@
+[
+    {
+        "type": "function",
+        "name": "getMiningChallenge",
+        "stateMutability": "view",
+        "inputs": [],
+        "outputs": [
+            {
+                "name": "challenge",
+                "type": "bytes32"
+            },
+            {
+                "name": "target",
+                "type": "uint256"
+            },
+            {
+                "name": "smhl",
+                "type": "tuple",
+                "components": [
+                    { "name": "targetAsciiSum", "type": "uint16" },
+                    { "name": "firstNChars", "type": "uint8" },
+                    { "name": "wordCount", "type": "uint8" },
+                    { "name": "charPosition", "type": "uint8" },
+                    { "name": "charValue", "type": "uint8" },
+                    { "name": "totalLength", "type": "uint16" }
+                ]
+            }
+        ]
+    },
+    {
+        "type": "function",
+        "name": "mine",
+        "stateMutability": "nonpayable",
+        "inputs": [
+            {
+                "name": "nonce",
+                "type": "uint256"
+            },
+            {
+                "name": "smhlSolution",
+                "type": "string"
+            },
+            {
+                "name": "tokenId",
+                "type": "uint256"
+            }
+        ],
+        "outputs": []
+    },
+    {
+        "type": "function",
+        "name": "totalMines",
+        "stateMutability": "view",
+        "inputs": [],
+        "outputs": [
+            {
+                "name": "",
+                "type": "uint256"
+            }
+        ]
+    },
+    {
+        "type": "function",
+        "name": "totalMinted",
+        "stateMutability": "view",
+        "inputs": [],
+        "outputs": [
+            {
+                "name": "",
+                "type": "uint256"
+            }
+        ]
+    },
+    {
+        "type": "function",
+        "name": "miningTarget",
+        "stateMutability": "view",
+        "inputs": [],
+        "outputs": [
+            {
+                "name": "",
+                "type": "uint256"
+            }
+        ]
+    },
+    {
+        "type": "function",
+        "name": "tokenMineCount",
+        "stateMutability": "view",
+        "inputs": [
+            {
+                "name": "",
+                "type": "uint256"
+            }
+        ],
+        "outputs": [
+            {
+                "name": "",
+                "type": "uint256"
+            }
+        ]
+    },
+    {
+        "type": "function",
+        "name": "tokenEarnings",
+        "stateMutability": "view",
+        "inputs": [
+            {
+                "name": "",
+                "type": "uint256"
+            }
+        ],
+        "outputs": [
+            {
+                "name": "",
+                "type": "uint256"
+            }
+        ]
+    },
+    {
+        "type": "function",
+        "name": "balanceOf",
+        "stateMutability": "view",
+        "inputs": [
+            {
+                "name": "account",
+                "type": "address"
+            }
+        ],
+        "outputs": [
+            {
+                "name": "",
+                "type": "uint256"
+            }
+        ]
+    },
+    {
+        "type": "function",
+        "name": "lastMineBlockNumber",
+        "stateMutability": "view",
+        "inputs": [],
+        "outputs": [
+            {
+                "name": "",
+                "type": "uint256"
+            }
+        ]
+    },
+    {
+        "type": "function",
+        "name": "MINEABLE_SUPPLY",
+        "stateMutability": "view",
+        "inputs": [],
+        "outputs": [
+            {
+                "name": "",
+                "type": "uint256"
+            }
+        ]
+    },
+    {
+        "type": "function",
+        "name": "ERA_INTERVAL",
+        "stateMutability": "view",
+        "inputs": [],
+        "outputs": [
+            {
+                "name": "",
+                "type": "uint256"
+            }
+        ]
+    }
+]

package/dist/abi/MiningAgent.json

@@ -0,0 +1,186 @@
+[
+    {
+        "type": "function",
+        "name": "getChallenge",
+        "stateMutability": "nonpayable",
+        "inputs": [
+            {
+                "name": "minter",
+                "type": "address"
+            }
+        ],
+        "outputs": [
+            {
+                "name": "",
+                "type": "tuple",
+                "components": [
+                    { "name": "targetAsciiSum", "type": "uint16" },
+                    { "name": "firstNChars", "type": "uint8" },
+                    { "name": "wordCount", "type": "uint8" },
+                    { "name": "charPosition", "type": "uint8" },
+                    { "name": "charValue", "type": "uint8" },
+                    { "name": "totalLength", "type": "uint16" }
+                ]
+            }
+        ]
+    },
+    {
+        "type": "function",
+        "name": "challengeSeeds",
+        "stateMutability": "view",
+        "inputs": [
+            {
+                "name": "",
+                "type": "address"
+            }
+        ],
+        "outputs": [
+            {
+                "name": "",
+                "type": "bytes32"
+            }
+        ]
+    },
+    {
+        "type": "function",
+        "name": "mint",
+        "stateMutability": "payable",
+        "inputs": [
+            {
+                "name": "solution",
+                "type": "string"
+            }
+        ],
+        "outputs": []
+    },
+    {
+        "type": "function",
+        "name": "getMintPrice",
+        "stateMutability": "view",
+        "inputs": [],
+        "outputs": [
+            {
+                "name": "",
+                "type": "uint256"
+            }
+        ]
+    },
+    {
+        "type": "function",
+        "name": "hashpower",
+        "stateMutability": "view",
+        "inputs": [
+            {
+                "name": "",
+                "type": "uint256"
+            }
+        ],
+        "outputs": [
+            {
+                "name": "",
+                "type": "uint16"
+            }
+        ]
+    },
+    {
+        "type": "function",
+        "name": "rarity",
+        "stateMutability": "view",
+        "inputs": [
+            {
+                "name": "",
+                "type": "uint256"
+            }
+        ],
+        "outputs": [
+            {
+                "name": "",
+                "type": "uint8"
+            }
+        ]
+    },
+    {
+        "type": "function",
+        "name": "mintBlock",
+        "stateMutability": "view",
+        "inputs": [
+            {
+                "name": "",
+                "type": "uint256"
+            }
+        ],
+        "outputs": [
+            {
+                "name": "",
+                "type": "uint256"
+            }
+        ]
+    },
+    {
+        "type": "function",
+        "name": "ownerOf",
+        "stateMutability": "view",
+        "inputs": [
+            {
+                "name": "tokenId",
+                "type": "uint256"
+            }
+        ],
+        "outputs": [
+            {
+                "name": "",
+                "type": "address"
+            }
+        ]
+    },
+    {
+        "type": "function",
+        "name": "nextTokenId",
+        "stateMutability": "view",
+        "inputs": [],
+        "outputs": [
+            {
+                "name": "",
+                "type": "uint256"
+            }
+        ]
+    },
+    {
+        "type": "function",
+        "name": "balanceOf",
+        "stateMutability": "view",
+        "inputs": [
+            {
+                "name": "owner",
+                "type": "address"
+            }
+        ],
+        "outputs": [
+            {
+                "name": "",
+                "type": "uint256"
+            }
+        ]
+    },
+    {
+        "type": "function",
+        "name": "tokenOfOwnerByIndex",
+        "stateMutability": "view",
+        "inputs": [
+            {
+                "name": "owner",
+                "type": "address"
+            },
+            {
+                "name": "index",
+                "type": "uint256"
+            }
+        ],
+        "outputs": [
+            {
+                "name": "",
+                "type": "uint256"
+            }
+        ]
+    }
+]

package/dist/config.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.config = void 0;
+exports.requirePrivateKey = requirePrivateKey;
+exports.requireLlmApiKey = requireLlmApiKey;
+exports.isExpensiveModel = isExpensiveModel;
+exports.writeEnvFile = writeEnvFile;
+const dotenv_1 = require("dotenv");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const chains_1 = require("viem/chains");
+(0, dotenv_1.config)();
+const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+const DEFAULT_RPC_URL = "https://mainnet.base.org";
+const DEFAULT_LLM_PROVIDER = "openai";
+const DEFAULT_LLM_MODEL = "gpt-4o-mini";
+const DEFAULT_OLLAMA_URL = "http://127.0.0.1:11434";
+const DEFAULT_CHAIN_NAME = "base";
+const DEFAULT_MINING_AGENT_ADDRESS = "0xB7caD3ca5F2BD8aEC2Eb67d6E8D448099B3bC03D";
+const DEFAULT_AGENT_COIN_ADDRESS = "0x12577CF0D8a07363224D6909c54C056A183e13b3";
+const EXPENSIVE_MODELS = ["gpt-4o", "gpt-4", "claude-3-opus", "claude-3-5-sonnet"];
+const CHEAP_OVERRIDES = ["gpt-4o-mini", "gpt-4-mini"];
+function normalizeProvider(value) {
+    if (value === "anthropic" || value === "ollama" || value === "openai" || value === "gemini" || value === "claude-code" || value === "codex") {
+        return value;
+    }
+    return DEFAULT_LLM_PROVIDER;
+}
+function resolveChainName() {
+    const envChain = process.env.CHAIN;
+    if (envChain === "base" || envChain === "baseSepolia") {
+        return envChain;
+    }
+    const rpcUrl = process.env.RPC_URL ?? DEFAULT_RPC_URL;
+    if (rpcUrl.toLowerCase().includes("sepolia")) {
+        return "baseSepolia";
+    }
+    return DEFAULT_CHAIN_NAME;
+}
+function parsePrivateKey(value) {
+    if (!value) {
+        return undefined;
+    }
+    if (!/^0x[0-9a-fA-F]{64}$/.test(value)) {
+        throw new Error("PRIVATE_KEY must be a 32-byte hex string prefixed with 0x.");
+    }
+    return value;
+}
+function parseAddress(envKey, fallback) {
+    const value = process.env[envKey];
+    if (value && /^0x[0-9a-fA-F]{40}$/.test(value)) {
+        return value;
+    }
+    if (fallback) {
+        return fallback;
+    }
+    // Return zero address instead of throwing — preflight checks will catch this
+    return ZERO_ADDRESS;
+}
+function resolveLlmApiKey(provider) {
+    if (provider === "claude-code" || provider === "codex")
+        return "";
+    if (process.env.LLM_API_KEY)
+        return process.env.LLM_API_KEY;
+    switch (provider) {
+        case "openai": return process.env.OPENAI_API_KEY;
+        case "anthropic": return process.env.ANTHROPIC_API_KEY;
+        case "gemini": return process.env.GEMINI_API_KEY;
+        default: return undefined;
+    }
+}
+const chainName = resolveChainName();
+exports.config = {
+    privateKey: parsePrivateKey(process.env.PRIVATE_KEY),
+    rpcUrl: process.env.RPC_URL ?? DEFAULT_RPC_URL,
+    llmProvider: normalizeProvider(process.env.LLM_PROVIDER),
+    llmApiKey: resolveLlmApiKey(normalizeProvider(process.env.LLM_PROVIDER)),
+    llmModel: process.env.LLM_MODEL ?? DEFAULT_LLM_MODEL,
+    ollamaUrl: process.env.OLLAMA_URL ?? DEFAULT_OLLAMA_URL,
+    chain: chainName === "baseSepolia" ? chains_1.baseSepolia : chains_1.base,
+    chainName,
+    miningAgentAddress: parseAddress("MINING_AGENT_ADDRESS", DEFAULT_MINING_AGENT_ADDRESS),
+    agentCoinAddress: parseAddress("AGENT_COIN_ADDRESS", DEFAULT_AGENT_COIN_ADDRESS),
+};
+function requirePrivateKey() {
+    if (!exports.config.privateKey) {
+        throw new Error("PRIVATE_KEY is required for minting and mining commands.");
+    }
+    return exports.config.privateKey;
+}
+function requireLlmApiKey() {
+    if (exports.config.llmProvider === "ollama" || exports.config.llmProvider === "claude-code" || exports.config.llmProvider === "codex") {
+        return "";
+    }
+    if (!exports.config.llmApiKey) {
+        const keyNames = { openai: "OPENAI_API_KEY", anthropic: "ANTHROPIC_API_KEY", gemini: "GEMINI_API_KEY" };
+        const alt = keyNames[exports.config.llmProvider] ?? "";
+        throw new Error(`LLM_API_KEY${alt ? ` (or ${alt})` : ""} is required for ${exports.config.llmProvider}.`);
+    }
+    return exports.config.llmApiKey;
+}
+function isExpensiveModel(model) {
+    const m = model.toLowerCase();
+    if (CHEAP_OVERRIDES.some((c) => m.startsWith(c)))
+        return false;
+    return EXPENSIVE_MODELS.some((e) => m.startsWith(e));
+}
+async function writeEnvFile(values) {
+    const lines = Object.entries(values)
+        .map(([key, value]) => `${key}=${value}`)
+        .join("\n");
+    await (0, promises_1.writeFile)((0, node_path_1.join)(process.cwd(), ".env"), lines + "\n", "utf8");
+}