@ergoblockchain/sage-widget 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ergo Platform contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,134 @@
+# @ergoblockchain/sage-widget
+
+[![npm](https://img.shields.io/npm/v/@ergoblockchain/sage-widget.svg)](https://www.npmjs.com/package/@ergoblockchain/sage-widget)
+[![license](https://img.shields.io/npm/l/@ergoblockchain/sage-widget.svg)](./LICENSE)
+
+Embeddable live-activity feed for **Sage** — the agent-economy concierge on [ergoblockchain.org](https://www.ergoblockchain.org). Drop a typed React component into your app, or call a vanilla DOM mount function from any framework. Every settled paid query Sage takes appears in the feed within a minute, with a clickable link to the on-chain receipt.
+
+> _Why this matters:_ Sage settles real paid AI queries on Ergo testnet. The feed makes the "agent-economy" thesis visibly provable wherever you embed it — not a marketing claim, a list of public on-chain receipts that update live.
+
+## Install
+
+```bash
+npm install @ergoblockchain/sage-widget
+# or
+pnpm add @ergoblockchain/sage-widget
+# or
+yarn add @ergoblockchain/sage-widget
+```
+
+`react` and `react-dom` are optional peer deps — only required if you import from `/react`.
+
+## Use it
+
+### React
+
+```tsx
+import { SageActivityFeed } from "@ergoblockchain/sage-widget/react"
+
+export function Footer() {
+  return <SageActivityFeed limit={5} refreshMs={60_000} />
+}
+```
+
+The component renders into your DOM (no iframe), styles itself with inline styles to avoid host-CSS conflicts, and polls `/api/sage/activity` on the host you point it at.
+
+### Vanilla / non-React
+
+```ts
+import { mountSageFeed } from "@ergoblockchain/sage-widget/vanilla"
+
+const handle = mountSageFeed(document.getElementById("sage-feed")!, {
+  limit: 5,
+  refreshMs: 60_000,
+})
+
+// later, if you want to tear down:
+handle.destroy()
+```
+
+Or use the canonical hosted CDN drop-in (no install needed):
+
+```html
+<div id="sage-feed"></div>
+<script src="https://www.ergoblockchain.org/agents.js"
+        data-target="#sage-feed"
+        data-height="320"
+        async></script>
+```
+
+That last form is an iframe variant served straight from ergoblockchain.org — total style isolation, zero install. Use the npm package when you want the markup inline (themable, accessibility-friendly, tree-shakeable).
+
+## Just the types
+
+If you want to render your own UI over Sage's API and skip the bundled components:
+
+```ts
+import {
+  fetchSageActivity,
+  type SageActivityEvent,
+  type SageActivityResponse,
+} from "@ergoblockchain/sage-widget"
+
+const data: SageActivityResponse = await fetchSageActivity({ limit: 10 })
+const settlements = data.events.filter((e) => e.type === "settlement")
+```
+
+## Render-prop / bring-your-own-design
+
+```tsx
+<SageActivityFeed>
+  {({ response, loading }) => (
+    <MyOwnDesign events={response?.events ?? []} loading={loading} />
+  )}
+</SageActivityFeed>
+```
+
+## Options
+
+| Prop            | Type                              | Default                                   | Notes                                                                                          |
+| --------------- | --------------------------------- | ----------------------------------------- | ---------------------------------------------------------------------------------------------- |
+| `apiBase`       | `string`                          | `"https://www.ergoblockchain.org"`        | Override if you run your own Sage deployment behind a custom domain.                            |
+| `limit`         | `number`                          | `5`                                       | Max 25.                                                                                        |
+| `refreshMs`     | `number`                          | `60000`                                   | Poll interval. Set to `0` to fetch once on mount and never refresh.                            |
+| `onUpdate`      | `(r: SageActivityResponse) => void` | —                                       | Fired after every successful poll.                                                              |
+| `onError`       | `(err: unknown) => void`          | `console.warn`                            | Fired on fetch failure.                                                                         |
+| `className`     | `string`                          | —                                         | Applied to the root container (React only).                                                    |
+| `style`         | `CSSProperties`                   | —                                         | Inline style merged onto the root container (React only).                                      |
+| `children`      | render-prop                       | —                                         | Pass a function for full UI control; the component will skip the default markup.               |
+
+## Event shape
+
+Each event in `response.events` is a typed object:
+
+```ts
+{
+  txId: string                       // 64-char hex
+  blockHeight: number
+  timestamp: number                  // ms epoch
+  type: "settlement" | "issuance" | "transfer"
+  inflowNanoErg: number              // sum of outputs to Sage wallet
+  paymentNanoErg?: number            // value of redeemed Note (settlements only)
+  noteBoxId?: string                 // first Note-shape input
+}
+```
+
+For settlements, use `paymentNanoErg` (the value of the consumed Note) for "amount paid" display. `inflowNanoErg` includes change boxes when buyer and seller share an address in test setups.
+
+## Related
+
+- **Live demo**: [ergoblockchain.org/agent-economy#sage-activity](https://www.ergoblockchain.org/agent-economy#sage-activity)
+- **API directly**: [`/api/sage/activity`](https://www.ergoblockchain.org/api/sage/activity) — JSON, no auth, cached 30s
+- **Receipt format**: [`/r/sage/<settlement_tx_id>`](https://www.ergoblockchain.org/r/sage/f697e4841dd9a0c689d0b83a311130b85a0cfbab123230a6c40284b44c4cafef)
+- **Accord Protocol**: [github.com/accord-protocol/accord-protocol](https://github.com/accord-protocol/accord-protocol)
+- **Sage in the registry**: [accord-protocol/registry/providers/sage.json](https://github.com/accord-protocol/accord-protocol/blob/main/registry/providers/sage.json)
+
+## Roadmap
+
+- **v0.1.x** _(current)_ — read-only activity feed (React + vanilla + types).
+- **v0.2** — `<SagePaymentWidget />` full chat with 402 + payment + Sonnet answer.
+- **v0.3** — generic `<AccordActivityFeed providerId="..." />` that works for any provider in the registry, not just Sage.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,51 @@
+'use strict';
+
+// src/types.ts
+var DEFAULT_API_BASE = "https://www.ergoblockchain.org";
+var DEFAULT_LIMIT = 5;
+var DEFAULT_REFRESH_MS = 6e4;
+
+// src/api.ts
+async function fetchSageActivity(opts = {}) {
+  const base = opts.apiBase ?? DEFAULT_API_BASE;
+  const limit = Math.min(Math.max(opts.limit ?? DEFAULT_LIMIT, 1), 25);
+  const url = `${base}/api/sage/activity?limit=${limit}`;
+  const res = await fetch(url, { signal: opts.signal });
+  if (!res.ok) {
+    throw new Error(`sage activity ${res.status}`);
+  }
+  return await res.json();
+}
+function nanoToErg(nano) {
+  if (!nano || nano <= 0) return "0";
+  const erg = nano / 1e9;
+  return erg.toFixed(9).replace(/\.?0+$/, "");
+}
+function relativeTime(ms, now = Date.now()) {
+  const diff = Math.max(0, now - ms);
+  const sec = Math.floor(diff / 1e3);
+  if (sec < 60) return `${sec}s ago`;
+  const min = Math.floor(sec / 60);
+  if (min < 60) return `${min}m ago`;
+  const hr = Math.floor(min / 60);
+  if (hr < 24) return `${hr}h ago`;
+  const day = Math.floor(hr / 24);
+  return `${day}d ago`;
+}
+function receiptUrl(txId, apiBase = DEFAULT_API_BASE) {
+  return `${apiBase}/r/sage/${txId}`;
+}
+function explorerUrl(txId, network = "testnet") {
+  return network === "testnet" ? `https://testnet.ergoplatform.com/transactions/${txId}` : `https://explorer.ergoplatform.com/transactions/${txId}`;
+}
+
+exports.DEFAULT_API_BASE = DEFAULT_API_BASE;
+exports.DEFAULT_LIMIT = DEFAULT_LIMIT;
+exports.DEFAULT_REFRESH_MS = DEFAULT_REFRESH_MS;
+exports.explorerUrl = explorerUrl;
+exports.fetchSageActivity = fetchSageActivity;
+exports.nanoToErg = nanoToErg;
+exports.receiptUrl = receiptUrl;
+exports.relativeTime = relativeTime;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/api.ts"],"names":[],"mappings":";;;AA6EO,IAAM,gBAAA,GAAmB;AACzB,IAAM,aAAA,GAAgB;AACtB,IAAM,kBAAA,GAAqB;;;AC5DlC,eAAsB,iBAAA,CACpB,IAAA,GAA6B,EAAC,EACC;AAC/B,EAAA,MAAM,IAAA,GAAO,KAAK,OAAA,IAAW,gBAAA;AAC7B,EAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,GAAA,CAAI,IAAA,CAAK,GAAA,CAAI,KAAK,KAAA,IAAS,aAAA,EAAe,CAAC,CAAA,EAAG,EAAE,CAAA;AACnE,EAAA,MAAM,GAAA,GAAM,CAAA,EAAG,IAAI,CAAA,yBAAA,EAA4B,KAAK,CAAA,CAAA;AACpD,EAAA,MAAM,GAAA,GAAM,MAAM,KAAA,CAAM,GAAA,EAAK,EAAE,MAAA,EAAQ,IAAA,CAAK,QAAQ,CAAA;AACpD,EAAA,IAAI,CAAC,IAAI,EAAA,EAAI;AACX,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,cAAA,EAAiB,GAAA,CAAI,MAAM,CAAA,CAAE,CAAA;AAAA,EAC/C;AACA,EAAA,OAAQ,MAAM,IAAI,IAAA,EAAK;AACzB;AAGO,SAAS,UAAU,IAAA,EAAkC;AAC1D,EAAA,IAAI,CAAC,IAAA,IAAQ,IAAA,IAAQ,CAAA,EAAG,OAAO,GAAA;AAC/B,EAAA,MAAM,MAAM,IAAA,GAAO,GAAA;AACnB,EAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,CAAA,CAAE,OAAA,CAAQ,UAAU,EAAE,CAAA;AAC5C;AAGO,SAAS,YAAA,CAAa,EAAA,EAAY,GAAA,GAAc,IAAA,CAAK,KAAI,EAAW;AACzE,EAAA,MAAM,IAAA,GAAO,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,MAAM,EAAE,CAAA;AACjC,EAAA,MAAM,GAAA,GAAM,IAAA,CAAK,KAAA,CAAM,IAAA,GAAO,GAAI,CAAA;AAClC,EAAA,IAAI,GAAA,GAAM,EAAA,EAAI,OAAO,CAAA,EAAG,GAAG,CAAA,KAAA,CAAA;AAC3B,EAAA,MAAM,GAAA,GAAM,IAAA,CAAK,KAAA,CAAM,GAAA,GAAM,EAAE,CAAA;AAC/B,EAAA,IAAI,GAAA,GAAM,EAAA,EAAI,OAAO,CAAA,EAAG,GAAG,CAAA,KAAA,CAAA;AAC3B,EAAA,MAAM,EAAA,GAAK,IAAA,CAAK,KAAA,CAAM,GAAA,GAAM,EAAE,CAAA;AAC9B,EAAA,IAAI,EAAA,GAAK,EAAA,EAAI,OAAO,CAAA,EAAG,EAAE,CAAA,KAAA,CAAA;AACzB,EAAA,MAAM,GAAA,GAAM,IAAA,CAAK,KAAA,CAAM,EAAA,GAAK,EAAE,CAAA;AAC9B,EAAA,OAAO,GAAG,GAAG,CAAA,KAAA,CAAA;AACf;AAGO,SAAS,UAAA,CAAW,IAAA,EAAc,OAAA,GAAkB,gBAAA,EAA0B;AACnF,EAAA,OAAO,CAAA,EAAG,OAAO,CAAA,QAAA,EAAW,IAAI,CAAA,CAAA;AAClC;AAGO,SAAS,WAAA,CACd,IAAA,EACA,OAAA,GAAiC,SAAA,EACzB;AACR,EAAA,OAAO,YAAY,SAAA,GACf,CAAA,8CAAA,EAAiD,IAAI,CAAA,CAAA,GACrD,kDAAkD,IAAI,CAAA,CAAA;AAC5D","file":"index.cjs","sourcesContent":["/**\n * Public types — mirror of /api/sage/activity response shape.\n *\n * The source of truth is the API at https://www.ergoblockchain.org/api/sage/activity;\n * this file re-states the schema so consumers don't have to depend on the\n * server-side fetcher.\n */\n\nexport type SageActivityType = \"settlement\" | \"issuance\" | \"transfer\"\n\nexport interface SageActivityEvent {\n  /** 64-char hex transaction id. */\n  txId: string\n  /** Block height at inclusion. */\n  blockHeight: number\n  /** Block timestamp (ms epoch). */\n  timestamp: number\n  /** Heuristic classification of the tx. */\n  type: SageActivityType\n  /** nanoERG flowing into the seller wallet from this tx (sum of outputs). */\n  inflowNanoErg: number\n  /**\n   * For settlements: value of the redeemed Note (= what the buyer paid).\n   * For other event types: undefined.\n   *\n   * Use this — not `inflowNanoErg` — when displaying \"amount paid for a\n   * settled query\". `inflowNanoErg` includes change boxes in test setups\n   * where the buyer and seller share an address.\n   */\n  paymentNanoErg?: number\n  /** First input box that carries Note-shape registers, if any. */\n  noteBoxId?: string\n}\n\nexport interface SageActivityResponse {\n  ok: boolean\n  network: \"testnet\" | \"mainnet\"\n  /** Sage seller wallet address. */\n  receiver: string\n  /** Total number of txs ever touching the wallet, per the explorer. */\n  total: number\n  events: SageActivityEvent[]\n  error?: string\n}\n\n/**\n * Configuration accepted by every entry point (React component +\n * vanilla mount fn). Defaults below are sensible for the canonical\n * ergoblockchain.org deployment.\n */\nexport interface SageWidgetOptions {\n  /**\n   * Base URL of the Sage host. Override if you run your own Sage\n   * deployment behind a custom domain. Default: ergoblockchain.org.\n   */\n  apiBase?: string\n  /**\n   * Number of events to display (max 25). Default: 5.\n   */\n  limit?: number\n  /**\n   * Polling interval in ms. Default: 60000 (60s). Set to 0 to disable\n   * polling — the widget will fetch once on mount and never refresh.\n   */\n  refreshMs?: number\n  /**\n   * Optional callback fired every time a fresh response arrives. Useful\n   * for analytics or for triggering host-side animations on new\n   * settlements.\n   */\n  onUpdate?: (response: SageActivityResponse) => void\n  /**\n   * Optional callback fired on fetch errors. Default: console.warn.\n   */\n  onError?: (error: unknown) => void\n}\n\nexport const DEFAULT_API_BASE = \"https://www.ergoblockchain.org\"\nexport const DEFAULT_LIMIT = 5\nexport const DEFAULT_REFRESH_MS = 60_000\n","/**\n * Thin client over /api/sage/activity.\n *\n * Pure fetch + shape — no rendering, no DOM. React + vanilla mounts\n * both call into here so the API contract lives in one place.\n */\n\nimport {\n  DEFAULT_API_BASE,\n  DEFAULT_LIMIT,\n  type SageActivityResponse,\n} from \"./types\"\n\nexport interface FetchActivityOptions {\n  apiBase?: string\n  limit?: number\n  signal?: AbortSignal\n}\n\nexport async function fetchSageActivity(\n  opts: FetchActivityOptions = {},\n): Promise<SageActivityResponse> {\n  const base = opts.apiBase ?? DEFAULT_API_BASE\n  const limit = Math.min(Math.max(opts.limit ?? DEFAULT_LIMIT, 1), 25)\n  const url = `${base}/api/sage/activity?limit=${limit}`\n  const res = await fetch(url, { signal: opts.signal })\n  if (!res.ok) {\n    throw new Error(`sage activity ${res.status}`)\n  }\n  return (await res.json()) as SageActivityResponse\n}\n\n/** nanoERG → \"0.001\" (trims trailing zeros, max 9 decimals). */\nexport function nanoToErg(nano: number | undefined): string {\n  if (!nano || nano <= 0) return \"0\"\n  const erg = nano / 1e9\n  return erg.toFixed(9).replace(/\\.?0+$/, \"\")\n}\n\n/** Cheap relative-time formatter, ASCII-only, no Intl deps. */\nexport function relativeTime(ms: number, now: number = Date.now()): string {\n  const diff = Math.max(0, now - ms)\n  const sec = Math.floor(diff / 1000)\n  if (sec < 60) return `${sec}s ago`\n  const min = Math.floor(sec / 60)\n  if (min < 60) return `${min}m ago`\n  const hr = Math.floor(min / 60)\n  if (hr < 24) return `${hr}h ago`\n  const day = Math.floor(hr / 24)\n  return `${day}d ago`\n}\n\n/** Receipt URL for a settled tx, given the host base. */\nexport function receiptUrl(txId: string, apiBase: string = DEFAULT_API_BASE): string {\n  return `${apiBase}/r/sage/${txId}`\n}\n\n/** Explorer URL for a tx on the given network. */\nexport function explorerUrl(\n  txId: string,\n  network: \"testnet\" | \"mainnet\" = \"testnet\",\n): string {\n  return network === \"testnet\"\n    ? `https://testnet.ergoplatform.com/transactions/${txId}`\n    : `https://explorer.ergoplatform.com/transactions/${txId}`\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,26 @@
+import { c as SageActivityResponse } from './types-uzMz6_mP.cjs';
+export { D as DEFAULT_API_BASE, a as DEFAULT_LIMIT, b as DEFAULT_REFRESH_MS, S as SageActivityEvent, d as SageActivityType, e as SageWidgetOptions } from './types-uzMz6_mP.cjs';
+
+/**
+ * Thin client over /api/sage/activity.
+ *
+ * Pure fetch + shape — no rendering, no DOM. React + vanilla mounts
+ * both call into here so the API contract lives in one place.
+ */
+
+interface FetchActivityOptions {
+    apiBase?: string;
+    limit?: number;
+    signal?: AbortSignal;
+}
+declare function fetchSageActivity(opts?: FetchActivityOptions): Promise<SageActivityResponse>;
+/** nanoERG → "0.001" (trims trailing zeros, max 9 decimals). */
+declare function nanoToErg(nano: number | undefined): string;
+/** Cheap relative-time formatter, ASCII-only, no Intl deps. */
+declare function relativeTime(ms: number, now?: number): string;
+/** Receipt URL for a settled tx, given the host base. */
+declare function receiptUrl(txId: string, apiBase?: string): string;
+/** Explorer URL for a tx on the given network. */
+declare function explorerUrl(txId: string, network?: "testnet" | "mainnet"): string;
+
+export { SageActivityResponse, explorerUrl, fetchSageActivity, nanoToErg, receiptUrl, relativeTime };

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+import { c as SageActivityResponse } from './types-uzMz6_mP.js';
+export { D as DEFAULT_API_BASE, a as DEFAULT_LIMIT, b as DEFAULT_REFRESH_MS, S as SageActivityEvent, d as SageActivityType, e as SageWidgetOptions } from './types-uzMz6_mP.js';
+
+/**
+ * Thin client over /api/sage/activity.
+ *
+ * Pure fetch + shape — no rendering, no DOM. React + vanilla mounts
+ * both call into here so the API contract lives in one place.
+ */
+
+interface FetchActivityOptions {
+    apiBase?: string;
+    limit?: number;
+    signal?: AbortSignal;
+}
+declare function fetchSageActivity(opts?: FetchActivityOptions): Promise<SageActivityResponse>;
+/** nanoERG → "0.001" (trims trailing zeros, max 9 decimals). */
+declare function nanoToErg(nano: number | undefined): string;
+/** Cheap relative-time formatter, ASCII-only, no Intl deps. */
+declare function relativeTime(ms: number, now?: number): string;
+/** Receipt URL for a settled tx, given the host base. */
+declare function receiptUrl(txId: string, apiBase?: string): string;
+/** Explorer URL for a tx on the given network. */
+declare function explorerUrl(txId: string, network?: "testnet" | "mainnet"): string;
+
+export { SageActivityResponse, explorerUrl, fetchSageActivity, nanoToErg, receiptUrl, relativeTime };

package/dist/index.js

@@ -0,0 +1,42 @@
+// src/types.ts
+var DEFAULT_API_BASE = "https://www.ergoblockchain.org";
+var DEFAULT_LIMIT = 5;
+var DEFAULT_REFRESH_MS = 6e4;
+
+// src/api.ts
+async function fetchSageActivity(opts = {}) {
+  const base = opts.apiBase ?? DEFAULT_API_BASE;
+  const limit = Math.min(Math.max(opts.limit ?? DEFAULT_LIMIT, 1), 25);
+  const url = `${base}/api/sage/activity?limit=${limit}`;
+  const res = await fetch(url, { signal: opts.signal });
+  if (!res.ok) {
+    throw new Error(`sage activity ${res.status}`);
+  }
+  return await res.json();
+}
+function nanoToErg(nano) {
+  if (!nano || nano <= 0) return "0";
+  const erg = nano / 1e9;
+  return erg.toFixed(9).replace(/\.?0+$/, "");
+}
+function relativeTime(ms, now = Date.now()) {
+  const diff = Math.max(0, now - ms);
+  const sec = Math.floor(diff / 1e3);
+  if (sec < 60) return `${sec}s ago`;
+  const min = Math.floor(sec / 60);
+  if (min < 60) return `${min}m ago`;
+  const hr = Math.floor(min / 60);
+  if (hr < 24) return `${hr}h ago`;
+  const day = Math.floor(hr / 24);
+  return `${day}d ago`;
+}
+function receiptUrl(txId, apiBase = DEFAULT_API_BASE) {
+  return `${apiBase}/r/sage/${txId}`;
+}
+function explorerUrl(txId, network = "testnet") {
+  return network === "testnet" ? `https://testnet.ergoplatform.com/transactions/${txId}` : `https://explorer.ergoplatform.com/transactions/${txId}`;
+}
+
+export { DEFAULT_API_BASE, DEFAULT_LIMIT, DEFAULT_REFRESH_MS, explorerUrl, fetchSageActivity, nanoToErg, receiptUrl, relativeTime };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/api.ts"],"names":[],"mappings":";AA6EO,IAAM,gBAAA,GAAmB;AACzB,IAAM,aAAA,GAAgB;AACtB,IAAM,kBAAA,GAAqB;;;AC5DlC,eAAsB,iBAAA,CACpB,IAAA,GAA6B,EAAC,EACC;AAC/B,EAAA,MAAM,IAAA,GAAO,KAAK,OAAA,IAAW,gBAAA;AAC7B,EAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,GAAA,CAAI,IAAA,CAAK,GAAA,CAAI,KAAK,KAAA,IAAS,aAAA,EAAe,CAAC,CAAA,EAAG,EAAE,CAAA;AACnE,EAAA,MAAM,GAAA,GAAM,CAAA,EAAG,IAAI,CAAA,yBAAA,EAA4B,KAAK,CAAA,CAAA;AACpD,EAAA,MAAM,GAAA,GAAM,MAAM,KAAA,CAAM,GAAA,EAAK,EAAE,MAAA,EAAQ,IAAA,CAAK,QAAQ,CAAA;AACpD,EAAA,IAAI,CAAC,IAAI,EAAA,EAAI;AACX,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,cAAA,EAAiB,GAAA,CAAI,MAAM,CAAA,CAAE,CAAA;AAAA,EAC/C;AACA,EAAA,OAAQ,MAAM,IAAI,IAAA,EAAK;AACzB;AAGO,SAAS,UAAU,IAAA,EAAkC;AAC1D,EAAA,IAAI,CAAC,IAAA,IAAQ,IAAA,IAAQ,CAAA,EAAG,OAAO,GAAA;AAC/B,EAAA,MAAM,MAAM,IAAA,GAAO,GAAA;AACnB,EAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,CAAA,CAAE,OAAA,CAAQ,UAAU,EAAE,CAAA;AAC5C;AAGO,SAAS,YAAA,CAAa,EAAA,EAAY,GAAA,GAAc,IAAA,CAAK,KAAI,EAAW;AACzE,EAAA,MAAM,IAAA,GAAO,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,MAAM,EAAE,CAAA;AACjC,EAAA,MAAM,GAAA,GAAM,IAAA,CAAK,KAAA,CAAM,IAAA,GAAO,GAAI,CAAA;AAClC,EAAA,IAAI,GAAA,GAAM,EAAA,EAAI,OAAO,CAAA,EAAG,GAAG,CAAA,KAAA,CAAA;AAC3B,EAAA,MAAM,GAAA,GAAM,IAAA,CAAK,KAAA,CAAM,GAAA,GAAM,EAAE,CAAA;AAC/B,EAAA,IAAI,GAAA,GAAM,EAAA,EAAI,OAAO,CAAA,EAAG,GAAG,CAAA,KAAA,CAAA;AAC3B,EAAA,MAAM,EAAA,GAAK,IAAA,CAAK,KAAA,CAAM,GAAA,GAAM,EAAE,CAAA;AAC9B,EAAA,IAAI,EAAA,GAAK,EAAA,EAAI,OAAO,CAAA,EAAG,EAAE,CAAA,KAAA,CAAA;AACzB,EAAA,MAAM,GAAA,GAAM,IAAA,CAAK,KAAA,CAAM,EAAA,GAAK,EAAE,CAAA;AAC9B,EAAA,OAAO,GAAG,GAAG,CAAA,KAAA,CAAA;AACf;AAGO,SAAS,UAAA,CAAW,IAAA,EAAc,OAAA,GAAkB,gBAAA,EAA0B;AACnF,EAAA,OAAO,CAAA,EAAG,OAAO,CAAA,QAAA,EAAW,IAAI,CAAA,CAAA;AAClC;AAGO,SAAS,WAAA,CACd,IAAA,EACA,OAAA,GAAiC,SAAA,EACzB;AACR,EAAA,OAAO,YAAY,SAAA,GACf,CAAA,8CAAA,EAAiD,IAAI,CAAA,CAAA,GACrD,kDAAkD,IAAI,CAAA,CAAA;AAC5D","file":"index.js","sourcesContent":["/**\n * Public types — mirror of /api/sage/activity response shape.\n *\n * The source of truth is the API at https://www.ergoblockchain.org/api/sage/activity;\n * this file re-states the schema so consumers don't have to depend on the\n * server-side fetcher.\n */\n\nexport type SageActivityType = \"settlement\" | \"issuance\" | \"transfer\"\n\nexport interface SageActivityEvent {\n  /** 64-char hex transaction id. */\n  txId: string\n  /** Block height at inclusion. */\n  blockHeight: number\n  /** Block timestamp (ms epoch). */\n  timestamp: number\n  /** Heuristic classification of the tx. */\n  type: SageActivityType\n  /** nanoERG flowing into the seller wallet from this tx (sum of outputs). */\n  inflowNanoErg: number\n  /**\n   * For settlements: value of the redeemed Note (= what the buyer paid).\n   * For other event types: undefined.\n   *\n   * Use this — not `inflowNanoErg` — when displaying \"amount paid for a\n   * settled query\". `inflowNanoErg` includes change boxes in test setups\n   * where the buyer and seller share an address.\n   */\n  paymentNanoErg?: number\n  /** First input box that carries Note-shape registers, if any. */\n  noteBoxId?: string\n}\n\nexport interface SageActivityResponse {\n  ok: boolean\n  network: \"testnet\" | \"mainnet\"\n  /** Sage seller wallet address. */\n  receiver: string\n  /** Total number of txs ever touching the wallet, per the explorer. */\n  total: number\n  events: SageActivityEvent[]\n  error?: string\n}\n\n/**\n * Configuration accepted by every entry point (React component +\n * vanilla mount fn). Defaults below are sensible for the canonical\n * ergoblockchain.org deployment.\n */\nexport interface SageWidgetOptions {\n  /**\n   * Base URL of the Sage host. Override if you run your own Sage\n   * deployment behind a custom domain. Default: ergoblockchain.org.\n   */\n  apiBase?: string\n  /**\n   * Number of events to display (max 25). Default: 5.\n   */\n  limit?: number\n  /**\n   * Polling interval in ms. Default: 60000 (60s). Set to 0 to disable\n   * polling — the widget will fetch once on mount and never refresh.\n   */\n  refreshMs?: number\n  /**\n   * Optional callback fired every time a fresh response arrives. Useful\n   * for analytics or for triggering host-side animations on new\n   * settlements.\n   */\n  onUpdate?: (response: SageActivityResponse) => void\n  /**\n   * Optional callback fired on fetch errors. Default: console.warn.\n   */\n  onError?: (error: unknown) => void\n}\n\nexport const DEFAULT_API_BASE = \"https://www.ergoblockchain.org\"\nexport const DEFAULT_LIMIT = 5\nexport const DEFAULT_REFRESH_MS = 60_000\n","/**\n * Thin client over /api/sage/activity.\n *\n * Pure fetch + shape — no rendering, no DOM. React + vanilla mounts\n * both call into here so the API contract lives in one place.\n */\n\nimport {\n  DEFAULT_API_BASE,\n  DEFAULT_LIMIT,\n  type SageActivityResponse,\n} from \"./types\"\n\nexport interface FetchActivityOptions {\n  apiBase?: string\n  limit?: number\n  signal?: AbortSignal\n}\n\nexport async function fetchSageActivity(\n  opts: FetchActivityOptions = {},\n): Promise<SageActivityResponse> {\n  const base = opts.apiBase ?? DEFAULT_API_BASE\n  const limit = Math.min(Math.max(opts.limit ?? DEFAULT_LIMIT, 1), 25)\n  const url = `${base}/api/sage/activity?limit=${limit}`\n  const res = await fetch(url, { signal: opts.signal })\n  if (!res.ok) {\n    throw new Error(`sage activity ${res.status}`)\n  }\n  return (await res.json()) as SageActivityResponse\n}\n\n/** nanoERG → \"0.001\" (trims trailing zeros, max 9 decimals). */\nexport function nanoToErg(nano: number | undefined): string {\n  if (!nano || nano <= 0) return \"0\"\n  const erg = nano / 1e9\n  return erg.toFixed(9).replace(/\\.?0+$/, \"\")\n}\n\n/** Cheap relative-time formatter, ASCII-only, no Intl deps. */\nexport function relativeTime(ms: number, now: number = Date.now()): string {\n  const diff = Math.max(0, now - ms)\n  const sec = Math.floor(diff / 1000)\n  if (sec < 60) return `${sec}s ago`\n  const min = Math.floor(sec / 60)\n  if (min < 60) return `${min}m ago`\n  const hr = Math.floor(min / 60)\n  if (hr < 24) return `${hr}h ago`\n  const day = Math.floor(hr / 24)\n  return `${day}d ago`\n}\n\n/** Receipt URL for a settled tx, given the host base. */\nexport function receiptUrl(txId: string, apiBase: string = DEFAULT_API_BASE): string {\n  return `${apiBase}/r/sage/${txId}`\n}\n\n/** Explorer URL for a tx on the given network. */\nexport function explorerUrl(\n  txId: string,\n  network: \"testnet\" | \"mainnet\" = \"testnet\",\n): string {\n  return network === \"testnet\"\n    ? `https://testnet.ergoplatform.com/transactions/${txId}`\n    : `https://explorer.ergoplatform.com/transactions/${txId}`\n}\n"]}

package/dist/react.cjs

@@ -0,0 +1,302 @@
+'use strict';
+
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+// src/react/SageActivityFeed.tsx
+
+// src/types.ts
+var DEFAULT_API_BASE = "https://www.ergoblockchain.org";
+var DEFAULT_LIMIT = 5;
+var DEFAULT_REFRESH_MS = 6e4;
+
+// src/api.ts
+async function fetchSageActivity(opts = {}) {
+  const base = opts.apiBase ?? DEFAULT_API_BASE;
+  const limit = Math.min(Math.max(opts.limit ?? DEFAULT_LIMIT, 1), 25);
+  const url = `${base}/api/sage/activity?limit=${limit}`;
+  const res = await fetch(url, { signal: opts.signal });
+  if (!res.ok) {
+    throw new Error(`sage activity ${res.status}`);
+  }
+  return await res.json();
+}
+function nanoToErg(nano) {
+  if (!nano || nano <= 0) return "0";
+  const erg = nano / 1e9;
+  return erg.toFixed(9).replace(/\.?0+$/, "");
+}
+function relativeTime(ms, now = Date.now()) {
+  const diff = Math.max(0, now - ms);
+  const sec = Math.floor(diff / 1e3);
+  if (sec < 60) return `${sec}s ago`;
+  const min = Math.floor(sec / 60);
+  if (min < 60) return `${min}m ago`;
+  const hr = Math.floor(min / 60);
+  if (hr < 24) return `${hr}h ago`;
+  const day = Math.floor(hr / 24);
+  return `${day}d ago`;
+}
+function receiptUrl(txId, apiBase = DEFAULT_API_BASE) {
+  return `${apiBase}/r/sage/${txId}`;
+}
+function explorerUrl(txId, network = "testnet") {
+  return network === "testnet" ? `https://testnet.ergoplatform.com/transactions/${txId}` : `https://explorer.ergoplatform.com/transactions/${txId}`;
+}
+var ONE_MIN = 6e4;
+function SageActivityFeed(props) {
+  const {
+    apiBase,
+    limit = DEFAULT_LIMIT,
+    refreshMs = DEFAULT_REFRESH_MS,
+    onUpdate,
+    onError,
+    className,
+    style,
+    children
+  } = props;
+  const [response, setResponse] = react.useState(null);
+  const [error, setError] = react.useState(null);
+  const [loading, setLoading] = react.useState(true);
+  const [now, setNow] = react.useState(() => Date.now());
+  const onUpdateRef = react.useRef(onUpdate);
+  const onErrorRef = react.useRef(onError);
+  react.useEffect(() => {
+    onUpdateRef.current = onUpdate;
+  }, [onUpdate]);
+  react.useEffect(() => {
+    onErrorRef.current = onError;
+  }, [onError]);
+  react.useEffect(() => {
+    let cancelled = false;
+    const abort = new AbortController();
+    async function load() {
+      try {
+        const data = await fetchSageActivity({
+          apiBase,
+          limit,
+          signal: abort.signal
+        });
+        if (cancelled) return;
+        setResponse(data);
+        setError(null);
+        setLoading(false);
+        onUpdateRef.current?.(data);
+      } catch (err) {
+        if (cancelled || err.name === "AbortError") return;
+        setError(err);
+        setLoading(false);
+        (onErrorRef.current ?? console.warn)(err);
+      }
+    }
+    load();
+    const pollId = refreshMs > 0 ? setInterval(load, refreshMs) : void 0;
+    const tickId = setInterval(() => setNow(Date.now()), ONE_MIN / 4);
+    return () => {
+      cancelled = true;
+      abort.abort();
+      if (pollId) clearInterval(pollId);
+      clearInterval(tickId);
+    };
+  }, [apiBase, limit, refreshMs]);
+  if (children) {
+    return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: children({ loading, response, error }) });
+  }
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className, style: { ...rootStyle, ...style }, children: [
+    /* @__PURE__ */ jsxRuntime.jsx(Header, { network: response?.network ?? "testnet" }),
+    /* @__PURE__ */ jsxRuntime.jsx(
+      List,
+      {
+        loading,
+        events: response?.events ?? [],
+        network: response?.network ?? "testnet",
+        apiBase,
+        now
+      }
+    ),
+    error ? /* @__PURE__ */ jsxRuntime.jsx("div", { style: errorStyle, children: "Could not reach the activity feed." }) : null
+  ] });
+}
+function Header({ network }) {
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { style: headerStyle, children: [
+    /* @__PURE__ */ jsxRuntime.jsx("span", { style: dotStyle }),
+    /* @__PURE__ */ jsxRuntime.jsxs("span", { style: labelStyle, children: [
+      "Live \xB7 Ergo ",
+      network
+    ] }),
+    /* @__PURE__ */ jsxRuntime.jsx(
+      "a",
+      {
+        href: "https://www.ergoblockchain.org/agent-economy#sage-activity",
+        target: "_blank",
+        rel: "noopener noreferrer",
+        style: linkStyle,
+        children: "Sage on chain"
+      }
+    )
+  ] });
+}
+function List({
+  loading,
+  events,
+  network,
+  apiBase,
+  now
+}) {
+  if (loading) return /* @__PURE__ */ jsxRuntime.jsx("div", { style: emptyStyle, children: "Loading\u2026" });
+  if (events.length === 0)
+    return /* @__PURE__ */ jsxRuntime.jsx("div", { style: emptyStyle, children: "No activity yet \u2014 be the first to ask Sage a paid query." });
+  return /* @__PURE__ */ jsxRuntime.jsx("div", { children: events.map((evt) => /* @__PURE__ */ jsxRuntime.jsx(Row, { evt, network, apiBase, now }, evt.txId)) });
+}
+function Row({
+  evt,
+  network,
+  apiBase,
+  now
+}) {
+  const isSettle = evt.type === "settlement";
+  const href = isSettle ? receiptUrl(evt.txId, apiBase) : explorerUrl(evt.txId, network);
+  const amount = isSettle ? evt.paymentNanoErg ?? evt.inflowNanoErg : evt.inflowNanoErg;
+  const chipStyle = isSettle ? chipSettleStyle : chipIssueStyle;
+  const chipText = isSettle ? "Settled" : evt.type === "issuance" ? "Issued" : "Transfer";
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    "a",
+    {
+      href,
+      target: "_blank",
+      rel: "noopener noreferrer",
+      style: rowStyle,
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsx("span", { style: chipStyle, children: chipText }),
+        /* @__PURE__ */ jsxRuntime.jsxs("span", { style: metaStyle, children: [
+          /* @__PURE__ */ jsxRuntime.jsx("span", { style: txStyle, children: evt.txId }),
+          /* @__PURE__ */ jsxRuntime.jsxs("span", { style: whenStyle, children: [
+            "block ",
+            evt.blockHeight.toLocaleString(),
+            " \xB7 ",
+            relativeTime(evt.timestamp, now)
+          ] })
+        ] }),
+        /* @__PURE__ */ jsxRuntime.jsxs("span", { style: amountStyle, children: [
+          nanoToErg(amount),
+          " ",
+          /* @__PURE__ */ jsxRuntime.jsx("span", { style: amountUnitStyle, children: "ERG" })
+        ] })
+      ]
+    }
+  );
+}
+var rootStyle = {
+  background: "#000",
+  color: "#e5e7eb",
+  fontFamily: "'JetBrains Mono',ui-monospace,SFMono-Regular,Menlo,monospace",
+  padding: "14px 16px",
+  borderRadius: 14,
+  border: "1px solid rgba(255,255,255,.08)",
+  boxSizing: "border-box",
+  width: "100%",
+  fontSize: 14,
+  lineHeight: 1.4
+};
+var headerStyle = {
+  display: "flex",
+  alignItems: "center",
+  gap: 10,
+  marginBottom: 10
+};
+var dotStyle = {
+  width: 8,
+  height: 8,
+  borderRadius: "50%",
+  background: "#fb923c",
+  flexShrink: 0
+};
+var labelStyle = {
+  fontSize: 10,
+  letterSpacing: "0.25em",
+  textTransform: "uppercase",
+  color: "#fb923c"
+};
+var linkStyle = {
+  marginLeft: "auto",
+  fontSize: 13,
+  color: "#fed7aa",
+  textDecoration: "none"
+};
+var rowStyle = {
+  display: "flex",
+  alignItems: "center",
+  gap: 10,
+  padding: "8px 0",
+  borderTop: "1px solid rgba(255,255,255,.06)",
+  textDecoration: "none",
+  color: "inherit"
+};
+var chipBase = {
+  fontSize: 9,
+  letterSpacing: "0.2em",
+  textTransform: "uppercase",
+  padding: "2px 6px",
+  borderRadius: 4,
+  flexShrink: 0,
+  border: "1px solid"
+};
+var chipSettleStyle = {
+  ...chipBase,
+  borderColor: "rgba(251,146,60,.4)",
+  color: "#fdba74",
+  background: "rgba(251,146,60,.1)"
+};
+var chipIssueStyle = {
+  ...chipBase,
+  borderColor: "rgba(245,158,11,.3)",
+  color: "rgba(252,211,77,.8)",
+  background: "rgba(245,158,11,.05)"
+};
+var metaStyle = {
+  flex: 1,
+  minWidth: 0,
+  display: "flex",
+  flexDirection: "column"
+};
+var txStyle = {
+  color: "#d1d5db",
+  fontSize: 11,
+  overflow: "hidden",
+  textOverflow: "ellipsis",
+  whiteSpace: "nowrap"
+};
+var whenStyle = {
+  color: "#6b7280",
+  fontSize: 10,
+  marginTop: 1
+};
+var amountStyle = {
+  color: "#fed7aa",
+  fontSize: 12,
+  flexShrink: 0,
+  textAlign: "right"
+};
+var amountUnitStyle = {
+  color: "#6b7280",
+  fontSize: 9,
+  textTransform: "uppercase",
+  marginLeft: 2
+};
+var emptyStyle = {
+  padding: "18px 0",
+  textAlign: "center",
+  color: "#6b7280",
+  fontSize: 11
+};
+var errorStyle = {
+  ...emptyStyle,
+  color: "#f87171"
+};
+
+exports.DEFAULT_API_BASE = DEFAULT_API_BASE;
+exports.DEFAULT_LIMIT = DEFAULT_LIMIT;
+exports.DEFAULT_REFRESH_MS = DEFAULT_REFRESH_MS;
+exports.SageActivityFeed = SageActivityFeed;
+//# sourceMappingURL=react.cjs.map
+//# sourceMappingURL=react.cjs.map