@lifi/perps-sdk 0.2.0-alpha.0 → 1.0.0

package/dist/types/signers/lighter/LighterReadOnlyTokenManager.d.ts

@@ -1,174 +0,0 @@
-import type { Address, ApproveReadOnlyTokenParams, LighterAccountConfig } from '@lifi/perps-types';
-import type { Account, WalletClient } from 'viem';
-import type { StorageAdapter } from '../../agent/types.js';
-/**
- * Default Lighter HTTP host the SDK posts the mint request to. Callers
- * pointing at testnet pass an override via {@link LighterReadOnlyTokenManagerOptions.lighterApiUrl}.
- */
-export declare const DEFAULT_LIGHTER_API_URL = "https://mainnet.zklighter.elliot.ai";
-/**
- * Default token name persisted alongside Lighter's `tokens/create` row.
- * Lighter requires a non-empty `name` form field; the literal here is what
- * surfaces in Lighter's UI listing under `app.lighter.xyz/read-only-tokens`.
- */
-export declare const DEFAULT_READ_ONLY_TOKEN_NAME = "LI.FI Perps";
-/**
- * Persisted shape of a Lighter read-only token. The `token` string is
- * Lighter's opaque `ro:{accountIndex}:{scope}:{expiry}:{rand}` bearer; the
- * SDK never parses it — `expiry`/`scope`/`accountIndex` are mint-time inputs
- * we keep alongside so consumers can render expiry UX without re-fetching.
- */
-export interface LighterReadOnlyToken {
-    /** Opaque bearer string — never parse client-side. */
-    token: string;
-    /** Unix seconds. The SDK's source of truth for expiry. */
-    expiry: number;
-    /** Lighter's `single | all` scope literal recorded at mint time. */
-    scope: 'single' | 'all';
-    /** Lighter L2 account index the token authorises. */
-    accountIndex: number;
-}
-/**
- * Lighter `POST /api/v1/tokens/create` response shape (subset). Lighter's
- * OpenAPI documents additional fields (`token_id`, `name`, `revoked`, etc.)
- * we don't need client-side.
- */
-export interface LighterCreateTokenResponse {
-    api_token: string;
-    account_index: number;
-    expiry: number;
-    scopes: string;
-}
-/**
- * Function injected for the HTTP boundary against Lighter's `tokens/create`
- * endpoint. Returning a parsed {@link LighterCreateTokenResponse} keeps the
- * mint code free of fetch/multipart plumbing and lets tests drop a fixture
- * in without spinning a mock server.
- */
-export type LighterTokenFetcher = (params: {
-    url: string;
-    authorization: string;
-    name: string;
-    accountIndex: number;
-    expiry: number;
-    subAccountAccess: boolean;
-    scopes: string;
-}) => Promise<LighterCreateTokenResponse>;
-/**
- * Function injected for the L1 wallet signature. Signature MUST be EIP-191
- * `personal_sign`. Returning a 0x-prefixed hex string keeps the mint path
- * agnostic to whichever wallet abstraction the consumer wires up.
- */
-export type LighterWalletSigner = (params: {
-    address: Address;
-    message: string;
-}) => Promise<string>;
-export interface LighterReadOnlyTokenManagerOptions {
-    storage?: StorageAdapter;
-    /** Lighter API host. Defaults to {@link DEFAULT_LIGHTER_API_URL}. */
-    lighterApiUrl?: string;
-    /** Override the multipart POST. Defaults to a `fetch`-based implementation. */
-    fetcher?: LighterTokenFetcher;
-    /** Clock injection for testing expiry logic. Defaults to `Date.now`. */
-    now?: () => number;
-}
-export interface ApproveReadOnlyTokenInputs extends ApproveReadOnlyTokenParams {
-    /** L1 wallet address that signs the mint message. */
-    address: Address;
-}
-export interface ApproveReadOnlyTokenResult {
-    token: LighterReadOnlyToken;
-    /** Projection of the post-mint Lighter account state. */
-    config: Pick<LighterAccountConfig, 'provider' | 'accountIndex' | 'readOnlyTokenApproved' | 'readOnlyTokenExpiry' | 'readOnlyTokenScope'>;
-}
-/**
- * Manage the per-account Lighter read-only token alongside the existing
- * `(L1 address, account index)`-scoped storage adapter pattern. Mirrors
- * `AgentManager`'s injection surface so the same `StorageAdapter` powers
- * both. The token is opaque — never parsed client-side; `expiry`/`scope`
- * recorded at mint time are the source of truth.
- *
- * The L1 wallet signer and the HTTP fetcher are both injectable so unit
- * tests don't need a real wallet or network.
- */
-export declare class LighterReadOnlyTokenManager {
-    private readonly storage;
-    private readonly lighterApiUrl;
-    private readonly fetcher;
-    private readonly now;
-    private readonly cache;
-    constructor(options?: LighterReadOnlyTokenManagerOptions);
-    private storageKey;
-    private isExpired;
-    /**
-     * Return the stored token for the `(address, accountIndex)` pair, or
-     * `undefined` if absent or past its `expiry`. Never surfaces an expired
-     * token — consumers can rely on the return value being usable as-is.
-     */
-    get(address: Address, accountIndex: number): Promise<LighterReadOnlyToken | undefined>;
-    /**
-     * `true` when a stored token exists AND its `expiry` falls within
-     * `thresholdDays` of now. `false` when no token exists, when the token is
-     * already expired (caller should treat that as "no token"), or when it
-     * has more than `thresholdDays` of life left.
-     */
-    isReadOnlyTokenExpiringSoon(address: Address, accountIndex: number, thresholdDays?: number): Promise<boolean>;
-    /**
-     * Persist `token` for the `(address, accountIndex)` pair. Overwrites any
-     * prior stored token under the same key — used both by the approve flow
-     * and by the renewal flow.
-     */
-    set(address: Address, accountIndex: number, token: LighterReadOnlyToken): Promise<void>;
-    remove(address: Address, accountIndex: number): Promise<void>;
-    /**
-     * Mint and persist a new Lighter read-only token.
-     *
-     * Asks `signer` to produce an EIP-191 `personal_sign` over the
-     * `createToken`-specific L1 message, POSTs the signed payload to Lighter's
-     * `/api/v1/tokens/create` via the injected `fetcher`, and persists the
-     * returned bearer alongside its `expiry`/`scope`/`accountIndex`.
-     *
-     * `expirySeconds` is the absolute unix-seconds expiry Lighter records on
-     * the row. Lighter enforces 1 day ≤ lifetime ≤ 10 years server-side; the
-     * SDK does NOT pre-validate and surfaces Lighter's 400 verbatim.
-     *
-     * `scope` defaults to `'all'` (token authorises read access to every
-     * account owned by the L1 signer). `'single'` is wired through so callers
-     * who need per-account scoping can opt in.
-     *
-     * @param signer EIP-191 wallet signer for the L1 message.
-     * @param inputs Token-mint parameters plus the L1 `address` that signs.
-     */
-    approve(signer: LighterWalletSigner, inputs: ApproveReadOnlyTokenInputs): Promise<ApproveReadOnlyTokenResult>;
-}
-/**
- * Build the EIP-191 message the user's L1 wallet signs to authorise a
- * Lighter `tokens/create` request.
- *
- * NOTE — Lighter's public docs do not fully specify the message template
- * for the read-only token mint flow. The shape here is the SDK's best-fit
- * given (a) Lighter's UI hosts the equivalent flow at
- * `app.lighter.xyz/read-only-tokens` and (b) Lighter's `tokens/create`
- * endpoint reads `account_index`, `expiry`, and `scopes` as form fields.
- * If Lighter publishes a documented template that diverges, update this
- * builder — the test fixtures will fail loudly.
- */
-export declare function buildReadOnlyTokenMessage(params: {
-    accountIndex: number;
-    expirySeconds: number;
-    scope: 'single' | 'all';
-}): string;
-/**
- * Default fetcher: posts a multipart/form-data request to Lighter's
- * `tokens/create` endpoint and returns the parsed response. Throws a
- * {@link PerpsError} with the Lighter-side body when the response is
- * non-2xx.
- */
-export declare const defaultLighterTokenFetcher: LighterTokenFetcher;
-/**
- * Adapter producing a {@link LighterWalletSigner} from a viem
- * `WalletClient`. Pulled out so `PerpsClient.approveReadOnlyToken` can call
- * into the manager without leaking viem types past the manager's boundary.
- */
-export declare function walletClientSigner(client: WalletClient<any, any, Account>): LighterWalletSigner;
-//# sourceMappingURL=LighterReadOnlyTokenManager.d.ts.map

