@win-trader/bindings 0.0.1 → 0.0.3

package/config-manager/dist/index.d.ts

@@ -14,189 +14,37 @@ export declare const ConfigManagerError: {
     3: {
         message: string;
     };
-    /**
-     * `set_upgrade_timelock` called with seconds below `MIN_UPGRADE_TIMELOCK`.
-     */
     6: {
         message: string;
     };
-    /**
-     * `propose_admin(caller, new_admin)` rejected because `caller == new_admin`.
-     */
     7: {
         message: string;
     };
-    /**
-     * `accept_admin` rejected — caller is not the currently pending admin.
-     */
     8: {
         message: string;
     };
-    /**
-     * `accept_admin` rejected — there is no pending admin proposal.
-     */
     9: {
         message: string;
     };
-    /**
-     * `upgrade` rejected — no `propose_upgrade` was made before commit.
-     * The two-step upgrade flow requires a prior proposal.
-     */
     10: {
         message: string;
     };
-    /**
-     * `upgrade` rejected — timelock has not elapsed yet.
-     */
     11: {
         message: string;
     };
-    /**
-     * `upgrade` rejected — `new_wasm_hash` does not match the proposed
-     * `PendingUpgrade.wasm_hash`.
-     */
     12: {
         message: string;
     };
-    /**
-     * `accept_admin` rejected — the proposal is older than
-     * `ADMIN_PROPOSAL_TTL_SECS`.
-     */
     13: {
         message: string;
     };
-    /**
-     * `set_upgrade_timelock` called with seconds above
-     * `MAX_UPGRADE_TIMELOCK_SECS`.
-     */
     14: {
         message: string;
     };
-    /**
-     * FeeSplits components (lp/dev/staker) do not sum to exactly BPS.
-     */
-    22: {
-        message: string;
-    };
-    /**
-     * `min_collateral` is not strictly positive.
-     */
-    30: {
-        message: string;
-    };
-    /**
-     * `max_utilization_ratio` is out of (0, BPS] range.
-     */
-    31: {
-        message: string;
-    };
-    /**
-     * `funding_cut_bps` exceeds `MAX_FUNDING_CUT_BPS`.
-     */
-    32: {
-        message: string;
-    };
-    /**
-     * `adl_pnl_bps` is below `MIN_ADL_PNL_BPS` or above BPS.
-     */
-    33: {
-        message: string;
-    };
-    /**
-     * `adl_utilization_bps` is out of (0, BPS] range.
-     */
-    34: {
-        message: string;
-    };
-    /**
-     * `liquidation_threshold_bps` is below `MIN_LIQUIDATION_THRESHOLD_BPS`
-     * or exceeds 10% of collateral.
-     */
-    35: {
-        message: string;
-    };
-    /**
-     * `cooldown_duration` exceeds `MAX_COOLDOWN_DURATION`.
-     */
-    36: {
-        message: string;
-    };
-    /**
-     * `min_position_lifetime` exceeds `MAX_MIN_POSITION_LIFETIME_SECS`.
-     */
-    37: {
-        message: string;
-    };
-    /**
-     * A BorrowRateConfig rate is negative.
-     */
-    40: {
-        message: string;
-    };
-    /**
-     * `optimal_utilization_bps` is out of (0, BPS] range.
-     */
-    41: {
-        message: string;
-    };
-    /**
-     * `slope2_bps < slope1_bps` — kink curve must be non-decreasing.
-     */
-    42: {
-        message: string;
-    };
-    /**
-     * `slope2_bps` exceeds `MAX_SLOPE2_BPS`.
-     */
-    43: {
-        message: string;
-    };
-    /**
-     * `open_fee_bps` exceeds `MAX_OPEN_FEE_BPS`.
-     */
-    44: {
-        message: string;
-    };
-    /**
-     * `liquidation_bounty_bps` exceeds `MAX_LIQUIDATION_BOUNTY_BPS`.
-     */
-    45: {
-        message: string;
-    };
-    /**
-     * `tp_sl_execution_fee` is negative or exceeds `MAX_TP_SL_EXECUTION_FEE`.
-     */
-    46: {
-        message: string;
-    };
-    /**
-     * `base_borrow_rate_bps` exceeds `MAX_BASE_BORROW_RATE_BPS`.
-     */
-    47: {
-        message: string;
-    };
-    /**
-     * `base_funding_rate_bps` exceeds `MAX_BASE_FUNDING_RATE_BPS`.
-     */
-    48: {
-        message: string;
-    };
 };
 export type StorageKey = {
     tag: "Initialized";
     values: void;
-} | {
-    tag: "FeeSplits";
-    values: void;
-} | {
-    tag: "FeeConfig";
-    values: void;
-} | {
-    tag: "ProtocolLimits";
-    values: void;
-} | {
-    tag: "BorrowRateConfig";
-    values: void;
 } | {
     tag: "UpgradeTimelock";
     values: void;
@@ -207,10 +55,6 @@ export type StorageKey = {
     tag: "Version";
     values: void;
 };
-/**
- * Pending admin transfer awaiting `accept_admin`. The proposal timestamp
- * bounds its lifetime to `ADMIN_PROPOSAL_TTL_SECS`.
- */
 export interface PendingAdminProposal {
     admin: string;
     proposed_at: u64;
@@ -315,105 +159,210 @@ export type OwnableStorageKey = {
     values: void;
 };
 /**
- * Represents a single trader's open leveraged position.
+ * Authoritative per-market state: the side aggregates, the funding indices,
+ * the current funding flows, and the market configuration.
+ *
+ * Soroban limits UDT field names to 30 characters, so where a doc glossary
+ * term is longer the field drops the redundant qualifier and its doc
+ * comment carries the full term (e.g. `receiver_backed_index_long` is the
+ * doc's `receiver_backed_payer_index` for the long side).
  */
-export interface Position {
+export interface Market {
+    config: MarketConfig;
     /**
-   * USDC collateral deposited by the trader.
+   * `INDEX_PRECISION`-scaled bps/day payer rate for the current interval.
    */
-    collateral: i128;
+    current_payer_rate: i128;
+    current_payer_side: PayerSide;
+    last_funding_checkpoint: u64;
+    long: MarketSide;
     /**
-   * Global borrow accumulator index at position open (for lazy fee calc).
+   * Cumulative payer fee per unit of dominant-side size that is LP
+   * revenue on collection (§8.2).
    */
-    entry_borrow_index: i128;
+    lp_backed_index_long: i128;
+    lp_backed_index_short: i128;
     /**
-   * Global funding accumulator index at position open (for lazy fee calc).
+   * LP-allocated remainder of the payer flow, cash/second at
+   * `INDEX_PRECISION` (§8.1).
    */
-    entry_funding_index: i128;
+    lp_flow_per_second: i128;
+    lp_payer_remainder: i128;
     /**
-   * Oracle price at the time the position was opened (scaled by 1e7).
+   * Cumulative payer fee per unit of dominant-side size whose collection
+   * restores cash backing an already-accrued receiver claim (§8.2).
    */
-    entry_price: i128;
+    receiver_backed_index_long: i128;
+    receiver_backed_index_short: i128;
     /**
-   * Flat USDC fee escrowed when TP or SL is set. Paid to executor on trigger, refunded on user close / ADL, forfeited to revenue on liquidation.
+   * Receiver-allocated share of the payer flow, cash/second at
+   * `INDEX_PRECISION` (§8.1).
    */
-    execution_fee_escrow: i128;
+    receiver_flow_per_second: i128;
+    receiver_flow_remainder: i128;
     /**
-   * True for a long position, false for a short.
+   * Cumulative funding credit per unit of light-side size (§8.2).
    */
-    is_long: boolean;
-    /**
-   * Block timestamp when the position was last increased (anti-front-running lock).
-   */
-    last_increased_time: u64;
-    /**
-   * Notional size of the position in USDC.
-   */
-    size: i128;
-    /**
-   * Stop-loss price (scaled by 1e7). 0 = not set.
-   */
-    stop_loss: i128;
-    /**
-   * Take-profit price (scaled by 1e7). 0 = not set.
-   */
-    take_profit: i128;
+    receiver_index_long: i128;
+    receiver_index_remainder: i128;
+    receiver_index_short: i128;
+    receiver_payer_remainder: i128;
+    short: MarketSide;
+}
+export interface LpConfig {
+    lp_request_delay: u64;
+    max_withdraw_utilization_bps: u32;
+    min_deposit_nav_factor_bps: u32;
 }
 /**
- * Global market state for a single tradeable asset symbol.
+ * Represents a single trader's open leveraged position.
  */
-export interface MarketInfo {
+export interface Position {
     /**
-   * Cumulative borrow fee index (grows monotonically with time).
+   * Asset units at `PRICE_PRECISION`.
    */
-    acc_borrow_index: i128;
+    base_exposure: i128;
+    borrow_debt: i128;
     /**
-   * Cumulative funding rate index (signed; positive = longs pay shorts).
+   * Cash owned by an optional-order executor.
    */
-    acc_funding_index: i128;
+    execution_budget: i128;
+    funding_paid_to_lps_debt: i128;
+    funding_paid_to_receivers_debt: i128;
+    funding_received_debt: i128;
+    id: u64;
+    is_long: boolean;
+    last_increased_time: u64;
+    market: string;
+    owner: string;
     /**
-   * Volume-weighted average entry price of all active long positions.
+   * Fixed gross capacity assigned when risk opens.
    */
-    global_long_avg_price: i128;
+    risk_units: i128;
     /**
-   * Volume-weighted average entry price of all active short positions.
+   * USD notional at `PRICE_PRECISION`.
    */
-    global_short_avg_price: i128;
+    size: i128;
     /**
-   * Timestamp of the last keeper index update.
+   * Trigger price for the optional stop-loss order; `0` = none.
    */
-    last_index_update: u64;
+    stop_loss: i128;
     /**
-   * Total notional size of all open long positions.
+   * Trader-owned collateral recorded in contract state (the doc's
+   * "stored collateral"). Effective collateral — stored collateral after
+   * pending fees and funding credits — is always derived, never stored.
    */
-    long_open_interest: i128;
+    stored_collateral: i128;
     /**
-   * Total notional size of all open short positions.
+   * Trigger price for the optional take-profit order; `0` = none.
    */
-    short_open_interest: i128;
+    take_profit: i128;
+}
+export interface LpRequest {
+    amount: i128;
+    execute_after: u64;
+    id: u64;
+    kind: LpRequestKind;
+    owner: string;
+    request_time: u64;
+    status: LpRequestStatus;
+}
+/**
+ * Which side currently pays funding (§8.1: the side with more base
+ * exposure). `None` when the market is balanced or empty.
+ */
+export type PayerSide = {
+    tag: "None";
+    values: void;
+} | {
+    tag: "Long";
+    values: void;
+} | {
+    tag: "Short";
+    values: void;
+};
+export type RiskState = {
+    tag: "Normal";
+    values: void;
+} | {
+    tag: "Warning";
+    values: void;
+} | {
+    tag: "Adl";
+    values: void;
+} | {
+    tag: "HardCap";
+    values: void;
+};
+export interface MarketSide {
+    base_exposure: i128;
+    risk_state: RiskState;
+    risk_units: i128;
+    size_open_interest: i128;
+    stored_collateral_total: i128;
+}
+export interface RoundPrice {
+    price: i128;
+    symbol: string;
+}
+export interface OracleRound {
+    id: u64;
+    previous_id: u64;
+    previous_timestamp: u64;
+    prices: Array<RoundPrice>;
+    timestamp: u64;
+}
+export interface GlobalConfig {
+    base_borrow_rate_bps_day: i128;
+    hard_cap_factor_limit_bps: u32;
+    lp_revenue_share_bps: u32;
+    max_active_markets: u32;
+    max_adl_reward: i128;
+    max_insolvent_touch_reward: i128;
+    max_variable_borrow_bps_day: i128;
+    min_collateral: i128;
+    min_position_lifetime: u64;
+    risk_capacity_limit_bps: u32;
+    risk_keeper_revenue_share_bps: u32;
+}
+export interface MarketConfig {
+    adl_pnl_factor_bps: u32;
+    adl_reward_bps: u32;
+    hard_cap_pnl_factor_bps: u32;
+    liquidation_reward_bps: u32;
+    maintenance_margin_bps: u32;
+    market_risk_factor_bps: u32;
+    max_funding_rate_bps_day: i128;
+    max_long_base_exposure: i128;
+    max_long_size_open_interest: i128;
+    max_short_base_exposure: i128;
+    max_short_size_open_interest: i128;
+    open_fee_high_bps: u32;
+    open_fee_low_bps: u32;
+    recovery_pnl_factor_bps: u32;
+    warning_pnl_factor_bps: u32;
 }
 /**
  * Global safety thresholds for price validation.
  */
 export interface OracleConfig {
     /**
-   * How long a cached aggregated price remains valid (in seconds). A
-   * `get_price` call within this window of the last fetch returns the
-   * cached value without re-querying sources. Must be > 0 and
-   * <= `staleness_threshold` (otherwise the cache could outlive a fresh
-   * source price and serve stale data).
+   * How long a cached aggregated price remains valid after the router
+   * fetch (in seconds). A cache hit also requires every source timestamp
+   * used for the cached median to remain within `staleness_threshold`.
+   * Must be > 0 and <= `staleness_threshold`.
    */
     cache_duration: u64;
     /**
    * Maximum allowed spread between oracle sources in basis points
-   * (e.g., 100 = 1%). Bounded at `shared::constants::MAX_DEVIATION_BPS_CEILING`.
+   * (e.g., 100 = 1%). Bounded at `crate::constants::MAX_DEVIATION_BPS_CEILING`.
    */
     max_deviation_bps: i128;
     /**
    * Minimum number of source responses that must agree within
    * `max_deviation_bps` for OracleRouter to return a price. Floored at
-   * `shared::constants::MIN_REQUIRED_SOURCES_FLOOR`, ceilinged at
-   * `shared::constants::MAX_ORACLE_SOURCES`.
+   * `crate::constants::MIN_REQUIRED_SOURCES_FLOOR`, ceilinged at
+   * `crate::constants::MAX_ORACLE_SOURCES`.
    */
     min_required_sources: u32;
     /**
@@ -422,6 +371,13 @@ export interface OracleConfig {
    */
     staleness_threshold: u64;
 }
+export type LpRequestKind = {
+    tag: "Deposit";
+    values: void;
+} | {
+    tag: "Withdrawal";
+    values: void;
+};
 /**
  * Data required during a WASM migration. Single definition for all contracts.
  */
@@ -431,15 +387,54 @@ export interface MigrationData {
 /**
  * Pending WASM upgrade — set by `propose_upgrade`, consumed by `upgrade`
  * (cleared atomically on a successful install), or cleared by `cancel_upgrade`.
- * Single shape across every protocol contract; all four contracts store it at
+ * Single shape across every protocol contract. Contracts store it at
  * the shared `pending_upgrade` Symbol key in their own instance storage (see
- * `interfaces::upgrade::pending_upgrade_key`). `upgrade` refuses to install
+ * `crate::upgrade::pending_upgrade_key`). `upgrade` refuses to install
  * unless `pending.wasm_hash` matches the supplied hash and `now >= eta`.
  */
 export interface PendingUpgrade {
     eta: u64;
     wasm_hash: Buffer;
 }
+export type LpRequestStatus = {
+    tag: "Pending";
+    values: void;
+} | {
+    tag: "Settled";
+    values: void;
+} | {
+    tag: "Failed";
+    values: void;
+} | {
+    tag: "Expired";
+    values: void;
+};
+export interface SettlementResult {
+    /**
+   * Shares minted for a deposit or assets paid for a withdrawal.
+   */
+    amount: i128;
+    status: SettlementStatus;
+}
+export type SettlementStatus = {
+    tag: "Settled";
+    values: void;
+} | {
+    tag: "Failed";
+    values: void;
+};
+export interface AccountingSnapshot {
+    cash_lp_equity: i128;
+    cash_shortfall: i128;
+    free_lp_capital: i128;
+    lp_blocked_side_count: u32;
+    non_lp_claims: i128;
+    open_position_count: u64;
+    physical_cash: i128;
+    required_risk_backing: i128;
+    total_risk_units: i128;
+    vault_nav: i128;
+}
 export declare const UpgradeableError: {
     /**
      * When migration is attempted but not allowed due to upgrade state.
@@ -546,54 +541,12 @@ export type PausableStorageKey = {
     tag: "Paused";
     values: void;
 };
-/**
- * Execution-bounty and open-fee parameters charged to traders.
- * `open_fee_bps` and `liquidation_bounty_bps` are in basis points;
- * `tp_sl_execution_fee` is a flat USDC amount at PRECISION scale.
- */
-export interface FeeConfig {
-    liquidation_bounty_bps: u32;
-    open_fee_bps: u32;
-    tp_sl_execution_fee: i128;
-}
-/**
- * Defines how protocol revenue is split between parties.
- * All values are in basis points (bps). Must sum to 10_000.
- */
-export interface FeeSplits {
-    dev_bps: u32;
-    lp_bps: u32;
-    staker_bps: u32;
-}
-/**
- * Global protocol risk and timing parameters.
- */
-export interface ProtocolLimits {
-    adl_pnl_bps: u32;
-    adl_utilization_bps: u32;
-    cooldown_duration: u64;
-    funding_cut_bps: u32;
-    liquidation_threshold_bps: u32;
-    max_utilization_ratio: i128;
-    min_collateral: i128;
-    min_position_lifetime: u64;
-}
-/**
- * Borrow rate kink curve and funding rate parameters (all in basis points).
- */
-export interface BorrowRateConfig {
-    base_borrow_rate_bps: i128;
-    base_funding_rate_bps: i128;
-    optimal_utilization_bps: i128;
-    slope1_bps: i128;
-    slope2_bps: i128;
-}
 export interface Client {
     /**
      * Construct and simulate a migrate transaction. Returns an `AssembledTransaction` object which will have a `result` field containing the result of the simulation. If this transaction changes contract state, you will need to call `signAndSend()` on the returned object.
      */
-    migrate: ({ migration_data, operator }: {
-        migration_data: MigrationData;
+    migrate: ({ data, operator }: {
+        data: MigrationData;
         operator: string;
     }, options?: MethodOptions) => Promise<AssembledTransaction<null>>;
     /**
@@ -645,21 +598,6 @@ export interface Client {
     cancel_upgrade: ({ caller }: {
         caller: string;
     }, options?: MethodOptions) => Promise<AssembledTransaction<null>>;
-    /**
-     * Construct and simulate a get_fee_config transaction. Returns an `AssembledTransaction` object which will have a `result` field containing the result of the simulation. If this transaction changes contract state, you will need to call `signAndSend()` on the returned object.
-     */
-    get_fee_config: (options?: MethodOptions) => Promise<AssembledTransaction<FeeConfig>>;
-    /**
-     * Construct and simulate a get_fee_splits transaction. Returns an `AssembledTransaction` object which will have a `result` field containing the result of the simulation. If this transaction changes contract state, you will need to call `signAndSend()` on the returned object.
-     */
-    get_fee_splits: (options?: MethodOptions) => Promise<AssembledTransaction<FeeSplits>>;
-    /**
-     * Construct and simulate a set_fee_config transaction. Returns an `AssembledTransaction` object which will have a `result` field containing the result of the simulation. If this transaction changes contract state, you will need to call `signAndSend()` on the returned object.
-     */
-    set_fee_config: ({ caller, config }: {
-        caller: string;
-        config: FeeConfig;
-    }, options?: MethodOptions) => Promise<AssembledTransaction<null>>;
     /**
      * Construct and simulate a propose_upgrade transaction. Returns an `AssembledTransaction` object which will have a `result` field containing the result of the simulation. If this transaction changes contract state, you will need to call `signAndSend()` on the returned object.
      */
@@ -675,17 +613,6 @@ export interface Client {
      * Construct and simulate a get_pending_admin transaction. Returns an `AssembledTransaction` object which will have a `result` field containing the result of the simulation. If this transaction changes contract state, you will need to call `signAndSend()` on the returned object.
      */
     get_pending_admin: (options?: MethodOptions) => Promise<AssembledTransaction<Option<string>>>;
-    /**
-     * Construct and simulate a update_fee_splits transaction. Returns an `AssembledTransaction` object which will have a `result` field containing the result of the simulation. If this transaction changes contract state, you will need to call `signAndSend()` on the returned object.
-     */
-    update_fee_splits: ({ caller, fee_splits }: {
-        caller: string;
-        fee_splits: FeeSplits;
-    }, options?: MethodOptions) => Promise<AssembledTransaction<null>>;
-    /**
-     * Construct and simulate a get_protocol_limits transaction. Returns an `AssembledTransaction` object which will have a `result` field containing the result of the simulation. If this transaction changes contract state, you will need to call `signAndSend()` on the returned object.
-     */
-    get_protocol_limits: (options?: MethodOptions) => Promise<AssembledTransaction<ProtocolLimits>>;
     /**
      * Construct and simulate a get_upgrade_timelock transaction. Returns an `AssembledTransaction` object which will have a `result` field containing the result of the simulation. If this transaction changes contract state, you will need to call `signAndSend()` on the returned object.
      */
@@ -703,31 +630,13 @@ export interface Client {
     cancel_admin_proposal: ({ caller }: {
         caller: string;
     }, options?: MethodOptions) => Promise<AssembledTransaction<null>>;
-    /**
-     * Construct and simulate a get_borrow_rate_config transaction. Returns an `AssembledTransaction` object which will have a `result` field containing the result of the simulation. If this transaction changes contract state, you will need to call `signAndSend()` on the returned object.
-     */
-    get_borrow_rate_config: (options?: MethodOptions) => Promise<AssembledTransaction<BorrowRateConfig>>;
-    /**
-     * Construct and simulate a update_protocol_limits transaction. Returns an `AssembledTransaction` object which will have a `result` field containing the result of the simulation. If this transaction changes contract state, you will need to call `signAndSend()` on the returned object.
-     */
-    update_protocol_limits: ({ caller, limits }: {
-        caller: string;
-        limits: ProtocolLimits;
-    }, options?: MethodOptions) => Promise<AssembledTransaction<null>>;
-    /**
-     * Construct and simulate a update_borrow_rate_config transaction. Returns an `AssembledTransaction` object which will have a `result` field containing the result of the simulation. If this transaction changes contract state, you will need to call `signAndSend()` on the returned object.
-     */
-    update_borrow_rate_config: ({ caller, config }: {
-        caller: string;
-        config: BorrowRateConfig;
-    }, options?: MethodOptions) => Promise<AssembledTransaction<null>>;
 }
 export declare class Client extends ContractClient {
     readonly options: ContractClientOptions;
     static deploy<T = Client>(
     /** Constructor/Initialization Args for the contract's `__constructor` method */
-    { admin_address }: {
-        admin_address: string;
+    { admin }: {
+        admin: string;
     }, 
     /** Options for initializing a Client as well as for calling a method, with extras specific to deploying. */
     options: MethodOptions & Omit<ContractClientOptions, "contractId"> & {
@@ -748,19 +657,11 @@ export declare class Client extends ContractClient {
         accept_admin: (json: string) => AssembledTransaction<null>;
         propose_admin: (json: string) => AssembledTransaction<null>;
         cancel_upgrade: (json: string) => AssembledTransaction<null>;
-        get_fee_config: (json: string) => AssembledTransaction<FeeConfig>;
-        get_fee_splits: (json: string) => AssembledTransaction<FeeSplits>;
-        set_fee_config: (json: string) => AssembledTransaction<null>;
         propose_upgrade: (json: string) => AssembledTransaction<null>;
         bump_config_state: (json: string) => AssembledTransaction<null>;
         get_pending_admin: (json: string) => AssembledTransaction<Option<string>>;
-        update_fee_splits: (json: string) => AssembledTransaction<null>;
-        get_protocol_limits: (json: string) => AssembledTransaction<ProtocolLimits>;
         get_upgrade_timelock: (json: string) => AssembledTransaction<bigint>;
         set_upgrade_timelock: (json: string) => AssembledTransaction<null>;
         cancel_admin_proposal: (json: string) => AssembledTransaction<null>;
-        get_borrow_rate_config: (json: string) => AssembledTransaction<BorrowRateConfig>;
-        update_protocol_limits: (json: string) => AssembledTransaction<null>;
-        update_borrow_rate_config: (json: string) => AssembledTransaction<null>;
     };
 }