@ottochain/sdk 2.4.0 → 2.6.0

package/dist/cjs/apps/staked-pool/state-machines/staked-pool-base.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * The generic staked-pool BASE definition (`StakedPool`) — the reusable epoch-pool skeleton with a
+ * minimal pass-through `finalize` (authority settles; publishes a trivial result and an EMPTY in-consensus
+ * set, zero transfers). It is the lowest-common-denominator def; downstream apps should prefer a
+ * specialization (e.g. the oracle pool) that supplies real aggregation. Exposed for definition-validity
+ * round-tripping and as the explicit "base, unspecialized" instance.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stakedPoolBaseDef = void 0;
+const base_js_1 = require("../base.js");
+/** Minimal finalize: authority settles; no aggregation, empty entitlement set, zero transfers. */
+const baseFinalizeArm = {
+    from: 'COLLECTING',
+    to: 'SETTLED',
+    eventName: 'finalize',
+    guard: {
+        and: [
+            { in: [{ var: 'state.authority' }, { map: [{ var: 'proofs' }, { var: 'address' }] }] },
+            { '>=': [{ count: [{ var: 'state.submissions' }] }, { var: 'state.quorum' }] },
+        ],
+    },
+    effect: {
+        merge: [
+            { var: 'state' },
+            {
+                status: 'SETTLED',
+                inConsensus: [],
+                claimed: {},
+                result: {
+                    submissionCount: { count: [{ var: 'state.submissions' }] },
+                    epoch: { var: 'state.epoch' },
+                    finalizedAt: { var: '$ordinal' },
+                },
+            },
+        ],
+    },
+    dependencies: [],
+};
+exports.stakedPoolBaseDef = (0, base_js_1.makeStakedPoolDef)({
+    metadata: {
+        name: 'StakedPool',
+        type: 'base',
+        description: 'Generic staked-epoch-pool base (FORMING→COLLECTING→SETTLED→COLLECTING…→CLOSED): registry-gated ' +
+            'join with stake custody, append-only submissions, a state-resident claim entitlement ledger, and ' +
+            'one-whole-asset claim/withdraw transfers. Specialize `submit`/`finalize` for a concrete pool.',
+    },
+    finalize: baseFinalizeArm,
+});

package/dist/cjs/apps/staked-pool/state-machines/staked-pool-oracle.js

