@ixo/openhands-sdk 0.3.0 → 0.4.0

package/dist/esm/chain/payoutSettings.d.ts

@@ -0,0 +1,97 @@
+import { type PayoutRail } from "./payoutTerms.ts";
+/** "chain" is today's on-chain escrow; the others are paid off chain by the facilitator. */
+export type SettingsRail = "chain" | PayoutRail;
+export declare const SETTINGS_RAILS: readonly SettingsRail[];
+export interface PayoutSettings {
+    v: 1;
+    /** The company's facilitator, as a canonical did:web. Absent when the company pays on chain only. */
+    facilitator?: string;
+    /** The rails the company pays on, in its own order. */
+    rails: SettingsRail[];
+    /** The oracles the company allows; the first is the default. */
+    oracles: string[];
+    /** What off-chain amounts are quoted in. Absent: USD. */
+    currency?: "USD" | "USDC";
+}
+export interface SettingsInput {
+    /** Needed only for the off-chain rails (usdc_base, stripe); blank or absent for a chain-only company. */
+    facilitator?: string;
+    rails: string[];
+    oracles: string[];
+    currency?: string;
+}
+export declare function buildPayoutSettings(input: SettingsInput): PayoutSettings;
+/** The document as stored, believed field by field; anything else is null. */
+export declare function readPayoutSettings(doc: unknown): PayoutSettings | null;
+/** The exact bytes that are published and hashed. */
+export declare const payoutSettingsJson: (settings: PayoutSettings) => string;
+export declare const payoutSettingsCid: (settings: PayoutSettings) => Promise<string>;
+/** The linked resource on the org's IID; the endpoint is the https address its store gave, as `#payoutTerms`. */
+export declare const payoutSettingsResource: (ref: {
+    cid: string;
+    url?: string;
+    uri?: string;
+}) => {
+    type: string;
+    id: string;
+    description: string;
+    mediaType: string;
+    serviceEndpoint: string;
+    proof: string;
+    encrypted: string;
+    right: string;
+};
+/** Where an org's settings are, found by id suffix. */
+export declare function payoutSettingsRef(linked: {
+    id?: string | null;
+    proof?: string | null;
+}[] | null | undefined): {
+    id: string;
+    cid: string;
+} | null;
+/** The fetched bytes, believed only when they hash to the anchored CID. */
+export declare function verifiedPayoutSettings(text: string | null, cid: string): Promise<PayoutSettings | null>;
+/**
+ * Whether `address` may edit this IID: a key in its `authentication` with that
+ * account (a `controller` entry is not enough — the chain answers code 1106).
+ * The org-admin check of OpenHands HQ, shared with the worker's shaped post.
+ * shortcut: matches on blockchainAccountID only, as every key minted by createIidVerificationMethods has one; upgrade if an org authenticates by bare public key.
+ */
+export declare function canEditIid(doc: {
+    verificationMethod?: {
+        id?: string;
+        blockchainAccountID?: string;
+    }[] | null;
+    authentication?: string[] | null;
+} | null | undefined, address: string): boolean;
+/** The settings edit, as one transaction's IID messages: the old resource out (when there is one) and the new one in. */
+export declare function replaceSettingsMsgs(org: string, signer: string, stored: {
+    cid: string;
+    url: string;
+}, oldId: string | null): ({
+    typeUrl: "/ixo.iid.v1beta1.MsgDeleteLinkedResource";
+    value: {
+        id: string;
+        resourceId: string;
+        signer: string;
+        linkedResource?: undefined;
+    };
+} | {
+    typeUrl: "/ixo.iid.v1beta1.MsgAddLinkedResource";
+    value: {
+        id: string;
+        signer: string;
+        linkedResource: {
+            type: string;
+            id: string;
+            description: string;
+            mediaType: string;
+            serviceEndpoint: string;
+            proof: string;
+            encrypted: string;
+            right: string;
+        };
+        resourceId?: undefined;
+    };
+})[];
+//# sourceMappingURL=payoutSettings.d.ts.map

