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

package/dist/esm/providers.d.ts

@@ -0,0 +1,116 @@
+import type { Asset } from './asset.js';
+import type { ActionType, PerpsSigner, SigningMethod } from './enums.js';
+import type { OhlcvInterval } from './market.js';
+/** @public */
+export interface ParamOption {
+    value: string;
+    label: string;
+}
+/** @public */
+export interface Param {
+    /** Wire key for the action params object: `{ [param.name]: value }`. */
+    name: string;
+    type: 'string';
+    /** Present iff the parameter has a fixed enumeration of admissible values. */
+    values?: ParamOption[];
+    default?: ParamOption;
+    readOnly?: boolean;
+}
+/**
+ * A single provider action. The same shape backs `Provider.setup`,
+ * `Provider.options`, and `Provider.actions` — categorisation lives in which
+ * array it sits in, not in the type. The core three fields are always present;
+ * the rest are presentation/ordering hints provided per-action in the
+ * provider's hardcoded metadata.
+ * @public
+ */
+export interface ProviderAction {
+    type: ActionType;
+    signers: PerpsSigner[];
+    signingMethod: SigningMethod;
+    /**
+     * Human label. Drives the card heading in the setup/options modals, and may
+     * also front an in-flight trading action ("{title} is working…").
+     */
+    title?: string;
+    description?: string;
+    /** UI form fields the widget renders to collect input for this action. */
+    params?: Param[];
+    /**
+     * Ascending order in which the user satisfies setup steps. Cloud-init
+     * convention: 10, 20, 30, … with 99 reserved for "always last"; the gaps
+     * leave room to insert steps later without renumbering. Lower runs first;
+     * a step may depend on every lower-sequenced step already being satisfied.
+     */
+    sequence?: number;
+}
+/**
+ * Provider-attached advisory shown against a market. Provider-agnostic: the
+ * producer decides when to emit one (e.g. an HL HIP-3 sub-dex risk warning).
+ * @public
+ */
+export interface TradeNotice {
+    /** Maps to the widget's panel styling: `warn` → warning, `info` → info. */
+    level: 'info' | 'warn';
+    /** Plaintext; any URL is rendered as text, not a hyperlink. */
+    message: string;
+}
+/** @public */
+export interface ProviderCategory {
+    id: string;
+    logoURI?: string;
+    /** `null` for the "spot" category — no single fixed quote. */
+    quoteAsset: Asset | null;
+    tradeNotice?: TradeNotice;
+}
+/** @public */
+export interface Provider {
+    key: string;
+    name: string;
+    logoURI: string;
+    signingMethod: SigningMethod;
+    /** When false, the provider is announced but not yet selectable in clients. */
+    active: boolean;
+    setup: ProviderAction[];
+    options: ProviderAction[];
+    actions: ProviderAction[];
+    categories: ProviderCategory[];
+    wsUrl?: string;
+    /** Absent means no minimum advertised. */
+    minDepositUsd?: number;
+    /**
+     * Minimum order notional value in USD. Feeds the SDK's `validateMargin`
+     * `minMarginUsd` parameter. Absent means no minimum advertised.
+     */
+    minOrderValueUsd?: number;
+    /**
+     * Minimum order notional value in USD for reduce-only orders, when the
+     * provider applies a lower floor than `minOrderValueUsd`. Absent means
+     * reduce-only orders use the same floor as `minOrderValueUsd`.
+     */
+    minReduceOrderValueUsd?: number;
+    /** Minimum withdrawal notional in USD. Absent means no minimum advertised. */
+    minWithdrawalUsd?: number;
+    /** Flat deposit fee in USD the provider charges. Absent means no fee advertised. */
+    depositFeeUsd?: number;
+    /** Flat withdrawal fee in USD the provider charges. Absent means no fee advertised. */
+    withdrawalFeeUsd?: number;
+    /**
+     * Aggregate up-votes for this provider. Populated only for inactive
+     * providers (those gathering demand before launch); absent once `active`.
+     */
+    upVotes?: number;
+    /** Aggregate down-votes. Populated only for inactive providers; see {@link upVotes}. */
+    downVotes?: number;
+    /**
+     * Candle intervals this provider supports for OHLCV/chart requests, in
+     * ascending order. Drives the client's chart interval selector. Empty for
+     * providers that expose no candle data.
+     */
+    supportedIntervals: OhlcvInterval[];
+}
+/** @public */
+export interface ProvidersResponse {
+    providers: Provider[];
+}
+//# sourceMappingURL=providers.d.ts.map