package/dist/types/signers/lighter/LighterReadOnlyTokenManager.d.ts.map

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

package/dist/types/signers/lighter/LighterSigner.d.ts

@@ -1,88 +0,0 @@
-import { ActionType } from '@lifi/perps-types';
-import { type LoadLighterWasmOptions } from './wasmLoader.js';
-export interface LighterSignerContext {
-    /** Lighter-native private key (from GenerateAPIKey, NOT an Ethereum key). */
-    apiKeyPrivateKey: string;
-    /** API key slot registered on-chain (0-255). */
-    apiKeyIndex: number;
-    /** Lighter account index — looked up from the user's L1 Ethereum address. */
-    accountIndex: number;
-}
-export interface LighterSignerConfig extends LoadLighterWasmOptions {
-    /** Lighter REST API base URL. */
-    apiUrl?: string;
-    /** Lighter chain ID (304 = mainnet). */
-    chainId?: number;
-}
-export interface LighterSignedBlob {
-    txType: number;
-    txInfo: string;
-    txHash: string;
-}
-export interface ChangePubKeyResult extends LighterSignedBlob {
-    /** EIP-191 message the L1 Ethereum wallet must sign to authorize the key rotation. */
-    messageToSign: string;
-}
-export interface ApiKeyPair {
-    publicKey: string;
-    privateKey: string;
-}
-export declare class LighterSigner {
-    private readonly apiUrl;
-    private readonly chainId;
-    private readonly loaderOptions;
-    private wasm;
-    private readonly registeredClients;
-    constructor(config?: LighterSignerConfig);
-    initialize(): Promise<void>;
-    /**
-     * Generate a fresh Lighter API keypair. Pass an optional 32-byte hex seed
-     * for deterministic generation (used in tests); omit for a random key.
-     */
-    generateAPIKey(seed?: string): Promise<ApiKeyPair>;
-    /**
-     * Sign an action blob with the provided (apiKeyPrivateKey, apiKeyIndex,
-     * accountIndex) context. `wasmSignParams` comes straight from the backend's
-     * `WasmBlobActionStep`. Returns the signed `{ txType, txInfo, txHash }`
-     * triple the backend forwards to Lighter's `sendTx` endpoint.
-     *
-     * For REGISTER_API_KEY use `signChangePubKey` instead — it returns an
-     * additional `messageToSign` the L1 wallet must countersign.
-     */
-    sign(action: ActionType, wasmSignParams: Record<string, unknown>, context: LighterSignerContext): Promise<LighterSignedBlob>;
-    /**
-     * Step 1 of the REGISTER_API_KEY flow. Generates the WASM blob for a
-     * ChangePubKey tx with `L1Sig` left empty, plus the canonical EIP-191
-     * message the L1 Ethereum wallet must sign next.
-     *
-     * Requires the freshly-generated `privateKey` (returned by
-     * {@link generateAPIKey}) — the Go WASM signer registers a per-slot client
-     * keyed on `(apiKeyIndex, accountIndex)` before it'll sign anything for
-     * that slot, including the ChangePubKey that's about to register the key
-     * on-chain. This is purely client-side bookkeeping; it does not touch the
-     * Lighter API.
-     */
-    signChangePubKey(pubKeyHex: string, privateKey: string, nonce: number, apiKeyIndex: number, accountIndex: number): Promise<ChangePubKeyResult>;
-    /**
-     * Step 2 of REGISTER_API_KEY — inject the L1 signature produced by the
-     * user's Ethereum wallet into the ChangePubKey txInfo JSON. `L1Sig` is the
-     * only field in txInfo that depends on the L1 signature; txHash does NOT
-     * include it (so we do not recompute it).
-     */
-    embedL1Signature(txInfo: string, l1Signature: string): string;
-    /**
-     * Create an auth token for authenticated WebSocket subscriptions.
-     * `deadline` is a Unix timestamp in seconds — tokens have an 8h hard cap.
-     */
-    createAuthToken(deadline: number, context: LighterSignerContext): Promise<string>;
-    private ensureLoaded;
-    private ensureClient;
-    /**
-     * Map an ActionType + backend-provided params object to the positional-arg
-     * WASM call. The Go signer exports take primitives in order, not an object
-     * — so we pick fields in the exact order the Go side expects. Unknown
-     * fields (e.g. backend's integrator_* hints) are ignored.
-     */
-    private dispatch;
-}
-//# sourceMappingURL=LighterSigner.d.ts.map

