@the-situation/abi 0.5.0-alpha.0

package/dist/amm.d.ts

@@ -0,0 +1,83 @@
+/**
+ * AMM contract ABI types and function names.
+ *
+ * These match the latest `normal_amm` interface.
+ *
+ * @module
+ */
+import type { NormalDistributionRaw, SQ128x128Raw } from '@the-situation/core';
+import type { AmmConfigRaw, AmmParamsRaw, ClaimResultRaw, FeeConfigRaw, LPInfoRaw, MarketStatusRaw, NormalSqrtHintsRaw, PositionCloseResultRaw, PositionCompactRaw, PositionExtendedRaw, TradeExecutionRaw } from './common';
+/**
+ * All AMM contract function names.
+ */
+export declare const AMM_FUNCTION_NAMES: readonly ["get_params", "get_config", "get_distribution", "get_market_status", "get_owner", "get_admin", "get_position_extended", "get_position_compact", "get_lp_info", "get_distribution_hints", "get_lp_shares", "get_position_settlement_status", "get_extension", "get_extension_call_points", "get_market_key", "get_metadata_hash", "get_math_class_hash", "get_fee_config", "get_accumulated_protocol_fees", "get_token_balance", "execute_trade", "check_close_position", "close_position", "close_position_guarded", "claim", "add_liquidity", "remove_liquidity", "initialize", "pause", "unpause", "settle", "update_parameters", "transfer_ownership", "update_admin", "update_math_class_hash", "withdraw_protocol_fees", "emergency_withdraw", "clear_tokens"];
+export type AmmFunctionName = (typeof AMM_FUNCTION_NAMES)[number];
+/**
+ * Input for execute_trade.
+ */
+export interface TradeInput {
+    readonly candidate: NormalDistributionRaw;
+    readonly xStar: SQ128x128Raw;
+    readonly suppliedCollateral: SQ128x128Raw;
+    readonly candidateHints: NormalSqrtHintsRaw;
+}
+/**
+ * Input for update_parameters.
+ */
+export interface UpdateParametersInput {
+    readonly tolerance: SQ128x128Raw;
+    readonly minTradeCollateral: SQ128x128Raw;
+}
+/**
+ * Return type mapping for AMM view functions.
+ */
+export interface AmmViewReturns {
+    get_params: AmmParamsRaw;
+    get_config: AmmConfigRaw;
+    get_distribution: NormalDistributionRaw;
+    get_market_status: MarketStatusRaw;
+    get_owner: string;
+    get_admin: string;
+    get_position_extended: PositionExtendedRaw;
+    get_position_compact: PositionCompactRaw;
+    get_lp_info: LPInfoRaw;
+    get_distribution_hints: NormalSqrtHintsRaw;
+    get_lp_shares: SQ128x128Raw;
+    get_position_settlement_status: unknown;
+    get_extension: string;
+    get_extension_call_points: unknown;
+    get_market_key: bigint;
+    get_metadata_hash: string;
+    get_math_class_hash: string;
+    get_fee_config: FeeConfigRaw;
+    get_accumulated_protocol_fees: bigint;
+    get_token_balance: bigint;
+}
+/**
+ * Return type mapping for AMM close position functions.
+ */
+export interface AmmCloseReturns {
+    check_close_position: PositionCloseResultRaw;
+    close_position: PositionCloseResultRaw;
+    close_position_guarded: PositionCloseResultRaw;
+}
+/**
+ * Return type mapping for AMM trade functions.
+ */
+export interface AmmTradeReturns {
+    execute_trade: TradeExecutionRaw;
+}
+/**
+ * Return type mapping for AMM LP functions.
+ */
+export interface AmmLPReturns {
+    add_liquidity: bigint;
+    remove_liquidity: bigint;
+}
+/**
+ * Return type mapping for AMM settlement functions.
+ */
+export interface AmmSettlementReturns {
+    claim: ClaimResultRaw;
+}
+//# sourceMappingURL=amm.d.ts.map

package/dist/amm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amm.d.ts","sourceRoot":"","sources":["../src/amm.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAMlB;;GAEG;AACH,eAAO,MAAM,kBAAkB,+uBAkDrB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAMlE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,EAAE,YAAY,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE,kBAAkB,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,kBAAkB,EAAE,YAAY,CAAC;CAC3C;AAMD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,YAAY,CAAC;IACzB,UAAU,EAAE,YAAY,CAAC;IACzB,gBAAgB,EAAE,qBAAqB,CAAC;IACxC,iBAAiB,EAAE,eAAe,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB,EAAE,mBAAmB,CAAC;IAC3C,oBAAoB,EAAE,kBAAkB,CAAC;IACzC,WAAW,EAAE,SAAS,CAAC;IACvB,sBAAsB,EAAE,kBAAkB,CAAC;IAC3C,aAAa,EAAE,YAAY,CAAC;IAC5B,8BAA8B,EAAE,OAAO,CAAC;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,yBAAyB,EAAE,OAAO,CAAC;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,YAAY,CAAC;IAC7B,6BAA6B,EAAE,MAAM,CAAC;IACtC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oBAAoB,EAAE,sBAAsB,CAAC;IAC7C,cAAc,EAAE,sBAAsB,CAAC;IACvC,sBAAsB,EAAE,sBAAsB,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,iBAAiB,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,cAAc,CAAC;CACvB"}

package/dist/amm.js

@@ -0,0 +1,60 @@
+/**
+ * AMM contract ABI types and function names.
+ *
+ * These match the latest `normal_amm` interface.
+ *
+ * @module
+ */
+// ============================================================================
+// Function Names
+// ============================================================================
+/**
+ * All AMM contract function names.
+ */
+export const AMM_FUNCTION_NAMES = [
+    // View functions
+    'get_params',
+    'get_config',
+    'get_distribution',
+    'get_market_status',
+    'get_owner',
+    'get_admin',
+    'get_position_extended',
+    'get_position_compact',
+    'get_lp_info',
+    'get_distribution_hints',
+    'get_lp_shares',
+    'get_position_settlement_status',
+    'get_extension',
+    'get_extension_call_points',
+    'get_market_key',
+    'get_metadata_hash',
+    'get_math_class_hash',
+    'get_fee_config',
+    'get_accumulated_protocol_fees',
+    'get_token_balance',
+    // Trade / close
+    'execute_trade',
+    'check_close_position',
+    'close_position',
+    'close_position_guarded',
+    // Position settlement
+    'claim',
+    // LP
+    'add_liquidity',
+    'remove_liquidity',
+    // Lifecycle + admin
+    'initialize',
+    'pause',
+    'unpause',
+    'settle',
+    'update_parameters',
+    'transfer_ownership',
+    'update_admin',
+    'update_math_class_hash',
+    // Fee / emergency
+    'withdraw_protocol_fees',
+    'emergency_withdraw',
+    'clear_tokens',
+];
+//# sourceMappingURL=amm.js.map

