@ottochain/sdk 2.0.0 → 2.2.0

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

@@ -1,7 +1,7 @@
 "use strict";
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
-//   protoc-gen-ts_proto  v2.11.2
+//   protoc-gen-ts_proto  v2.11.5
 //   protoc               unknown
 // source: ottochain/apps/markets/v1/market.proto
 Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -1,7 +1,7 @@
 "use strict";
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
-//   protoc-gen-ts_proto  v2.11.2
+//   protoc-gen-ts_proto  v2.11.5
 //   protoc               unknown
 // source: ottochain/v1/common.proto
 Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -1,7 +1,7 @@
 "use strict";
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
-//   protoc-gen-ts_proto  v2.11.2
+//   protoc-gen-ts_proto  v2.11.5
 //   protoc               unknown
 // source: ottochain/v1/fiber.proto
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/generated/ottochain/v1/messages.js

@@ -1,7 +1,7 @@
 "use strict";
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
-//   protoc-gen-ts_proto  v2.11.2
+//   protoc-gen-ts_proto  v2.11.5
 //   protoc               unknown
 // source: ottochain/v1/messages.proto
 Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -1,7 +1,7 @@
 "use strict";
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
-//   protoc-gen-ts_proto  v2.11.2
+//   protoc-gen-ts_proto  v2.11.5
 //   protoc               unknown
 // source: ottochain/v1/records.proto
 Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * Fiber App Definition Schema
+ *
+ * TypeScript-first definitions for fiber apps. This is the source of truth —
+ * no JSON, no code generation. Import types directly.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toProtoDefinition = exports.toJSON = exports.isFinalState = exports.getEventsFrom = exports.getTransitionsFrom = exports.defineFiberApp = void 0;
+// =============================================================================
+// Helper: defineFiberApp
+// =============================================================================
+/**
+ * Define a fiber app with full type inference.
+ *
+ * @example
+ * ```ts
+ * const agentDef = defineFiberApp({
+ *   metadata: { name: 'Agent', app: 'identity', type: 'agent', version: '1.0.0' },
+ *   states: {
+ *     REGISTERED: { id: 'REGISTERED', isFinal: false },
+ *     ACTIVE: { id: 'ACTIVE', isFinal: false },
+ *   },
+ *   initialState: 'REGISTERED',
+ *   transitions: [
+ *     { from: 'REGISTERED', to: 'ACTIVE', eventName: 'activate' },
+ *   ],
+ * });
+ * ```
+ */
+function defineFiberApp(definition) {
+    // Runtime validation could go here
+    return definition;
+}
+exports.defineFiberApp = defineFiberApp;
+/** Get valid transitions from a given state */
+function getTransitionsFrom(def, state) {
+    return def.transitions.filter(t => t.from === state);
+}
+exports.getTransitionsFrom = getTransitionsFrom;
+/** Get valid event names from a given state */
+function getEventsFrom(def, state) {
+    return getTransitionsFrom(def, state).map(t => t.eventName);
+}
+exports.getEventsFrom = getEventsFrom;
+/** Check if a state is final */
+function isFinalState(def, state) {
+    return def.states[state]?.isFinal ?? false;
+}
+exports.isFinalState = isFinalState;
+/** Convert definition to plain JSON (for serialization) */
+function toJSON(def) {
+    return JSON.parse(JSON.stringify(def));
+}
+exports.toJSON = toJSON;
+/**
+ * Extract proto-compatible StateMachineDefinition from a FiberAppDefinition.
+ * Use this when submitting to the metagraph.
+ *
+ * @example
+ * ```ts
+ * const def = getContractDefinition('agreement');
+ * const protoDef = toProtoDefinition(def);
+ * // Submit protoDef to metagraph
+ * ```
+ */
+function toProtoDefinition(def) {
+    // Extract only the proto-compatible fields
+    const protoDef = {
+        states: {},
+        initialState: def.initialState,
+        transitions: def.transitions.map(t => ({
+            from: t.from,
+            to: t.to,
+            eventName: t.eventName,
+            ...(t.guard && { guard: t.guard }),
+            ...(t.effect && { effect: t.effect }),
+            ...(t.dependencies?.length && { dependencies: [...t.dependencies] }),
+            ...(t.emits?.length && { emits: [...t.emits] }),
+        })),
+    };
+    // Copy states (only id and isFinal)
+    for (const [key, state] of Object.entries(def.states)) {
+        protoDef.states[key] = {
+            id: state.id,
+            isFinal: state.isFinal,
+        };
+    }
+    // Pass metadata through unchanged - it's an optional unstructured object
+    if (def.metadata) {
+        protoDef.metadata = def.metadata;
+    }
+    return protoDef;
+}
+exports.toProtoDefinition = toProtoDefinition;

package/dist/cjs/schema/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Fiber App Schema
+ */
+__exportStar(require("./fiber-app.js"), exports);