package/dist/types/signers/lighter/LighterSigner.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"LighterSigner.d.ts","sourceRoot":"","sources":["../../../../src/signers/lighter/LighterSigner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAEL,KAAK,sBAAsB,EAG5B,MAAM,iBAAiB,CAAA;AAWxB,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,gBAAgB,EAAE,MAAM,CAAA;IACxB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAA;IACnB,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,mBAAoB,SAAQ,sBAAsB;IACjE,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,sFAAsF;IACtF,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CACnB;AAKD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwB;IACtD,OAAO,CAAC,IAAI,CAAgC;IAC5C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;gBAE1C,MAAM,GAAE,mBAAwB;IAUtC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC;;;OAGG;IACG,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAYxD;;;;;;;;OAQG;IACG,IAAI,CACR,MAAM,EAAE,UAAU,EAClB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,iBAAiB,CAAC;IAa7B;;;;;;;;;;;OAWG;IACG,gBAAgB,CACpB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,kBAAkB,CAAC;IAqC9B;;;;;OAKG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAa7D;;;OAGG;IACG,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC;YAiBJ,YAAY;YAOZ,YAAY;IAmB1B;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;CAsGjB"}

package/dist/types/signers/lighter/index.d.ts

@@ -1,9 +0,0 @@
-export type { LighterApiKey } from './LighterKeyStore.js';
-export { DEFAULT_API_KEY_INDEX, LIGHTER_PROVIDER_KEY, LighterKeyStore, } from './LighterKeyStore.js';
-export type { ApproveReadOnlyTokenInputs, ApproveReadOnlyTokenResult, LighterCreateTokenResponse, LighterReadOnlyToken, LighterReadOnlyTokenManagerOptions, LighterTokenFetcher, LighterWalletSigner, } from './LighterReadOnlyTokenManager.js';
-export { buildReadOnlyTokenMessage, DEFAULT_LIGHTER_API_URL, DEFAULT_READ_ONLY_TOKEN_NAME, defaultLighterTokenFetcher, LighterReadOnlyTokenManager, walletClientSigner, } from './LighterReadOnlyTokenManager.js';
-export type { ApiKeyPair, ChangePubKeyResult, LighterSignedBlob, LighterSignerConfig, LighterSignerContext, } from './LighterSigner.js';
-export { LighterSigner } from './LighterSigner.js';
-export type { LighterWasmExports, LoadLighterWasmOptions, } from './wasmLoader.js';
-export { loadLighterWasm, resetLighterWasmCache } from './wasmLoader.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/types/signers/lighter/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/signers/lighter/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,GAChB,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EACV,0BAA0B,EAC1B,0BAA0B,EAC1B,0BAA0B,EAC1B,oBAAoB,EACpB,kCAAkC,EAClC,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,kCAAkC,CAAA;AACzC,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,4BAA4B,EAC5B,0BAA0B,EAC1B,2BAA2B,EAC3B,kBAAkB,GACnB,MAAM,kCAAkC,CAAA;AACzC,YAAY,EACV,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,YAAY,EACV,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/types/signers/lighter/wasmLoader.d.ts

