@ottochain/sdk 1.0.3 → 1.1.0

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

@@ -1,267 +0,0 @@
-/**
- * Oracles Application Types
- *
- * Constants, types, and utilities for the Oracle system on OttoChain.
- * Oracles provide truth resolution for markets and disputes.
- *
- * Core types (OracleState, Oracle, etc.) are exported from proto-generated
- * types in index.ts.
- *
- * @packageDocumentation
- */
-import { OracleState } from '../../generated/ottochain/apps/oracles/v1/oracle_pb.js';
-/**
- * Types of oracle resolutions
- */
-export 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 || (ResolutionType = {}));
-/**
- * Reasons for slashing oracle stake
- */
-export 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 || (SlashingReason = {}));
-/**
- * Default oracle configuration
- */
-export const 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
- */
-export const SLASHING_PERCENTAGES = {
-    [SlashingReason.UNSPECIFIED]: 0,
-    [SlashingReason.TIMEOUT]: DEFAULT_ORACLE_CONFIG.timeoutSlashPercent,
-    [SlashingReason.INCORRECT_RESOLUTION]: DEFAULT_ORACLE_CONFIG.incorrectSlashPercent,
-    [SlashingReason.COLLUSION]: DEFAULT_ORACLE_CONFIG.collusionSlashPercent,
-    [SlashingReason.PROTOCOL_VIOLATION]: DEFAULT_ORACLE_CONFIG.violationSlashPercent,
-};
-// ---------------------------------------------------------------------------
-// State Machine Transitions
-// ---------------------------------------------------------------------------
-/**
- * Valid transitions for each oracle state (aligned with proto OracleState enum)
- */
-export const ORACLE_TRANSITIONS = {
-    [OracleState.UNSPECIFIED]: [],
-    [OracleState.UNREGISTERED]: ['register'],
-    [OracleState.REGISTERED]: ['activate', 'withdraw'],
-    [OracleState.ACTIVE]: ['add_stake', 'record_resolution', 'slash', 'withdraw'],
-    [OracleState.SLASHED]: ['reactivate', 'withdraw'],
-    [OracleState.WITHDRAWN]: [], // Terminal state
-};
-/**
- * Check if an oracle state is terminal
- */
-export function isTerminalOracleState(state) {
-    return state === OracleState.WITHDRAWN;
-}
-/**
- * Check if an oracle can accept new assignments
- */
-export function canAcceptAssignment(state) {
-    return state === OracleState.ACTIVE;
-}
-// ---------------------------------------------------------------------------
-// Reputation Calculations
-// ---------------------------------------------------------------------------
-/**
- * Reputation update factors
- */
-export const 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
- */
-export function calculateReputation(currentReputation, delta, minReputation = 0) {
-    return Math.max(minReputation, currentReputation + delta);
-}
-/**
- * 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
- */
-export 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);
-}
-/**
- * Check if oracle qualifies for high-value markets
- */
-export function qualifiesForHighValue(reputation, stake, threshold = DEFAULT_ORACLE_CONFIG.highValueThreshold, minStakeMultiplier = 5) {
-    return (reputation >= threshold &&
-        stake >= DEFAULT_ORACLE_CONFIG.minStake * BigInt(minStakeMultiplier));
-}
-/**
- * Predefined slashing conditions
- */
-export const SLASHING_CONDITIONS = {
-    [SlashingReason.UNSPECIFIED]: {
-        reason: SlashingReason.UNSPECIFIED,
-        slashPercent: 0,
-        description: 'No slashing',
-        appealable: false,
-        suspensionEpochs: 0,
-    },
-    [SlashingReason.TIMEOUT]: {
-        reason: SlashingReason.TIMEOUT,
-        slashPercent: DEFAULT_ORACLE_CONFIG.timeoutSlashPercent,
-        description: 'Failed to submit resolution within deadline',
-        appealable: true,
-        suspensionEpochs: 12,
-    },
-    [SlashingReason.INCORRECT_RESOLUTION]: {
-        reason: SlashingReason.INCORRECT_RESOLUTION,
-        slashPercent: DEFAULT_ORACLE_CONFIG.incorrectSlashPercent,
-        description: 'Resolution overturned by dispute process',
-        appealable: true,
-        suspensionEpochs: 48,
-    },
-    [SlashingReason.COLLUSION]: {
-        reason: SlashingReason.COLLUSION,
-        slashPercent: DEFAULT_ORACLE_CONFIG.collusionSlashPercent,
-        description: 'Evidence of collusion or market manipulation',
-        appealable: false,
-        suspensionEpochs: -1, // Permanent
-    },
-    [SlashingReason.PROTOCOL_VIOLATION]: {
-        reason: SlashingReason.PROTOCOL_VIOLATION,
-        slashPercent: 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
- */
-export function calculateSlashAmount(stake, reason) {
-    const condition = SLASHING_CONDITIONS[reason];
-    return (stake * BigInt(Math.floor(condition.slashPercent * 10000))) / 10000n;
-}
-/**
- * Calculate remaining stake after slashing
- */
-export function calculateStakeAfterSlash(stake, reason) {
-    return stake - calculateSlashAmount(stake, reason);
-}
-/**
- * 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
- */
-export 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);
-}
-// ---------------------------------------------------------------------------
-// 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
- */
-export function calculateOracleReward(marketFees, rewardPercent = DEFAULT_ORACLE_CONFIG.oracleRewardPercent) {
-    return (marketFees * BigInt(Math.floor(rewardPercent * 10000))) / 10000n;
-}
-// ---------------------------------------------------------------------------
-// Type Guards
-// ---------------------------------------------------------------------------
-/**
- * Check if a value is a valid OracleState
- */
-export function isOracleState(value) {
-    return typeof value === 'number' && value in OracleState;
-}
-/**
- * Check if a value is a valid SlashingReason
- */
-export function isSlashingReason(value) {
-    return typeof value === 'number' && value in SlashingReason;
-}
-/**
- * Check if a value is a valid ResolutionType
- */
-export function isResolutionType(value) {
-    return typeof value === 'number' && value in ResolutionType;
-}

