@ixo/openhands-sdk 0.1.0 → 0.3.0

package/dist/esm/chain/entityShape.js

@@ -0,0 +1,184 @@
+/**
+ * The shape of every entity Openhands mints, as plain data (W2 of the IXO
+ * alignment plan). Pure functions, no chain client, no `node:` builtin, so the
+ * `chain` barrel stays isomorphic and the same builders serve the browser's
+ * poster, the worker, the MCP and every script. The caller wraps the result
+ * in `MsgCreateEntity.fromPartial` / `LinkedResource.fromPartial`.
+ *
+ * What "the IXO shape" is (verified on chain and in the portal's own
+ * `createEntity.ts`, 2026-10-09):
+ *
+ * - `context` is `[{ixo: https://w3id.org/ixo/context/v1}, {class: <protocol DID>}]`;
+ *   the class is the `protocol/...` the entity is created from.
+ * - `service` carries `#matrix` (type `MatrixHomeServer` — what the portal and
+ *   the evals-engine match on) and, while the claim lane still serves public
+ *   CIDs, `#ipfs`. Never `#cellnode`.
+ * - `linkedResource` carries `#pro` (type `Settings`, description `Profile`)
+ *   and `#dmn` (type `domainCard`) on every entity; `#done`, `#rub`, `#vct`
+ *   where the kind calls for them. `serviceEndpoint` is where the bytes are,
+ *   `proof` their content address.
+ * - `linkedEntity` links a deed to its claim protocol (`verifiableClaim`) and
+ *   a campaign ask to its campaign protocol (`partOf`). No link to any DAO.
+ */
+export const IXO_CONTEXT_URL = "https://w3id.org/ixo/context/v1";
+/** A DID of the entity module's shape, `did:ixo:entity:<32 hex>`. */
+export const isEntityDid = (value) => typeof value === "string" && /^did:ixo:entity:[0-9a-f]{32}$/.test(value);
+/** The JSON-LD context every classed entity carries: the ixo vocabulary and the class it was created from. */
+export function classContext(classDid) {
+    if (!isEntityDid(classDid))
+        throw new Error(`a class must be an entity DID, got ${JSON.stringify(classDid)}`);
+    return [
+        { key: "ixo", val: IXO_CONTEXT_URL },
+        { key: "class", val: classDid }
+    ];
+}
+/** `{id}#matrix`, the type readers match on (`MatrixHomeServer`), the homeserver without a trailing slash. */
+export const matrixService = (homeserver) => ({ id: "{id}#matrix", type: "MatrixHomeServer", serviceEndpoint: homeserver.replace(/\/+$/, "") });
+/** `{id}#ipfs` — kept only while claim bodies and attachments are served as public CIDs. */
+export const ipfsGatewayService = (gatewayUrl) => ({ id: "{id}#ipfs", type: "Ipfs", serviceEndpoint: `${gatewayUrl.replace(/\/+$/, "")}/ipfs/` });
+const resource = (fragment, type, description, mediaType, doc) => {
+    if (!doc.url?.trim() || !doc.proof?.trim())
+        throw new Error(`#${fragment} needs both a url and a proof`);
+    return { id: `{id}#${fragment}`, type, description, mediaType, serviceEndpoint: doc.url.trim(), proof: doc.proof.trim(), encrypted: "false", right: "" };
+};
+/** `#pro` — blocksync surfaces it as `settings.Profile`; Trace, the portal and `data/profiles.ts` read the name from it. */
+export const profileResource = (doc) => resource("pro", "Settings", "Profile", "application/ld+json", doc);
+/** `#dmn` — the domain card; the indexer finds it by this type. */
+export const domainCardResource = (doc) => resource("dmn", "domainCard", "Domain card", "application/ld+json", doc);
+/** `#done` — the ask's terms; readers match the type, not the fragment. */
+export const doneMeansResource = (doc) => resource("done", "DoneMeans", "What would count as done, published before the work", "application/json", doc);
+/** `#rub` — the evals-engine rubric; the engine matches `type === "rubric"` at an id ending `#rub`, and the proof is its hex sha256. */
+export const rubricResource = (doc) => resource("rub", "rubric", "The same terms, in the evals-engine's rubric format", "application/ld+json", doc);
+/** `#vct` — the claim form a rubric binds to; the engine finds it by id suffix on the collection's protocol. */
+export const claimFormResource = (doc) => resource("vct", "surveyTemplate", "The claim form this protocol's rubrics are bound to", "application/ld+json", doc);
+/** A deed → the `protocol/verifiableClaim` its collections point at. */
+export const verifiableClaimLink = (protocolDid) => {
+    if (!isEntityDid(protocolDid))
+        throw new Error(`verifiableClaim link needs an entity DID, got ${JSON.stringify(protocolDid)}`);
+    return { id: protocolDid, type: "protocol/verifiableClaim", relationship: "verifiableClaim", service: "" };
+};
+/** A campaign ask → its campaign `protocol/deed`. Never a DAO: the only `partOf` this estate writes. */
+export const campaignLink = (campaignProtocolDid) => {
+    if (!isEntityDid(campaignProtocolDid))
+        throw new Error(`partOf link needs an entity DID, got ${JSON.stringify(campaignProtocolDid)}`);
+    return { id: campaignProtocolDid, type: "protocol/deed", relationship: "partOf", service: "" };
+};
+/** The `#pro` document, exactly the shape the portal writes (`createEntity.ts`) and every reader expects (`type: "profile"`, `name`). */
+export function buildProfile(input) {
+    const name = input.name.trim();
+    if (!name)
+        throw new Error("a profile needs a name");
+    return {
+        "@context": { ixo: "https://w3id.org/ixo/ns/protocol/", "@id": "@type", type: "@type", "@protected": true },
+        id: "ixo:entity#profile",
+        type: "profile",
+        orgName: (input.orgName ?? "Openhands").trim(),
+        name,
+        image: input.image ?? "",
+        logo: input.logo ?? "",
+        brand: (input.brand ?? "Openhands").trim(),
+        location: (input.location ?? "Global").trim(),
+        description: (input.description ?? "").trim(),
+        attributes: [],
+        metrics: []
+    };
+}
+const CARD_CONTEXT = [
+    "https://www.w3.org/ns/credentials/v2",
+    "https://w3id.org/ixo/context/v1",
+    {
+        attribute: "https://w3id.org/ixo/attributes/v1/",
+        schema: "https://schema.org/",
+        ixo: "https://w3id.org/ixo/vocab/v1",
+        prov: "http://www.w3.org/ns/prov#",
+        proj: "https://linked.data.gov.au/def/project#",
+        xsd: "http://www.w3.org/2001/XMLSchema#",
+        id: "@id",
+        type: "@type",
+        "@protected": true
+    }
+];
+const imageObject = (url) => ({ type: "schema:ImageObject", id: url, contentUrl: url });
+/**
+ * The `#dmn` document: a Verifiable Credential of type `ixo:DomainCard` per
+ * `ixoworld/domainCards` (`schemas/ixo-domain-card-1.json`). Unsigned here —
+ * the indexer and the portal never verify a proof; a signer can add one.
+ */
+export function buildDomainCard(input) {
+    if (!isEntityDid(input.did))
+        throw new Error(`a domain card needs the entity's DID, got ${JSON.stringify(input.did)}`);
+    const name = input.name.trim();
+    if (!name)
+        throw new Error("a domain card needs a name");
+    const subject = {
+        id: input.did,
+        type: [input.type],
+        name,
+        description: input.description.trim()
+    };
+    if (input.url)
+        subject.url = input.url;
+    if (input.logo)
+        subject.logo = { ...imageObject(input.logo), "schema:additionalProperty": [
+                { type: "schema:PropertyValue", name: "logoLight", value: imageObject(input.logo) },
+                { type: "schema:PropertyValue", name: "logoDark", value: imageObject(input.logo) }
+            ] };
+    if (input.image?.length)
+        subject.image = input.image.map(imageObject);
+    if (input.keywords?.length)
+        subject.keywords = input.keywords;
+    if (input.geo)
+        subject.geoCoordinates = { latitude: String(input.geo.latitude), longitude: String(input.geo.longitude) };
+    if (input.relatedDocument)
+        subject.relatedDocument = { type: "schema:CreativeWork", id: input.relatedDocument };
+    if (input.relationships?.length)
+        subject.relationships = input.relationships;
+    return {
+        "@context": CARD_CONTEXT,
+        id: `${input.did}#dmn`,
+        type: ["VerifiableCredential", "ixo:DomainCard"],
+        issuer: { id: input.issuer ?? input.did },
+        validFrom: input.validFrom ?? new Date().toISOString().slice(0, 19) + "Z",
+        credentialSchema: { id: "https://w3id.org/ixo/protocol/schema/v1#domainCard", type: "JsonSchema" },
+        credentialSubject: subject
+    };
+}
+const HUNDRED_YEARS_MS = 100 * 365 * 24 * 3600 * 1000;
+/**
+ * The `MsgCreateEntity` body, minus the proto wrapping. Refuses the shapes
+ * the plan retired: a `dao` ask, an empty context, a cellnode service, a
+ * relayer that is not an entity DID.
+ */
+export function buildEntityMessage(input) {
+    if (!isEntityDid(input.relayerNode))
+        throw new Error(`relayerNode must be an entity DID, got ${JSON.stringify(input.relayerNode)}`);
+    if (input.services.some((service) => service.type === "Cellnode" || /#cellnode$/.test(service.id)))
+        throw new Error("no #cellnode service: documents live on Matrix media (rule of 2026-10-09)");
+    if (!input.services.some((service) => service.type === "MatrixHomeServer"))
+        throw new Error("every entity declares its Matrix homeserver as a MatrixHomeServer service");
+    if (!input.resources.some((item) => item.id === "{id}#pro"))
+        throw new Error("every entity carries a #pro profile — it is the only name Trace reads");
+    const ids = input.resources.map((item) => item.id);
+    const duplicate = ids.find((id, index) => ids.indexOf(id) !== index);
+    if (duplicate)
+        throw new Error(`linked resource ${duplicate} appears twice`);
+    return {
+        entityType: input.kind,
+        entityStatus: 0,
+        context: classContext(input.classDid),
+        verification: input.verification,
+        controller: [input.ownerDid],
+        ownerAddress: input.ownerAddress,
+        ownerDid: input.ownerDid,
+        relayerNode: input.relayerNode,
+        alsoKnownAs: (input.alsoKnownAs ?? "").slice(0, 140),
+        service: input.services,
+        linkedResource: input.resources,
+        linkedEntity: input.linkedEntities ?? [],
+        accordedRight: [],
+        linkedClaim: [],
+        startDate: input.startDate,
+        endDate: input.endDate ?? new Date(input.startDate.getTime() + HUNDRED_YEARS_MS)
+    };
+}
+//# sourceMappingURL=entityShape.js.map

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

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

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

@@ -1,14 +1,47 @@
 import { type Network, network } from "../network.ts";
 export { network };
+/**
+ * The relayer nodes Openhands may name. Two, by decision (2026-10-13):
+ * Qi.Space is the launch relayer and the default; Yoma is the secondary. No
+ * other node is offered — the per-network "whatever the index happened to
+ * use" defaults that stood here before (Impacts DAO on testnet, and the WRONG
+ * Impacts DAO on mainnet, which every deployment had to override) are gone.
+ *
+ * Why it matters: a portal lists an entity only when its `relayerNode` is
+ * the portal's own DAO and `entityVerified` is true, and
+ * `MsgUpdateEntityVerified` must be signed by a key with `authentication` on
+ * that node's IID. So the relayer decides who can see an ask and who can
+ * verify it. The chain itself only checks that the DID has an IID document,
+ * which is why a wrong value was accepted silently for a year.
+ */
+export declare const RELAYER_NAMES: readonly ["qi-space", "yoma"];
+export type RelayerName = (typeof RELAYER_NAMES)[number];
+/** What `relayerChoice()` answers: a named node, or a DID the deployment set by hand. */
+export type RelayerChoice = RelayerName | "custom";
 /** The chain endpoints each network uses when nothing overrides them. The only copy of this table. */
 export interface ChainEndpoints {
     rpcUrl: string;
     restUrl: string;
     graphqlUrl: string;
-    relayerNodeDid: string;
     faucetUrl: string | null;
+    /** The relayer nodes by name; `null` where that operator has no node on this network. */
+    relayers: Readonly<Record<RelayerName, string | null>>;
+    /** Which of `relayers` is used when neither `configure()` nor the environment chooses (not consulted on mainnet, see `relayerNode()`). */
+    defaultRelayer: RelayerName;
+    /** The default relayer's DID — what `relayerNode()` answers when nothing overrides it. */
+    relayerNodeDid: string;
+    /** The `protocol/deed` root an ask deed is classed under (chain-verified, 2026-10-09). */
+    deedClassDid: string;
+    /** The `protocol/verifiableClaim` class a claim protocol is classed under; `null` where unconfirmed (devnet). */
+    verifiableClaimClassDid: string | null;
+    /** The Matrix homeserver whose media repo holds every linked document (`#dmn`, `#pro`, `#done`, `#rub`, `#vct`). */
+    matrixHomeserver: string;
 }
 export declare const chainEndpointsFor: (net: Network) => Readonly<ChainEndpoints>;
+/** The DID of a named relayer on a network, or `null` when that operator has no node there. */
+export declare const relayerNodeFor: (net: Network, name: RelayerName) => string | null;
+/** `true` for the two names this SDK offers; anything else (including `""`) is not a relayer name. */
+export declare const isRelayerName: (value: unknown) => value is RelayerName;
 /**
  * Where we talk to the chain.
  *
@@ -41,10 +74,44 @@ export declare const faucetUrl: () => string | null;
  */
 export declare const graphqlUrl: () => string;
 /**
- * The relayer node every entity we mint names. A DID, so it cannot be
- * guessed from the network name the way a URL can — hence the table. The
- * testnet value used to be hardcoded everywhere, which meant a devnet
- * deployment minted entities that pointed at a relayer on another chain.
+ * Which relayer this deployment posts under: the configured name, else
+ * `"custom"` when a DID was set by hand, else the network's default
+ * (`qi-space` everywhere).
+ */
+export declare function relayerChoice(): RelayerChoice;
+/**
+ * The relayer node every entity we mint names — or `null` when this
+ * deployment has not said which, on a network where it must.
+ *
+ * Order: `configure({ relayerNodeDid })` / `NEXT_PUBLIC_RELAYER_NODE_DID`
+ * (an explicit DID always wins; it is the deployment's own choice), then
+ * `configure({ relayer })` / `NEXT_PUBLIC_RELAYER` (a name from the table),
+ * then the network's default. **Mainnet has no default**: real entities on
+ * the wrong node are invisible to every portal and unverifiable by the keys
+ * we hold, so an unconfigured mainnet answers `null` here and `relayerNode()`
+ * throws before anything is signed. A named relayer without a node on this
+ * network is `null` too.
+ */
+export declare function relayerNodeIfConfigured(): string | null;
+/**
+ * The relayer node to put on a `MsgCreateEntity`. Throws, naming the setting
+ * to fix, when `relayerNodeIfConfigured()` has no answer — the message is
+ * meant to be read by whoever deploys, before a single signature.
+ */
+export declare function relayerNode(): string;
+/** The `protocol/deed` class a new ask deed is created under. `NEXT_PUBLIC_DEED_CLASS_DID` overrides the network's. */
+export declare const deedClassDid: () => string;
+/** The `protocol/verifiableClaim` class, or `null` where the network's is unconfirmed (devnet) and nothing overrides it. */
+export declare const verifiableClaimClassDidIfConfigured: () => string | null;
+/** The `protocol/verifiableClaim` class a new claim protocol is created under. Throws where the network's is unconfirmed and nothing overrides it. */
+export declare function verifiableClaimClassDid(): string;
+/**
+ * The Matrix homeserver whose media repo holds every linked document:
+ * `configure({ matrixHomeserver })`, then `NEXT_PUBLIC_MATRIX_HOMESERVER`, then
+ * the network's. No trailing slash. Never the Worker's `MATRIX_HOMESERVER`
+ * binding: a `MATRIX_*` read marks a module server-only, and this one is
+ * reachable from every public barrel (barrels.test.ts). A Worker that wants
+ * its binding honoured passes it through `configure()`.
  */
-export declare const relayerNode: () => string;
+export declare const matrixHomeserver: () => string;
 //# sourceMappingURL=env.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../src/chain/env.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAOtD,OAAO,EAAE,OAAO,EAAE,CAAC;AAEnB,sGAAsG;AACtG,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AA2BD,eAAO,MAAM,iBAAiB,GAAI,KAAK,OAAO,KAAG,QAAQ,CAAC,cAAc,CAAmB,CAAC;AAE5F;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,MAAM,QAAO,MACuI,CAAC;AAElK;;;;GAIG;AACH,wBAAgB,IAAI,IAAI,MAAM,GAAG,SAAS,CAIzC;AAED,8FAA8F;AAC9F,eAAO,MAAM,OAAO,QAAO,MACwH,CAAC;AAEpJ,sGAAsG;AACtG,eAAO,MAAM,SAAS,QAAO,MAAM,GAAG,IAGrC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU,QAAO,MAGuG,CAAC;AAEtI;;;;;GAKG;AACH,eAAO,MAAM,WAAW,QAAO,MACqH,CAAC"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../src/chain/env.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAOtD,OAAO,EAAE,OAAO,EAAE,CAAC;AAEnB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa,+BAAgC,CAAC;AAC3D,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AACzD,yFAAyF;AACzF,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEnD,sGAAsG;AACtG,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,yFAAyF;IACzF,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;IACvD,0IAA0I;IAC1I,cAAc,EAAE,WAAW,CAAC;IAC5B,0FAA0F;IAC1F,cAAc,EAAE,MAAM,CAAC;IACvB,0FAA0F;IAC1F,YAAY,EAAE,MAAM,CAAC;IACrB,iHAAiH;IACjH,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,oHAAoH;IACpH,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAwDD,eAAO,MAAM,iBAAiB,GAAI,KAAK,OAAO,KAAG,QAAQ,CAAC,cAAc,CAAmB,CAAC;AAE5F,+FAA+F;AAC/F,eAAO,MAAM,cAAc,GAAI,KAAK,OAAO,EAAE,MAAM,WAAW,KAAG,MAAM,GAAG,IAAqC,CAAC;AAEhH,sGAAsG;AACtG,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,WAAgG,CAAC;AAEzJ;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,MAAM,QAAO,MACuI,CAAC;AAElK;;;;GAIG;AACH,wBAAgB,IAAI,IAAI,MAAM,GAAG,SAAS,CAIzC;AAED,8FAA8F;AAC9F,eAAO,MAAM,OAAO,QAAO,MACwH,CAAC;AAEpJ,sGAAsG;AACtG,eAAO,MAAM,SAAS,QAAO,MAAM,GAAG,IAGrC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU,QAAO,MAGuG,CAAC;AAoBtI;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,aAAa,CAK7C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CAQvD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAUpC;AAID,uHAAuH;AACvH,eAAO,MAAM,YAAY,QAAO,MAC8G,CAAC;AAE/I,4HAA4H;AAC5H,eAAO,MAAM,mCAAmC,QAAO,MAAM,GAAG,IACkG,CAAC;AAEnK,sJAAsJ;AACtJ,wBAAgB,uBAAuB,IAAI,MAAM,CAIhD;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,QAAO,MAC2I,CAAC"}

package/dist/esm/chain/env.js

@@ -6,31 +6,78 @@ import { firstSet, hasEnv } from "../envRead.js";
    below reads `configure()` first, then its own environment variable, then
    this network's row of the table, at call time. */
 export { network };
+/**
+ * The relayer nodes Openhands may name. Two, by decision (2026-10-13):
+ * Qi.Space is the launch relayer and the default; Yoma is the secondary. No
+ * other node is offered — the per-network "whatever the index happened to
+ * use" defaults that stood here before (Impacts DAO on testnet, and the WRONG
+ * Impacts DAO on mainnet, which every deployment had to override) are gone.
+ *
+ * Why it matters: a portal lists an entity only when its `relayerNode` is
+ * the portal's own DAO and `entityVerified` is true, and
+ * `MsgUpdateEntityVerified` must be signed by a key with `authentication` on
+ * that node's IID. So the relayer decides who can see an ask and who can
+ * verify it. The chain itself only checks that the DID has an IID document,
+ * which is why a wrong value was accepted silently for a year.
+ */
+export const RELAYER_NAMES = ["qi-space", "yoma"];
+/* Read off blocksync on 2026-10-09 and 2026-10-13 (all three networks): each
+   node's DID, type `dao`, its `entityVerified`, and the keys that hold
+   `authentication` on it. The testnet Qi.Space node was minted on 2026-10-13
+   for exactly this table. See IXO-ALIGNMENT-PLAN.md §2.1 (design-partners). */
+const QI_SPACE = {
+    devnet: "did:ixo:entity:3d875e6db1f6a725579ff3c37a77dc1b",
+    testnet: "did:ixo:entity:5e59f98989c33e9b3d2a0c1d55991060",
+    mainnet: "did:ixo:entity:47d9c64891e77cb8e588d33b83ab3042"
+};
+const YOMA = {
+    devnet: "did:ixo:entity:50a7d92f449ab5752f63c64521adb3cc",
+    testnet: "did:ixo:entity:3700e507b54ba7092d3f1c4873af26ab",
+    mainnet: "did:ixo:entity:5884e9e2c624cb8a38bde74225215ee8"
+};
 const ENDPOINTS = {
     devnet: {
         rpcUrl: "https://devnet.ixo.earth/rpc/",
         restUrl: "https://devnet.ixo.earth/rest",
         graphqlUrl: "https://devnet-blocksync-graphql.ixo.earth/graphql",
-        /* A DID, so it cannot be guessed from the network name the way a URL can. */
-        relayerNodeDid: "did:ixo:entity:2f22535f8b179a51d77a0e302e68d35d",
-        faucetUrl: "https://faucet.devnet.ixo.earth"
+        faucetUrl: "https://faucet.devnet.ixo.earth",
+        relayers: { "qi-space": QI_SPACE.devnet, yoma: YOMA.devnet },
+        defaultRelayer: "qi-space",
+        relayerNodeDid: QI_SPACE.devnet,
+        deedClassDid: "did:ixo:entity:ef2b04b2093d0e258c5e8fc8459805dc",
+        verifiableClaimClassDid: null,
+        matrixHomeserver: "https://devmx.ixo.earth"
     },
     testnet: {
         rpcUrl: "https://testnet.ixo.earth/rpc/",
         restUrl: "https://testnet.ixo.earth/rest",
         graphqlUrl: "https://testnet-blocksync-graphql.ixo.earth/graphql",
-        relayerNodeDid: "did:ixo:entity:3d079ebc0b332aad3305bb4a51c72edb",
-        faucetUrl: "https://faucet.testnet.ixo.earth"
+        faucetUrl: "https://faucet.testnet.ixo.earth",
+        relayers: { "qi-space": QI_SPACE.testnet, yoma: YOMA.testnet },
+        defaultRelayer: "qi-space",
+        relayerNodeDid: QI_SPACE.testnet,
+        deedClassDid: "did:ixo:entity:3f51fe4ea8670876b88c03712d503b43",
+        verifiableClaimClassDid: "did:ixo:entity:6112c527c614119115b78919e2673bcd",
+        matrixHomeserver: "https://testmx.ixo.earth"
     },
     mainnet: {
         rpcUrl: "https://impacthub.ixo.world/rpc/",
         restUrl: "https://impacthub.ixo.world/rest",
         graphqlUrl: "https://blocksync-graphql.ixo.earth/graphql",
-        relayerNodeDid: "did:ixo:entity:2f22535f8b179a51d77a0e302e68d35d",
-        faucetUrl: null
+        faucetUrl: null,
+        relayers: { "qi-space": QI_SPACE.mainnet, yoma: YOMA.mainnet },
+        defaultRelayer: "qi-space",
+        relayerNodeDid: QI_SPACE.mainnet,
+        deedClassDid: "did:ixo:entity:4a3d4a4597774b93b1a14d1e614f9e38",
+        verifiableClaimClassDid: "did:ixo:entity:004a597633a1012a6c785209ae0b627d",
+        matrixHomeserver: "https://mx.ixo.earth"
     }
 };
 export const chainEndpointsFor = (net) => ENDPOINTS[net];
+/** The DID of a named relayer on a network, or `null` when that operator has no node there. */
+export const relayerNodeFor = (net, name) => ENDPOINTS[net].relayers[name];
+/** `true` for the two names this SDK offers; anything else (including `""`) is not a relayer name. */
+export const isRelayerName = (value) => typeof value === "string" && RELAYER_NAMES.includes(value);
 /**
  * Where we talk to the chain.
  *
@@ -73,11 +120,98 @@ export const graphqlUrl = () =>
 /* The data layer's `gql()` has no default and refuses to guess; the chain
    layer always fell back to the network's own index. Both kept. */
 (givenConfig().graphqlUrl ?? (hasEnv() ? process.env.NEXT_PUBLIC_GRAPHQL_URL : undefined) ?? "") || ENDPOINTS[network()].graphqlUrl;
+/* ── the relayer ─────────────────────────────────────────────────────────── */
+/** `configure({ relayerNodeDid })` or `NEXT_PUBLIC_RELAYER_NODE_DID`: a DID set by hand, else undefined. */
+const explicitRelayerDid = () => givenConfig().relayerNodeDid ?? (hasEnv() ? firstSet(process.env.NEXT_PUBLIC_RELAYER_NODE_DID) : undefined);
+/** `configure({ relayer })` or `NEXT_PUBLIC_RELAYER`: a relayer NAME chosen by the deployment, else undefined. Throws on a name this SDK does not offer. */
+function explicitRelayerName() {
+    const given = givenConfig().relayer;
+    if (given !== undefined) {
+        if (!isRelayerName(given))
+            throw new Error(`configure({ relayer }) is ${JSON.stringify(given)}; it must be one of ${RELAYER_NAMES.join(", ")}`);
+        return given;
+    }
+    const raw = hasEnv() ? firstSet(process.env.NEXT_PUBLIC_RELAYER) : undefined;
+    if (raw === undefined)
+        return undefined;
+    if (!isRelayerName(raw))
+        throw new Error(`NEXT_PUBLIC_RELAYER is ${JSON.stringify(raw)}; it must be one of ${RELAYER_NAMES.join(", ")} (or unset for the network's default)`);
+    return raw;
+}
+/**
+ * Which relayer this deployment posts under: the configured name, else
+ * `"custom"` when a DID was set by hand, else the network's default
+ * (`qi-space` everywhere).
+ */
+export function relayerChoice() {
+    const name = explicitRelayerName();
+    if (name)
+        return name;
+    if (explicitRelayerDid())
+        return "custom";
+    return ENDPOINTS[network()].defaultRelayer;
+}
+/**
+ * The relayer node every entity we mint names — or `null` when this
+ * deployment has not said which, on a network where it must.
+ *
+ * Order: `configure({ relayerNodeDid })` / `NEXT_PUBLIC_RELAYER_NODE_DID`
+ * (an explicit DID always wins; it is the deployment's own choice), then
+ * `configure({ relayer })` / `NEXT_PUBLIC_RELAYER` (a name from the table),
+ * then the network's default. **Mainnet has no default**: real entities on
+ * the wrong node are invisible to every portal and unverifiable by the keys
+ * we hold, so an unconfigured mainnet answers `null` here and `relayerNode()`
+ * throws before anything is signed. A named relayer without a node on this
+ * network is `null` too.
+ */
+export function relayerNodeIfConfigured() {
+    const did = explicitRelayerDid();
+    if (did)
+        return did;
+    const name = explicitRelayerName();
+    const net = network();
+    if (name)
+        return ENDPOINTS[net].relayers[name];
+    if (net === "mainnet")
+        return null;
+    return ENDPOINTS[net].relayerNodeDid;
+}
+/**
+ * The relayer node to put on a `MsgCreateEntity`. Throws, naming the setting
+ * to fix, when `relayerNodeIfConfigured()` has no answer — the message is
+ * meant to be read by whoever deploys, before a single signature.
+ */
+export function relayerNode() {
+    const did = relayerNodeIfConfigured();
+    if (did)
+        return did;
+    const net = network();
+    const name = explicitRelayerName();
+    if (name) {
+        const other = RELAYER_NAMES.filter((candidate) => candidate !== name && ENDPOINTS[net].relayers[candidate]);
+        throw new Error(`${name} has no relayer node on ${net}; set NEXT_PUBLIC_RELAYER to ${other.join(" or ") || "a relayer with a node here"}, or NEXT_PUBLIC_RELAYER_NODE_DID to a DID, before posting`);
+    }
+    throw new Error("no relayer configured for mainnet: set NEXT_PUBLIC_RELAYER=qi-space (or yoma), or NEXT_PUBLIC_RELAYER_NODE_DID — there is no mainnet default on purpose");
+}
+/* ── the classes and the document store ──────────────────────────────────── */
+/** The `protocol/deed` class a new ask deed is created under. `NEXT_PUBLIC_DEED_CLASS_DID` overrides the network's. */
+export const deedClassDid = () => givenConfig().deedClassDid ?? (hasEnv() ? firstSet(process.env.NEXT_PUBLIC_DEED_CLASS_DID) : undefined) ?? ENDPOINTS[network()].deedClassDid;
+/** The `protocol/verifiableClaim` class, or `null` where the network's is unconfirmed (devnet) and nothing overrides it. */
+export const verifiableClaimClassDidIfConfigured = () => givenConfig().verifiableClaimClassDid ?? (hasEnv() ? firstSet(process.env.NEXT_PUBLIC_VC_CLASS_DID) : undefined) ?? ENDPOINTS[network()].verifiableClaimClassDid;
+/** The `protocol/verifiableClaim` class a new claim protocol is created under. Throws where the network's is unconfirmed and nothing overrides it. */
+export function verifiableClaimClassDid() {
+    const did = verifiableClaimClassDidIfConfigured();
+    if (!did)
+        throw new Error(`the protocol/verifiableClaim class on ${network()} is not confirmed; set NEXT_PUBLIC_VC_CLASS_DID`);
+    return did;
+}
 /**
- * The relayer node every entity we mint names. A DID, so it cannot be
- * guessed from the network name the way a URL can — hence the table. The
- * testnet value used to be hardcoded everywhere, which meant a devnet
- * deployment minted entities that pointed at a relayer on another chain.
+ * The Matrix homeserver whose media repo holds every linked document:
+ * `configure({ matrixHomeserver })`, then `NEXT_PUBLIC_MATRIX_HOMESERVER`, then
+ * the network's. No trailing slash. Never the Worker's `MATRIX_HOMESERVER`
+ * binding: a `MATRIX_*` read marks a module server-only, and this one is
+ * reachable from every public barrel (barrels.test.ts). A Worker that wants
+ * its binding honoured passes it through `configure()`.
  */
-export const relayerNode = () => givenConfig().relayerNodeDid ?? (hasEnv() ? firstSet(process.env.NEXT_PUBLIC_RELAYER_NODE_DID) : undefined) ?? ENDPOINTS[network()].relayerNodeDid;
+export const matrixHomeserver = () => (givenConfig().matrixHomeserver ?? (hasEnv() ? firstSet(process.env.NEXT_PUBLIC_MATRIX_HOMESERVER) : undefined) ?? ENDPOINTS[network()].matrixHomeserver).replace(/\/+$/, "");
 //# sourceMappingURL=env.js.map

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

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

package/dist/esm/config.d.ts

@@ -27,11 +27,12 @@
  */
 import { chainNetwork, type Network, NETWORKS } from "./network.ts";
 import { strictBase } from "./envRead.ts";
+import { RELAYER_NAMES, type RelayerChoice, type RelayerName } from "./chain/env.ts";
 import { DEFAULT_IPFS_GATEWAY_URL } from "./data/docUrls.ts";
 import { DEFAULT_RATES_URL } from "./data/rates.ts";
 import { DEFAULT_ORACLE_RECEIPT_HOSTS, parseHosts } from "./data/accept.ts";
 import { DEFAULT_CHECK_REWARD_BASE } from "./campaign/funding.ts";
-export { chainNetwork, NETWORKS, type Network, strictBase, parseHosts, DEFAULT_IPFS_GATEWAY_URL, DEFAULT_RATES_URL, DEFAULT_ORACLE_RECEIPT_HOSTS, DEFAULT_CHECK_REWARD_BASE };
+export { chainNetwork, NETWORKS, type Network, RELAYER_NAMES, type RelayerName, type RelayerChoice, strictBase, parseHosts, DEFAULT_IPFS_GATEWAY_URL, DEFAULT_RATES_URL, DEFAULT_ORACLE_RECEIPT_HOSTS, DEFAULT_CHECK_REWARD_BASE };
 export type AskDenom = "uixo" | "upay";
 export interface OpenhandsConfig {
     /** `NEXT_PUBLIC_CHAIN_NETWORK`; unset/empty → testnet; any other value throws. */
@@ -67,8 +68,25 @@ export interface OpenhandsConfig {
     granterAddress: string;
     /** `NEXT_PUBLIC_GRANTER_BOT_URL` || "" — the guest funnel's gate. */
     granterBotUrl: string;
-    /** `NEXT_PUBLIC_RELAYER_NODE_DID` || per-network. */
-    relayerNodeDid: string;
+    /**
+     * `NEXT_PUBLIC_RELAYER` (`qi-space` | `yoma`), else `"custom"` when
+     * `NEXT_PUBLIC_RELAYER_NODE_DID` names a node by hand, else the network's
+     * default (`qi-space`). A name this SDK does not offer throws.
+     */
+    relayer: RelayerChoice;
+    /**
+     * `NEXT_PUBLIC_RELAYER_NODE_DID` (an explicit DID wins), else the node
+     * `relayer` names on this network, else the network's default. `null` on
+     * mainnet when nothing chose — there is no mainnet default on purpose, and
+     * `chain/env` `relayerNode()` throws instead of minting on the wrong node.
+     */
+    relayerNodeDid: string | null;
+    /** `NEXT_PUBLIC_DEED_CLASS_DID` || per-network: the `protocol/deed` class an ask deed is created under. */
+    deedClassDid: string;
+    /** `NEXT_PUBLIC_VC_CLASS_DID` || per-network: the `protocol/verifiableClaim` class a claim protocol is created under; `null` where unconfirmed (devnet). */
+    verifiableClaimClassDid: string | null;
+    /** `NEXT_PUBLIC_MATRIX_HOMESERVER` || per-network; no trailing slash. Where every linked document is uploaded. A Worker's `MATRIX_HOMESERVER` binding is passed through `configure()`, never read here (barrels.test.ts). */
+    matrixHomeserver: string;
     /** `NEXT_PUBLIC_AUTHN_RP_ID` || undefined (the browser's own hostname). */
     authnRpId: string | undefined;
     /** `NEXT_PUBLIC_ASK_DENOM` === "upay" ? "upay" : "uixo". */
@@ -98,7 +116,15 @@ export interface NetworkDefaults {
     restUrl: string;
     graphqlUrl: string;
     vfsUrl: string;
+    /** The two relayer nodes on this network by name (`null` where an operator has none). */
+    relayers: Readonly<Record<RelayerName, string | null>>;
+    /** The name used when nothing chooses (not consulted on mainnet). */
+    defaultRelayer: RelayerName;
+    /** The default relayer's DID. */
     relayerNodeDid: string;
+    deedClassDid: string;
+    verifiableClaimClassDid: string | null;
+    matrixHomeserver: string;
     faucetUrl: string | null;
 }
 /** The endpoints a network uses when nothing overrides them. */

package/dist/esm/config.d.ts.map

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

package/dist/esm/config.js

@@ -28,7 +28,7 @@
 import { givenConfig, givenVersion, setGivenConfig } from "./given.js";
 import { chainNetwork, network, NETWORKS } from "./network.js";
 import { strictBase } from "./envRead.js";
-import { chainEndpointsFor, faucetUrl, relayerNode, restUrl, rpcUrl, rpId } from "./chain/env.js";
+import { chainEndpointsFor, deedClassDid, faucetUrl, matrixHomeserver, relayerChoice, relayerNodeIfConfigured, RELAYER_NAMES, restUrl, rpcUrl, rpId, verifiableClaimClassDidIfConfigured } from "./chain/env.js";
 import { askDenom } from "./chain/money.js";
 import { granterBotUrl } from "./chain/guest.js";
 import { oracleUrl } from "./chain/oracle.js";
@@ -44,7 +44,7 @@ import { campaignReadBudgetMs, campaignSince, campaignWalkTtlMs } from "./campai
 import { checkRewardBase, DEFAULT_CHECK_REWARD_BASE } from "./campaign/funding.js";
 import { checkerAiUpay, checkerBaseUpay, checkerPhotoUpay } from "./rubric/leg.js";
 /* Re-exported so this module's long-standing names keep working. */
-export { chainNetwork, NETWORKS, strictBase, parseHosts, DEFAULT_IPFS_GATEWAY_URL, DEFAULT_RATES_URL, DEFAULT_ORACLE_RECEIPT_HOSTS, DEFAULT_CHECK_REWARD_BASE };
+export { chainNetwork, NETWORKS, RELAYER_NAMES, strictBase, parseHosts, DEFAULT_IPFS_GATEWAY_URL, DEFAULT_RATES_URL, DEFAULT_ORACLE_RECEIPT_HOSTS, DEFAULT_CHECK_REWARD_BASE };
 /** The endpoints a network uses when nothing overrides them. */
 export function defaultsFor(net) {
     return { ...chainEndpointsFor(net), vfsUrl: vfsUrlFor(net) };
@@ -95,7 +95,11 @@ export function config() {
         campaignFoldUrl: campaignFoldUrl(),
         granterAddress: granterAddress(),
         granterBotUrl: granterBotUrl(),
-        relayerNodeDid: relayerNode(),
+        relayer: relayerChoice(),
+        relayerNodeDid: relayerNodeIfConfigured(),
+        deedClassDid: deedClassDid(),
+        verifiableClaimClassDid: verifiableClaimClassDidIfConfigured(),
+        matrixHomeserver: matrixHomeserver(),
         authnRpId: rpId(),
         askDenom: askDenom(),
         basePath: basePath(),