@ottochain/sdk 1.4.2 → 1.6.0

package/dist/types/apps/oracles/state-machines/index.d.ts

@@ -0,0 +1,312 @@
+/**
+ * Auto-generated from JSON state machine definitions.
+ * DO NOT EDIT - regenerate with: npm run prebuild
+ */
+export declare const oracleDef: {
+    readonly metadata: {
+        readonly name: "Oracle";
+        readonly description: "Oracle registration, reputation, and slashing state machine";
+        readonly version: "1.0.0";
+    };
+    readonly states: {
+        readonly UNREGISTERED: {
+            readonly id: "UNREGISTERED";
+            readonly isFinal: false;
+            readonly metadata: null;
+        };
+        readonly REGISTERED: {
+            readonly id: "REGISTERED";
+            readonly isFinal: false;
+            readonly metadata: null;
+        };
+        readonly ACTIVE: {
+            readonly id: "ACTIVE";
+            readonly isFinal: false;
+            readonly metadata: null;
+        };
+        readonly SLASHED: {
+            readonly id: "SLASHED";
+            readonly isFinal: false;
+            readonly metadata: null;
+        };
+        readonly WITHDRAWN: {
+            readonly id: "WITHDRAWN";
+            readonly isFinal: true;
+            readonly metadata: null;
+        };
+    };
+    readonly initialState: "UNREGISTERED";
+    readonly transitions: readonly [{
+        readonly from: "UNREGISTERED";
+        readonly to: "REGISTERED";
+        readonly eventName: "register";
+        readonly guard: {
+            readonly ">=": readonly [{
+                readonly var: "event.stake";
+            }, {
+                readonly var: "state.minStake";
+            }];
+        };
+        readonly effect: {
+            readonly merge: readonly [{
+                readonly var: "state";
+            }, {
+                readonly status: "REGISTERED";
+                readonly address: {
+                    readonly var: "event.agent";
+                };
+                readonly stake: {
+                    readonly var: "event.stake";
+                };
+                readonly registeredAt: {
+                    readonly var: "$timestamp";
+                };
+                readonly reputation: {
+                    readonly accuracy: 100;
+                    readonly totalResolutions: 0;
+                    readonly disputesWon: 0;
+                    readonly disputesLost: 0;
+                };
+                readonly domains: {
+                    readonly var: "event.domains";
+                };
+                readonly slashingHistory: readonly [];
+            }];
+        };
+        readonly dependencies: readonly [];
+    }, {
+        readonly from: "REGISTERED";
+        readonly to: "ACTIVE";
+        readonly eventName: "activate";
+        readonly guard: {
+            readonly or: readonly [{
+                readonly "===": readonly [{
+                    readonly var: "event.agent";
+                }, {
+                    readonly var: "state.address";
+                }];
+            }, {
+                readonly var: "event.adminOverride";
+            }];
+        };
+        readonly effect: {
+            readonly merge: readonly [{
+                readonly var: "state";
+            }, {
+                readonly status: "ACTIVE";
+                readonly activatedAt: {
+                    readonly var: "$timestamp";
+                };
+            }];
+        };
+        readonly dependencies: readonly [];
+    }, {
+        readonly from: "ACTIVE";
+        readonly to: "ACTIVE";
+        readonly eventName: "add_stake";
+        readonly guard: {
+            readonly and: readonly [{
+                readonly "===": readonly [{
+                    readonly var: "event.agent";
+                }, {
+                    readonly var: "state.address";
+                }];
+            }, {
+                readonly ">": readonly [{
+                    readonly var: "event.amount";
+                }, 0];
+            }];
+        };
+        readonly effect: {
+            readonly merge: readonly [{
+                readonly var: "state";
+            }, {
+                readonly stake: {
+                    readonly "+": readonly [{
+                        readonly var: "state.stake";
+                    }, {
+                        readonly var: "event.amount";
+                    }];
+                };
+                readonly lastStakeAt: {
+                    readonly var: "$timestamp";
+                };
+            }];
+        };
+        readonly dependencies: readonly [];
+    }, {
+        readonly from: "ACTIVE";
+        readonly to: "ACTIVE";
+        readonly eventName: "record_resolution";
+        readonly guard: {
+            readonly var: "event.marketId";
+        };
+        readonly effect: {
+            readonly merge: readonly [{
+                readonly var: "state";
+            }, {
+                readonly reputation: {
+                    readonly merge: readonly [{
+                        readonly var: "state.reputation";
+                    }, {
+                        readonly totalResolutions: {
+                            readonly "+": readonly [{
+                                readonly var: "state.reputation.totalResolutions";
+                            }, 1];
+                        };
+                        readonly accuracy: {
+                            readonly if: readonly [{
+                                readonly var: "event.correct";
+                            }, {
+                                readonly var: "state.reputation.accuracy";
+                            }, {
+                                readonly "-": readonly [{
+                                    readonly var: "state.reputation.accuracy";
+                                }, 5];
+                            }];
+                        };
+                    }];
+                };
+                readonly lastResolutionAt: {
+                    readonly var: "$timestamp";
+                };
+            }];
+        };
+        readonly dependencies: readonly [];
+    }, {
+        readonly from: "ACTIVE";
+        readonly to: "SLASHED";
+        readonly eventName: "slash";
+        readonly guard: {
+            readonly and: readonly [{
+                readonly var: "event.reason";
+            }, {
+                readonly ">": readonly [{
+                    readonly var: "event.amount";
+                }, 0];
+            }, {
+                readonly "<=": readonly [{
+                    readonly var: "event.amount";
+                }, {
+                    readonly var: "state.stake";
+                }];
+            }];
+        };
+        readonly effect: {
+            readonly merge: readonly [{
+                readonly var: "state";
+            }, {
+                readonly status: "SLASHED";
+                readonly stake: {
+                    readonly "-": readonly [{
+                        readonly var: "state.stake";
+                    }, {
+                        readonly var: "event.amount";
+                    }];
+                };
+                readonly slashingHistory: {
+                    readonly cat: readonly [{
+                        readonly var: "state.slashingHistory";
+                    }, readonly [{
+                        readonly reason: {
+                            readonly var: "event.reason";
+                        };
+                        readonly amount: {
+                            readonly var: "event.amount";
+                        };
+                        readonly marketId: {
+                            readonly var: "event.marketId";
+                        };
+                        readonly slashedAt: {
+                            readonly var: "$timestamp";
+                        };
+                    }]];
+                };
+                readonly slashedAt: {
+                    readonly var: "$timestamp";
+                };
+            }];
+        };
+        readonly dependencies: readonly [];
+    }, {
+        readonly from: "SLASHED";
+        readonly to: "ACTIVE";
+        readonly eventName: "reactivate";
+        readonly guard: {
+            readonly and: readonly [{
+                readonly "===": readonly [{
+                    readonly var: "event.agent";
+                }, {
+                    readonly var: "state.address";
+                }];
+            }, {
+                readonly ">=": readonly [{
+                    readonly var: "state.stake";
+                }, {
+                    readonly var: "state.minStake";
+                }];
+            }];
+        };
+        readonly effect: {
+            readonly merge: readonly [{
+                readonly var: "state";
+            }, {
+                readonly status: "ACTIVE";
+                readonly reactivatedAt: {
+                    readonly var: "$timestamp";
+                };
+            }];
+        };
+        readonly dependencies: readonly [];
+    }, {
+        readonly from: "ACTIVE";
+        readonly to: "WITHDRAWN";
+        readonly eventName: "withdraw";
+        readonly guard: {
+            readonly "===": readonly [{
+                readonly var: "event.agent";
+            }, {
+                readonly var: "state.address";
+            }];
+        };
+        readonly effect: {
+            readonly merge: readonly [{
+                readonly var: "state";
+            }, {
+                readonly status: "WITHDRAWN";
+                readonly withdrawnAt: {
+                    readonly var: "$timestamp";
+                };
+                readonly finalStake: {
+                    readonly var: "state.stake";
+                };
+            }];
+        };
+        readonly dependencies: readonly [];
+    }, {
+        readonly from: "SLASHED";
+        readonly to: "WITHDRAWN";
+        readonly eventName: "withdraw";
+        readonly guard: {
+            readonly "===": readonly [{
+                readonly var: "event.agent";
+            }, {
+                readonly var: "state.address";
+            }];
+        };
+        readonly effect: {
+            readonly merge: readonly [{
+                readonly var: "state";
+            }, {
+                readonly status: "WITHDRAWN";
+                readonly withdrawnAt: {
+                    readonly var: "$timestamp";
+                };
+                readonly finalStake: {
+                    readonly var: "state.stake";
+                };
+            }];
+        };
+        readonly dependencies: readonly [];
+    }];
+};

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

