@ottochain/sdk 2.5.0 → 2.6.0

package/dist/cjs/index.js

@@ -32,7 +32,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 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.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;
+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);
@@ -150,6 +150,7 @@ Object.defineProperty(exports, "transferAsset", { enumerable: true, get: functio
 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; } });

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/*)
     // -------------------------------------------------------------------------
     /**

package/dist/cjs/schema/effects.js

@@ -16,7 +16,7 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RESERVED_EFFECT_KEYS = exports.emit = exports.spawn = exports.triggers = exports.toWallet = exports.toFiber = exports.transferAsset = exports.setDependencyActive = exports.addDependency = void 0;
+exports.RESERVED_EFFECT_KEYS = exports.scriptCall = exports.emit = exports.spawn = exports.triggers = exports.toWallet = exports.toFiber = exports.transferAsset = exports.setDependencyActive = exports.addDependency = void 0;
 /**
  * `_addDependency` (#24): add — or re-activate — a runtime DYNAMIC dependency on `fiberId`, so that
  * fiber's state appears in `machines.<fiberId>` for SUBSEQUENT transitions of this fiber. `fiberId` may
@@ -139,6 +139,34 @@ const emit = (es) => ({
     _emit: es,
 });
 exports.emit = emit;
+/**
+ * `_scriptCall`: invoke a SCRIPT fiber's `method` from an effect. Unlike the array-valued directives,
+ * `_scriptCall` is a SINGLE object `{ fiberId, method, args }` (chain `ReservedKeys.scala` `SCRIPT_CALL` /
+ * `EffectExtractor.extractScriptCall`). `fiberId` is the target script's UUID (a literal or an expression,
+ * e.g. `{ var: "state.resolverId" }`); `method` is the script method NAME; `args` is the argument body —
+ * a JSON-Logic value the chain EVALUATES against the transition context before dispatch.
+ *
+ * The chain's extractor requires ALL THREE fields — if `args` is absent the whole call is silently DROPPED
+ * (fail-silent, like the other extractors). So the builder ALWAYS emits `args`, defaulting an omitted one
+ * to `{}` (no-args), mirroring how {@link triggers} defaults an absent `payload`. Authoring this as a
+ * builder makes a typo'd `_scriptcall` / wrong field a TypeScript error rather than a silently-merged
+ * state field. Place the fragment INSIDE the effect's state-update map so it rides in the evaluated result.
+ *
+ * @example
+ * effect: { merge: [ { var: "state" }, {
+ *   status: "resolving",
+ *   ...scriptCall({ fiberId: { var: "state.resolverId" }, method: "resolve",
+ *     args: { marketId: { var: "machineId" } } }),
+ * } ] }
+ */
+const scriptCall = (call) => ({
+    _scriptCall: {
+        fiberId: call.fiberId,
+        method: call.method,
+        args: call.args ?? {},
+    },
+});
+exports.scriptCall = scriptCall;
 /**
  * The complete set of `_`-prefixed RESERVED effect keys the chain's `EffectExtractor` consumes and
  * `StateMerger` strips from state (`ReservedKeys.scala:12-49`). Exported so a validator (Proposal 01)

package/dist/cjs/schema/fiber-app.js

@@ -194,8 +194,13 @@ function toProtoDefinition(def) {
             from: t.from,
             to: t.to,
             eventName: t.eventName,
-            guard: t.guard, // Required - Scala has no default
-            effect: t.effect, // Required - Scala has no default
+            // guard/effect are REQUIRED by the Scala `Transition` case class (no defaults). The authoring
+            // `Transition` types them OPTIONAL for ergonomics, so ALWAYS project a concrete value here — an
+            // omitted key would serialize to `undefined`, get dropped, and fail the chain's decode (HTTP 400).
+            // The defaults are the exact shapes the chain's `PublishVersionSigningCanonicalSuite` accepts:
+            // an always-true guard `{"==":[1,1]}` and an empty (no-op) effect `{}`.
+            guard: t.guard ?? { '==': [1, 1] },
+            effect: t.effect ?? {},
             // Chain `Transition.dependencies: Set[UUID]` is REQUIRED (no Scala default), and each
             // element must be a fiber UUID string. A `DependencySpec` object is a build-time-only
             // authoring affordance with no wire representation (concrete dependency UUIDs are per

package/dist/esm/index.js

@@ -67,7 +67,7 @@ depInState,
 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';
+export { addDependency, setDependencyActive, transferAsset, triggers, spawn, emit, scriptCall, 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/metagraph-client.js

@@ -116,7 +116,11 @@ export 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');
     }
@@ -162,15 +166,55 @@ export 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/*)
     // -------------------------------------------------------------------------
     /**

package/dist/esm/schema/effects.js

@@ -128,6 +128,33 @@ export const spawn = (ds) => ({ _spawn: ds });
 export const emit = (es) => ({
     _emit: es,
 });
+/**
+ * `_scriptCall`: invoke a SCRIPT fiber's `method` from an effect. Unlike the array-valued directives,
+ * `_scriptCall` is a SINGLE object `{ fiberId, method, args }` (chain `ReservedKeys.scala` `SCRIPT_CALL` /
+ * `EffectExtractor.extractScriptCall`). `fiberId` is the target script's UUID (a literal or an expression,
+ * e.g. `{ var: "state.resolverId" }`); `method` is the script method NAME; `args` is the argument body —
+ * a JSON-Logic value the chain EVALUATES against the transition context before dispatch.
+ *
+ * The chain's extractor requires ALL THREE fields — if `args` is absent the whole call is silently DROPPED
+ * (fail-silent, like the other extractors). So the builder ALWAYS emits `args`, defaulting an omitted one
+ * to `{}` (no-args), mirroring how {@link triggers} defaults an absent `payload`. Authoring this as a
+ * builder makes a typo'd `_scriptcall` / wrong field a TypeScript error rather than a silently-merged
+ * state field. Place the fragment INSIDE the effect's state-update map so it rides in the evaluated result.
+ *
+ * @example
+ * effect: { merge: [ { var: "state" }, {
+ *   status: "resolving",
+ *   ...scriptCall({ fiberId: { var: "state.resolverId" }, method: "resolve",
+ *     args: { marketId: { var: "machineId" } } }),
+ * } ] }
+ */
+export const scriptCall = (call) => ({
+    _scriptCall: {
+        fiberId: call.fiberId,
+        method: call.method,
+        args: call.args ?? {},
+    },
+});
 /**
  * The complete set of `_`-prefixed RESERVED effect keys the chain's `EffectExtractor` consumes and
  * `StateMerger` strips from state (`ReservedKeys.scala:12-49`). Exported so a validator (Proposal 01)

package/dist/esm/schema/fiber-app.js

@@ -181,8 +181,13 @@ export function toProtoDefinition(def) {
             from: t.from,
             to: t.to,
             eventName: t.eventName,
-            guard: t.guard, // Required - Scala has no default
-            effect: t.effect, // Required - Scala has no default
+            // guard/effect are REQUIRED by the Scala `Transition` case class (no defaults). The authoring
+            // `Transition` types them OPTIONAL for ergonomics, so ALWAYS project a concrete value here — an
+            // omitted key would serialize to `undefined`, get dropped, and fail the chain's decode (HTTP 400).
+            // The defaults are the exact shapes the chain's `PublishVersionSigningCanonicalSuite` accepts:
+            // an always-true guard `{"==":[1,1]}` and an empty (no-op) effect `{}`.
+            guard: t.guard ?? { '==': [1, 1] },
+            effect: t.effect ?? {},
             // Chain `Transition.dependencies: Set[UUID]` is REQUIRED (no Scala default), and each
             // element must be a fiber UUID string. A `DependencySpec` object is a build-time-only
             // authoring affordance with no wire representation (concrete dependency UUIDs are per

package/dist/types/index.d.ts

@@ -33,6 +33,6 @@ export { MetagraphClient as OttoMetagraphClient } from './ottochain/metagraph-cl
 export type { MetagraphClientConfig, Checkpoint, SubscribeOptions, FiberStateCallback, Unsubscribe, } from './ottochain/metagraph-client.js';
 export { toProtoDefinition, defineFiberApp, constrained, unconstrained, immutable, IMMUTABLE_POLICY, projectFiberPolicy, type ProtoStateMachineDefinition, type FiberAppDefinition, type FiberAppMetadata, type FiberPolicy, type FiberPolicyDials, type ImmutablePolicy, type EffectKind, type SpawnOwnerPolicy, type DependencyMode, type TransferPolicy, type DependencyPolicy, type MigrationAuthority, type UpgradePolicy, type VersionRange, type StateDefinition, type StdStateMetadata, type StateCategory, type Transition, } from './schema/fiber-app.js';
 export { type GuardRule, signerIsParty, signerIsAnyParty, signerInSet, signerIsNotParty, signerHasEntry, assetSignerIs, actorIsSigner, actorInSet, actorHasEntry, signerHasReputation, signerHasRole, signerHasReputationVia, signerHasRoleVia, depInState, actorNotInArray, } from './schema/guards.js';
-export { addDependency, setDependencyActive, transferAsset, triggers, spawn, emit, toFiber, toWallet, RESERVED_EFFECT_KEYS, } from './schema/effects.js';
+export { addDependency, setDependencyActive, transferAsset, triggers, spawn, emit, scriptCall, toFiber, toWallet, RESERVED_EFFECT_KEYS, } from './schema/effects.js';
 export { shieldApp, SHIELDED_POOL_STATE, type ShieldOptions } from './privacy/shield-app.js';
 export type { paths as ApiPaths, operations as ApiOperations, components as ApiComponents, VersionInfo, TransitionFeeEstimate, ScriptFeeEstimate, SubscribeRequest, SubscribeResponse, Subscriber, SubscriberList, } from './openapi.js';

package/dist/types/ottochain/index.d.ts

@@ -10,7 +10,7 @@ export type { Address, FiberId, StateId, HashValue, FiberOrdinal, SnapshotOrdina
 export { OTTOCHAIN_MESSAGE_TYPES, TOKEN_BEHAVIOR_BITS } from './types.js';
 export type { CurrencySnapshotResponse } from './snapshot.js';
 export { decodeOnChainState, getSnapshotOnChainState, getLatestOnChainState, getLogsForFiber, getEventReceipts, getScriptInvocations, extractOnChainState, } from './snapshot.js';
-export type { Checkpoint, StateProof, FeeEstimate, MetagraphClientConfig, SubscribeOptions, FiberStateCallback, Unsubscribe, } from './metagraph-client.js';
+export type { Checkpoint, StateProof, FeeEstimate, TransitionFeeEstimate, ScriptFeeEstimate, VersionInfo, SubscribeRequest, SubscribeResponse, SubscriberList, MetagraphClientConfig, SubscribeOptions, FiberStateCallback, Unsubscribe, } from './metagraph-client.js';
 export { MetagraphClient } from './metagraph-client.js';
 export { createTransitionPayload, createArchivePayload, createInvokeScriptPayload, signTransaction, addTransactionSignature, getPublicKeyForRegistration, createStateMachinePayload, createScriptPayload, createDataTransactionRequest, createAssetPolicyPayload, createMintAssetPayload, createApplyMorphismPayload, createAuthorizeComposePayload, } from './transaction.js';
 export type { CreateStateMachineParams, CreateStateMachineMessage, CreateScriptParams, CreateScriptMessage, DataTransactionRequest, TransitionParams, TransitionStateMachineMessage, ArchiveParams, ArchiveStateMachineMessage, InvokeScriptParams, InvokeScriptMessage, } from './transaction.js';

package/dist/types/ottochain/metagraph-client.d.ts

@@ -10,6 +10,8 @@
  */
 import type { Signed } from '@constellation-network/metagraph-sdk';
 import type { OnChain, CalculatedState, StateMachineFiberRecord, ScriptFiberRecord, EventReceipt, ScriptInvocation, FiberStatus, RegistryEntry } from './types.js';