@@ -1,71 +0,0 @@
-export interface LoadLighterWasmOptions {
-    /** Override URL for the `.wasm` binary (browser: fetch; Node: fs). */
-    wasmBinaryUrl?: string | URL;
-    /** Override URL for Go's `wasm_exec.js` runtime. */
-    wasmExecJsUrl?: string | URL;
-    /**
-     * Pre-fetched source of Go's `wasm_exec.js`. Preferred over
-     * `wasmExecJsUrl` for bundlers (Vite/webpack) that may transform a `.js`
-     * URL on serve, breaking the IIFE that installs `globalThis.Go`. Pass via
-     * a `?raw` import (Vite) or equivalent so the original source survives
-     * intact.
-     */
-    wasmExecJsSource?: string;
-}
-export interface LighterWasmExports {
-    GenerateAPIKey: (seed?: string) => {
-        publicKey?: string;
-        privateKey?: string;
-        error?: string;
-    };
-    CreateClient: (url: string, privateKey: string, chainId: number, apiKeyIndex: number, accountIndex: number) => {
-        error?: string;
-    };
-    CheckClient: (apiKeyIndex: number, accountIndex: number) => {
-        error?: string;
-    };
-    /**
-     * Returns `{authToken}` on success — note the field name is `authToken`,
-     * NOT `token`. Reading the wrong field silently fails (Go sets nothing
-     * else on the result), which is why early code paths returned undefined
-     * tokens with no error.
-     */
-    CreateAuthToken: (deadline: number, apiKeyIndex: number, accountIndex: number) => {
-        authToken?: string;
-        error?: string;
-    };
-    /**
-     * Signature mirrors lighter-python's `signer.SignChangePubKey(...)` call —
-     * 5 positional args including `skipNonce` (use 0 to embed our supplied
-     * nonce; 1 to leave it out for server-fill scenarios). Earlier versions
-     * here had only 4 args, which silently shifted all arguments by one and
-     * produced txInfo with garbage AccountIndex / ApiKeyIndex fields →
-     * Lighter rejected with code 20001 "invalid param".
-     */
-    SignChangePubKey: (pubKeyHex: string, skipNonce: number, nonce: number, apiKeyIndex: number, accountIndex: number) => SignResult & {
-        messageToSign?: string;
-    };
-    SignCreateOrder: (...args: unknown[]) => SignResult;
-    SignCancelOrder: (...args: unknown[]) => SignResult;
-    SignCancelAllOrders: (...args: unknown[]) => SignResult;
-    SignTransfer: (...args: unknown[]) => SignResult;
-    SignWithdraw: (...args: unknown[]) => SignResult;
-    SignUpdateLeverage: (...args: unknown[]) => SignResult;
-    SignModifyOrder: (...args: unknown[]) => SignResult;
-    SignUpdateMargin: (...args: unknown[]) => SignResult;
-}
-export interface SignResult {
-    txType?: number;
-    txInfo?: string;
-    txHash?: string;
-    error?: string;
-}
-/**
- * Load the Lighter WASM signer. Memoized per-process: subsequent calls return
- * the cached exports. The Go runtime keeps a long-running goroutine to service
- * JS calls — we start it once and never stop it.
- */
-export declare function loadLighterWasm(options?: LoadLighterWasmOptions): Promise<LighterWasmExports>;
-/** Testing helper — drop the cached WASM instance so the next load reinitializes. */
-export declare function resetLighterWasmCache(): void;
-//# sourceMappingURL=wasmLoader.d.ts.map

