@signet-base/cli 0.2.2 → 0.3.1

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@signet-base/cli",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "description": "CLI for Signet onchain advertising — list and post spotlight ads",
   "type": "module",
   "bin": {
     "signet": "./bin/signet.js",
-    "signet-cli": "./bin/signet.js"
+    "signet-base": "./bin/signet.js"
   },
   "scripts": {
     "start": "node bin/signet.js",

package/src/api.js

@@ -1,25 +1,11 @@
 /**
- * Signet API client
+ * Signet API client — only for x402 spotlight endpoint (requires HTTP for payment headers)
  */
 
 const DEFAULT_BASE_URL = "https://signet.sebayaki.com";
 
-export async function fetchEstimate(guaranteeHours = 0, baseUrl = DEFAULT_BASE_URL) {
-  const res = await fetch(`${baseUrl}/api/x402/estimate?guaranteeHours=${guaranteeHours}`);
-  if (!res.ok) throw new Error(`Estimate failed: ${res.status} ${await res.text()}`);
-  return res.json();
-}
-
-export async function fetchSignatures(startIndex = 0, endIndex = 5, baseUrl = DEFAULT_BASE_URL) {
-  const res = await fetch(
-    `${baseUrl}/api/signature/list?startIndex=${startIndex}&endIndex=${endIndex}`
-  );
-  if (!res.ok) throw new Error(`List failed: ${res.status} ${await res.text()}`);
-  return res.json();
-}
-
 /**
- * POST to spotlight endpoint. Returns the raw Response for 402 handling.
+ * POST to spotlight endpoint. Returns the raw Response for x402 header handling.
  */
 export async function postSpotlightRaw({ url, guaranteeHours, headers = {}, baseUrl = DEFAULT_BASE_URL }) {
   return fetch(`${baseUrl}/api/x402/spotlight`, {

package/src/commands/estimate.js

@@ -1,18 +1,21 @@
-import { fetchEstimate } from "../api.js";
+import { estimateUSDC, getSpotlightStatus } from "../contract.js";
 
 export async function estimate(opts) {
   const hours = parseInt(opts.hours);
 
   try {
-    const data = await fetchEstimate(hours, opts.baseUrl);
+    const [priceData, spotlight] = await Promise.all([
+      estimateUSDC(hours),
+      getSpotlightStatus(),
+    ]);
 
-    console.log(`\n💰 Signet Spotlight Estimate${opts.simulate ? " (SIMULATE)" : ""}\n`);
-    console.log(`  Guarantee Hours: ${data.guaranteeHours}`);
-    console.log(`  Estimated Cost:  $${data.estimatedUSDC} USDC`);
-    console.log(`  Spotlight Available: ${data.spotlightAvailable ? "✅ Yes" : "❌ No"}`);
+    console.log(`\n💰 Signet Spotlight Estimate\n`);
+    console.log(`  Guarantee Hours: ${hours}`);
+    console.log(`  Estimated Cost:  $${priceData.estimatedUSDC} USDC`);
+    console.log(`  Spotlight Available: ${spotlight.spotlightAvailable ? "✅ Yes" : "❌ No"}`);
 
-    if (data.spotlightRemainingSeconds > 0) {
-      const mins = Math.ceil(data.spotlightRemainingSeconds / 60);
+    if (spotlight.spotlightRemainingSeconds > 0) {
+      const mins = Math.ceil(spotlight.spotlightRemainingSeconds / 60);
       console.log(`  Current Guarantee Remaining: ${mins} min`);
     }
 

package/src/commands/list.js

@@ -1,30 +1,4 @@
-import { createPublicClient, http } from "viem";
-import { base } from "viem/chains";
-import { fetchSignatures } from "../api.js";
-
-const SIGNET_CONTRACT = "0xd53A6Ff418a5647704032089F64D9f0c5Ac958B0";
-const SIGNET_ABI = [
-  {
-    inputs: [],
-    name: "getSignatureCount",
-    outputs: [{ type: "uint256" }],
-    stateMutability: "view",
-    type: "function",
-  },
-];
-
-async function getSignatureCount() {
-  const client = createPublicClient({
-    chain: base,
-    transport: http(),
-  });
-  const count = await client.readContract({
-    address: SIGNET_CONTRACT,
-    abi: SIGNET_ABI,
-    functionName: "getSignatureCount",
-  });
-  return Number(count);
-}
+import { getSignatureCount, getSignatureList } from "../contract.js";
 
 export async function list(opts) {
   const count = parseInt(opts.count);
@@ -37,15 +11,9 @@ export async function list(opts) {
       return;
     }
 
-    // Fetch the most recent signatures (0-indexed)
     const latestIndex = total - 1;
     const startIndex = Math.max(0, latestIndex - count + 1);
-    const { signatures } = await fetchSignatures(startIndex, latestIndex, opts.baseUrl);
-
-    if (!signatures?.length) {
-      console.log("No signatures found.");
-      return;
-    }
+    const signatures = await getSignatureList(startIndex, latestIndex);
 
     // Sort descending (most recent first)
     signatures.sort((a, b) => b.signatureIndex - a.signatureIndex);
@@ -55,11 +23,9 @@ export async function list(opts) {
     for (const sig of signatures) {
       const date = new Date(sig.timestamp * 1000).toLocaleDateString();
       const hunt = (Number(sig.huntAmount) / 1e18).toFixed(2);
-      const title = sig.metadata?.title || "(no title)";
 
-      console.log(`  #${sig.signatureIndex} — ${title}`);
-      console.log(`     URL: ${sig.url}`);
-      console.log(`     HUNT: ${hunt} | Views: ${sig.viewCount} | Clicks: ${sig.clickCount}`);
+      console.log(`  #${sig.signatureIndex} — ${sig.url}`);
+      console.log(`     HUNT: ${hunt} | Guarantee: ${sig.guaranteeHours}h`);
       console.log(`     Date: ${date} | Wallet: ${sig.userWallet.slice(0, 8)}...`);
       console.log();
     }

package/src/commands/post.js

@@ -1,7 +1,8 @@
 import { x402Client, x402HTTPClient } from "@x402/core/client";
 import { registerExactEvmScheme } from "@x402/evm/exact/client";
 import { privateKeyToAccount } from "viem/accounts";
-import { fetchEstimate, postSpotlightRaw } from "../api.js";
+import { estimateUSDC, getSpotlightStatus } from "../contract.js";
+import { postSpotlightRaw } from "../api.js";
 
 export async function post(opts) {
   const privateKey = opts.privateKey || process.env.PRIVATE_KEY;
@@ -19,14 +20,17 @@ export async function post(opts) {
   console.log(`   Guarantee: ${hours}h\n`);
 
   try {
-    // Step 0: Get estimate
-    console.log("0️⃣  Fetching estimate...");
-    const est = await fetchEstimate(hours, opts.baseUrl);
-    console.log(`   Estimated Cost: $${est.estimatedUSDC} USDC`);
-    console.log(`   Available: ${est.spotlightAvailable ? "Yes" : "No"}\n`);
-
-    if (!est.spotlightAvailable) {
-      console.log(`   ⚠️  Spotlight is currently guaranteed. ${Math.ceil(est.spotlightRemainingSeconds / 60)} min remaining.`);
+    // Step 0: Get estimate from chain
+    console.log("0️⃣  Fetching estimate (on-chain)...");
+    const [priceData, spotlight] = await Promise.all([
+      estimateUSDC(hours),
+      getSpotlightStatus(),
+    ]);
+    console.log(`   Estimated Cost: $${priceData.estimatedUSDC} USDC`);
+    console.log(`   Available: ${spotlight.spotlightAvailable ? "Yes" : "No"}\n`);
+
+    if (!spotlight.spotlightAvailable) {
+      console.log(`   ⚠️  Spotlight is currently guaranteed. ${Math.ceil(spotlight.spotlightRemainingSeconds / 60)} min remaining.`);
     }
 
     // Step 1: POST without payment to get 402 response

package/src/contract.js

@@ -0,0 +1,172 @@
+import { createPublicClient, http, fallback, formatUnits } from "viem";
+import { base } from "viem/chains";
+
+const SIGNET_CONTRACT = "0xd53A6Ff418a5647704032089F64D9f0c5Ac958B0";
+const ZAP_CONTRACT = "0x7321e0f77F69C6944C45be683b60265C17bd4a73";
+const USDC_ADDRESS = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+
+const BASE_RPC_ENDPOINTS = [
+  "https://mainnet.base.org",
+  "https://base.llamarpc.com",
+  "https://base-rpc.publicnode.com",
+];
+
+const SIGNET_ABI = [
+  {
+    inputs: [],
+    name: "getSignatureCount",
+    outputs: [{ type: "uint256" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [{ name: "index", type: "uint256" }],
+    name: "getSignature",
+    outputs: [{
+      type: "tuple",
+      components: [
+        { name: "timestamp", type: "uint48" },
+        { name: "blockNumber", type: "uint48" },
+        { name: "userWallet", type: "address" },
+        { name: "url", type: "string" },
+        { name: "huntAmount", type: "uint96" },
+        { name: "signetAmount", type: "uint96" },
+        { name: "guaranteeHours", type: "uint8" },
+      ],
+    }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [
+      { name: "startIndex", type: "uint256" },
+      { name: "endIndex", type: "uint256" },
+    ],
+    name: "getSignatureList",
+    outputs: [{
+      type: "tuple[]",
+      components: [
+        { name: "timestamp", type: "uint48" },
+        { name: "blockNumber", type: "uint48" },
+        { name: "userWallet", type: "address" },
+        { name: "url", type: "string" },
+        { name: "huntAmount", type: "uint96" },
+        { name: "signetAmount", type: "uint96" },
+        { name: "guaranteeHours", type: "uint8" },
+      ],
+    }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [],
+    name: "isSpotlightAvailable",
+    outputs: [{ type: "bool" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [],
+    name: "getSpotlightRemainingTime",
+    outputs: [{ type: "uint256" }],
+    stateMutability: "view",
+    type: "function",
+  },
+];
+
+const ZAP_ABI = [
+  {
+    inputs: [
+      { name: "inputToken", type: "address" },
+      { name: "guaranteeHours", type: "uint8" },
+    ],
+    name: "estimateSign",
+    outputs: [
+      { name: "inputAmount", type: "uint256" },
+      { name: "huntAmount", type: "uint256" },
+    ],
+    stateMutability: "view",
+    type: "function",
+  },
+];
+
+function getClient() {
+  return createPublicClient({
+    chain: base,
+    transport: fallback(
+      BASE_RPC_ENDPOINTS.map(url => http(url, { timeout: 5000, retryCount: 1 })),
+      { rank: false }
+    ),
+  });
+}
+
+export async function getSignatureCount() {
+  const client = getClient();
+  const count = await client.readContract({
+    address: SIGNET_CONTRACT,
+    abi: SIGNET_ABI,
+    functionName: "getSignatureCount",
+  });
+  return Number(count);
+}
+
+export async function getSignatureList(startIndex, endIndex) {
+  const client = getClient();
+  // Contract's getSignatureList requires startIndex < endIndex
+  const sigs = await client.readContract({
+    address: SIGNET_CONTRACT,
+    abi: SIGNET_ABI,
+    functionName: "getSignatureList",
+    args: [BigInt(startIndex), BigInt(endIndex + 1)], // endIndex is exclusive in contract when startIndex < endIndex
+  });
+  return sigs.map((sig, i) => ({
+    signatureIndex: startIndex + i,
+    timestamp: Number(sig.timestamp),
+    blockNumber: Number(sig.blockNumber),
+    userWallet: sig.userWallet,
+    url: sig.url,
+    huntAmount: sig.huntAmount.toString(),
+    signetAmount: sig.signetAmount.toString(),
+    guaranteeHours: sig.guaranteeHours,
+  }));
+}
+
+export async function getSpotlightStatus() {
+  const client = getClient();
+  const [isAvailable, remainingTime] = await Promise.all([
+    client.readContract({
+      address: SIGNET_CONTRACT,
+      abi: SIGNET_ABI,
+      functionName: "isSpotlightAvailable",
+    }),
+    client.readContract({
+      address: SIGNET_CONTRACT,
+      abi: SIGNET_ABI,
+      functionName: "getSpotlightRemainingTime",
+    }),
+  ]);
+  return {
+    spotlightAvailable: Boolean(isAvailable),
+    spotlightRemainingSeconds: Number(remainingTime),
+  };
+}
+
+export async function estimateUSDC(guaranteeHours) {
+  const client = getClient();
+  const PRICE_BUFFER_BPS = 500n; // 5% buffer matching server config
+
+  const result = await client.simulateContract({
+    address: ZAP_CONTRACT,
+    abi: ZAP_ABI,
+    functionName: "estimateSign",
+    args: [USDC_ADDRESS, guaranteeHours],
+  });
+
+  const [usdcAmount] = result.result;
+  const usdcWithBuffer = (usdcAmount * (10000n + PRICE_BUFFER_BPS)) / 10000n;
+
+  return {
+    estimatedUSDC: formatUnits(usdcWithBuffer, 6),
+    estimatedUSDCRaw: usdcWithBuffer.toString(),
+  };
+}