@ixo/openhands-sdk 0.0.0-stage → 0.1.0

package/dist/esm/data/denoms.js

@@ -0,0 +1,102 @@
+import { restUrl } from "./balance.js";
+import { forgetDenomRoutes, learnDenomRoutes } from "./format.js";
+/**
+ * What a chain denom is called, and how many base units make one.
+ *
+ * The chain speaks in base units under names like `uixo` and, for anything
+ * that crossed a bridge, `ibc/<64 hex chars>` — which is what a receipt was
+ * printing beside "+5,020,000,000" for what was five thousand USD Coin. Two
+ * readings fix that: the hash is a *route* (`transfer/channel-26/uusdc`),
+ * and the chain publishes every route it has seen under its token metadata,
+ * so a hash resolves to a base denom; and the base denom tells its ticker
+ * and its decimals, from the Cosmos convention (`u` is micro, `a` is atto)
+ * with a table for the ones that do not follow it.
+ *
+ * Server-side only, by design: this file carries a seed of every route both
+ * ixo networks knew on 2026-09-16 and a fetch of the chain's token metadata,
+ * and neither belongs in a client bundle. A server page awaits
+ * `primeDenoms()` once (cached a day) before deriving its amounts; the
+ * formatter's small registry (`format.ts`) does the rest, everywhere.
+ */
+/** The IBC routes each network had published as token metadata on 2026-09-16, hash → base denom. */
+const SEED = {
+    /* mainnet (ixo-5) */
+    "ibc/05AC4BBA78C5951339A47DD1BC1E7FC922A9311DF81C85745B1C162F516FF2F1": "uosmo",
+    "ibc/07FA7831E1920D0C87C9388F86B0108677F6ED0C9DE7E4063F05ED675192405C": "ustars",
+    "ibc/0973E5F82D860F674100F65F7FC0EA802CCCDA41908AA02B5062B1ADD185D3D4": "uaxl",
+    "ibc/2658C97FC74B74AB1898982081523C455561BBE3C705E47707021D47F3D94B38": "uusdc",
+    "ibc/3C58AC56E392E53BBA24A1021D9D7615CD229226111F089AE6A95F05E50C776F": "uusdc",
+    "ibc/69AB354E552F5494BC622A92189688EB8CA39E0DEFB4159CB771CAFC3CFB984F": "uixo",
+    "ibc/6BBE9BD4246F8E04948D5A4EEE7164B2630263B9EBB5E7DC5F0A46C62A2FF97B": "uusdc",
+    "ibc/7D7CC2914A5548991E34CF9850264E214FF5BACC950D662EF3F69D9ED27C7333": "uiov",
+    "ibc/8112CB4D6605445BA3EB43CD4845E75E4854E3C91463EAD6B94A4DA226787EC5": "erc20/tether/usdt",
+    "ibc/87B127D828F2E4E021A2922BA90871641682B7A001F25C902899CB500C2DC81E": "uixo",
+    "ibc/8856C0DEC552C800245E07130DD2433BBDFF87C68A85867F47A708E8492CE540": "uatom",
+    "ibc/93C021F79186303FBBE7174E01DFD3AA9516F05806A9C50B98CAFC2473A53AA1": "ugraviton",
+    "ibc/A01367FF44D9DE359A984FC14EC5227AA96ED08B8B4B31B539BB63B9B9305F80": "uusdc",
+    "ibc/A541CA4E66B23EA5A20A5B36A2363C2AC629111E62A443F8FE653BC340B2F40F": "xrowan",
+    "ibc/C4CFF46FD6DE35CA4CF4CE031E643C8FDC9BA4B99AE598E9B0ED98FE3A2319F9": "uatom",
+    "ibc/C90C3DADD95B11B0F74B16146876597A67A40EAC2351338D82F503EF00C1CC62": "uixo",
+    "ibc/C9300DDD93DF3A3A668CAB02398A0AA081EF89EC005B2DB68832E363BAAABF85": "uatom",
+    "ibc/D22AC278ADADE96FB760FD793A39A4FC575B0FB7679DF85C704D67EEBDDB1120": "aevmos",
+    "ibc/DFD628D519AE17E66130E9877E56EF1B06EF6FED08B550298A8C03FE141F224D": "udvpn",
+    "ibc/E0E34950BD70FDA0C785D5AA5FB1474077332263A8F97C8C6B98AE8F7157EB0D": "ugraviton",
+    "ibc/EFCDD4C4BE40A6162F97DBFE7D834294061E7D8CC62AFB44A96BDD4C2978C366": "uxki",
+    /* testnet (pandora-8) */
+    "ibc/0634D0993744740D675AD01E81156EAC945AEAAE17C074918DC7FF52F41B263E": "uaxl",
+    "ibc/376222D6D9DAE23092E29740E56B758580935A6D77C24C2ABD57A6A78A1F3955": "uosmo",
+    "ibc/9463E39D230614B313B487836D13A392BD1731928713D4C8427A083627048DB3": "uaxl",
+    "ibc/C01154C2547F4CB10A985EA78E7CD4BA891C1504360703A37E1D7043F06B5E1F": "uaxl"
+};
+let primedAt = 0;
+let priming = null;
+const PRIME_TTL_MS = 24 * 60 * 60_000;
+/**
+ * Learn every bridge route this network's token metadata names.
+ *
+ * Server-side, once a day, never throws: a page that could not reach the
+ * node still renders, with the seed. Callers await it before deriving the
+ * amounts a page shows, so a coin minted after the seed reads right.
+ */
+export async function primeDenoms(now = Date.now, fetchImpl = fetch) {
+    if (primedAt > 0 && now() - primedAt < PRIME_TTL_MS)
+        return;
+    if (priming)
+        return priming;
+    priming = (async () => {
+        /* The seed first, so a node that will not answer still leaves every
+           route the networks had on the day this was written. */
+        learnDenomRoutes(Object.entries(SEED));
+        try {
+            const response = await fetchImpl(`${restUrl()}/cosmos/bank/v1beta1/denoms_metadata?pagination.limit=500`, { signal: AbortSignal.timeout(10_000) });
+            if (!response.ok)
+                return;
+            const { metadatas = [] } = (await response.json());
+            for (const one of metadatas) {
+                if (!one.base?.startsWith("ibc/") || !one.display)
+                    continue;
+                const leaf = one.display.split("/").filter(Boolean);
+                /* `transfer/channel-26/uusdc` → `uusdc`; `…/erc20/tether/usdt` → the
+                   three segments after the last channel hop. */
+                const at = leaf.lastIndexOf(leaf.filter((part) => part.startsWith("channel-")).pop() ?? "");
+                const base = at >= 0 ? leaf.slice(at + 1).join("/") : leaf[leaf.length - 1];
+                if (base)
+                    learnDenomRoutes([[one.base, base]]);
+            }
+            primedAt = now();
+        }
+        catch {
+            /* The seed carries the page. */
+        }
+        finally {
+            priming = null;
+        }
+    })();
+    return priming;
+}
+/** For tests: forget the seed and everything learned. */
+export function forgetDenoms() {
+    forgetDenomRoutes();
+    primedAt = 0;
+}
+//# sourceMappingURL=denoms.js.map