package/dist/amm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"amm.js","sourceRoot":"","sources":["../src/amm.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiBH,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,iBAAiB;IACjB,YAAY;IACZ,YAAY;IACZ,kBAAkB;IAClB,mBAAmB;IACnB,WAAW;IACX,WAAW;IACX,uBAAuB;IACvB,sBAAsB;IACtB,aAAa;IACb,wBAAwB;IACxB,eAAe;IACf,gCAAgC;IAChC,eAAe;IACf,2BAA2B;IAC3B,gBAAgB;IAChB,mBAAmB;IACnB,qBAAqB;IACrB,gBAAgB;IAChB,+BAA+B;IAC/B,mBAAmB;IAEnB,gBAAgB;IAChB,eAAe;IACf,sBAAsB;IACtB,gBAAgB;IAChB,wBAAwB;IAExB,sBAAsB;IACtB,OAAO;IAEP,KAAK;IACL,eAAe;IACf,kBAAkB;IAElB,oBAAoB;IACpB,YAAY;IACZ,OAAO;IACP,SAAS;IACT,QAAQ;IACR,mBAAmB;IACnB,oBAAoB;IACpB,cAAc;IACd,wBAAwB;IAExB,kBAAkB;IAClB,wBAAwB;IACxB,oBAAoB;IACpB,cAAc;CACN,CAAC"}

package/dist/common.d.ts

