plotlink-ows 0.1.13

package/packages/cli/src/commands/create.ts

@@ -0,0 +1,34 @@
+import { readFileSync } from "node:fs";
+import type { Command } from "commander";
+import { buildClient } from "../sdk.js";
+
+export function registerCreate(program: Command): void {
+  program
+    .command("create")
+    .description("Create a new storyline from a content file")
+    .requiredOption("-t, --title <title>", "Storyline title")
+    .requiredOption("-f, --file <path>", "Path to content file (plain text)")
+    .requiredOption("-g, --genre <genre>", "Genre label")
+    .action(async (opts: { title: string; file: string; genre: string }) => {
+      try {
+        const content = readFileSync(opts.file, "utf-8");
+        const client = buildClient({ ipfs: true });
+
+        console.log(`Creating storyline "${opts.title}" (7-day deadline)...`);
+        const result = await client.createStoryline(
+          opts.title,
+          content,
+          opts.genre,
+          true,
+        );
+
+        console.log("Storyline created!");
+        console.log(`  ID:   ${result.storylineId}`);
+        console.log(`  TX:   ${result.txHash}`);
+        console.log(`  CID:  ${result.contentCid}`);
+      } catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+      }
+    });
+}

package/packages/cli/src/commands/status.ts

@@ -0,0 +1,201 @@
+import type { Command } from "commander";
+import { createClient } from "@supabase/supabase-js";
+import { type Address, erc20Abi, formatUnits } from "viem";
+import { mcv2BondAbi } from "../sdk/index.js";
+import { buildClient } from "../sdk.js";
+import { loadConfig } from "../config.js";
+
+export function registerStatus(program: Command): void {
+  program
+    .command("status")
+    .description("Query storyline data (plots, deadline, token price) from Supabase and on-chain")
+    .requiredOption("-s, --storyline <id>", "Storyline ID")
+    .action(async (opts: { storyline: string }) => {
+      try {
+        const storylineId = BigInt(opts.storyline);
+        const cfg = loadConfig();
+        const client = buildClient({ ipfs: false });
+
+        console.log(`Fetching storyline ${storylineId}...`);
+
+        // -----------------------------------------------------------------
+        // 1. Storyline data — Supabase primary, paginated RPC fallback
+        // -----------------------------------------------------------------
+        let title = "";
+        let creator: Address = "0x0000000000000000000000000000000000000000";
+        let tokenAddress: Address = "0x0000000000000000000000000000000000000000";
+        let hasDeadline = false;
+        let openingCID = "";
+        let plotCount = 0;
+
+        // Supabase-only metadata
+        let dbRow: {
+          last_plot_time: string | null;
+          sunset: boolean;
+          writer_type: number | null;
+          block_timestamp: string | null;
+        } | null = null;
+
+        // Try Supabase first (fast, indexed), fall back to paginated RPC
+        // if not configured or if the storyline isn't indexed yet
+        let fromSupabase = false;
+        if (cfg.supabaseUrl && cfg.supabaseAnonKey) {
+          const supabase = createClient(cfg.supabaseUrl, cfg.supabaseAnonKey);
+          const { data } = await supabase
+            .from("storylines")
+            .select("title, writer_address, token_address, has_deadline, plot_count, last_plot_time, sunset, writer_type, block_timestamp")
+            .eq("storyline_id", Number(storylineId))
+            .eq("contract_address", client.storyFactory.toLowerCase())
+            .single();
+
+          if (data) {
+            fromSupabase = true;
+            title = data.title;
+            creator = data.writer_address as Address;
+            tokenAddress = data.token_address as Address;
+            hasDeadline = data.has_deadline;
+            plotCount = data.plot_count;
+            dbRow = {
+              last_plot_time: data.last_plot_time,
+              sunset: data.sunset,
+              writer_type: data.writer_type,
+              block_timestamp: data.block_timestamp,
+            };
+
+            // Opening CID is only in event logs; fetch via paginated RPC
+            const info = await client.getStoryline(storylineId);
+            if (info) {
+              openingCID = info.openingCID;
+            }
+          }
+        }
+
+        if (!fromSupabase) {
+          // Fallback: paginated RPC log fetching (chunks into RPC-safe ranges)
+          const info = await client.getStoryline(storylineId);
+          if (!info) {
+            console.error(`Storyline ${storylineId} not found on-chain.`);
+            process.exit(1);
+          }
+
+          title = info.title;
+          creator = info.creator;
+          tokenAddress = info.tokenAddress;
+          hasDeadline = info.hasDeadline;
+          openingCID = info.openingCID;
+
+          const plots = await client.getPlots(storylineId);
+          plotCount = plots.length;
+        }
+
+        // -----------------------------------------------------------------
+        // 2. Reserve token metadata (symbol + decimals via tokenBond)
+        // -----------------------------------------------------------------
+        let tokenSymbol = "TOKEN";
+        let tokenDecimals = 18;
+        let bondCreator: Address | null = null;
+        let bondReserveToken: Address | null = null;
+        try {
+          const bond = await client.publicClient.readContract({
+            address: client.mcv2Bond,
+            abi: mcv2BondAbi,
+            functionName: "tokenBond",
+            args: [tokenAddress],
+          });
+          bondCreator = (bond as readonly unknown[])[0] as Address;
+          const reserveToken = (bond as readonly unknown[])[4] as Address;
+          bondReserveToken = reserveToken;
+          const [sym, dec] = await Promise.all([
+            client.publicClient.readContract({
+              address: reserveToken,
+              abi: erc20Abi,
+              functionName: "symbol",
+            }),
+            client.publicClient.readContract({
+              address: reserveToken,
+              abi: erc20Abi,
+              functionName: "decimals",
+            }),
+          ]);
+          tokenSymbol = sym;
+          tokenDecimals = dec;
+        } catch {
+          // Fall back to defaults if calls fail
+        }
+
+        // -----------------------------------------------------------------
+        // 3. On-chain token price (MCV2_Bond)
+        // -----------------------------------------------------------------
+        const tokenPrice = await client.getTokenPrice(tokenAddress);
+
+        // -----------------------------------------------------------------
+        // 4. On-chain royalty info
+        // -----------------------------------------------------------------
+        let unclaimedRoyalty: bigint | null = null;
+        try {
+          if (bondCreator && bondReserveToken) {
+            const royalty = await client.getRoyaltyInfo(bondCreator, bondReserveToken);
+            unclaimedRoyalty = royalty.balance;
+          }
+        } catch {
+          // Token may not have a bond yet
+        }
+
+        // -----------------------------------------------------------------
+        // Display
+        // -----------------------------------------------------------------
+        console.log();
+        console.log(`Title:            ${title}`);
+        console.log(`Creator:          ${creator}`);
+        console.log(`Token:            ${tokenAddress}`);
+        console.log(`Has deadline:     ${hasDeadline ? "yes" : "no"}`);
+        if (openingCID) {
+          console.log(`Opening CID:      ${openingCID}`);
+        }
+        console.log(`Plot count:       ${plotCount}`);
+
+        if (dbRow) {
+          console.log(`Sunset:           ${dbRow.sunset ? "yes" : "no"}`);
+          console.log(`Writer type:      ${dbRow.writer_type === 1 ? "agent" : dbRow.writer_type === 0 ? "human" : "unknown"}`);
+          if (dbRow.block_timestamp) {
+            console.log(`Created:          ${new Date(dbRow.block_timestamp).toISOString()}`);
+          }
+          if (dbRow.last_plot_time) {
+            console.log(`Last plot:        ${new Date(dbRow.last_plot_time).toISOString()}`);
+          }
+
+          // Deadline remaining (7 days from last plot)
+          if (hasDeadline && dbRow.last_plot_time && !dbRow.sunset) {
+            const DEADLINE_HOURS = 168;
+            const deadlineMs =
+              new Date(dbRow.last_plot_time).getTime() + DEADLINE_HOURS * 60 * 60 * 1000;
+            const remainingMs = deadlineMs - Date.now();
+            if (remainingMs <= 0) {
+              console.log(`Deadline:         expired`);
+            } else {
+              const totalMin = Math.floor(remainingMs / 60_000);
+              const days = Math.floor(totalMin / 1440);
+              const hours = Math.floor((totalMin % 1440) / 60);
+              const mins = totalMin % 60;
+              const parts: string[] = [];
+              if (days > 0) parts.push(`${days}d`);
+              if (hours > 0) parts.push(`${hours}h`);
+              if (mins > 0 || parts.length === 0) parts.push(`${mins}m`);
+              console.log(`Deadline:         ${parts.join(" ")} remaining`);
+            }
+          }
+        }
+
+        if (tokenPrice) {
+          console.log(`Token price:      ${tokenPrice.priceFormatted} ${tokenSymbol}`);
+        }
+
+        if (unclaimedRoyalty !== null && unclaimedRoyalty > 0n) {
+          console.log(`Unclaimed royalty: ${formatUnits(unclaimedRoyalty, tokenDecimals)} ${tokenSymbol}`);
+        }
+      } catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+      }
+    });
+}