package/dist/esm/data/denoms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"denoms.js","sourceRoot":"","sources":["../../../src/data/denoms.ts"],"names":[],"mappings":"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"}

package/dist/esm/data/displayNames.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Short account names for a batch of addresses, read from our homeserver.
+ *
+ * The leaderboard's fold uses this, and only for people who switched the
+ * account name on: it asks `@did-ixo-<address>:<server>` for a display name,
+ * shortens it with `shortName`, and returns the short form or a state. The
+ * full display name never leaves this function, and neither does the Matrix
+ * user id (it carries the address) nor anything about an avatar — the
+ * request is for `/displayname` alone, so a picture is never even fetched.
+ *
+ * Env-free and dependency-light on purpose: the config is passed in, `fetch`
+ * can be, and the only import is `shortName`. A worker imports this module
+ * directly; it is re-exported from `matrixProfiles.ts` for anybody who reads
+ * the estate's Matrix profiles from there.
+ *
+ * Three states rather than a name-or-null, because they mean different things
+ * to somebody about to publish:
+ *
+ * - `found` — the homeserver answered with a display name that has an honest
+ *   short form.
+ * - `none` — it answered, and there is nothing to show: no such account
+ *   (404), no display name, or one `shortName` refuses.
+ * - `unknown` — it did not answer usefully: a timeout, a 5xx, 401, 429, a
+ *   network error, or the batch's deadline passed first. A caller should keep
+ *   whatever it last published rather than read this as "no name".
+ */
+export type DisplayNameLookup = {
+    state: "found";
+    name: string;
+} | {
+    state: "none";
+} | {
+    state: "unknown";
+};
+export interface DisplayNameConfig {
+    /** The homeserver's base URL, e.g. `https://testmx.ixo.earth`. */
+    homeserver: string;
+    /** A bearer token, for homeservers that require one for profile reads. */
+    token?: string;
+    /** Our server name — the part after the colon in `@did-ixo-<address>:<server>`. */
+    serverName: string;
+}
+export interface DisplayNameOptions {
+    /** At most this many requests in flight; clamped to 1..5. Default 5. */
+    concurrency?: number;
+    /** Per request. Default 4000 ms. */
+    timeoutMs?: number;
+    /** For the whole batch: nothing starts after it, and in-flight requests are cut at it. Default 20000 ms. */
+    deadlineMs?: number;
+    fetch?: typeof fetch;
+}
+/**
+ * The host of a homeserver URL, which is its server name for the homeservers
+ * this estate runs (testmx.ixo.earth, mx.ixo.earth). Empty when unparseable.
+ */
+export declare const serverNameFromHomeserver: (homeserver: string) => string;
+export declare function readDisplayNames(config: DisplayNameConfig, addresses: readonly string[], options?: DisplayNameOptions): Promise<Map<string, DisplayNameLookup>>;
+//# sourceMappingURL=displayNames.d.ts.map

