@ottochain/sdk 0.2.0

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

@@ -0,0 +1,35 @@
+/**
+ * Governance & DAO Types
+ *
+ * TypeScript types matching the JSON Logic state machine definitions
+ * in ottochain/docs/trust-graph/state-machines/dao/
+ *
+ * @packageDocumentation
+ */
+// =============================================================================
+// Helpers
+// =============================================================================
+/**
+ * Type guard for SingleOwnerDAO
+ */
+export function isSingleOwnerDAO(state) {
+    return state.schema === 'SingleOwnerDAO';
+}
+/**
+ * Type guard for MultisigDAO
+ */
+export function isMultisigDAO(state) {
+    return state.schema === 'MultisigDAO';
+}
+/**
+ * Type guard for TokenDAO
+ */
+export function isTokenDAO(state) {
+    return state.schema === 'TokenDAO';
+}
+/**
+ * Type guard for ThresholdDAO
+ */
+export function isThresholdDAO(state) {
+    return state.schema === 'ThresholdDAO';
+}

package/dist/esm/apps/identity/constants.js

@@ -0,0 +1,53 @@
+/**
+ * Identity Constants
+ *
+ * State machine transitions and configuration constants for agent identity.
+ *
+ * @packageDocumentation
+ */
+import { AgentState } from '../../generated/ottochain/apps/identity/v1/agent.js';
+import { AttestationType } from '../../generated/ottochain/apps/identity/v1/attestation.js';
+// ---------------------------------------------------------------------------
+// State Machine Transitions
+// ---------------------------------------------------------------------------
+/**
+ * Valid transitions for each agent state.
+ * Maps current state to allowed event names.
+ */
+export const AGENT_TRANSITIONS = {
+    [AgentState.AGENT_STATE_UNSPECIFIED]: [],
+    [AgentState.AGENT_STATE_REGISTERED]: ['activate', 'withdraw'],
+    [AgentState.AGENT_STATE_ACTIVE]: ['challenge', 'withdraw'],
+    [AgentState.AGENT_STATE_CHALLENGED]: ['uphold_challenge', 'dismiss_challenge'],
+    [AgentState.AGENT_STATE_SUSPENDED]: ['begin_probation'],
+    [AgentState.AGENT_STATE_PROBATION]: ['complete_probation'],
+    [AgentState.AGENT_STATE_WITHDRAWN]: [], // Terminal state
+    [AgentState.UNRECOGNIZED]: [],
+};
+// ---------------------------------------------------------------------------
+// Reputation Configuration
+// ---------------------------------------------------------------------------
+/**
+ * Reputation delta by attestation type.
+ * These values match the metagraph state machine defaults.
+ */
+export const ATTESTATION_DELTAS = {
+    [AttestationType.ATTESTATION_TYPE_UNSPECIFIED]: 0,
+    [AttestationType.ATTESTATION_TYPE_COMPLETION]: 5,
+    [AttestationType.ATTESTATION_TYPE_VOUCH]: 2,
+    [AttestationType.ATTESTATION_TYPE_VIOLATION]: -10,
+    [AttestationType.ATTESTATION_TYPE_BEHAVIORAL]: 3,
+    [AttestationType.UNRECOGNIZED]: 0,
+};
+/**
+ * Check if a transition is valid for the given state.
+ */
+export function canTransition(state, event) {
+    return AGENT_TRANSITIONS[state]?.includes(event) ?? false;
+}
+/**
+ * Get reputation delta for an attestation type.
+ */
+export function getReputationDelta(type) {
+    return ATTESTATION_DELTAS[type] ?? 0;
+}

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