@@ -0,0 +1,403 @@
+/**
+ * Common ABI types for The Situation contracts.
+ *
+ * These types match the Cairo `onchain::common` module and provide
+ * the serialization boundary between TypeScript and Starknet contracts.
+ *
+ * @module
+ */
+import type { NormalDistributionRaw, NormalSqrtHintsRaw, SQ128x128Raw } from '@the-situation/core';
+/** Maximum total fee in basis points (10% = 1000 bps) */
+export declare const MAX_FEE_BPS = 1000;
+/**
+ * Fee configuration for a market (all values in basis points, 1 bps = 0.01%).
+ */
+export interface FeeConfigRaw {
+    /** Fee on trades that benefits LPs (stays in pool) */
+    readonly lpFeeBps: number;
+    /** Fee on trades that goes to protocol/factory */
+    readonly protocolFeeBps: number;
+    /** Fee on trader winnings at settlement */
+    readonly settlementFeeBps: number;
+}
+/**
+ * Validates fee configuration.
+ */
+export declare function isValidFeeConfigRaw(config: FeeConfigRaw): boolean;
+/**
+ * Creates a validated fee configuration.
+ */
+export declare function createFeeConfigRaw(lpFeeBps: number, protocolFeeBps: number, settlementFeeBps: number): FeeConfigRaw | null;
+/**
+ * AMM parameters configuration.
+ */
+export interface AmmParamsRaw {
+    /** L2 norm constraint: ||f||_2 = k */
+    readonly k: SQ128x128Raw;
+    /** Initial backing requirement */
+    readonly backing: SQ128x128Raw;
+    /** Numerical tolerance for verification */
+    readonly tolerance: SQ128x128Raw;
+    /** Minimum collateral required per trade */
+    readonly minTradeCollateral: SQ128x128Raw;
+}
+/**
+ * Creates AMM parameters.
+ */
+export declare function createAmmParamsRaw(k: SQ128x128Raw, backing: SQ128x128Raw, tolerance: SQ128x128Raw, minTradeCollateral: SQ128x128Raw): AmmParamsRaw;
+/**
+ * Market status information.
+ */
+export interface MarketStatusRaw {
+    readonly isInitialized: boolean;
+    readonly isPaused: boolean;
+    readonly isSettled: boolean;
+    readonly settlementValue: SQ128x128Raw;
+}
+/**
+ * Creates market status.
+ */
+export declare function createMarketStatusRaw(isInitialized: boolean, isPaused: boolean, isSettled: boolean, settlementValue: SQ128x128Raw): MarketStatusRaw;
+/**
+ * Trader position information.
+ */
+export interface PositionRaw {
+    readonly distribution: NormalDistributionRaw;
+    readonly collateralLocked: SQ128x128Raw;
+    readonly exists: boolean;
+}
+/**
+ * Extended position with delta tracking.
+ *
+ * Note on terminology:
+ * - `deltaCount`: Total historical deltas (not "current position size"). Each trade creates
+ *   a delta, and closing a position creates an offsetting delta. This number only increases.
+ * - `exists`: Means "has ever traded in this market", not "has open position".
+ *   A trader who opened and closed their position still has `exists: true`.
+ * - `earlySettled`: Set when trader calls `close_position()` before market settlement.
+ *   They receive their payout immediately and cannot claim again at settlement.
+ * - `claimed`: Set when trader calls `claim()` after market settlement.
+ */
+export interface PositionExtendedRaw {
+    /** Number of position deltas for this trader (cumulative, only increases) */
+    readonly deltaCount: number;
+    /** Total collateral locked across all deltas */
+    readonly totalCollateralLocked: SQ128x128Raw;
+    /** Whether the position has been claimed after market settlement */
+    readonly claimed: boolean;
+    /** Whether the trader closed their position before market settlement (early exit) */
+    readonly earlySettled: boolean;
+    /** Whether the trader has ever traded in this market */
+    readonly exists: boolean;
+}
+/**
+ * Position delta information (old format - deprecated).
+ * @deprecated Use PositionDeltaV2Raw for new code
+ */
+export interface PositionDeltaRaw {
+    readonly distribution: NormalDistributionRaw;
+    readonly collateralLocked: SQ128x128Raw;
+    readonly timestamp: bigint;
+}
+/**
+ * Position delta information (v0.5.0+ format).
+ *
+ * Each delta records a trade transition from one distribution to another.
+ * For the FIRST delta (index 0), `from_*` contains the ORIGINAL market
+ * distribution when the trader entered.
+ */
+export interface PositionDeltaV2Raw {
+    /** Market mean before this trade */
+    readonly from_mean: SQ128x128Raw;
+    /** Market variance before this trade */
+    readonly from_variance: SQ128x128Raw;
+    /** Market sigma before this trade */
+    readonly from_sigma: SQ128x128Raw;
+    /** Market lambda (k/||p||_2) before this trade */
+    readonly from_lambda: SQ128x128Raw;
+    /** Market mean after this trade */
+    readonly to_mean: SQ128x128Raw;
+    /** Market variance after this trade */
+    readonly to_variance: SQ128x128Raw;
+    /** Market sigma after this trade */
+    readonly to_sigma: SQ128x128Raw;
+    /** Market lambda after this trade */
+    readonly to_lambda: SQ128x128Raw;
+    /** Collateral locked in this delta */
+    readonly collateral_locked: SQ128x128Raw;
+}
+/**
+ * Scaled backing validation results.
+ */
+export interface ScaledBackingCheckRaw {
+    readonly maxValueUpper: SQ128x128Raw;
+    readonly isValid: boolean;
+    readonly computationSucceeded: boolean;
+}
+/**
+ * Collateral verification results.
+ */
+export interface CollateralVerificationRaw {
+    readonly sideValid: boolean;
+    readonly stationaryValid: boolean;
+    readonly curvatureValid: boolean;
+    readonly computedCollateral: SQ128x128Raw;
+    readonly collateralSufficient: boolean;
+    readonly computationValid: boolean;
+}
+/**
+ * Trade validation results.
+ */
+export interface TradeCheckRaw {
+    readonly backingCheck: ScaledBackingCheckRaw;
+    readonly verification: CollateralVerificationRaw;
+    readonly minTradeCollateral: SQ128x128Raw;
+    readonly collateralAboveMin: boolean;
+    readonly isValid: boolean;
+}
+/**
+ * Trade execution result with token amount.
+ */
+export interface TradeExecutionRaw {
+    readonly check: TradeCheckRaw;
+    /** Token amount transferred (in token decimals) */
+    readonly tokenAmount: bigint;
+    /** Index of the created position delta */
+    readonly deltaIndex: number;
+}
+/**
+ * Claim result after settlement.
+ */
+export interface ClaimResultRaw {
+    /** Computed position value at settlement */
+    readonly positionValue: SQ128x128Raw;
+    /** Total collateral that was locked */
+    readonly collateralReturned: SQ128x128Raw;
+    /** Token amount paid out (in token decimals) */
+    readonly tokenPayout: bigint;
+    /** Whether the claim was successful */
+    readonly success: boolean;
+}
+/**
+ * LP pool information.
+ */
+export interface LPInfoRaw {
+    /** Total LP shares outstanding */
+    readonly totalShares: SQ128x128Raw;
+    /** Total backing deposited by LPs */
+    readonly totalBackingDeposited: SQ128x128Raw;
+}
+/**
+ * Precomputed sqrt hints for normal distribution operations.
+ */
+export type { NormalSqrtHintsRaw };
+/**
+ * Full AMM configuration.
+ */
+export interface AmmConfigRaw {
+    /** Collateral token address */
+    readonly collateralToken: string;
+    /** Token decimals (native token precision) */
+    readonly tokenDecimals: number;
+    /** Internal decimals (precision for SQ128x128 math, <= 7) */
+    readonly internalDecimals: number;
+    /** Decimal shift (tokenDecimals - internalDecimals) */
+    readonly decimalShift: number;
+    /** Market parameters */
+    readonly params: AmmParamsRaw;
+}
+/**
+ * PDF norm validation results.
+ */
+export interface PdfNormCheckRaw {
+    readonly sigma: SQ128x128Raw;
+    readonly computedNorm: SQ128x128Raw;
+    readonly targetNorm: SQ128x128Raw;
+    readonly isValid: boolean;
+    readonly computationSucceeded: boolean;
+}
+/**
+ * Reason for trade rejection.
+ *
+ * Maps to Cairo `TradeRejectReason` enum.
+ */
+export declare enum TradeRejectReason {
+    /** Backing constraint check failed */
+    BackingConstraintFailed = "BackingConstraintFailed",
+    /** Invalid hints provided */
+    InvalidHints = "InvalidHints",
+    /** Insufficient collateral supplied */
+    InsufficientCollateral = "InsufficientCollateral",
+    /** Collateral verification failed */
+    VerificationFailed = "VerificationFailed",
+    /** Invalid candidate distribution */
+    InvalidDistribution = "InvalidDistribution"
+}
+/**
+ * Trade rejected event data.
+ *
+ * Emitted when a trade is rejected with a specific reason.
+ */
+export interface TradeRejectedEvent {
+    /** Trader address */
+    readonly trader: string;
+    /** Candidate distribution that was rejected */
+    readonly candidate: NormalDistributionRaw;
+    /** Collateral that was supplied */
+    readonly suppliedCollateral: SQ128x128Raw;
+    /** Hints that were provided */
+    readonly candidateHints: NormalSqrtHintsRaw;
+    /** Reason for rejection */
+    readonly reason: TradeRejectReason;
+}
+/**
+ * Settlement status from contract.
+ *
+ * Maps to Cairo `SettlementStatus` enum returned by
+ * `get_position_settlement_status()`.
+ *
+ * This is the native contract enum, distinct from the SDK's computed
+ * `SettlementState` which provides additional states like 'never_traded'.
+ */
+export declare enum SettlementStatusRaw {
+    /** Position has not been settled (neither claimed nor early settled) */
+    NotSettled = "NotSettled",
+    /** Position was closed before market settlement via close_position() */
+    EarlySettled = "EarlySettled",
+    /** Position was claimed after market settlement via claim() */
+    Claimed = "Claimed"
+}
+/**
+ * Reason for close position rejection.
+ *
+ * Maps to Cairo `CloseRejection` enum.
+ */
+export declare enum CloseRejectionReason {
+    None = "None",
+    NoPosition = "NoPosition",
+    MarketSettled = "MarketSettled",
+    MarketPaused = "MarketPaused",
+    AlreadyClosed = "AlreadyClosed",
+    AlreadyClaimed = "AlreadyClaimed",
+    InvalidAdditionalCollateral = "InvalidAdditionalCollateral",
+    InvalidPositionState = "InvalidPositionState",
+    InvalidHints = "InvalidHints",
+    BackingFail = "BackingFail",
+    LowCollateral = "LowCollateral",
+    VerificationFailed = "VerificationFailed",
+    CollateralTooLarge = "CollateralTooLarge",
+    InvalidState = "InvalidState"
+}
+/**
+ * Compact position information from get_position_compact.
+ *
+ * Contains the trader's original distribution (the market state before their first trade)
+ * plus position flags. Used for close_position operations.
+ *
+ * NOTE: Field names are camelCase because responses are normalized from snake_case.
+ */
+export interface PositionCompactRaw {
+    /** Original mean when trader first entered (market state before first trade) */
+    readonly originalMean: SQ128x128Raw;
+    /** Original variance when trader first entered */
+    readonly originalVariance: SQ128x128Raw;
+    /** Original sigma when trader first entered */
+    readonly originalSigma: SQ128x128Raw;
+    /** Original lambda when trader first entered */
+    readonly originalLambda: SQ128x128Raw;
+    /** Effective mean after all trades */
+    readonly effectiveMean: SQ128x128Raw;
+    /** Effective variance after all trades */
+    readonly effectiveVariance: SQ128x128Raw;
+    /** Effective sigma after all trades */
+    readonly effectiveSigma: SQ128x128Raw;
+    /** Effective lambda after all trades */
+    readonly effectiveLambda: SQ128x128Raw;
+    /** Close market mean (current market state for closing) */
+    readonly closeMarketMean: SQ128x128Raw;
+    /** Close market variance */
+    readonly closeMarketVariance: SQ128x128Raw;
+    /** Close market sigma */
+    readonly closeMarketSigma: SQ128x128Raw;
+    /** Close market lambda */
+    readonly closeMarketLambda: SQ128x128Raw;
+    /** Total collateral locked in position */
+    readonly totalCollateral: SQ128x128Raw;
+    /** Bitmask flags: bit 0 = exists, bit 1 = claimed, bit 2 = early_settled */
+    readonly flags: bigint;
+}
+/**
+ * Raw close position preview result.
+ *
+ * Contains all information about what would happen if a position is closed.
+ */
+export interface ClosePreviewRaw {
+    /** Effective distribution after close */
+    readonly effectiveDistribution: NormalDistributionRaw;
+    /** Target distribution for the close trade */
+    readonly targetDistribution: NormalDistributionRaw;
+    /** Resulting market distribution */
+    readonly marketDistribution: NormalDistributionRaw;
+    /** Whether position would be completely flat */
+    readonly wouldBeFlat: boolean;
+    /** Total collateral required for the close */
+    readonly collateralRequired: SQ128x128Raw;
+    /** Existing collateral locked in position */
+    readonly existingCollateral: SQ128x128Raw;
+    /** Additional collateral required (if any) */
+    readonly additionalRequired: SQ128x128Raw;
+    /** Estimated payout on close (in token decimals) */
+    readonly estimatedPayout: bigint;
+    /** LP fee for the close trade (in token decimals) */
+    readonly lpFee: bigint;
+    /** Protocol fee for the close trade (in token decimals) */
+    readonly protocolFee: bigint;
+    /** Whether the position can be closed */
+    readonly canClose: boolean;
+    /** Reason for rejection if canClose is false */
+    readonly rejectionReason: CloseRejectionReason;
+}
+/**
+ * Raw position close execution result.
+ *
+ * Contains the result of executing a close position operation.
+ */
+export interface PositionCloseResultRaw {
+    /** Whether a trade was executed to close */
+    readonly tradeExecuted: boolean;
+    /** Trade execution result if trade was executed */
+    readonly tradeResult: TradeExecutionRaw;
+    /** Whether position is now completely flat */
+    readonly isFlat: boolean;
+    /** Immediate payout to trader (in token decimals) */
+    readonly immediatePayout: bigint;
+    /** Collateral that was required */
+    readonly collateralRequired: SQ128x128Raw;
+    /** Existing collateral that was locked */
+    readonly existingCollateral: SQ128x128Raw;
+    /** Additional collateral that was supplied */
+    readonly additionalRequired: SQ128x128Raw;
+    /** Net additional collateral (after accounting for existing locked collateral) */
+    readonly netAdditionalCollateral: SQ128x128Raw;
+    /** LP fee paid (in token decimals) */
+    readonly lpFee: bigint;
+    /** Protocol fee paid (in token decimals) */
+    readonly protocolFee: bigint;
+    /** Rejection reason when trade execution did not proceed */
+    readonly rejectionReason: CloseRejectionReason;
+}
+/**
+ * Guard parameters for `close_position_guarded`.
+ *
+ * Guards constrain execution against stale market state and collateral drift.
+ */
+export interface CloseExecutionGuardsRaw {
+    readonly expectedMarketDist: NormalDistributionRaw;
+    readonly expectedBacking: SQ128x128Raw;
+    readonly expectedTolerance: SQ128x128Raw;
+    readonly expectedMinTradeCollateral: SQ128x128Raw;
+    readonly maxRequiredCollateral: SQ128x128Raw;
+    readonly maxAdditionalCollateral: SQ128x128Raw;
+    readonly maxAdditionalTokenAmount: bigint;
+}
+//# sourceMappingURL=common.d.ts.map

