plotlink-ows 0.1.13

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

@@ -0,0 +1,56 @@
+/**
+ * Default contract addresses and chain configuration for PlotLink on Base.
+ *
+ * Mirrored from lib/contracts/constants.ts in the web app.
+ * These serve as defaults — callers can override via PlotLinkConfig.
+ */
+
+// ---------------------------------------------------------------------------
+// Chain
+// ---------------------------------------------------------------------------
+
+/** Base Sepolia (testnet) chain ID. */
+export const BASE_SEPOLIA_CHAIN_ID = 84532;
+
+/** Base (mainnet) chain ID. */
+export const BASE_MAINNET_CHAIN_ID = 8453;
+
+/**
+ * Approximate deployment block for PlotLink contracts on Base Sepolia.
+ * Used as the default fromBlock in event log queries to avoid scanning
+ * from genesis (which times out on Base).
+ */
+export const DEPLOYMENT_BLOCK = BigInt(20_000_000);
+
+/**
+ * Deployment block for PlotLink contracts on Base mainnet.
+ * Used as the default fromBlock for mainnet event log queries.
+ */
+export const DEPLOYMENT_BLOCK_MAINNET = BigInt(43_840_298);
+
+/** Supported chain IDs for the PlotLink SDK. */
+export const SUPPORTED_CHAIN_IDS = new Set([BASE_SEPOLIA_CHAIN_ID, BASE_MAINNET_CHAIN_ID]);
+
+// ---------------------------------------------------------------------------
+// PlotLink contracts (Base Sepolia defaults)
+// ---------------------------------------------------------------------------
+
+/** StoryFactory — storyline + plot management (Base Sepolia). */
+export const STORY_FACTORY_ADDRESS =
+  "0xfa5489b6710Ba2f8406b37fA8f8c3018e51FA229" as const;
+
+/** StoryFactory — storyline + plot management (Base mainnet). */
+export const STORY_FACTORY_MAINNET_ADDRESS =
+  "0x9D2AE1E99D0A6300bfcCF41A82260374e38744Cf" as const;
+
+/** MCV2_Bond — bonding curve trading (Base Sepolia). */
+export const MCV2_BOND_ADDRESS =
+  "0x5dfA75b0185efBaEF286E80B847ce84ff8a62C2d" as const;
+
+/** MCV2_Bond — bonding curve trading (Base mainnet). */
+export const MCV2_BOND_MAINNET_ADDRESS =
+  "0xc5a076cad94176c2996B32d8466Be1cE757FAa27" as const;
+
+/** ERC-8004 Agent Identity Registry. */
+export const ERC8004_REGISTRY_ADDRESS =
+  "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432" as const;

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

@@ -0,0 +1,46 @@
+/**
+ * @plotlink/sdk — TypeScript SDK for the PlotLink protocol on Base.
+ *
+ * @example
+ * ```ts
+ * import { PlotLink } from "@plotlink/sdk";
+ *
+ * const client = new PlotLink({
+ *   privateKey: "0x...",
+ *   rpcUrl: "https://sepolia.base.org",
+ *   filebase: { accessKey: "...", secretKey: "...", bucket: "my-bucket" },
+ * });
+ *
+ * const { storylineId } = await client.createStoryline(
+ *   "My Story",
+ *   "Once upon a time...",
+ *   "Fantasy",
+ * );
+ * ```
+ */
+
+export { PlotLink } from "./client.js";
+export type {
+  PlotLinkConfig,
+  CreateStorylineResult,
+  ChainPlotResult,
+  StorylineInfo,
+  PlotInfo,
+  RegisterAgentResult,
+  SetAgentWalletResult,
+  RoyaltyInfo,
+  TokenPriceInfo,
+} from "./client.js";
+export type { FilebaseConfig } from "./ipfs.js";
+
+// Re-export constants for callers who need contract addresses
+export {
+  STORY_FACTORY_ADDRESS,
+  MCV2_BOND_ADDRESS,
+  ERC8004_REGISTRY_ADDRESS,
+  BASE_SEPOLIA_CHAIN_ID,
+  BASE_MAINNET_CHAIN_ID,
+} from "./constants.js";
+
+// Re-export ABIs for direct contract reads
+export { mcv2BondAbi } from "./abi.js";

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