package/packages/cli/src/config.ts

@@ -0,0 +1,103 @@
+import { readFileSync, existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { homedir } from "node:os";
+
+/**
+ * Resolved configuration for the CLI.
+ * Loaded from environment variables, falling back to `.plotlinkrc` in cwd or home dir.
+ */
+export interface CliConfig {
+  privateKey: string;
+  rpcUrl: string;
+  chainId?: number;
+  filebaseAccessKey?: string;
+  filebaseSecretKey?: string;
+  filebaseBucket?: string;
+  supabaseUrl?: string;
+  supabaseAnonKey?: string;
+}
+
+/**
+ * Load CLI config by merging env vars over `.plotlinkrc` values.
+ *
+ * Priority (highest first):
+ *   1. Environment variables (PLOTLINK_PRIVATE_KEY, PLOTLINK_RPC_URL, etc.)
+ *   2. `.plotlinkrc` JSON file in cwd
+ *   3. `.plotlinkrc` JSON file in home dir
+ */
+export function loadConfig(): CliConfig {
+  const rc = loadRcFile();
+
+  const privateKey = env("PLOTLINK_PRIVATE_KEY") ?? rc.privateKey;
+  const rpcUrl = env("PLOTLINK_RPC_URL") ?? rc.rpcUrl;
+
+  if (!privateKey) {
+    throw new Error(
+      "Missing private key. Set PLOTLINK_PRIVATE_KEY env var or add \"privateKey\" to .plotlinkrc",
+    );
+  }
+  if (!rpcUrl) {
+    throw new Error(
+      "Missing RPC URL. Set PLOTLINK_RPC_URL env var or add \"rpcUrl\" to .plotlinkrc",
+    );
+  }
+
+  const chainIdRaw = env("PLOTLINK_CHAIN_ID") ?? rc.chainId;
+  const chainId = chainIdRaw ? Number(chainIdRaw) : undefined;
+
+  return {
+    privateKey,
+    rpcUrl,
+    chainId,
+    filebaseAccessKey: env("PLOTLINK_FILEBASE_ACCESS_KEY") ?? rc.filebaseAccessKey,
+    filebaseSecretKey: env("PLOTLINK_FILEBASE_SECRET_KEY") ?? rc.filebaseSecretKey,
+    filebaseBucket: env("PLOTLINK_FILEBASE_BUCKET") ?? rc.filebaseBucket,
+    supabaseUrl: env("PLOTLINK_SUPABASE_URL") ?? rc.supabaseUrl,
+    supabaseAnonKey: env("PLOTLINK_SUPABASE_ANON_KEY") ?? rc.supabaseAnonKey,
+  };
+}
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+function env(name: string): string | undefined {
+  const val = process.env[name];
+  return val && val.trim().length > 0 ? val.trim() : undefined;
+}
+
+interface RcData {
+  privateKey?: string;
+  rpcUrl?: string;
+  chainId?: string;
+  filebaseAccessKey?: string;
+  filebaseSecretKey?: string;
+  filebaseBucket?: string;
+  supabaseUrl?: string;
+  supabaseAnonKey?: string;
+}
+
+function loadRcFile(): RcData {
+  const candidates = [
+    resolve(process.cwd(), ".plotlinkrc"),
+    resolve(homedir(), ".plotlinkrc"),
+  ];
+
+  for (const filepath of candidates) {
+    if (existsSync(filepath)) {
+      const raw = readFileSync(filepath, "utf-8");
+      try {
+        const parsed = JSON.parse(raw) as RcData;
+        console.warn(
+          "WARNING: Loading keys from .plotlinkrc — ensure this file is in .gitignore and never committed.",
+        );
+        return parsed;
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`Error parsing .plotlinkrc: ${message}. Check your JSON syntax.`);
+      }
+    }
+  }
+
+  return {};
+}