@@ -6,7 +6,8 @@
  * @packageDocumentation
  */
 export * as proto from '../generated/index.js';
-export type { Address, FiberId, StateId, HashValue, FiberOrdinal, SnapshotOrdinal, JsonLogicValue, JsonLogicExpression, FiberStatus, AccessControlPolicy, StateMachineDefinition, EmittedEvent, EventReceipt, OracleInvocation, FiberLogEntry, StateMachineFiberRecord, ScriptFiberRecord, FiberRecord, FiberCommit, OnChain, CalculatedState, CreateStateMachine, TransitionStateMachine, ArchiveStateMachine, CreateScript, InvokeScript, OttochainMessage, } from './types.js';
+export type { Address, FiberId, StateId, HashValue, FiberOrdinal, SnapshotOrdinal, JsonLogicValue, JsonLogicExpression, FiberStatus, AccessControlPolicy, StateMachineDefinition, EmittedEvent, EventReceipt, OracleInvocation, FiberLogEntry, StateMachineFiberRecord, ScriptFiberRecord, FiberRecord, FiberCommit, OnChain, CalculatedState, CreateStateMachine, TransitionStateMachine, ArchiveStateMachine, CreateScript, InvokeScript, OttochainMessage, OttochainMessageType, } from './types.js';
+export { OTTOCHAIN_MESSAGE_TYPES } from './types.js';
 export type { CurrencySnapshotResponse } from './snapshot.js';
 export { decodeOnChainState, getSnapshotOnChainState, getLatestOnChainState, getLogsForFiber, getEventReceipts, getScriptInvocations, extractOnChainState, } from './snapshot.js';
 export type { Checkpoint, MetagraphClientConfig, SubscribeOptions, FiberStateCallback, Unsubscribe, } from './metagraph-client.js';

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

