@lifi/perps-sdk 0.1.1-alpha.8 → 0.2.0-alpha.0

package/dist/types/services/getPrices.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getPrices.d.ts","sourceRoot":"","sources":["../../../src/services/getPrices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAA;IACX,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,eAAe,EACvB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,cAAc,CAAC,CAMzB"}
+{"version":3,"file":"getPrices.d.ts","sourceRoot":"","sources":["../../../src/services/getPrices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAA;IAChB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,eAAe,EACvB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,cAAc,CAAC,CAMzB"}

package/dist/types/services/getProviders.d.ts

@@ -0,0 +1,20 @@
+import type { ProvidersResponse } from '@lifi/perps-types';
+import type { PerpsSDKClient, SDKRequestOptions } from '../client/createPerpsClient.js';
+/**
+ * Get all available providers.
+ *
+ * @param client - The SDK client instance
+ * @param options - Request options (e.g., AbortSignal)
+ * @returns List of supported providers with their authorization requirements
+ * @throws {PerpsError} On API error responses
+ * @throws {PerpsError} On network or parsing errors
+ *
+ * @example
+ * ```ts
+ * const client = createPerpsClient({ integrator: 'my-app' })
+ * const { providers } = await getProviders(client)
+ * console.log(providers) // [{ key: 'hyperliquid', name: 'Hyperliquid', ... }]
+ * ```
+ */
+export declare function getProviders(client: PerpsSDKClient, options?: SDKRequestOptions): Promise<ProvidersResponse>;
+//# sourceMappingURL=getProviders.d.ts.map

package/dist/types/services/getProviders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getProviders.d.ts","sourceRoot":"","sources":["../../../src/services/getProviders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAGvC;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAO5B"}

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

@@ -0,0 +1,29 @@
+import type { Address } from '@lifi/perps-types';
+import type { StorageAdapter } from '../../agent/types.js';
+export declare const LIGHTER_PROVIDER_KEY = "lighter";
+/**
+ * Default API key slot. Reusing one slot is deliberate: Lighter allows 256
+ * slots per account but re-registering a slot overwrites the prior key, so
+ * a fixed slot keeps storage small and recovery simple.
+ */
+export declare const DEFAULT_API_KEY_INDEX = 1;
+export interface LighterApiKey {
+    /** Lighter account index, looked up once via accountsByL1Address. */
+    accountIndex: number;
+    /** API key slot (0-255). Defaults to {@link DEFAULT_API_KEY_INDEX}. */
+    apiKeyIndex: number;
+    /** Lighter-native private key (0x-prefixed hex). */
+    apiKeyPrivateKey: string;
+    /** Corresponding public key, registered via ChangePubKey. */
+    apiKeyPublicKey: string;
+}
+export declare class LighterKeyStore {
+    private readonly storage;
+    private readonly cache;
+    constructor(storage: StorageAdapter);
+    private storageKey;
+    get(address: Address): Promise<LighterApiKey | null>;
+    set(address: Address, value: LighterApiKey): Promise<void>;
+    remove(address: Address): Promise<void>;
+}
+//# sourceMappingURL=LighterKeyStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LighterKeyStore.d.ts","sourceRoot":"","sources":["../../../../src/signers/lighter/LighterKeyStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAc1D,eAAO,MAAM,oBAAoB,YAAY,CAAA;AAE7C;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,IAAI,CAAA;AAEtC,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,YAAY,EAAE,MAAM,CAAA;IACpB,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAA;IACnB,oDAAoD;IACpD,gBAAgB,EAAE,MAAM,CAAA;IACxB,6DAA6D;IAC7D,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmC;gBAE7C,OAAO,EAAE,cAAc;IAInC,OAAO,CAAC,UAAU;IAIZ,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAepD,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAM1D,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAK9C"}

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

@@ -0,0 +1,174 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,88 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,9 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,71 @@
+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

@@ -0,0 +1 @@
+{"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/accountSummary.d.ts

@@ -0,0 +1,13 @@
+import type { AccountResponse, Asset, Position } from '@lifi/perps-types';
+export interface AccountSummary {
+    /** Total portfolio value in USD */
+    portfolioValue: number;
+    /** Collateral available for new positions */
+    availableMargin: number;
+    /** Margin locked in open positions */
+    marginUsed: number;
+    /** Unrealized PnL across all positions */
+    unrealizedPnl: number;
+}
+export declare function calculateAccountSummary(account: AccountResponse, positions: Position[], prices: Record<string, string>, assets?: Asset[], collateralCurrencies?: ReadonlySet<string>): AccountSummary;
+//# sourceMappingURL=accountSummary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"accountSummary.d.ts","sourceRoot":"","sources":["../../../src/utils/accountSummary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAIzE,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,cAAc,EAAE,MAAM,CAAA;IACtB,6CAA6C;IAC7C,eAAe,EAAE,MAAM,CAAA;IACvB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAA;IAClB,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAA;CACtB;AAwDD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,QAAQ,EAAE,EACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,MAAM,CAAC,EAAE,KAAK,EAAE,EAChB,oBAAoB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GACzC,cAAc,CAsDhB"}

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

@@ -0,0 +1,19 @@
+/**
+ * Exhaustiveness helper for discriminated-union switches.
+ *
+ * Use in the `default` arm of a `switch (discriminant)` block: TypeScript
+ * narrows the variable to `never` when every case is handled, so adding a
+ * new variant to the union without a corresponding `case` becomes a
+ * compile error here. At runtime — if reached — throw rather than return
+ * silently; the throw is unreachable in well-typed code but flags
+ * upstream-shape drift loudly.
+ *
+ * @example
+ *   switch (config.provider) {
+ *     case 'hyperliquid': return projectHyperliquid(config)
+ *     case 'lighter': return projectLighter(config)
+ *     default: return assertNever(config)
+ *   }
+ */
+export declare function assertNever(value: never): never;
+//# sourceMappingURL=assertNever.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assertNever.d.ts","sourceRoot":"","sources":["../../../src/utils/assertNever.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAI/C"}

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

@@ -0,0 +1,109 @@
+/**
+ * Universal perpetual futures calculation utilities.
+ *
+ * Pure functions for computing position-related values that any consumer
+ * of the perps SDK would need. All parameters are required — no default
+ * values for critical financial parameters.
+ */
+/**
+ * Calculate position size in asset units from margin.
+ *
+ * @param marginUsd - Margin amount in USD
+ * @param leverage - Position leverage
+ * @param price - Current asset price
+ * @returns Position size in asset units
+ */
+export declare function calculatePositionSize(marginUsd: number, leverage: number, price: number): number;
+/**
+ * Calculate notional value of a position.
+ *
+ * @param size - Position size in asset units
+ * @param price - Current asset price
+ * @returns Notional value in USD
+ */
+export declare function calculateNotionalValue(size: number, price: number): number;
+/**
+ * Calculate unrealized PnL.
+ *
+ * @param entryPrice - Position entry price
+ * @param currentPrice - Current market price
+ * @param size - Position size (positive for long, negative for short)
+ * @returns Unrealized PnL in USD
+ */
+export declare function calculateUnrealizedPnl(entryPrice: number, currentPrice: number, size: number): number;
+/**
+ * Calculate return on equity (ROE) percentage.
+ *
+ * @param pnl - Profit/loss in USD
+ * @param margin - Initial margin in USD
+ * @returns ROE as percentage (e.g., 10 for 10%)
+ */
+export declare function calculateRoe(pnl: number, margin: number): number;
+/**
+ * Calculate required margin for a position.
+ *
+ * @param notionalValue - Position notional value in USD
+ * @param leverage - Position leverage
+ * @returns Required margin in USD
+ */
+export declare function calculateRequiredMargin(notionalValue: number, leverage: number): number;
+/**
+ * Estimate trading fees.
+ *
+ * @param sizeUsd - Position size in USD (notional value)
+ * @param feeRate - Fee rate as decimal (e.g., 0.00035 for 0.035%)
+ * @returns Estimated fee in USD
+ */
+export declare function estimateFees(sizeUsd: number, feeRate: number): number;
+/**
+ * Apply slippage to a price for order execution.
+ *
+ * @param price - Base price
+ * @param slippagePercent - Slippage tolerance as percentage (e.g., 0.5 for 0.5%)
+ * @param isBuy - True if buying (price goes up), false if selling (price goes down)
+ * @returns Price adjusted for slippage
+ */
+export declare function applySlippage(price: number, slippagePercent: number, isBuy: boolean): number;
+export interface ExpectedPnl {
+    amount: number;
+    percent: number;
+}
+/**
+ * Calculate expected gain/loss for a TP or SL trigger price.
+ * Returns signed values — positive means profit, negative means loss.
+ *
+ * @param triggerPrice - The TP or SL target price
+ * @param entryPrice - Position entry / current market price
+ * @param leverage - Position leverage multiplier
+ * @param isLong - True for long positions, false for short
+ * @param margin - Margin amount in USD
+ */
+export declare function calculateExpectedPnl(triggerPrice: number, entryPrice: number, leverage: number, isLong: boolean, margin: number): ExpectedPnl | null;
+/**
+ * Convert a percentage gain/loss to a target price.
+ *
+ * @param percent - Target gain/loss percentage (positive = profitable direction)
+ * @param entryPrice - Position entry price
+ * @param leverage - Position leverage multiplier
+ * @param isLong - True for long positions, false for short
+ */
+export declare function priceFromPercent(percent: number, entryPrice: number, leverage: number, isLong: boolean): number;
+/**
+ * Convert a target price to a percentage gain/loss.
+ *
+ * @param price - Target price
+ * @param entryPrice - Position entry price
+ * @param leverage - Position leverage multiplier
+ * @param isLong - True for long positions, false for short
+ */
+export declare function percentFromPrice(price: number, entryPrice: number, leverage: number, isLong: boolean): number;
+/**
+ * Calculate realized PnL as a percentage of position value at close.
+ *
+ * @param realizedPnl - The realized profit/loss in USD
+ * @param size - Position size in asset units at close
+ * @param price - Price at close
+ * @returns PnL as a percentage of position value
+ */
+export declare function calculateRealizedPnlPercent(realizedPnl: number, size: number, price: number): number;
+//# sourceMappingURL=calculations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calculations.d.ts","sourceRoot":"","sources":["../../../src/utils/calculations.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,GACX,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAKhE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,OAAO,GACb,MAAM,CAGR;AAMD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GACb,WAAW,GAAG,IAAI,CAUpB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,GACd,MAAM,CAMR;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,GACd,MAAM,CAMR;AAMD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,MAAM,CAMR"}

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

@@ -0,0 +1,3 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,46 @@
+/**
+ * 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