@parabolicfamily/mcp 0.2.0 → 0.2.2

package/src/venues.ts

@@ -91,3 +91,46 @@ export function venueSubgraphsFrom(env: Record<string, string | undefined>, chai
   }
   return out;
 }
+
+// ---- reading another launchpad's coin through the Parabolic site (docs/52 P-D) ----------------------------------
+
+/**
+ * A coin made on another launchpad, as the site writes its reference: `<chain>:<venue>:0x…` (`rhc:pons:0x…`,
+ * `arc:solonpad:0x…`), or `<venue>:0x…` on this server's chain. Undefined for anything else, so a plain address or a
+ * Parabolic ref (`rhc:0x…`) keeps the path it has always taken. The venue is any lowercase word the site might know
+ * (it knows more launchpads than this package routes); the site answers a 400 for one it does not read there.
+ */
+export type VenueRefInput = { chainPart?: string; venue: string; address: Address };
+export function parseVenueRefInput(input: string): VenueRefInput | undefined {
+  const parts = String(input ?? "").trim().split(":");
+  if (parts.length < 2 || parts.length > 3) return undefined;
+  const address = parts[parts.length - 1];
+  const venue = parts[parts.length - 2].toLowerCase();
+  if (!/^0x[0-9a-fA-F]{40}$/.test(address) || !/^[a-z]{2,24}$/.test(venue) || venue === "parabolic") return undefined;
+  // `rhc:0x…` is a chain prefix, not a venue: a two-part ref whose first part names a chain is Parabolic's.
+  if (parts.length === 2 && ["arc", "rhc", "base", "eth", "bnb", "sol", "arct", "anvil"].includes(venue)) return undefined;
+  return { ...(parts.length === 3 ? { chainPart: parts[0].toLowerCase() } : {}), venue, address: address as Address };
+}
+
+/** The coin as the site's public API answers it (web/lib/api/coins.ts `serializeCoin`), the fields this package reads. */
+export type SiteVenueCoin = {
+  chain?: string; venue?: string; address: string; curve?: string | null; name: string; ticker: string; creator: string | null; logo?: string | null; description?: string | null;
+  pair: string; pairToken?: string | null; quoteDecimals?: number | null; quoteDollar?: boolean | null;
+  status: "climbing" | "graduated"; price: number; marketCap: number; raised: number; threshold: number; progressPct: number;
+  holders?: number | null; volume24h?: number | null; change24h?: number | null; tradeCount?: number | null;
+  createdAt?: number | null; lastTradeAt?: number | null; graduatedAt?: number | null; poolId?: string | null; url?: string;
+};
+
+/**
+ * One venue coin from the site (GET <api>/coins/{address}?chain=<key>&venue=<id>), which reads the launchpad's index or
+ * subgraph and, for a coin neither holds, the launchpad's own factory at the head. Undefined on a 404 (no such coin on
+ * that launchpad); any other failure throws a sentence naming the site's answer, never the URL's query.
+ */
+export async function fetchSiteVenueCoin(apiUrl: string, chainKey: string, venue: string, address: Address, fetchImpl: typeof fetch = fetch): Promise<SiteVenueCoin | undefined> {
+  const base = apiUrl.replace(/\/+$/, "");
+  const res = await fetchImpl(`${base}/coins/${address}?chain=${encodeURIComponent(chainKey)}&venue=${encodeURIComponent(venue)}`, { headers: { accept: "application/json" }, signal: AbortSignal.timeout(10_000) });
+  if (res.status === 404) return undefined;
+  const body = (await res.json().catch(() => ({}))) as { coin?: SiteVenueCoin; error?: string };
+  if (!res.ok || !body.coin) throw new Error(`The Parabolic site could not read that coin (HTTP ${res.status}${body.error ? `: ${body.error}` : ""}).`);
+  return body.coin;
+}