@metaflux-dex/client 0.0.1

package/dist/types.d.ts

@@ -0,0 +1,143 @@
+export type Side = 0 | 1;
+export type Tif = 0 | 1 | 2;
+export type StpMode = 0 | 1 | 2 | 3;
+export interface Builder {
+    fee: number;
+    user: string;
+}
+export interface Order {
+    asset: number;
+    side: Side;
+    priceE8: bigint;
+    sizeE8: bigint;
+    tif: Tif;
+    stp?: StpMode;
+    cloid?: bigint;
+    reduceOnly?: boolean;
+    builder?: Builder;
+}
+export interface SignedOrder {
+    payload: Uint8Array;
+    signature: Uint8Array;
+    signer: Uint8Array;
+}
+export interface NativeOrder {
+    owner: string;
+    market: number;
+    side: NativeSide;
+    kind: NativeOrderKind;
+    size: number;
+    limit_px: number;
+    tif: NativeTif;
+    stp_mode: NativeStpMode;
+    reduce_only: boolean;
+    cloid?: string;
+    builder?: NativeBuilder;
+}
+export interface NativeCancel {
+    owner: string;
+    market: number;
+    oid?: number;
+    cloid?: string;
+}
+export type NativeSide = 'bid' | 'ask';
+export type NativeOrderKind = 'limit' | 'market' | 'stop_loss' | 'take_profit';
+export type NativeTif = 'gtc' | 'ioc' | 'aon' | 'alo';
+export type NativeStpMode = 'cancel_oldest' | 'cancel_newest' | 'cancel_both' | 'reject';
+export interface NativeBuilder {
+    fee: number;
+    user: string;
+}
+export interface NativeSignedAction {
+    actionJson: string;
+    nonce: bigint;
+    signature: string;
+}
+export type OrderStatus = {
+    resting: {
+        oid: number;
+        cloid?: string;
+    };
+} | {
+    filled: {
+        oid: number;
+        total_sz: string;
+        avg_px: string;
+    };
+} | {
+    error: string;
+} | {
+    pending: {
+        action_hash: string;
+        nonce: number;
+    };
+};
+export interface NativeExchangeAck {
+    statuses?: OrderStatus[];
+    accepted?: boolean;
+    error?: string;
+    mempool_depth?: number;
+    nonce?: number;
+    action_hash?: string;
+}
+export interface OrderAck {
+    id: string;
+    timestamp: number;
+    datetime: string;
+    symbol: string;
+    type: 'limit' | 'market';
+    side: 'buy' | 'sell';
+    price?: string;
+    amount: string;
+    filled: string;
+    remaining: string;
+    status: 'open' | 'closed' | 'canceled' | 'expired' | 'rejected';
+    clientOrderId?: string;
+}
+export interface Market {
+    id: string;
+    symbol: string;
+    base: string;
+    quote: string;
+    settle?: string;
+    active: boolean;
+    spot: boolean;
+    contract: boolean;
+    swap: boolean;
+    future: boolean;
+    linear: boolean;
+    precision: {
+        amount: number;
+        price: number;
+    };
+    limits: {
+        amount: {
+            min?: string;
+            max?: string;
+        };
+        price: {
+            min?: string;
+            max?: string;
+        };
+        cost: {
+            min?: string;
+            max?: string;
+        };
+    };
+}
+export interface Position {
+    symbol: string;
+    side: 'long' | 'short';
+    contracts: string;
+    notional?: string;
+    entryPrice?: string;
+    markPrice?: string;
+    liquidationPrice?: string;
+    unrealizedPnl?: string;
+    leverage?: string;
+    timestamp: number;
+}
+export interface ErrorEnvelope {
+    error: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAgBA,MAAM,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;AAKzB,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAO5B,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAMpC,MAAM,WAAW,OAAO;IAItB,GAAG,EAAE,MAAM,CAAC;IAGZ,IAAI,EAAE,MAAM,CAAC;CACd;AAMD,MAAM,WAAW,KAAK;IAEpB,KAAK,EAAE,MAAM,CAAC;IAEd,IAAI,EAAE,IAAI,CAAC;IAGX,OAAO,EAAE,MAAM,CAAC;IAGhB,MAAM,EAAE,MAAM,CAAC;IAEf,GAAG,EAAE,GAAG,CAAC;IAIT,GAAG,CAAC,EAAE,OAAO,CAAC;IAKd,KAAK,CAAC,EAAE,MAAM,CAAC;IAIf,UAAU,CAAC,EAAE,OAAO,CAAC;IAGrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAWD,MAAM,WAAW,WAAW;IAE1B,OAAO,EAAE,UAAU,CAAC;IAEpB,SAAS,EAAE,UAAU,CAAC;IAEtB,MAAM,EAAE,UAAU,CAAC;CACpB;AAWD,MAAM,WAAW,WAAW;IAI1B,KAAK,EAAE,MAAM,CAAC;IAEd,MAAM,EAAE,MAAM,CAAC;IAEf,IAAI,EAAE,UAAU,CAAC;IAEjB,IAAI,EAAE,eAAe,CAAC;IAEtB,IAAI,EAAE,MAAM,CAAC;IAEb,QAAQ,EAAE,MAAM,CAAC;IAEjB,GAAG,EAAE,SAAS,CAAC;IAEf,QAAQ,EAAE,aAAa,CAAC;IAExB,WAAW,EAAE,OAAO,CAAC;IAGrB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAOD,MAAM,WAAW,YAAY;IAE3B,KAAK,EAAE,MAAM,CAAC;IAEd,MAAM,EAAE,MAAM,CAAC;IAIf,GAAG,CAAC,EAAE,MAAM,CAAC;IAGb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAGD,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,KAAK,CAAC;AAKvC,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,aAAa,CAAC;AAI/E,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAItD,MAAM,MAAM,aAAa,GACrB,eAAe,GACf,eAAe,GACf,aAAa,GACb,QAAQ,CAAC;AAIb,MAAM,WAAW,aAAa;IAE5B,GAAG,EAAE,MAAM,CAAC;IAEZ,IAAI,EAAE,MAAM,CAAC;CACd;AAQD,MAAM,WAAW,kBAAkB;IAEjC,UAAU,EAAE,MAAM,CAAC;IAEnB,KAAK,EAAE,MAAM,CAAC;IAEd,SAAS,EAAE,MAAM,CAAC;CACnB;AASD,MAAM,MAAM,WAAW,GAEnB;IAAE,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAE5C;IAAE,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAG7D;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAGjB;IAAE,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAYxD,MAAM,WAAW,iBAAiB;IAEhC,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IAGzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAKD,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IACzB,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAKD,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,MAAM,EAAE;QACN,MAAM,EAAE;YAAE,GAAG,CAAC,EAAE,MAAM,CAAC;YAAC,GAAG,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACvC,KAAK,EAAE;YAAE,GAAG,CAAC,EAAE,MAAM,CAAC;YAAC,GAAG,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACtC,IAAI,EAAE;YAAE,GAAG,CAAC,EAAE,MAAM,CAAC;YAAC,GAAG,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACtC,CAAC;CACH;AAID,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAKD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/types.js

@@ -0,0 +1,13 @@
+// Type definitions for the @metaflux-dex/client surface.
+//
+// Shapes mirror the CCXT-compat REST responses emitted by the MetaFlux
+// api-gateway (`metaflux/crates/api-gateway/src/ccxt/types.rs`). The
+// monetary-fields-as-decimal-strings convention is load-bearing — CCXT
+// clients pass these straight into `Decimal(value)` and any drift to
+// number-typed fields silently loses precision.
+//
+// `Order` / `SignedOrder` are MTF-native (they carry pre-signed bytes
+// the gateway forwards to the node). The other types match what the
+// gateway emits.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,EAAE;AACF,uEAAuE;AACvE,qEAAqE;AACrE,uEAAuE;AACvE,qEAAqE;AACrE,gDAAgD;AAChD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,iBAAiB"}

package/dist/wasm.d.ts

@@ -0,0 +1,28 @@
+import type { Builder, Side, StpMode, Tif } from './types.js';
+interface WasmModule {
+    default: (path?: string | URL | Request) => Promise<unknown>;
+    keccak256: (data: Uint8Array) => Uint8Array;
+    sign_secp256k1: (privKey: Uint8Array, messageHash: Uint8Array) => Uint8Array;
+    recover_pubkey: (sig: Uint8Array, messageHash: Uint8Array) => Uint8Array;
+    verify_secp256k1: (pubkeyCompressed: Uint8Array, sig: Uint8Array, messageHash: Uint8Array) => boolean;
+    eip712_typed_data_hash: (domainSeparator: Uint8Array, messageHash: Uint8Array) => Uint8Array;
+    encode_limit_order: (asset: number, side: number, sizeE8Lo: bigint, sizeE8Hi: bigint, priceE8Lo: bigint, priceE8Hi: bigint, tif: number, stp: number, hasCloid: boolean, cloidLo: bigint, cloidHi: bigint, reduceOnly: boolean, hasBuilder: boolean, builderFee: number, builderUser: Uint8Array) => Uint8Array;
+    derive_address_from_pubkey: (pubkey: Uint8Array) => Uint8Array;
+}
+export declare class WasmNotBuiltError extends Error {
+    constructor(cause?: unknown);
+}
+export declare class WasmCallError extends Error {
+    readonly call: string;
+    constructor(call: string, hint?: string);
+}
+export declare function loadWasm(): Promise<WasmModule>;
+export declare function _resetWasmCacheForTest(): void;
+export declare function keccak256(data: Uint8Array): Promise<Uint8Array>;
+export declare function signSecp256k1(privKey: Uint8Array, messageHash: Uint8Array): Promise<Uint8Array>;
+export declare function recoverPubkey(sig: Uint8Array, messageHash: Uint8Array): Promise<Uint8Array>;
+export declare function eip712TypedDataHash(domainSeparator: Uint8Array, messageHash: Uint8Array): Promise<Uint8Array>;
+export declare function encodeLimitOrder(asset: number, side: Side, sizeE8: bigint, priceE8: bigint, tif: Tif, stp?: StpMode, cloid?: bigint, reduceOnly?: boolean, builder?: Builder): Promise<Uint8Array>;
+export declare function deriveAddressFromPubkey(pubkey: Uint8Array): Promise<Uint8Array>;
+export {};
+//# sourceMappingURL=wasm.d.ts.map

package/dist/wasm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm.d.ts","sourceRoot":"","sources":["../src/wasm.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAK9D,UAAU,UAAU;IAClB,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,SAAS,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,UAAU,CAAC;IAC5C,cAAc,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,KAAK,UAAU,CAAC;IAC7E,cAAc,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,KAAK,UAAU,CAAC;IACzE,gBAAgB,EAAE,CAChB,gBAAgB,EAAE,UAAU,EAC5B,GAAG,EAAE,UAAU,EACf,WAAW,EAAE,UAAU,KACpB,OAAO,CAAC;IACb,sBAAsB,EAAE,CACtB,eAAe,EAAE,UAAU,EAC3B,WAAW,EAAE,UAAU,KACpB,UAAU,CAAC;IAChB,kBAAkB,EAAE,CAClB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,OAAO,EACnB,UAAU,EAAE,OAAO,EACnB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,UAAU,KACpB,UAAU,CAAC;IAChB,0BAA0B,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,UAAU,CAAC;CAChE;AAOD,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,KAAK,CAAC,EAAE,OAAO;CAU5B;AAID,qBAAa,aAAc,SAAQ,KAAK;aACV,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAOxD;AAcD,wBAAsB,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC,CAwCpD;AAID,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAyCD,wBAAsB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAOrE;AAID,wBAAsB,aAAa,CACjC,OAAO,EAAE,UAAU,EACnB,WAAW,EAAE,UAAU,GACtB,OAAO,CAAC,UAAU,CAAC,CAUrB;AAGD,wBAAsB,aAAa,CACjC,GAAG,EAAE,UAAU,EACf,WAAW,EAAE,UAAU,GACtB,OAAO,CAAC,UAAU,CAAC,CAUrB;AAGD,wBAAsB,mBAAmB,CACvC,eAAe,EAAE,UAAU,EAC3B,WAAW,EAAE,UAAU,GACtB,OAAO,CAAC,UAAU,CAAC,CAUrB;AAqBD,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,GAAG,EACR,GAAG,GAAE,OAAW,EAChB,KAAK,CAAC,EAAE,MAAM,EACd,UAAU,UAAQ,EAClB,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,UAAU,CAAC,CAkErB;AAgCD,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,UAAU,CAAC,CAUrB"}

package/dist/wasm.js

@@ -0,0 +1,279 @@
+// WASM module loader + typed facade.
+//
+// The wasm-pack-emitted `pkg/metaflux_client_wasm.js` is dynamically
+// imported so the bundle can be tree-shaken when consumers only want
+// the pure-TS REST surface. `loadWasm()` is idempotent; first call
+// instantiates, subsequent calls reuse the resolved promise.
+//
+// Why dynamic import + facade?
+//
+// 1. The `pkg/` directory is only present after `npm run build:wasm`.
+//    A top-level `import` would crash on a fresh clone before that step
+//    runs; dynamic import lets the WASM-using code paths fail with a
+//    helpful error pointing to the build command.
+// 2. The wasm-bindgen-generated module exports raw `Uint8Array` returns
+//    that are zero-length on encoder failure (see `lib.rs`). The facade
+//    promotes that to a typed exception, keeping the Client surface
+//    free of "did this succeed?" branches.
+let wasmPromise;
+/// Custom error thrown when the WASM module cannot be loaded — e.g. on
+/// a fresh clone before `npm run build:wasm` has produced `pkg/`. The
+/// message points at the fix.
+export class WasmNotBuiltError extends Error {
+    constructor(cause) {
+        super('metaflux_client_wasm not built. Run `npm run build:wasm` first ' +
+            '(requires `wasm-pack`; install via `brew install wasm-pack`).');
+        this.name = 'WasmNotBuiltError';
+        if (cause !== undefined) {
+            this.cause = cause;
+        }
+    }
+}
+/// Thrown when a WASM-side encoder/signer returns an empty buffer (the
+/// `lib.rs` convention for invalid input). Carries the failed call name.
+export class WasmCallError extends Error {
+    call;
+    constructor(call, hint) {
+        super(`WASM call '${call}' returned empty result` +
+            (hint !== undefined ? ` (${hint})` : ''));
+        this.call = call;
+        this.name = 'WasmCallError';
+    }
+}
+/// Idempotently load + initialise the WASM module.
+///
+/// First call dynamically imports `../pkg/metaflux_client_wasm.js`
+/// (the wasm-pack output), invokes the default-export `init`, and
+/// caches the resolved module. Subsequent calls return the cached
+/// promise — both fast-path and re-entrant safe.
+///
+/// The dynamic import path is built from a string variable so the
+/// TypeScript compiler does not try to statically resolve the
+/// (until-built) `pkg/` directory at typecheck time. The shape
+/// expected from the loaded module is enforced by the cast to
+/// `WasmModule`.
+export async function loadWasm() {
+    if (wasmPromise === undefined) {
+        wasmPromise = (async () => {
+            let mod;
+            try {
+                // Path is relative to the *compiled* dist/ output (one level
+                // above pkg/ at the repo root). At dev-mode (vitest running
+                // .ts directly) the same relative path lands on the same
+                // pkg/ directory because vitest cwd is the repo root.
+                const wasmPath = '../pkg/metaflux_client_wasm.js';
+                mod = (await import(/* @vite-ignore */ wasmPath));
+            }
+            catch (err) {
+                throw new WasmNotBuiltError(err);
+            }
+            // wasm-pack's default-export `init` accepts an optional .wasm source;
+            // we let it auto-resolve relative to the .js shim. The Node-target
+            // build (`--target nodejs`) loads the .wasm synchronously at
+            // module-load time and exposes NO default export — only `web` /
+            // `bundler` builds need this call.
+            if (typeof mod.default === 'function') {
+                const init = mod
+                    .default;
+                try {
+                    // Browser / bundler: default-resolve the .wasm via fetch.
+                    await init();
+                }
+                catch (fetchErr) {
+                    // Node (incl. vitest): the web-target shim's `init()` fetches the
+                    // .wasm by file URL, which Node's fetch refuses. Fall back to
+                    // reading + compiling the bytes ourselves and handing them to
+                    // init(). Only attempt this where `node:fs` is importable; if it
+                    // is not (true browser), rethrow the original fetch error.
+                    const compiled = await compileWasmFromFs();
+                    if (compiled === undefined)
+                        throw fetchErr;
+                    await init({ module_or_path: compiled });
+                }
+            }
+            return mod;
+        })();
+    }
+    return wasmPromise;
+}
+/// Reset the cached module — used by tests that want to exercise the
+/// WasmNotBuiltError path. Not part of the public API.
+export function _resetWasmCacheForTest() {
+    wasmPromise = undefined;
+}
+/// Node-only: read + compile the wasm-pack `_bg.wasm` bytes so the web-target
+/// `init()` can be fed a ready module instead of fetching a file URL (which
+/// Node's `fetch` rejects). Returns `undefined` in environments without
+/// `node:fs` (a real browser), where the fetch path is correct anyway.
+async function compileWasmFromFs() {
+    try {
+        const fs = await import('node:fs/promises');
+        const url = await import('node:url');
+        const path = await import('node:path');
+        // Resolve the .wasm next to the wasm-pack .js shim. From dev (vitest on
+        // src/*.ts) the cwd is the repo root and pkg/ sits there; from the
+        // compiled dist/ output pkg/ is one level up. Try both.
+        const candidates = [
+            path.resolve(process.cwd(), 'pkg', 'metaflux_client_wasm_bg.wasm'),
+            url.fileURLToPath(new URL('../pkg/metaflux_client_wasm_bg.wasm', import.meta.url)),
+        ];
+        for (const c of candidates) {
+            try {
+                const bytes = await fs.readFile(c);
+                return await WebAssembly.compile(bytes);
+            }
+            catch {
+                // Try the next candidate.
+            }
+        }
+        return undefined;
+    }
+    catch {
+        // `node:fs` unavailable -> not Node; the fetch path is the right one.
+        return undefined;
+    }
+}
+// ============================================================================
+// Typed wrappers — each promotes an empty WASM result to a thrown error.
+// ============================================================================
+/// `keccak256(data)` -> 32-byte digest. Throws `WasmCallError` on empty
+/// result (should not happen — keccak accepts any length input).
+export async function keccak256(data) {
+    const wasm = await loadWasm();
+    const out = wasm.keccak256(data);
+    if (out.length !== 32) {
+        throw new WasmCallError('keccak256', `got ${out.length} bytes, want 32`);
+    }
+    return out;
+}
+/// Produce a recoverable ECDSA signature in `r || s || v` 65-byte form.
+/// Throws on a malformed private key or message hash length.
+export async function signSecp256k1(privKey, messageHash) {
+    const wasm = await loadWasm();
+    const out = wasm.sign_secp256k1(privKey, messageHash);
+    if (out.length !== 65) {
+        throw new WasmCallError('sign_secp256k1', 'invalid private key or message hash length (expected 32 bytes each)');
+    }
+    return out;
+}
+/// Recover the 33-byte compressed pubkey from a sig + message digest.
+export async function recoverPubkey(sig, messageHash) {
+    const wasm = await loadWasm();
+    const out = wasm.recover_pubkey(sig, messageHash);
+    if (out.length !== 33) {
+        throw new WasmCallError('recover_pubkey', 'malformed signature or message hash');
+    }
+    return out;
+}
+/// EIP-712 envelope hash: `keccak256(0x1901 || domain || message)`.
+export async function eip712TypedDataHash(domainSeparator, messageHash) {
+    const wasm = await loadWasm();
+    const out = wasm.eip712_typed_data_hash(domainSeparator, messageHash);
+    if (out.length !== 32) {
+        throw new WasmCallError('eip712_typed_data_hash', `got ${out.length} bytes, want 32`);
+    }
+    return out;
+}
+/// Encode the canonical msgpack body for an `order` action. The 128-bit
+/// `priceE8` / `sizeE8` amounts are split into (lo, hi) `bigint` words
+/// for the wasm-bindgen ABI — see `lib.rs::u128_from_parts`.
+///
+/// `stp` (self-trade-prevention) and `reduceOnly` are REQUIRED on the node's
+/// signed wire (`OrderParams` has no serde default for either); they default
+/// here to `0` (CancelNewest) / `false` so callers can omit them, but are
+/// always emitted into the body.
+///
+/// `cloid` (optional client order id) rides the signed body as the raw 128-bit
+/// integer — the node's `Cloid(u128)` wire form — split into (lo, hi) words for
+/// the wasm-bindgen ABI. Omit for no cloid (the key is skipped; the node fills
+/// `None`).
+///
+/// `builder` (ADR-012 §L.5.2) is optional. When supplied it is encoded
+/// INSIDE the body so the carve is covered by the EIP-712 signature; an
+/// omitted builder produces byte-identical output to the pre-builder
+/// encoder (the `builder` key is skipped, and the node defaults it to
+/// `None`).
+export async function encodeLimitOrder(asset, side, sizeE8, priceE8, tif, stp = 0, cloid, reduceOnly = false, builder) {
+    if (sizeE8 < 0n)
+        throw new RangeError('sizeE8 must be non-negative');
+    if (priceE8 < 0n)
+        throw new RangeError('priceE8 must be non-negative');
+    if (sizeE8 >= 1n << 128n)
+        throw new RangeError('sizeE8 overflows u128');
+    if (priceE8 >= 1n << 128n)
+        throw new RangeError('priceE8 overflows u128');
+    const mask64 = (1n << 64n) - 1n;
+    const sizeLo = sizeE8 & mask64;
+    const sizeHi = (sizeE8 >> 64n) & mask64;
+    const priceLo = priceE8 & mask64;
+    const priceHi = (priceE8 >> 64n) & mask64;
+    // Cloid: optional 128-bit client order id. On the signed wire it is the
+    // raw u128 (node `Cloid(u128)`), split into (lo, hi) for the ABI.
+    let hasCloid = false;
+    let cloidLo = 0n;
+    let cloidHi = 0n;
+    if (cloid !== undefined) {
+        if (cloid < 0n)
+            throw new RangeError('cloid must be non-negative');
+        if (cloid >= 1n << 128n)
+            throw new RangeError('cloid overflows u128');
+        hasCloid = true;
+        cloidLo = cloid & mask64;
+        cloidHi = (cloid >> 64n) & mask64;
+    }
+    // Builder carve. Validate fee + address shape on the TS side so a
+    // malformed carve fails loudly here rather than encoding silently —
+    // an unsigned or dropped builder would be worse than a thrown error.
+    let hasBuilder = false;
+    let builderFee = 0;
+    let builderUser = EMPTY_BYTES;
+    if (builder !== undefined) {
+        if (!Number.isInteger(builder.fee) || builder.fee < 0 || builder.fee > 0xffff) {
+            throw new RangeError('builder.fee must be a u16 (0..=65535) in basis points');
+        }
+        builderUser = addressHexToBytes(builder.user);
+        hasBuilder = true;
+        builderFee = builder.fee;
+    }
+    const wasm = await loadWasm();
+    const out = wasm.encode_limit_order(asset, side, sizeLo, sizeHi, priceLo, priceHi, tif, stp, hasCloid, cloidLo, cloidHi, reduceOnly, hasBuilder, builderFee, builderUser);
+    if (out.length === 0) {
+        throw new WasmCallError('encode_limit_order', 'msgpack encoder failed (invalid builder address length?)');
+    }
+    return out;
+}
+/// Shared empty buffer for the no-builder fast path — avoids allocating a
+/// fresh zero-length `Uint8Array` per call.
+const EMPTY_BYTES = new Uint8Array(0);
+/// Parse a `0x`-prefixed (or bare) 40-char hex address into 20 raw bytes.
+/// Mirrors `core_state::address::Address::from_hex`. Throws on any
+/// non-hex char or wrong length — a malformed builder address must never
+/// reach the signed body.
+function addressHexToBytes(addr) {
+    const hex = addr.startsWith('0x') ? addr.slice(2) : addr;
+    if (hex.length !== 40) {
+        throw new RangeError(`builder.user must be a 20-byte (40 hex char) address, got '${addr}'`);
+    }
+    // Whole-string hex check up front — `parseInt('1z', 16)` would silently
+    // return 1, so per-byte parsing alone could mask a malformed char.
+    if (!/^[0-9a-fA-F]{40}$/.test(hex)) {
+        throw new RangeError(`builder.user contains a non-hex character: '${addr}'`);
+    }
+    const out = new Uint8Array(20);
+    for (let i = 0; i < 20; i++) {
+        out[i] = Number.parseInt(hex.slice(i * 2, i * 2 + 2), 16);
+    }
+    return out;
+}
+/// Derive the standard 20-byte EVM address from a SEC1 public key.
+/// Accepts 33-byte compressed, 64-byte raw x||y, or 65-byte
+/// uncompressed `0x04 || x || y`.
+export async function deriveAddressFromPubkey(pubkey) {
+    const wasm = await loadWasm();
+    const out = wasm.derive_address_from_pubkey(pubkey);
+    if (out.length !== 20) {
+        throw new WasmCallError('derive_address_from_pubkey', 'malformed pubkey (expected 33, 64, or 65 bytes)');
+    }
+    return out;
+}
+//# sourceMappingURL=wasm.js.map

package/dist/wasm.js.map

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

package/dist/ws.d.ts

@@ -0,0 +1,43 @@
+export type WsChannel = 'l2Book' | 'trades' | 'bbo' | 'fills' | 'candles' | 'userEvents';
+export declare const WS_CHANNELS: readonly WsChannel[];
+export interface WsSubscription {
+    type: WsChannel;
+    coin?: string;
+}
+export interface WsFrame {
+    channel: string;
+    data: unknown;
+}
+export type WsMessageHandler = (frame: WsFrame) => void;
+export interface WsConfig {
+    pingIntervalMs: number;
+    initialBackoffMs: number;
+    maxBackoffMs: number;
+    autoReconnect: boolean;
+}
+export declare class WsClient {
+    private readonly url;
+    private readonly config;
+    private socket;
+    private readonly active;
+    private readonly handlers;
+    private pingTimer;
+    private reconnectTimer;
+    private backoffMs;
+    private closed;
+    constructor(url: string, config?: Partial<WsConfig>);
+    onMessage(handler: WsMessageHandler): () => void;
+    connect(): Promise<void>;
+    subscribe(sub: WsSubscription): Promise<void>;
+    unsubscribe(sub: WsSubscription): Promise<void>;
+    get isOpen(): boolean;
+    close(): void;
+    private openOnce;
+    private scheduleReconnect;
+    private startPing;
+    private send;
+    private dispatch;
+    private clearTimers;
+    private clearPing;
+}
+//# sourceMappingURL=ws.d.ts.map

package/dist/ws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../src/ws.ts"],"names":[],"mappings":"AAuBA,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,QAAQ,GACR,KAAK,GACL,OAAO,GACP,SAAS,GACT,YAAY,CAAC;AAGjB,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAOlC,CAAC;AAKX,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAOD,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CACf;AAGD,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;AAGxD,MAAM,WAAW,QAAQ;IAEvB,cAAc,EAAE,MAAM,CAAC;IAEvB,gBAAgB,EAAE,MAAM,CAAC;IAEzB,YAAY,EAAE,MAAM,CAAC;IAErB,aAAa,EAAE,OAAO,CAAC;CACxB;AA6BD,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,MAAM,CAAwB;IAEtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0B;IACnD,OAAO,CAAC,SAAS,CAA6C;IAC9D,OAAO,CAAC,cAAc,CAA4C;IAClE,OAAO,CAAC,SAAS,CAAS;IAE1B,OAAO,CAAC,MAAM,CAAS;gBAEX,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,CAAC,QAAQ,CAAM;IAWvD,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,IAAI;IAW1C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQxB,SAAS,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7C,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrD,IAAI,MAAM,IAAI,OAAO,CAEpB;IAID,KAAK,IAAI,IAAI;IAeb,OAAO,CAAC,QAAQ;IAuChB,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,IAAI;IAQZ,OAAO,CAAC,QAAQ;IAchB,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,SAAS;CAMlB"}