package/dist/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":"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"}

package/dist/common.js

@@ -0,0 +1,107 @@
+/**
+ * Common ABI types for The Situation contracts.
+ *
+ * These types match the Cairo `onchain::common` module and provide
+ * the serialization boundary between TypeScript and Starknet contracts.
+ *
+ * @module
+ */
+// ============================================================================
+// Constants
+// ============================================================================
+/** Maximum total fee in basis points (10% = 1000 bps) */
+export const MAX_FEE_BPS = 1000;
+/**
+ * Validates fee configuration.
+ */
+export function isValidFeeConfigRaw(config) {
+    const total = config.lpFeeBps + config.protocolFeeBps + config.settlementFeeBps;
+    return total <= MAX_FEE_BPS;
+}
+/**
+ * Creates a validated fee configuration.
+ */
+export function createFeeConfigRaw(lpFeeBps, protocolFeeBps, settlementFeeBps) {
+    const config = { lpFeeBps, protocolFeeBps, settlementFeeBps };
+    return isValidFeeConfigRaw(config) ? config : null;
+}
+/**
+ * Creates AMM parameters.
+ */
+export function createAmmParamsRaw(k, backing, tolerance, minTradeCollateral) {
+    return { k, backing, tolerance, minTradeCollateral };
+}
+/**
+ * Creates market status.
+ */
+export function createMarketStatusRaw(isInitialized, isPaused, isSettled, settlementValue) {
+    return { isInitialized, isPaused, isSettled, settlementValue };
+}
+// ============================================================================
+// Trade Rejection Types
+// ============================================================================
+/**
+ * Reason for trade rejection.
+ *
+ * Maps to Cairo `TradeRejectReason` enum.
+ */
+export var TradeRejectReason;
+(function (TradeRejectReason) {
+    /** Backing constraint check failed */
+    TradeRejectReason["BackingConstraintFailed"] = "BackingConstraintFailed";
+    /** Invalid hints provided */
+    TradeRejectReason["InvalidHints"] = "InvalidHints";
+    /** Insufficient collateral supplied */
+    TradeRejectReason["InsufficientCollateral"] = "InsufficientCollateral";
+    /** Collateral verification failed */
+    TradeRejectReason["VerificationFailed"] = "VerificationFailed";
+    /** Invalid candidate distribution */
+    TradeRejectReason["InvalidDistribution"] = "InvalidDistribution";
+})(TradeRejectReason || (TradeRejectReason = {}));
+// ============================================================================
+// Settlement Status Types (v0.4.0)
+// ============================================================================
+/**
+ * Settlement status from contract.
+ *
+ * Maps to Cairo `SettlementStatus` enum returned by
+ * `get_position_settlement_status()`.
+ *
+ * This is the native contract enum, distinct from the SDK's computed
+ * `SettlementState` which provides additional states like 'never_traded'.
+ */
+export var SettlementStatusRaw;
+(function (SettlementStatusRaw) {
+    /** Position has not been settled (neither claimed nor early settled) */
+    SettlementStatusRaw["NotSettled"] = "NotSettled";
+    /** Position was closed before market settlement via close_position() */
+    SettlementStatusRaw["EarlySettled"] = "EarlySettled";
+    /** Position was claimed after market settlement via claim() */
+    SettlementStatusRaw["Claimed"] = "Claimed";
+})(SettlementStatusRaw || (SettlementStatusRaw = {}));
+// ============================================================================
+// Close Position Types (v0.1.4)
+// ============================================================================
+/**
+ * Reason for close position rejection.
+ *
+ * Maps to Cairo `CloseRejection` enum.
+ */
+export var CloseRejectionReason;
+(function (CloseRejectionReason) {
+    CloseRejectionReason["None"] = "None";
+    CloseRejectionReason["NoPosition"] = "NoPosition";
+    CloseRejectionReason["MarketSettled"] = "MarketSettled";
+    CloseRejectionReason["MarketPaused"] = "MarketPaused";
+    CloseRejectionReason["AlreadyClosed"] = "AlreadyClosed";
+    CloseRejectionReason["AlreadyClaimed"] = "AlreadyClaimed";
+    CloseRejectionReason["InvalidAdditionalCollateral"] = "InvalidAdditionalCollateral";
+    CloseRejectionReason["InvalidPositionState"] = "InvalidPositionState";
+    CloseRejectionReason["InvalidHints"] = "InvalidHints";
+    CloseRejectionReason["BackingFail"] = "BackingFail";
+    CloseRejectionReason["LowCollateral"] = "LowCollateral";
+    CloseRejectionReason["VerificationFailed"] = "VerificationFailed";
+    CloseRejectionReason["CollateralTooLarge"] = "CollateralTooLarge";
+    CloseRejectionReason["InvalidState"] = "InvalidState";
+})(CloseRejectionReason || (CloseRejectionReason = {}));
+//# sourceMappingURL=common.js.map