@@ -0,0 +1,88 @@
+import {
+  S3Client,
+  PutObjectCommand,
+  HeadObjectCommand,
+} from "@aws-sdk/client-s3";
+
+/**
+ * Filebase configuration for IPFS pinning via S3-compatible API.
+ */
+export interface FilebaseConfig {
+  accessKey: string;
+  secretKey: string;
+  bucket: string;
+}
+
+/**
+ * Create an S3-compatible client for Filebase IPFS pinning.
+ */
+function createFilebaseClient(config: FilebaseConfig): S3Client {
+  return new S3Client({
+    endpoint: "https://s3.filebase.com",
+    region: "us-east-1",
+    credentials: {
+      accessKeyId: config.accessKey,
+      secretAccessKey: config.secretKey,
+    },
+  });
+}
+
+/**
+ * Upload content to Filebase (IPFS pinning via S3 API) and return the CID.
+ *
+ * The CID is retrieved from the HeadObject response metadata after upload.
+ * Content is stored as UTF-8 plain text.
+ */
+export async function uploadToIPFS(
+  content: string,
+  key: string,
+  config: FilebaseConfig,
+): Promise<string> {
+  const s3 = createFilebaseClient(config);
+
+  await s3.send(
+    new PutObjectCommand({
+      Bucket: config.bucket,
+      Key: key,
+      Body: content,
+      ContentType: "text/plain; charset=utf-8",
+    }),
+  );
+
+  const head = await s3.send(
+    new HeadObjectCommand({ Bucket: config.bucket, Key: key }),
+  );
+  const cid = head.Metadata?.cid;
+  if (!cid) {
+    throw new Error("Filebase response missing CID in metadata");
+  }
+
+  return cid;
+}
+
+/**
+ * Upload content to IPFS with retry logic.
+ *
+ * 3 attempts with exponential backoff (1s, 2s, 4s).
+ */
+export async function uploadWithRetry(
+  content: string,
+  key: string,
+  config: FilebaseConfig,
+  maxRetries = 3,
+): Promise<string> {
+  let lastError: Error | null = null;
+  for (let attempt = 1; attempt <= maxRetries; attempt++) {
+    try {
+      return await uploadToIPFS(content, key, config);
+    } catch (error) {
+      lastError = error instanceof Error ? error : new Error("Unknown error");
+      if (attempt < maxRetries) {
+        await new Promise((r) =>
+          setTimeout(r, Math.pow(2, attempt - 1) * 1000),
+        );
+      }
+    }
+  }
+  throw lastError || new Error("IPFS upload failed after retries");
+}

package/packages/cli/src/sdk.ts

@@ -0,0 +1,36 @@
+import { PlotLink } from "./sdk/index.js";
+import type { PlotLinkConfig } from "./sdk/index.js";
+import { loadConfig } from "./config.js";
+
+/**
+ * Build a PlotLink SDK client from CLI config.
+ *
+ * @param options.ipfs - Whether IPFS (Filebase) credentials are required.
+ *   Commands that upload content (create, chain) need this; read-only commands don't.
+ */
+export function buildClient(options: { ipfs: boolean }): PlotLink {
+  const cfg = loadConfig();
+
+  const config: PlotLinkConfig = {
+    privateKey: cfg.privateKey,
+    rpcUrl: cfg.rpcUrl,
+    chainId: cfg.chainId,
+  };
+
+  if (options.ipfs) {
+    if (!cfg.filebaseAccessKey || !cfg.filebaseSecretKey || !cfg.filebaseBucket) {
+      throw new Error(
+        "Filebase credentials required for this command. " +
+          "Set PLOTLINK_FILEBASE_ACCESS_KEY, PLOTLINK_FILEBASE_SECRET_KEY, " +
+          "and PLOTLINK_FILEBASE_BUCKET env vars or add them to .plotlinkrc",
+      );
+    }
+    config.filebase = {
+      accessKey: cfg.filebaseAccessKey,
+      secretKey: cfg.filebaseSecretKey,
+      bucket: cfg.filebaseBucket,
+    };
+  }
+
+  return new PlotLink(config);
+}