@@ -0,0 +1,131 @@
+"use strict";
+/**
+ * Oracle-pool specialization of the staked-pool base (`StakedPoolOracle`).
+ *
+ * `submit` appends a numeric datapoint `{ addr, value }` (the base default arm).
+ * `finalize` (COLLECTING→SETTLED) aggregates the array with an outlier-bounded mean and publishes the
+ * answer + the in-consensus address set — emitting ZERO asset transfers (the entitlement ledger is
+ * `inConsensus`; rewards are pulled per-claim via the base `claim_reward` arm).
+ *
+ * Aggregation (default `trimmedMean`):
+ *   1. vals    = map(submissions, .value)
+ *   2. trimmed = filter(submissions, value != min(vals) && value != max(vals))   — drop single min + single max
+ *   3. center  = sum(trimmed.value) / count(trimmed)                              — EXACT rational (no truncation)
+ *   4. kept    = filter(submissions, abs(value - center) <= outlierBound)         — the in-consensus set
+ *   5. answer  = sum(kept.value) / count(kept)
+ *
+ * CRITICAL JLVM SCOPING (verified against @constellation-network/metagraph-sdk-jlvm@1.8.0-rc.5):
+ *   - Inside a `map`/`filter` callback the data scope is the BARE element, BUT the outer `state.*` is
+ *     still readable (verified: `{cat:[addr,"|",{var:"state.epoch"}]}` reads epoch correctly).
+ *   - A `let`-bound name does NOT cross into a `map`/`filter` callback. So `center` is INLINED into the
+ *     `kept` predicate (it reads `state.submissions`, which IS visible) rather than `let`-hoisted — a
+ *     `let`-bound `center` resolves to null inside `filter`, evicting every submission (div-by-zero).
+ *   - A `reduce` with a MAP initial accumulator is rejected (`opReduce` requires `isPrimitive(init)`),
+ *     so the reward ledger is NOT a folded `{addr:int}` map — it is the `inConsensus` array (membership =
+ *     entitlement), consumed by `claim_reward` + a `claimed` dedup map.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stakedPoolOracleDef = void 0;
+exports.makeOraclePoolDef = makeOraclePoolDef;
+const base_js_1 = require("../base.js");
+const sum = (arr) => ({
+    reduce: [arr, { '+': [{ var: 'accumulator' }, { var: 'current' }] }, 0],
+});
+const meanOf = (arr) => ({ '/': [sum(arr), { count: [arr] }] });
+/** vals = map(submissions, .value) */
+const VALS = { map: [{ var: 'state.submissions' }, { get: [{ var: '' }, 'value'] }] };
+/**
+ * The aggregation `center` as a CLOSED expression over `state.submissions` (must be inlined into the
+ * `kept` filter — see file header). `trimmedMean` drops the single min + single max before averaging.
+ */
+function centerExpr(aggregation) {
+    if (aggregation === 'mean')
+        return meanOf(VALS);
+    const trimmed = {
+        filter: [
+            { var: 'state.submissions' },
+            {
+                and: [
+                    { '!==': [{ get: [{ var: '' }, 'value'] }, { min: [VALS] }] },
+                    { '!==': [{ get: [{ var: '' }, 'value'] }, { max: [VALS] }] },
+                ],
+            },
+        ],
+    };
+    const trimmedVals = { map: [trimmed, { get: [{ var: '' }, 'value'] }] };
+    return meanOf(trimmedVals);
+}
+/** finalize COLLECTING→SETTLED — publish answer + inConsensus; ZERO asset transfers. */
+function finalizeArm(aggregation) {
+    const center = centerExpr(aggregation);
+    // kept = the in-consensus submissions; `center` is INLINED (visible state.submissions inside filter).
+    const kept = {
+        filter: [
+            { var: 'state.submissions' },
+            {
+                '<=': [{ abs: [{ '-': [{ get: [{ var: '' }, 'value'] }, center] }] }, { var: 'state.outlierBound' }],
+            },
+        ],
+    };
+    const keptVals = { map: [kept, { get: [{ var: '' }, 'value'] }] };
+    const inConsensus = { map: [kept, { get: [{ var: '' }, 'addr'] }] };
+    return {
+        from: 'COLLECTING',
+        to: 'SETTLED',
+        eventName: 'finalize',
+        // Authority finalizes once quorum is met AND the window has elapsed.
+        guard: {
+            and: [
+                { in: [{ var: 'state.authority' }, { map: [{ var: 'proofs' }, { var: 'address' }] }] },
+                { '>=': [{ count: [{ var: 'state.submissions' }] }, { var: 'state.quorum' }] },
+                {
+                    '>=': [{ var: '$ordinal' }, { '+': [{ var: 'state.epochStartedAt' }, { var: 'state.epochLength' }] }],
+                },
+            ],
+        },
+        // ZERO _transferAsset: publish result + record the in-consensus entitlement set + reset claimed.
+        effect: {
+            merge: [
+                { var: 'state' },
+                {
+                    status: 'SETTLED',
+                    inConsensus,
+                    claimed: {},
+                    result: {
+                        value: meanOf(keptVals),
+                        epoch: { var: 'state.epoch' },
+                        finalizedAt: { var: '$ordinal' },
+                    },
+                },
+            ],
+        },
+        dependencies: [],
+    };
+}
+/** Build the oracle-pool definition. `outlierPenalty` is soft-only (no-credit for outliers); hard slash is v2. */
+function makeOraclePoolDef(options = {}) {
+    const aggregation = options.aggregation ?? 'trimmedMean';
+    return (0, base_js_1.makeStakedPoolDef)({
+        metadata: {
+            name: 'StakedPoolOracle',
+            type: 'oraclePool',
+            description: 'Reputation-gated staked oracle pool: participants stake + submit numeric datapoints; finalize ' +
+                'publishes an outlier-bounded (default trimmed-mean) consensus answer and credits the in-consensus ' +
+                'set as a claim entitlement (zero finalize-time transfers); a consumer reads the published value ' +
+                'cross-fiber via an epoch-pinned depInState(SETTLED) gate.',
+        },
+        finalize: finalizeArm(aggregation),
+        extraCreateProperties: {
+            rewardPolicy: {
+                type: 'string',
+                description: 'Asset policy of the shared fungible reward token.',
+                immutable: true,
+            },
+        },
+        extraStateProperties: {
+            rewardPolicy: { type: 'string', immutable: true },
+        },
+    });
+}
+/** Default oracle-pool definition (trimmed-mean). */
+exports.stakedPoolOracleDef = makeOraclePoolDef();