package/dist/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,yDAAyD;AACzD,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC;AAkBhC;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAoB;IACtD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,cAAc,GAAG,MAAM,CAAC,gBAAgB,CAAC;IAChF,OAAO,KAAK,IAAI,WAAW,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAgB,EAChB,cAAsB,EACtB,gBAAwB;IAExB,MAAM,MAAM,GAAiB,EAAE,QAAQ,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAC;IAC5E,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AACrD,CAAC;AAoBD;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,CAAe,EACf,OAAqB,EACrB,SAAuB,EACvB,kBAAgC;IAEhC,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC;AACvD,CAAC;AAgBD;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,aAAsB,EACtB,QAAiB,EACjB,SAAkB,EAClB,eAA6B;IAE7B,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC;AACjE,CAAC;AAyMD,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,CAAN,IAAY,iBAWX;AAXD,WAAY,iBAAiB;IAC3B,sCAAsC;IACtC,wEAAmD,CAAA;IACnD,6BAA6B;IAC7B,kDAA6B,CAAA;IAC7B,uCAAuC;IACvC,sEAAiD,CAAA;IACjD,qCAAqC;IACrC,8DAAyC,CAAA;IACzC,qCAAqC;IACrC,gEAA2C,CAAA;AAC7C,CAAC,EAXW,iBAAiB,KAAjB,iBAAiB,QAW5B;AAoBD,+EAA+E;AAC/E,mCAAmC;AACnC,+EAA+E;AAE/E;;;;;;;;GAQG;AACH,MAAM,CAAN,IAAY,mBAOX;AAPD,WAAY,mBAAmB;IAC7B,wEAAwE;IACxE,gDAAyB,CAAA;IACzB,wEAAwE;IACxE,oDAA6B,CAAA;IAC7B,+DAA+D;IAC/D,0CAAmB,CAAA;AACrB,CAAC,EAPW,mBAAmB,KAAnB,mBAAmB,QAO9B;AAED,+EAA+E;AAC/E,gCAAgC;AAChC,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,CAAN,IAAY,oBAeX;AAfD,WAAY,oBAAoB;IAC9B,qCAAa,CAAA;IACb,iDAAyB,CAAA;IACzB,uDAA+B,CAAA;IAC/B,qDAA6B,CAAA;IAC7B,uDAA+B,CAAA;IAC/B,yDAAiC,CAAA;IACjC,mFAA2D,CAAA;IAC3D,qEAA6C,CAAA;IAC7C,qDAA6B,CAAA;IAC7B,mDAA2B,CAAA;IAC3B,uDAA+B,CAAA;IAC/B,iEAAyC,CAAA;IACzC,iEAAyC,CAAA;IACzC,qDAA6B,CAAA;AAC/B,CAAC,EAfW,oBAAoB,KAApB,oBAAoB,QAe/B"}

