@sherwoodagent/cli 0.80.0 → 0.82.0

package/dist/chunk-VR4VHX4D.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/ipfs.ts"],"sourcesContent":["/**\n * IPFS metadata upload/fetch via Sherwood API.\n *\n * Uploads go through the server-side API at api.sherwood.sh/ipfs/upload\n * which holds the Pinata JWT. CLI and app only need the gateway URL for reads.\n */\n\nexport interface FundMetadata {\n  schema: string;\n  name: string;\n  description: string;\n  logo?: string;\n  chain: string;\n  xmtpGroupId?: string;\n  strategies: {\n    id: string;\n    name: string;\n    description: string;\n    protocols: string[];\n    riskLevel: string;\n  }[];\n  terms: {\n    minDeposit?: string;\n    minDepositFormatted?: string;\n    feeModel?: string;\n    lockPeriod?: number;\n  };\n  links: {\n    moltbook?: string;\n    dashboard?: string;\n    github?: string;\n  };\n}\n\nconst DEFAULT_PINATA_GATEWAY = \"https://sherwood.mypinata.cloud\";\n// SHERWOOD_API_URL overrides the BASE — an origin serving the flat v1 tree,\n// e.g. https://api.sherwood.sh, http://localhost:3000/api/v1,\n// https://<deployment>.vercel.app/api/v1.\nconst DEFAULT_API_BASE = \"https://api.sherwood.sh\";\n\nfunction getUploadApiUrl(): string {\n  return `${process.env.SHERWOOD_API_URL ?? DEFAULT_API_BASE}/ipfs/upload`;\n}\n\nfunction getPinataGateway(): string {\n  return process.env.PINATA_GATEWAY || DEFAULT_PINATA_GATEWAY;\n}\n\n/**\n * Upload JSON to IPFS via the Sherwood API (server-side Pinata).\n * Returns the IPFS URI (ipfs://Qm...).\n */\nasync function uploadToIPFS(content: Record<string, unknown>, name: string): Promise<string> {\n  const url = getUploadApiUrl();\n\n  // Transient \"fetch failed\" / cold-start 5xx from the pin API shouldn't kill\n  // a propose flow — retry briefly before surfacing (vnet e2e finding).\n  const attempts = 3;\n  let lastErr: unknown;\n  for (let i = 0; i < attempts; i++) {\n    try {\n      const response = await fetch(url, {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify({ content, name }),\n      });\n\n      if (!response.ok) {\n        const text = await response.text();\n        // 4xx won't improve on retry; 5xx might.\n        if (response.status < 500) throw new Error(`IPFS upload failed (${response.status}): ${text}`);\n        lastErr = new Error(`IPFS upload failed (${response.status}): ${text}`);\n      } else {\n        const result = (await response.json()) as { ipfsHash: string };\n        return `ipfs://${result.ipfsHash}`;\n      }\n    } catch (err) {\n      if (err instanceof Error && err.message.startsWith(\"IPFS upload failed (4\")) throw err;\n      lastErr = err;\n    }\n    if (i < attempts - 1) await new Promise((r) => setTimeout(r, 2000 * (i + 1)));\n  }\n  throw lastErr instanceof Error ? lastErr : new Error(`IPFS upload failed: ${String(lastErr)}`);\n}\n\n/**\n * Pin arbitrary JSON to IPFS.\n * Used for research results and other generic JSON payloads.\n * Returns the IPFS URI (ipfs://Qm...).\n */\nexport async function pinJSON(content: Record<string, unknown>, name: string): Promise<string> {\n  return uploadToIPFS(content, name);\n}\n\n/**\n * Upload fund metadata to IPFS.\n * Returns the IPFS URI (ipfs://Qm...).\n */\nexport async function uploadMetadata(metadata: FundMetadata): Promise<string> {\n  const name = `sherwood-fund-${metadata.name.toLowerCase().replace(/\\s+/g, \"-\")}`;\n  return uploadToIPFS(metadata as unknown as Record<string, unknown>, name);\n}\n\n/**\n * Fetch and parse metadata from an IPFS URI.\n * Supports ipfs:// protocol URIs and raw CIDs.\n */\nexport async function fetchMetadata(ipfsURI: string): Promise<FundMetadata> {\n  const gateway = getPinataGateway();\n  let cid: string;\n\n  if (ipfsURI.startsWith(\"ipfs://\")) {\n    cid = ipfsURI.slice(7);\n  } else if (ipfsURI.startsWith(\"Qm\") || ipfsURI.startsWith(\"bafy\")) {\n    cid = ipfsURI;\n  } else {\n    throw new Error(`Invalid IPFS URI: ${ipfsURI}`);\n  }\n\n  const url = `${gateway}/ipfs/${cid}`;\n  const response = await fetch(url);\n\n  if (!response.ok) {\n    throw new Error(`Failed to fetch metadata from ${url} (${response.status})`);\n  }\n\n  return (await response.json()) as FundMetadata;\n}\n\n/**\n * Merge flag-driven overrides onto the fund's CURRENT metadata.\n *\n * `update-metadata` used to rebuild the JSON from scratch, silently dropping\n * any field not re-supplied by a flag — notably `xmtpGroupId`, which is the\n * ONLY group-discovery path for the dashboard on ENS-less chains (issue #458).\n *\n * Semantics: flags (`name`/`description`) win; everything else on `current`\n * (`xmtpGroupId`, `terms`, `links`, `strategies`, and any unknown keys) is\n * preserved. Unknown keys survive because the spread of `current` is a runtime\n * copy of every own-enumerable property, not just the ones in `FundMetadata`.\n * Pass `current = null` (e.g. when the fetch failed) to fall back to the old\n * build-from-scratch behavior.\n */\nexport function mergeFundMetadata(\n  current: Partial<FundMetadata> | null | undefined,\n  overrides: {\n    name?: string;\n    description?: string;\n    subdomain: string;\n    defaultChain: string;\n  },\n): FundMetadata {\n  const base = { ...(current ?? {}) } as Partial<FundMetadata> & Record<string, unknown>;\n  const name = overrides.name || base.name || overrides.subdomain;\n  const description =\n    overrides.description ||\n    base.description ||\n    `${name} — a Sherwood fund on ${overrides.subdomain}.sherwoodagent.eth`;\n  return {\n    ...base,\n    schema: base.schema || \"sherwood/fund/v1\",\n    name,\n    description,\n    chain: base.chain || overrides.defaultChain,\n    strategies: base.strategies ?? [],\n    terms: base.terms ?? {},\n    links: base.links ?? {},\n  };\n}\n\n/**\n * Resolve a metadata URI (ipfs:// or data: base64) to name + description.\n * Returns null on any error — callers should treat enrichment as best-effort.\n */\nexport async function resolveMetadataSummary(\n  uri: string,\n): Promise<{ name: string; description: string } | null> {\n  try {\n    if (uri.startsWith(\"data:application/json;base64,\")) {\n      const b64 = uri.slice(\"data:application/json;base64,\".length);\n      const json = JSON.parse(Buffer.from(b64, \"base64\").toString(\"utf-8\"));\n      return { name: json.name || \"\", description: json.description || \"\" };\n    }\n    const meta = await fetchMetadata(uri);\n    return { name: meta.name, description: meta.description };\n  } catch {\n    return null;\n  }\n}\n"],"mappings":"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","names":[]}