package/dist/esm/data/displayNames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"displayNames.d.ts","sourceRoot":"","sources":["../../../src/data/displayNames.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,MAAM,MAAM,iBAAiB,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAE5G,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4GAA4G;IAC5G,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAID;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GAAI,YAAY,MAAM,KAAG,MAM7D,CAAC;AAEF,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAiDzK"}

package/dist/esm/data/displayNames.js

@@ -0,0 +1,94 @@
+/**
+ * Short account names for a batch of addresses, read from our homeserver.
+ *
+ * The leaderboard's fold uses this, and only for people who switched the
+ * account name on: it asks `@did-ixo-<address>:<server>` for a display name,
+ * shortens it with `shortName`, and returns the short form or a state. The
+ * full display name never leaves this function, and neither does the Matrix
+ * user id (it carries the address) nor anything about an avatar — the
+ * request is for `/displayname` alone, so a picture is never even fetched.
+ *
+ * Env-free and dependency-light on purpose: the config is passed in, `fetch`
+ * can be, and the only import is `shortName`. A worker imports this module
+ * directly; it is re-exported from `matrixProfiles.ts` for anybody who reads
+ * the estate's Matrix profiles from there.
+ *
+ * Three states rather than a name-or-null, because they mean different things
+ * to somebody about to publish:
+ *
+ * - `found` — the homeserver answered with a display name that has an honest
+ *   short form.
+ * - `none` — it answered, and there is nothing to show: no such account
+ *   (404), no display name, or one `shortName` refuses.
+ * - `unknown` — it did not answer usefully: a timeout, a 5xx, 401, 429, a
+ *   network error, or the batch's deadline passed first. A caller should keep
+ *   whatever it last published rather than read this as "no name".
+ */
+import { shortName } from "./shortName.js";
+const ADDRESS = /^ixo1[0-9a-z]{20,70}$/;
+/**
+ * The host of a homeserver URL, which is its server name for the homeservers
+ * this estate runs (testmx.ixo.earth, mx.ixo.earth). Empty when unparseable.
+ */
+export const serverNameFromHomeserver = (homeserver) => {
+    try {
+        return new URL(homeserver).host;
+    }
+    catch {
+        return "";
+    }
+};
+export async function readDisplayNames(config, addresses, options = {}) {
+    const out = new Map();
+    const unique = [...new Set(addresses.filter(Boolean))];
+    const base = config.homeserver.replace(/\/+$/, "");
+    const server = config.serverName.trim();
+    if (!base || !server) {
+        for (const address of unique)
+            out.set(address, { state: "unknown" });
+        return out;
+    }
+    const doFetch = options.fetch ?? fetch;
+    const width = Math.max(1, Math.min(5, Math.floor(options.concurrency ?? 5)));
+    const timeoutMs = Math.max(1, options.timeoutMs ?? 4000);
+    const deadline = Date.now() + Math.max(0, options.deadlineMs ?? 20_000);
+    const readOne = async (address) => {
+        /* Not an address, so not an account on our server: nothing to show. */
+        if (!ADDRESS.test(address))
+            return { state: "none" };
+        const left = deadline - Date.now();
+        if (left <= 0)
+            return { state: "unknown" };
+        const userId = `@did-ixo-${address}:${server}`;
+        try {
+            const answer = await doFetch(`${base}/_matrix/client/v3/profile/${encodeURIComponent(userId)}/displayname`, {
+                headers: config.token ? { authorization: `Bearer ${config.token}` } : {},
+                signal: AbortSignal.timeout(Math.min(timeoutMs, left))
+            });
+            if (answer.status === 404)
+                return { state: "none" };
+            if (!answer.ok)
+                return { state: "unknown" };
+            const body = (await answer.json());
+            const name = shortName(typeof body?.displayname === "string" ? body.displayname : null);
+            return name ? { state: "found", name } : { state: "none" };
+        }
+        catch {
+            return { state: "unknown" };
+        }
+    };
+    let next = 0;
+    const lane = async () => {
+        for (;;) {
+            const index = next;
+            next += 1;
+            if (index >= unique.length)
+                return;
+            const address = unique[index];
+            out.set(address, await readOne(address));
+        }
+    };
+    await Promise.all(Array.from({ length: Math.min(width, unique.length) }, lane));
+    return out;
+}
+//# sourceMappingURL=displayNames.js.map