package/dist/esm/chain/payoutSettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payoutSettings.d.ts","sourceRoot":"","sources":["../../../src/chain/payoutSettings.ts"],"names":[],"mappings":"AAYA,OAAO,EAA+B,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEhF,4FAA4F;AAC5F,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,UAAU,CAAC;AAChD,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAAqC,CAAC;AAMxF,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,CAAC,CAAC;IACL,qGAAqG;IACrG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,gEAAgE;IAChE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,yGAAyG;IACzG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,CAexE;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAatE;AAED,qDAAqD;AACrD,eAAO,MAAM,kBAAkB,GAAI,UAAU,cAAc,KAAG,MAAkC,CAAC;AAEjG,eAAO,MAAM,iBAAiB,GAAI,UAAU,cAAc,KAAG,OAAO,CAAC,MAAM,CAA4C,CAAC;AAExH,iHAAiH;AACjH,eAAO,MAAM,sBAAsB,GAAI,KAAK;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;CASrF,CAAC;AAEH,uDAAuD;AACvD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAGhJ;AAED,2EAA2E;AAC3E,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAO7G;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE;IAAE,kBAAkB,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,IAAI,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAI9L;AAED,yHAAyH;AACzH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;KAK1H"}

package/dist/esm/chain/payoutSettings.js

