@ottochain/sdk 1.0.2 → 1.1.0

package/dist/apps/oracles/types.js

@@ -1,306 +0,0 @@
-"use strict";
-/**
- * Oracles Application Types
- *
- * Constants, types, and utilities for the Oracle system on OttoChain.
- * Oracles provide truth resolution for markets and disputes.
- *
- * Note: When proto files are generated, enums will move to generated types.
- *
- * @packageDocumentation
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isResolutionType = exports.isSlashingReason = exports.isOracleState = exports.calculateOracleReward = exports.calculateSelectionScore = exports.calculateStakeAfterSlash = exports.calculateSlashAmount = exports.SLASHING_CONDITIONS = exports.qualifiesForHighValue = exports.calculateWeightedReputation = exports.calculateReputation = exports.REPUTATION_DELTAS = exports.canAcceptAssignment = exports.isTerminalOracleState = exports.ORACLE_TRANSITIONS = exports.SLASHING_PERCENTAGES = exports.DEFAULT_ORACLE_CONFIG = exports.SlashingReason = exports.ResolutionType = exports.OracleState = void 0;
-// ---------------------------------------------------------------------------
-// Enums (will be replaced by proto-generated versions)
-// ---------------------------------------------------------------------------
-/**
- * Oracle lifecycle states
- */
-var OracleState;
-(function (OracleState) {
-    OracleState[OracleState["UNSPECIFIED"] = 0] = "UNSPECIFIED";
-    /** Oracle has registered but not yet staked */
-    OracleState[OracleState["REGISTERED"] = 1] = "REGISTERED";
-    /** Oracle is staked and available for assignments */
-    OracleState[OracleState["ACTIVE"] = 2] = "ACTIVE";
-    /** Oracle is currently assigned to resolve a market */
-    OracleState[OracleState["ASSIGNED"] = 3] = "ASSIGNED";
-    /** Oracle has submitted a resolution, in challenge period */
-    OracleState[OracleState["SUBMITTED"] = 4] = "SUBMITTED";
-    /** Oracle is under review due to dispute */
-    OracleState[OracleState["CHALLENGED"] = 5] = "CHALLENGED";
-    /** Oracle is suspended due to slashing */
-    OracleState[OracleState["SUSPENDED"] = 6] = "SUSPENDED";
-    /** Oracle has withdrawn stake and exited */
-    OracleState[OracleState["WITHDRAWN"] = 7] = "WITHDRAWN";
-})(OracleState || (exports.OracleState = OracleState = {}));
-/**
- * Types of oracle resolutions
- */
-var ResolutionType;
-(function (ResolutionType) {
-    ResolutionType[ResolutionType["UNSPECIFIED"] = 0] = "UNSPECIFIED";
-    /** Binary yes/no outcome */
-    ResolutionType[ResolutionType["BINARY"] = 1] = "BINARY";
-    /** One of multiple predefined outcomes */
-    ResolutionType[ResolutionType["MULTI_CHOICE"] = 2] = "MULTI_CHOICE";
-    /** Numeric value (e.g., price) */
-    ResolutionType[ResolutionType["NUMERIC"] = 3] = "NUMERIC";
-    /** Free-form attestation */
-    ResolutionType[ResolutionType["ATTESTATION"] = 4] = "ATTESTATION";
-})(ResolutionType || (exports.ResolutionType = ResolutionType = {}));
-/**
- * Reasons for slashing oracle stake
- */
-var SlashingReason;
-(function (SlashingReason) {
-    SlashingReason[SlashingReason["UNSPECIFIED"] = 0] = "UNSPECIFIED";
-    /** Failed to submit resolution in time */
-    SlashingReason[SlashingReason["TIMEOUT"] = 1] = "TIMEOUT";
-    /** Resolution overturned by dispute */
-    SlashingReason[SlashingReason["INCORRECT_RESOLUTION"] = 2] = "INCORRECT_RESOLUTION";
-    /** Evidence of collusion or manipulation */
-    SlashingReason[SlashingReason["COLLUSION"] = 3] = "COLLUSION";
-    /** Violation of oracle protocol */
-    SlashingReason[SlashingReason["PROTOCOL_VIOLATION"] = 4] = "PROTOCOL_VIOLATION";
-})(SlashingReason || (exports.SlashingReason = SlashingReason = {}));
-/**
- * Default oracle configuration
- */
-exports.DEFAULT_ORACLE_CONFIG = {
-    minStake: 10000n,
-    timeoutSlashPercent: 0.05,
-    incorrectSlashPercent: 0.25,
-    collusionSlashPercent: 1.0,
-    violationSlashPercent: 0.10,
-    cooldownEpochs: 48,
-    baseReputation: 50,
-    highValueThreshold: 100,
-    resolutionWindowEpochs: 12,
-    challengeWindowEpochs: 6,
-    oracleRewardPercent: 0.01,
-};
-/**
- * Slashing percentages by reason
- */
-exports.SLASHING_PERCENTAGES = {
-    [SlashingReason.UNSPECIFIED]: 0,
-    [SlashingReason.TIMEOUT]: exports.DEFAULT_ORACLE_CONFIG.timeoutSlashPercent,
-    [SlashingReason.INCORRECT_RESOLUTION]: exports.DEFAULT_ORACLE_CONFIG.incorrectSlashPercent,
-    [SlashingReason.COLLUSION]: exports.DEFAULT_ORACLE_CONFIG.collusionSlashPercent,
-    [SlashingReason.PROTOCOL_VIOLATION]: exports.DEFAULT_ORACLE_CONFIG.violationSlashPercent,
-};
-// ---------------------------------------------------------------------------
-// State Machine Transitions
-// ---------------------------------------------------------------------------
-/**
- * Valid transitions for each oracle state
- */
-exports.ORACLE_TRANSITIONS = {
-    [OracleState.UNSPECIFIED]: [],
-    [OracleState.REGISTERED]: ['stake', 'withdraw'],
-    [OracleState.ACTIVE]: ['assign', 'unstake'],
-    [OracleState.ASSIGNED]: ['submit', 'timeout'],
-    [OracleState.SUBMITTED]: ['finalize', 'challenge'],
-    [OracleState.CHALLENGED]: ['uphold', 'overturn'],
-    [OracleState.SUSPENDED]: ['begin_probation', 'permanent_ban'],
-    [OracleState.WITHDRAWN]: [], // Terminal state
-};
-/**
- * Check if an oracle state is terminal
- */
-function isTerminalOracleState(state) {
-    return state === OracleState.WITHDRAWN;
-}
-exports.isTerminalOracleState = isTerminalOracleState;
-/**
- * Check if an oracle can accept new assignments
- */
-function canAcceptAssignment(state) {
-    return state === OracleState.ACTIVE;
-}
-exports.canAcceptAssignment = canAcceptAssignment;
-// ---------------------------------------------------------------------------
-// Reputation Calculations
-// ---------------------------------------------------------------------------
-/**
- * Reputation update factors
- */
-exports.REPUTATION_DELTAS = {
-    /** Successfully resolved market without challenge */
-    successfulResolution: 5,
-    /** Resolution upheld after challenge */
-    upheldChallenge: 10,
-    /** Resolution overturned (negative) */
-    overturnedResolution: -25,
-    /** Timeout on assigned market (negative) */
-    timeout: -15,
-    /** Collusion detected (negative) */
-    collusion: -100,
-    /** Protocol violation (negative) */
-    violation: -20,
-    /** Bonus for high-value market resolution */
-    highValueBonus: 3,
-};
-/**
- * Calculate new reputation after an event
- *
- * @param currentReputation - Current reputation score
- * @param delta - Reputation change (positive or negative)
- * @param minReputation - Minimum reputation floor (default 0)
- * @returns New reputation score
- */
-function calculateReputation(currentReputation, delta, minReputation = 0) {
-    return Math.max(minReputation, currentReputation + delta);
-}
-exports.calculateReputation = calculateReputation;
-/**
- * Calculate weighted reputation considering history
- *
- * @param baseReputation - Current base reputation
- * @param successCount - Number of successful resolutions
- * @param failureCount - Number of failed/overturned resolutions
- * @returns Weighted reputation score
- */
-function calculateWeightedReputation(baseReputation, successCount, failureCount) {
-    const totalAttempts = successCount + failureCount;
-    if (totalAttempts === 0)
-        return baseReputation;
-    const successRate = successCount / totalAttempts;
-    const experienceMultiplier = Math.min(1 + Math.log10(totalAttempts + 1) * 0.2, 1.5);
-    return Math.round(baseReputation * successRate * experienceMultiplier);
-}
-exports.calculateWeightedReputation = calculateWeightedReputation;
-/**
- * Check if oracle qualifies for high-value markets
- */
-function qualifiesForHighValue(reputation, stake, threshold = exports.DEFAULT_ORACLE_CONFIG.highValueThreshold, minStakeMultiplier = 5) {
-    return (reputation >= threshold &&
-        stake >= exports.DEFAULT_ORACLE_CONFIG.minStake * BigInt(minStakeMultiplier));
-}
-exports.qualifiesForHighValue = qualifiesForHighValue;
-/**
- * Predefined slashing conditions
- */
-exports.SLASHING_CONDITIONS = {
-    [SlashingReason.UNSPECIFIED]: {
-        reason: SlashingReason.UNSPECIFIED,
-        slashPercent: 0,
-        description: 'No slashing',
-        appealable: false,
-        suspensionEpochs: 0,
-    },
-    [SlashingReason.TIMEOUT]: {
-        reason: SlashingReason.TIMEOUT,
-        slashPercent: exports.DEFAULT_ORACLE_CONFIG.timeoutSlashPercent,
-        description: 'Failed to submit resolution within deadline',
-        appealable: true,
-        suspensionEpochs: 12,
-    },
-    [SlashingReason.INCORRECT_RESOLUTION]: {
-        reason: SlashingReason.INCORRECT_RESOLUTION,
-        slashPercent: exports.DEFAULT_ORACLE_CONFIG.incorrectSlashPercent,
-        description: 'Resolution overturned by dispute process',
-        appealable: true,
-        suspensionEpochs: 48,
-    },
-    [SlashingReason.COLLUSION]: {
-        reason: SlashingReason.COLLUSION,
-        slashPercent: exports.DEFAULT_ORACLE_CONFIG.collusionSlashPercent,
-        description: 'Evidence of collusion or market manipulation',
-        appealable: false,
-        suspensionEpochs: -1, // Permanent
-    },
-    [SlashingReason.PROTOCOL_VIOLATION]: {
-        reason: SlashingReason.PROTOCOL_VIOLATION,
-        slashPercent: exports.DEFAULT_ORACLE_CONFIG.violationSlashPercent,
-        description: 'Violation of oracle operating protocol',
-        appealable: true,
-        suspensionEpochs: 24,
-    },
-};
-/**
- * Calculate slash amount for a given stake and reason
- *
- * @param stake - Oracle's current stake
- * @param reason - Reason for slashing
- * @returns Amount to be slashed
- */
-function calculateSlashAmount(stake, reason) {
-    const condition = exports.SLASHING_CONDITIONS[reason];
-    return (stake * BigInt(Math.floor(condition.slashPercent * 10000))) / 10000n;
-}
-exports.calculateSlashAmount = calculateSlashAmount;
-/**
- * Calculate remaining stake after slashing
- */
-function calculateStakeAfterSlash(stake, reason) {
-    return stake - calculateSlashAmount(stake, reason);
-}
-exports.calculateStakeAfterSlash = calculateStakeAfterSlash;
-/**
- * Calculate oracle selection score
- * Higher score = more likely to be selected
- *
- * @param candidate - Oracle candidate details
- * @param marketValue - Value of market to resolve (affects weight for high-value markets)
- * @returns Selection score
- */
-function calculateSelectionScore(candidate, marketValue = 0n) {
-    const reputationWeight = 0.4;
-    const stakeWeight = 0.3;
-    const successWeight = 0.2;
-    const loadWeight = 0.1;
-    // Normalize stake to 0-100 range (assuming 1M max)
-    const normalizedStake = Math.min(Number(candidate.stake / 10000n), 100);
-    // Load penalty (fewer active = better)
-    const loadScore = Math.max(0, 100 - candidate.activeAssignments * 20);
-    // High-value market bonus for qualified oracles
-    const highValueBonus = marketValue > 100000n &&
-        qualifiesForHighValue(candidate.reputation, candidate.stake) ? 10 : 0;
-    return (candidate.reputation * reputationWeight +
-        normalizedStake * stakeWeight +
-        candidate.successRate * 100 * successWeight +
-        loadScore * loadWeight +
-        highValueBonus);
-}
-exports.calculateSelectionScore = calculateSelectionScore;
-// ---------------------------------------------------------------------------
-// Reward Calculations
-// ---------------------------------------------------------------------------
-/**
- * Calculate oracle reward for successful resolution
- *
- * @param marketFees - Total fees collected from market
- * @param rewardPercent - Oracle's reward percentage (default from config)
- * @returns Oracle reward amount
- */
-function calculateOracleReward(marketFees, rewardPercent = exports.DEFAULT_ORACLE_CONFIG.oracleRewardPercent) {
-    return (marketFees * BigInt(Math.floor(rewardPercent * 10000))) / 10000n;
-}
-exports.calculateOracleReward = calculateOracleReward;
-// ---------------------------------------------------------------------------
-// Type Guards
-// ---------------------------------------------------------------------------
-/**
- * Check if a value is a valid OracleState
- */
-function isOracleState(value) {
-    return typeof value === 'number' && value in OracleState;
-}
-exports.isOracleState = isOracleState;
-/**
- * Check if a value is a valid SlashingReason
- */
-function isSlashingReason(value) {
-    return typeof value === 'number' && value in SlashingReason;
-}
-exports.isSlashingReason = isSlashingReason;
-/**
- * Check if a value is a valid ResolutionType
- */
-function isResolutionType(value) {
-    return typeof value === 'number' && value in ResolutionType;
-}
-exports.isResolutionType = isResolutionType;

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