package/dist/esm/data/displayNames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"displayNames.js","sourceRoot":"","sources":["../../../src/data/displayNames.ts"],"names":[],"mappings":"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"}

package/dist/esm/data/docPath.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Naming a document from a page — the smallest possible module.
+ *
+ * A link, an image source and a claim-id check are all a browser page ever
+ * needs of the store layer, and this file rides into every page's shared
+ * chunk through the data barrel's members. Everything that names a host or
+ * builds a store URL stays in `docUrls.ts`; everything that fetches, in
+ * `docs.ts`. Both re-export this, so any of the three paths works.
+ */
+/** Our own fingerprints are prefixed; everything else is a content address. */
+export declare const isCid: (claimId: string) => boolean;
+/**
+ * A claim id as this app mints them: a content address when the answer was
+ * sealed, else `qi-` and a bounded run of hex (the submit page's fallback,
+ * `qi-<40 hex>`) or a short tag (`qi-guest-…`, `qi-smoke-…`). A page that
+ * takes a claim id as a path segment refuses anything else before it reads,
+ * so a random segment cannot mint a cache entry for a trace that cannot exist.
+ */
+export declare const isClaimId: (claimId: string) => boolean;
+/**
+ * A same-origin path that resolves an address to wherever it lives — for an
+ * `<img src>` or a link, where the page cannot ask two stores itself. Both
+ * apps serve it (`/api/doc/[cid]`); the youth app prefixes its base path —
+ * `NEXT_PUBLIC_BASE_PATH` (inlined at build time) or `configure({ basePath })`.
+ */
+export declare const docPath: (cid: string) => string;
+export declare function basePath(): string;
+//# sourceMappingURL=docPath.d.ts.map

