@ottochain/sdk 2.0.0 → 2.2.0

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

@@ -0,0 +1,281 @@
+import { defineFiberApp } from "../../../schema/fiber-app.js";
+/**
+ * Asset custody with conditional release, dispute resolution, and split payments.
+ */
+export const contractEscrowDef = defineFiberApp({
+    metadata: {
+        name: "ContractEscrow",
+        app: "contracts",
+        type: "escrow",
+        version: "1.0.0",
+        description: "Asset custody with conditional release, dispute resolution, and split payments",
+        crossReferences: {
+            contractId: {
+                machine: "contract-agreement",
+                field: "contractId",
+                description: "Links to Contract SM that created this escrow",
+            },
+            marketId: {
+                machine: "market-universal",
+                field: "marketId",
+                description: "Links to Market SM for market-based escrow",
+            },
+            insuranceId: {
+                machine: "insurance",
+                field: "insuranceId",
+                description: "Links to Insurance SM for protected escrow",
+            },
+            arbitrationPoolId: {
+                machine: "arbitration-pool",
+                field: "arbitrationPoolId",
+                description: "Links to ArbitrationPool for dispute resolution",
+            },
+            treasuryId: {
+                machine: "treasury",
+                field: "treasuryId",
+                description: "Links to Treasury for fee collection",
+            },
+        },
+    },
+    createSchema: {
+        required: ["depositor", "beneficiary", "requiredAmount"],
+        properties: {
+            depositor: {
+                type: "address",
+                description: "DAG address of the depositor",
+            },
+            beneficiary: {
+                type: "address",
+                description: "DAG address of the beneficiary",
+            },
+            requiredAmount: {
+                type: "number",
+                minimum: 0,
+                description: "Required escrow amount",
+            },
+            releaseWindowMs: {
+                type: "integer",
+                description: "Time window for dispute before auto-release",
+                nullable: true,
+            },
+            expiresAt: {
+                type: "integer",
+                description: "Timestamp when escrow expires",
+                nullable: true,
+            },
+            autoActivate: {
+                type: "boolean",
+                description: "Whether to auto-activate on funding",
+                nullable: true,
+            },
+        },
+    },
+    stateSchema: {
+        properties: {
+            depositor: { type: "address" },
+            beneficiary: { type: "address" },
+            requiredAmount: { type: "number" },
+            balance: { type: "number" },
+            fundedAt: { type: "integer", nullable: true },
+            activatedAt: { type: "integer", nullable: true },
+            releaseRequest: { type: "object", nullable: true },
+            releaseDeadline: { type: "integer", nullable: true },
+            releasedAt: { type: "integer", nullable: true },
+            releasedTo: { type: "address", nullable: true },
+            disputedAt: { type: "integer", nullable: true },
+            refundedAt: { type: "integer", nullable: true },
+            splits: { type: "array", nullable: true },
+            rulingId: { type: "string", nullable: true },
+            releaseWindowMs: { type: "integer", nullable: true },
+            expiresAt: { type: "integer", nullable: true },
+            autoActivate: { type: "boolean", nullable: true },
+        },
+    },
+    eventSchemas: {
+        deposit: {
+            properties: {
+                amount: { type: "number" },
+            },
+        },
+        activate: {},
+        request_release: {
+            properties: {
+                amount: { type: "number" },
+                reason: { type: "string", nullable: true },
+            },
+        },
+        approve_release: {},
+        dispute: {},
+        ruling: {
+            properties: {
+                judicialRuling: { type: "boolean" },
+                splits: { type: "array" },
+                rulingId: { type: "string" },
+            },
+        },
+        refund: {
+            properties: {
+                mutualConsent: { type: "boolean", nullable: true },
+            },
+        },
+        cancel: {},
+    },
+    states: {
+        CREATED: { id: "CREATED", isFinal: false, metadata: null },
+        FUNDED: { id: "FUNDED", isFinal: false, metadata: null },
+        ACTIVE: { id: "ACTIVE", isFinal: false, metadata: null },
+        RELEASING: { id: "RELEASING", isFinal: false, metadata: null },
+        DISPUTED: { id: "DISPUTED", isFinal: false, metadata: null },
+        RELEASED: { id: "RELEASED", isFinal: true, metadata: null },
+        REFUNDED: { id: "REFUNDED", isFinal: true, metadata: null },
+        SPLIT: { id: "SPLIT", isFinal: true, metadata: null },
+    },
+    initialState: "CREATED",
+    transitions: [
+        {
+            from: "CREATED",
+            to: "FUNDED",
+            eventName: "deposit",
+            guard: {
+                and: [
+                    { "===": [{ var: "event.agent" }, { var: "state.depositor" }] },
+                    { ">=": [{ var: "event.amount" }, { var: "state.requiredAmount" }] },
+                ],
+            },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    { balance: { var: "event.amount" }, fundedAt: { var: "$timestamp" } },
+                ],
+            },
+            dependencies: [],
+        },
+        {
+            from: "FUNDED",
+            to: "ACTIVE",
+            eventName: "activate",
+            guard: {
+                or: [
+                    { "===": [{ var: "event.agent" }, { var: "state.beneficiary" }] },
+                    { var: "state.autoActivate" },
+                ],
+            },
+            effect: {
+                merge: [{ var: "state" }, { activatedAt: { var: "$timestamp" } }],
+            },
+            dependencies: [],
+        },
+        {
+            from: "ACTIVE",
+            to: "RELEASING",
+            eventName: "request_release",
+            guard: { "===": [{ var: "event.agent" }, { var: "state.beneficiary" }] },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    {
+                        releaseRequest: {
+                            requestedBy: { var: "event.agent" },
+                            amount: { var: "event.amount" },
+                            reason: { var: "event.reason" },
+                            requestedAt: { var: "$timestamp" },
+                        },
+                        releaseDeadline: {
+                            "+": [{ var: "$timestamp" }, { var: "state.releaseWindowMs" }],
+                        },
+                    },
+                ],
+            },
+            dependencies: [],
+        },
+        {
+            from: "RELEASING",
+            to: "RELEASED",
+            eventName: "approve_release",
+            guard: {
+                or: [
+                    { "===": [{ var: "event.agent" }, { var: "state.depositor" }] },
+                    { ">=": [{ var: "$timestamp" }, { var: "state.releaseDeadline" }] },
+                ],
+            },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    {
+                        releasedAt: { var: "$timestamp" },
+                        releasedTo: { var: "state.beneficiary" },
+                    },
+                ],
+            },
+            dependencies: [],
+        },
+        {
+            from: "RELEASING",
+            to: "DISPUTED",
+            eventName: "dispute",
+            guard: {
+                and: [
+                    { "===": [{ var: "event.agent" }, { var: "state.depositor" }] },
+                    { "<": [{ var: "$timestamp" }, { var: "state.releaseDeadline" }] },
+                ],
+            },
+            effect: {
+                merge: [{ var: "state" }, { disputedAt: { var: "$timestamp" } }],
+            },
+            spawns: {
+                sm: "Judiciary",
+                initialData: {
+                    caseType: "escrow_dispute",
+                    plaintiff: { var: "state.depositor" },
+                    defendant: { var: "state.beneficiary" },
+                    claim: {
+                        escrowId: { var: "fiberId" },
+                        amount: { var: "state.balance" },
+                    },
+                },
+            },
+            dependencies: [],
+        },
+        {
+            from: "DISPUTED",
+            to: "SPLIT",
+            eventName: "ruling",
+            guard: { var: "event.judicialRuling" },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    {
+                        splits: { var: "event.splits" },
+                        rulingId: { var: "event.rulingId" },
+                    },
+                ],
+            },
+            dependencies: [],
+        },
+        {
+            from: "ACTIVE",
+            to: "REFUNDED",
+            eventName: "refund",
+            guard: {
+                or: [
+                    { var: "event.mutualConsent" },
+                    { ">=": [{ var: "$timestamp" }, { var: "state.expiresAt" }] },
+                ],
+            },
+            effect: {
+                merge: [{ var: "state" }, { refundedAt: { var: "$timestamp" } }],
+            },
+            dependencies: [],
+        },
+        {
+            from: "CREATED",
+            to: "REFUNDED",
+            eventName: "cancel",
+            guard: { "===": [{ var: "event.agent" }, { var: "state.depositor" }] },
+            effect: {
+                merge: [{ var: "state" }, { refundedAt: { var: "$timestamp" } }],
+            },
+            dependencies: [],
+        },
+    ],
+});

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