package/dist/factory.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Factory contract ABI types and function names.
+ *
+ * These match the latest `normal_factory` Cairo interface.
+ *
+ * @module
+ */
+import type { FeeConfigRaw, NormalSqrtHintsRaw } from './common';
+import type { NormalDistributionRaw, SQ128x128Raw } from '@the-situation/core';
+/**
+ * All factory contract function names.
+ */
+export declare const FACTORY_FUNCTION_NAMES: readonly ["get_amm_class_hash", "get_math_class_hash", "get_owner", "is_paused", "is_extension_approved", "deploy_normal_market", "approve_extension", "revoke_extension", "update_class_hash", "update_math_class_hash", "transfer_ownership", "pause", "unpause", "withdraw_protocol_fees"];
+export type FactoryFunctionName = (typeof FACTORY_FUNCTION_NAMES)[number];
+/**
+ * Parameters for deploying a normal market via the factory.
+ */
+export interface NormalMarketDeploymentParamsRaw {
+    readonly salt: string | bigint;
+    readonly marketOwner: string;
+    readonly marketAdmin: string;
+    readonly collateralToken: string;
+    readonly tokenDecimals: number;
+    readonly internalDecimals: number;
+    readonly initialDistribution: NormalDistributionRaw;
+    readonly k: SQ128x128Raw;
+    readonly backing: SQ128x128Raw;
+    readonly tolerance: SQ128x128Raw;
+    readonly minTradeCollateral: SQ128x128Raw;
+    readonly initialHints: NormalSqrtHintsRaw;
+    readonly feeConfig: FeeConfigRaw;
+    readonly extension: string;
+    readonly extensionCallPoints: number;
+    readonly metadataHash: string;
+}
+/**
+ * Return type mapping for factory view functions.
+ */
+export interface FactoryViewReturns {
+    get_amm_class_hash: string;
+    get_math_class_hash: string;
+    get_owner: string;
+    is_paused: boolean;
+    is_extension_approved: boolean;
+}
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAM/E;;GAEG;AACH,eAAO,MAAM,sBAAsB,+RAwBzB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAM1E;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,mBAAmB,EAAE,qBAAqB,CAAC;IACpD,QAAQ,CAAC,CAAC,EAAE,YAAY,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,kBAAkB,EAAE,YAAY,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAMD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,qBAAqB,EAAE,OAAO,CAAC;CAChC"}

package/dist/factory.js

@@ -0,0 +1,35 @@
+/**
+ * Factory contract ABI types and function names.
+ *
+ * These match the latest `normal_factory` Cairo interface.
+ *
+ * @module
+ */
+// ============================================================================
+// Function Names
+// ============================================================================
+/**
+ * All factory contract function names.
+ */
+export const FACTORY_FUNCTION_NAMES = [
+    // View functions
+    'get_amm_class_hash',
+    'get_math_class_hash',
+    'get_owner',
+    'is_paused',
+    'is_extension_approved',
+    // Deployment
+    'deploy_normal_market',
+    // Extension admin
+    'approve_extension',
+    'revoke_extension',
+    // Contract admin
+    'update_class_hash',
+    'update_math_class_hash',
+    'transfer_ownership',
+    'pause',
+    'unpause',
+    // Fee operations
+    'withdraw_protocol_fees',
+];
+//# sourceMappingURL=factory.js.map

package/dist/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,iBAAiB;IACjB,oBAAoB;IACpB,qBAAqB;IACrB,WAAW;IACX,WAAW;IACX,uBAAuB;IAEvB,aAAa;IACb,sBAAsB;IAEtB,kBAAkB;IAClB,mBAAmB;IACnB,kBAAkB;IAElB,iBAAiB;IACjB,mBAAmB;IACnB,wBAAwB;IACxB,oBAAoB;IACpB,OAAO;IACP,SAAS;IAET,iBAAiB;IACjB,wBAAwB;CAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * ABI types for The Situation contracts.
+ *
+ * This module provides TypeScript types that match the Cairo contract ABIs,
+ * enabling type-safe interactions with Starknet contracts.
+ *
+ * @module
+ */
+export { AMM_FUNCTION_NAMES, type AmmCloseReturns, type AmmFunctionName, type AmmLPReturns, type AmmSettlementReturns, type AmmTradeReturns, type AmmViewReturns, type TradeInput, type UpdateParametersInput, } from './amm';
+export { type AmmConfigRaw, type AmmParamsRaw, type ClaimResultRaw, type ClosePreviewRaw, CloseRejectionReason, type CollateralVerificationRaw, createAmmParamsRaw, createFeeConfigRaw, createMarketStatusRaw, type FeeConfigRaw, isValidFeeConfigRaw, type LPInfoRaw, MAX_FEE_BPS, type MarketStatusRaw, type NormalSqrtHintsRaw, type PdfNormCheckRaw, type CloseExecutionGuardsRaw, type PositionCloseResultRaw, type PositionDeltaRaw, type PositionDeltaV2Raw, type PositionCompactRaw, type PositionExtendedRaw, type PositionRaw, type ScaledBackingCheckRaw, SettlementStatusRaw, type TradeCheckRaw, type TradeExecutionRaw, type TradeRejectedEvent, TradeRejectReason, } from './common';
+export { FACTORY_FUNCTION_NAMES, type FactoryFunctionName, type FactoryViewReturns, type NormalMarketDeploymentParamsRaw, } from './factory';
+export { type CheckClosePositionCompactViewInput, MATH_LIBRARY_FUNCTION_NAMES, type CheckTradeViewInput, type ComputePositionValueViewInput, type MathLibraryFunctionName, type MathLibraryViewReturns, type PreviewAddLiquidityViewInput, type PreviewClaimViewInput, type PreviewRemoveLiquidityViewInput, } from './math-library';
+export { ORACLE_FUNCTION_NAMES, type Cumulative256Raw, type MarketKeyInput, type OracleFunctionName, type OracleViewReturns, type SnapshotRaw, } from './oracle';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,qBAAqB,GAC3B,MAAM,OAAO,CAAC;AAEf,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,YAAY,EAEjB,KAAK,cAAc,EAEnB,KAAK,eAAe,EACpB,oBAAoB,EACpB,KAAK,yBAAyB,EAC9B,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EAErB,KAAK,YAAY,EACjB,mBAAmB,EAEnB,KAAK,SAAS,EAEd,WAAW,EAEX,KAAK,eAAe,EAEpB,KAAK,kBAAkB,EAEvB,KAAK,eAAe,EAEpB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EAExB,KAAK,WAAW,EAEhB,KAAK,qBAAqB,EAC1B,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,sBAAsB,EACtB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,+BAA+B,GACrC,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,KAAK,kCAAkC,EACvC,2BAA2B,EAC3B,KAAK,mBAAmB,EACxB,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,4BAA4B,EACjC,KAAK,qBAAqB,EAC1B,KAAK,+BAA+B,GACrC,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,qBAAqB,EACrB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,WAAW,GACjB,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+/**
+ * ABI types for The Situation contracts.
+ *
+ * This module provides TypeScript types that match the Cairo contract ABIs,
+ * enabling type-safe interactions with Starknet contracts.
+ *
+ * @module
+ */
+// AMM contract types
+export { AMM_FUNCTION_NAMES, } from './amm';
+// Common types shared across contracts
+export { CloseRejectionReason, createAmmParamsRaw, createFeeConfigRaw, createMarketStatusRaw, isValidFeeConfigRaw, 
+// Constants
+MAX_FEE_BPS, SettlementStatusRaw, TradeRejectReason, } from './common';
+// Factory contract types
+export { FACTORY_FUNCTION_NAMES, } from './factory';
+// MathLibrary contract types (v0.3.0)
+export { MATH_LIBRARY_FUNCTION_NAMES, } from './math-library';
+// Oracle contract types
+export { ORACLE_FUNCTION_NAMES, } from './oracle';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,qBAAqB;AACrB,OAAO,EACL,kBAAkB,GASnB,MAAM,OAAO,CAAC;AACf,uCAAuC;AACvC,OAAO,EASL,oBAAoB,EAEpB,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EAGrB,mBAAmB;AAGnB,YAAY;AACZ,WAAW,EAkBX,mBAAmB,EAInB,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAElB,yBAAyB;AACzB,OAAO,EACL,sBAAsB,GAIvB,MAAM,WAAW,CAAC;AAEnB,sCAAsC;AACtC,OAAO,EAEL,2BAA2B,GAQ5B,MAAM,gBAAgB,CAAC;AAExB,wBAAwB;AACxB,OAAO,EACL,qBAAqB,GAMtB,MAAM,UAAU,CAAC"}