package/dist/esm/data/docPath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docPath.d.ts","sourceRoot":"","sources":["../../../src/data/docPath.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,+EAA+E;AAC/E,eAAO,MAAM,KAAK,GAAI,SAAS,MAAM,KAAG,OAA6C,CAAC;AAEtF;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,SAAS,MAAM,KAAG,OAA0E,CAAC;AAEvH;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,KAAG,MAA4D,CAAC;AAOnG,wBAAgB,QAAQ,IAAI,MAAM,CAGjC"}

package/dist/esm/data/docPath.js

@@ -0,0 +1,37 @@
+/**
+ * Naming a document from a page — the smallest possible module.
+ *
+ * A link, an image source and a claim-id check are all a browser page ever
+ * needs of the store layer, and this file rides into every page's shared
+ * chunk through the data barrel's members. Everything that names a host or
+ * builds a store URL stays in `docUrls.ts`; everything that fetches, in
+ * `docs.ts`. Both re-export this, so any of the three paths works.
+ */
+import { givenConfig } from "../given.js";
+/** Our own fingerprints are prefixed; everything else is a content address. */
+export const isCid = (claimId) => /^ba[a-z0-9]{20,}$/i.test(claimId);
+/**
+ * A claim id as this app mints them: a content address when the answer was
+ * sealed, else `qi-` and a bounded run of hex (the submit page's fallback,
+ * `qi-<40 hex>`) or a short tag (`qi-guest-…`, `qi-smoke-…`). A page that
+ * takes a claim id as a path segment refuses anything else before it reads,
+ * so a random segment cannot mint a cache entry for a trace that cannot exist.
+ */
+export const isClaimId = (claimId) => isCid(claimId) || /^qi-[a-z0-9][a-z0-9-]{3,63}$/i.test(claimId);
+/**
+ * A same-origin path that resolves an address to wherever it lives — for an
+ * `<img src>` or a link, where the page cannot ask two stores itself. Both
+ * apps serve it (`/api/doc/[cid]`); the youth app prefixes its base path —
+ * `NEXT_PUBLIC_BASE_PATH` (inlined at build time) or `configure({ basePath })`.
+ */
+export const docPath = (cid) => `${basePath()}/api/doc/${encodeURIComponent(cid)}`;
+/*
+ * The one value this module needs, resolved the way `config().basePath` is
+ * (`configure()` first, then the literal env read Next inlines) without
+ * importing the whole resolver — see `given.ts`.
+ */
+export function basePath() {
+    const env = typeof process === "undefined" || !process.env ? undefined : process.env.NEXT_PUBLIC_BASE_PATH;
+    return (givenConfig().basePath ?? env ?? "").replace(/\/+$/, "");
+}
+//# sourceMappingURL=docPath.js.map

package/dist/esm/data/docPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docPath.js","sourceRoot":"","sources":["../../../src/data/docPath.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,+EAA+E;AAC/E,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,OAAe,EAAW,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAEtF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,OAAe,EAAW,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,+BAA+B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAEvH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,GAAG,QAAQ,EAAE,YAAY,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;AAEnG;;;;GAIG;AACH,MAAM,UAAU,QAAQ;IACtB,MAAM,GAAG,GAAG,OAAO,OAAO,KAAK,WAAW,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;IAC3G,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACnE,CAAC"}

package/dist/esm/data/docUrls.d.ts