@@ -0,0 +1,90 @@
+import { defineFiberApp } from "../../../schema/fiber-app.js";
+/**
+ * Minimal contract state machine - extend for custom use cases.
+ */
+export const contractUniversalDef = defineFiberApp({
+    metadata: {
+        name: "ContractUniversal",
+        app: "contracts",
+        type: "universal",
+        version: "1.0.0",
+        description: "Minimal contract state machine - extend for custom use cases",
+    },
+    createSchema: {
+        properties: {},
+    },
+    stateSchema: {
+        properties: {
+            status: { type: "string" },
+            acceptedAt: { type: "integer", nullable: true },
+            cancelledAt: { type: "integer", nullable: true },
+            completedAt: { type: "integer", nullable: true },
+        },
+    },
+    eventSchemas: {
+        accept: {},
+        cancel: {},
+        complete: {},
+    },
+    states: {
+        PROPOSED: { id: "PROPOSED", isFinal: false, metadata: null },
+        ACTIVE: { id: "ACTIVE", isFinal: false, metadata: null },
+        COMPLETED: { id: "COMPLETED", isFinal: true, metadata: null },
+        CANCELLED: { id: "CANCELLED", isFinal: true, metadata: null },
+    },
+    initialState: "PROPOSED",
+    transitions: [
+        {
+            from: "PROPOSED",
+            to: "ACTIVE",
+            eventName: "accept",
+            guard: { "==": [1, 1] },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    { status: "ACTIVE", acceptedAt: { var: "$timestamp" } },
+                ],
+            },
+            dependencies: [],
+        },
+        {
+            from: "PROPOSED",
+            to: "CANCELLED",
+            eventName: "cancel",
+            guard: { "==": [1, 1] },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    { status: "CANCELLED", cancelledAt: { var: "$timestamp" } },
+                ],
+            },
+            dependencies: [],
+        },
+        {
+            from: "ACTIVE",
+            to: "COMPLETED",
+            eventName: "complete",
+            guard: { "==": [1, 1] },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    { status: "COMPLETED", completedAt: { var: "$timestamp" } },
+                ],
+            },
+            dependencies: [],
+        },
+        {
+            from: "ACTIVE",
+            to: "CANCELLED",
+            eventName: "cancel",
+            guard: { "==": [1, 1] },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    { status: "CANCELLED", cancelledAt: { var: "$timestamp" } },
+                ],
+            },
+            dependencies: [],
+        },
+    ],
+});