package/packages/cli/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2021",
+    "lib": ["ES2021"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "declaration": true,
+    "declarationMap": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "noEmit": true
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["node_modules", "dist"]
+}

package/packages/cli/tsup.config.ts

@@ -0,0 +1,14 @@
+import { defineConfig } from "tsup";
+
+export default defineConfig({
+  entry: ["src/index.ts"],
+  format: ["esm"],
+  dts: false,
+  splitting: false,
+  sourcemap: true,
+  clean: true,
+  outDir: "dist",
+  banner: {
+    js: "#!/usr/bin/env node",
+  },
+});

package/public/.well-known/farcaster.json

@@ -0,0 +1,38 @@
+{
+  "accountAssociation": {
+    "header": "eyJmaWQiOjgxMDYsInR5cGUiOiJhdXRoIiwia2V5IjoiMHhhNzBiMDZhNzdkNmEwQTg0NmE4Yzg1RDYwMzA0OWFCNjA5NzU3RUY0In0",
+    "payload": "eyJkb21haW4iOiJwbG90bGluay54eXoifQ",
+    "signature": "jHCxpF3pxXBHBwI4uRuIFAskfPhL9bb4tTnmJ2VJLlwJMV3rZSeozOCw/8Pio4BTd0GLS0YUDIPGd7E51DATLhw="
+  },
+  "miniapp": {
+    "version": "1",
+    "name": "PlotLink",
+    "subtitle": "Write Stories. Trade Them.",
+    "description": "Tokenise your story from day 1. Publish plots, drive trading, earn royalties from every trade.",
+    "iconUrl": "https://plotlink.xyz/icon.png",
+    "homeUrl": "https://plotlink.xyz",
+    "imageUrl": "https://plotlink.xyz/embed-image.png",
+    "buttonTitle": "Open PlotLink",
+    "splashImageUrl": "https://plotlink.xyz/splash.png",
+    "splashBackgroundColor": "#E8DFD0",
+    "heroImageUrl": "https://plotlink.xyz/og-image.png",
+    "tagline": "Your story is a token.",
+    "ogTitle": "PlotLink",
+    "ogDescription": "Tokenise your story from day 1. Publish plots, drive trading, earn royalties from every trade.",
+    "ogImageUrl": "https://plotlink.xyz/og-image.png",
+    "screenshotUrls": [
+      "https://plotlink.xyz/screenshot-1.png",
+      "https://plotlink.xyz/screenshot-2.png",
+      "https://plotlink.xyz/screenshot-3.png"
+    ],
+    "primaryCategory": "entertainment",
+    "tags": ["stories", "writing", "onchain", "base"],
+    "requiredChains": ["eip155:8453"],
+    "requiredCapabilities": [
+      "wallet.getEthereumProvider",
+      "actions.swapToken"
+    ],
+    "webhookUrl": "https://plotlink.xyz/api/webhook/notifications"
+  }
+}
+

package/public/basescan-icon.svg