package/dist/esm/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../src/providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD,cAAc;AACd,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAED,cAAc;AACd,MAAM,WAAW,KAAK;IACpB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,QAAQ,CAAA;IACd,8EAA8E;IAC9E,MAAM,CAAC,EAAE,WAAW,EAAE,CAAA;IACtB,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAA;IAChB,OAAO,EAAE,WAAW,EAAE,CAAA;IACtB,aAAa,EAAE,aAAa,CAAA;IAC5B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,KAAK,EAAE,CAAA;IAChB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,2EAA2E;IAC3E,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;IACtB,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,cAAc;AACd,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,8DAA8D;IAC9D,UAAU,EAAE,KAAK,GAAG,IAAI,CAAA;IACxB,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B;AAED,cAAc;AACd,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,aAAa,CAAA;IAC5B,+EAA+E;IAC/E,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,EAAE,cAAc,EAAE,CAAA;IACvB,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,UAAU,EAAE,gBAAgB,EAAE,CAAA;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,oFAAoF;IACpF,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,uFAAuF;IACvF,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,kBAAkB,EAAE,aAAa,EAAE,CAAA;CACpC;AAED,cAAc;AACd,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,QAAQ,EAAE,CAAA;CACtB"}

package/{src/_esm → dist/esm}/providers.js.map

@@ -1 +1 @@
-{"version":3,"file":"providers.js","sourceRoot":"","sources":["../providers.ts"],"names":[],"mappings":""}
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../src/providers.ts"],"names":[],"mappings":""}

package/dist/esm/quote.d.ts

@@ -0,0 +1,47 @@
+import type { FeeTier } from './account.js';
+import type { FundingInfo } from './market.js';
+/** @public */
+export type QuoteSide = 'buy' | 'sell';
+/** @public */
+export type TradeType = 'perps' | 'spot';
+/**
+ * One-shot fill estimate for a market order of `sizeUsd` notional on a single
+ * venue: the VWAP fill walked from the orderbook, the price impact versus the
+ * mark, the base-tier taker fee, and (for perps) the current funding rate.
+ *
+ * `priceImpactBps` is signed-magnitude basis points (1 bps = 0.01%) of the
+ * VWAP fill's deviation from `markPrice` — always non-negative, since a buy
+ * fills above mark and a sell below.
+ * @public
+ */
+export interface Quote {
+    provider: string;
+    /** Human `displaySymbol` the quote was resolved against, e.g. `"BTC"`. */
+    symbol: string;
+    /** Opaque resolved `Market.id`. */
+    marketId: string;
+    type: TradeType;
+    side: QuoteSide;
+    /** Input notional in USD. */
+    sizeUsd: string;
+    /** Base amount the book filled for `sizeUsd` (or the most obtainable when the book is too thin). */
+    baseSize: string;
+    markPrice: string;
+    /** Volume-weighted average fill price from the book walk. */
+    expectedFillPrice: string;
+    /** VWAP deviation from `markPrice` in basis points; non-negative. */
+    priceImpactBps: string;
+    /** Base maker/taker fee fractions (not bps) for the public tier. */
+    feeTier: FeeTier;
+    /** Always `true` in v1 — quotes use the public base tier, never a per-account tier. */
+    isDefaultFeeTier: boolean;
+    /** Taker fee on the filled notional in USD: `filledNotional * feeTier.taker`. */
+    feeUsd: string;
+    /** Current funding for perps; `null` for spot. */
+    funding: FundingInfo | null;
+    /** `true` when the book could not fill the full `sizeUsd` — `baseSize`/fill reflect the best obtainable. */
+    insufficientLiquidity: boolean;
+    /** Unix milliseconds the quote was produced. */
+    timestamp: number;
+}
+//# sourceMappingURL=quote.d.ts.map

package/dist/esm/quote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote.d.ts","sourceRoot":"","sources":["../../src/quote.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,cAAc;AACd,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,CAAA;AAEtC,cAAc;AACd,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,CAAA;AAExC;;;;;;;;;GASG;AACH,MAAM,WAAW,KAAK;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAA;IACd,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,SAAS,CAAA;IACf,IAAI,EAAE,SAAS,CAAA;IACf,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,oGAAoG;IACpG,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,6DAA6D;IAC7D,iBAAiB,EAAE,MAAM,CAAA;IACzB,qEAAqE;IACrE,cAAc,EAAE,MAAM,CAAA;IACtB,oEAAoE;IACpE,OAAO,EAAE,OAAO,CAAA;IAChB,uFAAuF;IACvF,gBAAgB,EAAE,OAAO,CAAA;IACzB,iFAAiF;IACjF,MAAM,EAAE,MAAM,CAAA;IACd,kDAAkD;IAClD,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;IAC3B,4GAA4G;IAC5G,qBAAqB,EAAE,OAAO,CAAA;IAC9B,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAA;CAClB"}