@@ -0,0 +1,50 @@
+/**
+ * Agent Identity Application
+ *
+ * Types and utilities for the Agent Identity system on OttoChain.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   AgentState,
+ *   AgentIdentity,
+ *   getIdentityDefinition
+ * } from '@ottochain/sdk/apps/identity';
+ *
+ * const identityDef = getIdentityDefinition();
+ * ```
+ *
+ * @packageDocumentation
+ */
+// Re-export generated protobuf types (source of truth)
+export { AgentState, Platform, PlatformLink, AgentIdentity, AgentIdentityDefinition, agentStateFromJSON, agentStateToJSON, platformFromJSON, platformToJSON, } from '../../generated/ottochain/apps/identity/v1/agent.js';
+export { AttestationType, ReputationDelta, Attestation, VouchRequest, ChallengeRequest, ReputationConfig, attestationTypeFromJSON, attestationTypeToJSON, } from '../../generated/ottochain/apps/identity/v1/attestation.js';
+// Re-export constants and utilities
+export { AGENT_TRANSITIONS, ATTESTATION_DELTAS, canTransition, getReputationDelta, } from './constants.js';
+// ---------------------------------------------------------------------------
+// Configuration Defaults
+// ---------------------------------------------------------------------------
+/**
+ * Default reputation configuration for agent identity
+ */
+export const DEFAULT_REPUTATION_CONFIG = {
+    baseReputation: 10,
+    completionDelta: 5,
+    vouchDelta: 2,
+    violationDelta: -10,
+    behavioralDelta: 3,
+    minReputation: 0,
+    challengeThreshold: 5,
+};
+// ---------------------------------------------------------------------------
+// State Machine JSON Definition
+// ---------------------------------------------------------------------------
+import agentIdentityDef from './state-machines/agent-identity.json';
+/**
+ * Get the agent identity state machine definition.
+ *
+ * @returns The state machine definition JSON for AgentIdentity
+ */
+export function getIdentityDefinition() {
+    return agentIdentityDef;
+}

package/dist/esm/apps/identity/state-machines/agent-identity.json