@@ -20,13 +20,12 @@
 /**
  * Normalize a CreateStateMachine message for wire format
  *
- * Ensures all Option fields are explicit null:
- * - definition.metadata
- * - definition.states[*].metadata
- * - definition.transitions[*].guard
- * - definition.transitions[*].actions
- * - definition.transitions[*].metadata
- * - parentFiberId
+ * 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
+ * - participants → null when absent (Optional Set[Address] for multi-party signing)
  *
  * @example
  * ```typescript
@@ -35,16 +34,30 @@
  *   definition: { states: { INIT: { id: { value: 'INIT' }, isFinal: false } }, ... },
  *   initialData: {}
  * });
- * // message now has parentFiberId: null, definition.metadata: null, etc.
+ * // message now has parentFiberId: null, participants: 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>;
 /**

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

@@ -157,7 +157,9 @@ export interface CreateStateMachine {
     fiberId: string;
     definition: StateMachineDefinition;
     initialData: JsonLogicValue;
-    parentFiberId?: string;
+    parentFiberId?: string | null;
+    /** Optional set of DAG addresses authorized to sign transitions (multi-party signing). */
+    participants?: string[] | null;
 }
 /**
  * Trigger a state machine transition.
@@ -208,3 +210,12 @@ export type OttochainMessage = {
 } | {
     InvokeScript: InvokeScript;
 };
+/**
+ * Names of all valid OttochainMessage types.
+ * Use this for runtime validation (e.g., in API routes).
+ */
+export declare const OTTOCHAIN_MESSAGE_TYPES: readonly ["CreateStateMachine", "TransitionStateMachine", "ArchiveStateMachine", "CreateScript", "InvokeScript"];
+/**
+ * Type representing valid message type names.
+ */
+export type OttochainMessageType = (typeof OTTOCHAIN_MESSAGE_TYPES)[number];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ottochain/sdk",
-  "version": "1.4.2",
+  "version": "1.6.0",
   "description": "TypeScript SDK for ottochain metagraph operations - signing, encoding, and network interactions",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -100,18 +100,18 @@
   "devDependencies": {
     "@babel/preset-env": "^7.29.0",
     "@commitlint/cli": "^20.4.4",
-    "@commitlint/config-conventional": "^19.0.0",
-    "@eslint/js": "^9.39.3",
+    "@commitlint/config-conventional": "^20.5.0",
+    "@eslint/js": "^9.39.4",
     "@jest/globals": "^30.3.0",
     "@types/jest": "^30.0.0",
-    "@types/node": "^25.3.3",
+    "@types/node": "^25.5.0",
     "@typescript-eslint/eslint-plugin": "^8.56.1",
-    "@typescript-eslint/parser": "^8.56.1",
+    "@typescript-eslint/parser": "^8.57.1",
     "eslint": "^9.39.3",
-    "jest": "^30.2.0",
+    "jest": "^30.3.0",
     "prettier": "^3.0.0",
     "ts-jest": "^29.0.0",
-    "ts-proto": "^2.11.2",
+    "ts-proto": "^2.11.5",
     "typedoc": "^0.28.17",
     "typescript": "^5.0.0"
   },
@@ -125,7 +125,7 @@
     "registry": "https://registry.npmjs.org"
   },
   "scripts": {
-    "build": "npm run build:cjs && npm run build:esm && npm run build:types && npm run build:fixup",
+    "build": "npm run prebuild && npm run build:cjs && npm run build:esm && npm run build:types && npm run build:fixup",
     "build:fixup": "echo '{\"type\":\"module\"}' > dist/esm/package.json && echo '{\"type\":\"commonjs\"}' > dist/cjs/package.json",
     "build:cjs": "tsc -p tsconfig.cjs.json",
     "build:esm": "tsc -p tsconfig.esm.json",
@@ -137,6 +137,7 @@
     "generate": "buf generate",
     "lint:proto": "buf lint",
     "docs": "typedoc",
-    "docs:watch": "typedoc --watch"
+    "docs:watch": "typedoc --watch",
+    "prebuild": "node scripts/inline-json.mjs"
   }
 }