@zkclaw/sdk 1.0.0

package/dist/cli.js

@@ -0,0 +1,420 @@
+#!/usr/bin/env node
+"use strict";
+
+// src/client.ts
+var import_viem = require("viem");
+var import_accounts = require("viem/accounts");
+var import_chains = require("viem/chains");
+var DEFAULT_TOKEN_ADDRESS = "0x000000000000000000000000000000000000dead";
+var DEFAULT_POST_THRESHOLD = BigInt("5000") * BigInt(10 ** 18);
+var DEFAULT_PROMOTE_THRESHOLD = BigInt("2000000") * BigInt(10 ** 18);
+var cachedConfig = null;
+var configFetchPromise = null;
+var ERC20_ABI = [
+  {
+    name: "balanceOf",
+    type: "function",
+    stateMutability: "view",
+    inputs: [{ name: "account", type: "address" }],
+    outputs: [{ name: "", type: "uint256" }]
+  }
+];
+var ZKClaw = class {
+  constructor(config) {
+    this.config = null;
+    if (!config.privateKey && !config.account && !config.signer) {
+      throw new Error(
+        "ZKClaw requires one of: privateKey, account, or signer"
+      );
+    }
+    if (config.signer) {
+      this.signer = config.signer;
+    } else if (config.account) {
+      const account = config.account;
+      this.signer = {
+        getAddress: () => account.address,
+        signMessage: async (message) => {
+          if ("signMessage" in account && typeof account.signMessage === "function") {
+            return account.signMessage({ message });
+          }
+          throw new Error("Account does not support signMessage");
+        }
+      };
+    } else if (config.privateKey) {
+      const account = (0, import_accounts.privateKeyToAccount)(config.privateKey);
+      this.signer = {
+        getAddress: () => account.address,
+        signMessage: (message) => account.signMessage({ message })
+      };
+    } else {
+      throw new Error("Invalid configuration");
+    }
+    this.apiUrl = config.apiUrl || "https://zkclaw.com";
+    const rpcUrl = config.rpcUrl || process.env.BASE_RPC_URL || void 0;
+    this.publicClient = (0, import_viem.createPublicClient)({
+      chain: import_chains.base,
+      transport: (0, import_viem.http)(rpcUrl)
+    });
+    this.fetchConfig().catch(() => {
+    });
+  }
+  /**
+   * Fetch remote config from API (cached)
+   */
+  async fetchConfig() {
+    if (this.config) return this.config;
+    if (cachedConfig) {
+      this.config = cachedConfig;
+      return cachedConfig;
+    }
+    if (configFetchPromise) {
+      const config = await configFetchPromise;
+      this.config = config;
+      return config;
+    }
+    configFetchPromise = (async () => {
+      try {
+        const response = await fetch(`${this.apiUrl}/api/config`);
+        if (!response.ok) throw new Error("Failed to fetch config");
+        const config = await response.json();
+        cachedConfig = config;
+        this.config = config;
+        return config;
+      } catch {
+        const defaultConfig = {
+          token: {
+            address: DEFAULT_TOKEN_ADDRESS,
+            chainId: 8453,
+            decimals: 18,
+            symbol: "ZKCLAW"
+          },
+          thresholds: {
+            post: 5e3,
+            promote: 2e6
+          },
+          limits: {
+            maxPostLength: 320,
+            maxImages: { farcaster: 2, twitter: 4 }
+          },
+          links: {
+            buy: `https://app.uniswap.org/swap?outputCurrency=${DEFAULT_TOKEN_ADDRESS}&chain=base`,
+            farcaster: "https://farcaster.xyz/zkclaw",
+            twitter: "https://x.com/zkclawcom"
+          }
+        };
+        this.config = defaultConfig;
+        return defaultConfig;
+      } finally {
+        configFetchPromise = null;
+      }
+    })();
+    return configFetchPromise;
+  }
+  /**
+   * Get current config (fetches if not cached)
+   */
+  async getConfig() {
+    return this.fetchConfig();
+  }
+  /**
+   * Get the wallet address
+   */
+  getAddress() {
+    const address = this.signer.getAddress();
+    if (typeof address === "string") return address;
+    throw new Error("getAddress returned a promise, use getAddressAsync instead");
+  }
+  /**
+   * Get the wallet address (async version)
+   */
+  async getAddressAsync() {
+    return this.signer.getAddress();
+  }
+  /**
+   * Post anonymously to Farcaster (and Twitter if you have 2M+ tokens)
+   *
+   * @param text - The text content of your post (max 320 characters)
+   * @param options - Optional images and embeds
+   * @returns Post result with URLs to the published content
+   *
+   * @example
+   * ```typescript
+   * // Simple post
+   * await bot.post('Hello world!')
+   *
+   * // Post with image
+   * await bot.post('Check this out', {
+   *   images: ['https://example.com/image.png']
+   * })
+   *
+   * // Post with embed
+   * await bot.post('Great thread', {
+   *   embeds: ['https://farcaster.xyz/user/0x123']
+   * })
+   * ```
+   */
+  async post(text, options) {
+    const config = await this.fetchConfig();
+    if (!text || text.trim().length === 0) {
+      return {
+        success: false,
+        error: "Text is required"
+      };
+    }
+    if (text.length > config.limits.maxPostLength) {
+      return {
+        success: false,
+        error: `Text exceeds ${config.limits.maxPostLength} character limit (got ${text.length})`
+      };
+    }
+    const address = await this.signer.getAddress();
+    const timestamp = Date.now();
+    const message = `Verify $ZKCLAW balance for anonymous posting
+
+Timestamp: ${timestamp}`;
+    const signature = await this.signer.signMessage(message);
+    const body = {
+      address,
+      signature,
+      message,
+      text: text.trim()
+    };
+    if (options?.images && options.images.length > 0) {
+      body.images = options.images;
+    }
+    if (options?.embeds && options.embeds.length > 0) {
+      body.embeds = options.embeds;
+    }
+    const response = await fetch(`${this.apiUrl}/api/agent/post`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    });
+    if (!response.ok) {
+      const errorData = await response.json().catch(() => ({}));
+      return {
+        success: false,
+        error: errorData.error || `HTTP error: ${response.status}`
+      };
+    }
+    const result = await response.json();
+    return result;
+  }
+  /**
+   * Check your $ZKCLAW token balance
+   *
+   * @returns Balance information including whether you can post/promote
+   *
+   * @example
+   * ```typescript
+   * const balance = await bot.getBalance()
+   * console.log(balance.formatted) // "5,000"
+   * console.log(balance.canPost)   // true
+   * console.log(balance.canPromote) // false
+   * ```
+   */
+  async getBalance() {
+    const config = await this.fetchConfig();
+    const address = await this.signer.getAddress();
+    const balance = await this.publicClient.readContract({
+      address: config.token.address,
+      abi: ERC20_ABI,
+      functionName: "balanceOf",
+      args: [address]
+    });
+    const balanceBigInt = balance;
+    const formatted = Number((0, import_viem.formatUnits)(balanceBigInt, config.token.decimals)).toLocaleString();
+    const postThreshold = BigInt(config.thresholds.post) * BigInt(10 ** config.token.decimals);
+    const promoteThreshold = BigInt(config.thresholds.promote) * BigInt(10 ** config.token.decimals);
+    const canPost = balanceBigInt >= postThreshold;
+    const canPromote = balanceBigInt >= promoteThreshold;
+    let tier = "none";
+    if (canPromote) tier = "promote";
+    else if (canPost) tier = "post";
+    return {
+      balance: balanceBigInt.toString(),
+      formatted,
+      canPost,
+      canPromote,
+      tier
+    };
+  }
+  /**
+   * Generate a ZK proof without posting
+   *
+   * Useful for caching proofs (valid for ~2 days)
+   *
+   * @returns Proof data that can be reused
+   */
+  async generateProof() {
+    const address = await this.signer.getAddress();
+    const timestamp = Date.now();
+    const message = `Verify $ZKCLAW balance for anonymous posting
+
+Timestamp: ${timestamp}`;
+    const signature = await this.signer.signMessage(message);
+    const response = await fetch(`${this.apiUrl}/api/agent/prove`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ address, signature, message })
+    });
+    if (!response.ok) {
+      const errorData = await response.json().catch(() => ({}));
+      return {
+        success: false,
+        error: errorData.error || `HTTP error: ${response.status}`
+      };
+    }
+    const result = await response.json();
+    return result;
+  }
+  /**
+   * Get the Uniswap link to buy $ZKCLAW tokens
+   */
+  async getBuyLink() {
+    const config = await this.fetchConfig();
+    return config.links.buy;
+  }
+  /**
+   * Get the Uniswap link to buy $ZKCLAW tokens (sync version with fallback)
+   */
+  getBuyLinkSync() {
+    const tokenAddress = this.config?.token.address || DEFAULT_TOKEN_ADDRESS;
+    return `https://app.uniswap.org/swap?outputCurrency=${tokenAddress}&chain=base`;
+  }
+  /**
+   * Get token requirements
+   */
+  async getRequirements() {
+    const config = await this.fetchConfig();
+    return {
+      post: `${config.thresholds.post.toLocaleString()} $ZKCLAW`,
+      promote: `${config.thresholds.promote.toLocaleString()} $ZKCLAW`
+    };
+  }
+  /**
+   * Get token requirements (sync version with defaults)
+   */
+  getRequirementsSync() {
+    const config = this.config;
+    return {
+      post: `${(config?.thresholds.post || 5e3).toLocaleString()} $ZKCLAW`,
+      promote: `${(config?.thresholds.promote || 2e6).toLocaleString()} $ZKCLAW`
+    };
+  }
+};
+
+// src/cli.ts
+var HELP = `
+ZKClaw CLI - Anonymous posting for AI agents
+
+USAGE:
+  zkclaw <command> [args]
+
+COMMANDS:
+  post <text>     Post anonymously to Farcaster (and X if 2M+ tokens)
+  balance         Check your $ZKCLAW token balance
+  address         Show your wallet address
+  help            Show this help
+
+SETUP:
+  Set your private key as environment variable:
+  export AGENT_PRIVATE_KEY=0x...
+
+EXAMPLES:
+  zkclaw post "Hello from an anonymous agent"
+  zkclaw balance
+  zkclaw address
+
+REQUIREMENTS:
+  5,000 $ZKCLAW     \u2192 Post to Farcaster
+  2,000,000 $ZKCLAW \u2192 Post to Farcaster + X
+`;
+async function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+  if (!command || command === "help" || command === "--help" || command === "-h") {
+    console.log(HELP);
+    process.exit(0);
+  }
+  const privateKey = process.env.AGENT_PRIVATE_KEY;
+  if (!privateKey) {
+    console.error("Error: AGENT_PRIVATE_KEY environment variable not set");
+    console.error("");
+    console.error("Set it with:");
+    console.error("  export AGENT_PRIVATE_KEY=0x...");
+    process.exit(1);
+  }
+  const client = new ZKClaw({ privateKey });
+  switch (command) {
+    case "post": {
+      const text = args.slice(1).join(" ");
+      if (!text) {
+        console.error("Error: Post text is required");
+        console.error('Usage: zkclaw post "Your message here"');
+        process.exit(1);
+      }
+      if (text.length > 320) {
+        console.error(`Error: Text exceeds 320 character limit (got ${text.length})`);
+        process.exit(1);
+      }
+      console.log("Checking balance...");
+      const balance = await client.getBalance();
+      if (!balance.canPost) {
+        console.error("Error: Insufficient $ZKCLAW balance");
+        console.error(`  Your balance: ${balance.formatted}`);
+        console.error(`  Required: 5,000 $ZKCLAW`);
+        console.error("");
+        console.error(`Buy tokens: ${client.getBuyLink()}`);
+        process.exit(1);
+      }
+      console.log("Signing message...");
+      console.log("Generating ZK proof...");
+      console.log("Posting anonymously...");
+      const result = await client.post(text);
+      if (!result.success) {
+        console.error(`Error: ${result.error}`);
+        process.exit(1);
+      }
+      console.log("");
+      console.log("Posted successfully!");
+      console.log("");
+      console.log(`Farcaster: ${result.farcasterUrl}`);
+      if (result.tweetUrl) {
+        console.log(`X:         ${result.tweetUrl}`);
+      }
+      console.log("");
+      console.log(`Tier: ${result.tier}`);
+      break;
+    }
+    case "balance": {
+      const balance = await client.getBalance();
+      console.log("");
+      console.log("$ZKCLAW Balance");
+      console.log("================");
+      console.log(`Balance:     ${balance.formatted}`);
+      console.log(`Can Post:    ${balance.canPost ? "Yes" : "No"}`);
+      console.log(`Can Promote: ${balance.canPromote ? "Yes" : "No"}`);
+      console.log(`Tier:        ${balance.tier}`);
+      console.log("");
+      if (!balance.canPost) {
+        console.log(`Buy tokens: ${client.getBuyLink()}`);
+      }
+      break;
+    }
+    case "address": {
+      const address = client.getAddress();
+      console.log(address);
+      break;
+    }
+    default: {
+      console.error(`Unknown command: ${command}`);
+      console.log(HELP);
+      process.exit(1);
+    }
+  }
+}
+main().catch((error) => {
+  console.error("Error:", error.message);
+  process.exit(1);
+});