package/dist/types/signers/lighter/wasmLoader.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"wasmLoader.d.ts","sourceRoot":"","sources":["../../../../src/signers/lighter/wasmLoader.ts"],"names":[],"mappings":"AAwDA,MAAM,WAAW,sBAAsB;IACrC,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;IAC5B,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;IAC5B;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK;QACjC,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;IACD,YAAY,EAAE,CACZ,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,KACjB;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACvB,WAAW,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9E;;;;;OAKG;IACH,eAAe,EAAE,CACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,KACjB;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3C;;;;;;;OAOG;IACH,gBAAgB,EAAE,CAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,KACjB,UAAU,GAAG;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5C,eAAe,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,UAAU,CAAA;IACnD,eAAe,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,UAAU,CAAA;IACnD,mBAAmB,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,UAAU,CAAA;IACvD,YAAY,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,UAAU,CAAA;IAChD,YAAY,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,UAAU,CAAA;IAChD,kBAAkB,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,UAAU,CAAA;IACtD,eAAe,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,UAAU,CAAA;IACnD,gBAAgB,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,UAAU,CAAA;CACrD;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAsFD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,kBAAkB,CAAC,CAK7B;AA+DD,qFAAqF;AACrF,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/types/utils/hyperliquid/index.d.ts

@@ -1,3 +0,0 @@
-export { calculateLiquidationPrice, calculateMaintenanceMarginRate, } from './liquidation.js';
-export { formatOrderPrice, formatOrderSize, getMaxPriceDecimals, } from './orderFormatting.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/types/utils/hyperliquid/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/hyperliquid/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,mBAAmB,GACpB,MAAM,sBAAsB,CAAA"}