@@ -0,0 +1,4 @@
+<svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M4.15603 9.50607C4.15604 9.39424 4.17811 9.2835 4.22096 9.18024C4.26382 9.07696 4.3266 8.98319 4.40572 8.9043C4.48485 8.82541 4.57875 8.76295 4.68203 8.72053C4.78531 8.6781 4.89594 8.65652 5.00757 8.65704L6.41934 8.66166C6.64444 8.66166 6.86032 8.75125 7.0195 8.91072C7.17867 9.07019 7.26809 9.28649 7.26809 9.51201V14.8608C7.42709 14.8136 7.63059 14.7632 7.85451 14.7104C8.00965 14.6738 8.14791 14.5858 8.24687 14.4606C8.34583 14.3355 8.39971 14.1805 8.39974 14.0208V7.38654C8.39974 7.16101 8.48915 6.9447 8.64832 6.78521C8.80749 6.6257 9.02338 6.53608 9.24849 6.53603H10.6645C10.8897 6.53608 11.1055 6.6257 11.2647 6.78521C11.4239 6.9447 11.5133 7.16101 11.5133 7.38654V13.5442C11.5133 13.5442 11.8675 13.4006 12.2124 13.2546C12.3406 13.2003 12.4499 13.1094 12.5268 12.9933C12.6038 12.8771 12.6448 12.7408 12.6449 12.6014V5.26059C12.6449 5.0351 12.7343 4.81884 12.8935 4.65936C13.0526 4.49989 13.2684 4.41028 13.4935 4.41023H14.9081C15.133 4.41047 15.3487 4.50014 15.5077 4.6596C15.6667 4.81905 15.756 5.03521 15.756 5.26059V11.3055C16.9825 10.415 18.2253 9.34395 19.2117 8.05613C19.3547 7.8692 19.4494 7.64969 19.4873 7.41717C19.5251 7.18465 19.505 6.94636 19.4285 6.72357C18.9719 5.40754 18.2461 4.20149 17.2977 3.1826C16.3491 2.16371 15.1988 1.35442 13.9202 0.806509C12.6416 0.258603 11.2629 -0.0158526 9.8724 0.000707134C8.48187 0.0172669 7.11009 0.324477 5.84486 0.902678C4.57962 1.48088 3.44881 2.31734 2.52474 3.35853C1.6007 4.39972 0.903758 5.62271 0.478538 6.94925C0.0533168 8.27577 -0.0908225 9.67665 0.0553422 11.0622C0.201507 12.4477 0.634757 13.7875 1.32737 14.9956C1.44804 15.204 1.62557 15.3736 1.83911 15.4845C2.05264 15.5953 2.29331 15.6428 2.53285 15.6213C2.80044 15.5977 3.13361 15.5643 3.52973 15.5178C3.70211 15.4981 3.86128 15.4156 3.97689 15.286C4.09251 15.1564 4.1565 14.9887 4.15669 14.8149V9.50607" fill="white"/>
+<path d="M4.12598 18.0839C5.61704 19.1707 7.37912 19.8231 9.21725 19.9687C11.0554 20.1145 12.8979 19.7478 14.541 18.9095C16.1841 18.0712 17.5637 16.7938 18.5271 15.2187C19.4905 13.6436 20.0003 11.8321 20 9.98475C20 9.75363 19.9893 9.52614 19.974 9.29932C16.3221 14.7562 9.57929 17.3072 4.12598 18.0839Z" fill="#0052FF"/>
+</svg>

package/public/hunt-token.svg

@@ -0,0 +1,11 @@
+<svg width="500" height="500" viewBox="0 0 500 500" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_98_6)">
+<path d="M250 500C388.071 500 500 388.071 500 250C500 111.929 388.071 0 250 0C111.929 0 0 111.929 0 250C0 388.071 111.929 500 250 500Z" fill="#FC6F6F"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M202.446 96.0144L202.445 172.304C216.387 164.124 232.643 159.431 250 159.431C300.411 159.431 341.529 199.016 343.663 248.648C343.711 248.648 343.75 248.687 343.75 248.735V339.1C343.75 351.857 333.409 362.198 320.652 362.198C307.896 362.198 297.554 351.857 297.554 339.1V248.82C297.554 248.726 297.478 248.649 297.383 248.649C297.383 248.649 297.384 248.649 297.383 248.649C295.316 224.417 274.891 205.391 250 205.391C225.413 205.391 205.184 223.956 202.702 247.765L202.626 248.564C202.621 248.612 202.58 248.649 202.532 248.649C202.484 248.648 202.446 248.686 202.446 248.734C202.446 248.733 202.446 248.734 202.446 248.734L202.446 339.1C202.446 351.857 192.104 362.198 179.348 362.198C166.591 362.198 156.25 351.857 156.25 339.1V96.0144C156.25 83.2578 166.591 72.9166 179.348 72.9166C192.104 72.9166 202.446 83.2579 202.446 96.0144C202.446 96.0145 202.446 96.0144 202.446 96.0144ZM179.348 427.083C192.104 427.083 202.446 416.795 202.446 404.103C202.446 391.411 192.104 381.123 179.348 381.123C166.591 381.123 156.25 391.411 156.25 404.103C156.25 416.795 166.591 427.083 179.348 427.083ZM320.652 427.083C333.409 427.083 343.75 416.795 343.75 404.103C343.75 391.411 333.409 381.123 320.652 381.123C307.896 381.123 297.554 391.411 297.554 404.103C297.554 416.795 307.896 427.083 320.652 427.083Z" fill="white"/>
+</g>
+<defs>
+<clipPath id="clip0_98_6">
+<rect width="500" height="500" fill="white"/>
+</clipPath>
+</defs>
+</svg>

