@ottochain/sdk 1.0.2 → 1.1.0

package/dist/types/apps/oracles/types.d.ts

@@ -1,193 +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 declare enum ResolutionType {
-    UNSPECIFIED = 0,
-    /** Binary yes/no outcome */
-    BINARY = 1,
-    /** One of multiple predefined outcomes */
-    MULTI_CHOICE = 2,
-    /** Numeric value (e.g., price) */
-    NUMERIC = 3,
-    /** Free-form attestation */
-    ATTESTATION = 4
-}
-/**
- * Reasons for slashing oracle stake
- */
-export declare enum SlashingReason {
-    UNSPECIFIED = 0,
-    /** Failed to submit resolution in time */
-    TIMEOUT = 1,
-    /** Resolution overturned by dispute */
-    INCORRECT_RESOLUTION = 2,
-    /** Evidence of collusion or manipulation */
-    COLLUSION = 3,
-    /** Violation of oracle protocol */
-    PROTOCOL_VIOLATION = 4
-}
-/**
- * Oracle configuration type
- */
-export interface OracleConfig {
-    /** Minimum stake required to become an oracle (in base units) */
-    minStake: bigint;
-    /** Stake slashed for timeout (percentage) */
-    timeoutSlashPercent: number;
-    /** Stake slashed for incorrect resolution (percentage) */
-    incorrectSlashPercent: number;
-    /** Stake slashed for collusion (percentage) */
-    collusionSlashPercent: number;
-    /** Stake slashed for protocol violation (percentage) */
-    violationSlashPercent: number;
-    /** Epochs to wait before withdrawal after unstaking */
-    cooldownEpochs: number;
-    /** Base reputation for new oracles */
-    baseReputation: number;
-    /** Minimum reputation to accept high-value markets */
-    highValueThreshold: number;
-    /** Resolution window in epochs */
-    resolutionWindowEpochs: number;
-    /** Challenge window after submission in epochs */
-    challengeWindowEpochs: number;
-    /** Reward percentage from resolved market fees */
-    oracleRewardPercent: number;
-}
-/**
- * Default oracle configuration
- */
-export declare const DEFAULT_ORACLE_CONFIG: OracleConfig;
-/**
- * Slashing percentages by reason
- */
-export declare const SLASHING_PERCENTAGES: Record<SlashingReason, number>;
-/**
- * Valid transitions for each oracle state (aligned with proto OracleState enum)
- */
-export declare const ORACLE_TRANSITIONS: Record<OracleState, readonly string[]>;
-/**
- * Check if an oracle state is terminal
- */
-export declare function isTerminalOracleState(state: OracleState): boolean;
-/**
- * Check if an oracle can accept new assignments
- */
-export declare function canAcceptAssignment(state: OracleState): boolean;
-/**
- * Reputation update factors
- */
-export declare const REPUTATION_DELTAS: {
-    /** Successfully resolved market without challenge */
-    readonly successfulResolution: 5;
-    /** Resolution upheld after challenge */
-    readonly upheldChallenge: 10;
-    /** Resolution overturned (negative) */
-    readonly overturnedResolution: -25;
-    /** Timeout on assigned market (negative) */
-    readonly timeout: -15;
-    /** Collusion detected (negative) */
-    readonly collusion: -100;
-    /** Protocol violation (negative) */
-    readonly violation: -20;
-    /** Bonus for high-value market resolution */
-    readonly 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 declare function calculateReputation(currentReputation: number, delta: number, minReputation?: number): number;
-/**
- * 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 declare function calculateWeightedReputation(baseReputation: number, successCount: number, failureCount: number): number;
-/**
- * Check if oracle qualifies for high-value markets
- */
-export declare function qualifiesForHighValue(reputation: number, stake: bigint, threshold?: number, minStakeMultiplier?: number): boolean;
-/**
- * Slashing condition definition
- */
-export interface SlashingCondition {
-    reason: SlashingReason;
-    slashPercent: number;
-    description: string;
-    appealable: boolean;
-    suspensionEpochs: number;
-}
-/**
- * Predefined slashing conditions
- */
-export declare const SLASHING_CONDITIONS: Record<SlashingReason, SlashingCondition>;
-/**
- * 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 declare function calculateSlashAmount(stake: bigint, reason: SlashingReason): bigint;
-/**
- * Calculate remaining stake after slashing
- */
-export declare function calculateStakeAfterSlash(stake: bigint, reason: SlashingReason): bigint;
-/**
- * Oracle candidate for selection
- */
-export interface OracleCandidate {
-    address: string;
-    reputation: number;
-    stake: bigint;
-    activeAssignments: number;
-    successRate: number;
-}
-/**
- * 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 declare function calculateSelectionScore(candidate: OracleCandidate, marketValue?: bigint): number;
-/**
- * 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 declare function calculateOracleReward(marketFees: bigint, rewardPercent?: number): bigint;
-/**
- * Check if a value is a valid OracleState
- */
-export declare function isOracleState(value: unknown): value is OracleState;
-/**
- * Check if a value is a valid SlashingReason
- */
-export declare function isSlashingReason(value: unknown): value is SlashingReason;
-/**
- * Check if a value is a valid ResolutionType
- */
-export declare function isResolutionType(value: unknown): value is ResolutionType;

package/dist/types/generated/ottochain/apps/contracts/v1/contract_pb.d.ts

@@ -1,274 +0,0 @@
-import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
-import type { Address } from "../../../v1/common_pb.js";
-import type { Timestamp } from "@bufbuild/protobuf/wkt";
-import type { JsonObject, Message } from "@bufbuild/protobuf";
-/**
- * Describes the file ottochain/apps/contracts/v1/contract.proto.
- */
-export declare const file_ottochain_apps_contracts_v1_contract: GenFile;
-/**
- * Contract between two agents
- *
- * @generated from message ottochain.apps.contracts.v1.Contract
- */
-export type Contract = Message<"ottochain.apps.contracts.v1.Contract"> & {
-    /**
-     * @generated from field: string id = 1;
-     */
-    id: string;
-    /**
-     * Human-readable ID
-     *
-     * @generated from field: string contract_id = 2;
-     */
-    contractId: string;
-    /**
-     * @generated from field: ottochain.v1.Address proposer = 3;
-     */
-    proposer?: Address;
-    /**
-     * @generated from field: ottochain.v1.Address counterparty = 4;
-     */
-    counterparty?: Address;
-    /**
-     * @generated from field: ottochain.apps.contracts.v1.ContractState state = 5;
-     */
-    state: ContractState;
-    /**
-     * Flexible terms structure
-     *
-     * @generated from field: google.protobuf.Struct terms = 6;
-     */
-    terms?: JsonObject;
-    /**
-     * @generated from field: google.protobuf.Timestamp proposed_at = 7;
-     */
-    proposedAt?: Timestamp;
-    /**
-     * @generated from field: google.protobuf.Timestamp accepted_at = 8;
-     */
-    acceptedAt?: Timestamp;
-    /**
-     * @generated from field: google.protobuf.Timestamp completed_at = 9;
-     */
-    completedAt?: Timestamp;
-    /**
-     * Evidence of completion
-     *
-     * @generated from field: string completion_proof = 10;
-     */
-    completionProof: string;
-};
-/**
- * Describes the message ottochain.apps.contracts.v1.Contract.
- * Use `create(ContractSchema)` to create a new message.
- */
-export declare const ContractSchema: GenMessage<Contract>;
-/**
- * Propose a new contract
- *
- * @generated from message ottochain.apps.contracts.v1.ProposeContractRequest
- */
-export type ProposeContractRequest = Message<"ottochain.apps.contracts.v1.ProposeContractRequest"> & {
-    /**
-     * @generated from field: ottochain.v1.Address proposer = 1;
-     */
-    proposer?: Address;
-    /**
-     * @generated from field: ottochain.v1.Address counterparty = 2;
-     */
-    counterparty?: Address;
-    /**
-     * @generated from field: google.protobuf.Struct terms = 3;
-     */
-    terms?: JsonObject;
-    /**
-     * @generated from field: string description = 4;
-     */
-    description: string;
-};
-/**
- * Describes the message ottochain.apps.contracts.v1.ProposeContractRequest.
- * Use `create(ProposeContractRequestSchema)` to create a new message.
- */
-export declare const ProposeContractRequestSchema: GenMessage<ProposeContractRequest>;
-/**
- * Accept a proposed contract
- *
- * @generated from message ottochain.apps.contracts.v1.AcceptContractRequest
- */
-export type AcceptContractRequest = Message<"ottochain.apps.contracts.v1.AcceptContractRequest"> & {
-    /**
-     * @generated from field: string contract_id = 1;
-     */
-    contractId: string;
-    /**
-     * @generated from field: ottochain.v1.Address acceptor = 2;
-     */
-    acceptor?: Address;
-};
-/**
- * Describes the message ottochain.apps.contracts.v1.AcceptContractRequest.
- * Use `create(AcceptContractRequestSchema)` to create a new message.
- */
-export declare const AcceptContractRequestSchema: GenMessage<AcceptContractRequest>;
-/**
- * Complete a contract with proof
- *
- * @generated from message ottochain.apps.contracts.v1.CompleteContractRequest
- */
-export type CompleteContractRequest = Message<"ottochain.apps.contracts.v1.CompleteContractRequest"> & {
-    /**
-     * @generated from field: string contract_id = 1;
-     */
-    contractId: string;
-    /**
-     * @generated from field: ottochain.v1.Address completer = 2;
-     */
-    completer?: Address;
-    /**
-     * @generated from field: string proof = 3;
-     */
-    proof: string;
-};
-/**
- * Describes the message ottochain.apps.contracts.v1.CompleteContractRequest.
- * Use `create(CompleteContractRequestSchema)` to create a new message.
- */
-export declare const CompleteContractRequestSchema: GenMessage<CompleteContractRequest>;
-/**
- * Reject a proposed contract
- *
- * @generated from message ottochain.apps.contracts.v1.RejectContractRequest
- */
-export type RejectContractRequest = Message<"ottochain.apps.contracts.v1.RejectContractRequest"> & {
-    /**
-     * @generated from field: string contract_id = 1;
-     */
-    contractId: string;
-    /**
-     * @generated from field: ottochain.v1.Address rejector = 2;
-     */
-    rejector?: Address;
-    /**
-     * @generated from field: string reason = 3;
-     */
-    reason: string;
-};
-/**
- * Describes the message ottochain.apps.contracts.v1.RejectContractRequest.
- * Use `create(RejectContractRequestSchema)` to create a new message.
- */
-export declare const RejectContractRequestSchema: GenMessage<RejectContractRequest>;
-/**
- * Dispute a contract
- *
- * @generated from message ottochain.apps.contracts.v1.DisputeContractRequest
- */
-export type DisputeContractRequest = Message<"ottochain.apps.contracts.v1.DisputeContractRequest"> & {
-    /**
-     * @generated from field: string contract_id = 1;
-     */
-    contractId: string;
-    /**
-     * @generated from field: ottochain.v1.Address disputant = 2;
-     */
-    disputant?: Address;
-    /**
-     * @generated from field: string evidence = 3;
-     */
-    evidence: string;
-    /**
-     * @generated from field: string reason = 4;
-     */
-    reason: string;
-};
-/**
- * Describes the message ottochain.apps.contracts.v1.DisputeContractRequest.
- * Use `create(DisputeContractRequestSchema)` to create a new message.
- */
-export declare const DisputeContractRequestSchema: GenMessage<DisputeContractRequest>;
-/**
- * Contract state machine definition
- *
- * Valid transitions:
- *   PROPOSED -> ACTIVE (accept)
- *   PROPOSED -> REJECTED (reject)
- *   PROPOSED -> CANCELLED (cancel)
- *   ACTIVE -> COMPLETED (complete)
- *   ACTIVE -> DISPUTED (dispute)
- *   DISPUTED -> COMPLETED (resolve_for_completer)
- *   DISPUTED -> REJECTED (resolve_for_disputant)
- *
- * @generated from message ottochain.apps.contracts.v1.ContractDefinition
- */
-export type ContractDefinition = Message<"ottochain.apps.contracts.v1.ContractDefinition"> & {
-    /**
-     * Both parties must sign completion
-     *
-     * @generated from field: bool require_both_signatures = 1;
-     */
-    requireBothSignatures: boolean;
-    /**
-     * How long after completion disputes allowed
-     *
-     * @generated from field: int32 dispute_window_epochs = 2;
-     */
-    disputeWindowEpochs: number;
-};
-/**
- * Describes the message ottochain.apps.contracts.v1.ContractDefinition.
- * Use `create(ContractDefinitionSchema)` to create a new message.
- */
-export declare const ContractDefinitionSchema: GenMessage<ContractDefinition>;
-/**
- * Contract lifecycle states
- *
- * @generated from enum ottochain.apps.contracts.v1.ContractState
- */
-export declare enum ContractState {
-    /**
-     * @generated from enum value: CONTRACT_STATE_UNSPECIFIED = 0;
-     */
-    UNSPECIFIED = 0,
-    /**
-     * Awaiting counterparty acceptance
-     *
-     * @generated from enum value: CONTRACT_STATE_PROPOSED = 1;
-     */
-    PROPOSED = 1,
-    /**
-     * Both parties agreed, in progress
-     *
-     * @generated from enum value: CONTRACT_STATE_ACTIVE = 2;
-     */
-    ACTIVE = 2,
-    /**
-     * Successfully fulfilled (terminal)
-     *
-     * @generated from enum value: CONTRACT_STATE_COMPLETED = 3;
-     */
-    COMPLETED = 3,
-    /**
-     * Counterparty declined (terminal)
-     *
-     * @generated from enum value: CONTRACT_STATE_REJECTED = 4;
-     */
-    REJECTED = 4,
-    /**
-     * Under dispute resolution
-     *
-     * @generated from enum value: CONTRACT_STATE_DISPUTED = 5;
-     */
-    DISPUTED = 5,
-    /**
-     * Cancelled by proposer before acceptance (terminal)
-     *
-     * @generated from enum value: CONTRACT_STATE_CANCELLED = 6;
-     */
-    CANCELLED = 6
-}
-/**
- * Describes the enum ottochain.apps.contracts.v1.ContractState.
- */
-export declare const ContractStateSchema: GenEnum<ContractState>;