package/dist/math-library.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Math library ABI-facing types and function names.
+ *
+ * These match the v0.6.0 `INormalMathLibrary` interface.
+ *
+ * @module
+ */
+import type { NormalDistributionRaw, SQ128x128Raw } from '@the-situation/core';
+import type { AmmParamsRaw, ClaimResultRaw, FeeConfigRaw, NormalSqrtHintsRaw, PositionCloseResultRaw, PositionCompactRaw, PositionDeltaV2Raw, TradeCheckRaw } from './common';
+/**
+ * All supported view entrypoints on the math library.
+ */
+export declare const MATH_LIBRARY_FUNCTION_NAMES: readonly ["compute_hints_view", "check_trade_view", "compute_position_value_view", "preview_claim_view", "check_close_position_compact_view", "preview_add_liquidity_view", "preview_remove_liquidity_view"];
+export type MathLibraryFunctionName = (typeof MATH_LIBRARY_FUNCTION_NAMES)[number];
+/**
+ * Input for `check_trade_view`.
+ */
+export interface CheckTradeViewInput {
+    readonly currentDistribution: NormalDistributionRaw;
+    readonly candidateDistribution: NormalDistributionRaw;
+    readonly xStar: SQ128x128Raw;
+    readonly suppliedCollateral: SQ128x128Raw;
+    readonly params: AmmParamsRaw;
+    readonly currentHints: NormalSqrtHintsRaw;
+    readonly candidateHints: NormalSqrtHintsRaw;
+}
+/**
+ * Input for `compute_position_value_view`.
+ */
+export interface ComputePositionValueViewInput {
+    readonly deltas: readonly PositionDeltaV2Raw[];
+    readonly outcome: SQ128x128Raw;
+}
+/**
+ * Input for `preview_claim_view`.
+ */
+export interface PreviewClaimViewInput {
+    readonly deltas: readonly PositionDeltaV2Raw[];
+    readonly settlementValue: SQ128x128Raw;
+    readonly totalCollateral: SQ128x128Raw;
+    readonly internalDecimals: number;
+    readonly decimalShift: number;
+    readonly settlementFeeBps: number;
+}
+/**
+ * Input for `check_close_position_compact_view`.
+ */
+export interface CheckClosePositionCompactViewInput {
+    readonly position: PositionCompactRaw;
+    readonly marketDistribution: NormalDistributionRaw;
+    readonly xStar: SQ128x128Raw;
+    readonly additionalCollateral: SQ128x128Raw;
+    readonly params: AmmParamsRaw;
+    readonly currentHints: NormalSqrtHintsRaw;
+    readonly targetHints: NormalSqrtHintsRaw;
+    readonly internalDecimals: number;
+    readonly decimalShift: number;
+    readonly feeConfig: FeeConfigRaw;
+}
+/**
+ * Input for `preview_add_liquidity_view`.
+ */
+export interface PreviewAddLiquidityViewInput {
+    readonly shareAmount: SQ128x128Raw;
+    readonly totalShares: SQ128x128Raw;
+    readonly totalBacking: SQ128x128Raw;
+    readonly internalDecimals: number;
+    readonly decimalShift: number;
+}
+/**
+ * Input for `preview_remove_liquidity_view`.
+ */
+export interface PreviewRemoveLiquidityViewInput {
+    readonly shareAmount: SQ128x128Raw;
+    readonly totalShares: SQ128x128Raw;
+    readonly totalBacking: SQ128x128Raw;
+    readonly internalDecimals: number;
+    readonly decimalShift: number;
+}
+/**
+ * Return type mapping for math library entrypoints.
+ */
+export interface MathLibraryViewReturns {
+    compute_hints_view: NormalSqrtHintsRaw | null;
+    check_trade_view: TradeCheckRaw;
+    compute_position_value_view: SQ128x128Raw | null;
+    preview_claim_view: ClaimResultRaw;
+    check_close_position_compact_view: PositionCloseResultRaw;
+    preview_add_liquidity_view: bigint;
+    preview_remove_liquidity_view: bigint;
+}
+//# sourceMappingURL=math-library.d.ts.map