package/public/manifest.json

@@ -0,0 +1,26 @@
+{
+  "name": "PlotLink",
+  "short_name": "PlotLink",
+  "icons": [
+    {
+      "src": "/icon-192.png",
+      "sizes": "192x192",
+      "type": "image/png"
+    },
+    {
+      "src": "/favicon.png",
+      "sizes": "512x512",
+      "type": "image/png"
+    },
+    {
+      "src": "/icon.png",
+      "sizes": "1024x1024",
+      "type": "image/png",
+      "purpose": "any maskable"
+    }
+  ],
+  "theme_color": "#E8DFD0",
+  "background_color": "#E8DFD0",
+  "display": "standalone",
+  "start_url": "/"
+}

package/public/mc-icon-light.svg

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="1020px" height="1020px" viewBox="0 0 1020 1020" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+    <title>mc-icon-light</title>
+    <g id="logo" stroke="none" stroke-width="1" fill="none" fill-rule="evenodd">
+        <g id="mc-icon-light" transform="translate(-30.000000, -30.000000)">
+            <g transform="translate(30.000000, 30.000000)">
+                <rect id="Rectangle" stroke="#15E6B7" stroke-width="24" fill="#0B0C1B" x="12" y="12" width="996" height="996" rx="498"></rect>
+                <path d="M736.934432,224.4 C769.334531,224.4 795.6,250.665469 795.6,283.065568 L795.6,740.863736 C795.6,771.09374 771.09374,795.6 740.863736,795.6 C710.633733,795.6 686.127473,771.09374 686.127473,740.863736 L686.127473,575.034575 C686.127473,553.774672 668.892916,536.540116 647.633014,536.540116 C633.317279,536.540116 620.184023,544.484345 613.538095,557.163931 L555.21226,668.442215 C546.44299,685.172869 529.113721,695.655242 510.224176,695.655242 C491.330835,695.655242 473.9942,685.183015 465.202528,668.459833 L406.692308,557.163931 C396.766677,538.283777 373.414975,531.024701 354.534821,540.950331 C341.836684,547.625966 333.884982,560.789906 333.884982,575.135874 L333.884982,740.857509 C333.884982,771.090952 309.375934,795.6 279.142491,795.6 C248.909048,795.6 224.4,771.090952 224.4,740.857509 L224.4,283.47033 C224.4,250.846687 250.846687,224.4 283.47033,224.4 C319.769722,224.4 353.053162,244.599081 369.811254,276.79865 L426.27033,385.28104 C450.395193,431.635375 507.529872,449.655921 553.884206,425.531058 C571.057571,416.593273 585.075942,402.602598 594.047672,385.446943 L651.08227,276.38594 C667.794142,244.429662 700.87212,224.4 736.934432,224.4 Z M425.2125,715.275 C447.393636,715.275 465.375,733.256364 465.375,755.4375 C465.375,777.618636 447.393636,795.6 425.2125,795.6 C403.031364,795.6 385.05,777.618636 385.05,755.4375 C385.05,733.256364 403.031364,715.275 425.2125,715.275 Z M594.7875,715.275 C616.968636,715.275 634.95,733.256364 634.95,755.4375 C634.95,777.618636 616.968636,795.6 594.7875,795.6 C572.606364,795.6 554.625,777.618636 554.625,755.4375 C554.625,733.256364 572.606364,715.275 594.7875,715.275 Z" id="Combined-Shape" fill="#15E6B7" fill-rule="nonzero"></path>
+            </g>
+        </g>
+    </g>
+</svg>

package/public/plotlink-logo-symbol.svg