@@ -0,0 +1,320 @@
+{
+    "metadata": {
+        "name": "AgentIdentity",
+        "description": "Decentralized agent identity with reputation tracking and lifecycle management",
+        "version": "1.0.0"
+    },
+    "states": {
+        "REGISTERED": {
+            "id": {
+                "value": "REGISTERED"
+            },
+            "isFinal": false,
+            "metadata": null
+        },
+        "ACTIVE": {
+            "id": {
+                "value": "ACTIVE"
+            },
+            "isFinal": false,
+            "metadata": null
+        },
+        "CHALLENGED": {
+            "id": {
+                "value": "CHALLENGED"
+            },
+            "isFinal": false,
+            "metadata": null
+        },
+        "SUSPENDED": {
+            "id": {
+                "value": "SUSPENDED"
+            },
+            "isFinal": false,
+            "metadata": null
+        },
+        "PROBATION": {
+            "id": {
+                "value": "PROBATION"
+            },
+            "isFinal": false,
+            "metadata": null
+        },
+        "WITHDRAWN": {
+            "id": {
+                "value": "WITHDRAWN"
+            },
+            "isFinal": true,
+            "metadata": null
+        }
+    },
+    "initialState": {
+        "value": "REGISTERED"
+    },
+    "transitions": [
+        {
+            "from": {
+                "value": "REGISTERED"
+            },
+            "to": {
+                "value": "ACTIVE"
+            },
+            "eventName": "activate",
+            "guard": {
+                "==": [
+                    1,
+                    1
+                ]
+            },
+            "effect": {
+                "merge": [
+                    {
+                        "var": "state"
+                    },
+                    {
+                        "status": "ACTIVE",
+                        "activatedAt": {
+                            "var": "$timestamp"
+                        }
+                    }
+                ]
+            },
+            "dependencies": []
+        },
+        {
+            "from": {
+                "value": "ACTIVE"
+            },
+            "to": {
+                "value": "ACTIVE"
+            },
+            "eventName": "receive_vouch",
+            "guard": {
+                "!!": [
+                    {
+                        "var": "event.from"
+                    }
+                ]
+            },
+            "effect": {
+                "merge": [
+                    {
+                        "var": "state"
+                    },
+                    {
+                        "reputation": {
+                            "+": [
+                                {
+                                    "var": "state.reputation"
+                                },
+                                2
+                            ]
+                        }
+                    }
+                ]
+            },
+            "dependencies": []
+        },
+        {
+            "from": {
+                "value": "ACTIVE"
+            },
+            "to": {
+                "value": "ACTIVE"
+            },
+            "eventName": "receive_completion",
+            "guard": {
+                "==": [
+                    1,
+                    1
+                ]
+            },
+            "effect": {
+                "merge": [
+                    {
+                        "var": "state"
+                    },
+                    {
+                        "reputation": {
+                            "+": [
+                                {
+                                    "var": "state.reputation"
+                                },
+                                5
+                            ]
+                        }
+                    }
+                ]
+            },
+            "dependencies": []
+        },
+        {
+            "from": {
+                "value": "ACTIVE"
+            },
+            "to": {
+                "value": "CHALLENGED"
+            },
+            "eventName": "challenge",
+            "guard": {
+                "!!": [
+                    {
+                        "var": "event.challenger"
+                    }
+                ]
+            },
+            "effect": {
+                "merge": [
+                    {
+                        "var": "state"
+                    },
+                    {
+                        "status": "CHALLENGED",
+                        "challengedBy": {
+                            "var": "event.challenger"
+                        }
+                    }
+                ]
+            },
+            "dependencies": []
+        },
+        {
+            "from": {
+                "value": "CHALLENGED"
+            },
+            "to": {
+                "value": "ACTIVE"
+            },
+            "eventName": "dismiss_challenge",
+            "guard": {
+                "==": [
+                    1,
+                    1
+                ]
+            },
+            "effect": {
+                "merge": [
+                    {
+                        "var": "state"
+                    },
+                    {
+                        "status": "ACTIVE",
+                        "challengedBy": null
+                    }
+                ]
+            },
+            "dependencies": []
+        },
+        {
+            "from": {
+                "value": "CHALLENGED"
+            },
+            "to": {
+                "value": "SUSPENDED"
+            },
+            "eventName": "uphold_challenge",
+            "guard": {
+                "==": [
+                    1,
+                    1
+                ]
+            },
+            "effect": {
+                "merge": [
+                    {
+                        "var": "state"
+                    },
+                    {
+                        "status": "SUSPENDED",
+                        "suspendedAt": {
+                            "var": "$timestamp"
+                        }
+                    }
+                ]
+            },
+            "dependencies": []
+        },
+        {
+            "from": {
+                "value": "SUSPENDED"
+            },
+            "to": {
+                "value": "PROBATION"
+            },
+            "eventName": "begin_probation",
+            "guard": {
+                "==": [
+                    1,
+                    1
+                ]
+            },
+            "effect": {
+                "merge": [
+                    {
+                        "var": "state"
+                    },
+                    {
+                        "status": "PROBATION",
+                        "probationStartedAt": {
+                            "var": "$timestamp"
+                        }
+                    }
+                ]
+            },
+            "dependencies": []
+        },
+        {
+            "from": {
+                "value": "PROBATION"
+            },
+            "to": {
+                "value": "ACTIVE"
+            },
+            "eventName": "complete_probation",
+            "guard": {
+                "==": [
+                    1,
+                    1
+                ]
+            },
+            "effect": {
+                "merge": [
+                    {
+                        "var": "state"
+                    },
+                    {
+                        "status": "ACTIVE",
+                        "probationStartedAt": null
+                    }
+                ]
+            },
+            "dependencies": []
+        },
+        {
+            "from": {
+                "value": "ACTIVE"
+            },
+            "to": {
+                "value": "WITHDRAWN"
+            },
+            "eventName": "withdraw",
+            "guard": {
+                "==": [
+                    1,
+                    1
+                ]
+            },
+            "effect": {
+                "merge": [
+                    {
+                        "var": "state"
+                    },
+                    {
+                        "status": "WITHDRAWN"
+                    }
+                ]
+            },
+            "dependencies": []
+        }
+    ]
+}

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

