@ottochain/sdk 0.2.0

package/dist/esm/apps/contracts/state-machines/escrow.json

@@ -0,0 +1,426 @@
+{
+    "metadata": {
+        "name": "Escrow",
+        "description": "Asset custody during multi-party transactions with conditional release",
+        "version": "1.0.0"
+    },
+    "states": {
+        "CREATED": {
+            "id": {
+                "value": "CREATED"
+            },
+            "isFinal": false,
+            "metadata": null
+        },
+        "FUNDED": {
+            "id": {
+                "value": "FUNDED"
+            },
+            "isFinal": false,
+            "metadata": null
+        },
+        "ACTIVE": {
+            "id": {
+                "value": "ACTIVE"
+            },
+            "isFinal": false,
+            "metadata": null
+        },
+        "RELEASING": {
+            "id": {
+                "value": "RELEASING"
+            },
+            "isFinal": false,
+            "metadata": null
+        },
+        "DISPUTED": {
+            "id": {
+                "value": "DISPUTED"
+            },
+            "isFinal": false,
+            "metadata": null
+        },
+        "RELEASED": {
+            "id": {
+                "value": "RELEASED"
+            },
+            "isFinal": true,
+            "metadata": null
+        },
+        "REFUNDED": {
+            "id": {
+                "value": "REFUNDED"
+            },
+            "isFinal": true,
+            "metadata": null
+        },
+        "SPLIT": {
+            "id": {
+                "value": "SPLIT"
+            },
+            "isFinal": true,
+            "metadata": null
+        }
+    },
+    "initialState": {
+        "value": "CREATED"
+    },
+    "crossReferences": {
+        "contractId": "Links to Contract SM that created this escrow",
+        "marketId": "Links to Market SM for market-based escrow",
+        "insuranceId": "Links to Insurance SM for protected escrow",
+        "arbitrationPoolId": "Links to ArbitrationPool for dispute resolution",
+        "treasuryId": "Links to Treasury for fee collection"
+    },
+    "transitions": [
+        {
+            "from": {
+                "value": "CREATED"
+            },
+            "to": {
+                "value": "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": {
+                "value": "FUNDED"
+            },
+            "to": {
+                "value": "ACTIVE"
+            },
+            "eventName": "activate",
+            "guard": {
+                "or": [
+                    {
+                        "===": [
+                            {
+                                "var": "event.agent"
+                            },
+                            {
+                                "var": "state.beneficiary"
+                            }
+                        ]
+                    },
+                    {
+                        "var": "state.autoActivate"
+                    }
+                ]
+            },
+            "effect": {
+                "merge": [
+                    {
+                        "var": "state"
+                    },
+                    {
+                        "activatedAt": {
+                            "var": "$timestamp"
+                        }
+                    }
+                ]
+            },
+            "emits": {
+                "target": "Contract",
+                "event": "escrow_activated",
+                "payload": {
+                    "escrowId": {
+                        "var": "fiberId"
+                    }
+                }
+            },
+            "dependencies": []
+        },
+        {
+            "from": {
+                "value": "ACTIVE"
+            },
+            "to": {
+                "value": "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": {
+                "value": "RELEASING"
+            },
+            "to": {
+                "value": "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"
+                        }
+                    }
+                ]
+            },
+            "emits": {
+                "target": "Treasury",
+                "event": "collect_fee",
+                "payload": {
+                    "amount": {
+                        "*": [
+                            {
+                                "var": "state.balance"
+                            },
+                            {
+                                "var": "state.feePercent"
+                            }
+                        ]
+                    },
+                    "source": "escrow"
+                }
+            },
+            "dependencies": []
+        },
+        {
+            "from": {
+                "value": "RELEASING"
+            },
+            "to": {
+                "value": "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": {
+                "value": "DISPUTED"
+            },
+            "to": {
+                "value": "SPLIT"
+            },
+            "eventName": "ruling",
+            "guard": {
+                "var": "event.judicialRuling"
+            },
+            "effect": {
+                "merge": [
+                    {
+                        "var": "state"
+                    },
+                    {
+                        "splits": {
+                            "var": "event.splits"
+                        },
+                        "rulingId": {
+                            "var": "event.rulingId"
+                        }
+                    }
+                ]
+            },
+            "dependencies": []
+        },
+        {
+            "from": {
+                "value": "ACTIVE"
+            },
+            "to": {
+                "value": "REFUNDED"
+            },
+            "eventName": "refund",
+            "guard": {
+                "or": [
+                    {
+                        "var": "event.mutualConsent"
+                    },
+                    {
+                        ">=": [
+                            {
+                                "var": "$timestamp"
+                            },
+                            {
+                                "var": "state.expiresAt"
+                            }
+                        ]
+                    }
+                ]
+            },
+            "effect": {
+                "merge": [
+                    {
+                        "var": "state"
+                    },
+                    {
+                        "refundedAt": {
+                            "var": "$timestamp"
+                        }
+                    }
+                ]
+            },
+            "dependencies": []
+        }
+    ]
+}

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