@@ -0,0 +1,38 @@
+/**
+ * The addresses of the two stores, and nothing that talks to them.
+ *
+ * Split from `docs.ts` so a page that only needs to *name* a document — a
+ * link, an image source, a host to trust — carries a few lines into the
+ * browser rather than the whole reader. `docs.ts` re-exports all of this,
+ * so either path works; this one is the light one — and `docPath.ts`, which
+ * this re-exports, is the lightest, for the pages that only ever link.
+ */
+import { type Network, network } from "../network.ts";
+export * from "./docPath.ts";
+export { network };
+export declare const vfsUrlFor: (net: Network) => string;
+export declare const DEFAULT_IPFS_GATEWAY_URL = "https://ipfs.gateway.ixo.world";
+/** The filesystem worker for this network. Override with `NEXT_PUBLIC_VFS_URL` (local `wrangler dev`) or `configure({ vfsUrl })`. */
+export declare const vfsUrl: () => string;
+/** The ixo IPFS gateway: reads for the whole network, and open uploads. One host for every network. */
+export declare const ipfsGatewayUrl: () => string;
+/** The address of exactly those bytes on the filesystem — anonymous, immutable. */
+export declare const vfsDocUrl: (cid: string) => string;
+/** The same bytes through the gateway. */
+export declare const ipfsDocUrl: (cid: string) => string;
+export type DocStore = "vfs" | "ipfs";
+/**
+ * The URL of a document stored beside another — a photograph beside the
+ * envelope that names it — on the store that just answered for the envelope.
+ * One submission lands in one store (the uploader holds to a store for the
+ * whole of it), so the sibling is there too, without a second lookup.
+ */
+export declare const docUrlBeside: (cid: string, answeredUrl: string) => string;
+/** Every place a document may be, in the order a reader should ask. */
+export declare const docUrls: (cid: string) => {
+    store: DocStore;
+    url: string;
+}[];
+/** The hosts a reader will follow a document address to — the trust list for a stranger's URL. */
+export declare const docHosts: () => string[];
+//# sourceMappingURL=docUrls.d.ts.map

package/dist/esm/data/docUrls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docUrls.d.ts","sourceRoot":"","sources":["../../../src/data/docUrls.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,KAAK,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAGtD,cAAc,cAAc,CAAC;AAG7B,OAAO,EAAE,OAAO,EAAE,CAAC;AASnB,eAAO,MAAM,SAAS,GAAI,KAAK,OAAO,KAAG,MAA6B,CAAC;AAEvE,eAAO,MAAM,wBAAwB,mCAAmC,CAAC;AAEzE,qIAAqI;AACrI,eAAO,MAAM,MAAM,QAAO,MACqH,CAAC;AAEhJ,uGAAuG;AACvG,eAAO,MAAM,cAAc,QAAO,MAC6H,CAAC;AAEhK,mFAAmF;AACnF,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,KAAG,MAAyC,CAAC;AAElF,0CAA0C;AAC1C,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,KAAG,MAA2C,CAAC;AAErF,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;AAEtC;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,EAAE,aAAa,MAAM,KAAG,MAAqF,CAAC;AAEtJ,uEAAuE;AACvE,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,KAAG;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAGrE,CAAC;AAEF,kGAAkG;AAClG,eAAO,MAAM,QAAQ,QAAO,MAAM,EAA8D,CAAC"}

package/dist/esm/data/docUrls.js