package/dist/types/utils/hyperliquid/liquidation.d.ts

@@ -1,46 +0,0 @@
-/**
- * Hyperliquid-specific liquidation price calculation.
- *
- * Uses the exact formula from Hyperliquid docs:
- * https://hyperliquid.gitbook.io/hyperliquid-docs/trading/liquidations
- *
- * liq_price = price - side * margin_available / position_size / (1 - l * side)
- *
- * Where:
- * - l = 1 / (2 * maxLeverage) (maintenance margin fraction)
- * - side = 1 (long) or -1 (short)
- * - margin_available = isolated_margin - maintenance_margin_required
- */
-/**
- * Calculate the maintenance margin fraction for a Hyperliquid asset.
- *
- * Maintenance margin is half of the initial margin at max leverage.
- *
- * @param maxLeverage - Maximum leverage for the asset (e.g., 50 for BTC)
- * @returns Maintenance margin fraction (e.g., 0.01 for 50x max leverage),
- *   or undefined if maxLeverage is zero
- */
-export declare function calculateMaintenanceMarginRate(maxLeverage: number): number | undefined;
-/**
- * Calculate liquidation price using the exact Hyperliquid formula.
- *
- * For isolated margin, new position prediction. For existing positions,
- * prefer Position.liquidationPrice from the API.
- *
- * Formula derivation (isolated margin, single position):
- *   margin_per_unit        = entryPrice / leverage
- *   maintenance_per_unit   = entryPrice * mmr
- *   margin_available       = margin_per_unit - maintenance_per_unit
- *   liq_price              = entryPrice - side * margin_available / (1 - mmr * side)
- *
- * Where mmr = 1 / (2 * maxLeverage).
- *
- * @param entryPrice - Position entry price
- * @param leverage - User-selected leverage (e.g., 10)
- * @param isLong - True if long position, false if short
- * @param maxLeverage - Asset's maximum leverage (e.g., 50 for BTC). Determines
- *   the maintenance margin rate: mmr = 1 / (2 * maxLeverage)
- * @returns Estimated liquidation price, or undefined if inputs are invalid
- */
-export declare function calculateLiquidationPrice(entryPrice: number, leverage: number, isLong: boolean, maxLeverage: number): number | undefined;
-//# sourceMappingURL=liquidation.d.ts.map

