@ottochain/sdk 0.2.0

package/dist/ottochain/metagraph-client.js

@@ -0,0 +1,157 @@
+"use strict";
+/**
+ * Ottochain Metagraph Client
+ *
+ * Client for interacting with ottochain ML0 custom routes (/v1 prefix)
+ * and framework snapshot endpoints.
+ *
+ * @see modules/l0/src/main/scala/xyz/kd5ujc/metagraph_l0/ML0CustomRoutes.scala
+ * @see modules/data_l1/src/main/scala/xyz/kd5ujc/data_l1/DataL1CustomRoutes.scala
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetagraphClient = void 0;
+const client_js_1 = require("../metakit/network/client.js");
+const types_js_1 = require("../metakit/network/types.js");
+const snapshot_js_1 = require("./snapshot.js");
+/**
+ * Client for ottochain metagraph operations.
+ *
+ * Provides typed access to all ML0 custom routes (under /data-application/v1/)
+ * and framework snapshot endpoints.
+ *
+ * @example
+ * ```typescript
+ * const client = new MetagraphClient({
+ *   ml0Url: 'http://localhost:9200',
+ *   dl1Url: 'http://localhost:9400',
+ * });
+ *
+ * // Query on-chain state
+ * const onChain = await client.getOnChain();
+ *
+ * // Get all active state machines
+ * const machines = await client.getStateMachines('Active');
+ *
+ * // Get event receipts for a fiber
+ * const events = await client.getStateMachineEvents(fiberId);
+ * ```
+ */
+class MetagraphClient {
+    constructor(config) {
+        this.ml0 = new client_js_1.HttpClient(config.ml0Url, config.timeout);
+        if (config.dl1Url) {
+            this.dl1 = new client_js_1.HttpClient(config.dl1Url, config.timeout);
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Custom routes (ML0 /data-application/v1/*)
+    // -------------------------------------------------------------------------
+    /**
+     * Get the current on-chain state (directly from L0 context).
+     */
+    async getOnChain() {
+        return this.ml0.get('/data-application/v1/onchain');
+    }
+    /**
+     * Get the latest checkpoint (ordinal + calculated state).
+     */
+    async getCheckpoint() {
+        return this.ml0.get('/data-application/v1/checkpoint');
+    }
+    /**
+     * Get all state machines, optionally filtered by status.
+     */
+    async getStateMachines(status) {
+        const query = status ? `?status=${status}` : '';
+        return this.ml0.get(`/data-application/v1/state-machines${query}`);
+    }
+    /**
+     * Get a single state machine by fiber ID.
+     */
+    async getStateMachine(fiberId) {
+        try {
+            return await this.ml0.get(`/data-application/v1/state-machines/${fiberId}`);
+        }
+        catch (error) {
+            if (error instanceof types_js_1.NetworkError && error.statusCode === 404) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Get event receipts for a state machine from the current ordinal's logs.
+     */
+    async getStateMachineEvents(fiberId) {
+        return this.ml0.get(`/data-application/v1/state-machines/${fiberId}/events`);
+    }
+    /**
+     * Get all script oracles, optionally filtered by status.
+     */
+    async getScripts(status) {
+        const query = status ? `?status=${status}` : '';
+        return this.ml0.get(`/data-application/v1/oracles${query}`);
+    }
+    /**
+     * Get a single script oracle by fiber ID.
+     */
+    async getScript(scriptId) {
+        try {
+            return await this.ml0.get(`/data-application/v1/oracles/${scriptId}`);
+        }
+        catch (error) {
+            if (error instanceof types_js_1.NetworkError && error.statusCode === 404) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Get oracle invocations from the current ordinal's logs.
+     */
+    async getScriptInvocations(scriptId) {
+        return this.ml0.get(`/data-application/v1/oracles/${scriptId}/invocations`);
+    }
+    // -------------------------------------------------------------------------
+    // Framework snapshot endpoints (ML0 /snapshots/*)
+    // -------------------------------------------------------------------------
+    /**
+     * Get the latest snapshot and decode its on-chain state.
+     */
+    async getLatestSnapshotOnChainState() {
+        const snapshot = await this.ml0.get('/snapshots/latest');
+        return (0, snapshot_js_1.extractOnChainState)(snapshot);
+    }
+    /**
+     * Get a snapshot by ordinal and decode its on-chain state.
+     */
+    async getSnapshotOnChainState(ordinal) {
+        const snapshot = await this.ml0.get(`/snapshots/${ordinal}`);
+        return (0, snapshot_js_1.extractOnChainState)(snapshot);
+    }
+    /**
+     * Get the latest snapshot ordinal.
+     */
+    async getLatestOrdinal() {
+        const snapshot = await this.ml0.get('/snapshots/latest');
+        return snapshot.value.ordinal;
+    }
+    // -------------------------------------------------------------------------
+    // DL1 data submission (framework POST /data)
+    // -------------------------------------------------------------------------
+    /**
+     * Submit a signed data update to the DL1 node.
+     * The POST /data endpoint is framework-provided (no /v1 prefix).
+     *
+     * @param signedData - Signed OttochainMessage
+     * @returns Response hash
+     */
+    async postData(signedData) {
+        if (!this.dl1) {
+            throw new Error('dl1Url is required for postData');
+        }
+        return this.dl1.post('/data', signedData);
+    }
+}
+exports.MetagraphClient = MetagraphClient;

package/dist/ottochain/snapshot.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Snapshot decoder for ottochain on-chain state
+ *
+ * Fetches currency incremental snapshots from metagraph L0 and decodes the
+ * on-chain state from the DataApplicationPart's binary payload.
+ *
+ * The on-chain state is serialized using JsonBinaryCodec (canonical JSON → UTF-8 bytes).
+ *
+ * @see modules/models/src/main/scala/xyz/kd5ujc/schema/OnChain.scala
+ * @packageDocumentation
+ */
+import type { OnChain, EventReceipt, OracleInvocation, FiberLogEntry } from './types.js';
+/**
+ * Decode on-chain state from binary (JsonBinaryCodec format).
+ *
+ * JsonBinaryCodec serialization is: canonical JSON → UTF-8 bytes.
+ * So decoding is simply: UTF-8 bytes → JSON.parse.
+ *
+ * @param bytes - UTF-8 encoded canonical JSON bytes
+ * @returns Decoded OnChain state
+ */
+export declare function decodeOnChainState(bytes: Uint8Array): OnChain;
+/**
+ * Snapshot response shape from GET /snapshots/{ordinal} or /snapshots/latest
+ * on the metagraph L0 node (port 9200 by default).
+ */
+export interface CurrencySnapshotResponse {
+    value: {
+        ordinal: number;
+        dataApplication?: {
+            onChainState: number[];
+            blocks: unknown[];
+        };
+        [key: string]: unknown;
+    };
+    proofs: unknown[];
+}
+/**
+ * Fetch and decode the on-chain state from a specific snapshot ordinal.
+ *
+ * @param ml0BaseUrl - Metagraph L0 node base URL (e.g., 'http://localhost:9200')
+ * @param ordinal - Snapshot ordinal number
+ * @returns Decoded OnChain state, or null if no data application part
+ */
+export declare function getSnapshotOnChainState(ml0BaseUrl: string, ordinal: number): Promise<OnChain | null>;
+/**
+ * Fetch and decode the on-chain state from the latest snapshot.
+ *
+ * @param ml0BaseUrl - Metagraph L0 node base URL (e.g., 'http://localhost:9200')
+ * @returns Decoded OnChain state, or null if no data application part
+ */
+export declare function getLatestOnChainState(ml0BaseUrl: string): Promise<OnChain | null>;
+/**
+ * Extract and decode on-chain state from a snapshot response.
+ */
+export declare function extractOnChainState(snapshot: CurrencySnapshotResponse): OnChain | null;
+/**
+ * Get all log entries for a specific fiber from on-chain state.
+ *
+ * @param onChain - Decoded on-chain state
+ * @param fiberId - Fiber UUID to filter by
+ * @returns Array of log entries for the fiber, or empty array
+ */
+export declare function getLogsForFiber(onChain: OnChain, fiberId: string): FiberLogEntry[];
+/**
+ * Get EventReceipt log entries for a specific fiber.
+ *
+ * EventReceipts are distinguished from OracleInvocations by the presence
+ * of the `eventName` field.
+ *
+ * @param onChain - Decoded on-chain state
+ * @param fiberId - Fiber UUID to filter by
+ * @returns Array of EventReceipt entries
+ */
+export declare function getEventReceipts(onChain: OnChain, fiberId: string): EventReceipt[];
+/**
+ * Get OracleInvocation log entries for a specific fiber.
+ *
+ * OracleInvocations are distinguished from EventReceipts by the presence
+ * of the `method` field.
+ *
+ * @param onChain - Decoded on-chain state
+ * @param fiberId - Fiber UUID to filter by
+ * @returns Array of OracleInvocation entries
+ */
+export declare function getScriptInvocations(onChain: OnChain, fiberId: string): OracleInvocation[];

package/dist/ottochain/snapshot.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * Snapshot decoder for ottochain on-chain state
+ *
+ * Fetches currency incremental snapshots from metagraph L0 and decodes the
+ * on-chain state from the DataApplicationPart's binary payload.
+ *
+ * The on-chain state is serialized using JsonBinaryCodec (canonical JSON → UTF-8 bytes).
+ *
+ * @see modules/models/src/main/scala/xyz/kd5ujc/schema/OnChain.scala
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getScriptInvocations = exports.getEventReceipts = exports.getLogsForFiber = exports.extractOnChainState = exports.getLatestOnChainState = exports.getSnapshotOnChainState = exports.decodeOnChainState = void 0;
+const client_js_1 = require("../metakit/network/client.js");
+/**
+ * Decode on-chain state from binary (JsonBinaryCodec format).
+ *
+ * JsonBinaryCodec serialization is: canonical JSON → UTF-8 bytes.
+ * So decoding is simply: UTF-8 bytes → JSON.parse.
+ *
+ * @param bytes - UTF-8 encoded canonical JSON bytes
+ * @returns Decoded OnChain state
+ */
+function decodeOnChainState(bytes) {
+    const json = new TextDecoder().decode(bytes);
+    return JSON.parse(json);
+}
+exports.decodeOnChainState = decodeOnChainState;
+/**
+ * Fetch and decode the on-chain state from a specific snapshot ordinal.
+ *
+ * @param ml0BaseUrl - Metagraph L0 node base URL (e.g., 'http://localhost:9200')
+ * @param ordinal - Snapshot ordinal number
+ * @returns Decoded OnChain state, or null if no data application part
+ */
+async function getSnapshotOnChainState(ml0BaseUrl, ordinal) {
+    const client = new client_js_1.HttpClient(ml0BaseUrl);
+    const snapshot = await client.get(`/snapshots/${ordinal}`);
+    return extractOnChainState(snapshot);
+}
+exports.getSnapshotOnChainState = getSnapshotOnChainState;
+/**
+ * Fetch and decode the on-chain state from the latest snapshot.
+ *
+ * @param ml0BaseUrl - Metagraph L0 node base URL (e.g., 'http://localhost:9200')
+ * @returns Decoded OnChain state, or null if no data application part
+ */
+async function getLatestOnChainState(ml0BaseUrl) {
+    const client = new client_js_1.HttpClient(ml0BaseUrl);
+    const snapshot = await client.get('/snapshots/latest');
+    return extractOnChainState(snapshot);
+}
+exports.getLatestOnChainState = getLatestOnChainState;
+/**
+ * Extract and decode on-chain state from a snapshot response.
+ */
+function extractOnChainState(snapshot) {
+    const dataPart = snapshot.value?.dataApplication;
+    if (!dataPart?.onChainState) {
+        return null;
+    }
+    const bytes = new Uint8Array(dataPart.onChainState);
+    return decodeOnChainState(bytes);
+}
+exports.extractOnChainState = extractOnChainState;
+// ---------------------------------------------------------------------------
+// Log filtering helpers
+// ---------------------------------------------------------------------------
+/**
+ * Get all log entries for a specific fiber from on-chain state.
+ *
+ * @param onChain - Decoded on-chain state
+ * @param fiberId - Fiber UUID to filter by
+ * @returns Array of log entries for the fiber, or empty array
+ */
+function getLogsForFiber(onChain, fiberId) {
+    return onChain.latestLogs[fiberId] ?? [];
+}
+exports.getLogsForFiber = getLogsForFiber;
+/**
+ * Get EventReceipt log entries for a specific fiber.
+ *
+ * EventReceipts are distinguished from OracleInvocations by the presence
+ * of the `eventName` field.
+ *
+ * @param onChain - Decoded on-chain state
+ * @param fiberId - Fiber UUID to filter by
+ * @returns Array of EventReceipt entries
+ */
+function getEventReceipts(onChain, fiberId) {
+    return getLogsForFiber(onChain, fiberId)
+        .filter((entry) => 'eventName' in entry && 'success' in entry);
+}
+exports.getEventReceipts = getEventReceipts;
+/**
+ * Get OracleInvocation log entries for a specific fiber.
+ *
+ * OracleInvocations are distinguished from EventReceipts by the presence
+ * of the `method` field.
+ *
+ * @param onChain - Decoded on-chain state
+ * @param fiberId - Fiber UUID to filter by
+ * @returns Array of OracleInvocation entries
+ */
+function getScriptInvocations(onChain, fiberId) {
+    return getLogsForFiber(onChain, fiberId)
+        .filter((entry) => 'method' in entry && 'result' in entry);
+}
+exports.getScriptInvocations = getScriptInvocations;

package/dist/ottochain/types.d.ts

@@ -0,0 +1,278 @@
+/**
+ * Ottochain-specific type definitions
+ *
+ * TypeScript interfaces mirroring the Scala domain model for ottochain metagraphs.
+ * These types represent the on-chain state, fiber records, log entries, and message formats.
+ *
+ * @see modules/models/src/main/scala/xyz/kd5ujc/schema/
+ * @packageDocumentation
+ */
+/**
+ * Fiber sequence number (non-negative integer).
+ * Serializes as a plain number in JSON.
+ *
+ * @see modules/models/src/main/scala/xyz/kd5ujc/schema/fiber/FiberOrdinal.scala
+ */
+export type FiberOrdinal = number;
+/**
+ * Snapshot ordinal from the Constellation framework.
+ * Serializes as `{ value: number }` in JSON.
+ */
+export interface SnapshotOrdinal {
+    value: number;
+}
+/**
+ * State identifier for state machines.
+ * Serializes as `{ value: string }` in JSON.
+ *
+ * @see modules/models/src/main/scala/xyz/kd5ujc/schema/fiber/StateId.scala
+ */
+export interface StateId {
+    value: string;
+}
+/**
+ * Constellation network address (DAG address string).
+ */
+export type Address = string;
+/**
+ * Hash value from the Constellation framework.
+ * Serializes as `{ value: string }` in JSON.
+ */
+export interface HashValue {
+    value: string;
+}
+/**
+ * JSON logic value - arbitrary JSON data used for state data and payloads.
+ */
+export type JsonLogicValue = unknown;
+/**
+ * JSON logic expression - a JsonLogic program definition.
+ */
+export type JsonLogicExpression = unknown;
+/**
+ * Lifecycle status of a fiber.
+ *
+ * @see modules/models/src/main/scala/xyz/kd5ujc/schema/fiber/FiberStatus.scala
+ */
+export type FiberStatus = 'Active' | 'Archived' | 'Failed';
+/**
+ * Access control policy for script oracles.
+ *
+ * @see modules/models/src/main/scala/xyz/kd5ujc/schema/fiber/AccessControlPolicy.scala
+ */
+export type AccessControlPolicy = {
+    Public: Record<string, never>;
+} | {
+    Whitelist: {
+        addresses: Address[];
+    };
+} | {
+    FiberOwned: {
+        fiberId: string;
+    };
+};
+/**
+ * Definition of a state machine's structure and transitions.
+ *
+ * @see modules/models/src/main/scala/xyz/kd5ujc/schema/fiber/StateMachineDefinition.scala
+ */
+export interface StateMachineDefinition {
+    states: Record<string, unknown>;
+    initialState: StateId;
+    transitions: unknown[];
+    metadata?: JsonLogicValue;
+}
+/**
+ * Event emitted by a state machine transition trigger.
+ *
+ * @see modules/models/src/main/scala/xyz/kd5ujc/schema/fiber/EmittedEvent.scala
+ */
+export interface EmittedEvent {
+    name: string;
+    data: JsonLogicValue;
+    destination?: string;
+}
+/**
+ * Receipt of a state machine event processing.
+ * Emitted as a FiberLogEntry after each TransitionStateMachine.
+ *
+ * @see modules/models/src/main/scala/xyz/kd5ujc/schema/fiber/FiberLogEntry.scala
+ */
+export interface EventReceipt {
+    fiberId: string;
+    sequenceNumber: FiberOrdinal;
+    eventName: string;
+    ordinal: SnapshotOrdinal;
+    fromState: StateId;
+    toState: StateId;
+    success: boolean;
+    gasUsed: number;
+    triggersFired: number;
+    errorMessage?: string;
+    sourceFiberId?: string;
+    emittedEvents: EmittedEvent[];
+}
+/**
+ * Log entry for a script oracle invocation.
+ * Emitted as a FiberLogEntry after each InvokeScript.
+ *
+ * @see modules/models/src/main/scala/xyz/kd5ujc/schema/fiber/FiberLogEntry.scala
+ */
+export interface OracleInvocation {
+    fiberId: string;
+    method: string;
+    args: JsonLogicValue;
+    result: JsonLogicValue;
+    gasUsed: number;
+    invokedAt: SnapshotOrdinal;
+    invokedBy: Address;
+}
+/**
+ * Union type for all fiber log entries.
+ * The runtime JSON is discriminated by the presence of type-specific fields.
+ */
+export type FiberLogEntry = EventReceipt | OracleInvocation;
+/**
+ * On-chain record for a state machine fiber.
+ *
+ * @see modules/models/src/main/scala/xyz/kd5ujc/schema/Records.scala
+ */
+export interface StateMachineFiberRecord {
+    fiberId: string;
+    creationOrdinal: SnapshotOrdinal;
+    previousUpdateOrdinal: SnapshotOrdinal;
+    latestUpdateOrdinal: SnapshotOrdinal;
+    definition: StateMachineDefinition;
+    currentState: StateId;
+    stateData: JsonLogicValue;
+    stateDataHash: HashValue;
+    sequenceNumber: FiberOrdinal;
+    owners: Address[];
+    status: FiberStatus;
+    lastReceipt?: EventReceipt;
+    parentFiberId?: string;
+    childFiberIds: string[];
+}
+/**
+ * On-chain record for a script oracle fiber.
+ *
+ * @see modules/models/src/main/scala/xyz/kd5ujc/schema/Records.scala
+ */
+export interface ScriptFiberRecord {
+    fiberId: string;
+    creationOrdinal: SnapshotOrdinal;
+    latestUpdateOrdinal: SnapshotOrdinal;
+    scriptProgram: JsonLogicExpression;
+    stateData?: JsonLogicValue;
+    stateDataHash?: HashValue;
+    accessControl: AccessControlPolicy;
+    sequenceNumber: FiberOrdinal;
+    owners: Address[];
+    status: FiberStatus;
+    lastInvocation?: OracleInvocation;
+}
+/**
+ * Union type for all fiber records.
+ */
+export type FiberRecord = StateMachineFiberRecord | ScriptFiberRecord;
+/**
+ * Commit hash for a single fiber in the on-chain state.
+ *
+ * @see modules/models/src/main/scala/xyz/kd5ujc/schema/OnChain.scala
+ */
+export interface FiberCommit {
+    recordHash: HashValue;
+    stateDataHash?: HashValue;
+    sequenceNumber: FiberOrdinal;
+}
+/**
+ * Full on-chain state of the ottochain metagraph.
+ *
+ * - `fiberCommits`: Map of fiber UUID → commit hashes (lightweight proof)
+ * - `latestLogs`: Map of fiber UUID → log entries from the current ordinal (ephemeral)
+ *
+ * @see modules/models/src/main/scala/xyz/kd5ujc/schema/OnChain.scala
+ */
+export interface OnChain {
+    fiberCommits: Record<string, FiberCommit>;
+    latestLogs: Record<string, FiberLogEntry[]>;
+}
+/**
+ * Full calculated state of the metagraph (served by ML0 /v1/ endpoints).
+ *
+ * Contains the materialized view of all fiber records, queryable by fiber type.
+ */
+export interface CalculatedState {
+    stateMachines: Record<string, StateMachineFiberRecord>;
+    scripts: Record<string, ScriptFiberRecord>;
+}
+/**
+ * Create a new state machine fiber.
+ *
+ * @see modules/models/src/main/scala/xyz/kd5ujc/schema/Updates.scala
+ */
+export interface CreateStateMachine {
+    fiberId: string;
+    definition: StateMachineDefinition;
+    initialData: JsonLogicValue;
+    parentFiberId?: string;
+}
+/**
+ * Trigger a state machine transition.
+ *
+ * @see modules/models/src/main/scala/xyz/kd5ujc/schema/Updates.scala
+ */
+export interface TransitionStateMachine {
+    fiberId: string;
+    eventName: string;
+    payload: JsonLogicValue;
+    targetSequenceNumber: FiberOrdinal;
+}
+/**
+ * Archive a state machine fiber.
+ *
+ * @see modules/models/src/main/scala/xyz/kd5ujc/schema/Updates.scala
+ */
+export interface ArchiveStateMachine {
+    fiberId: string;
+    targetSequenceNumber: FiberOrdinal;
+}
+/**
+ * Create a new script oracle fiber.
+ *
+ * @see modules/models/src/main/scala/xyz/kd5ujc/schema/Updates.scala
+ */
+export interface CreateScript {
+    fiberId: string;
+    scriptProgram: JsonLogicExpression;
+    initialState?: JsonLogicValue;
+    accessControl: AccessControlPolicy;
+}
+/**
+ * Invoke a script oracle.
+ *
+ * @see modules/models/src/main/scala/xyz/kd5ujc/schema/Updates.scala
+ */
+export interface InvokeScript {
+    fiberId: string;
+    method: string;
+    args: JsonLogicValue;
+    targetSequenceNumber: FiberOrdinal;
+}
+/**
+ * Union type for all ottochain messages (DataUpdate payloads).
+ *
+ * JSON is wrapped as `{ MessageName: { ...fields } }` where MessageName
+ * is the class name (e.g., `{ CreateStateMachine: { fiberId: "...", ... } }`).
+ */
+export type OttochainMessage = {
+    CreateStateMachine: CreateStateMachine;
+} | {
+    TransitionStateMachine: TransitionStateMachine;
+} | {
+    ArchiveStateMachine: ArchiveStateMachine;
+} | {
+    CreateScript: CreateScript;
+} | {
+    InvokeScript: InvokeScript;
+};

package/dist/ottochain/types.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Ottochain-specific type definitions
+ *
+ * TypeScript interfaces mirroring the Scala domain model for ottochain metagraphs.
+ * These types represent the on-chain state, fiber records, log entries, and message formats.
+ *
+ * @see modules/models/src/main/scala/xyz/kd5ujc/schema/
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/apps/contracts/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Contracts Application
+ *
+ * Types and utilities for smart contracts on OttoChain.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   ContractState,
+ *   Contract,
+ *   getContractDefinition,
+ *   getEscrowDefinition
+ * } from '@ottochain/sdk/apps/contracts';
+ *
+ * const contractDef = getContractDefinition();
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { ContractState, Contract, ProposeContractRequest, AcceptContractRequest, CompleteContractRequest, RejectContractRequest, DisputeContractRequest, ContractDefinition, contractStateFromJSON, contractStateToJSON, } from '../../generated/ottochain/apps/contracts/v1/contract.js';
+export type ContractDefinitionType = 'Contract' | 'Escrow';
+export declare const CONTRACT_DEFINITIONS: Record<ContractDefinitionType, unknown>;
+/**
+ * Get the contract state machine definition.
+ */
+export declare function getContractDefinition(): unknown;
+/**
+ * Get the escrow state machine definition.
+ */
+export declare function getEscrowDefinition(): unknown;

package/dist/types/apps/contracts/types.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Contract Utilities
+ *
+ * Constants and utilities for the Contract application.
+ * Core types are generated from protobuf - see the generated exports.
+ *
+ * @packageDocumentation
+ */
+import { ContractState } from '../../generated/ottochain/apps/contracts/v1/contract_pb.js';
+/**
+ * Default contract configuration
+ */
+export declare const DEFAULT_CONTRACT_CONFIG: {
+    readonly requireBothSignatures: false;
+    readonly disputeWindowEpochs: 10;
+};
+/**
+ * Valid transitions for each contract state
+ */
+export declare const CONTRACT_TRANSITIONS: Record<ContractState, readonly string[]>;
+/**
+ * Check if a contract state is terminal (no further transitions allowed)
+ */
+export declare function isTerminalState(state: ContractState): boolean;