@strobelabs/perpcity-sdk 0.5.0 → 0.6.0

package/dist/{index.d.mts → index.d.cts}

@@ -1388,17 +1388,13 @@ declare const PERP_MANAGER_ABI: readonly [{
         readonly name: "funding";
         readonly type: "int256";
     }, {
-        readonly internalType: "int256";
+        readonly internalType: "uint256";
         readonly name: "netMargin";
-        readonly type: "int256";
+        readonly type: "uint256";
     }, {
         readonly internalType: "bool";
         readonly name: "wasLiquidated";
         readonly type: "bool";
-    }, {
-        readonly internalType: "uint256";
-        readonly name: "notional";
-        readonly type: "uint256";
     }];
     readonly stateMutability: "nonpayable";
     readonly type: "function";
@@ -1825,8 +1821,13 @@ type OpenMakerPositionParams = {
     priceLower: number;
     priceUpper: number;
     liquidity: bigint;
-    maxAmt0In: number | bigint;
-    maxAmt1In: number | bigint;
+    slippageTolerance?: number;
+    maxAmt0In?: number | bigint;
+    maxAmt1In?: number | bigint;
+};
+type QuoteOpenMakerPositionResult = {
+    perpDelta: bigint;
+    usdDelta: bigint;
 };
 type CreatePerpParams = {
     beacon: Address;
@@ -1860,6 +1861,11 @@ type MarginRatios = {
     max: number;
     liq: number;
 };
+type MakerDetails = {
+    unlockTimestamp: number;
+    tickLower: number;
+    tickUpper: number;
+};
 type PositionRawData = {
     perpId: Hex;
     positionId: bigint;
@@ -1867,6 +1873,18 @@ type PositionRawData = {
     entryPerpDelta: bigint;
     entryUsdDelta: bigint;
     marginRatios: MarginRatios;
+    makerDetails: MakerDetails | null;
+};
+type QuoteTakerPositionResult = {
+    perpDelta: bigint;
+    usdDelta: bigint;
+    fillPrice: number;
+};
+type QuoteClosePositionResult = {
+    pnl: number;
+    funding: number;
+    netMargin: number;
+    wasLiquidated: boolean;
 };
 type CacheConfig = {
     ttl: number;
@@ -6371,10 +6389,51 @@ declare function getPerpBeacon(perpData: PerpData): string;
 declare function getPerpBounds(perpData: PerpData): Bounds;
 declare function getPerpFees(perpData: PerpData): Fees;
 declare function getPerpTickSpacing(perpData: PerpData): number;
+declare function getFundingRate(context: PerpCityContext, perpId: Hex): Promise<{
+    ratePerDay: number;
+    ratePerMinute: number;
+    rawX96: bigint;
+}>;
+declare function getIndexValue(context: PerpCityContext, perpId: Hex): Promise<bigint>;
+declare function getIndexTWAP(context: PerpCityContext, perpId: Hex, secondsAgo: number): Promise<bigint>;
 
 declare function createPerp(context: PerpCityContext, params: CreatePerpParams): Promise<Hex>;
 declare function openTakerPosition(context: PerpCityContext, perpId: Hex, params: OpenTakerPositionParams): Promise<OpenPosition>;
+declare function calculateAlignedTicks(priceLower: number, priceUpper: number, tickSpacing: number): {
+    alignedTickLower: number;
+    alignedTickUpper: number;
+};
+declare const DEFAULT_MAKER_SLIPPAGE_TOLERANCE = 0.01;
+declare const MAX_UINT128: bigint;
+declare function quoteOpenMakerPosition(context: PerpCityContext, perpId: Hex, params: OpenMakerPositionParams): Promise<QuoteOpenMakerPositionResult>;
+/**
+ * Computes maxAmtIn slippage limit from a quote delta.
+ *
+ * When delta < 0 (tokens need to go in), applies slippage tolerance to the
+ * absolute amount. When delta >= 0 (quote says no tokens needed), uses
+ * `fallbackRef` as a reference to compute a small buffer — this prevents
+ * reverts when price moves between quote and execution, shifting the token
+ * split so some amount of this token is now required.
+ *
+ * Note: `fallbackRef` is intentionally the *other* leg's delta (cross-unit).
+ * It is only used as a rough magnitude reference for sizing a small buffer,
+ * not as a precise same-unit value. For maker positions the two legs are
+ * correlated in magnitude, so this heuristic produces a reasonable buffer.
+ */
+declare function applySlippage(delta: bigint, slippageTolerance: number, fallbackRef?: bigint): bigint;
 declare function openMakerPosition(context: PerpCityContext, perpId: Hex, params: OpenMakerPositionParams): Promise<OpenPosition>;
+declare function quoteTakerPosition(context: PerpCityContext, perpId: Hex, params: {
+    holder: Address;
+    isLong: boolean;
+    margin: number;
+    leverage: number;
+}): Promise<QuoteTakerPositionResult>;
+declare function adjustMargin(context: PerpCityContext, positionId: bigint, marginDelta: bigint): Promise<{
+    txHash: Hex;
+}>;
+declare function adjustNotional(context: PerpCityContext, positionId: bigint, usdDelta: bigint, perpLimit: bigint): Promise<{
+    txHash: Hex;
+}>;
 
 declare function getPositionPerpId(positionData: OpenPositionData): Hex;
 declare function getPositionId(positionData: OpenPositionData): bigint;
@@ -6385,6 +6444,10 @@ declare function getPositionPnl(positionData: OpenPositionData): number;
 declare function getPositionFundingPayment(positionData: OpenPositionData): number;
 declare function getPositionEffectiveMargin(positionData: OpenPositionData): number;
 declare function getPositionIsLiquidatable(positionData: OpenPositionData): boolean;
+declare function quoteClosePosition(context: PerpCityContext, positionId: bigint): Promise<QuoteClosePositionResult>;
+declare function closePositionWithQuote(context: PerpCityContext, _perpId: Hex, positionId: bigint, 
+/** Slippage as a fraction, e.g. 0.01 = 1%. Compare with calculateClosePositionParams which uses percentage form (1 = 1%). */
+slippageTolerance?: number): Promise<ClosePositionResult>;
 declare function closePosition(context: PerpCityContext, perpId: Hex, positionId: bigint, params: ClosePositionParams): Promise<ClosePositionResult>;
 declare function getPositionLiveDetailsFromContract(context: PerpCityContext, _perpId: Hex, positionId: bigint): Promise<LiveDetails>;
 /**
@@ -6427,16 +6490,46 @@ declare function calculateLeverage(positionValue: number, effectiveMargin: numbe
  * @returns Liquidation price in USD, or null if cannot be calculated
  */
 declare function calculateLiquidationPrice(rawData: PositionRawData, isLong: boolean): number | null;
+declare function calculatePnlPercentage(pnl: number, funding: number, margin: number): number;
+/**
+ * Calculates ClosePositionParams for a position close, handling the difference
+ * between taker and maker positions.
+ *
+ * For taker positions, the contract checks minAmt1Out (for longs) or maxAmt1In
+ * (for shorts) against the raw USD swap delta — NOT netMargin. The swap amount
+ * corresponds to the position's notional value at current price, so slippage
+ * limits must be based on `notional`, not `expectedReturn`.
+ *
+ * For maker positions, the contract checks minAmt0Out and minAmt1Out against
+ * the raw token amounts from Uniswap liquidity removal. The split between
+ * perp tokens and USDC depends on where the current price sits in the LP range,
+ * and quoteClosePosition only returns the aggregate netMargin. Since we cannot
+ * predict the individual token amounts, both minimums are set to 0.
+ */
+declare function calculateClosePositionParams(opts: {
+    isMaker: boolean;
+    isLong?: boolean;
+    notional: number;
+    /** Slippage as a percentage, e.g. 1 = 1%. Compare with closePositionWithQuote which uses fractional form (0.01 = 1%). */
+    slippagePercent: number;
+}): ClosePositionParams;
 
 declare function getUserUsdcBalance(userData: UserData): number;
 declare function getUserOpenPositions(userData: UserData): OpenPositionData[];
 declare function getUserWalletAddress(userData: UserData): Hex;
 
+declare function getUsdcAllowance(context: PerpCityContext, owner: Address): Promise<bigint>;
 declare function approveUsdc(context: PerpCityContext, amount: bigint, confirmations?: number): Promise<void>;
 
 declare const NUMBER_1E6: number;
 declare const BIGINT_1E6: bigint;
 declare const Q96: bigint;
+declare const MIN_TICK = -887272;
+declare const MAX_TICK = 887272;
+declare const MIN_PRICE = 0.000001;
+declare const MAX_PRICE = 1000000;
+declare const UINT256_MAX: bigint;
+declare const INT256_THRESHOLD: bigint;
 
 declare function priceToSqrtPriceX96(price: number): bigint;
 /**
@@ -6449,6 +6542,12 @@ declare function scaleToX96(amount: number): bigint;
 declare function scaleFromX96(valueX96: bigint): number;
 declare function priceToTick(price: number, roundDown: boolean): number;
 declare function tickToPrice(tick: number): number;
+/**
+ * Interprets a uint256 as int256 if it exceeds 2^255 (unsigned underflow).
+ * The contract returns netMargin as uint256, but it can underflow when
+ * the effective margin is negative (position is underwater).
+ */
+declare function uint256ToInt256(value: bigint): bigint;
 declare function sqrtPriceX96ToPrice(sqrtPriceX96: bigint): number;
 declare function marginRatioToLeverage(marginRatio: number): number;
 declare function scaleFrom6Decimals(value: number): number;
@@ -6530,6 +6629,14 @@ declare function parseContractError(error: unknown): PerpCityError;
  */
 declare function withErrorHandling<T>(fn: () => Promise<T>, context: string): Promise<T>;
 
+/**
+ * Convert a funding diff (over `interval` seconds) to a percentage for `period` seconds.
+ * Defers the interval division until after scaling to avoid truncating small differentials.
+ */
+declare function convertFundingDiffX96ToPercentPerPeriod(fundingDiffX96: bigint, interval: bigint, periodSeconds: bigint): number;
+declare function convertFundingPerSecondX96ToPercentPerMinute(fundingPerSecondX96: bigint): number;
+declare function convertFundingPerSecondX96ToPercentPerDay(fundingPerSecondX96: bigint): number;
+
 /**
  * Calculate liquidity from USDC amount (amount1) using Uniswap v3 formula
  * liquidity = amount1 / (sqrt(priceUpper) - sqrt(priceLower))
@@ -6591,4 +6698,4 @@ interface RpcConfig {
  */
 declare function getRpcUrl(config?: RpcConfig): string;
 
-export { BEACON_ABI, BIGINT_1E6, type Bounds, type CacheConfig, type ClosePositionParams, type ClosePositionResult, ContractError, type CreatePerpParams, ErrorCategory, type ErrorDebugInfo, ErrorSource, type Fees, InsufficientFundsError, type LiveDetails, type MarginRatios, NUMBER_1E6, type OpenMakerPositionParams, OpenPosition, type OpenPositionData, type OpenTakerPositionParams, PERP_MANAGER_ABI, PerpCityContext, type PerpCityContextConfig, type PerpCityDeployments, PerpCityError, type PerpConfig, type PerpData, type PositionRawData, Q96, RPCError, type RpcConfig, TransactionRejectedError, type UserData, ValidationError, approveUsdc, calculateEntryPrice, calculateLeverage, calculateLiquidationPrice, calculateLiquidityForTargetRatio, calculatePositionSize, calculatePositionValue, closePosition, createPerp, estimateLiquidity, getPerpBeacon, getPerpBounds, getPerpFees, getPerpMark, getPerpTickSpacing, getPositionEffectiveMargin, getPositionFundingPayment, getPositionId, getPositionIsLiquidatable, getPositionIsLong, getPositionIsMaker, getPositionLiveDetails, getPositionLiveDetailsFromContract, getPositionPerpId, getPositionPnl, getRpcUrl, getUserOpenPositions, getUserUsdcBalance, getUserWalletAddress, marginRatioToLeverage, openMakerPosition, openTakerPosition, parseContractError, priceToSqrtPriceX96, priceToTick, scale6Decimals, scaleFrom6Decimals, scaleFromX96, scaleToX96, sqrtPriceX96ToPrice, tickToPrice, withErrorHandling };
+export { BEACON_ABI, BIGINT_1E6, type Bounds, type CacheConfig, type ClosePositionParams, type ClosePositionResult, ContractError, type CreatePerpParams, DEFAULT_MAKER_SLIPPAGE_TOLERANCE, ErrorCategory, type ErrorDebugInfo, ErrorSource, type Fees, INT256_THRESHOLD, InsufficientFundsError, type LiveDetails, MAX_PRICE, MAX_TICK, MAX_UINT128, MIN_PRICE, MIN_TICK, type MakerDetails, type MarginRatios, NUMBER_1E6, type OpenMakerPositionParams, OpenPosition, type OpenPositionData, type OpenTakerPositionParams, PERP_MANAGER_ABI, PerpCityContext, type PerpCityContextConfig, type PerpCityDeployments, PerpCityError, type PerpConfig, type PerpData, type PositionRawData, Q96, type QuoteClosePositionResult, type QuoteOpenMakerPositionResult, type QuoteTakerPositionResult, RPCError, type RpcConfig, TransactionRejectedError, UINT256_MAX, type UserData, ValidationError, adjustMargin, adjustNotional, applySlippage, approveUsdc, calculateAlignedTicks, calculateClosePositionParams, calculateEntryPrice, calculateLeverage, calculateLiquidationPrice, calculateLiquidityForTargetRatio, calculatePnlPercentage, calculatePositionSize, calculatePositionValue, closePosition, closePositionWithQuote, convertFundingDiffX96ToPercentPerPeriod, convertFundingPerSecondX96ToPercentPerDay, convertFundingPerSecondX96ToPercentPerMinute, createPerp, estimateLiquidity, getFundingRate, getIndexTWAP, getIndexValue, getPerpBeacon, getPerpBounds, getPerpFees, getPerpMark, getPerpTickSpacing, getPositionEffectiveMargin, getPositionFundingPayment, getPositionId, getPositionIsLiquidatable, getPositionIsLong, getPositionIsMaker, getPositionLiveDetails, getPositionLiveDetailsFromContract, getPositionPerpId, getPositionPnl, getRpcUrl, getUsdcAllowance, getUserOpenPositions, getUserUsdcBalance, getUserWalletAddress, marginRatioToLeverage, openMakerPosition, openTakerPosition, parseContractError, priceToSqrtPriceX96, priceToTick, quoteClosePosition, quoteOpenMakerPosition, quoteTakerPosition, scale6Decimals, scaleFrom6Decimals, scaleFromX96, scaleToX96, sqrtPriceX96ToPrice, tickToPrice, uint256ToInt256, withErrorHandling };

package/dist/index.d.ts

@@ -1388,17 +1388,13 @@ declare const PERP_MANAGER_ABI: readonly [{
         readonly name: "funding";
         readonly type: "int256";
     }, {
-        readonly internalType: "int256";
+        readonly internalType: "uint256";
         readonly name: "netMargin";
-        readonly type: "int256";
+        readonly type: "uint256";
     }, {
         readonly internalType: "bool";
         readonly name: "wasLiquidated";
         readonly type: "bool";
-    }, {
-        readonly internalType: "uint256";
-        readonly name: "notional";
-        readonly type: "uint256";
     }];
     readonly stateMutability: "nonpayable";
     readonly type: "function";
@@ -1825,8 +1821,13 @@ type OpenMakerPositionParams = {
     priceLower: number;
     priceUpper: number;
     liquidity: bigint;
-    maxAmt0In: number | bigint;
-    maxAmt1In: number | bigint;
+    slippageTolerance?: number;
+    maxAmt0In?: number | bigint;
+    maxAmt1In?: number | bigint;
+};
+type QuoteOpenMakerPositionResult = {
+    perpDelta: bigint;
+    usdDelta: bigint;
 };
 type CreatePerpParams = {
     beacon: Address;
@@ -1860,6 +1861,11 @@ type MarginRatios = {
     max: number;
     liq: number;
 };
+type MakerDetails = {
+    unlockTimestamp: number;
+    tickLower: number;
+    tickUpper: number;
+};
 type PositionRawData = {
     perpId: Hex;
     positionId: bigint;
@@ -1867,6 +1873,18 @@ type PositionRawData = {
     entryPerpDelta: bigint;
     entryUsdDelta: bigint;
     marginRatios: MarginRatios;
+    makerDetails: MakerDetails | null;
+};
+type QuoteTakerPositionResult = {
+    perpDelta: bigint;
+    usdDelta: bigint;
+    fillPrice: number;
+};
+type QuoteClosePositionResult = {
+    pnl: number;
+    funding: number;
+    netMargin: number;
+    wasLiquidated: boolean;
 };
 type CacheConfig = {
     ttl: number;
@@ -6371,10 +6389,51 @@ declare function getPerpBeacon(perpData: PerpData): string;
 declare function getPerpBounds(perpData: PerpData): Bounds;
 declare function getPerpFees(perpData: PerpData): Fees;
 declare function getPerpTickSpacing(perpData: PerpData): number;
+declare function getFundingRate(context: PerpCityContext, perpId: Hex): Promise<{
+    ratePerDay: number;
+    ratePerMinute: number;
+    rawX96: bigint;
+}>;
+declare function getIndexValue(context: PerpCityContext, perpId: Hex): Promise<bigint>;
+declare function getIndexTWAP(context: PerpCityContext, perpId: Hex, secondsAgo: number): Promise<bigint>;
 
 declare function createPerp(context: PerpCityContext, params: CreatePerpParams): Promise<Hex>;
 declare function openTakerPosition(context: PerpCityContext, perpId: Hex, params: OpenTakerPositionParams): Promise<OpenPosition>;
+declare function calculateAlignedTicks(priceLower: number, priceUpper: number, tickSpacing: number): {
+    alignedTickLower: number;
+    alignedTickUpper: number;
+};
+declare const DEFAULT_MAKER_SLIPPAGE_TOLERANCE = 0.01;
+declare const MAX_UINT128: bigint;
+declare function quoteOpenMakerPosition(context: PerpCityContext, perpId: Hex, params: OpenMakerPositionParams): Promise<QuoteOpenMakerPositionResult>;
+/**
+ * Computes maxAmtIn slippage limit from a quote delta.
+ *
+ * When delta < 0 (tokens need to go in), applies slippage tolerance to the
+ * absolute amount. When delta >= 0 (quote says no tokens needed), uses
+ * `fallbackRef` as a reference to compute a small buffer — this prevents
+ * reverts when price moves between quote and execution, shifting the token
+ * split so some amount of this token is now required.
+ *
+ * Note: `fallbackRef` is intentionally the *other* leg's delta (cross-unit).
+ * It is only used as a rough magnitude reference for sizing a small buffer,
+ * not as a precise same-unit value. For maker positions the two legs are
+ * correlated in magnitude, so this heuristic produces a reasonable buffer.
+ */
+declare function applySlippage(delta: bigint, slippageTolerance: number, fallbackRef?: bigint): bigint;
 declare function openMakerPosition(context: PerpCityContext, perpId: Hex, params: OpenMakerPositionParams): Promise<OpenPosition>;
+declare function quoteTakerPosition(context: PerpCityContext, perpId: Hex, params: {
+    holder: Address;
+    isLong: boolean;
+    margin: number;
+    leverage: number;
+}): Promise<QuoteTakerPositionResult>;
+declare function adjustMargin(context: PerpCityContext, positionId: bigint, marginDelta: bigint): Promise<{
+    txHash: Hex;
+}>;
+declare function adjustNotional(context: PerpCityContext, positionId: bigint, usdDelta: bigint, perpLimit: bigint): Promise<{
+    txHash: Hex;
+}>;
 
 declare function getPositionPerpId(positionData: OpenPositionData): Hex;
 declare function getPositionId(positionData: OpenPositionData): bigint;
@@ -6385,6 +6444,10 @@ declare function getPositionPnl(positionData: OpenPositionData): number;
 declare function getPositionFundingPayment(positionData: OpenPositionData): number;
 declare function getPositionEffectiveMargin(positionData: OpenPositionData): number;
 declare function getPositionIsLiquidatable(positionData: OpenPositionData): boolean;
+declare function quoteClosePosition(context: PerpCityContext, positionId: bigint): Promise<QuoteClosePositionResult>;
+declare function closePositionWithQuote(context: PerpCityContext, _perpId: Hex, positionId: bigint, 
+/** Slippage as a fraction, e.g. 0.01 = 1%. Compare with calculateClosePositionParams which uses percentage form (1 = 1%). */
+slippageTolerance?: number): Promise<ClosePositionResult>;
 declare function closePosition(context: PerpCityContext, perpId: Hex, positionId: bigint, params: ClosePositionParams): Promise<ClosePositionResult>;
 declare function getPositionLiveDetailsFromContract(context: PerpCityContext, _perpId: Hex, positionId: bigint): Promise<LiveDetails>;
 /**
@@ -6427,16 +6490,46 @@ declare function calculateLeverage(positionValue: number, effectiveMargin: numbe
  * @returns Liquidation price in USD, or null if cannot be calculated
  */
 declare function calculateLiquidationPrice(rawData: PositionRawData, isLong: boolean): number | null;
+declare function calculatePnlPercentage(pnl: number, funding: number, margin: number): number;
+/**
+ * Calculates ClosePositionParams for a position close, handling the difference
+ * between taker and maker positions.
+ *
+ * For taker positions, the contract checks minAmt1Out (for longs) or maxAmt1In
+ * (for shorts) against the raw USD swap delta — NOT netMargin. The swap amount
+ * corresponds to the position's notional value at current price, so slippage
+ * limits must be based on `notional`, not `expectedReturn`.
+ *
+ * For maker positions, the contract checks minAmt0Out and minAmt1Out against
+ * the raw token amounts from Uniswap liquidity removal. The split between
+ * perp tokens and USDC depends on where the current price sits in the LP range,
+ * and quoteClosePosition only returns the aggregate netMargin. Since we cannot
+ * predict the individual token amounts, both minimums are set to 0.
+ */
+declare function calculateClosePositionParams(opts: {
+    isMaker: boolean;
+    isLong?: boolean;
+    notional: number;
+    /** Slippage as a percentage, e.g. 1 = 1%. Compare with closePositionWithQuote which uses fractional form (0.01 = 1%). */
+    slippagePercent: number;
+}): ClosePositionParams;
 
 declare function getUserUsdcBalance(userData: UserData): number;
 declare function getUserOpenPositions(userData: UserData): OpenPositionData[];
 declare function getUserWalletAddress(userData: UserData): Hex;
 
+declare function getUsdcAllowance(context: PerpCityContext, owner: Address): Promise<bigint>;
 declare function approveUsdc(context: PerpCityContext, amount: bigint, confirmations?: number): Promise<void>;
 
 declare const NUMBER_1E6: number;
 declare const BIGINT_1E6: bigint;
 declare const Q96: bigint;
+declare const MIN_TICK = -887272;
+declare const MAX_TICK = 887272;
+declare const MIN_PRICE = 0.000001;
+declare const MAX_PRICE = 1000000;
+declare const UINT256_MAX: bigint;
+declare const INT256_THRESHOLD: bigint;
 
 declare function priceToSqrtPriceX96(price: number): bigint;
 /**
@@ -6449,6 +6542,12 @@ declare function scaleToX96(amount: number): bigint;
 declare function scaleFromX96(valueX96: bigint): number;
 declare function priceToTick(price: number, roundDown: boolean): number;
 declare function tickToPrice(tick: number): number;
+/**
+ * Interprets a uint256 as int256 if it exceeds 2^255 (unsigned underflow).
+ * The contract returns netMargin as uint256, but it can underflow when
+ * the effective margin is negative (position is underwater).
+ */
+declare function uint256ToInt256(value: bigint): bigint;
 declare function sqrtPriceX96ToPrice(sqrtPriceX96: bigint): number;
 declare function marginRatioToLeverage(marginRatio: number): number;
 declare function scaleFrom6Decimals(value: number): number;
@@ -6530,6 +6629,14 @@ declare function parseContractError(error: unknown): PerpCityError;
  */
 declare function withErrorHandling<T>(fn: () => Promise<T>, context: string): Promise<T>;
 
+/**
+ * Convert a funding diff (over `interval` seconds) to a percentage for `period` seconds.
+ * Defers the interval division until after scaling to avoid truncating small differentials.
+ */
+declare function convertFundingDiffX96ToPercentPerPeriod(fundingDiffX96: bigint, interval: bigint, periodSeconds: bigint): number;
+declare function convertFundingPerSecondX96ToPercentPerMinute(fundingPerSecondX96: bigint): number;
+declare function convertFundingPerSecondX96ToPercentPerDay(fundingPerSecondX96: bigint): number;
+
 /**
  * Calculate liquidity from USDC amount (amount1) using Uniswap v3 formula
  * liquidity = amount1 / (sqrt(priceUpper) - sqrt(priceLower))
@@ -6591,4 +6698,4 @@ interface RpcConfig {
  */
 declare function getRpcUrl(config?: RpcConfig): string;
 
-export { BEACON_ABI, BIGINT_1E6, type Bounds, type CacheConfig, type ClosePositionParams, type ClosePositionResult, ContractError, type CreatePerpParams, ErrorCategory, type ErrorDebugInfo, ErrorSource, type Fees, InsufficientFundsError, type LiveDetails, type MarginRatios, NUMBER_1E6, type OpenMakerPositionParams, OpenPosition, type OpenPositionData, type OpenTakerPositionParams, PERP_MANAGER_ABI, PerpCityContext, type PerpCityContextConfig, type PerpCityDeployments, PerpCityError, type PerpConfig, type PerpData, type PositionRawData, Q96, RPCError, type RpcConfig, TransactionRejectedError, type UserData, ValidationError, approveUsdc, calculateEntryPrice, calculateLeverage, calculateLiquidationPrice, calculateLiquidityForTargetRatio, calculatePositionSize, calculatePositionValue, closePosition, createPerp, estimateLiquidity, getPerpBeacon, getPerpBounds, getPerpFees, getPerpMark, getPerpTickSpacing, getPositionEffectiveMargin, getPositionFundingPayment, getPositionId, getPositionIsLiquidatable, getPositionIsLong, getPositionIsMaker, getPositionLiveDetails, getPositionLiveDetailsFromContract, getPositionPerpId, getPositionPnl, getRpcUrl, getUserOpenPositions, getUserUsdcBalance, getUserWalletAddress, marginRatioToLeverage, openMakerPosition, openTakerPosition, parseContractError, priceToSqrtPriceX96, priceToTick, scale6Decimals, scaleFrom6Decimals, scaleFromX96, scaleToX96, sqrtPriceX96ToPrice, tickToPrice, withErrorHandling };
+export { BEACON_ABI, BIGINT_1E6, type Bounds, type CacheConfig, type ClosePositionParams, type ClosePositionResult, ContractError, type CreatePerpParams, DEFAULT_MAKER_SLIPPAGE_TOLERANCE, ErrorCategory, type ErrorDebugInfo, ErrorSource, type Fees, INT256_THRESHOLD, InsufficientFundsError, type LiveDetails, MAX_PRICE, MAX_TICK, MAX_UINT128, MIN_PRICE, MIN_TICK, type MakerDetails, type MarginRatios, NUMBER_1E6, type OpenMakerPositionParams, OpenPosition, type OpenPositionData, type OpenTakerPositionParams, PERP_MANAGER_ABI, PerpCityContext, type PerpCityContextConfig, type PerpCityDeployments, PerpCityError, type PerpConfig, type PerpData, type PositionRawData, Q96, type QuoteClosePositionResult, type QuoteOpenMakerPositionResult, type QuoteTakerPositionResult, RPCError, type RpcConfig, TransactionRejectedError, UINT256_MAX, type UserData, ValidationError, adjustMargin, adjustNotional, applySlippage, approveUsdc, calculateAlignedTicks, calculateClosePositionParams, calculateEntryPrice, calculateLeverage, calculateLiquidationPrice, calculateLiquidityForTargetRatio, calculatePnlPercentage, calculatePositionSize, calculatePositionValue, closePosition, closePositionWithQuote, convertFundingDiffX96ToPercentPerPeriod, convertFundingPerSecondX96ToPercentPerDay, convertFundingPerSecondX96ToPercentPerMinute, createPerp, estimateLiquidity, getFundingRate, getIndexTWAP, getIndexValue, getPerpBeacon, getPerpBounds, getPerpFees, getPerpMark, getPerpTickSpacing, getPositionEffectiveMargin, getPositionFundingPayment, getPositionId, getPositionIsLiquidatable, getPositionIsLong, getPositionIsMaker, getPositionLiveDetails, getPositionLiveDetailsFromContract, getPositionPerpId, getPositionPnl, getRpcUrl, getUsdcAllowance, getUserOpenPositions, getUserUsdcBalance, getUserWalletAddress, marginRatioToLeverage, openMakerPosition, openTakerPosition, parseContractError, priceToSqrtPriceX96, priceToTick, quoteClosePosition, quoteOpenMakerPosition, quoteTakerPosition, scale6Decimals, scaleFrom6Decimals, scaleFromX96, scaleToX96, sqrtPriceX96ToPrice, tickToPrice, uint256ToInt256, withErrorHandling };