@@ -0,0 +1,5 @@
+<svg width="300" height="364" viewBox="0 0 300 364" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M47.3684 292.105H300V0H47.3684C21.2479 0 0 21.2479 0 47.3684V319.089C0 343.39 21.2479 363.158 47.3684 363.158H300V347.368H47.3684C30.2529 347.368 15.7895 334.416 15.7895 319.089C15.7895 303.947 29.6669 292.105 47.3684 292.105Z" fill="#8B4513"/>
+<path d="M129.746 186.622C127.559 186.713 125.553 186.804 123.73 186.895C121.999 186.895 120.312 186.895 118.672 186.895C117.122 186.895 115.573 186.895 114.023 186.895C112.565 186.895 111.016 186.85 109.375 186.758V211.505C109.375 216.609 109.284 221.531 109.102 226.27C108.919 230.919 108.646 234.428 108.281 236.798L132.07 235.977V257.579H48.9453V239.122C52.0443 238.939 54.8242 238.666 57.2852 238.301C59.8372 237.846 61.9336 236.843 63.5742 235.294C65.306 233.653 66.6276 231.238 67.5391 228.048C68.4505 224.857 68.9062 220.437 68.9062 214.786V107.462C68.9062 104.91 68.9062 102.403 68.9062 99.9421C68.9974 97.4811 69.0885 95.1569 69.1797 92.9694C69.2708 90.6908 69.362 88.64 69.4531 86.8171C69.6354 84.9942 69.8177 83.4903 70 82.3054L48.9453 83.1257V61.5241L128.652 60.9772C140.775 60.8861 151.758 62.0254 161.602 64.3952C171.536 66.765 180.013 70.4564 187.031 75.4694C194.049 80.3913 199.473 86.7259 203.301 94.4733C207.129 102.221 209.043 111.518 209.043 122.364C209.134 130.202 207.585 137.859 204.395 145.333C201.204 152.716 196.328 159.415 189.766 165.43C183.294 171.446 175.091 176.368 165.156 180.196C155.221 184.024 143.418 186.166 129.746 186.622ZM121.953 166.661C129.609 166.661 136.217 165.704 141.777 163.79C147.337 161.785 151.895 158.868 155.449 155.04C159.004 151.212 161.602 146.518 163.242 140.958C164.974 135.398 165.84 129.063 165.84 121.954C165.84 115.756 165.247 110.424 164.062 105.958C162.878 101.492 161.283 97.7546 159.277 94.7468C157.272 91.6478 154.948 89.1869 152.305 87.364C149.753 85.4499 147.064 84.0371 144.238 83.1257C141.504 82.1231 138.724 81.485 135.898 81.2116C133.164 80.847 130.612 80.6647 128.242 80.6647C125.234 80.6647 122.546 80.8926 120.176 81.3483C117.897 81.8041 115.938 82.8067 114.297 84.3561C112.747 85.9056 111.517 88.1387 110.605 91.0554C109.785 93.972 109.375 97.8913 109.375 102.813V165.841C111.38 166.023 113.431 166.205 115.527 166.387C117.624 166.57 119.766 166.661 121.953 166.661Z" fill="white"/>
+<path d="M215.98 100.579V93.9871C217.087 93.922 218.08 93.8243 218.959 93.6941C219.87 93.5313 220.619 93.1733 221.205 92.6199C221.824 92.0339 222.296 91.1713 222.621 90.032C222.947 88.8927 223.109 87.3139 223.109 85.2957V46.9656C223.109 46.0541 223.109 45.1589 223.109 44.28C223.142 43.4011 223.174 42.571 223.207 41.7898C223.24 40.976 223.272 40.2436 223.305 39.5925C223.37 38.9415 223.435 38.4044 223.5 37.9812L215.98 38.2742V30.5593H244.691V37.1511C243.552 37.2162 242.543 37.3302 241.664 37.4929C240.785 37.6557 240.036 38.0138 239.418 38.5671C238.832 39.1205 238.376 39.9669 238.051 41.1062C237.725 42.2455 237.562 43.8243 237.562 45.8425V84.1726C237.562 85.0841 237.546 85.9792 237.514 86.8582C237.514 87.7045 237.497 88.5183 237.465 89.2996C237.432 90.0808 237.383 90.797 237.318 91.448C237.286 92.0665 237.237 92.5873 237.172 93.0105L250.6 92.9617C254.538 92.9617 257.631 91.6108 259.877 88.9089C262.123 86.1746 263.246 82.073 263.246 76.6042H269.887L269.301 100.579H215.98Z" fill="white"/>
+</svg>