@@ -1,48 +0,0 @@
-"use strict";
-/**
- * Contract Utilities
- *
- * Constants and utilities for the Contract application.
- * Core types are generated from protobuf - see the generated exports.
- *
- * @packageDocumentation
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isTerminalState = exports.CONTRACT_TRANSITIONS = exports.DEFAULT_CONTRACT_CONFIG = void 0;
-const contract_pb_js_1 = require("../../generated/ottochain/apps/contracts/v1/contract_pb.js");
-// ---------------------------------------------------------------------------
-// Configuration Defaults
-// ---------------------------------------------------------------------------
-/**
- * Default contract configuration
- */
-exports.DEFAULT_CONTRACT_CONFIG = {
-    requireBothSignatures: false,
-    disputeWindowEpochs: 10,
-};
-// ---------------------------------------------------------------------------
-// State Machine Transitions
-// ---------------------------------------------------------------------------
-/**
- * Valid transitions for each contract state
- */
-exports.CONTRACT_TRANSITIONS = {
-    [contract_pb_js_1.ContractState.UNSPECIFIED]: [],
-    [contract_pb_js_1.ContractState.PROPOSED]: ['accept', 'reject', 'cancel'],
-    [contract_pb_js_1.ContractState.ACTIVE]: ['complete', 'dispute'],
-    [contract_pb_js_1.ContractState.DISPUTED]: ['resolve_for_completer', 'resolve_for_disputant'],
-    [contract_pb_js_1.ContractState.COMPLETED]: [], // Terminal state
-    [contract_pb_js_1.ContractState.REJECTED]: [], // Terminal state
-    [contract_pb_js_1.ContractState.CANCELLED]: [], // Terminal state
-};
-/**
- * Check if a contract state is terminal (no further transitions allowed)
- */
-function isTerminalState(state) {
-    return [
-        contract_pb_js_1.ContractState.COMPLETED,
-        contract_pb_js_1.ContractState.REJECTED,
-        contract_pb_js_1.ContractState.CANCELLED,
-    ].includes(state);
-}
-exports.isTerminalState = isTerminalState;