@@ -0,0 +1,111 @@
+/**
+ * A company's payout settings (OpenHands HQ), on the org's own chain record.
+ *
+ * One linked resource on the org's IID, `{orgDid}#payoutSettings`, points at
+ * this small JSON document by the https address its store gave (Vault or
+ * gateway) with the CID as its proof — stored
+ * and anchored exactly as `#payoutTerms` is (payoutTerms.ts). An ask posted for
+ * the org builds its `#payoutTerms` from these plus the poster's per-ask
+ * choices. Strict: unknown fields, a bad value or a CID that is not the bytes'
+ * own read as no settings at all.
+ */
+import { cidOfText } from "../udid/cid.js";
+import { facilitatorDid, storedHttps } from "./payoutTerms.js";
+export const SETTINGS_RAILS = ["chain", "usdc_base", "stripe"];
+const KEYS = ["v", "facilitator", "rails", "oracles", "currency"];
+const MAX_ORACLES = 10;
+// An oracle the company allows: its did:web (IXO's and hosted oracles) or its on-chain entity.
+const ORACLE = /^(did:web:[a-z0-9.-]+(%3A\d+)?(:[A-Za-z0-9._~-]+)*|did:ixo:entity:[0-9a-f]{32})$/;
+export function buildPayoutSettings(input) {
+    const rails = [...new Set(input.rails)];
+    if (rails.length === 0 || !rails.every((rail) => SETTINGS_RAILS.includes(rail)))
+        throw new Error(`rails are some of ${SETTINGS_RAILS.join(", ")}, at least one`);
+    const oracles = [...new Set(input.oracles.map((one) => one.trim()).filter(Boolean))];
+    if (oracles.length === 0)
+        throw new Error("name at least one oracle");
+    if (oracles.length > MAX_ORACLES)
+        throw new Error(`at most ${MAX_ORACLES} oracles`);
+    const bad = oracles.find((one) => !ORACLE.test(one));
+    if (bad)
+        throw new Error(`an oracle is a did:web or a did:ixo:entity, not ${bad}`);
+    if (input.currency !== undefined && input.currency !== "USD" && input.currency !== "USDC")
+        throw new Error(`currency is USD or USDC, not ${input.currency}`);
+    if (input.currency === "USDC" && rails.includes("stripe"))
+        throw new Error("Stripe pays in USD");
+    const facilitator = input.facilitator?.trim();
+    const offChain = rails.filter((rail) => rail !== "chain");
+    if (!facilitator && offChain.length)
+        throw new Error(`${offChain.join(" and ")} ${offChain.length === 1 ? "is" : "are"} paid by the company's facilitator: name one`);
+    /* Key order is the stored bytes' (and so the CID's): a doc with a facilitator reads exactly as it was written. */
+    return { v: 1, ...(facilitator ? { facilitator: facilitatorDid(facilitator) } : {}), rails, oracles, ...(input.currency ? { currency: input.currency } : {}) };
+}
+/** The document as stored, believed field by field; anything else is null. */
+export function readPayoutSettings(doc) {
+    if (!doc || typeof doc !== "object" || Array.isArray(doc))
+        return null;
+    if (Object.keys(doc).some((key) => !KEYS.includes(key)))
+        return null;
+    const d = doc;
+    if (d.v !== 1 || !Array.isArray(d.rails) || !Array.isArray(d.oracles) || (d.facilitator !== undefined && typeof d.facilitator !== "string"))
+        return null;
+    if (!d.rails.every((rail) => typeof rail === "string") || !d.oracles.every((one) => typeof one === "string"))
+        return null;
+    try {
+        const built = buildPayoutSettings({ ...(d.facilitator !== undefined ? { facilitator: d.facilitator } : {}), rails: d.rails, oracles: d.oracles, ...(d.currency !== undefined ? { currency: d.currency } : {}) });
+        // Canonical only: what was stored must be what the builder writes, or a reader and the facilitator could disagree.
+        return payoutSettingsJson(built) === JSON.stringify(doc) ? built : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** The exact bytes that are published and hashed. */
+export const payoutSettingsJson = (settings) => JSON.stringify(settings);
+export const payoutSettingsCid = (settings) => cidOfText(payoutSettingsJson(settings));
+/** The linked resource on the org's IID; the endpoint is the https address its store gave, as `#payoutTerms`. */
+export const payoutSettingsResource = (ref) => ({
+    type: "PayoutSettings",
+    id: "{id}#payoutSettings",
+    description: "How this organisation pays for answers",
+    mediaType: "application/json",
+    serviceEndpoint: storedHttps(ref, "#payoutSettings"),
+    proof: ref.cid,
+    encrypted: "false",
+    right: ""
+});
+/** Where an org's settings are, found by id suffix. */
+export function payoutSettingsRef(linked) {
+    const found = (linked ?? []).find((one) => typeof one?.id === "string" && one.id.endsWith("#payoutSettings"));
+    return found?.id && found.proof ? { id: found.id, cid: found.proof } : null;
+}
+/** The fetched bytes, believed only when they hash to the anchored CID. */
+export async function verifiedPayoutSettings(text, cid) {
+    if (text === null || (await cidOfText(text)) !== cid)
+        return null;
+    try {
+        return readPayoutSettings(JSON.parse(text));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Whether `address` may edit this IID: a key in its `authentication` with that
+ * account (a `controller` entry is not enough — the chain answers code 1106).
+ * The org-admin check of OpenHands HQ, shared with the worker's shaped post.
+ * shortcut: matches on blockchainAccountID only, as every key minted by createIidVerificationMethods has one; upgrade if an org authenticates by bare public key.
+ */
+export function canEditIid(doc, address) {
+    if (!doc || !address)
+        return false;
+    const authn = new Set(doc.authentication ?? []);
+    return (doc.verificationMethod ?? []).some((method) => authn.has(method.id ?? "") && (method.blockchainAccountID ?? "").split(":").pop() === address);
+}
+/** The settings edit, as one transaction's IID messages: the old resource out (when there is one) and the new one in. */
+export function replaceSettingsMsgs(org, signer, stored, oldId) {
+    return [
+        ...(oldId ? [{ typeUrl: "/ixo.iid.v1beta1.MsgDeleteLinkedResource", value: { id: org, resourceId: oldId, signer } }] : []),
+        { typeUrl: "/ixo.iid.v1beta1.MsgAddLinkedResource", value: { id: org, signer, linkedResource: payoutSettingsResource(stored) } }
+    ];
+}
+//# sourceMappingURL=payoutSettings.js.map

package/dist/esm/chain/payoutSettings.js.map

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

package/dist/esm/chain/payoutTerms.d.ts

@@ -0,0 +1,72 @@
+export type PayoutRail = "usdc_base" | "stripe";
+export interface PayoutTerms {
+    v: 1;
+    /** The organisation that pays: its did:ixo:entity, the collection's `entity`. */
+    org: string;
+    /** The org's facilitator, as a canonical did:web. */
+    facilitator: string;
+    rails: PayoutRail[];
+    /** Per approved answer, a decimal string: two decimals for USD, up to six for USDC. */
+    amount: string;
+    /** USD when the rails include stripe; USDC only with usdc_base alone (which also pays USD 1:1). */
+    currency: "USD" | "USDC";
+    payee: "submitter";
+    /** A hint, not authority: the org's trusted-oracle list decides. */
+    oracle?: string;
+}
+export interface PayoutInput {
+    org: string;
+    facilitator: string;
+    rail: PayoutRail;
+    amount: number;
+    currency: string;
+    oracle?: string;
+}
+/** `https://host/any/path` or `did:web:host[:path]` → `did:web:host`, a port as `%3A`. */
+export declare function facilitatorDid(facilitator: string): string;
+/** The facilitator's https origin, from either form. */
+export declare const facilitatorOrigin: (facilitator: string) => string;
+export declare function buildPayoutTerms(input: PayoutInput): PayoutTerms;
+/** The document as stored, believed field by field; anything else is null. */
+export declare function readPayoutTerms(doc: unknown): PayoutTerms | null;
+/** The exact bytes that are published and hashed. */
+export declare const payoutTermsJson: (terms: PayoutTerms) => string;
+/** CIDv1 raw sha256 of those bytes: the facilitator recomputes it and refuses a mismatch. */
+export declare const payoutTermsCid: (terms: PayoutTerms) => Promise<string>;
+/** The https address the store gave (`url` from the browser's store, `uri` from the worker's); an extra resource is never `ipfs:`. */
+export declare function storedHttps(ref: {
+    url?: string;
+    uri?: string;
+}, what: string): string;
+/** The linked resource on the ask entity. Wrap in `ixo.iid.v1beta1.LinkedResource.fromPartial` at the call site. The proof is the CID the facilitator recomputes. */
+export declare const payoutTermsResource: (ref: {
+    cid: string;
+    url?: string;
+    uri?: string;
+}) => {
+    type: string;
+    id: string;
+    description: string;
+    mediaType: string;
+    serviceEndpoint: string;
+    proof: string;
+    encrypted: string;
+    right: string;
+};
+/** Where an entity's payout terms are, found by id suffix as the engine finds `#vct`. */
+export declare function payoutTermsRef(linked: {
+    id?: string | null;
+    serviceEndpoint?: string | null;
+    proof?: string | null;
+}[]): {
+    cid: string;
+    url: string;
+} | null;
+/** What the ask's own `#done` terms carry for the board: no org, no facilitator, those are this document's. */
+export declare const payoutSummary: (terms: PayoutTerms) => {
+    rail: PayoutRail;
+    amount: string;
+    currency: "USD" | "USDC";
+};
+export declare const railWords: (rail: PayoutRail) => string;
+//# sourceMappingURL=payoutTerms.d.ts.map

package/dist/esm/chain/payoutTerms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payoutTerms.d.ts","sourceRoot":"","sources":["../../../src/chain/payoutTerms.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;AAIhD,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,CAAC,CAAC;IACL,iFAAiF;IACjF,GAAG,EAAE,MAAM,CAAC;IACZ,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,uFAAuF;IACvF,MAAM,EAAE,MAAM,CAAC;IACf,mGAAmG;IACnG,QAAQ,EAAE,KAAK,GAAG,MAAM,CAAC;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAQD,0FAA0F;AAC1F,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAU1D;AAED,wDAAwD;AACxD,eAAO,MAAM,iBAAiB,GAAI,aAAa,MAAM,KAAG,MAAgG,CAAC;AAEzJ,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAuBhE;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAkBhE;AAED,qDAAqD;AACrD,eAAO,MAAM,eAAe,GAAI,OAAO,WAAW,KAAG,MAA+B,CAAC;AAErF,6FAA6F;AAC7F,eAAO,MAAM,cAAc,GAAI,OAAO,WAAW,KAAG,OAAO,CAAC,MAAM,CAAsC,CAAC;AAEzG,sIAAsI;AACtI,wBAAgB,WAAW,CAAC,GAAG,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIrF;AAED,qKAAqK;AACrK,eAAO,MAAM,mBAAmB,GAAI,KAAK;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;CASlF,CAAC;AAEH,yFAAyF;AACzF,wBAAgB,cAAc,CAAC,MAAM,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAAE,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAG5J;AAED,+GAA+G;AAC/G,eAAO,MAAM,aAAa,GAAI,OAAO,WAAW;;;;CAAgF,CAAC;AAEjI,eAAO,MAAM,SAAS,GAAI,MAAM,UAAU,KAAG,MAAyE,CAAC"}

package/dist/esm/chain/payoutTerms.js

@@ -0,0 +1,127 @@
+/**
+ * How an ask paid off chain pays (OpenHands HQ, ways B and C).
+ *
+ * The approval leg of such an ask is empty, so the chain pays nobody; the
+ * organisation's facilitator reads this document at `{askDid}#payoutTerms`
+ * and pays the submitter on USDC on Base or Stripe once an approved oracle
+ * approves. **The shape is S4's #payoutTerms v1 contract (confirmed
+ * 2026-10-13); strict, unknown fields are refused.** This file is the only
+ * writer and reader, so a change to it is a change here.
+ */
+import { cidOfText } from "../udid/cid.js";
+const RAILS = ["usdc_base", "stripe"];
+const KEYS = ["v", "org", "facilitator", "rails", "amount", "currency", "payee", "oracle"];
+const ORG = /^did:ixo:entity:[0-9a-f]{32}$/;
+const HOST = /^[a-z0-9.-]+(%3a\d+)?$/i;
+// The facilitator verifies the oracle by did:web or did:key; an on-chain entity DID is not one.
+const WEB_OR_KEY = (did) => did.startsWith("did:web:") || did.startsWith("did:key:");
+const MAX_DECIMALS = { USD: 2, USDC: 6 };
+/** `https://host/any/path` or `did:web:host[:path]` → `did:web:host`, a port as `%3A`. */
+export function facilitatorDid(facilitator) {
+    const value = facilitator.trim();
+    if (value.toLowerCase().startsWith("did:web:")) {
+        const host = value.slice("did:web:".length).split(":")[0] ?? "";
+        if (!host || !HOST.test(host))
+            throw new Error(`not a facilitator did:web: ${facilitator}`);
+        return `did:web:${host.toLowerCase().replace(/%3a/, "%3A")}`;
+    }
+    const url = URL.canParse(value) ? new URL(value) : null;
+    if (url?.protocol !== "https:" || !url.hostname)
+        throw new Error(`a facilitator is a did:web or an https URL, not ${facilitator}`);
+    return `did:web:${url.host.toLowerCase().replace(/:/g, "%3A")}`;
+}
+/** The facilitator's https origin, from either form. */
+export const facilitatorOrigin = (facilitator) => `https://${facilitatorDid(facilitator).slice("did:web:".length).replace(/%3A/g, ":")}`;
+export function buildPayoutTerms(input) {
+    if (!ORG.test(input.org))
+        throw new Error(`org must be the organisation's did:ixo:entity, not ${input.org}`);
+    if (!RAILS.includes(input.rail))
+        throw new Error(`rail must be usdc_base or stripe, not ${input.rail}`);
+    // USDC on Base pays USD 1:1, so usdc_base takes either; Stripe only USD.
+    if (input.currency !== "USD" && !(input.rail === "usdc_base" && input.currency === "USDC"))
+        throw new Error(`${input.rail === "stripe" ? "Stripe pays in USD" : "USDC on Base pays in USDC or USD"}, not ${input.currency}`);
+    const currency = input.currency;
+    if (!Number.isFinite(input.amount) || input.amount <= 0)
+        throw new Error("the payout amount must be more than 0");
+    if (input.amount > 1_000_000)
+        throw new Error("the payout amount is at most 1,000,000");
+    const places = MAX_DECIMALS[currency];
+    const scaled = input.amount * 10 ** places;
+    if (Math.abs(Math.round(scaled) - scaled) > 1e-6)
+        throw new Error(`a ${currency} payout amount has at most ${places} decimals (${places === 2 ? "cents" : "micro-dollars"})`);
+    // Two decimals when that is exact, else the shortest exact form (USDC only gets here).
+    const amount = Math.abs(Math.round(input.amount * 100) - input.amount * 100) <= 1e-6 ? input.amount.toFixed(2) : input.amount.toFixed(places).replace(/0+$/, "");
+    return {
+        v: 1,
+        org: input.org,
+        facilitator: facilitatorDid(input.facilitator),
+        rails: [input.rail],
+        amount,
+        currency,
+        payee: "submitter",
+        ...(input.oracle !== undefined && WEB_OR_KEY(input.oracle) && { oracle: input.oracle })
+    };
+}
+/** The document as stored, believed field by field; anything else is null. */
+export function readPayoutTerms(doc) {
+    if (!doc || typeof doc !== "object" || Array.isArray(doc))
+        return null;
+    if (Object.keys(doc).some((key) => !KEYS.includes(key)))
+        return null;
+    const d = doc;
+    if (d.v !== 1 || d.payee !== "submitter")
+        return null;
+    if (typeof d.org !== "string" || !ORG.test(d.org))
+        return null;
+    if (d.oracle !== undefined && (typeof d.oracle !== "string" || !WEB_OR_KEY(d.oracle)))
+        return null;
+    if (!Array.isArray(d.rails) || d.rails.length === 0 || !d.rails.every((rail) => RAILS.includes(rail)) || new Set(d.rails).size !== d.rails.length)
+        return null;
+    if (d.currency !== "USD" && d.currency !== "USDC")
+        return null;
+    if (d.rails.includes("stripe") && d.currency !== "USD")
+        return null; // no stripe means usdc_base alone (rails are unique): USD or USDC
+    if (typeof d.amount !== "string" || !/^\d+(\.\d+)?$/.test(d.amount) || Number(d.amount) <= 0)
+        return null;
+    if ((d.amount.split(".")[1]?.length ?? 0) > MAX_DECIMALS[d.currency])
+        return null;
+    try {
+        if (typeof d.facilitator !== "string" || facilitatorDid(d.facilitator) !== d.facilitator)
+            return null;
+    }
+    catch {
+        return null;
+    }
+    return { v: 1, org: d.org, facilitator: d.facilitator, rails: [...d.rails], amount: d.amount, currency: d.currency, payee: "submitter", ...(d.oracle !== undefined && { oracle: d.oracle }) };
+}
+/** The exact bytes that are published and hashed. */
+export const payoutTermsJson = (terms) => JSON.stringify(terms);
+/** CIDv1 raw sha256 of those bytes: the facilitator recomputes it and refuses a mismatch. */
+export const payoutTermsCid = (terms) => cidOfText(payoutTermsJson(terms));
+/** The https address the store gave (`url` from the browser's store, `uri` from the worker's); an extra resource is never `ipfs:`. */
+export function storedHttps(ref, what) {
+    const url = (ref.url ?? ref.uri ?? "").trim();
+    if (!/^https:\/\/\S+$/.test(url))
+        throw new Error(`${what} needs the https address its store gave, got ${JSON.stringify(url)}`);
+    return url;
+}
+/** The linked resource on the ask entity. Wrap in `ixo.iid.v1beta1.LinkedResource.fromPartial` at the call site. The proof is the CID the facilitator recomputes. */
+export const payoutTermsResource = (ref) => ({
+    type: "PayoutTerms",
+    id: "{id}#payoutTerms",
+    description: "How an approved answer is paid, off chain",
+    mediaType: "application/json",
+    serviceEndpoint: storedHttps(ref, "#payoutTerms"),
+    proof: ref.cid,
+    encrypted: "false",
+    right: ""
+});
+/** Where an entity's payout terms are, found by id suffix as the engine finds `#vct`. */
+export function payoutTermsRef(linked) {
+    const found = linked.find((one) => typeof one?.id === "string" && one.id.endsWith("#payoutTerms"));
+    return found?.proof && found.serviceEndpoint ? { cid: found.proof, url: found.serviceEndpoint } : null;
+}
+/** What the ask's own `#done` terms carry for the board: no org, no facilitator, those are this document's. */
+export const payoutSummary = (terms) => ({ rail: terms.rails[0], amount: terms.amount, currency: terms.currency });
+export const railWords = (rail) => (rail === "stripe" ? "Paid by Stripe" : "Paid in USDC on Base");
+//# sourceMappingURL=payoutTerms.js.map

package/dist/esm/chain/payoutTerms.js.map

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

package/dist/esm/chain/query.d.ts

@@ -71,5 +71,19 @@ export declare function txEvents(transactionHash: string): Promise<{
  * `utils.common.getValueFromEvents` does for an inline result.
  */
 export declare function valueFromTx(transactionHash: string, type: string, key: string): Promise<string>;
+/**
+ * EVERY value of that attribute, in the order the messages emitted them — a
+ * transaction that mints two entities (W4: the ask's claim protocol and its
+ * deed) emits `wasm.token_id` twice, and `valueFromTx` only ever answers the first.
+ */
+export declare function valuesFromEvents(events: readonly {
+    type: string;
+    attributes: readonly {
+        key: string;
+        value: string;
+    }[];
+}[], type: string, key: string): string[];
+/** `valuesFromEvents` over a transaction fetched by hash — the phone-broadcast path. */
+export declare function valuesFromTx(transactionHash: string, type: string, key: string): Promise<string[]>;
 export {};
 //# sourceMappingURL=query.d.ts.map

package/dist/esm/chain/query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/chain/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAInE,KAAK,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC;AAIjE,wBAAgB,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CAGrD;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIrE;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,SAAS,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GAAG,SAAS,EAAE,GAAG,SAAa,GAAG,OAAO,CAiBjH;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,SAAS,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GAAG,SAAS,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAStH;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,CAAA;CAAE,EAAE,EACvF,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,GAAG,SAAa,GACf,MAAM,GAAG,SAAS,CAOpB;AAED,uGAAuG;AACvG,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAS7G;AAED,wFAAwF;AACxF,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS9D;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,EAAE,CAAC,CAYjI;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAerG"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/chain/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAInE,KAAK,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC;AAIjE,wBAAgB,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CAGrD;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIrE;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,SAAS,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GAAG,SAAS,EAAE,GAAG,SAAa,GAAG,OAAO,CAiBjH;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,SAAS,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GAAG,SAAS,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAStH;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,CAAA;CAAE,EAAE,EACvF,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,GAAG,SAAa,GACf,MAAM,GAAG,SAAS,CAOpB;AAED,uGAAuG;AACvG,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAS7G;AAED,wFAAwF;AACxF,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS9D;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,EAAE,CAAC,CAYjI;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAerG;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,SAAS;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAahK;AAED,wFAAwF;AACxF,wBAAsB,YAAY,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAExG"}

package/dist/esm/chain/query.js

@@ -157,4 +157,29 @@ export async function valueFromTx(transactionHash, type, key) {
     }
     return "";
 }
+/**
+ * EVERY value of that attribute, in the order the messages emitted them — a
+ * transaction that mints two entities (W4: the ask's claim protocol and its
+ * deed) emits `wasm.token_id` twice, and `valueFromTx` only ever answers the first.
+ */
+export function valuesFromEvents(events, type, key) {
+    const out = [];
+    for (const event of events) {
+        if (event.type !== type)
+            continue;
+        for (const attribute of event.attributes) {
+            const name = /^[A-Za-z0-9+/=]+$/.test(attribute.key) && attribute.key !== key ? Buffer.from(attribute.key, "base64").toString("utf8") : attribute.key;
+            if (name !== key)
+                continue;
+            const raw = attribute.value ?? "";
+            const decoded = /^[A-Za-z0-9+/=]+$/.test(raw) ? Buffer.from(raw, "base64").toString("utf8") : raw;
+            out.push((decoded || raw).replace(/^"|"$/g, ""));
+        }
+    }
+    return out;
+}
+/** `valuesFromEvents` over a transaction fetched by hash — the phone-broadcast path. */
+export async function valuesFromTx(transactionHash, type, key) {
+    return valuesFromEvents(await txEvents(transactionHash), type, key);
+}
 //# sourceMappingURL=query.js.map

package/dist/esm/chain/query.js.map

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

package/dist/esm/chain/reviewBilling.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Per-review checker billing (owner rulings 2026-10-14). Per ORACLE: one that
+ * publishes `reviewBilling.mode: "x402"` on `/v1/info` bills each check to the
+ * payer's Decision Console credits, so an ask it judges posts with an EMPTY
+ * evaluation leg (no fee grant, send or escrow). The payer is the org's OWNER
+ * (the chain owner of the org entity), who turns it on in the Console; for a
+ * person's own ask, the poster. `NEXT_PUBLIC_REVIEW_BILLING` is only a kill
+ * switch: unless it is "credits", every ask escrows its fee as before.
+ *
+ * Also here: the words, the owner's register with the oracle (its 402/503 is
+ * the only place "billing is not on" shows up), and the collection's pause
+ * reason read back from `GET /v1/collections` (S3 contracts, section c).
+ * Every oracle call is best effort: it never throws and never blocks a post.
+ */
+/** The kill switch: off (anything but "credits") escrows every fee as before. */
+export declare const reviewsBilledPerCheck: () => boolean;
+/** Whether an ask this oracle judges is billed per check: the oracle publishes x402 and the switch is on. */
+export declare const billedPerCheck: (oracle: {
+    reviewBilling?: "x402" | "escrow";
+} | null | undefined) => boolean;
+/**
+ * Whether the deployment's own checker bills each check to credits (its `/v1/info` says x402, it signs as `checker`,
+ * prices in PAY, and the kill switch is on). Then an ask it judges escrows ONE coin, the reward's; otherwise its fee
+ * (PAY) is escrowed beside an IXO or USDC reward. False on any read failure: the cautious answer, two coins.
+ */
+export declare function deploymentBillsPerCheck(checker: string, read?: import("../data/oracleInfo.ts").FetchJson): Promise<boolean>;
+/** The preview line for an ask whose reviews are billed per check. */
+export declare const creditsCopy: (org: string | null, priceFace: string) => string;
+/** The same, for an oracle whose fee is set aside from the poster's (or the org's) account when the ask is posted. */
+export declare const setAsideCopy: (org: string | null, priceFace: string) => string;
+/** An oracle with no URL (a company's own entity): nothing is charged between the company and itself; IXO's engine bills its decision fee to the oracle owner's credits. */
+export declare const ownOracleCopy = "No review fee here \u00B7 IXO's checking fee comes from the oracle owner's Console credits";
+/** The oracle's register answer, as the poster reads it; null for any other status. */
+export declare function registerRefusal(status: number, org: string | null, consoleUrl?: string | null, message?: string, reason?: string): string | null;
+/** A collection's pause, as the poster reads it; null for any reason that is not the payer's. */
+export declare function pausedCopy(reason: string | null | undefined, org: string | null): string | null;
+/** Signs one invocation for the oracle: `can` on `ixo:eval-oracle`, as the collection's owner, to `audience` (its did:web). */
+export type MintFor = (audience: string, can: "collections/register" | "collections/read") => Promise<string>;
+/**
+ * The owner's own invocation, minted from their ed25519 key (as store.ts mints its filesystem token): self-issued by
+ * their did:ixo with NO proof chain (the oracle answers 401 to a delegated one), one capability, five minutes, a nonce.
+ */
+export declare function ownerMint(owner: {
+    address: string;
+    mnemonic: string;
+}): MintFor;
+export interface OracleCallOptions {
+    fetch?: typeof fetch;
+    attempts?: number;
+    delayMs?: number;
+}
+/** The oracle's did:web as it publishes it at `/.well-known/did.json` (the UCAN audience), never derived from its host. Null when unread. */
+export declare function oracleDid(oracleUrl: string, options?: Pick<OracleCallOptions, "fetch">): Promise<string | null>;
+/** The first https link in the oracle's message: its Console page, when it names one. */
+export declare const consoleLinkIn: (message: string) => string | null;
+export interface Watched {
+    status: string;
+    pausedReason: string | null;
+}
+/** The owner's collections this oracle watches (`GET /v1/collections`, `collections/read`), by id; null when unread. */
+export declare function watchedCollections(oracleUrl: string, audience: string, mint: MintFor, options?: Pick<OracleCallOptions, "fetch">): Promise<Map<string, Watched> | null>;
+export type RegisterAnswer = {
+    watched: Watched;
+} | {
+    status: number;
+    message: string;
+    reason: string;
+} | null;
+/**
+ * The owner registers the ask with the oracle: `POST /v1/collections/register`, but only when the oracle does not
+ * already watch it. On the OpenHands and Spongy oracles the hire nudge and their cron register it themselves, and a
+ * re-register can RESUME a paused collection, so the watched list is read first, before every try, and a watched
+ * collection is only read, never registered. Unread list: nothing is registered (null).
+ *
+ * Retried by S3's `details.reason` first: collection_not_found, not_hired, company_unavailable, credits_unavailable;
+ * every other known code is final. An oracle without the codes: 404, a 409 naming the evaluate grant, 503 and a
+ * network error are retried; everything else is final, 403 and any other 409 included. Null when nothing definite came back.
+ */
+export declare function registerWithOracle(collectionId: string, oracleUrl: string, mint: MintFor, options?: OracleCallOptions): Promise<RegisterAnswer>;
+/** The poster's register answer, in words: null when there is nothing to act on. */
+export declare function registerNote(collectionId: string, oracleUrl: string, org: string | null, mint: MintFor, options?: OracleCallOptions): Promise<string | null>;
+/** The pause reasons about paying for reviews (contract 1.22.0); every other reason is the oracle's own. */
+export declare const PAYER_PAUSES: ReadonlySet<string>;
+/** The owner's collections the oracle has paused for its payer, `collectionId → pausedReason`. Empty on any failure. */
+export declare function payerPauses(oracleUrl: string, mint: MintFor, options?: Pick<OracleCallOptions, "fetch">): Promise<Map<string, string>>;
+//# sourceMappingURL=reviewBilling.d.ts.map

package/dist/esm/chain/reviewBilling.d.ts.map

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