package/dist/types/utils/hyperliquid/liquidation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"liquidation.d.ts","sourceRoot":"","sources":["../../../../src/utils/hyperliquid/liquidation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,SAAS,CAKpB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,EACf,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,SAAS,CAYpB"}

package/dist/types/utils/hyperliquid/orderFormatting.d.ts

@@ -1,44 +0,0 @@
-/**
- * Hyperliquid order size and price formatting for exchange submission.
- *
- * These encode Hyperliquid-specific order submission rules. Getting size/price
- * formatting wrong causes rejected orders.
- *
- * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/tick-and-lot-size
- */
-/**
- * Derive the maximum number of price decimal places for a given asset.
- *
- * @param szDecimals - The asset's szDecimals (from market meta)
- * @param market - Optional market type (e.g. 'spot'). Defaults to perps rules.
- * @returns Maximum allowed price decimals
- */
-export declare function getMaxPriceDecimals(szDecimals: number, market?: string): number;
-/**
- * Format a size value for order submission.
- *
- * Per Hyperliquid docs (tick-and-lot-size):
- * - Size must be rounded to the asset's szDecimals
- * - Trailing zeroes must be removed for signing
- *
- * @param size - The size value to format
- * @param szDecimals - Number of decimal places allowed for this asset (from meta)
- * @returns Size as a string with correct precision, no trailing zeros
- */
-export declare function formatOrderSize(size: number, szDecimals: number): string;
-/**
- * Format a price value for order submission.
- *
- * Per Hyperliquid docs (tick-and-lot-size):
- * - Maximum 5 significant figures
- * - Max decimals = MAX_DECIMALS - szDecimals (6 for perps, 8 for spot)
- * - Integer prices always allowed regardless of significant figures
- * - Trailing zeroes must be removed for signing
- *
- * @param price - The price value to format
- * @param szDecimals - The asset's szDecimals (affects max price decimals)
- * @param market - Optional market type (e.g. 'spot'). Defaults to perps rules.
- * @returns Price as a string with correct precision, no trailing zeros
- */
-export declare function formatOrderPrice(price: number, szDecimals: number, market?: string): string;
-//# sourceMappingURL=orderFormatting.d.ts.map

package/dist/types/utils/hyperliquid/orderFormatting.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"orderFormatting.d.ts","sourceRoot":"","sources":["../../../../src/utils/hyperliquid/orderFormatting.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAER;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAMxE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAsBR"}

package/dist/types/utils/request.d.ts

@@ -1,25 +0,0 @@
-import type { PerpsBaseConfig, SDKRequestOptions } from '../client/createPerpsClient.js';
-export interface RequestOptions extends RequestInit {
-    /** Number of retries on 5xx errors. Default: 1 */
-    retries?: number;
-}
-/**
- * Make an HTTP request to the Perps API.
- *
- * @param config - SDK configuration
- * @param url - The full URL to request
- * @param options - Fetch options plus retries
- * @param sdkOptions - SDK-specific options (signal, etc.)
- * @returns Parsed JSON response
- * @throws {PerpsError} On non-2xx responses or network errors
- */
-export declare function request<T>(config: PerpsBaseConfig, url: string, options?: RequestOptions, sdkOptions?: SDKRequestOptions): Promise<T>;
-/**
- * Build a URL with query parameters.
- *
- * @param baseUrl - The base URL
- * @param params - Query parameters (undefined values are filtered out)
- * @returns Full URL with query string
- */
-export declare function buildUrl(baseUrl: string, params: Record<string, string | number | boolean | undefined>): string;
-//# sourceMappingURL=request.d.ts.map

package/dist/types/utils/request.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../../src/utils/request.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAKvC,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAID;;;;;;;;;GASG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAC7B,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,cAAmB,EAC5B,UAAU,CAAC,EAAE,iBAAiB,GAC7B,OAAO,CAAC,CAAC,CAAC,CA+EZ;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAC5D,MAAM,CAWR"}