package/dist/esm/apps/contracts/state-machines/index.js

@@ -7,6 +7,8 @@ export const contractAgreementDef = {
         "name": "ContractAgreement",
         "description": "Two-party agreement with mutual completion attestation and dispute resolution",
         "version": "1.0.0",
+        "app": "contracts",
+        "type": "agreement",
         "crossReferences": {
             "proposerIdentityId": "Links to proposer's AgentIdentity fiber",
             "counterpartyIdentityId": "Links to counterparty's AgentIdentity fiber",
@@ -14,6 +16,49 @@ export const contractAgreementDef = {
             "arbitrationPoolId": "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"
+            }
+        }
+    },
+    "eventSchemas": {
+        "accept": {},
+        "reject": {},
+        "cancel": {},
+        "submit_completion": {},
+        "finalize": {},
+        "dispute": {},
+        "resolve": {}
+    },
     "states": {
         "PROPOSED": {
             "id": "PROPOSED",
@@ -351,6 +396,49 @@ export const contractAgreementDef = {
                 ]
             },
             "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": []
         }
     ]
 };
@@ -359,6 +447,8 @@ export const contractEscrowDef = {
         "name": "ContractEscrow",
         "description": "Asset custody with conditional release, dispute resolution, and split payments",
         "version": "1.0.0",
+        "app": "contracts",
+        "type": "escrow",
         "crossReferences": {
             "contractId": "Links to Contract SM that created this escrow",
             "marketId": "Links to Market SM for market-based escrow",
@@ -367,6 +457,47 @@ export const contractEscrowDef = {
             "treasuryId": "Links to Treasury for fee collection"
         }
     },
+    "createSchema": {
+        "required": [
+            "depositor",
+            "beneficiary",
+            "requiredAmount"
+        ],
+        "properties": {
+            "depositor": {
+                "type": "address",
+                "description": "DAG address of the depositor"
+            },
+            "beneficiary": {
+                "type": "address",
+                "description": "DAG address of the beneficiary"
+            },
+            "requiredAmount": {
+                "type": "number",
+                "minimum": 0,
+                "description": "Required escrow amount"
+            }
+        }
+    },
+    "stateSchema": {
+        "properties": {
+            "balance": {
+                "type": "number"
+            },
+            "releaseRequest": {
+                "type": "object"
+            }
+        }
+    },
+    "eventSchemas": {
+        "deposit": {},
+        "activate": {},
+        "request_release": {},
+        "approve_release": {},
+        "dispute": {},
+        "ruling": {},
+        "refund": {}
+    },
     "states": {
         "CREATED": {
             "id": "CREATED",
@@ -705,6 +836,34 @@ export const contractEscrowDef = {
                 ]
             },
             "dependencies": []
+        },
+        {
+            "from": "CREATED",
+            "to": "REFUNDED",
+            "eventName": "cancel",
+            "guard": {
+                "===": [
+                    {
+                        "var": "event.agent"
+                    },
+                    {
+                        "var": "state.depositor"
+                    }
+                ]
+            },
+            "effect": {
+                "merge": [
+                    {
+                        "var": "state"
+                    },
+                    {
+                        "refundedAt": {
+                            "var": "$timestamp"
+                        }
+                    }
+                ]
+            },
+            "dependencies": []
         }
     ]
 };