package/dist/math-library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math-library.d.ts","sourceRoot":"","sources":["../src/math-library.ts"],"names":[],"mappings":"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"}

package/dist/math-library.js

@@ -0,0 +1,20 @@
+/**
+ * Math library ABI-facing types and function names.
+ *
+ * These match the v0.6.0 `INormalMathLibrary` interface.
+ *
+ * @module
+ */
+/**
+ * All supported view entrypoints on the math library.
+ */
+export const MATH_LIBRARY_FUNCTION_NAMES = [
+    'compute_hints_view',
+    'check_trade_view',
+    'compute_position_value_view',
+    'preview_claim_view',
+    'check_close_position_compact_view',
+    'preview_add_liquidity_view',
+    'preview_remove_liquidity_view',
+];
+//# sourceMappingURL=math-library.js.map

package/dist/math-library.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"math-library.js","sourceRoot":"","sources":["../src/math-library.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,oBAAoB;IACpB,kBAAkB;IAClB,6BAA6B;IAC7B,oBAAoB;IACpB,mCAAmC;IACnC,4BAA4B;IAC5B,+BAA+B;CACvB,CAAC"}

package/dist/oracle.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Oracle contract ABI types and function names.
+ *
+ * These match the IOracle interface from Cairo contracts.
+ *
+ * @module
+ */
+import type { NormalDistributionRaw, SQ128x128Raw } from '@the-situation/core';
+/**
+ * 256-bit cumulative value for TWAP calculations.
+ *
+ * Uses the same limb representation as SQ128x128Raw for consistency.
+ */
+export interface Cumulative256Raw {
+    readonly limb0: bigint;
+    readonly limb1: bigint;
+    readonly limb2: bigint;
+    readonly limb3: bigint;
+    readonly neg: boolean;
+}
+/**
+ * Oracle snapshot stored for TWAP calculations.
+ */
+export interface SnapshotRaw {
+    readonly blockTimestamp: bigint;
+    readonly meanCumulative: Cumulative256Raw;
+    readonly varianceCumulative: Cumulative256Raw;
+}
+/**
+ * Market key for identifying a unique market.
+ *
+ * This uniquely identifies a market by its immutable parameters.
+ */
+export interface MarketKeyInput {
+    readonly collateralToken: string;
+    readonly initialDistribution: NormalDistributionRaw;
+    readonly k: SQ128x128Raw;
+    readonly initialBacking: SQ128x128Raw;
+    readonly extension: string;
+    /** Metadata hash for market identification (v0.1.4) */
+    readonly metadataHash: string;
+}
+/**
+ * All Oracle contract function names.
+ */
+export declare const ORACLE_FUNCTION_NAMES: readonly ["get_average_mean_over_period", "get_average_mean_over_last", "get_average_variance_over_period", "get_average_variance_over_last", "get_earliest_observation_time", "get_latest_observation_time", "get_snapshot_count", "get_snapshot", "get_amm"];
+export type OracleFunctionName = (typeof ORACLE_FUNCTION_NAMES)[number];
+/**
+ * Return type mapping for Oracle view functions.
+ */
+export interface OracleViewReturns {
+    get_average_mean_over_period: SQ128x128Raw;
+    get_average_mean_over_last: SQ128x128Raw;
+    get_average_variance_over_period: SQ128x128Raw;
+    get_average_variance_over_last: SQ128x128Raw;
+    get_earliest_observation_time: bigint;
+    get_latest_observation_time: bigint;
+    get_snapshot_count: bigint;
+    get_snapshot: SnapshotRaw;
+    get_amm: string;
+}
+//# sourceMappingURL=oracle.d.ts.map

package/dist/oracle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle.d.ts","sourceRoot":"","sources":["../src/oracle.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAM/E;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,gBAAgB,CAAC;IAC1C,QAAQ,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;CAC/C;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,mBAAmB,EAAE,qBAAqB,CAAC;IACpD,QAAQ,CAAC,CAAC,EAAE,YAAY,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,YAAY,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,uDAAuD;IACvD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAMD;;GAEG;AACH,eAAO,MAAM,qBAAqB,gQAWxB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAMxE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAEhC,4BAA4B,EAAE,YAAY,CAAC;IAE3C,0BAA0B,EAAE,YAAY,CAAC;IAEzC,gCAAgC,EAAE,YAAY,CAAC;IAE/C,8BAA8B,EAAE,YAAY,CAAC;IAE7C,6BAA6B,EAAE,MAAM,CAAC;IAEtC,2BAA2B,EAAE,MAAM,CAAC;IAEpC,kBAAkB,EAAE,MAAM,CAAC;IAE3B,YAAY,EAAE,WAAW,CAAC;IAE1B,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/oracle.js

@@ -0,0 +1,26 @@
+/**
+ * Oracle contract ABI types and function names.
+ *
+ * These match the IOracle interface from Cairo contracts.
+ *
+ * @module
+ */
+// ============================================================================
+// Function Names
+// ============================================================================
+/**
+ * All Oracle contract function names.
+ */
+export const ORACLE_FUNCTION_NAMES = [
+    // View functions
+    'get_average_mean_over_period',
+    'get_average_mean_over_last',
+    'get_average_variance_over_period',
+    'get_average_variance_over_last',
+    'get_earliest_observation_time',
+    'get_latest_observation_time',
+    'get_snapshot_count',
+    'get_snapshot',
+    'get_amm',
+];
+//# sourceMappingURL=oracle.js.map

package/dist/oracle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle.js","sourceRoot":"","sources":["../src/oracle.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA6CH,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,iBAAiB;IACjB,8BAA8B;IAC9B,4BAA4B;IAC5B,kCAAkC;IAClC,gCAAgC;IAChC,+BAA+B;IAC/B,6BAA6B;IAC7B,oBAAoB;IACpB,cAAc;IACd,SAAS;CACD,CAAC"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@the-situation/abi",
+  "version": "0.5.0-alpha.0",
+  "description": "ABI type definitions for The Situation contracts",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc -b",
+    "test": "bun test src/ 2>/dev/null || true",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo"
+  },
+  "dependencies": {
+    "@the-situation/core": "0.5.0-alpha.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "@types/bun": "^1.1.0"
+  },
+  "license": "MIT"
+}