@ottochain/sdk 2.3.0 → 2.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ottochain/sdk",
-  "version": "2.3.0",
+  "version": "2.5.0",
   "description": "TypeScript SDK for ottochain metagraph operations - signing, encoding, and network interactions",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -21,6 +21,16 @@
       "require": "./dist/cjs/ottochain/index.js",
       "types": "./dist/types/ottochain/index.d.ts"
     },
+    "./zk": {
+      "import": "./dist/esm/zk/index.js",
+      "require": "./dist/cjs/zk/index.js",
+      "types": "./dist/types/zk/index.d.ts"
+    },
+    "./templates": {
+      "import": "./dist/esm/templates/index.js",
+      "require": "./dist/cjs/templates/index.js",
+      "types": "./dist/types/templates/index.d.ts"
+    },
     "./apps/identity": {
       "import": "./dist/esm/apps/identity/index.js",
       "require": "./dist/cjs/apps/identity/index.js",
@@ -36,6 +46,11 @@
       "require": "./dist/cjs/apps/markets/index.js",
       "types": "./dist/types/apps/markets/index.d.ts"
     },
+    "./apps/lending": {
+      "import": "./dist/esm/apps/lending/index.js",
+      "require": "./dist/cjs/apps/lending/index.js",
+      "types": "./dist/types/apps/lending/index.d.ts"
+    },
     "./apps/oracles": {
       "import": "./dist/esm/apps/oracles/index.js",
       "require": "./dist/cjs/apps/oracles/index.js",
@@ -51,6 +66,16 @@
       "require": "./dist/cjs/apps/corporate/index.js",
       "types": "./dist/types/apps/corporate/index.d.ts"
     },