@@ -0,0 +1,44 @@
+/**
+ * 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';
+// ---------------------------------------------------------------------------
+// Configuration Defaults
+// ---------------------------------------------------------------------------
+/**
+ * Default contract configuration
+ */
+export const DEFAULT_CONTRACT_CONFIG = {
+    requireBothSignatures: false,
+    disputeWindowEpochs: 10,
+};
+// ---------------------------------------------------------------------------
+// State Machine Transitions
+// ---------------------------------------------------------------------------
+/**
+ * Valid transitions for each contract state
+ */
+export const CONTRACT_TRANSITIONS = {
+    [ContractState.UNSPECIFIED]: [],
+    [ContractState.PROPOSED]: ['accept', 'reject', 'cancel'],
+    [ContractState.ACTIVE]: ['complete', 'dispute'],
+    [ContractState.DISPUTED]: ['resolve_for_completer', 'resolve_for_disputant'],
+    [ContractState.COMPLETED]: [], // Terminal state
+    [ContractState.REJECTED]: [], // Terminal state
+    [ContractState.CANCELLED]: [], // Terminal state
+};
+/**
+ * Check if a contract state is terminal (no further transitions allowed)
+ */
+export function isTerminalState(state) {
+    return [
+        ContractState.COMPLETED,
+        ContractState.REJECTED,
+        ContractState.CANCELLED,
+    ].includes(state);
+}

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

@@ -0,0 +1,57 @@
+/**
+ * Corporate Governance Application
+ *
+ * Types and utilities for corporate entity management on OttoChain.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   EntityType,
+ *   EntityState,
+ *   CorporateEntity,
+ *   getCorporateDefinition
+ * } from '@ottochain/sdk/apps/corporate';
+ *
+ * const entityDef = getCorporateDefinition('Entity');
+ * const boardDef = getCorporateDefinition('Board');
+ * ```
+ *
+ * @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';
+// ---------------------------------------------------------------------------
+// State Machine JSON Definitions
+// ---------------------------------------------------------------------------
+import corporateEntityDef from './state-machines/corporate-entity.json';
+import corporateBoardDef from './state-machines/corporate-board.json';
+import corporateShareholdersDef from './state-machines/corporate-shareholders.json';
+import corporateOfficersDef from './state-machines/corporate-officers.json';
+import corporateSecuritiesDef from './state-machines/corporate-securities.json';
+import corporateComplianceDef from './state-machines/corporate-compliance.json';
+import corporateBylawsDef from './state-machines/corporate-bylaws.json';
+import corporateCommitteeDef from './state-machines/corporate-committee.json';
+import corporateProxyDef from './state-machines/corporate-proxy.json';
+import corporateResolutionDef from './state-machines/corporate-resolution.json';
+export const CORPORATE_DEFINITIONS = {
+    Entity: corporateEntityDef,
+    Board: corporateBoardDef,
+    Shareholders: corporateShareholdersDef,
+    Officers: corporateOfficersDef,
+    Securities: corporateSecuritiesDef,
+    Compliance: corporateComplianceDef,
+    Bylaws: corporateBylawsDef,
+    Committee: corporateCommitteeDef,
+    Proxy: corporateProxyDef,
+    Resolution: corporateResolutionDef,
+};
+/**
+ * Get the state machine definition for a corporate type.
+ */
+export function getCorporateDefinition(type) {
+    const def = CORPORATE_DEFINITIONS[type];
+    if (!def) {
+        throw new Error(`Unknown corporate type: ${type}`);
+    }
+    return def;
+}