package/packages/cli/src/index.ts

@@ -0,0 +1,21 @@
+import { Command } from "commander";
+import { registerCreate } from "./commands/create.js";
+import { registerChain } from "./commands/chain.js";
+import { registerStatus } from "./commands/status.js";
+import { registerClaim } from "./commands/claim.js";
+import { registerAgentRegister } from "./commands/agent-register.js";
+
+const program = new Command();
+
+program
+  .name("plotlink")
+  .description("CLI for the PlotLink protocol on Base")
+  .version("0.1.0");
+
+registerCreate(program);
+registerChain(program);
+registerStatus(program);
+registerClaim(program);
+registerAgentRegister(program);
+
+program.parse();

package/packages/cli/src/sdk/abi.ts

@@ -0,0 +1,222 @@
+/**
+ * Contract ABIs for the PlotLink protocol.
+ *
+ * Mirrored from lib/contracts/abi.ts and lib/contracts/erc8004.ts in the web
+ * app. The SDK keeps its own copy to avoid cross-package imports.
+ */
+
+// ---------------------------------------------------------------------------
+// StoryFactory
+// ---------------------------------------------------------------------------
+
+export const storyFactoryAbi = [
+  // Events
+  {
+    type: "event",
+    name: "PlotChained",
+    inputs: [
+      { name: "storylineId", type: "uint256", indexed: true },
+      { name: "plotIndex", type: "uint256", indexed: true },
+      { name: "writer", type: "address", indexed: true },
+      { name: "title", type: "string", indexed: false },
+      { name: "contentCID", type: "string", indexed: false },
+      { name: "contentHash", type: "bytes32", indexed: false },
+    ],
+  },
+  {
+    type: "event",
+    name: "StorylineCreated",
+    inputs: [
+      { name: "storylineId", type: "uint256", indexed: true },
+      { name: "writer", type: "address", indexed: true },
+      { name: "tokenAddress", type: "address", indexed: false },
+      { name: "title", type: "string", indexed: false },
+      { name: "hasDeadline", type: "bool", indexed: false },
+      { name: "openingCID", type: "string", indexed: false },
+      { name: "openingHash", type: "bytes32", indexed: false },
+    ],
+  },
+  {
+    type: "event",
+    name: "Donation",
+    inputs: [
+      { name: "storylineId", type: "uint256", indexed: true },
+      { name: "donor", type: "address", indexed: true },
+      { name: "amount", type: "uint256", indexed: false },
+    ],
+  },
+  {
+    type: "event",
+    name: "CurveUpdated",
+    inputs: [{ name: "newStepCount", type: "uint256", indexed: false }],
+  },
+  // Functions
+  {
+    type: "function",
+    name: "createStoryline",
+    stateMutability: "payable",
+    inputs: [
+      { name: "title", type: "string" },
+      { name: "openingCID", type: "string" },
+      { name: "openingHash", type: "bytes32" },
+      { name: "hasDeadline", type: "bool" },
+    ],
+    outputs: [{ name: "storylineId", type: "uint256" }],
+  },
+  {
+    type: "function",
+    name: "chainPlot",
+    stateMutability: "nonpayable",
+    inputs: [
+      { name: "storylineId", type: "uint256" },
+      { name: "title", type: "string" },
+      { name: "contentCID", type: "string" },
+      { name: "contentHash", type: "bytes32" },
+    ],
+    outputs: [],
+  },
+  {
+    type: "function",
+    name: "donate",
+    stateMutability: "nonpayable",
+    inputs: [
+      { name: "storylineId", type: "uint256" },
+      { name: "amount", type: "uint256" },
+    ],
+    outputs: [],
+  },
+  {
+    type: "function",
+    name: "hasSunset",
+    stateMutability: "view",
+    inputs: [{ name: "storylineId", type: "uint256" }],
+    outputs: [{ name: "", type: "bool" }],
+  },
+  {
+    type: "function",
+    name: "updateCurve",
+    stateMutability: "nonpayable",
+    inputs: [
+      { name: "newRanges", type: "uint128[]" },
+      { name: "newPrices", type: "uint128[]" },
+    ],
+    outputs: [],
+  },
+  {
+    type: "function",
+    name: "owner",
+    stateMutability: "view",
+    inputs: [],
+    outputs: [{ name: "", type: "address" }],
+  },
+  {
+    type: "function",
+    name: "storylines",
+    stateMutability: "view",
+    inputs: [{ name: "storylineId", type: "uint256" }],
+    outputs: [
+      { name: "writer", type: "address" },
+      { name: "token", type: "address" },
+      { name: "plotCount", type: "uint24" },
+      { name: "lastPlotTime", type: "uint40" },
+      { name: "hasDeadline", type: "bool" },
+    ],
+  },
+] as const;
+
+// ---------------------------------------------------------------------------
+// ERC-8004 Agent Registry
+// ---------------------------------------------------------------------------
+
+export const erc8004Abi = [
+  {
+    type: "function",
+    name: "agentIdByWallet",
+    stateMutability: "view",
+    inputs: [{ name: "wallet", type: "address" }],
+    outputs: [{ name: "agentId", type: "uint256" }],
+  },
+  {
+    type: "function",
+    name: "register",
+    stateMutability: "nonpayable",
+    inputs: [{ name: "agentURI", type: "string" }],
+    outputs: [{ name: "agentId", type: "uint256" }],
+  },
+  {
+    type: "function",
+    name: "setAgentWallet",
+    stateMutability: "nonpayable",
+    inputs: [
+      { name: "agentId", type: "uint256" },
+      { name: "newWallet", type: "address" },
+      { name: "deadline", type: "uint256" },
+      { name: "signature", type: "bytes" },
+    ],
+    outputs: [],
+  },
+  {
+    type: "event",
+    name: "Registered",
+    inputs: [
+      { name: "agentId", type: "uint256", indexed: true },
+      { name: "agentURI", type: "string", indexed: false },
+      { name: "owner", type: "address", indexed: true },
+    ],
+  },
+] as const;
+
+// ---------------------------------------------------------------------------
+// MCV2_Bond (Mint Club V2 bonding curve)
+// ---------------------------------------------------------------------------
+
+export const mcv2BondAbi = [
+  {
+    type: "function",
+    name: "creationFee",
+    stateMutability: "view",
+    inputs: [],
+    outputs: [{ name: "", type: "uint256" }],
+  },
+  {
+    type: "function",
+    name: "getRoyaltyInfo",
+    stateMutability: "view",
+    inputs: [
+      { name: "wallet", type: "address" },
+      { name: "reserveToken", type: "address" },
+    ],
+    outputs: [
+      { name: "balance", type: "uint256" },
+      { name: "claimed", type: "uint256" },
+    ],
+  },
+  {
+    type: "function",
+    name: "claimRoyalties",
+    stateMutability: "nonpayable",
+    inputs: [{ name: "reserveToken", type: "address" }],
+    outputs: [],
+  },
+  {
+    type: "function",
+    name: "priceForNextMint",
+    stateMutability: "view",
+    inputs: [{ name: "token", type: "address" }],
+    outputs: [{ name: "", type: "uint128" }],
+  },
+  {
+    type: "function",
+    name: "tokenBond",
+    stateMutability: "view",
+    inputs: [{ name: "token", type: "address" }],
+    outputs: [
+      { name: "creator", type: "address" },
+      { name: "mintRoyalty", type: "uint16" },
+      { name: "burnRoyalty", type: "uint16" },
+      { name: "createdAt", type: "uint40" },
+      { name: "reserveToken", type: "address" },
+      { name: "reserveBalance", type: "uint256" },
+    ],
+  },
+] as const;