package/dist/esm/generated/ottochain/apps/contracts/v1/contract_pb.js

@@ -1,97 +0,0 @@
-// @generated by protoc-gen-es v2.2.0 with parameter "target=ts,import_extension=.js"
-// @generated from file ottochain/apps/contracts/v1/contract.proto (package ottochain.apps.contracts.v1, syntax proto3)
-/* eslint-disable */
-import { enumDesc, fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv1";
-import { file_ottochain_v1_common } from "../../../v1/common_pb.js";
-import { file_google_protobuf_struct, file_google_protobuf_timestamp } from "@bufbuild/protobuf/wkt";
-/**
- * Describes the file ottochain/apps/contracts/v1/contract.proto.
- */
-export const file_ottochain_apps_contracts_v1_contract = /*@__PURE__*/ fileDesc("CipvdHRvY2hhaW4vYXBwcy9jb250cmFjdHMvdjEvY29udHJhY3QucHJvdG8SG290dG9jaGFpbi5hcHBzLmNvbnRyYWN0cy52MSKSAwoIQ29udHJhY3QSCgoCaWQYASABKAkSEwoLY29udHJhY3RfaWQYAiABKAkSJwoIcHJvcG9zZXIYAyABKAsyFS5vdHRvY2hhaW4udjEuQWRkcmVzcxIrCgxjb3VudGVycGFydHkYBCABKAsyFS5vdHRvY2hhaW4udjEuQWRkcmVzcxI5CgVzdGF0ZRgFIAEoDjIqLm90dG9jaGFpbi5hcHBzLmNvbnRyYWN0cy52MS5Db250cmFjdFN0YXRlEiYKBXRlcm1zGAYgASgLMhcuZ29vZ2xlLnByb3RvYnVmLlN0cnVjdBIvCgtwcm9wb3NlZF9hdBgHIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASLwoLYWNjZXB0ZWRfYXQYCCABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEjAKDGNvbXBsZXRlZF9hdBgJIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASGAoQY29tcGxldGlvbl9wcm9vZhgKIAEoCSKrAQoWUHJvcG9zZUNvbnRyYWN0UmVxdWVzdBInCghwcm9wb3NlchgBIAEoCzIVLm90dG9jaGFpbi52MS5BZGRyZXNzEisKDGNvdW50ZXJwYXJ0eRgCIAEoCzIVLm90dG9jaGFpbi52MS5BZGRyZXNzEiYKBXRlcm1zGAMgASgLMhcuZ29vZ2xlLnByb3RvYnVmLlN0cnVjdBITCgtkZXNjcmlwdGlvbhgEIAEoCSJVChVBY2NlcHRDb250cmFjdFJlcXVlc3QSEwoLY29udHJhY3RfaWQYASABKAkSJwoIYWNjZXB0b3IYAiABKAsyFS5vdHRvY2hhaW4udjEuQWRkcmVzcyJnChdDb21wbGV0ZUNvbnRyYWN0UmVxdWVzdBITCgtjb250cmFjdF9pZBgBIAEoCRIoCgljb21wbGV0ZXIYAiABKAsyFS5vdHRvY2hhaW4udjEuQWRkcmVzcxINCgVwcm9vZhgDIAEoCSJlChVSZWplY3RDb250cmFjdFJlcXVlc3QSEwoLY29udHJhY3RfaWQYASABKAkSJwoIcmVqZWN0b3IYAiABKAsyFS5vdHRvY2hhaW4udjEuQWRkcmVzcxIOCgZyZWFzb24YAyABKAkieQoWRGlzcHV0ZUNvbnRyYWN0UmVxdWVzdBITCgtjb250cmFjdF9pZBgBIAEoCRIoCglkaXNwdXRhbnQYAiABKAsyFS5vdHRvY2hhaW4udjEuQWRkcmVzcxIQCghldmlkZW5jZRgDIAEoCRIOCgZyZWFzb24YBCABKAkiVAoSQ29udHJhY3REZWZpbml0aW9uEh8KF3JlcXVpcmVfYm90aF9zaWduYXR1cmVzGAEgASgIEh0KFWRpc3B1dGVfd2luZG93X2Vwb2NocxgCIAEoBSrdAQoNQ29udHJhY3RTdGF0ZRIeChpDT05UUkFDVF9TVEFURV9VTlNQRUNJRklFRBAAEhsKF0NPTlRSQUNUX1NUQVRFX1BST1BPU0VEEAESGQoVQ09OVFJBQ1RfU1RBVEVfQUNUSVZFEAISHAoYQ09OVFJBQ1RfU1RBVEVfQ09NUExFVEVEEAMSGwoXQ09OVFJBQ1RfU1RBVEVfUkVKRUNURUQQBBIbChdDT05UUkFDVF9TVEFURV9ESVNQVVRFRBAFEhwKGENPTlRSQUNUX1NUQVRFX0NBTkNFTExFRBAGQr8BCh9jb20ub3R0b2NoYWluLmFwcHMuY29udHJhY3RzLnYxQg1Db250cmFjdFByb3RvUAGiAgNPQUOqAhtPdHRvY2hhaW4uQXBwcy5Db250cmFjdHMuVjHKAhtPdHRvY2hhaW5cQXBwc1xDb250cmFjdHNcVjHiAidPdHRvY2hhaW5cQXBwc1xDb250cmFjdHNcVjFcR1BCTWV0YWRhdGHqAh5PdHRvY2hhaW46OkFwcHM6OkNvbnRyYWN0czo6VjFiBnByb3RvMw", [file_ottochain_v1_common, file_google_protobuf_struct, file_google_protobuf_timestamp]);
-/**
- * Describes the message ottochain.apps.contracts.v1.Contract.
- * Use `create(ContractSchema)` to create a new message.
- */
-export const ContractSchema = /*@__PURE__*/ messageDesc(file_ottochain_apps_contracts_v1_contract, 0);
-/**
- * Describes the message ottochain.apps.contracts.v1.ProposeContractRequest.
- * Use `create(ProposeContractRequestSchema)` to create a new message.
- */
-export const ProposeContractRequestSchema = /*@__PURE__*/ messageDesc(file_ottochain_apps_contracts_v1_contract, 1);
-/**
- * Describes the message ottochain.apps.contracts.v1.AcceptContractRequest.
- * Use `create(AcceptContractRequestSchema)` to create a new message.
- */
-export const AcceptContractRequestSchema = /*@__PURE__*/ messageDesc(file_ottochain_apps_contracts_v1_contract, 2);
-/**
- * Describes the message ottochain.apps.contracts.v1.CompleteContractRequest.
- * Use `create(CompleteContractRequestSchema)` to create a new message.
- */
-export const CompleteContractRequestSchema = /*@__PURE__*/ messageDesc(file_ottochain_apps_contracts_v1_contract, 3);
-/**
- * Describes the message ottochain.apps.contracts.v1.RejectContractRequest.
- * Use `create(RejectContractRequestSchema)` to create a new message.
- */
-export const RejectContractRequestSchema = /*@__PURE__*/ messageDesc(file_ottochain_apps_contracts_v1_contract, 4);
-/**
- * Describes the message ottochain.apps.contracts.v1.DisputeContractRequest.
- * Use `create(DisputeContractRequestSchema)` to create a new message.
- */
-export const DisputeContractRequestSchema = /*@__PURE__*/ messageDesc(file_ottochain_apps_contracts_v1_contract, 5);
-/**
- * Describes the message ottochain.apps.contracts.v1.ContractDefinition.
- * Use `create(ContractDefinitionSchema)` to create a new message.
- */
-export const ContractDefinitionSchema = /*@__PURE__*/ messageDesc(file_ottochain_apps_contracts_v1_contract, 6);
-/**
- * Contract lifecycle states
- *
- * @generated from enum ottochain.apps.contracts.v1.ContractState
- */
-export var ContractState;
-(function (ContractState) {
-    /**
-     * @generated from enum value: CONTRACT_STATE_UNSPECIFIED = 0;
-     */
-    ContractState[ContractState["UNSPECIFIED"] = 0] = "UNSPECIFIED";
-    /**
-     * Awaiting counterparty acceptance
-     *
-     * @generated from enum value: CONTRACT_STATE_PROPOSED = 1;
-     */
-    ContractState[ContractState["PROPOSED"] = 1] = "PROPOSED";
-    /**
-     * Both parties agreed, in progress
-     *
-     * @generated from enum value: CONTRACT_STATE_ACTIVE = 2;
-     */
-    ContractState[ContractState["ACTIVE"] = 2] = "ACTIVE";
-    /**
-     * Successfully fulfilled (terminal)
-     *
-     * @generated from enum value: CONTRACT_STATE_COMPLETED = 3;
-     */
-    ContractState[ContractState["COMPLETED"] = 3] = "COMPLETED";
-    /**
-     * Counterparty declined (terminal)
-     *
-     * @generated from enum value: CONTRACT_STATE_REJECTED = 4;
-     */
-    ContractState[ContractState["REJECTED"] = 4] = "REJECTED";
-    /**
-     * Under dispute resolution
-     *
-     * @generated from enum value: CONTRACT_STATE_DISPUTED = 5;
-     */
-    ContractState[ContractState["DISPUTED"] = 5] = "DISPUTED";
-    /**
-     * Cancelled by proposer before acceptance (terminal)
-     *
-     * @generated from enum value: CONTRACT_STATE_CANCELLED = 6;
-     */
-    ContractState[ContractState["CANCELLED"] = 6] = "CANCELLED";
-})(ContractState || (ContractState = {}));
-/**
- * Describes the enum ottochain.apps.contracts.v1.ContractState.
- */
-export const ContractStateSchema = /*@__PURE__*/ enumDesc(file_ottochain_apps_contracts_v1_contract, 0);