package/dist/esm/quote.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=quote.js.map

package/dist/esm/quote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote.js","sourceRoot":"","sources":["../../src/quote.ts"],"names":[],"mappings":""}

package/dist/esm/subscriptions.d.ts

@@ -0,0 +1,115 @@
+import type { Balance, Fill, OpenOrder, Position, TriggerOrder } from './account.js';
+import type { Candle, OhlcvInterval, OrderbookResponse } from './market.js';
+import type { Address } from './primitives.js';
+/** @public */
+export type PricesSubscription = {
+    channel: 'prices';
+    dex: string;
+};
+/** @public */
+export type OrderbookSubscription = {
+    channel: 'orderbook';
+    dex: string;
+    marketId: string;
+    depth?: number;
+    /**
+     * Desired price granularity of streamed levels, in quote currency (e.g.
+     * `10` buckets a BTC book into $10-wide levels). Providers that aggregate
+     * the book server-side honour it best-effort; providers that stream the
+     * full book ignore it. `undefined` requests full precision.
+     */
+    priceStep?: number;
+};
+/** @public */
+export type CandleSubscription = {
+    channel: 'candle';
+    dex: string;
+    marketId: string;
+    interval: OhlcvInterval;
+};
+/** @public */
+export type OrderUpdatesSubscription = {
+    channel: 'orderUpdates';
+    dex: string;
+    address: Address;
+};
+/** @public */
+export type FillsSubscription = {
+    channel: 'fills';
+    dex: string;
+    address: Address;
+};
+/** @public */
+export type PositionsSubscription = {
+    channel: 'positions';
+    dex: string;
+    address: Address;
+};
+/** @public */
+export type SpotBalancesSubscription = {
+    channel: 'spotBalances';
+    dex: string;
+    address: Address;
+};
+/** @public */
+export type Subscription = PricesSubscription | OrderbookSubscription | CandleSubscription | OrderUpdatesSubscription | FillsSubscription | PositionsSubscription | SpotBalancesSubscription;
+/** @public */
+export type PricesEvent = {
+    channel: 'prices';
+    data: Record<string, string>;
+};
+/** @public */
+export type OrderbookEvent = {
+    channel: 'orderbook';
+    data: OrderbookResponse;
+};
+/** @public */
+export type CandleEvent = {
+    channel: 'candle';
+    data: Candle;
+};
+/** @public */
+export type OrderUpdatesEvent = {
+    channel: 'orderUpdates';
+    data: {
+        /** Upserts — active orders, non-trigger. */
+        openOrders: OpenOrder[];
+        /** Upserts — active orders with trigger semantics (TP/SL). */
+        triggerOrders: TriggerOrder[];
+        /**
+         * orderIds whose status just transitioned to terminal (filled, cancelled,
+         * rejected, expired). Consumers should evict these from both buckets.
+         */
+        terminated: string[];
+    };
+};
+/** @public */
+export type FillsEvent = {
+    channel: 'fills';
+    data: Fill[];
+};
+/**
+ * Positions stream frame. `data` is always the full set of currently open
+ * positions for the subscribed address, never a partial update: zero-size
+ * entries never appear, and a close is observed as the market's absence from
+ * the next frame. Consumers replace their state; they must not merge.
+ * @public
+ */
+export type PositionsEvent = {
+    channel: 'positions';
+    data: Position[];
+};
+/**
+ * Spot holdings as typed {@link Balance}s, each carrying the venue-locked
+ * portion (`locked` = reserved against open orders; `available = units − locked`).
+ * @public
+ */
+export type SpotBalancesEvent = {
+    channel: 'spotBalances';
+    data: (Balance & {
+        locked: string;
+    })[];
+};
+/** @public */
+export type SubscriptionEvent = PricesEvent | OrderbookEvent | CandleEvent | OrderUpdatesEvent | FillsEvent | PositionsEvent | SpotBalancesEvent;
+//# sourceMappingURL=subscriptions.d.ts.map

package/dist/esm/subscriptions.d.ts.map

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

package/{src/_esm → dist/esm}/subscriptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"subscriptions.js","sourceRoot":"","sources":["../subscriptions.ts"],"names":[],"mappings":""}
+{"version":3,"file":"subscriptions.js","sourceRoot":"","sources":["../../src/subscriptions.ts"],"names":[],"mappings":""}