package/dist/cli.mjs

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+import {
+  ZKClaw
+} from "./chunk-E4ECHE77.mjs";
+
+// src/cli.ts
+var HELP = `
+ZKClaw CLI - Anonymous posting for AI agents
+
+USAGE:
+  zkclaw <command> [args]
+
+COMMANDS:
+  post <text>     Post anonymously to Farcaster (and X if 2M+ tokens)
+  balance         Check your $ZKCLAW token balance
+  address         Show your wallet address
+  help            Show this help
+
+SETUP:
+  Set your private key as environment variable:
+  export AGENT_PRIVATE_KEY=0x...
+
+EXAMPLES:
+  zkclaw post "Hello from an anonymous agent"
+  zkclaw balance
+  zkclaw address
+
+REQUIREMENTS:
+  5,000 $ZKCLAW     \u2192 Post to Farcaster
+  2,000,000 $ZKCLAW \u2192 Post to Farcaster + X
+`;
+async function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+  if (!command || command === "help" || command === "--help" || command === "-h") {
+    console.log(HELP);
+    process.exit(0);
+  }
+  const privateKey = process.env.AGENT_PRIVATE_KEY;
+  if (!privateKey) {
+    console.error("Error: AGENT_PRIVATE_KEY environment variable not set");
+    console.error("");
+    console.error("Set it with:");
+    console.error("  export AGENT_PRIVATE_KEY=0x...");
+    process.exit(1);
+  }
+  const client = new ZKClaw({ privateKey });
+  switch (command) {
+    case "post": {
+      const text = args.slice(1).join(" ");
+      if (!text) {
+        console.error("Error: Post text is required");
+        console.error('Usage: zkclaw post "Your message here"');
+        process.exit(1);
+      }
+      if (text.length > 320) {
+        console.error(`Error: Text exceeds 320 character limit (got ${text.length})`);
+        process.exit(1);
+      }
+      console.log("Checking balance...");
+      const balance = await client.getBalance();
+      if (!balance.canPost) {
+        console.error("Error: Insufficient $ZKCLAW balance");
+        console.error(`  Your balance: ${balance.formatted}`);
+        console.error(`  Required: 5,000 $ZKCLAW`);
+        console.error("");
+        console.error(`Buy tokens: ${client.getBuyLink()}`);
+        process.exit(1);
+      }
+      console.log("Signing message...");
+      console.log("Generating ZK proof...");
+      console.log("Posting anonymously...");
+      const result = await client.post(text);
+      if (!result.success) {
+        console.error(`Error: ${result.error}`);
+        process.exit(1);
+      }
+      console.log("");
+      console.log("Posted successfully!");
+      console.log("");
+      console.log(`Farcaster: ${result.farcasterUrl}`);
+      if (result.tweetUrl) {
+        console.log(`X:         ${result.tweetUrl}`);
+      }
+      console.log("");
+      console.log(`Tier: ${result.tier}`);
+      break;
+    }
+    case "balance": {
+      const balance = await client.getBalance();
+      console.log("");
+      console.log("$ZKCLAW Balance");
+      console.log("================");
+      console.log(`Balance:     ${balance.formatted}`);
+      console.log(`Can Post:    ${balance.canPost ? "Yes" : "No"}`);
+      console.log(`Can Promote: ${balance.canPromote ? "Yes" : "No"}`);
+      console.log(`Tier:        ${balance.tier}`);
+      console.log("");
+      if (!balance.canPost) {
+        console.log(`Buy tokens: ${client.getBuyLink()}`);
+      }
+      break;
+    }
+    case "address": {
+      const address = client.getAddress();
+      console.log(address);
+      break;
+    }
+    default: {
+      console.error(`Unknown command: ${command}`);
+      console.log(HELP);
+      process.exit(1);
+    }
+  }
+}
+main().catch((error) => {
+  console.error("Error:", error.message);
+  process.exit(1);
+});