@@ -0,0 +1,46 @@
+/**
+ * The addresses of the two stores, and nothing that talks to them.
+ *
+ * Split from `docs.ts` so a page that only needs to *name* a document — a
+ * link, an image source, a host to trust — carries a few lines into the
+ * browser rather than the whole reader. `docs.ts` re-exports all of this,
+ * so either path works; this one is the light one — and `docPath.ts`, which
+ * this re-exports, is the lightest, for the pages that only ever link.
+ */
+import { givenConfig } from "../given.js";
+import { network } from "../network.js";
+import { firstSet, hasEnv } from "../envRead.js";
+export * from "./docPath.js";
+/* An unrecognised network throws (at the first call, never at import) rather than reading testnet (../network.ts). */
+export { network };
+/** The filesystem worker each network uses when nothing overrides it. The only copy of this table. */
+const VFS_BY_NETWORK = {
+    devnet: "https://devnet.vfs.ixo.earth",
+    testnet: "https://testnet.vfs.ixo.earth",
+    mainnet: "https://vfs.ixo.earth"
+};
+export const vfsUrlFor = (net) => VFS_BY_NETWORK[net];
+export const DEFAULT_IPFS_GATEWAY_URL = "https://ipfs.gateway.ixo.world";
+/** The filesystem worker for this network. Override with `NEXT_PUBLIC_VFS_URL` (local `wrangler dev`) or `configure({ vfsUrl })`. */
+export const vfsUrl = () => (givenConfig().vfsUrl ?? (hasEnv() ? firstSet(process.env.NEXT_PUBLIC_VFS_URL) : undefined) ?? VFS_BY_NETWORK[network()]).replace(/\/+$/, "");
+/** The ixo IPFS gateway: reads for the whole network, and open uploads. One host for every network. */
+export const ipfsGatewayUrl = () => (givenConfig().ipfsGatewayUrl ?? (hasEnv() ? firstSet(process.env.NEXT_PUBLIC_IPFS_GATEWAY_URL) : undefined) ?? DEFAULT_IPFS_GATEWAY_URL).replace(/\/+$/, "");
+/** The address of exactly those bytes on the filesystem — anonymous, immutable. */
+export const vfsDocUrl = (cid) => `${vfsUrl()}/public/cid/${cid}`;
+/** The same bytes through the gateway. */
+export const ipfsDocUrl = (cid) => `${ipfsGatewayUrl()}/ipfs/${cid}`;
+/**
+ * The URL of a document stored beside another — a photograph beside the
+ * envelope that names it — on the store that just answered for the envelope.
+ * One submission lands in one store (the uploader holds to a store for the
+ * whole of it), so the sibling is there too, without a second lookup.
+ */
+export const docUrlBeside = (cid, answeredUrl) => (answeredUrl.startsWith(`${vfsUrl()}/`) ? vfsDocUrl(cid) : ipfsDocUrl(cid));
+/** Every place a document may be, in the order a reader should ask. */
+export const docUrls = (cid) => [
+    { store: "vfs", url: vfsDocUrl(cid) },
+    { store: "ipfs", url: ipfsDocUrl(cid) }
+];
+/** The hosts a reader will follow a document address to — the trust list for a stranger's URL. */
+export const docHosts = () => [new URL(vfsUrl()).host, new URL(ipfsGatewayUrl()).host];
+//# sourceMappingURL=docUrls.js.map

package/dist/esm/data/docUrls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docUrls.js","sourceRoot":"","sources":["../../../src/data/docUrls.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAgB,OAAO,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEjD,cAAc,cAAc,CAAC;AAE7B,sHAAsH;AACtH,OAAO,EAAE,OAAO,EAAE,CAAC;AAEnB,sGAAsG;AACtG,MAAM,cAAc,GAAsC;IACxD,MAAM,EAAE,8BAA8B;IACtC,OAAO,EAAE,+BAA+B;IACxC,OAAO,EAAE,uBAAuB;CACjC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAY,EAAU,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;AAEvE,MAAM,CAAC,MAAM,wBAAwB,GAAG,gCAAgC,CAAC;AAEzE,qIAAqI;AACrI,MAAM,CAAC,MAAM,MAAM,GAAG,GAAW,EAAE,CACjC,CAAC,WAAW,EAAE,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAEhJ,uGAAuG;AACvG,MAAM,CAAC,MAAM,cAAc,GAAG,GAAW,EAAE,CACzC,CAAC,WAAW,EAAE,CAAC,cAAc,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,wBAAwB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAEhK,mFAAmF;AACnF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,GAAG,MAAM,EAAE,eAAe,GAAG,EAAE,CAAC;AAElF,0CAA0C;AAC1C,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,GAAG,cAAc,EAAE,SAAS,GAAG,EAAE,CAAC;AAIrF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAW,EAAE,WAAmB,EAAU,EAAE,CAAC,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;AAEtJ,uEAAuE;AACvE,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAAW,EAAsC,EAAE,CAAC;IAC1E,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE;IACrC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE;CACxC,CAAC;AAEF,kGAAkG;AAClG,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAa,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC"}

