@calimero-network/mero-js 24.1.3 → 24.3.0

package/dist/index.cjs

@@ -1766,16 +1766,18 @@ var AdminApiClient = class {
    * Ask what this node can do for a member in `contextId`, before they sign
    * anything.
    *
-   * The two facts {@link performIntent} needs and a client cannot derive: whose
-   * account goes in the warrant's `executor`, and whether this node holds
-   * `CAN_AUTHOR_ON_BEHALF` on the owning group. `canAuthorOnBehalf: false` comes
-   * back as an answer rather than an error — it is the default state of every
-   * context — so a caller can say "an admin of `groupId` must grant it to
-   * `executorAccount`" instead of presenting a warrant that will be refused
-   * after the author has spent a nonce on it.
-   *
-   * `404` means the context belongs to no group, or this node holds no account
-   * yet; either way it can be named as no warrant's executor.
+   * The facts {@link performIntent} needs and a client cannot derive: whose
+   * account and key go in the warrant's `executor` and `executor_key`, which
+   * release it pins, and whether this node holds `CAN_AUTHOR_ON_BEHALF` on the
+   * owning group.
+   * `canAuthorOnBehalf: false` comes back as an answer rather than an error, as
+   * it is the default state of every context, so a caller can say "an admin of
+   * `groupId` must grant it to `executorAccount`" instead of presenting a
+   * warrant that will be refused after the author has spent a nonce on it.
+   *
+   * `404` means the context belongs to no group, this node holds no account or
+   * identity in it yet, or its group names no release yet; no warrant can be
+   * spent here until that changes.
    *
    * For a caller with no credential on the node at all — a browser tab holding
    * one signing key — use `RelayClient`, which reads this same route on a node
@@ -7472,7 +7474,7 @@ function splitVersion2(version) {
 var SIGN_DOMAIN2 = new TextEncoder().encode("calimero.warrant.v2");
 var INTENT_DOMAIN = new TextEncoder().encode("calimero.warrant.intent.v1");
 var MAX_CITED_HEADS = 64;
-var UNPINNED_APP = "00".repeat(32);
+var MAX_RELEASE_VERSION_LEN = 256;
 async function intentHash(method, argsJson) {
   const args = new TextEncoder().encode(JSON.stringify(argsJson));
   return domainHash(INTENT_DOMAIN, [new TextEncoder().encode(method), args]);
@@ -7481,11 +7483,9 @@ async function signWarrant(input) {
   const context = fromHex(input.context, "context", 32);
   const authorAccount = fromHex(input.authorAccount, "authorAccount", 32);
   const executor = fromHex(input.executor, "executor", 32);
-  const appVersion = fromHex(
-    input.appVersion ?? UNPINNED_APP,
-    "appVersion",
-    32
-  );
+  const executorKey = fromHex(input.executorKey, "executorKey", 32);
+  const releaseBytecodeId = fromHex(input.releaseBytecodeId, "releaseBytecodeId", 32);
+  const releaseVersion2 = releaseVersionBytes(input.releaseVersion ?? "");
   const accountHeads = citedHeads(input.accountHeads, "accountHeads");
   const governanceFloor = citedHeads(input.governanceFloor, "governanceFloor");
   const signer = await resolveSigner(input.deviceSecret, input.signer, "deviceSecret");
@@ -7499,7 +7499,9 @@ async function signWarrant(input) {
     authorAccount,
     publicKey,
     executor,
-    appVersion,
+    executorKey,
+    releaseBytecodeId,
+    releaseVersion2,
     method,
     commitment,
     u64le(accountHeads.length),
@@ -7516,7 +7518,10 @@ async function signWarrant(input) {
       authorAccount,
       publicKey,
       executor,
-      appVersion,
+      executorKey,
+      releaseBytecodeId,
+      u32le(releaseVersion2.length),
+      releaseVersion2,
       u32le(method.length),
       method,
       commitment,
@@ -7537,6 +7542,18 @@ function checkedSignature(signature) {
   }
   return signature;
 }
+function releaseVersionBytes(version) {
+  const bytes = new TextEncoder().encode(version);
+  checkReleaseVersionLength(bytes.length);
+  return bytes;
+}
+function checkReleaseVersionLength(len) {
+  if (len > MAX_RELEASE_VERSION_LEN) {
+    throw new Error(
+      `releaseVersion is ${len} bytes, over the ${MAX_RELEASE_VERSION_LEN} a node accepts`
+    );
+  }
+}
 function citedHeads(heads, label2) {
   const list = heads ?? [];
   if (list.length > MAX_CITED_HEADS) {
@@ -7562,6 +7579,7 @@ async function creationWarrantPreimage(p) {
     p.authorAccount,
     p.deviceKey,
     p.executor,
+    p.executorKey,
     p.applicationId,
     new Uint8Array([p.serviceName === null ? 0 : 1]),
     p.serviceName ?? new Uint8Array(0),
@@ -7581,6 +7599,7 @@ async function signCreationWarrant(input) {
   const seed = input.seed === void 0 ? crypto.getRandomValues(new Uint8Array(32)) : fromHex(input.seed, "seed", 32);
   const authorAccount = fromHex(input.authorAccount, "authorAccount", 32);
   const executor = fromHex(input.executor, "executor", 32);
+  const executorKey = fromHex(input.executorKey, "executorKey", 32);
   const applicationId = fromHex(input.applicationId, "applicationId", 32);
   const serviceName = label(input.serviceName, "serviceName");
   const name = label(input.name, "name");
@@ -7595,6 +7614,7 @@ async function signCreationWarrant(input) {
     authorAccount,
     deviceKey,
     executor,
+    executorKey,
     applicationId,
     serviceName,
     name,
@@ -7612,6 +7632,7 @@ async function signCreationWarrant(input) {
       authorAccount,
       deviceKey,
       executor,
+      executorKey,
       applicationId,
       borshOption(serviceName),
       borshOption(name),
@@ -7671,6 +7692,7 @@ function parseCreationWarrant(warrant) {
     authorAccount: hex(take(32, "authorAccount")),
     deviceKey: hex(take(32, "deviceKey")),
     executor: hex(take(32, "executor")),
+    executorKey: hex(take(32, "executorKey")),
     applicationId: hex(take(32, "applicationId")),
     serviceName: option("serviceName"),
     name: option("name"),
@@ -7717,6 +7739,7 @@ async function governanceWarrantPreimage(p) {
     p.authorAccount,
     p.deviceKey,
     p.executor,
+    p.executorKey,
     p.opHash,
     u64le(p.accountHeads.length),
     ...p.accountHeads,
@@ -7730,6 +7753,7 @@ async function signGovernanceWarrant(input) {
   const scope = fromHex(input.scope, "scope", 32);
   const authorAccount = fromHex(input.authorAccount, "authorAccount", 32);
   const executor = fromHex(input.executor, "executor", 32);
+  const executorKey = fromHex(input.executorKey, "executorKey", 32);
   const accountHeads = citedHeads(input.accountHeads, "accountHeads");
   const governanceFloor = citedHeads(input.governanceFloor, "governanceFloor");
   const kind = kindByte(input.op.kind);
@@ -7742,6 +7766,7 @@ async function signGovernanceWarrant(input) {
     authorAccount,
     deviceKey,
     executor,
+    executorKey,
     opHash,
     accountHeads,
     governanceFloor,
@@ -7756,6 +7781,7 @@ async function signGovernanceWarrant(input) {
       authorAccount,
       deviceKey,
       executor,
+      executorKey,
       opHash,
       u32le(accountHeads.length),
       ...accountHeads,
@@ -7807,6 +7833,7 @@ function parseGovernanceWarrant(warrant) {
     authorAccount: hex(take(32, "authorAccount")),
     deviceKey: hex(take(32, "deviceKey")),
     executor: hex(take(32, "executor")),
+    executorKey: hex(take(32, "executorKey")),
     opHash: hex(take(32, "opHash")),
     accountHeads: heads("accountHeads"),
     governanceFloor: heads("governanceFloor"),
@@ -8111,7 +8138,6 @@ var RelayClient = class {
   constructor(config) {
     this.config = config;
     this.baseUrl = config.relayUrl.replace(/\/+$/, "");
-    this.executorAccount = config.executorAccount;
     const injected = config.fetch;
     this.fetchImpl = injected ? (input, init) => injected(input, init) : (input, init) => globalThis.fetch(input, init);
     this.timeoutMs = config.timeoutMs ?? 1e4;
@@ -8161,8 +8187,10 @@ var RelayClient = class {
    * as diagnostics after a failure.
    */
   async describe(contextId) {
-    const body = await this.json("GET", `/admin-api/contexts/${encodeURIComponent(contextId)}/intents`);
-    this.executorAccount = body.data.executorAccount;
+    const body = await this.json(
+      "GET",
+      `/admin-api/contexts/${encodeURIComponent(contextId)}/intents`
+    );
     return body.data;
   }
   /**
@@ -8173,14 +8201,23 @@ var RelayClient = class {
    * apply. Nothing accumulates and nothing is reusable.
    */
   async execute(contextId, method, argsJson = {}) {
-    const executor = this.executorAccount ?? (await this.describe(contextId)).executorAccount;
+    const described = await this.describe(contextId);
+    const executor = this.checkedExecutor(described);
+    const releaseBytecodeId = hex(
+      fromHex(described.releaseBytecodeId ?? "", "the relay's releaseBytecodeId", 32)
+    );
+    const releaseVersion2 = described.releaseVersion ?? "";
+    releaseVersionBytes(releaseVersion2);
     const signer = await this.authorSigner();
     const nonce2 = await this.config.nonces.next();
     const ttl = this.config.ttlSeconds ?? DEFAULT_TTL_SECONDS;
     const warrant = await signWarrant({
       context: contextId,
       authorAccount: this.config.authorAccount,
-      executor,
+      executor: executor.executorAccount,
+      executorKey: executor.executorKey,
+      releaseBytecodeId,
+      releaseVersion: releaseVersion2,
       method,
       argsJson,
       nonce: nonce2,
@@ -8260,7 +8297,7 @@ var RelayClient = class {
         403
       );
     }
-    const executor = this.checkedExecutor(described.executorAccount);
+    const executor = this.checkedExecutor(described);
     const initArgs = input.initArgs ?? {};
     const signer = await this.authorSigner();
     const nonce2 = await this.config.nonces.next();
@@ -8269,7 +8306,8 @@ var RelayClient = class {
       group: input.groupId,
       seed: input.seed,
       authorAccount: this.config.authorAccount,
-      executor,
+      executor: executor.executorAccount,
+      executorKey: executor.executorKey,
       applicationId: input.applicationId,
       serviceName: input.serviceName,
       name: input.name,
@@ -8291,7 +8329,7 @@ var RelayClient = class {
   }
   /**
    * Ask the relay whether it may publish governance ops for members of
-   * `groupId`, and which account a warrant must name.
+   * `groupId`, and which account and key a warrant must name.
    */
   async describeGovernance(groupId) {
     const body = await this.json(
@@ -8325,7 +8363,7 @@ var RelayClient = class {
         403
       );
     }
-    const executor = this.checkedExecutor(described.executorAccount);
+    const executor = this.checkedExecutor(described);
     const signer = await this.authorSigner();
     const nonce2 = await this.config.nonces.next();
     const ttl = this.config.ttlSeconds ?? DEFAULT_TTL_SECONDS;
@@ -8333,7 +8371,8 @@ var RelayClient = class {
       scope: input.groupId,
       op: input.op,
       authorAccount: this.config.authorAccount,
-      executor,
+      executor: executor.executorAccount,
+      executorKey: executor.executorKey,
       nonce: nonce2,
       notAfter: BigInt(Math.floor(Date.now() / 1e3)) + BigInt(ttl),
       signer
@@ -8359,9 +8398,7 @@ var RelayClient = class {
    *
    * The executor cannot be learned from the relay first: the namespace does not
    * exist, so `describeGovernance` has nothing to answer about. It comes from
-   * `input.executorAccount`, the configured one, or one an earlier call learned
-   * (`describe`, `createContext`, `govern`), and without any of them this
-   * throws before taking a nonce.
+   * `input.executor` only, and without it this throws before taking a nonce.
    * The nonce is spent in the new namespace's ledger.
    *
    * With `defaultCapabilities`, the founder then sets the namespace's default
@@ -8372,13 +8409,13 @@ var RelayClient = class {
    * Refusals (`400`/`403`) come back as {@link IntentRefusedError}; a salt
    * that names an existing namespace is a `409`, an `HTTPError`.
    */
-  async foundNamespace(input = {}) {
-    const executor = input.executorAccount ? this.checkedExecutor(input.executorAccount) : this.executorAccount;
-    if (!executor) {
+  async foundNamespace(input) {
+    if (!input?.executor) {
       throw new Error(
-        "foundNamespace needs the relay's account: pass executorAccount or configure it (checked before signing, no nonce was spent)"
+        "foundNamespace needs the relay's account and signing key: pass executor (checked before signing, no nonce was spent)"
       );
     }
+    const executor = this.checkedExecutor(input.executor);
     const salt = input.salt ? hex(fromHex(input.salt, "salt", 32)) : hex(crypto.getRandomValues(new Uint8Array(32)));
     const namespaceId = await foundedNamespaceId(this.config.authorAccount, salt);
     const op = namespaceCreatedOp({
@@ -8395,7 +8432,8 @@ var RelayClient = class {
       scope: namespaceId,
       op,
       authorAccount: this.config.authorAccount,
-      executor,
+      executor: executor.executorAccount,
+      executorKey: executor.executorKey,
       nonce: nonce2,
       notAfter: BigInt(Math.floor(Date.now() / 1e3)) + BigInt(ttl),
       signer
@@ -8436,18 +8474,21 @@ var RelayClient = class {
     return body.data;
   }
   /**
-   * The executor a warrant must name: the one the relay answered with, which a
-   * configured account must agree with. Remembered for later calls.
+   * The relay's answer, checked against a configured account.
+   * Decoded here so a relay naming no key is refused before a nonce is taken.
    */
   checkedExecutor(answered) {
+    const executor = {
+      executorAccount: hex(fromHex(answered.executorAccount ?? "", "the relay's executorAccount", 32)),
+      executorKey: hex(fromHex(answered.executorKey ?? "", "the relay's executorKey", 32))
+    };
     const configured = this.config.executorAccount;
-    if (configured && configured.toLowerCase() !== answered.toLowerCase()) {
+    if (configured && configured.toLowerCase() !== executor.executorAccount) {
       throw new Error(
-        `configured executorAccount ${configured} is not the relay's account ${answered}; a warrant naming it would be unspendable`
+        `configured executorAccount ${configured} is not the relay's account ${executor.executorAccount}; a warrant naming it would be unspendable`
       );
     }
-    this.executorAccount = answered;
-    return answered;
+    return executor;
   }
   /**
    * One request, waiting out a rate limit rather than failing the caller.
@@ -10789,19 +10830,10 @@ async function foundDelegatedNamespace(s, req = {}, deps = {}) {
   const relays = knownRelays(s).map((u) => u.replace(/\/+$/, ""));
   const relay = relays[0];
   if (!relay) throw new Error("no relay is known for this account, so there is nowhere to found a namespace");
-  const known = Object.entries(readRelayMap(s.account).namespaces).find(
-    ([, url]) => url.replace(/\/+$/, "") === relay
-  )?.[0];
-  const named = s.executorAccount && s.relayUrl && s.relayUrl.replace(/\/+$/, "") === relay ? s.executorAccount : null;
-  if (!named && !known) {
-    throw new Error(
-      "the executor account of this relay is not known: join a namespace on it first, or connect with the relay's executor account (the cloud shows it beside the relay)"
-    );
-  }
-  const executorAccount = named ?? (await client(s, relay, governanceNonce(relay, known), deps.fetch).describeGovernance(known)).executorAccount;
+  const executor = await foundingExecutor(s, relay, deps.fetch);
   let next = BigInt(Date.now());
   const founded = await client(s, relay, { next: async () => next++ }, deps.fetch).foundNamespace({
-    executorAccount,
+    executor,
     ...req.defaultCapabilities !== void 0 ? { defaultCapabilities: req.defaultCapabilities } : {},
     ...req.application ? { application: req.application } : {}
   });
@@ -10821,6 +10853,33 @@ async function foundDelegatedNamespace(s, req = {}, deps = {}) {
   };
   return { namespaceId: founded.namespaceId, teeEnabled: founded.teeEnabled, ...ha };
 }
+async function foundingExecutor(s, relay, fetch2) {
+  const named = s.executorAccount && s.relayUrl?.replace(/\/+$/, "") === relay ? s.executorAccount : null;
+  if (named) return { executorAccount: named, executorKey: await attestedNodeKey(relay) };
+  const known = Object.entries(readRelayMap(s.account).namespaces).find(
+    ([, url]) => url.replace(/\/+$/, "") === relay
+  )?.[0];
+  if (!known) {
+    throw new Error(
+      "the executor account of this relay is not known: join a namespace on it first, or connect with the relay's executor account (the cloud shows it beside the relay)"
+    );
+  }
+  const executorKey = await attestedNodeKey(relay);
+  const described = await client(s, relay, governanceNonce(relay, known), fetch2).describeGovernance(known);
+  if (described.executorKey?.toLowerCase() !== executorKey) {
+    throw new Error(
+      `the relay's discovery names signing key ${described.executorKey}, not the relay's node key ${executorKey}: refusing to found through it`
+    );
+  }
+  return { executorAccount: described.executorAccount, executorKey };
+}
+async function attestedNodeKey(relay) {
+  const key = await attemptRelayNodeKey(relay);
+  if (key.kind === "learned") return key.nodeKey;
+  throw new Error(
+    key.kind === "unavailable" ? "the relay's signing key could not be learned: its attestation did not answer, try again" : "the relay's attestation was refused, so founding through it is not possible (only a key from its operator, pinned with pinRelayNodeKey, can stand in)"
+  );
+}
 var HA_ACCOUNT_NOT_LINKED_MESSAGE = "link this account to your cloud user in the wallet so invitees can find this namespace";
 var HA_REFUSAL_MESSAGES = {
   account_not_linked: HA_ACCOUNT_NOT_LINKED_MESSAGE,