@strobelabs/perpcity-sdk 0.1.7 → 0.2.0

package/dist/index.d.ts

@@ -6,14 +6,106 @@ import { GraphQLClient } from 'graphql-request';
 interface PerpCityDeployments {
     perpManager: Address;
     usdc: Address;
-    goldskyPublic: string;
-    goldskyPrivate: string;
 }
 interface PerpCityContextConfig {
     walletClient: WalletClient;
     goldskyBearerToken?: string;
+    goldskyEndpoint: string;
+    deployments: PerpCityDeployments;
 }
 
+type OpenInterest = {
+    takerLongNotional: number;
+    takerShortNotional: number;
+};
+type TimeSeries<T extends number | OpenInterest> = {
+    timestamp: number;
+    value: T;
+};
+type Bounds = {
+    minMargin: number;
+    minTakerLeverage: number;
+    maxTakerLeverage: number;
+};
+type Fees = {
+    creatorFee: number;
+    insuranceFee: number;
+    lpFee: number;
+    liquidationFee: number;
+};
+type LiveDetails = {
+    pnl: number;
+    fundingPayment: number;
+    effectiveMargin: number;
+    isLiquidatable: boolean;
+};
+type ClosedPosition = {
+    perpId: Hex;
+    wasMaker: boolean;
+    wasLong: boolean;
+    pnlAtClose: number;
+};
+type ClosePositionParams = {
+    minAmt0Out: number;
+    minAmt1Out: number;
+    maxAmt1In: number;
+};
+type OpenTakerPositionParams = {
+    isLong: boolean;
+    margin: number;
+    leverage: number;
+    unspecifiedAmountLimit: number;
+};
+type OpenMakerPositionParams = {
+    margin: number;
+    priceLower: number;
+    priceUpper: number;
+    liquidity: bigint;
+    maxAmt0In: number;
+    maxAmt1In: number;
+};
+type CreatePerpParams = {
+    startingPrice: number;
+    beacon: Address;
+};
+type PerpData = {
+    id: Hex;
+    tickSpacing: number;
+    mark: number;
+    index: number;
+    beacon: Address;
+    lastIndexUpdate: number;
+    openInterest: OpenInterest;
+    markTimeSeries: TimeSeries<number>[];
+    indexTimeSeries: TimeSeries<number>[];
+    fundingRate: number;
+    bounds: Bounds;
+    fees: Fees;
+    openInterestTimeSeries: TimeSeries<OpenInterest>[];
+    fundingRateTimeSeries: TimeSeries<number>[];
+    totalOpenMakerPnl: number;
+    totalOpenTakerPnl: number;
+};
+type UserData = {
+    walletAddress: Hex;
+    usdcBalance: number;
+    openPositions: OpenPositionData[];
+    closedPositions: ClosedPosition[];
+    realizedPnl: number;
+    unrealizedPnl: number;
+};
+type OpenPositionData = {
+    perpId: Hex;
+    positionId: bigint;
+    isLong?: boolean;
+    isMaker?: boolean;
+    liveDetails: LiveDetails;
+};
+type CacheConfig = {
+    ttl: number;
+    maxSize: number;
+};
+
 declare class PerpCityContext {
     readonly walletClient: viem.Client<viem.Transport, viem.Chain | undefined, viem.Account | undefined, viem.WalletRpcSchema, {
         call: (parameters: viem.CallParameters<viem.Chain | undefined>) => Promise<viem.CallReturnType>;
@@ -38,15 +130,15 @@ declare class PerpCityContext {
             blobGasUsed: bigint;
             difficulty: bigint;
             excessBlobGas: bigint;
-            extraData: viem.Hex;
+            extraData: Hex;
             gasLimit: bigint;
             gasUsed: bigint;
-            miner: viem.Address;
+            miner: Address;
             mixHash: viem.Hash;
             parentBeaconBlockRoot?: `0x${string}` | undefined;
             parentHash: viem.Hash;
-            receiptsRoot: viem.Hex;
-            sealFields: viem.Hex[];
+            receiptsRoot: Hex;
+            sealFields: Hex[];
             sha3Uncles: viem.Hash;
             size: bigint;
             stateRoot: viem.Hash;
@@ -59,18 +151,18 @@ declare class PerpCityContext {
             transactions: includeTransactions extends true ? ({
                 type: "legacy";
                 chainId?: number | undefined;
-                r: viem.Hex;
-                s: viem.Hex;
+                r: Hex;
+                s: Hex;
                 v: bigint;
                 yParity?: undefined | undefined;
                 value: bigint;
-                from: viem.Address;
+                from: Address;
                 gas: bigint;
                 hash: viem.Hash;
-                input: viem.Hex;
+                input: Hex;
                 nonce: number;
-                to: viem.Address | null;
-                typeHex: viem.Hex | null;
+                to: Address | null;
+                typeHex: Hex | null;
                 accessList?: undefined | undefined;
                 authorizationList?: undefined | undefined;
                 blobVersionedHashes?: undefined | undefined;
@@ -84,18 +176,18 @@ declare class PerpCityContext {
             } | {
                 type: "eip2930";
                 chainId: number;
-                r: viem.Hex;
-                s: viem.Hex;
+                r: Hex;
+                s: Hex;
                 v: bigint;
                 yParity: number;
                 value: bigint;
-                from: viem.Address;
+                from: Address;
                 gas: bigint;
                 hash: viem.Hash;
-                input: viem.Hex;
+                input: Hex;
                 nonce: number;
-                to: viem.Address | null;
-                typeHex: viem.Hex | null;
+                to: Address | null;
+                typeHex: Hex | null;
                 accessList: viem.AccessList;
                 authorizationList?: undefined | undefined;
                 blobVersionedHashes?: undefined | undefined;
@@ -109,18 +201,18 @@ declare class PerpCityContext {
             } | {
                 type: "eip1559";
                 chainId: number;
-                r: viem.Hex;
-                s: viem.Hex;
+                r: Hex;
+                s: Hex;
                 v: bigint;
                 yParity: number;
                 value: bigint;
-                from: viem.Address;
+                from: Address;
                 gas: bigint;
                 hash: viem.Hash;
-                input: viem.Hex;
+                input: Hex;
                 nonce: number;
-                to: viem.Address | null;
-                typeHex: viem.Hex | null;
+                to: Address | null;
+                typeHex: Hex | null;
                 accessList: viem.AccessList;
                 authorizationList?: undefined | undefined;
                 blobVersionedHashes?: undefined | undefined;
@@ -134,21 +226,21 @@ declare class PerpCityContext {
             } | {
                 type: "eip4844";
                 chainId: number;
-                r: viem.Hex;
-                s: viem.Hex;
+                r: Hex;
+                s: Hex;
                 v: bigint;
                 yParity: number;
                 value: bigint;
-                from: viem.Address;
+                from: Address;
                 gas: bigint;
                 hash: viem.Hash;
-                input: viem.Hex;
+                input: Hex;
                 nonce: number;
-                to: viem.Address | null;
-                typeHex: viem.Hex | null;
+                to: Address | null;
+                typeHex: Hex | null;
                 accessList: viem.AccessList;
                 authorizationList?: undefined | undefined;
-                blobVersionedHashes: readonly viem.Hex[];
+                blobVersionedHashes: readonly Hex[];
                 gasPrice?: undefined | undefined;
                 maxFeePerBlobGas: bigint;
                 maxFeePerGas: bigint;
@@ -159,18 +251,18 @@ declare class PerpCityContext {
             } | {
                 type: "eip7702";
                 chainId: number;
-                r: viem.Hex;
-                s: viem.Hex;
+                r: Hex;
+                s: Hex;
                 v: bigint;
                 yParity: number;
                 value: bigint;
-                from: viem.Address;
+                from: Address;
                 gas: bigint;
                 hash: viem.Hash;
-                input: viem.Hex;
+                input: Hex;
                 nonce: number;
-                to: viem.Address | null;
-                typeHex: viem.Hex | null;
+                to: Address | null;
+                typeHex: Hex | null;
                 accessList: viem.AccessList;
                 authorizationList: viem.SignedAuthorizationList;
                 blobVersionedHashes?: undefined | undefined;
@@ -209,18 +301,18 @@ declare class PerpCityContext {
         getTransaction: <blockTag extends viem.BlockTag = "latest">(args: viem.GetTransactionParameters<blockTag>) => Promise<{
             type: "legacy";
             chainId?: number | undefined;
-            r: viem.Hex;
-            s: viem.Hex;
+            r: Hex;
+            s: Hex;
             v: bigint;
             yParity?: undefined | undefined;
             value: bigint;
-            from: viem.Address;
+            from: Address;
             gas: bigint;
             hash: viem.Hash;
-            input: viem.Hex;
+            input: Hex;
             nonce: number;
-            to: viem.Address | null;
-            typeHex: viem.Hex | null;
+            to: Address | null;
+            typeHex: Hex | null;
             accessList?: undefined | undefined;
             authorizationList?: undefined | undefined;
             blobVersionedHashes?: undefined | undefined;
@@ -234,18 +326,18 @@ declare class PerpCityContext {
         } | {
             type: "eip2930";
             chainId: number;
-            r: viem.Hex;
-            s: viem.Hex;
+            r: Hex;
+            s: Hex;
             v: bigint;
             yParity: number;
             value: bigint;
-            from: viem.Address;
+            from: Address;
             gas: bigint;
             hash: viem.Hash;
-            input: viem.Hex;
+            input: Hex;
             nonce: number;
-            to: viem.Address | null;
-            typeHex: viem.Hex | null;
+            to: Address | null;
+            typeHex: Hex | null;
             accessList: viem.AccessList;
             authorizationList?: undefined | undefined;
             blobVersionedHashes?: undefined | undefined;
@@ -259,18 +351,18 @@ declare class PerpCityContext {
         } | {
             type: "eip1559";
             chainId: number;
-            r: viem.Hex;
-            s: viem.Hex;
+            r: Hex;
+            s: Hex;
             v: bigint;
             yParity: number;
             value: bigint;
-            from: viem.Address;
+            from: Address;
             gas: bigint;
             hash: viem.Hash;
-            input: viem.Hex;
+            input: Hex;
             nonce: number;
-            to: viem.Address | null;
-            typeHex: viem.Hex | null;
+            to: Address | null;
+            typeHex: Hex | null;
             accessList: viem.AccessList;
             authorizationList?: undefined | undefined;
             blobVersionedHashes?: undefined | undefined;
@@ -284,21 +376,21 @@ declare class PerpCityContext {
         } | {
             type: "eip4844";
             chainId: number;
-            r: viem.Hex;
-            s: viem.Hex;
+            r: Hex;
+            s: Hex;
             v: bigint;
             yParity: number;
             value: bigint;
-            from: viem.Address;
+            from: Address;
             gas: bigint;
             hash: viem.Hash;
-            input: viem.Hex;
+            input: Hex;
             nonce: number;
-            to: viem.Address | null;
-            typeHex: viem.Hex | null;
+            to: Address | null;
+            typeHex: Hex | null;
             accessList: viem.AccessList;
             authorizationList?: undefined | undefined;
-            blobVersionedHashes: readonly viem.Hex[];
+            blobVersionedHashes: readonly Hex[];
             gasPrice?: undefined | undefined;
             maxFeePerBlobGas: bigint;
             maxFeePerGas: bigint;
@@ -309,18 +401,18 @@ declare class PerpCityContext {
         } | {
             type: "eip7702";
             chainId: number;
-            r: viem.Hex;
-            s: viem.Hex;
+            r: Hex;
+            s: Hex;
             v: bigint;
             yParity: number;
             value: bigint;
-            from: viem.Address;
+            from: Address;
             gas: bigint;
             hash: viem.Hash;
-            input: viem.Hex;
+            input: Hex;
             nonce: number;
-            to: viem.Address | null;
-            typeHex: viem.Hex | null;
+            to: Address | null;
+            typeHex: Hex | null;
             accessList: viem.AccessList;
             authorizationList: viem.SignedAuthorizationList;
             blobVersionedHashes?: undefined | undefined;
@@ -336,13 +428,13 @@ declare class PerpCityContext {
         getTransactionCount: (args: viem.GetTransactionCountParameters) => Promise<viem.GetTransactionCountReturnType>;
         getTransactionReceipt: (args: viem.GetTransactionReceiptParameters) => Promise<viem.TransactionReceipt>;
         multicall: <const contracts extends readonly unknown[], allowFailure extends boolean = true>(args: viem.MulticallParameters<contracts, allowFailure>) => Promise<viem.MulticallReturnType<contracts, allowFailure>>;
-        prepareTransactionRequest: <const request extends viem.PrepareTransactionRequestRequest<viem.Chain | undefined, chainOverride>, chainOverride extends viem.Chain | undefined = undefined, accountOverride extends viem.Account | viem.Address | undefined = undefined>(args: viem.PrepareTransactionRequestParameters<viem.Chain | undefined, viem.Account | undefined, chainOverride, accountOverride, request>) => Promise<viem.UnionRequiredBy<Extract<viem.UnionOmit<viem.ExtractChainFormatterParameters<viem.DeriveChain<viem.Chain | undefined, chainOverride>, "transactionRequest", viem.TransactionRequest>, "from"> & (viem.DeriveChain<viem.Chain | undefined, chainOverride> extends infer T_1 ? T_1 extends viem.DeriveChain<viem.Chain | undefined, chainOverride> ? T_1 extends viem.Chain ? {
+        prepareTransactionRequest: <const request extends viem.PrepareTransactionRequestRequest<viem.Chain | undefined, chainOverride>, chainOverride extends viem.Chain | undefined = undefined, accountOverride extends viem.Account | Address | undefined = undefined>(args: viem.PrepareTransactionRequestParameters<viem.Chain | undefined, viem.Account | undefined, chainOverride, accountOverride, request>) => Promise<viem.UnionRequiredBy<Extract<viem.UnionOmit<viem.ExtractChainFormatterParameters<viem.DeriveChain<viem.Chain | undefined, chainOverride>, "transactionRequest", viem.TransactionRequest>, "from"> & (viem.DeriveChain<viem.Chain | undefined, chainOverride> extends infer T_1 ? T_1 extends viem.DeriveChain<viem.Chain | undefined, chainOverride> ? T_1 extends viem.Chain ? {
             chain: T_1;
         } : {
             chain?: undefined;
         } : never : never) & (viem.DeriveAccount<viem.Account | undefined, accountOverride> extends infer T_2 ? T_2 extends viem.DeriveAccount<viem.Account | undefined, accountOverride> ? T_2 extends viem.Account ? {
             account: T_2;
-            from: viem.Address;
+            from: Address;
         } : {
             account?: undefined;
             from?: undefined;
@@ -3594,7 +3686,7 @@ declare class PerpCityContext {
         simulate: <const calls extends readonly unknown[]>(args: viem.SimulateBlocksParameters<calls>) => Promise<viem.SimulateBlocksReturnType<calls>>;
         simulateBlocks: <const calls extends readonly unknown[]>(args: viem.SimulateBlocksParameters<calls>) => Promise<viem.SimulateBlocksReturnType<calls>>;
         simulateCalls: <const calls extends readonly unknown[]>(args: viem.SimulateCallsParameters<calls>) => Promise<viem.SimulateCallsReturnType<calls>>;
-        simulateContract: <const abi extends viem.Abi | readonly unknown[], functionName extends viem.ContractFunctionName<abi, "nonpayable" | "payable">, const args_1 extends viem.ContractFunctionArgs<abi, "nonpayable" | "payable", functionName>, chainOverride extends viem.Chain | undefined, accountOverride extends viem.Account | viem.Address | undefined = undefined>(args: viem.SimulateContractParameters<abi, functionName, args_1, viem.Chain | undefined, chainOverride, accountOverride>) => Promise<viem.SimulateContractReturnType<abi, functionName, args_1, viem.Chain | undefined, viem.Account | undefined, chainOverride, accountOverride>>;
+        simulateContract: <const abi extends viem.Abi | readonly unknown[], functionName extends viem.ContractFunctionName<abi, "nonpayable" | "payable">, const args_1 extends viem.ContractFunctionArgs<abi, "nonpayable" | "payable", functionName>, chainOverride extends viem.Chain | undefined, accountOverride extends viem.Account | Address | undefined = undefined>(args: viem.SimulateContractParameters<abi, functionName, args_1, viem.Chain | undefined, chainOverride, accountOverride>) => Promise<viem.SimulateContractReturnType<abi, functionName, args_1, viem.Chain | undefined, viem.Account | undefined, chainOverride, accountOverride>>;
         verifyHash: (args: viem.VerifyHashActionParameters) => Promise<viem.VerifyHashActionReturnType>;
         verifyMessage: (args: viem.VerifyMessageActionParameters) => Promise<viem.VerifyMessageActionReturnType>;
         verifySiweMessage: (args: viem__types_actions_siwe_verifySiweMessage.VerifySiweMessageParameters) => Promise<viem__types_actions_siwe_verifySiweMessage.VerifySiweMessageReturnType>;
@@ -3608,126 +3700,33 @@ declare class PerpCityContext {
         watchPendingTransactions: (args: viem.WatchPendingTransactionsParameters<viem.Transport>) => viem.WatchPendingTransactionsReturnType;
     } & viem.WalletActions<viem.Chain | undefined, viem.Account | undefined>>;
     readonly goldskyClient: GraphQLClient;
+    private readonly _deployments;
     constructor(config: PerpCityContextConfig);
-    validateChainId(): number;
     deployments(): PerpCityDeployments;
-}
-
-type ClosePositionParams = {
-    minAmt0Out: number;
-    minAmt1Out: number;
-    maxAmt1In: number;
-};
-type LiveDetails = {
-    pnl: number;
-    fundingPayment: number;
-    effectiveMargin: number;
-    isLiquidatable: boolean;
-};
-declare class OpenPosition {
-    readonly context: PerpCityContext;
-    readonly perpId: Hex;
-    readonly positionId: bigint;
-    constructor(context: PerpCityContext, perpId: Hex, positionId: bigint);
-    closePosition(params: ClosePositionParams): Promise<OpenPosition | null>;
-    liveDetails(): Promise<LiveDetails>;
-}
-
-type OpenMakerPositionParams = {
-    margin: number;
-    priceLower: number;
-    priceUpper: number;
-    maxAmt0In: number;
-    maxAmt1In: number;
-};
-type OpenTakerPositionParams = {
-    isLong: boolean;
-    margin: number;
-    leverage: number;
-    unspecifiedAmountLimit: number;
-};
-type OpenInterest = {
-    takerLongNotional: number;
-    takerShortNotional: number;
-};
-type TimeSeries<T extends number | OpenInterest> = {
-    timestamp: number;
-    value: T;
-};
-type SimulateOpenPositionResults = {
-    success: boolean;
-    size: number;
-    notional: number;
-    creatorFeeAmt: number;
-    insuranceFeeAmt: number;
-    lpFeeAmt: number;
-};
-type Fees = {
-    creatorFee: number;
-    insuranceFee: number;
-    lpFee: number;
-    liquidationFee: number;
-};
-type Bounds = {
-    minMargin: number;
-    minTakerLeverage: number;
-    maxTakerLeverage: number;
-};
-declare class Perp {
-    readonly context: PerpCityContext;
-    readonly id: Hex;
-    constructor(context: PerpCityContext, id: Hex);
-    tickSpacing(): Promise<number>;
-    mark(): Promise<number>;
-    index(): Promise<number>;
-    beacon(): Promise<Address>;
-    lastIndexUpdate(): Promise<number>;
-    openInterest(): Promise<OpenInterest>;
-    markTimeSeries(): Promise<TimeSeries<number>[]>;
-    indexTimeSeries(): Promise<TimeSeries<number>[]>;
-    fundingRate(): Promise<number>;
-    bounds(): Promise<Bounds>;
-    maxTakerNotional(isLong: boolean): Promise<number>;
-    simulateTaker(params: OpenTakerPositionParams): Promise<SimulateOpenPositionResults>;
-    allMakerPositions(): Promise<OpenPosition[]>;
-    allTakerPositions(): Promise<OpenPosition[]>;
-    totalOpenMakerPnl(): Promise<number>;
-    totalOpenTakerPnl(): Promise<number>;
-    fees(): Promise<Fees>;
-    openInterestTimeSeries(): Promise<TimeSeries<OpenInterest>[]>;
-    fundingRateTimeSeries(): Promise<TimeSeries<number>[]>;
-    approveAndOpenMakerPosition(params: OpenMakerPositionParams): Promise<OpenPosition>;
-    approveAndOpenTakerPosition(params: OpenTakerPositionParams): Promise<OpenPosition>;
-    openMakerPosition(params: OpenMakerPositionParams): Promise<OpenPosition>;
-    openTakerPosition(params: OpenTakerPositionParams): Promise<OpenPosition>;
-}
-
-type CreatePerpParams = {
-    startingPrice: number;
-    beacon: Address;
-};
-declare class PerpManager {
-    readonly context: PerpCityContext;
-    constructor(context: PerpCityContext);
-    getPerps(): Promise<Perp[]>;
-    createPerp(params: CreatePerpParams): Promise<Perp>;
-}
-
-type ClosedPosition = {
-    perpId: Hex;
-    wasMaker: boolean;
-    wasLong: boolean;
-    pnlAtClose: number;
-};
-declare class User {
-    readonly context: PerpCityContext;
-    readonly walletAddress: Hex;
-    constructor(context: PerpCityContext);
-    usdcBalance(): Promise<number>;
-    openPositions(): Promise<OpenPosition[]>;
-    closedPositions(): Promise<ClosedPosition[]>;
-    realizedPnl(): Promise<number>;
-    unrealizedPnl(): Promise<number>;
+    private fetchPerpData;
+    private fetchPerpContractData;
+    /**
+     * Fetch comprehensive perp data with all related information in a single batched request
+     */
+    getPerpData(perpId: Hex): Promise<PerpData>;
+    /**
+     * Fetch data for multiple perps efficiently with true batching
+     * This fetches all perps in just 2 Goldsky requests total (not 2N!)
+     */
+    getMultiplePerpData(perpIds: Hex[]): Promise<Map<Hex, PerpData>>;
+    private fetchMultiplePerpContractData;
+    private fetchUserData;
+    private fetchUserOpenPositions;
+    private fetchUserClosedPositions;
+    private fetchPositionLiveDetailsFromContract;
+    /**
+     * Fetch comprehensive user data with all positions in a single batched request
+     */
+    getUserData(userAddress: Hex): Promise<UserData>;
+    /**
+     * Fetch open position data with live details
+     */
+    getOpenPositionData(perpId: Hex, positionId: bigint): Promise<OpenPositionData>;
 }
 
 declare function priceToSqrtPriceX96(price: number): bigint;
@@ -3747,9 +3746,59 @@ declare const Q96: bigint;
 
 declare function estimateLiquidity(context: PerpCityContext, tickLower: number, tickUpper: number, usdScaled: bigint): Promise<bigint>;
 
-declare const DEPLOYMENTS: {
-    [chainId: number]: PerpCityDeployments;
-};
+/**
+ * Base class for all PerpCity SDK errors
+ */
+declare class PerpCityError extends Error {
+    readonly cause?: Error | undefined;
+    constructor(message: string, cause?: Error | undefined);
+}
+/**
+ * Error thrown when a contract call reverts
+ */
+declare class ContractError extends PerpCityError {
+    readonly errorName?: string | undefined;
+    readonly args?: readonly unknown[] | undefined;
+    constructor(message: string, errorName?: string | undefined, args?: readonly unknown[] | undefined, cause?: Error);
+}
+/**
+ * Error thrown when a transaction is rejected by the user
+ */
+declare class TransactionRejectedError extends PerpCityError {
+    constructor(message?: string, cause?: Error);
+}
+/**
+ * Error thrown when there are insufficient funds
+ */
+declare class InsufficientFundsError extends PerpCityError {
+    constructor(message?: string, cause?: Error);
+}
+/**
+ * Error thrown when a GraphQL query fails
+ */
+declare class GraphQLError extends PerpCityError {
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Error thrown when an RPC call fails
+ */
+declare class RPCError extends PerpCityError {
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Error thrown when validation fails
+ */
+declare class ValidationError extends PerpCityError {
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Parse and format a contract error into a user-friendly message
+ */
+declare function parseContractError(error: unknown): PerpCityError;
+/**
+ * Wrap an async function with error handling
+ */
+declare function withErrorHandling<T>(fn: () => Promise<T>, context: string): Promise<T>;
 
 declare const PERP_MANAGER_ABI: readonly [{
     readonly inputs: readonly [{
@@ -4963,4 +5012,57 @@ declare const BEACON_ABI: readonly [{
     readonly type: "function";
 }];
 
-export { BEACON_ABI, BIGINT_1E6, type Bounds, type ClosePositionParams, type ClosedPosition, type CreatePerpParams, DEPLOYMENTS, type Fees, type LiveDetails, NUMBER_1E6, type OpenInterest, type OpenMakerPositionParams, OpenPosition, type OpenTakerPositionParams, PERP_MANAGER_ABI, Perp, PerpCityContext, type PerpCityContextConfig, type PerpCityDeployments, PerpManager, Q96, type SimulateOpenPositionResults, type TimeSeries, User, approveUsdc, estimateLiquidity, marginRatioToLeverage, priceToSqrtPriceX96, priceToTick, scale6Decimals, scaleFrom6Decimals, scaleFromX96, scaleToX96, sqrtPriceX96ToPrice };
+declare class OpenPosition {
+    readonly context: PerpCityContext;
+    readonly perpId: Hex;
+    readonly positionId: bigint;
+    readonly isLong?: boolean;
+    readonly isMaker?: boolean;
+    constructor(context: PerpCityContext, perpId: Hex, positionId: bigint, isLong?: boolean, isMaker?: boolean);
+    closePosition(params: ClosePositionParams): Promise<OpenPosition | null>;
+    liveDetails(): Promise<LiveDetails>;
+}
+
+declare function getPerpMark(perpData: PerpData): number;
+declare function getPerpIndex(perpData: PerpData): number;
+declare function getPerpBeacon(perpData: PerpData): string;
+declare function getPerpLastIndexUpdate(perpData: PerpData): number;
+declare function getPerpOpenInterest(perpData: PerpData): OpenInterest;
+declare function getPerpMarkTimeSeries(perpData: PerpData): TimeSeries<number>[];
+declare function getPerpIndexTimeSeries(perpData: PerpData): TimeSeries<number>[];
+declare function getPerpFundingRate(perpData: PerpData): number;
+declare function getPerpBounds(perpData: PerpData): Bounds;
+declare function getPerpFees(perpData: PerpData): Fees;
+declare function getPerpOpenInterestTimeSeries(perpData: PerpData): TimeSeries<OpenInterest>[];
+declare function getPerpFundingRateTimeSeries(perpData: PerpData): TimeSeries<number>[];
+declare function getPerpTickSpacing(perpData: PerpData): number;
+declare function getAllMakerPositions(context: PerpCityContext, perpId: Hex): Promise<OpenPosition[]>;
+declare function getAllTakerPositions(context: PerpCityContext, perpId: Hex): Promise<OpenPosition[]>;
+declare function getTotalOpenMakerPnl(context: PerpCityContext, perpId: Hex): Promise<number>;
+declare function getTotalOpenTakerPnl(context: PerpCityContext, perpId: Hex): Promise<number>;
+
+declare function getPerps(context: PerpCityContext): Promise<Hex[]>;
+declare function createPerp(context: PerpCityContext, params: CreatePerpParams): Promise<Hex>;
+declare function openTakerPosition(context: PerpCityContext, perpId: Hex, params: OpenTakerPositionParams): Promise<OpenPosition>;
+declare function openMakerPosition(context: PerpCityContext, perpId: Hex, params: OpenMakerPositionParams): Promise<OpenPosition>;
+
+declare function getUserUsdcBalance(userData: UserData): number;
+declare function getUserOpenPositions(userData: UserData): OpenPositionData[];
+declare function getUserClosedPositions(userData: UserData): ClosedPosition[];
+declare function getUserRealizedPnl(userData: UserData): number;
+declare function getUserUnrealizedPnl(userData: UserData): number;
+declare function getUserWalletAddress(userData: UserData): Hex;
+
+declare function getPositionPerpId(positionData: OpenPositionData): Hex;
+declare function getPositionId(positionData: OpenPositionData): bigint;
+declare function getPositionIsLong(positionData: OpenPositionData): boolean | undefined;
+declare function getPositionIsMaker(positionData: OpenPositionData): boolean | undefined;
+declare function getPositionLiveDetails(positionData: OpenPositionData): LiveDetails;
+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 closePosition(context: PerpCityContext, perpId: Hex, positionId: bigint, params: ClosePositionParams): Promise<OpenPositionData | null>;
+declare function getPositionLiveDetailsFromContract(context: PerpCityContext, perpId: Hex, positionId: bigint): Promise<LiveDetails>;
+
+export { BEACON_ABI, BIGINT_1E6, type Bounds, type CacheConfig, type ClosePositionParams, type ClosedPosition, ContractError, type CreatePerpParams, type Fees, GraphQLError, InsufficientFundsError, type LiveDetails, NUMBER_1E6, type OpenInterest, type OpenMakerPositionParams, OpenPosition, type OpenPositionData, type OpenTakerPositionParams, PERP_MANAGER_ABI, PerpCityContext, type PerpCityContextConfig, type PerpCityDeployments, PerpCityError, type PerpData, Q96, RPCError, type TimeSeries, TransactionRejectedError, type UserData, ValidationError, approveUsdc, closePosition, createPerp, estimateLiquidity, getAllMakerPositions, getAllTakerPositions, getPerpBeacon, getPerpBounds, getPerpFees, getPerpFundingRate, getPerpFundingRateTimeSeries, getPerpIndex, getPerpIndexTimeSeries, getPerpLastIndexUpdate, getPerpMark, getPerpMarkTimeSeries, getPerpOpenInterest, getPerpOpenInterestTimeSeries, getPerpTickSpacing, getPerps, getPositionEffectiveMargin, getPositionFundingPayment, getPositionId, getPositionIsLiquidatable, getPositionIsLong, getPositionIsMaker, getPositionLiveDetails, getPositionLiveDetailsFromContract, getPositionPerpId, getPositionPnl, getTotalOpenMakerPnl, getTotalOpenTakerPnl, getUserClosedPositions, getUserOpenPositions, getUserRealizedPnl, getUserUnrealizedPnl, getUserUsdcBalance, getUserWalletAddress, marginRatioToLeverage, openMakerPosition, openTakerPosition, parseContractError, priceToSqrtPriceX96, priceToTick, scale6Decimals, scaleFrom6Decimals, scaleFromX96, scaleToX96, sqrtPriceX96ToPrice, withErrorHandling };