package/dist/esm/typedData.d.ts

@@ -0,0 +1,28 @@
+import type { Address, Hex } from './primitives.js';
+/** @public */
+export interface TypedDataDomain {
+    name?: string;
+    version?: string;
+    chainId?: number;
+    verifyingContract?: Address;
+    salt?: Hex;
+}
+/** @public */
+export interface TypedDataParameter {
+    name: string;
+    type: string;
+}
+/** @public */
+export type PerpsPrimaryType = string;
+/** @public */
+export type PerpsTypedData = {
+    domain: TypedDataDomain;
+    types: Record<string, readonly TypedDataParameter[]>;
+    primaryType: PerpsPrimaryType;
+    message: Record<string, any>;
+};
+/** @public */
+export type PerpsSignedTypedData = PerpsTypedData & {
+    signature: Hex;
+};
+//# sourceMappingURL=typedData.d.ts.map

package/dist/esm/typedData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typedData.d.ts","sourceRoot":"","sources":["../../src/typedData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAA;AAEnD,cAAc;AACd,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,IAAI,CAAC,EAAE,GAAG,CAAA;CACX;AAED,cAAc;AACd,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,cAAc;AACd,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAA;AAErC,cAAc;AACd,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,eAAe,CAAA;IACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC,CAAA;IACpD,WAAW,EAAE,gBAAgB,CAAA;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAC7B,CAAA;AAED,cAAc;AACd,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG;IAClD,SAAS,EAAE,GAAG,CAAA;CACf,CAAA"}

package/{src/_esm → dist/esm}/typedData.js.map

@@ -1 +1 @@
-{"version":3,"file":"typedData.js","sourceRoot":"","sources":["../typedData.ts"],"names":[],"mappings":""}
+{"version":3,"file":"typedData.js","sourceRoot":"","sources":["../../src/typedData.ts"],"names":[],"mappings":""}

package/dist/esm/vote.d.ts

@@ -0,0 +1,68 @@
+import type { Address } from './primitives.js';
+import type { PerpsTypedData, TypedDataParameter } from './typedData.js';
+/**
+ * Sentinel sent in the `provider` field for provider-independent actions
+ * (e.g. {@link "./enums.js".ActionType.META_VOTE}). The backend dispatches
+ * on this value instead of resolving a real provider plugin.
+ * @public
+ */
+export declare const META_PROVIDER = "meta";
+/** @public */
+export type MetaProvider = typeof META_PROVIDER;
+/**
+ * Vote direction. `up` endorses the subject; `down` opposes it.
+ * @public
+ */
+export type VoteDirection = 'up' | 'down';
+/**
+ * Discriminates what a vote is about, leaving room for future product-level
+ * vote subjects without changing the EIP-712 `primaryType`.
+ * @public
+ */
+export type VoteType = 'provider';
+/**
+ * Params for an {@link "./enums.js".ActionType.META_VOTE} action.
+ *
+ * `targetProvider` is the voted-on subject — kept distinct from the transport
+ * `provider` field, which carries the {@link META_PROVIDER} sentinel for this
+ * provider-independent action.
+ * @public
+ */
+export interface VoteParams {
+    /** Key of the inactive provider being voted on (the voted-on subject). */
+    targetProvider: string;
+    direction: VoteDirection;
+    voteType: VoteType;
+}
+/**
+ * EIP-712 message body for a `Vote`. Field order matches {@link voteTypeFields}.
+ * @public
+ */
+export interface VoteMessage {
+    /** Key of the inactive provider being voted on. */
+    targetProvider: string;
+    direction: VoteDirection;
+    voteType: VoteType;
+    voter: Address;
+    /** Unix timestamp in milliseconds. */
+    timestamp: number;
+}
+/**
+ * EIP-712 type member list for the `Vote` primary type. Field order is part of
+ * the signed digest and must match the backend's encoder.
+ * @public
+ */
+export declare const voteTypeFields: readonly TypedDataParameter[];
+/**
+ * EIP-712 typed data for a vote, as returned by `createAction` and signed
+ * client-side. `primaryType` is always `'Vote'`.
+ * @public
+ */
+export interface VoteTypedData extends PerpsTypedData {
+    primaryType: 'Vote';
+    types: {
+        Vote: readonly TypedDataParameter[];
+    } & PerpsTypedData['types'];
+    message: VoteMessage;
+}
+//# sourceMappingURL=vote.d.ts.map