package/dist/esm/apps/contracts/index.js

@@ -19,11 +19,11 @@
  * @packageDocumentation
  */
 // Re-export generated protobuf types (source of truth)
-export { ContractState, Contract, ProposeContractRequest, AcceptContractRequest, CompleteContractRequest, RejectContractRequest, DisputeContractRequest, ContractDefinition, contractStateFromJSON, contractStateToJSON, } from '../../generated/ottochain/apps/contracts/v1/contract.js';
+export { ContractState, Contract, ProposeContractRequest, AcceptContractRequest, CompleteContractRequest, RejectContractRequest, DisputeContractRequest, ContractDefinition, contractStateFromJSON, contractStateToJSON, } from "../../generated/ottochain/apps/contracts/v1/contract.js";
 // ---------------------------------------------------------------------------
 // State Machine Definitions (generated from JSON at build time)
 // ---------------------------------------------------------------------------
-import { contractUniversalDef, contractAgreementDef, contractEscrowDef, } from './state-machines/index.js';
+import { contractUniversalDef, contractAgreementDef, contractEscrowDef, } from "./state-machines/index.js";
 export { contractUniversalDef, contractAgreementDef, contractEscrowDef };
 /** All contract state machine definitions */
 export const CONTRACTS_DEFINITIONS = {
@@ -35,7 +35,7 @@ export const CONTRACTS_DEFINITIONS = {
  * Get a contract state machine definition by type.
  * @param type - 'universal' | 'agreement' | 'escrow' (default: 'agreement')
  */
-export function getContractDefinition(type = 'agreement') {
+export function getContractDefinition(type = "agreement") {
     return CONTRACTS_DEFINITIONS[type];
 }
 /** @deprecated Use getContractDefinition('escrow') */

package/dist/esm/apps/contracts/state-machines/contract-agreement.js

@@ -0,0 +1,269 @@
+import { defineFiberApp } from "../../../schema/fiber-app.js";
+/**
+ * Two-party agreement with mutual completion attestation and dispute resolution.
+ */
+export const contractAgreementDef = defineFiberApp({
+    metadata: {
+        name: "ContractAgreement",
+        app: "contracts",
+        type: "agreement",
+        version: "1.0.0",
+        description: "Two-party agreement with mutual completion attestation and dispute resolution",
+        crossReferences: {
+            proposerIdentityId: {
+                machine: "identity-agent",
+                field: "proposer",
+                description: "Links to proposer's AgentIdentity fiber",
+            },
+            counterpartyIdentityId: {
+                machine: "identity-agent",
+                field: "counterparty",
+                description: "Links to counterparty's AgentIdentity fiber",
+            },
+            escrowId: {
+                machine: "contract-escrow",
+                field: "escrowId",
+                description: "Links to Escrow if payment is escrowed",
+            },
+            arbitrationPoolId: {
+                machine: "arbitration-pool",
+                field: "arbitrationPoolId",
+                description: "Links to ArbitrationPool for dispute resolution",
+            },
+        },
+    },
+    createSchema: {
+        required: ["proposer", "counterparty"],
+        properties: {
+            proposer: {
+                type: "address",
+                description: "DAG address of the proposer",
+                immutable: true,
+            },
+            counterparty: {
+                type: "address",
+                description: "DAG address of the counterparty",
+                immutable: true,
+            },
+        },
+    },
+    stateSchema: {
+        properties: {
+            status: { type: "string" },
+            proposer: { type: "address" },
+            counterparty: { type: "address" },
+            completions: { type: "array" },
+            acceptedAt: { type: "integer", nullable: true },
+            rejectedAt: { type: "integer", nullable: true },
+            rejectReason: { type: "string", nullable: true },
+            cancelledAt: { type: "integer", nullable: true },
+            completedAt: { type: "integer", nullable: true },
+            disputedAt: { type: "integer", nullable: true },
+            disputeReason: { type: "string", nullable: true },
+            disputedBy: { type: "address", nullable: true },
+            resolvedAt: { type: "integer", nullable: true },
+            resolution: { type: "string", nullable: true },
+            rulingId: { type: "string", nullable: true },
+        },
+    },
+    eventSchemas: {
+        accept: {},
+        reject: { properties: { reason: { type: "string" } } },
+        cancel: {},
+        submit_completion: { properties: { proof: { type: "string" } } },
+        finalize: {},
+        dispute: { properties: { reason: { type: "string" } } },
+        resolve: {
+            properties: {
+                judicialRuling: { type: "boolean", nullable: true },
+                proposerApproves: { type: "boolean", nullable: true },
+                counterpartyApproves: { type: "boolean", nullable: true },
+                resolution: { type: "string" },
+                rulingId: { type: "string", nullable: true },
+            },
+        },
+    },
+    states: {
+        PROPOSED: { id: "PROPOSED", isFinal: false, metadata: null },
+        ACTIVE: { id: "ACTIVE", isFinal: false, metadata: null },
+        COMPLETED: { id: "COMPLETED", isFinal: true, metadata: null },
+        DISPUTED: { id: "DISPUTED", isFinal: false, metadata: null },
+        REJECTED: { id: "REJECTED", isFinal: true, metadata: null },
+        CANCELLED: { id: "CANCELLED", isFinal: true, metadata: null },
+    },
+    initialState: "PROPOSED",
+    transitions: [
+        {
+            from: "PROPOSED",
+            to: "ACTIVE",
+            eventName: "accept",
+            guard: { "===": [{ var: "event.agent" }, { var: "state.counterparty" }] },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    { status: "ACTIVE", acceptedAt: { var: "$timestamp" } },
+                ],
+            },
+            dependencies: [],
+        },
+        {
+            from: "PROPOSED",
+            to: "REJECTED",
+            eventName: "reject",
+            guard: { "===": [{ var: "event.agent" }, { var: "state.counterparty" }] },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    {
+                        status: "REJECTED",
+                        rejectedAt: { var: "$timestamp" },
+                        rejectReason: { var: "event.reason" },
+                    },
+                ],
+            },
+            dependencies: [],
+        },
+        {
+            from: "PROPOSED",
+            to: "CANCELLED",
+            eventName: "cancel",
+            guard: { "===": [{ var: "event.agent" }, { var: "state.proposer" }] },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    { status: "CANCELLED", cancelledAt: { var: "$timestamp" } },
+                ],
+            },
+            dependencies: [],
+        },
+        {
+            from: "ACTIVE",
+            to: "ACTIVE",
+            eventName: "submit_completion",
+            guard: {
+                and: [
+                    {
+                        or: [
+                            { "===": [{ var: "event.agent" }, { var: "state.proposer" }] },
+                            {
+                                "===": [{ var: "event.agent" }, { var: "state.counterparty" }],
+                            },
+                        ],
+                    },
+                    {
+                        "!": [
+                            {
+                                in: [
+                                    { var: "event.agent" },
+                                    { map: [{ var: "state.completions" }, { var: "agent" }] },
+                                ],
+                            },
+                        ],
+                    },
+                ],
+            },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    {
+                        completions: {
+                            cat: [
+                                { var: "state.completions" },
+                                [
+                                    {
+                                        agent: { var: "event.agent" },
+                                        proof: { var: "event.proof" },
+                                        submittedAt: { var: "$timestamp" },
+                                    },
+                                ],
+                            ],
+                        },
+                    },
+                ],
+            },
+            dependencies: [],
+        },
+        {
+            from: "ACTIVE",
+            to: "COMPLETED",
+            eventName: "finalize",
+            guard: { ">=": [{ size: { var: "state.completions" } }, 2] },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    { status: "COMPLETED", completedAt: { var: "$timestamp" } },
+                ],
+            },
+            dependencies: [],
+        },
+        {
+            from: "ACTIVE",
+            to: "DISPUTED",
+            eventName: "dispute",
+            guard: {
+                or: [
+                    { "===": [{ var: "event.agent" }, { var: "state.proposer" }] },
+                    { "===": [{ var: "event.agent" }, { var: "state.counterparty" }] },
+                ],
+            },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    {
+                        status: "DISPUTED",
+                        disputedAt: { var: "$timestamp" },
+                        disputeReason: { var: "event.reason" },
+                        disputedBy: { var: "event.agent" },
+                    },
+                ],
+            },
+            dependencies: [],
+        },
+        {
+            from: "DISPUTED",
+            to: "COMPLETED",
+            eventName: "resolve",
+            guard: {
+                or: [
+                    { var: "event.judicialRuling" },
+                    {
+                        and: [
+                            { "===": [{ var: "event.proposerApproves" }, true] },
+                            { "===": [{ var: "event.counterpartyApproves" }, true] },
+                        ],
+                    },
+                ],
+            },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    {
+                        status: "COMPLETED",
+                        resolvedAt: { var: "$timestamp" },
+                        resolution: { var: "event.resolution" },
+                        rulingId: { var: "event.rulingId" },
+                    },
+                ],
+            },
+            dependencies: [],
+        },
+        {
+            from: "ACTIVE",
+            to: "CANCELLED",
+            eventName: "cancel",
+            guard: {
+                or: [
+                    { "===": [{ var: "event.agent" }, { var: "state.proposer" }] },
+                    { "===": [{ var: "event.agent" }, { var: "state.counterparty" }] },
+                ],
+            },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    { status: "CANCELLED", cancelledAt: { var: "$timestamp" } },
+                ],
+            },
+            dependencies: [],
+        },
+    ],
+});