@@ -712,7 +871,24 @@ export const contractUniversalDef = {
     "metadata": {
         "name": "ContractUniversal",
         "description": "Minimal contract state machine - extend for custom use cases",
-        "version": "1.0.0"
+        "version": "1.0.0",
+        "app": "contracts",
+        "type": "universal"
+    },
+    "createSchema": {
+        "properties": {}
+    },
+    "stateSchema": {
+        "properties": {
+            "status": {
+                "type": "string"
+            }
+        }
+    },
+    "eventSchemas": {
+        "accept": {},
+        "cancel": {},
+        "complete": {}
     },
     "states": {
         "PROPOSED": {

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

@@ -20,12 +20,12 @@
  * @packageDocumentation
  */
 // Re-export generated protobuf types (source of truth)
-export { EntityType, EntityState, DirectorStatus, OfficerStatus, BoardMeetingType, ResolutionStatus, Jurisdiction, ShareClass, CorporateEntity, RegisteredAgent, Incorporator, ShareStructure, CorporateBoard, Director, SeatInfo, QuorumRules, BoardMeeting, MeetingAttendee, CorporateOfficers, Officer, OfficerAction, CorporateShareholders, Shareholder, ShareHolding, CorporateResolution, ResolutionVote, CorporateSecurities, SecurityIssuance, SecurityTransfer, CorporateCompliance, FilingRecord, ComplianceRequirement, CreateEntityRequest, AppointDirectorRequest, IssueSharesRequest, ProposeResolutionRequest, entityTypeFromJSON, entityTypeToJSON, entityStateFromJSON, entityStateToJSON, directorStatusFromJSON, directorStatusToJSON, officerStatusFromJSON, officerStatusToJSON, boardMeetingTypeFromJSON, boardMeetingTypeToJSON, resolutionStatusFromJSON, resolutionStatusToJSON, } from '../../generated/ottochain/apps/corporate/v1/corporate.js';
+export { EntityType, EntityState, DirectorStatus, OfficerStatus, BoardMeetingType, ResolutionStatus, Jurisdiction, ShareClass, CorporateEntity, RegisteredAgent, Incorporator, ShareStructure, CorporateBoard, Director, SeatInfo, QuorumRules, BoardMeeting, MeetingAttendee, CorporateOfficers, Officer, OfficerAction, CorporateShareholders, Shareholder, ShareHolding, CorporateResolution, ResolutionVote, CorporateSecurities, SecurityIssuance, SecurityTransfer, CorporateCompliance, FilingRecord, ComplianceRequirement, CreateEntityRequest, AppointDirectorRequest, IssueSharesRequest, ProposeResolutionRequest, entityTypeFromJSON, entityTypeToJSON, entityStateFromJSON, entityStateToJSON, directorStatusFromJSON, directorStatusToJSON, officerStatusFromJSON, officerStatusToJSON, boardMeetingTypeFromJSON, boardMeetingTypeToJSON, resolutionStatusFromJSON, resolutionStatusToJSON, } from "../../generated/ottochain/apps/corporate/v1/corporate.js";
 // ---------------------------------------------------------------------------
 // State Machine Definitions (generated from JSON at build time)
 // ---------------------------------------------------------------------------
-import { corpEntityDef, corpBoardDef, corpShareholdersDef, corpSecuritiesDef, } from './state-machines/index.js';
-export { corpEntityDef, corpBoardDef, corpShareholdersDef, corpSecuritiesDef, };
+import { corpEntityDef, corpBoardDef, corpShareholdersDef, corpSecuritiesDef, } from "./state-machines/index.js";
+export { corpEntityDef, corpBoardDef, corpShareholdersDef, corpSecuritiesDef };
 /** All corporate state machine definitions */
 export const CORPORATE_DEFINITIONS = {
     entity: corpEntityDef,