+import type { VersionInfo, TransitionFeeEstimate, ScriptFeeEstimate, SubscribeRequest, SubscribeResponse, SubscriberList } from '../openapi.js';
+export type { VersionInfo, TransitionFeeEstimate, ScriptFeeEstimate, SubscribeRequest, SubscribeResponse, SubscriberList, } from '../openapi.js';
 /**
  * Checkpoint response from the metagraph (ordinal + calculated state).
  */
@@ -23,22 +25,39 @@ export interface Checkpoint {
  * endpoints.
  */
 export interface StateProof {
-    /** The record (or projected field) the proof attests to. */
-    record: unknown;
+    /**
+     * The trie key the proof is keyed on — the fiber/asset id (optionally suffixed with the requested
+     * field). Chain: `StateProofResponse.key: String` (required).
+     */
+    key: string;
+    ordinal: number;
     /** The committed-state combined root (= the snapshot's `calculatedStateProof`). */
     committedRoot: string;
     /** The Merkle-Patricia trie root. */
     mptRoot: string;
-    ordinal: number;
+    /** The record (or projected field) the proof attests to. */
+    record: unknown;
     /** The Merkle-Patricia inclusion proof. */
     proof: unknown;
+    /**
+     * The `stateData` field name that was projected, present ONLY when a `?field=` was requested
+     * (chain `field: Option[String]`, `dropNullValues`-stripped otherwise).
+     */
+    field?: string;
+    /**
+     * The value of the projected `field`, present ONLY when a `?field=` was requested
+     * (chain `fieldValue: Option[Json]`, `dropNullValues`-stripped otherwise).
+     */
+    fieldValue?: unknown;
 }
-/** A fee/gas estimate for a transition or script invocation (shape is advisory / may evolve). */
-export interface FeeEstimate {
-    gas?: number;
-    fee?: number;
-    [key: string]: unknown;
-}
+/**
+ * A static fee/gas estimate. The wire is one of two per-endpoint shapes — {@link TransitionFeeEstimate}
+ * (state-machine transition) or {@link ScriptFeeEstimate} (script invocation) — that mirror the chain's
+ * `FeeEstimates.scala` case classes byte-for-byte. Prefer the per-endpoint types on
+ * {@link MetagraphClient.estimateTransitionFee} / {@link MetagraphClient.estimateScriptFee}; this union is
+ * a convenience for code that handles either.
+ */
+export type FeeEstimate = TransitionFeeEstimate | ScriptFeeEstimate;
 /**
  * Options for subscribeFiberState polling behaviour.
  */
@@ -151,8 +170,12 @@ export declare class MetagraphClient {
      * Get script invocations from the current ordinal's logs.
      */
     getScriptInvocations(scriptId: string): Promise<ScriptInvocation[]>;
-    /** Get the metagraph version string. */
-    getVersion(): Promise<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.
+     */
+    getVersion(): Promise<VersionInfo>;
     /** Get the full registry namespace, keyed by full registry name `labels.tld`. */
     getRegistry(): Promise<Record<string, RegistryEntry>>;
     /** Resolve a single registry entry by full name (`labels.tld`), or null if unregistered. */
@@ -167,10 +190,41 @@ export declare class MetagraphClient {
     getScriptStateProof(fiberId: string, field: string): Promise<StateProof>;
     /** Light-client state proof for a field of an asset instance. */
     getAssetStateProof(assetId: string, field: string): Promise<StateProof>;
-    /** Estimate the fee/gas for a transition event on a state-machine fiber. */
-    estimateTransitionFee(fiberId: string, eventName: string): Promise<FeeEstimate>;
-    /** Estimate the fee/gas for invoking a script fiber. */
-    estimateScriptFee(fiberId: string): Promise<FeeEstimate>;
+    /**
+     * 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`.
+     */
+    estimateTransitionFee(fiberId: string, eventName: string): Promise<TransitionFeeEstimate>;
+    /**
+     * Estimate the fee/gas for invoking a script fiber. Returns a {@link ScriptFeeEstimate}
+     * (`{ scriptId, gasEstimate, opCount, maxDepth, note }`) — chain `FeeEstimates.scala`.
+     */
+    estimateScriptFee(fiberId: string): Promise<ScriptFeeEstimate>;
+    /**
+     * 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`.
+     */
+    subscribeWebhook(request: SubscribeRequest): Promise<SubscribeResponse>;
+    /**
+     * 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.
+     */
+    unsubscribeWebhook(id: string): Promise<void>;
+    /**
+     * List the current webhook subscribers (secrets are redacted server-side).
+     *
+     * `GET …/webhooks/subscribers` → `SubscriberList { subscribers: Subscriber[] }`. Chain:
+     * `ML0Routes.scala` (`webhook.list`) + `webhooks/Subscriber.scala`.
+     */
+    listWebhookSubscribers(): Promise<SubscriberList>;
     /**
      * Get the latest snapshot and decode its on-chain state.
      */

package/dist/types/schema/effects.d.ts

@@ -131,6 +131,31 @@ export declare const emit: (es: {
     data: JsonLogicValue;
     destination?: string;
 }[]) => Record<string, unknown>;
+/**
+ * `_scriptCall`: invoke a SCRIPT fiber's `method` from an effect. Unlike the array-valued directives,
+ * `_scriptCall` is a SINGLE object `{ fiberId, method, args }` (chain `ReservedKeys.scala` `SCRIPT_CALL` /
+ * `EffectExtractor.extractScriptCall`). `fiberId` is the target script's UUID (a literal or an expression,
+ * e.g. `{ var: "state.resolverId" }`); `method` is the script method NAME; `args` is the argument body —
+ * a JSON-Logic value the chain EVALUATES against the transition context before dispatch.
+ *
+ * The chain's extractor requires ALL THREE fields — if `args` is absent the whole call is silently DROPPED
+ * (fail-silent, like the other extractors). So the builder ALWAYS emits `args`, defaulting an omitted one
+ * to `{}` (no-args), mirroring how {@link triggers} defaults an absent `payload`. Authoring this as a
+ * builder makes a typo'd `_scriptcall` / wrong field a TypeScript error rather than a silently-merged
+ * state field. Place the fragment INSIDE the effect's state-update map so it rides in the evaluated result.
+ *
+ * @example
+ * effect: { merge: [ { var: "state" }, {
+ *   status: "resolving",
+ *   ...scriptCall({ fiberId: { var: "state.resolverId" }, method: "resolve",
+ *     args: { marketId: { var: "machineId" } } }),
+ * } ] }
+ */
+export declare const scriptCall: (call: {
+    fiberId: JsonLogicValue;
+    method: string;
+    args?: JsonLogicValue;
+}) => Record<string, unknown>;
 /**
  * The complete set of `_`-prefixed RESERVED effect keys the chain's `EffectExtractor` consumes and
  * `StateMerger` strips from state (`ReservedKeys.scala:12-49`). Exported so a validator (Proposal 01)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ottochain/sdk",
-  "version": "2.5.0",
+  "version": "2.6.0",
   "description": "TypeScript SDK for ottochain metagraph operations - signing, encoding, and network interactions",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",