package/dist/cjs/apps/corporate/types.js

@@ -1,44 +0,0 @@
-"use strict";
-/**
- * Corporate Governance type definitions
- *
- * TypeScript interfaces for corporate governance state machines covering
- * entity lifecycle, board management, shareholder meetings, officers,
- * bylaws, committees, resolutions, proxy voting, securities, and compliance.
- *
- * @see corporate/*.json for JSON state machine definitions
- * @packageDocumentation
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CORPORATE_DEFINITIONS = void 0;
-// ---------------------------------------------------------------------------
-// State Machine Imports
-// ---------------------------------------------------------------------------
-const corporate_entity_json_1 = __importDefault(require("./state-machines/corporate-entity.json"));
-const corporate_board_json_1 = __importDefault(require("./state-machines/corporate-board.json"));
-const corporate_shareholders_json_1 = __importDefault(require("./state-machines/corporate-shareholders.json"));
-const corporate_officers_json_1 = __importDefault(require("./state-machines/corporate-officers.json"));
-const corporate_bylaws_json_1 = __importDefault(require("./state-machines/corporate-bylaws.json"));
-const corporate_committee_json_1 = __importDefault(require("./state-machines/corporate-committee.json"));
-const corporate_resolution_json_1 = __importDefault(require("./state-machines/corporate-resolution.json"));
-const corporate_proxy_json_1 = __importDefault(require("./state-machines/corporate-proxy.json"));
-const corporate_securities_json_1 = __importDefault(require("./state-machines/corporate-securities.json"));
-const corporate_compliance_json_1 = __importDefault(require("./state-machines/corporate-compliance.json"));
-/**
- * Corporate governance state machine definitions.
- */
-exports.CORPORATE_DEFINITIONS = {
-    Entity: corporate_entity_json_1.default,
-    Board: corporate_board_json_1.default,
-    Shareholders: corporate_shareholders_json_1.default,
-    Officers: corporate_officers_json_1.default,
-    Bylaws: corporate_bylaws_json_1.default,
-    Committee: corporate_committee_json_1.default,
-    Resolution: corporate_resolution_json_1.default,
-    Proxy: corporate_proxy_json_1.default,
-    Securities: corporate_securities_json_1.default,
-    Compliance: corporate_compliance_json_1.default,
-};

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