package/src/agent/AgentManager.ts

@@ -1,137 +0,0 @@
-import type { Address, Hex } from '@lifi/perps-types'
-import { PerpsErrorCode } from '@lifi/perps-types'
-import { generatePrivateKey, privateKeyToAccount } from 'viem/accounts'
-import { PerpsErrorMessage } from '../errors/constants.js'
-import { PerpsError } from '../errors/PerpsError.js'
-import { localStorageAdapter } from './storage.js'
-import type { Agent, StorageAdapter } from './types.js'
-
-const STORAGE_PREFIX = 'lifi-perps-agent'
-
-/**
- * Manages agent keypairs for USER_AGENT signing mode.
- * Agent keys are stored per user address + provider combination.
- */
-export class AgentManager {
-  private storage: StorageAdapter
-  private cache: Map<string, Agent> = new Map()
-
-  constructor(storage?: StorageAdapter) {
-    this.storage = storage ?? localStorageAdapter
-  }
-
-  /**
-   * Get the storage key for an agent.
-   */
-  private storageKey(address: Address, provider: string): string {
-    return `${STORAGE_PREFIX}:${address.toLowerCase()}:${provider.toLowerCase()}`
-  }
-
-  /**
-   * Get an existing agent for a user + provider pair.
-   *
-   * @throws {PerpsError} If agent not found
-   */
-  async getAgent(address: Address, provider: string): Promise<Agent> {
-    const key = this.storageKey(address, provider)
-
-    // Check cache first
-    const cached = this.cache.get(key)
-    if (cached) {
-      return cached
-    }
-
-    // Check storage
-    const stored = await this.storage.get(key)
-    if (stored) {
-      const agent = JSON.parse(stored) as Agent
-      this.cache.set(key, agent)
-      return agent
-    }
-
-    const error = new PerpsError(
-      PerpsErrorCode.SDKError,
-      PerpsErrorMessage.AgentNotFound
-    )
-    error.tool = '@lifi/perps-sdk'
-    throw error
-  }
-
-  /**
-   * Get an existing agent or create a new one.
-   */
-  async getOrCreateAgent(address: Address, provider: string): Promise<Agent> {
-    try {
-      return await this.getAgent(address, provider)
-    } catch {
-      // Generate new agent
-      const privateKey = generatePrivateKey()
-      const account = privateKeyToAccount(privateKey)
-
-      const agent: Agent = {
-        address: account.address,
-        privateKey,
-      }
-
-      // Store
-      const key = this.storageKey(address, provider)
-      await this.storage.set(key, JSON.stringify(agent))
-      this.cache.set(key, agent)
-
-      return agent
-    }
-  }
-
-  /**
-   * Check if an agent exists for a user + provider pair.
-   */
-  async hasAgent(address: Address, provider: string): Promise<boolean> {
-    try {
-      await this.getAgent(address, provider)
-      return true
-    } catch {
-      return false
-    }
-  }
-
-  /**
-   * Remove an agent for a user + provider pair.
-   * Call this when the user revokes agent authorization.
-   */
-  async removeAgent(address: Address, provider: string): Promise<void> {
-    const key = this.storageKey(address, provider)
-    this.cache.delete(key)
-    await this.storage.remove(key)
-  }
-
-  /**
-   * Import an existing agent keypair.
-   * Useful for restoring from backup or using a specific key.
-   */
-  async importAgent(
-    address: Address,
-    provider: string,
-    privateKey: Hex
-  ): Promise<Agent> {
-    const account = privateKeyToAccount(privateKey)
-
-    const agent: Agent = {
-      address: account.address,
-      privateKey,
-    }
-
-    const key = this.storageKey(address, provider)
-    await this.storage.set(key, JSON.stringify(agent))
-    this.cache.set(key, agent)
-
-    return agent
-  }
-
-  /**
-   * Clear all cached agents.
-   * Does not remove from storage.
-   */
-  clearCache(): void {
-    this.cache.clear()
-  }
-}