package/public/plotlink-logo.svg

@@ -0,0 +1,5 @@
+<svg width="300" height="364" viewBox="0 0 300 364" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M47.3684 292.105H300V0H47.3684C21.2479 0 0 21.2479 0 47.3684V319.089C0 343.39 21.2479 363.158 47.3684 363.158H300V347.368H47.3684C30.2529 347.368 15.7895 334.416 15.7895 319.089C15.7895 303.947 29.6669 292.105 47.3684 292.105Z" fill="#8B4513"/>
+<path d="M129.746 186.622C127.559 186.713 125.553 186.804 123.73 186.895C121.999 186.895 120.312 186.895 118.672 186.895C117.122 186.895 115.573 186.895 114.023 186.895C112.565 186.895 111.016 186.85 109.375 186.758V211.505C109.375 216.609 109.284 221.531 109.102 226.27C108.919 230.919 108.646 234.428 108.281 236.798L132.07 235.977V257.579H48.9453V239.122C52.0443 238.939 54.8242 238.666 57.2852 238.301C59.8372 237.846 61.9336 236.843 63.5742 235.294C65.306 233.653 66.6276 231.238 67.5391 228.048C68.4505 224.857 68.9062 220.437 68.9062 214.786V107.462C68.9062 104.91 68.9062 102.403 68.9062 99.9421C68.9974 97.4811 69.0885 95.1569 69.1797 92.9694C69.2708 90.6908 69.362 88.64 69.4531 86.8171C69.6354 84.9942 69.8177 83.4903 70 82.3054L48.9453 83.1257V61.5241L128.652 60.9772C140.775 60.8861 151.758 62.0254 161.602 64.3952C171.536 66.765 180.013 70.4564 187.031 75.4694C194.049 80.3913 199.473 86.7259 203.301 94.4733C207.129 102.221 209.043 111.518 209.043 122.364C209.134 130.202 207.585 137.859 204.395 145.333C201.204 152.716 196.328 159.415 189.766 165.43C183.294 171.446 175.091 176.368 165.156 180.196C155.221 184.024 143.418 186.166 129.746 186.622ZM121.953 166.661C129.609 166.661 136.217 165.704 141.777 163.79C147.337 161.785 151.895 158.868 155.449 155.04C159.004 151.212 161.602 146.518 163.242 140.958C164.974 135.398 165.84 129.063 165.84 121.954C165.84 115.756 165.247 110.424 164.062 105.958C162.878 101.492 161.283 97.7546 159.277 94.7468C157.272 91.6478 154.948 89.1869 152.305 87.364C149.753 85.4499 147.064 84.0371 144.238 83.1257C141.504 82.1231 138.724 81.485 135.898 81.2116C133.164 80.847 130.612 80.6647 128.242 80.6647C125.234 80.6647 122.546 80.8926 120.176 81.3483C117.897 81.8041 115.938 82.8067 114.297 84.3561C112.747 85.9056 111.517 88.1387 110.605 91.0554C109.785 93.972 109.375 97.8913 109.375 102.813V165.841C111.38 166.023 113.431 166.205 115.527 166.387C117.624 166.57 119.766 166.661 121.953 166.661Z" fill="white"/>
+<path d="M215.98 100.579V93.9871C217.087 93.922 218.08 93.8243 218.959 93.6941C219.87 93.5313 220.619 93.1733 221.205 92.6199C221.824 92.0339 222.296 91.1713 222.621 90.032C222.947 88.8927 223.109 87.3139 223.109 85.2957V46.9656C223.109 46.0541 223.109 45.1589 223.109 44.28C223.142 43.4011 223.174 42.571 223.207 41.7898C223.24 40.976 223.272 40.2436 223.305 39.5925C223.37 38.9415 223.435 38.4044 223.5 37.9812L215.98 38.2742V30.5593H244.691V37.1511C243.552 37.2162 242.543 37.3302 241.664 37.4929C240.785 37.6557 240.036 38.0138 239.418 38.5671C238.832 39.1205 238.376 39.9669 238.051 41.1062C237.725 42.2455 237.562 43.8243 237.562 45.8425V84.1726C237.562 85.0841 237.546 85.9792 237.514 86.8582C237.514 87.7045 237.497 88.5183 237.465 89.2996C237.432 90.0808 237.383 90.797 237.318 91.448C237.286 92.0665 237.237 92.5873 237.172 93.0105L250.6 92.9617C254.538 92.9617 257.631 91.6108 259.877 88.9089C262.123 86.1746 263.246 82.073 263.246 76.6042H269.887L269.301 100.579H215.98Z" fill="white"/>
+</svg>