@@ -1,42 +0,0 @@
-"use strict";
-/**
- * Governance & DAO Types
- *
- * TypeScript types matching the JSON Logic state machine definitions
- * in ottochain/docs/trust-graph/state-machines/dao/
- *
- * @packageDocumentation
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isThresholdDAO = exports.isTokenDAO = exports.isMultisigDAO = exports.isSingleOwnerDAO = void 0;
-// =============================================================================
-// Helpers
-// =============================================================================
-/**
- * Type guard for SingleOwnerDAO
- */
-function isSingleOwnerDAO(state) {
-    return state.schema === 'SingleOwnerDAO';
-}
-exports.isSingleOwnerDAO = isSingleOwnerDAO;
-/**
- * Type guard for MultisigDAO
- */
-function isMultisigDAO(state) {
-    return state.schema === 'MultisigDAO';
-}
-exports.isMultisigDAO = isMultisigDAO;
-/**
- * Type guard for TokenDAO
- */
-function isTokenDAO(state) {
-    return state.schema === 'TokenDAO';
-}
-exports.isTokenDAO = isTokenDAO;
-/**
- * Type guard for ThresholdDAO
- */
-function isThresholdDAO(state) {
-    return state.schema === 'ThresholdDAO';
-}
-exports.isThresholdDAO = isThresholdDAO;

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

