@ottochain/sdk 2.4.0 → 2.5.0

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

@@ -0,0 +1,127 @@
+/**
+ * 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.
+ */
+import { makeStakedPoolDef } from '../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. */
+export function makeOraclePoolDef(options = {}) {
+    const aggregation = options.aggregation ?? 'trimmedMean';
+    return 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). */
+export const stakedPoolOracleDef = makeOraclePoolDef();

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

@@ -1,6 +1,6 @@
 // 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
 /* eslint-disable */

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

@@ -1,6 +1,6 @@
 // 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
 /* eslint-disable */

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

@@ -1,6 +1,6 @@
 // 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
 /* eslint-disable */

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

@@ -1,6 +1,6 @@
 // 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
 /* eslint-disable */

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

@@ -1,6 +1,6 @@
 // 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
 /* eslint-disable */

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

@@ -1,6 +1,6 @@
 // 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
 /* eslint-disable */

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

@@ -1,6 +1,6 @@
 // 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
 /* eslint-disable */

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

@@ -1,6 +1,6 @@
 // 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
 /* eslint-disable */

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

@@ -1,6 +1,6 @@
 // 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
 /* eslint-disable */

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

@@ -1,6 +1,6 @@
 // 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
 /* eslint-disable */
@@ -427,7 +427,7 @@ export const StateMachineDefinition = {
     },
 };
 function createBaseEmittedEvent() {
-    return { name: "", data: undefined, destination: undefined };
+    return { name: "", data: undefined, destination: undefined, emitterFiberId: "", emissionIndex: 0 };
 }
 export const EmittedEvent = {
     encode(message, writer = new BinaryWriter()) {
@@ -440,6 +440,12 @@ export const 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) {
@@ -470,6 +476,20 @@ export const 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;
@@ -483,6 +503,16 @@ export const 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) {
@@ -496,6 +526,12 @@ export const 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) {
@@ -506,6 +542,8 @@ export const 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/esm/generated/ottochain/v1/messages.js

@@ -1,6 +1,6 @@
 // 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
 /* eslint-disable */

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

@@ -1,6 +1,6 @@
 // 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
 /* eslint-disable */

package/dist/esm/index.js

@@ -49,7 +49,10 @@ validate, validatePrivateKey, validatePublicKey, validateAddress, validateKeyPai
 // ─── OttoChain metagraph client ───────────────────────────────────────────────
 export { MetagraphClient as OttoMetagraphClient } from './ottochain/metagraph-client.js';
 // Proto definition helper
-export { toProtoDefinition, defineFiberApp, } from './schema/fiber-app.js';
+export { toProtoDefinition, defineFiberApp, 
+// Fiber policy (the fiber constitution): mirrors the chain ADT
+// `FiberPolicy = Unconstrained | Immutable | Constrained(<dials>)`.
+constrained, unconstrained, immutable, IMMUTABLE_POLICY, projectFiberPolicy, } from './schema/fiber-app.js';
 // Canonical authorization-guard builders (bind to verified signers, not attacker payloads).
 export { signerIsParty, signerIsAnyParty, signerInSet, signerIsNotParty, signerHasEntry, assetSignerIs, 
 // effect-key coupling (S1): bind a dynamic map key to a verified signer
@@ -59,9 +62,12 @@ signerHasReputation, signerHasRole,
 // identity-registry reads (runtime-bound registry id, #24)
 signerHasReputationVia, signerHasRoleVia, 
 // cross-fiber state gate (runtime-bound dependency, #24) — replaces object-form deps
-depInState, } from './schema/guards.js';
-// Reserved EFFECT-directive builders (dynamic dependencies, #24).
-export { addDependency, setDependencyActive } from './schema/effects.js';
+depInState, 
+// append-only-array dedup: actor not yet present in an array of records
+actorNotInArray, } from './schema/guards.js';
+// 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).
+export { addDependency, setDependencyActive, transferAsset, triggers, spawn, emit, toFiber, toWallet, RESERVED_EFFECT_KEYS, } from './schema/effects.js';
 // ─── Privacy: shield any fiber app into a zk-jlvm-shielded private-state pool ──
 // See docs/design/zk-private-contract-state-rfc.md.
 export { shieldApp, SHIELDED_POOL_STATE } from './privacy/shield-app.js';

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

@@ -145,6 +145,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/esm/ottochain/metagraph-client.js

@@ -244,7 +244,9 @@ export class MetagraphClient {
                 try {
                     onError(cbErr instanceof Error ? cbErr : new Error(String(cbErr)));
                 }
-                catch { /* ignore */ }
+                catch {
+                    /* ignore */
+                }
             }
         };
         const poll = async () => {
@@ -261,7 +263,9 @@ export class MetagraphClient {
                 try {
                     onError(err instanceof Error ? err : new Error(String(err)));
                 }
-                catch { /* ignore */ }
+                catch {
+                    /* ignore */
+                }
                 if (active)
                     setTimeout(poll, intervalMs);
                 return;
@@ -294,7 +298,9 @@ export 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.
@@ -392,14 +398,16 @@ export 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/esm/ottochain/snapshot.js

@@ -81,8 +81,7 @@ export function getLogsForFiber(onChain, fiberId) {
  * @returns Array of EventReceipt entries
  */
 export 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.
@@ -95,6 +94,5 @@ export function getEventReceipts(onChain, fiberId) {
  * @returns Array of ScriptInvocation entries
  */
 export 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/esm/ottochain/transaction.js

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

package/dist/esm/privacy/index.js

@@ -2,5 +2,5 @@
  * Privacy: shield any fiber app into a zk-jlvm-shielded private-state pool.
  * See docs/design/zk-private-contract-state-rfc.md.
  */
-export { shieldApp, SHIELDED_POOL_STATE } from "./shield-app.js";
-export { sealedBidAccountDef, shieldedSealedBidDef, vickreyAuctionDef } from "./sealed-bid.js";
+export { shieldApp, SHIELDED_POOL_STATE } from './shield-app.js';
+export { sealedBidAccountDef, shieldedSealedBidDef, vickreyAuctionDef } from './sealed-bid.js';