package/scripts/backfill-trade-prices.ts

@@ -0,0 +1,97 @@
+#!/usr/bin/env npx tsx
+/**
+ * Backfill trade_history.price_per_token with marginal price (priceForNextMint)
+ * instead of the batch average that was previously stored.
+ *
+ * Usage:
+ *   npx tsx scripts/backfill-trade-prices.ts
+ *
+ * Requires: NEXT_PUBLIC_SUPABASE_URL, SUPABASE_SERVICE_ROLE_KEY
+ */
+
+import { createClient } from "@supabase/supabase-js";
+import { formatUnits } from "viem";
+import { publicClient } from "../lib/rpc";
+import { priceForNextMintFunction } from "../lib/contracts/abi";
+import { MCV2_BOND } from "../lib/contracts/constants";
+
+const SUPABASE_URL = process.env.NEXT_PUBLIC_SUPABASE_URL || "";
+const SUPABASE_KEY = process.env.SUPABASE_SERVICE_ROLE_KEY || "";
+
+if (!SUPABASE_URL || !SUPABASE_KEY) {
+  console.error("Missing NEXT_PUBLIC_SUPABASE_URL or SUPABASE_SERVICE_ROLE_KEY");
+  process.exit(1);
+}
+
+const supabase = createClient(SUPABASE_URL, SUPABASE_KEY, {
+  auth: { autoRefreshToken: false, persistSession: false },
+});
+
+async function main() {
+  console.log("=== Backfill Trade Prices ===");
+  console.log(`MCV2_BOND: ${MCV2_BOND}`);
+
+  const { data: trades, error: fetchError } = await supabase
+    .from("trade_history")
+    .select("id, token_address, block_number, price_per_token")
+    .order("block_number", { ascending: true });
+
+  if (fetchError) {
+    console.error("Failed to fetch trades:", fetchError.message);
+    process.exit(1);
+  }
+
+  if (!trades || trades.length === 0) {
+    console.log("No trades to backfill.");
+    return;
+  }
+
+  console.log(`Found ${trades.length} trades to backfill.`);
+
+  let updated = 0;
+  let failed = 0;
+
+  for (const trade of trades) {
+    try {
+      const price = await publicClient.readContract({
+        address: MCV2_BOND as `0x${string}`,
+        abi: [priceForNextMintFunction],
+        functionName: "priceForNextMint",
+        args: [trade.token_address as `0x${string}`],
+        blockNumber: BigInt(trade.block_number),
+      });
+
+      const marginalPrice = Number(formatUnits(price, 18));
+
+      const { error: updateError } = await supabase
+        .from("trade_history")
+        .update({ price_per_token: marginalPrice })
+        .eq("id", trade.id);
+
+      if (updateError) {
+        console.error(`  [FAIL] id=${trade.id}: ${updateError.message}`);
+        failed++;
+      } else {
+        const oldPrice = trade.price_per_token;
+        if (Math.abs(marginalPrice - oldPrice) > 0.0001) {
+          console.log(`  [FIX] id=${trade.id} block=${trade.block_number}: ${oldPrice} → ${marginalPrice}`);
+        }
+        updated++;
+      }
+    } catch (err) {
+      console.error(`  [FAIL] id=${trade.id} block=${trade.block_number}: ${(err as Error).message?.slice(0, 80)}`);
+      failed++;
+    }
+
+    // Delay between RPC calls to avoid rate limits
+    await new Promise((r) => setTimeout(r, 200));
+  }
+
+  console.log("");
+  console.log(`=== Backfill complete: ${updated} updated, ${failed} failed ===`);
+}
+
+main().catch((err) => {
+  console.error("Fatal error:", err);
+  process.exit(2);
+});