package/dist/cjs/generated/google/protobuf/struct.js

@@ -1,7 +1,7 @@
 "use strict";
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
-//   protoc-gen-ts_proto  v2.11.5
+//   protoc-gen-ts_proto  v2.11.8
 //   protoc               unknown
 // source: google/protobuf/struct.proto
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/generated/google/protobuf/timestamp.js

@@ -1,7 +1,7 @@
 "use strict";
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
-//   protoc-gen-ts_proto  v2.11.5
+//   protoc-gen-ts_proto  v2.11.8
 //   protoc               unknown
 // source: google/protobuf/timestamp.proto
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/generated/ottochain/apps/contracts/v1/contract.js

@@ -1,7 +1,7 @@
 "use strict";
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
-//   protoc-gen-ts_proto  v2.11.5
+//   protoc-gen-ts_proto  v2.11.8
 //   protoc               unknown
 // source: ottochain/apps/contracts/v1/contract.proto
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/generated/ottochain/apps/corporate/v1/corporate.js

@@ -1,7 +1,7 @@
 "use strict";
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
-//   protoc-gen-ts_proto  v2.11.5
+//   protoc-gen-ts_proto  v2.11.8
 //   protoc               unknown
 // source: ottochain/apps/corporate/v1/corporate.proto
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/generated/ottochain/apps/governance/v1/governance.js

@@ -1,7 +1,7 @@
 "use strict";
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
-//   protoc-gen-ts_proto  v2.11.5
+//   protoc-gen-ts_proto  v2.11.8
 //   protoc               unknown
 // source: ottochain/apps/governance/v1/governance.proto
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/generated/ottochain/apps/identity/v1/attestation.js

@@ -1,7 +1,7 @@
 "use strict";
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
-//   protoc-gen-ts_proto  v2.11.5
+//   protoc-gen-ts_proto  v2.11.8
 //   protoc               unknown
 // source: ottochain/apps/identity/v1/attestation.proto
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/generated/ottochain/apps/identity/v1/identity.js

@@ -1,7 +1,7 @@
 "use strict";
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
-//   protoc-gen-ts_proto  v2.11.5
+//   protoc-gen-ts_proto  v2.11.8
 //   protoc               unknown
 // source: ottochain/apps/identity/v1/identity.proto
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/generated/ottochain/apps/markets/v1/market.js

@@ -1,7 +1,7 @@
 "use strict";
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
-//   protoc-gen-ts_proto  v2.11.5
+//   protoc-gen-ts_proto  v2.11.8
 //   protoc               unknown
 // source: ottochain/apps/markets/v1/market.proto
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/generated/ottochain/v1/common.js

@@ -1,7 +1,7 @@
 "use strict";
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
-//   protoc-gen-ts_proto  v2.11.5
+//   protoc-gen-ts_proto  v2.11.8
 //   protoc               unknown
 // source: ottochain/v1/common.proto
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/generated/ottochain/v1/fiber.js

@@ -1,7 +1,7 @@
 "use strict";
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
-//   protoc-gen-ts_proto  v2.11.5
+//   protoc-gen-ts_proto  v2.11.8
 //   protoc               unknown
 // source: ottochain/v1/fiber.proto
 Object.defineProperty(exports, "__esModule", { value: true });