@@ -0,0 +1,50 @@
+/**
+ * Agent Identity Utilities
+ *
+ * Constants and utilities for the Agent Identity application.
+ * Core types are generated from protobuf - see the generated exports.
+ *
+ * @packageDocumentation
+ */
+import { AgentState } from '../../generated/ottochain/apps/identity/v1/agent_pb.js';
+import { AttestationType } from '../../generated/ottochain/apps/identity/v1/attestation_pb.js';
+// ---------------------------------------------------------------------------
+// Configuration Defaults
+// ---------------------------------------------------------------------------
+/**
+ * Default reputation configuration for agent identity
+ */
+export const DEFAULT_REPUTATION_CONFIG = {
+    baseReputation: 10,
+    completionDelta: 5,
+    vouchDelta: 2,
+    violationDelta: -10,
+    behavioralDelta: 3,
+    minReputation: 0,
+    challengeThreshold: 5,
+};
+// ---------------------------------------------------------------------------
+// State Machine Transitions
+// ---------------------------------------------------------------------------
+/**
+ * Valid transitions for each agent state
+ */
+export const AGENT_TRANSITIONS = {
+    [AgentState.UNSPECIFIED]: [],
+    [AgentState.REGISTERED]: ['activate', 'withdraw'],
+    [AgentState.ACTIVE]: ['challenge', 'withdraw'],
+    [AgentState.CHALLENGED]: ['uphold_challenge', 'dismiss_challenge'],
+    [AgentState.SUSPENDED]: ['begin_probation'],
+    [AgentState.PROBATION]: ['complete_probation'],
+    [AgentState.WITHDRAWN]: [], // Terminal state
+};
+/**
+ * Reputation delta by attestation type
+ */
+export const ATTESTATION_DELTAS = {
+    [AttestationType.UNSPECIFIED]: 0,
+    [AttestationType.COMPLETION]: 5,
+    [AttestationType.VOUCH]: 2,
+    [AttestationType.VIOLATION]: -10,
+    [AttestationType.BEHAVIORAL]: 3,
+};

package/dist/esm/apps/index.js

@@ -0,0 +1,32 @@
+/**
+ * OttoChain Applications
+ *
+ * Application-specific types and utilities for OttoChain SDK.
+ *
+ * @example
+ * ```typescript
+ * import { identity, contracts, markets, oracles, governance } from '@ottochain/sdk/apps';
+ *
+ * // Use identity types
+ * const { AgentState } = identity;
+ *
+ * // Check oracle reputation
+ * const state = oracles.OracleState.ACTIVE;
+ *
+ * // Create a multisig DAO
+ * const dao = governance.createMultisigState({
+ *   name: 'Treasury',
+ *   signers: ['DAG...', 'DAG...', 'DAG...'],
+ *   threshold: 2
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+// Re-export as namespaces for organized access
+export * as identity from './identity/index.js';
+export * as contracts from './contracts/index.js';
+export * as markets from './markets/index.js';
+export * as oracles from './oracles/index.js';
+export * as governance from './governance/index.js';
+export * as corporate from './corporate/index.js';

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

@@ -0,0 +1,34 @@
+/**
+ * Markets Application
+ *
+ * Types and utilities for prediction markets on OttoChain.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   MarketType,
+ *   MarketState,
+ *   Market,
+ *   getMarketDefinition
+ * } from '@ottochain/sdk/apps/markets';
+ *
+ * const marketDef = getMarketDefinition();
+ * ```
+ *
+ * @packageDocumentation
+ */
+// Re-export generated protobuf types (source of truth)
+export { MarketType, MarketState, Commitment, Resolution, Market, CreateMarketRequest, CommitToMarketRequest, SubmitResolutionRequest, CancelMarketRequest, MarketDefinition, marketTypeFromJSON, marketTypeToJSON, marketStateFromJSON, marketStateToJSON, } from '../../generated/ottochain/apps/markets/v1/market.js';
+// ---------------------------------------------------------------------------
+// State Machine JSON Definitions
+// ---------------------------------------------------------------------------
+import marketUniversalDef from './state-machines/market-universal.json';
+export const MARKET_DEFINITIONS = {
+    Universal: marketUniversalDef,
+};
+/**
+ * Get the market state machine definition.
+ */
+export function getMarketDefinition(type = 'Universal') {
+    return MARKET_DEFINITIONS[type];
+}