+    "./apps/compute": {
+      "import": "./dist/esm/apps/compute/index.js",
+      "require": "./dist/cjs/apps/compute/index.js",
+      "types": "./dist/types/apps/compute/index.d.ts"
+    },
+    "./apps/staked-pool": {
+      "import": "./dist/esm/apps/staked-pool/index.js",
+      "require": "./dist/cjs/apps/staked-pool/index.js",
+      "types": "./dist/types/apps/staked-pool/index.d.ts"
+    },
     "./apps": {
       "import": "./dist/esm/apps/index.js",
       "require": "./dist/cjs/apps/index.js",
@@ -76,7 +101,11 @@
     "test:coverage": "jest --coverage",
     "lint": "eslint src tests",
     "format": "prettier --write src tests",
+    "format:check": "prettier --check src tests",
     "generate": "buf generate",
+    "fetch:openapi": "node scripts/fetch-openapi.mjs",
+    "gen:openapi": "openapi-typescript openapi/ottochain-openapi-ml0.json -o src/generated/openapi.ts",
+    "sync:openapi": "npm run fetch:openapi && npm run gen:openapi",
     "lint:proto": "buf lint",
     "docs": "typedoc",
     "docs:watch": "typedoc --watch",
@@ -106,32 +135,35 @@
     "url": "https://github.com/ottobot-ai/ottochain-sdk/issues"
   },
   "dependencies": {
-    "@bufbuild/protobuf": "^2.12.0",
-    "@constellation-network/metagraph-sdk": "^0.2.0",
+    "@bufbuild/protobuf": "^2.12.1",
+    "@constellation-network/metagraph-sdk": "1.8.0-rc.7",
+    "@constellation-network/metagraph-sdk-jlvm": "1.8.0-rc.7",
+    "@noble/hashes": "^1.8.0",
     "@stardust-collective/dag4": "^2.6.0",
     "@stardust-collective/dag4-keystore": "^2.6.0",
     "canonicalize": "^3.0.0",
     "js-sha256": "^0.11.1",
     "js-sha512": "^0.9.0",
-    "zod": "^3.22.0"
+    "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@babel/preset-env": "^7.29.0",
-    "@commitlint/cli": "^20.5.2",
-    "@commitlint/config-conventional": "^20.5.0",
-    "@eslint/js": "^9.39.4",
+    "@babel/preset-env": "^7.29.7",
+    "@commitlint/cli": "^21.1.0",
+    "@commitlint/config-conventional": "^21.1.0",
+    "@eslint/js": "^10.0.1",
     "@jest/globals": "^30.3.0",
     "@types/jest": "^30.0.0",
-    "@types/node": "^25.6.0",
-    "@typescript-eslint/eslint-plugin": "^8.56.1",
-    "@typescript-eslint/parser": "^8.59.0",
-    "eslint": "^9.39.3",
+    "@types/node": "^26.0.1",
+    "@typescript-eslint/eslint-plugin": "^8.62.0",
+    "@typescript-eslint/parser": "^8.62.0",
+    "eslint": "^10.6.0",
     "jest": "^30.3.0",
-    "prettier": "^3.8.3",
+    "openapi-typescript": "^7.13.0",
+    "prettier": "^3.9.1",
     "ts-jest": "29.4.9",
-    "ts-proto": "^2.11.6",
+    "ts-proto": "^2.11.9",
     "typedoc": "^0.28.19",
-    "typescript": "^5.0.0"
+    "typescript": "^6.0.3"
   },
   "peerDependencies": {
     "@stardust-collective/dag4": "^2.6.0"

package/dist/cjs/ottochain/normalize.js

@@ -1,186 +0,0 @@
-"use strict";
-/**
- * Normalize OttoChain Messages for Signing
- *
- * Converts OttoChain message objects to the wire format expected by the
- * Scala metagraph. Specifically, ensures all `Option[A]=None` fields are
- * present as explicit `null` values, matching what circe's magnolia encoder
- * produces on the Scala side.
- *
- * This is necessary because metakit's `JsonBinaryCodec.deriveDataUpdate`
- * (rc.8) canonicalizes the circe-encoded JSON **including null fields**.
- * If the TypeScript client omits optional fields (undefined), the canonical
- * JSON won't match and signature verification will fail.
- *
- * Schema mapping (Scala → TypeScript):
- * - `Option[A] = None` → `null` (must be explicit, not undefined/absent)
- * - `Option[A] = Some(v)` → `v`
- * - `List.empty` → `[]`
- * - `Map.empty` → `{}`
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.normalizeMessage = exports.normalizeArchiveStateMachine = exports.normalizeTransitionStateMachine = exports.normalizeCreateStateMachine = void 0;
-/**
- * Normalize a State object for wire format
- */
-function normalizeState(state) {
-    return {
-        id: state.id,
-        isFinal: state.isFinal ?? false,
-        metadata: state.metadata ?? null,
-    };
-}
-/**
- * Normalize a Transition object for wire format
- *
- * Scala Transition schema:
- *   from: StateId (required)
- *   to: StateId (required)
- *   eventName: String (required)
- *   guard: JsonLogicExpression (required)
- *   effect: JsonLogicExpression (required)
- *   dependencies: Set[UUID] = Set.empty
- *
- * `dependencies` serializes as `[]` when empty (default). Both `guard`
- * and `effect` are required non-optional fields.
- */
-function normalizeTransition(t) {
-    return {
-        from: t.from,
-        to: t.to,
-        eventName: t.eventName,
-        guard: t.guard,
-        effect: t.effect,
-        dependencies: t.dependencies ?? [],
-    };
-}
-/**
- * Check if a value looks like FiberAppMetadata (has 'name' and 'app' fields).
- * These TypeScript-only fields should be stripped before sending to metagraph.
- */
-function isFiberAppMetadata(value) {
-    return (typeof value === 'object' &&
-        value !== null &&
-        'name' in value &&
-        'app' in value);
-}
-/**
- * Normalize a StateMachineDefinition for wire format
- *
- * Strips FiberAppMetadata from the definition — the Scala schema expects
- * `metadata: Option[Json] = None`, not the TypeScript app metadata object.
- */
-function normalizeDefinition(def) {
-    const states = def.states;
-    const normalizedStates = {};
-    if (states) {
-        for (const [key, state] of Object.entries(states)) {
-            normalizedStates[key] = normalizeState(state);
-        }
-    }
-    const transitions = def.transitions ?? [];
-    // Strip FiberAppMetadata if present — it's TypeScript-only, not part of wire format.
-    // The Scala schema has `metadata: Option[Json] = None`, so use null for wire format.
-    const wireMetadata = isFiberAppMetadata(def.metadata) ? null : (def.metadata ?? null);
-    return {
-        states: normalizedStates,
-        initialState: def.initialState,
-        transitions: transitions.map(normalizeTransition),
-        metadata: wireMetadata,
-    };
-}
-/**
- * Normalize a CreateStateMachine message for wire format
- *
- * Ensures all Option/default fields are explicit in wire format:
- * - definition.metadata → null when absent
- * - definition.states[*].metadata → null when absent
- * - definition.transitions[*].dependencies → [] when absent
- * - parentFiberId → null when absent
- *
- * @example
- * ```typescript
- * const message = normalizeCreateStateMachine({
- *   fiberId: '...',
- *   definition: { states: { INIT: { id: { value: 'INIT' }, isFinal: false } }, ... },
- *   initialData: {}
- * });
- * // message now has parentFiberId: null, definition.metadata: null, etc.
- * ```
- */
-function normalizeCreateStateMachine(msg) {
-    return {
-        fiberId: msg.fiberId,
-        definition: normalizeDefinition(msg.definition),
-        initialData: msg.initialData ?? {},
-        parentFiberId: msg.parentFiberId ?? null,
-    };
-}
-exports.normalizeCreateStateMachine = normalizeCreateStateMachine;
-/**
- * Normalize a TransitionStateMachine message for wire format
- *
- * Scala TransitionStateMachine schema:
- *   fiberId: UUID (required)
- *   eventName: String (required)
- *   payload: JsonLogicValue (required)
- *   targetSequenceNumber: FiberOrdinal (required)
- *
- * All fields are required — no Option types, so no null normalization needed.
- */
-function normalizeTransitionStateMachine(msg) {
-    return {
-        fiberId: msg.fiberId,
-        eventName: msg.eventName,
-        payload: msg.payload,
-        targetSequenceNumber: msg.targetSequenceNumber,
-    };
-}
-exports.normalizeTransitionStateMachine = normalizeTransitionStateMachine;
-/**
- * Normalize an ArchiveStateMachine message for wire format
- *
- * Scala ArchiveStateMachine schema:
- *   fiberId: UUID (required)
- *   targetSequenceNumber: FiberOrdinal (required)
- *
- * All fields are required — no Option types, so no null normalization needed.
- */
-function normalizeArchiveStateMachine(msg) {
-    return {
-        fiberId: msg.fiberId,
-        targetSequenceNumber: msg.targetSequenceNumber,
-    };
-}
-exports.normalizeArchiveStateMachine = normalizeArchiveStateMachine;
-/**
- * Normalize any OttochainMessage wrapper for wire format.
- *
- * Detects the message type from the wrapper key and applies the
- * appropriate normalization.
- *
- * @param message - OttochainMessage in wrapper format: `{ CreateStateMachine: {...} }`
- * @returns Normalized message with all Option fields as explicit null
- *
- * @example
- * ```typescript
- * const normalized = normalizeMessage({
- *   CreateStateMachine: { fiberId: '...', definition: {...}, initialData: {} }
- * });
- * const signed = await signDataUpdate(normalized, privateKey);
- * ```
- */
-function normalizeMessage(message) {
-    if ('CreateStateMachine' in message) {
-        return { CreateStateMachine: normalizeCreateStateMachine(message.CreateStateMachine) };
-    }
-    if ('TransitionStateMachine' in message) {
-        return { TransitionStateMachine: normalizeTransitionStateMachine(message.TransitionStateMachine) };
-    }
-    if ('ArchiveStateMachine' in message) {
-        return { ArchiveStateMachine: normalizeArchiveStateMachine(message.ArchiveStateMachine) };
-    }
-    // CreateScript and InvokeScript — pass through (no optional fields)
-    return message;
-}
-exports.normalizeMessage = normalizeMessage;

package/dist/esm/ottochain/normalize.js

@@ -1,179 +0,0 @@
-/**
- * Normalize OttoChain Messages for Signing
- *
- * Converts OttoChain message objects to the wire format expected by the
- * Scala metagraph. Specifically, ensures all `Option[A]=None` fields are
- * present as explicit `null` values, matching what circe's magnolia encoder
- * produces on the Scala side.
- *
- * This is necessary because metakit's `JsonBinaryCodec.deriveDataUpdate`
- * (rc.8) canonicalizes the circe-encoded JSON **including null fields**.
- * If the TypeScript client omits optional fields (undefined), the canonical
- * JSON won't match and signature verification will fail.
- *
- * Schema mapping (Scala → TypeScript):
- * - `Option[A] = None` → `null` (must be explicit, not undefined/absent)
- * - `Option[A] = Some(v)` → `v`
- * - `List.empty` → `[]`
- * - `Map.empty` → `{}`
- */
-/**
- * Normalize a State object for wire format
- */
-function normalizeState(state) {
-    return {
-        id: state.id,
-        isFinal: state.isFinal ?? false,
-        metadata: state.metadata ?? null,
-    };
-}
-/**
- * Normalize a Transition object for wire format
- *
- * Scala Transition schema:
- *   from: StateId (required)
- *   to: StateId (required)
- *   eventName: String (required)
- *   guard: JsonLogicExpression (required)
- *   effect: JsonLogicExpression (required)
- *   dependencies: Set[UUID] = Set.empty
- *
- * `dependencies` serializes as `[]` when empty (default). Both `guard`
- * and `effect` are required non-optional fields.
- */
-function normalizeTransition(t) {
-    return {
-        from: t.from,
-        to: t.to,
-        eventName: t.eventName,
-        guard: t.guard,
-        effect: t.effect,
-        dependencies: t.dependencies ?? [],
-    };
-}
-/**
- * Check if a value looks like FiberAppMetadata (has 'name' and 'app' fields).
- * These TypeScript-only fields should be stripped before sending to metagraph.
- */
-function isFiberAppMetadata(value) {
-    return (typeof value === 'object' &&
-        value !== null &&
-        'name' in value &&
-        'app' in value);
-}
-/**
- * Normalize a StateMachineDefinition for wire format
- *
- * Strips FiberAppMetadata from the definition — the Scala schema expects
- * `metadata: Option[Json] = None`, not the TypeScript app metadata object.
- */
-function normalizeDefinition(def) {
-    const states = def.states;
-    const normalizedStates = {};
-    if (states) {
-        for (const [key, state] of Object.entries(states)) {
-            normalizedStates[key] = normalizeState(state);
-        }
-    }
-    const transitions = def.transitions ?? [];
-    // Strip FiberAppMetadata if present — it's TypeScript-only, not part of wire format.
-    // The Scala schema has `metadata: Option[Json] = None`, so use null for wire format.
-    const wireMetadata = isFiberAppMetadata(def.metadata) ? null : (def.metadata ?? null);
-    return {
-        states: normalizedStates,
-        initialState: def.initialState,
-        transitions: transitions.map(normalizeTransition),
-        metadata: wireMetadata,
-    };
-}
-/**
- * Normalize a CreateStateMachine message for wire format
- *
- * Ensures all Option/default fields are explicit in wire format:
- * - definition.metadata → null when absent
- * - definition.states[*].metadata → null when absent
- * - definition.transitions[*].dependencies → [] when absent
- * - parentFiberId → null when absent
- *
- * @example
- * ```typescript
- * const message = normalizeCreateStateMachine({
- *   fiberId: '...',
- *   definition: { states: { INIT: { id: { value: 'INIT' }, isFinal: false } }, ... },
- *   initialData: {}
- * });
- * // message now has parentFiberId: null, definition.metadata: null, etc.
- * ```
- */
-export function normalizeCreateStateMachine(msg) {
-    return {
-        fiberId: msg.fiberId,
-        definition: normalizeDefinition(msg.definition),
-        initialData: msg.initialData ?? {},
-        parentFiberId: msg.parentFiberId ?? null,
-    };
-}
-/**
- * Normalize a TransitionStateMachine message for wire format
- *
- * Scala TransitionStateMachine schema:
- *   fiberId: UUID (required)
- *   eventName: String (required)
- *   payload: JsonLogicValue (required)
- *   targetSequenceNumber: FiberOrdinal (required)
- *
- * All fields are required — no Option types, so no null normalization needed.
- */
-export function normalizeTransitionStateMachine(msg) {
-    return {
-        fiberId: msg.fiberId,
-        eventName: msg.eventName,
-        payload: msg.payload,
-        targetSequenceNumber: msg.targetSequenceNumber,
-    };
-}
-/**
- * Normalize an ArchiveStateMachine message for wire format
- *
- * Scala ArchiveStateMachine schema:
- *   fiberId: UUID (required)
- *   targetSequenceNumber: FiberOrdinal (required)
- *
- * All fields are required — no Option types, so no null normalization needed.
- */
-export function normalizeArchiveStateMachine(msg) {
-    return {
-        fiberId: msg.fiberId,
-        targetSequenceNumber: msg.targetSequenceNumber,
-    };
-}
-/**
- * Normalize any OttochainMessage wrapper for wire format.
- *
- * Detects the message type from the wrapper key and applies the
- * appropriate normalization.
- *
- * @param message - OttochainMessage in wrapper format: `{ CreateStateMachine: {...} }`
- * @returns Normalized message with all Option fields as explicit null
- *
- * @example
- * ```typescript
- * const normalized = normalizeMessage({
- *   CreateStateMachine: { fiberId: '...', definition: {...}, initialData: {} }
- * });
- * const signed = await signDataUpdate(normalized, privateKey);
- * ```
- */
-export function normalizeMessage(message) {
-    if ('CreateStateMachine' in message) {
-        return { CreateStateMachine: normalizeCreateStateMachine(message.CreateStateMachine) };
-    }
-    if ('TransitionStateMachine' in message) {
-        return { TransitionStateMachine: normalizeTransitionStateMachine(message.TransitionStateMachine) };
-    }
-    if ('ArchiveStateMachine' in message) {
-        return { ArchiveStateMachine: normalizeArchiveStateMachine(message.ArchiveStateMachine) };
-    }
-    // CreateScript and InvokeScript — pass through (no optional fields)
-    return message;
-}

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

@@ -1,79 +0,0 @@
-/**
- * Normalize OttoChain Messages for Signing
- *
- * Converts OttoChain message objects to the wire format expected by the
- * Scala metagraph. Specifically, ensures all `Option[A]=None` fields are
- * present as explicit `null` values, matching what circe's magnolia encoder
- * produces on the Scala side.
- *
- * This is necessary because metakit's `JsonBinaryCodec.deriveDataUpdate`
- * (rc.8) canonicalizes the circe-encoded JSON **including null fields**.
- * If the TypeScript client omits optional fields (undefined), the canonical
- * JSON won't match and signature verification will fail.
- *
- * Schema mapping (Scala → TypeScript):
- * - `Option[A] = None` → `null` (must be explicit, not undefined/absent)
- * - `Option[A] = Some(v)` → `v`
- * - `List.empty` → `[]`
- * - `Map.empty` → `{}`
- */
-/**
- * Normalize a CreateStateMachine message for wire format
- *
- * Ensures all Option/default fields are explicit in wire format:
- * - definition.metadata → null when absent
- * - definition.states[*].metadata → null when absent
- * - definition.transitions[*].dependencies → [] when absent
- * - parentFiberId → null when absent
- *
- * @example
- * ```typescript
- * const message = normalizeCreateStateMachine({
- *   fiberId: '...',
- *   definition: { states: { INIT: { id: { value: 'INIT' }, isFinal: false } }, ... },
- *   initialData: {}
- * });
- * // message now has parentFiberId: null, definition.metadata: null, etc.
- * ```
- */
-export declare function normalizeCreateStateMachine(msg: Record<string, unknown>): Record<string, unknown>;
-/**
- * Normalize a TransitionStateMachine message for wire format
- *
- * Scala TransitionStateMachine schema:
- *   fiberId: UUID (required)
- *   eventName: String (required)
- *   payload: JsonLogicValue (required)
- *   targetSequenceNumber: FiberOrdinal (required)
- *
- * All fields are required — no Option types, so no null normalization needed.
- */
-export declare function normalizeTransitionStateMachine(msg: Record<string, unknown>): Record<string, unknown>;
-/**
- * Normalize an ArchiveStateMachine message for wire format
- *
- * Scala ArchiveStateMachine schema:
- *   fiberId: UUID (required)
- *   targetSequenceNumber: FiberOrdinal (required)
- *
- * All fields are required — no Option types, so no null normalization needed.
- */
-export declare function normalizeArchiveStateMachine(msg: Record<string, unknown>): Record<string, unknown>;
-/**
- * Normalize any OttochainMessage wrapper for wire format.
- *
- * Detects the message type from the wrapper key and applies the
- * appropriate normalization.
- *
- * @param message - OttochainMessage in wrapper format: `{ CreateStateMachine: {...} }`
- * @returns Normalized message with all Option fields as explicit null
- *
- * @example
- * ```typescript
- * const normalized = normalizeMessage({
- *   CreateStateMachine: { fiberId: '...', definition: {...}, initialData: {} }
- * });
- * const signed = await signDataUpdate(normalized, privateKey);
- * ```
- */
-export declare function normalizeMessage(message: Record<string, unknown>): Record<string, unknown>;