@@ -433,7 +433,7 @@ exports.StateMachineDefinition = {
     },
 };
 function createBaseEmittedEvent() {
-    return { name: "", data: undefined, destination: undefined };
+    return { name: "", data: undefined, destination: undefined, emitterFiberId: "", emissionIndex: 0 };
 }
 exports.EmittedEvent = {
     encode(message, writer = new wire_1.BinaryWriter()) {
@@ -446,6 +446,12 @@ exports.EmittedEvent = {
         if (message.destination !== undefined) {
             writer.uint32(26).string(message.destination);
         }
+        if (message.emitterFiberId !== "") {
+            writer.uint32(34).string(message.emitterFiberId);
+        }
+        if (message.emissionIndex !== 0) {
+            writer.uint32(40).int32(message.emissionIndex);
+        }
         return writer;
     },
     decode(input, length) {
@@ -476,6 +482,20 @@ exports.EmittedEvent = {
                     message.destination = reader.string();
                     continue;
                 }
+                case 4: {
+                    if (tag !== 34) {
+                        break;
+                    }
+                    message.emitterFiberId = reader.string();
+                    continue;
+                }
+                case 5: {
+                    if (tag !== 40) {
+                        break;
+                    }
+                    message.emissionIndex = reader.int32();
+                    continue;
+                }
             }
             if ((tag & 7) === 4 || tag === 0) {
                 break;
@@ -489,6 +509,16 @@ exports.EmittedEvent = {
             name: isSet(object.name) ? globalThis.String(object.name) : "",
             data: isSet(object?.data) ? object.data : undefined,
             destination: isSet(object.destination) ? globalThis.String(object.destination) : undefined,
+            emitterFiberId: isSet(object.emitterFiberId)
+                ? globalThis.String(object.emitterFiberId)
+                : isSet(object.emitter_fiber_id)
+                    ? globalThis.String(object.emitter_fiber_id)
+                    : "",
+            emissionIndex: isSet(object.emissionIndex)
+                ? globalThis.Number(object.emissionIndex)
+                : isSet(object.emission_index)
+                    ? globalThis.Number(object.emission_index)
+                    : 0,
         };
     },
     toJSON(message) {
@@ -502,6 +532,12 @@ exports.EmittedEvent = {
         if (message.destination !== undefined) {
             obj.destination = message.destination;
         }
+        if (message.emitterFiberId !== "") {
+            obj.emitterFiberId = message.emitterFiberId;
+        }
+        if (message.emissionIndex !== 0) {
+            obj.emissionIndex = Math.round(message.emissionIndex);
+        }
         return obj;
     },
     create(base) {
@@ -512,6 +548,8 @@ exports.EmittedEvent = {
         message.name = object.name ?? "";
         message.data = object.data ?? undefined;
         message.destination = object.destination ?? undefined;
+        message.emitterFiberId = object.emitterFiberId ?? "";
+        message.emissionIndex = object.emissionIndex ?? 0;
         return message;
     },
 };

package/dist/cjs/generated/ottochain/v1/messages.js

@@ -1,7 +1,7 @@
 "use strict";
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
-//   protoc-gen-ts_proto  v2.11.5
+//   protoc-gen-ts_proto  v2.11.8
 //   protoc               unknown
 // source: ottochain/v1/messages.proto
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/generated/ottochain/v1/records.js

@@ -1,7 +1,7 @@
 "use strict";
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
-//   protoc-gen-ts_proto  v2.11.5
+//   protoc-gen-ts_proto  v2.11.8
 //   protoc               unknown
 // source: ottochain/v1/records.proto
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/index.js

@@ -31,8 +31,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.signerIsNotParty = exports.signerInSet = exports.signerIsAnyParty = exports.signerIsParty = exports.defineFiberApp = exports.toProtoDefinition = exports.OttoMetagraphClient = exports.assert = exports.safeParse = exports.validateKeyPair = exports.validateAddress = exports.validatePublicKey = exports.validatePrivateKey = exports.validate = exports.CompleteContractRequestSchema = exports.AcceptContractRequestSchema = exports.ProposeContractRequestSchema = exports.ContractTermsSchema = exports.PlatformLinkSchema = exports.AgentIdentityRegistrationSchema = exports.TransferParamsSchema = exports.CurrencyTransactionSchema = exports.CurrencyTransactionValueSchema = exports.TransactionReferenceSchema = exports.SignedSchema = exports.SignatureProofSchema = exports.KeyPairSchema = exports.PublicKeySchema = exports.PrivateKeySchema = exports.DagAddressSchema = exports.wrapError = exports.isErrorCode = exports.ErrorCode = exports.TransactionError = exports.SigningError = exports.ValidationError = exports.NetworkError = exports.OttoChainError = exports.GENESIS_MANIFEST_VERSION = exports.buildGenesisManifest = exports.dropNulls = exports.MetagraphNetworkError = exports.HttpClient = exports.createMetagraphClient = exports.MetagraphClient = exports.batchSign = exports.addSignature = exports.createSignedObject = exports.signDataUpdate = exports.verify = void 0;
-exports.SHIELDED_POOL_STATE = exports.shieldApp = exports.setDependencyActive = exports.addDependency = exports.depInState = exports.signerHasRoleVia = exports.signerHasReputationVia = exports.signerHasRole = exports.signerHasReputation = exports.actorHasEntry = exports.actorInSet = exports.actorIsSigner = exports.assetSignerIs = exports.signerHasEntry = void 0;
+exports.IMMUTABLE_POLICY = exports.immutable = exports.unconstrained = exports.constrained = exports.defineFiberApp = exports.toProtoDefinition = exports.OttoMetagraphClient = exports.assert = exports.safeParse = exports.validateKeyPair = exports.validateAddress = exports.validatePublicKey = exports.validatePrivateKey = exports.validate = exports.CompleteContractRequestSchema = exports.AcceptContractRequestSchema = exports.ProposeContractRequestSchema = exports.ContractTermsSchema = exports.PlatformLinkSchema = exports.AgentIdentityRegistrationSchema = exports.TransferParamsSchema = exports.CurrencyTransactionSchema = exports.CurrencyTransactionValueSchema = exports.TransactionReferenceSchema = exports.SignedSchema = exports.SignatureProofSchema = exports.KeyPairSchema = exports.PublicKeySchema = exports.PrivateKeySchema = exports.DagAddressSchema = exports.wrapError = exports.isErrorCode = exports.ErrorCode = exports.TransactionError = exports.SigningError = exports.ValidationError = exports.NetworkError = exports.OttoChainError = exports.GENESIS_MANIFEST_VERSION = exports.buildGenesisManifest = exports.dropNulls = exports.MetagraphNetworkError = exports.HttpClient = exports.createMetagraphClient = exports.MetagraphClient = exports.batchSign = exports.addSignature = exports.createSignedObject = exports.signDataUpdate = exports.verify = void 0;
+exports.SHIELDED_POOL_STATE = exports.shieldApp = exports.RESERVED_EFFECT_KEYS = exports.toWallet = exports.toFiber = exports.scriptCall = exports.emit = exports.spawn = exports.triggers = exports.transferAsset = exports.setDependencyActive = exports.addDependency = exports.actorNotInArray = exports.depInState = exports.signerHasRoleVia = exports.signerHasReputationVia = exports.signerHasRole = exports.signerHasReputation = exports.actorHasEntry = exports.actorInSet = exports.actorIsSigner = exports.assetSignerIs = exports.signerHasEntry = exports.signerIsNotParty = exports.signerInSet = exports.signerIsAnyParty = exports.signerIsParty = exports.projectFiberPolicy = void 0;
 // ─── Core metagraph SDK ───────────────────────────────────────────────────────
 // Consumers can also import directly from '@constellation-network/metagraph-sdk'
 __exportStar(require("@constellation-network/metagraph-sdk"), exports);
@@ -112,6 +112,13 @@ Object.defineProperty(exports, "OttoMetagraphClient", { enumerable: true, get: f
 var fiber_app_js_1 = require("./schema/fiber-app.js");
 Object.defineProperty(exports, "toProtoDefinition", { enumerable: true, get: function () { return fiber_app_js_1.toProtoDefinition; } });
 Object.defineProperty(exports, "defineFiberApp", { enumerable: true, get: function () { return fiber_app_js_1.defineFiberApp; } });
+// Fiber policy (the fiber constitution): mirrors the chain ADT
+// `FiberPolicy = Unconstrained | Immutable | Constrained(<dials>)`.
+Object.defineProperty(exports, "constrained", { enumerable: true, get: function () { return fiber_app_js_1.constrained; } });
+Object.defineProperty(exports, "unconstrained", { enumerable: true, get: function () { return fiber_app_js_1.unconstrained; } });
+Object.defineProperty(exports, "immutable", { enumerable: true, get: function () { return fiber_app_js_1.immutable; } });
+Object.defineProperty(exports, "IMMUTABLE_POLICY", { enumerable: true, get: function () { return fiber_app_js_1.IMMUTABLE_POLICY; } });
+Object.defineProperty(exports, "projectFiberPolicy", { enumerable: true, get: function () { return fiber_app_js_1.projectFiberPolicy; } });
 // Canonical authorization-guard builders (bind to verified signers, not attacker payloads).
 var guards_js_1 = require("./schema/guards.js");
 Object.defineProperty(exports, "signerIsParty", { enumerable: true, get: function () { return guards_js_1.signerIsParty; } });
@@ -132,10 +139,21 @@ Object.defineProperty(exports, "signerHasReputationVia", { enumerable: true, get
 Object.defineProperty(exports, "signerHasRoleVia", { enumerable: true, get: function () { return guards_js_1.signerHasRoleVia; } });
 // cross-fiber state gate (runtime-bound dependency, #24) — replaces object-form deps
 Object.defineProperty(exports, "depInState", { enumerable: true, get: function () { return guards_js_1.depInState; } });
-// Reserved EFFECT-directive builders (dynamic dependencies, #24).
+// append-only-array dedup: actor not yet present in an array of records
+Object.defineProperty(exports, "actorNotInArray", { enumerable: true, get: function () { return guards_js_1.actorNotInArray; } });
+// Reserved EFFECT-directive builders (dynamic dependencies, #24; whole-asset custody moves;
+// cross-fiber triggers, spawn, emit + recipient-intent helpers; the reserved-key set for validators).
 var effects_js_1 = require("./schema/effects.js");
 Object.defineProperty(exports, "addDependency", { enumerable: true, get: function () { return effects_js_1.addDependency; } });
 Object.defineProperty(exports, "setDependencyActive", { enumerable: true, get: function () { return effects_js_1.setDependencyActive; } });
+Object.defineProperty(exports, "transferAsset", { enumerable: true, get: function () { return effects_js_1.transferAsset; } });
+Object.defineProperty(exports, "triggers", { enumerable: true, get: function () { return effects_js_1.triggers; } });
+Object.defineProperty(exports, "spawn", { enumerable: true, get: function () { return effects_js_1.spawn; } });
+Object.defineProperty(exports, "emit", { enumerable: true, get: function () { return effects_js_1.emit; } });
+Object.defineProperty(exports, "scriptCall", { enumerable: true, get: function () { return effects_js_1.scriptCall; } });
+Object.defineProperty(exports, "toFiber", { enumerable: true, get: function () { return effects_js_1.toFiber; } });
+Object.defineProperty(exports, "toWallet", { enumerable: true, get: function () { return effects_js_1.toWallet; } });
+Object.defineProperty(exports, "RESERVED_EFFECT_KEYS", { enumerable: true, get: function () { return effects_js_1.RESERVED_EFFECT_KEYS; } });
 // ─── Privacy: shield any fiber app into a zk-jlvm-shielded private-state pool ──
 // See docs/design/zk-private-contract-state-rfc.md.
 var shield_app_js_1 = require("./privacy/shield-app.js");

package/dist/cjs/ottochain/genesis-manifest.js

@@ -149,6 +149,12 @@ function toWireDefinition(def) {
         })),
         // Strip FiberAppMetadata — the chain's `metadata` is `Option[JsonLogicValue]`.
         metadata: null,
+        // Carry the fiber constitution through verbatim from the shared projector: PRESENT for
+        // `Constrained` (a bare object of set dials) and `Immutable` (the bare string
+        // `"Immutable"`), ABSENT for `Unconstrained`. The `policy` key is only set here when
+        // `toProtoDefinition` emitted one, so an unconstrained def keeps NO `policy` key
+        // (omit-on-unconstrained wire parity).
+        ...(proto.policy !== undefined ? { policy: proto.policy } : {}),
     };
 }
 // ─── Builder ──────────────────────────────────────────────────────────────────

package/dist/cjs/ottochain/metagraph-client.js

@@ -119,7 +119,11 @@ class MetagraphClient {
     // -------------------------------------------------------------------------
     // Registry, audit, state-proofs, fee estimates (ML0 /data-application/v1/*)
     // -------------------------------------------------------------------------
-    /** Get the metagraph version string. */
+    /**
+     * Get the node's service identity + build metadata. The chain's `GET …/version` returns a
+     * `VersionInfo` OBJECT (`{ service, version, name, scalaVersion, sbtVersion, gitCommit, buildTime,
+     * tessellationVersion }`) — chain `ServiceMeta.scala` — NOT a bare string.
+     */
     async getVersion() {
         return this.ml0.get('/data-application/v1/version');
     }
@@ -165,15 +169,55 @@ class MetagraphClient {
     async getAssetStateProof(assetId, field) {
         return this.ml0.get(`/data-application/v1/assets/${assetId}/state-proof?field=${encodeURIComponent(field)}`);
     }
-    /** Estimate the fee/gas for a transition event on a state-machine fiber. */
+    /**
+     * Estimate the fee/gas for a transition event on a state-machine fiber. Returns a
+     * {@link TransitionFeeEstimate} (`{ fiberId, currentState, event, gasEstimate, opCount, maxDepth,
+     * candidateTransitions, note }`) — chain `FeeEstimates.scala`.
+     */
     async estimateTransitionFee(fiberId, eventName) {
         return this.ml0.get(`/data-application/v1/state-machines/${fiberId}/estimate-fee?event=${encodeURIComponent(eventName)}`);
     }
-    /** Estimate the fee/gas for invoking a script fiber. */
+    /**
+     * Estimate the fee/gas for invoking a script fiber. Returns a {@link ScriptFeeEstimate}
+     * (`{ scriptId, gasEstimate, opCount, maxDepth, note }`) — chain `FeeEstimates.scala`.
+     */
     async estimateScriptFee(fiberId) {
         return this.ml0.get(`/data-application/v1/scripts/${fiberId}/estimate-fee`);
     }
     // -------------------------------------------------------------------------
+    // Webhook subscriptions (ML0 /data-application/v1/webhooks/*)
+    // -------------------------------------------------------------------------
+    /**
+     * Subscribe a callback URL to snapshot-notification webhooks.
+     *
+     * `POST …/webhooks/subscribe` with `SubscribeRequest { callbackUrl, secret? }`; the chain replies
+     * `201 Created` with `SubscribeResponse { id, callbackUrl, createdAt }`. Chain: `ML0Routes.scala`
+     * (`webhook.subscribe`) + `webhooks/Subscriber.scala`.
+     */
+    async subscribeWebhook(request) {
+        return this.ml0.post('/data-application/v1/webhooks/subscribe', request);
+    }
+    /**
+     * Unsubscribe a webhook by its subscriber id.
+     *
+     * `DELETE …/webhooks/subscribe/{id}` → `204 No Content` (empty body) on success, or `404` if the id is
+     * unknown. Chain: `ML0Routes.scala` (`webhook.unsubscribe`). The vendored `HttpClient` exposes only
+     * `get`/`post`, so this reuses its shared private `request` helper — same `NetworkError`/timeout
+     * handling as every other call — to issue the DELETE.
+     */
+    async unsubscribeWebhook(id) {
+        await this.ml0.request('DELETE', `/data-application/v1/webhooks/subscribe/${encodeURIComponent(id)}`);
+    }
+    /**
+     * List the current webhook subscribers (secrets are redacted server-side).
+     *
+     * `GET …/webhooks/subscribers` → `SubscriberList { subscribers: Subscriber[] }`. Chain:
+     * `ML0Routes.scala` (`webhook.list`) + `webhooks/Subscriber.scala`.
+     */
+    async listWebhookSubscribers() {
+        return this.ml0.get('/data-application/v1/webhooks/subscribers');
+    }
+    // -------------------------------------------------------------------------
     // Framework snapshot endpoints (ML0 /snapshots/*)
     // -------------------------------------------------------------------------
     /**
@@ -247,7 +291,9 @@ class MetagraphClient {
                 try {
                     onError(cbErr instanceof Error ? cbErr : new Error(String(cbErr)));
                 }
-                catch { /* ignore */ }
+                catch {
+                    /* ignore */
+                }
             }
         };
         const poll = async () => {
@@ -264,7 +310,9 @@ class MetagraphClient {
                 try {
                     onError(err instanceof Error ? err : new Error(String(err)));
                 }
-                catch { /* ignore */ }
+                catch {
+                    /* ignore */
+                }
                 if (active)
                     setTimeout(poll, intervalMs);
                 return;
@@ -297,7 +345,9 @@ class MetagraphClient {
         // callers can unsubscribe before the first poll runs, and each
         // jest.runOnlyPendingTimersAsync() advances exactly one poll cycle.
         setTimeout(poll, 0);
-        return () => { active = false; };
+        return () => {
+            active = false;
+        };
     }
     /**
      * Wait for a fiber to reach a specific state, with an optional timeout.
@@ -395,14 +445,16 @@ class MetagraphClient {
             let settled = false;
             let pending = this.dl1Clients.length;
             for (const client of this.dl1Clients) {
-                client.post('/data', request).then((result) => { if (!settled) {
-                    settled = true;
-                    resolve(result);
-                } }, (err) => {
+                client.post('/data', request).then((result) => {
+                    if (!settled) {
+                        settled = true;
+                        resolve(result);
+                    }
+                }, (err) => {
                     errors.push(err instanceof Error ? err : new Error(String(err)));
                     pending--;
                     if (pending === 0 && !settled) {
-                        reject(new Error('All DL1 nodes failed: ' + errors.map(e => e.message).join('; ')));
+                        reject(new Error('All DL1 nodes failed: ' + errors.map((e) => e.message).join('; ')));
                     }
                 });
             }

package/dist/cjs/ottochain/snapshot.js

@@ -90,8 +90,7 @@ function getLogsForFiber(onChain, fiberId) {
  * @returns Array of EventReceipt entries
  */
 function getEventReceipts(onChain, fiberId) {
-    return getLogsForFiber(onChain, fiberId)
-        .filter((entry) => 'eventName' in entry && 'success' in entry);
+    return getLogsForFiber(onChain, fiberId).filter((entry) => 'eventName' in entry && 'success' in entry);
 }
 /**
  * Get ScriptInvocation log entries for a specific fiber.
@@ -104,6 +103,5 @@ function getEventReceipts(onChain, fiberId) {
  * @returns Array of ScriptInvocation entries
  */
 function getScriptInvocations(onChain, fiberId) {
-    return getLogsForFiber(onChain, fiberId)
-        .filter((entry) => 'method' in entry && 'result' in entry);
+    return getLogsForFiber(onChain, fiberId).filter((entry) => 'method' in entry && 'result' in entry);
 }

package/dist/cjs/ottochain/transaction.js

@@ -15,6 +15,8 @@ exports.createAssetPolicyPayload = createAssetPolicyPayload;
 exports.createMintAssetPayload = createMintAssetPayload;
 exports.createApplyMorphismPayload = createApplyMorphismPayload;
 exports.createAuthorizeComposePayload = createAuthorizeComposePayload;
+exports.createPublishMachineVersionPayload = createPublishMachineVersionPayload;
+exports.createUpgradeFiberPayload = createUpgradeFiberPayload;
 exports.signTransaction = signTransaction;
 exports.createDataTransactionRequest = createDataTransactionRequest;
 exports.addTransactionSignature = addTransactionSignature;
@@ -172,6 +174,14 @@ function createApplyMorphismPayload(params) {
 function createAuthorizeComposePayload(params) {
     return { AuthorizeCompose: params };
 }
+/** Wrap a {@link PublishMachineVersion} (create-or-append a STATE-MACHINE registry version). */
+function createPublishMachineVersionPayload(params) {
+    return { PublishMachineVersion: params };
+}
+/** Wrap an {@link UpgradeFiber} (re-pin a fiber to another registered version of the SAME package). */
+function createUpgradeFiberPayload(params) {
+    return { UpgradeFiber: params };
+}
 /**
  * Sign a transaction payload for self-signed mode.
  *