package/dist/esm/data/docs.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Where a public document lives, and how to fetch one by its address.
+ *
+ * Two stores, one address space. A document is named by its content — a
+ * CIDv1 over the exact bytes — and lives in one of two places:
+ *
+ * - **The IXO Virtual Filesystem**, when a signed-in person put it there.
+ *   Their own namespace, published, served to anyone at `/public/cid/<cid>`
+ *   without a token (the bytes stay encrypted at rest; the CID is computed
+ *   over the plaintext, with the same encoder the network's IPFS pins use).
+ * - **IPFS, through the ixo gateway**, for everything else: uploads by a
+ *   phone that is not signed in, by the worker's own keys, and every
+ *   document written before 2026-09-17 — those lived on a store that is gone
+ *   from this code, and `scripts/migrate-docs.ts` copies them to the gateway
+ *   under the same addresses (both encode bytes the same way).
+ *
+ * A reader does not know which, and does not need to: `fetchDoc` asks both
+ * stores at once and takes the first that has the bytes — a miss on the
+ * filesystem is one index lookup, a miss on the gateway is a walk of the
+ * public network that can take half a minute, so waiting for either in turn
+ * would be the wrong speed for half the documents — and remembers which
+ * store answered so the next read of the same address asks only there.
+ * Nothing here imports anything, so a browser, a route, a cron and a test
+ * all read the same way.
+ */
+import { type DocStore } from "./docUrls.ts";
+export * from "./docUrls.ts";
+export declare function rememberDocStore(cid: string, store: DocStore): void;
+/** For tests: forget every remembered store. */
+export declare const forgetDocStores: () => void;
+export interface DocFetchInit extends RequestInit {
+    next?: {
+        revalidate?: number | false;
+        tags?: string[];
+    };
+    /** Per store, when no `signal` is given. */
+    timeoutMs?: number;
+    /** Injected in tests. */
+    fetchImpl?: typeof fetch;
+}
+/**
+ * Fetch a document by its address, wherever it is.
+ *
+ * Always answers with a `Response`, never throws: `ok` means the bytes are
+ * there, anything else means they are not, from whichever store answered
+ * last — so a caller written against `fetch(url)` reads the same. The
+ * response's `url` is the store's own, which is how a caller finds the
+ * documents stored beside this one (`docUrlBeside`).
+ */
+export declare function fetchDoc(cid: string, init?: DocFetchInit): Promise<Response>;
+/** The document as JSON, or null — for the many readers that want nothing else. */
+export declare function readDocJson<T>(cid: string, init?: DocFetchInit): Promise<T | null>;
+/**
+ * The one URL a document is actually at — for a place that has to write an
+ * address down (a credential, a signed determination, a share card's image)
+ * rather than fetch it now. A HEAD to every store at once, remembered like a
+ * read; null when none has it, which a caller must treat as "not yet" rather
+ * than invent a location for.
+ */
+export declare function resolveDocUrl(cid: string, init?: DocFetchInit): Promise<string | null>;
+//# sourceMappingURL=docs.d.ts.map

package/dist/esm/data/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../src/data/docs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7D,cAAc,cAAc,CAAC;AAW7B,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAGnE;AAED,gDAAgD;AAChD,eAAO,MAAM,eAAe,QAAO,IAA0B,CAAC;AAE9D,MAAM,WAAW,YAAa,SAAQ,WAAW;IAG/C,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACxD,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AA8ED;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC,CActF;AAED,mFAAmF;AACnF,wBAAsB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAO5F;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiBhG"}