@paydprotocol/mcp 0.3.0 → 0.3.1

package/dist/server.js

@@ -126,6 +126,7 @@ var GATEWAYS = [
 var LOG_SPAN = 9000n;
 var ROOT_WINDOWS = 6n;
 var GATEWAY_TIMEOUT_MS = 8e3;
+var OLD_GATEWAY_TIMEOUT_MS = 3e3;
 var robinhoodChain = defineChain({
   id: CHAIN_ID,
   name: "Robinhood Chain",
@@ -219,7 +220,7 @@ function createPayd(opts) {
     for (const path of paths) {
       for (const gw of gateways) {
         try {
-          const res = await fetch(gw.trim() + path, { signal: AbortSignal.timeout(GATEWAY_TIMEOUT_MS) });
+          const res = await fetch(gw.trim() + path, { signal: AbortSignal.timeout(publishedAt === void 0 ? GATEWAY_TIMEOUT_MS : OLD_GATEWAY_TIMEOUT_MS) });
           if (!res.ok) continue;
           const text = await res.text();
           if (sha256(toHex(text)) !== digest) continue;
@@ -370,12 +371,15 @@ function createPayd(opts) {
      *
      * An empty array if the address is not in the active root — a holder who
      * arrived after the last publication, or below the threshold. That is not an
-     * error, it is the answer.
+     * error, it is the answer. An artifact no gateway serves IS an error: it
+     * used to read as the same empty array, and a holder was told they had
+     * nothing when the page simply could not see.
      */
     async shares(holder) {
       if (!isAddress(holder)) throw new Error(`payd: invalid holder address: ${holder}`);
-      const { artifact, d } = await activeArtifact();
-      if (!artifact) return [];
+      const { artifact, d, rootId } = await activeArtifact();
+      if (rootId === 0n) return [];
+      if (!artifact) throw new Error("payd: epoch data not found on any gateway");
       const mine = artifact.entries.filter((e) => e.holder.toLowerCase() === holder.toLowerCase());
       return Promise.all(mine.map(async (e) => {
         const stock = e.stock;
@@ -875,7 +879,7 @@ async function holderShares(c, vault, holder) {
     return {
       mode,
       shares: [],
-      note: "Nothing in the current root for this address. Usually: bought after the last publication, or a share under the value floor \u2014 check again after the next epoch. It can also mean the epoch data could not be fetched from any gateway right now. Not an error either way."
+      note: "Nothing in the current root for this address. Usually: bought after the last publication, or a share under the value floor \u2014 check again after the next epoch. Not an error. (Epoch data that cannot be fetched comes back as an error, never as this.)"
     };
   }
   return {
@@ -887,10 +891,18 @@ async function holderShares(c, vault, holder) {
 async function holderPortfolio(c, holder) {
   const h = requireAddress("holder", holder);
   const { tokens } = await listTokens(c, { limit: Number.MAX_SAFE_INTEGER, offset: 0 });
-  const rows = await Promise.all(tokens.map(async (t) => ({ ...t, ...await holderShares(c, t.vault, h) })));
+  const rows = await Promise.all(tokens.map(async (t) => {
+    try {
+      return { ...t, ...await holderShares(c, t.vault, h) };
+    } catch (e) {
+      return { ...t, shares: [], error: e.message };
+    }
+  }));
   const paying = rows.filter((r) => r.shares.length > 0);
+  const unreadable = rows.filter((r) => "error" in r).map((r) => ({ vault: r.vault, symbol: r.symbol, error: r.error }));
   return {
     launches: paying,
+    ...unreadable.length ? { unreadable } : {},
     scanned: rows.length,
     note: "Only launches where this address is in the current root are listed. Backing and lottery launches never list a share (see payd_token_info.howHoldersArePaid). " + UNTRUSTED_NOTE
   };
@@ -901,7 +913,9 @@ async function holderHistory(c, vault, holder, days) {
   if (payScreen(mode) !== "claim") return { mode, legs: [], note: PAID_HOW[mode] };
   const since = Math.floor(Date.now() / 1e3) - Math.round(days * 86400);
   const r = await createPayd({ vault: v, client: c }).earnedSince(requireAddress("holder", holder), since);
-  if (!r) throw new Error("the older epoch data could not be fetched from any gateway right now; try again later");
+  if (!r) {
+    throw new Error(`no epoch data from ${days} days ago: the keeper keeps only its most recent epoch files pinned (a few days' worth), and older ones are dropped by design. Ask for a shorter period.`);
+  }
   return {
     mode,
     days,
@@ -957,7 +971,7 @@ async function launchOptions(c) {
 // src/register.ts
 import { readFileSync } from "node:fs";
 import { z } from "zod";
-var VERSION = "0.3.0";
+var VERSION = "0.3.1";
 var run = async (f) => {
   try {
     return { content: [{ type: "text", text: toJson(await f()) }] };

package/docs/SDK.md

@@ -262,6 +262,7 @@ that is the answer.
 | What you see | What it is |
 |---|---|
 | `shares()` returns nothing for a real holder | they are not in the *current* root — bought after the last publication, or below the threshold. Next epoch fixes it. |
+| `shares()` throws `epoch data not found on any gateway` | the root exists but no gateway served its artifact (since 2026-10-07; it used to return `[]`, which told a holder they had nothing). Retry; it is not their share. |
 | `activeRoot() == 0` | no root published yet. A brand-new launch. Show "preparing the first payout". |
 | `economics()` returns zeros | a Pons getter moved. Hide the block; do not show 0 %. |
 | the artifact fetch fails on every gateway | the content is fine, the gateways are not. Retry, add gateways. Never fall back to unverified content. |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paydprotocol/mcp",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Keyless MCP server for Payd on Robinhood Chain: read launches, baskets and holder shares, and prepare unsigned transactions for your own wallet.",
   "type": "module",
   "license": "MIT",