package/dist/esm/vote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vote.d.ts","sourceRoot":"","sources":["../../src/vote.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAExE;;;;;GAKG;AACH,eAAO,MAAM,aAAa,SAAS,CAAA;AAEnC,cAAc;AACd,MAAM,MAAM,YAAY,GAAG,OAAO,aAAa,CAAA;AAE/C;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,MAAM,CAAA;AAEzC;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAA;AAEjC;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB,0EAA0E;IAC1E,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,aAAa,CAAA;IACxB,QAAQ,EAAE,QAAQ,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,aAAa,CAAA;IACxB,QAAQ,EAAE,QAAQ,CAAA;IAClB,KAAK,EAAE,OAAO,CAAA;IACd,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,kBAAkB,EAMvD,CAAA;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAc,SAAQ,cAAc;IACnD,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE;QAAE,IAAI,EAAE,SAAS,kBAAkB,EAAE,CAAA;KAAE,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;IACxE,OAAO,EAAE,WAAW,CAAA;CACrB"}

package/dist/esm/vote.js

@@ -0,0 +1,20 @@
+/**
+ * Sentinel sent in the `provider` field for provider-independent actions
+ * (e.g. {@link "./enums.js".ActionType.META_VOTE}). The backend dispatches
+ * on this value instead of resolving a real provider plugin.
+ * @public
+ */
+export const META_PROVIDER = 'meta';
+/**
+ * EIP-712 type member list for the `Vote` primary type. Field order is part of
+ * the signed digest and must match the backend's encoder.
+ * @public
+ */
+export const voteTypeFields = [
+    { name: 'targetProvider', type: 'string' },
+    { name: 'direction', type: 'string' },
+    { name: 'voteType', type: 'string' },
+    { name: 'voter', type: 'address' },
+    { name: 'timestamp', type: 'uint256' },
+];
+//# sourceMappingURL=vote.js.map

package/dist/esm/vote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vote.js","sourceRoot":"","sources":["../../src/vote.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAA;AA+CnC;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAkC;IAC3D,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC1C,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE;IACrC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;IACpC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;IAClC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;CACvC,CAAA"}

package/dist/types/acceptTerms.d.ts

@@ -0,0 +1,45 @@
+import type { Address } from './primitives.js';
+import type { PerpsTypedData, TypedDataParameter } from './typedData.js';
+/**
+ * Params for an {@link "./enums.js".ActionType.META_ACCEPT_TERMS} action.
+ *
+ * Provider-independent: cast with the {@link "./vote.js".META_PROVIDER}
+ * sentinel in the transport `provider` field.
+ * @public
+ */
+export interface AcceptTermsParams {
+    /** Terms-of-Service version being accepted; backend-owned, relayed verbatim. */
+    termsVersion: string;
+}
+/**
+ * EIP-712 message body for an `AcceptTerms`. Field order matches
+ * {@link acceptTermsTypeFields}.
+ * @public
+ */
+export interface AcceptTermsMessage {
+    /** Human-readable action, e.g. `"Accept LI.FI Perps Terms of Service v3"`. */
+    action: string;
+    acceptor: Address;
+    termsVersion: string;
+    /** Unix timestamp in milliseconds. */
+    timestamp: number;
+}
+/**
+ * EIP-712 type member list for the `AcceptTerms` primary type. Field order is
+ * part of the signed digest and must match the backend's encoder.
+ * @public
+ */
+export declare const acceptTermsTypeFields: readonly TypedDataParameter[];
+/**
+ * EIP-712 typed data for a terms acceptance, as returned by `createAction` and
+ * signed client-side. `primaryType` is always `'AcceptTerms'`.
+ * @public
+ */
+export interface AcceptTermsTypedData extends PerpsTypedData {
+    primaryType: 'AcceptTerms';
+    types: {
+        AcceptTerms: readonly TypedDataParameter[];
+    } & PerpsTypedData['types'];
+    message: AcceptTermsMessage;
+}
+//# sourceMappingURL=acceptTerms.d.ts.map

package/dist/types/acceptTerms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acceptTerms.d.ts","sourceRoot":"","sources":["../../src/acceptTerms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAExE;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,gFAAgF;IAChF,YAAY,EAAE,MAAM,CAAA;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,OAAO,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,kBAAkB,EAK9D,CAAA;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D,WAAW,EAAE,aAAa,CAAA;IAC1B,KAAK,EAAE;QACL,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAA;KAC3C,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;IAC3B,OAAO,EAAE,kBAAkB,CAAA;CAC5B"}