@calimero-network/mero-js 24.2.0 → 24.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -230,16 +230,18 @@ export declare class AdminApiClient {
230
230
  * Ask what this node can do for a member in `contextId`, before they sign
231
231
  * anything.
232
232
  *
233
- * The two facts {@link performIntent} needs and a client cannot derive: whose
234
- * account and key go in the warrant's `executor` and `executor_key`, and
235
- * whether this node holds `CAN_AUTHOR_ON_BEHALF` on the owning group.
233
+ * The facts {@link performIntent} needs and a client cannot derive: whose
234
+ * account and key go in the warrant's `executor` and `executor_key`, which
235
+ * release it pins, and whether this node holds `CAN_AUTHOR_ON_BEHALF` on the
236
+ * owning group.
236
237
  * `canAuthorOnBehalf: false` comes back as an answer rather than an error, as
237
238
  * it is the default state of every context, so a caller can say "an admin of
238
239
  * `groupId` must grant it to `executorAccount`" instead of presenting a
239
240
  * warrant that will be refused after the author has spent a nonce on it.
240
241
  *
241
- * `404` means the context belongs to no group, or this node holds no account
242
- * yet; either way it can be named as no warrant's executor.
242
+ * `404` means the context belongs to no group, this node holds no account or
243
+ * identity in it yet, or its group names no release yet; no warrant can be
244
+ * spent here until that changes.
243
245
  *
244
246
  * For a caller with no credential on the node at all — a browser tab holding
245
247
  * one signing key — use `RelayClient`, which reads this same route on a node
@@ -562,16 +562,18 @@ export class AdminApiClient {
562
562
  * Ask what this node can do for a member in `contextId`, before they sign
563
563
  * anything.
564
564
  *
565
- * The two facts {@link performIntent} needs and a client cannot derive: whose
566
- * account and key go in the warrant's `executor` and `executor_key`, and
567
- * whether this node holds `CAN_AUTHOR_ON_BEHALF` on the owning group.
565
+ * The facts {@link performIntent} needs and a client cannot derive: whose
566
+ * account and key go in the warrant's `executor` and `executor_key`, which
567
+ * release it pins, and whether this node holds `CAN_AUTHOR_ON_BEHALF` on the
568
+ * owning group.
568
569
  * `canAuthorOnBehalf: false` comes back as an answer rather than an error, as
569
570
  * it is the default state of every context, so a caller can say "an admin of
570
571
  * `groupId` must grant it to `executorAccount`" instead of presenting a
571
572
  * warrant that will be refused after the author has spent a nonce on it.
572
573
  *
573
- * `404` means the context belongs to no group, or this node holds no account
574
- * yet; either way it can be named as no warrant's executor.
574
+ * `404` means the context belongs to no group, this node holds no account or
575
+ * identity in it yet, or its group names no release yet; no warrant can be
576
+ * spent here until that changes.
575
577
  *
576
578
  * For a caller with no credential on the node at all — a browser tab holding
577
579
  * one signing key — use `RelayClient`, which reads this same route on a node
@@ -375,6 +375,25 @@ export interface Namespace {
375
375
  * this is absent only on nodes that predate it.
376
376
  */
377
377
  founding?: NamespaceFounding;
378
+ /**
379
+ * Group ops this node logged but holds unapplied, because their group's
380
+ * history is sealed under a key it lacks: their effects are missing here until
381
+ * that key arrives. What explains a subgroup that looks stale on this node and
382
+ * current on another. Absent when nothing is held, and on nodes that predate it.
383
+ */
384
+ heldOps?: NamespaceHeldOps;
385
+ }
386
+ /** The group ops a namespace holds unapplied on the node that answered. */
387
+ export interface NamespaceHeldOps {
388
+ ops: NamespaceHeldOp[];
389
+ /** Holds past the node's listing bound, counted but not listed. */
390
+ untracked: number;
391
+ }
392
+ export interface NamespaceHeldOp {
393
+ /** Hex id of the namespace op in the governance DAG. */
394
+ deltaId: string;
395
+ /** Hex id of the group whose sealed history it waits on. */
396
+ groupId: string;
378
397
  }
379
398
  /**
380
399
  * The founder and salt a namespace id was derived from:
@@ -475,10 +494,10 @@ export interface PerformIntentResponseData {
475
494
  * What a node says about running intents in one context — read before minting a
476
495
  * warrant, not after being refused one.
477
496
  *
478
- * Every input to a warrant is something the author already holds except two:
479
- * whose account and key go in `executor` and `executor_key`, and whether that
480
- * node may act here at all. Both belong to the node, so both are answered here,
481
- * on the path the intent will be presented to.
497
+ * Every input to a warrant is something the author already holds except three:
498
+ * whose account and key go in `executor` and `executor_key`, which release it
499
+ * pins, and whether that node may act here at all. The node knows them, so they
500
+ * are answered here, on the path the intent will be presented to.
482
501
  *
483
502
  * Reading it first is what lets a client fail before signing. A warrant spends a
484
503
  * nonce from a monotonic per-device sequence, and one naming the wrong executor
@@ -504,6 +523,14 @@ export interface IntentRelayInfo {
504
523
  canAuthorOnBehalf: boolean;
505
524
  /** The group whose admin must grant that capability, 64 hex. */
506
525
  groupId: string;
526
+ /**
527
+ * The blob id of the release that group names, 64 hex: what a warrant for this
528
+ * node must pin as `release_bytecode_id`. The route answers 404 while the group
529
+ * names no release.
530
+ */
531
+ releaseBytecodeId: string;
532
+ /** That release's semver, for the warrant's `release_version`. */
533
+ releaseVersion: string;
507
534
  }
508
535
  export interface NodeIdentity {
509
536
  /**