@@ -1,53 +0,0 @@
-"use strict";
-/**
- * Agent Identity Utilities
- *
- * Constants and utilities for the Agent Identity application.
- * Core types are generated from protobuf - see the generated exports.
- *
- * @packageDocumentation
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ATTESTATION_DELTAS = exports.AGENT_TRANSITIONS = exports.DEFAULT_REPUTATION_CONFIG = void 0;
-const agent_pb_js_1 = require("../../generated/ottochain/apps/identity/v1/agent_pb.js");
-const attestation_pb_js_1 = require("../../generated/ottochain/apps/identity/v1/attestation_pb.js");
-// ---------------------------------------------------------------------------
-// Configuration Defaults
-// ---------------------------------------------------------------------------
-/**
- * Default reputation configuration for agent identity
- */
-exports.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
- */
-exports.AGENT_TRANSITIONS = {
-    [agent_pb_js_1.AgentState.UNSPECIFIED]: [],
-    [agent_pb_js_1.AgentState.REGISTERED]: ['activate', 'withdraw'],
-    [agent_pb_js_1.AgentState.ACTIVE]: ['challenge', 'withdraw'],
-    [agent_pb_js_1.AgentState.CHALLENGED]: ['uphold_challenge', 'dismiss_challenge'],
-    [agent_pb_js_1.AgentState.SUSPENDED]: ['begin_probation'],
-    [agent_pb_js_1.AgentState.PROBATION]: ['complete_probation'],
-    [agent_pb_js_1.AgentState.WITHDRAWN]: [], // Terminal state
-};
-/**
- * Reputation delta by attestation type
- */
-exports.ATTESTATION_DELTAS = {
-    [attestation_pb_js_1.AttestationType.UNSPECIFIED]: 0,
-    [attestation_pb_js_1.AttestationType.COMPLETION]: 5,
-    [attestation_pb_js_1.AttestationType.VOUCH]: 2,
-    [attestation_pb_js_1.AttestationType.VIOLATION]: -10,
-    [attestation_pb_js_1.AttestationType.BEHAVIORAL]: 3,
-};