@symmio/trading-core 0.1.0

package/dist/transfers/get-transfer-history/query-document.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Internal-transfer history over the **events** subgraph's `internalTransfers`
+ * collection (raw on-chain transfer events). Filtered server-side by
+ * `sender_in` / `user_in` (the `or` group selects outgoing and/or incoming
+ * relative to the queried accounts) and a `blockTimestamp` range; sorted by
+ * `blockTimestamp`.
+ *
+ * The events subgraph forbids mixing column filters with `or` at the same level,
+ * so the `blockTimestamp` bounds are repeated INSIDE each `or` branch (i.e.
+ * `(sender_in AND time) OR (user_in AND time)`) rather than alongside the `or`.
+ *
+ * `sender` / `user` are `Bytes` scalars (the codegen `Bytes` scalar is a plain
+ * string, so lowercased addresses pass straight through). `amount` is 18-decimal
+ * (account-balance units), unlike the 6-decimal collateral amounts on
+ * `balanceChanges`. Compiles to a typed query string via graphql-codegen against
+ * the events schema.
+ */
+export declare const InternalTransfersDocument: import('../../symmio-subgraph/types/generated/events/graphql').TypedDocumentString<import('../../symmio-subgraph/types/generated/events/graphql').TransferHistoryQuery, {
+    senders: Array<string> | string;
+    users: Array<string> | string;
+    first: number;
+    skip: number;
+    orderDirection: import('../../symmio-subgraph/types/generated/events/graphql').OrderDirection;
+    startDate: string;
+    endDate: string;
+}>;
+//# sourceMappingURL=query-document.d.ts.map

package/dist/transfers/get-transfer-history/query-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-document.d.ts","sourceRoot":"","sources":["../../../src/transfers/get-transfer-history/query-document.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;EA8BpC,CAAC"}

package/dist/transfers/get-transfer-history/query-document.js

@@ -0,0 +1,7 @@
+import { graphql as e } from "../../symmio-subgraph/types/generated/events/gql.js";
+//#region src/transfers/get-transfer-history/query-document.ts
+var t = e("\n  query TransferHistory(\n    $senders: [Bytes!]!\n    $users: [Bytes!]!\n    $first: Int!\n    $skip: Int!\n    $orderDirection: OrderDirection!\n    $startDate: BigInt!\n    $endDate: BigInt!\n  ) {\n    internalTransfers(\n      first: $first\n      skip: $skip\n      orderBy: blockTimestamp\n      orderDirection: $orderDirection\n      where: {\n        or: [\n          { sender_in: $senders, blockTimestamp_gte: $startDate, blockTimestamp_lte: $endDate }\n          { user_in: $users, blockTimestamp_gte: $startDate, blockTimestamp_lte: $endDate }\n        ]\n      }\n    ) {\n      id\n      sender\n      user\n      amount\n      blockTimestamp\n      transactionHash\n    }\n  }\n");
+//#endregion
+export { t as InternalTransfersDocument };
+
+//# sourceMappingURL=query-document.js.map

package/dist/transfers/get-transfer-history/query-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-document.js","names":[],"sources":["../../../src/transfers/get-transfer-history/query-document.ts"],"sourcesContent":["/**\n * Events-schema `graphql()` factory. NOTE: events operations must live under\n * `src/transfers/**` — codegen routes the two subgraph schemas by file path, not\n * by which `graphql` is imported. See `packages/trading-core/codegen.ts`.\n */\nimport { graphql } from \"../../symmio-subgraph/types/generated/events\";\n\n/**\n * Internal-transfer history over the **events** subgraph's `internalTransfers`\n * collection (raw on-chain transfer events). Filtered server-side by\n * `sender_in` / `user_in` (the `or` group selects outgoing and/or incoming\n * relative to the queried accounts) and a `blockTimestamp` range; sorted by\n * `blockTimestamp`.\n *\n * The events subgraph forbids mixing column filters with `or` at the same level,\n * so the `blockTimestamp` bounds are repeated INSIDE each `or` branch (i.e.\n * `(sender_in AND time) OR (user_in AND time)`) rather than alongside the `or`.\n *\n * `sender` / `user` are `Bytes` scalars (the codegen `Bytes` scalar is a plain\n * string, so lowercased addresses pass straight through). `amount` is 18-decimal\n * (account-balance units), unlike the 6-decimal collateral amounts on\n * `balanceChanges`. Compiles to a typed query string via graphql-codegen against\n * the events schema.\n */\nexport const InternalTransfersDocument = graphql(`\n  query TransferHistory(\n    $senders: [Bytes!]!\n    $users: [Bytes!]!\n    $first: Int!\n    $skip: Int!\n    $orderDirection: OrderDirection!\n    $startDate: BigInt!\n    $endDate: BigInt!\n  ) {\n    internalTransfers(\n      first: $first\n      skip: $skip\n      orderBy: blockTimestamp\n      orderDirection: $orderDirection\n      where: {\n        or: [\n          { sender_in: $senders, blockTimestamp_gte: $startDate, blockTimestamp_lte: $endDate }\n          { user_in: $users, blockTimestamp_gte: $startDate, blockTimestamp_lte: $endDate }\n        ]\n      }\n    ) {\n      id\n      sender\n      user\n      amount\n      blockTimestamp\n      transactionHash\n    }\n  }\n`);\n"],"mappings":";;AAwBA,IAAa,IAA4B,EAAQ,yrBA8BhD"}

package/dist/transfers/get-transfer-history/query.d.ts

@@ -0,0 +1,38 @@
+import { Config } from '../../core/config';
+import { Compute, ConfigKeyParameter } from '../../shared/types/properties';
+import { QueryParameter, SymmioQueryOptions } from '../../shared/types/query';
+import { GetTransferHistoryParameters, GetTransferHistoryReturnType } from './get-transfer-history';
+/** Data resolved by the {@link getTransferHistoryQueryOptions} query. */
+export type GetTransferHistoryData = GetTransferHistoryReturnType;
+/**
+ * Build the TanStack Query key for {@link getTransferHistoryQueryOptions}.
+ *
+ * @param options - Query parameters (accounts, direction, paging, time range, chain id, config key).
+ * @returns A stable, hashable query key.
+ */
+export declare function getTransferHistoryQueryKey(options: Compute<GetTransferHistoryParameters & ConfigKeyParameter>): readonly ["getTransferHistory", Record<string, unknown>];
+/** Query-key type produced by {@link getTransferHistoryQueryKey}. */
+export type GetTransferHistoryQueryKey = ReturnType<typeof getTransferHistoryQueryKey>;
+/**
+ * Options accepted by {@link getTransferHistoryQueryOptions}: the action's
+ * parameters plus TanStack overrides.
+ */
+export type GetTransferHistoryOptions = Compute<GetTransferHistoryParameters & QueryParameter<GetTransferHistoryData, Error, GetTransferHistoryData, GetTransferHistoryQueryKey>>;
+/** TanStack Query options returned by {@link getTransferHistoryQueryOptions}. */
+export type GetTransferHistoryQueryOptions = SymmioQueryOptions<GetTransferHistoryData, Error, GetTransferHistoryData, GetTransferHistoryQueryKey>;
+/**
+ * Build TanStack Query options for {@link getTransferHistory}. Pass
+ * `query.refetchInterval` to poll; the query is disabled until at least one
+ * `account` is supplied.
+ *
+ * @param config - The SDK config.
+ * @param options - Query parameters and TanStack overrides.
+ * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.
+ *
+ * @example
+ * ```ts
+ * useQuery(getTransferHistoryQueryOptions(config, { accounts: ["0xsub…"], direction: "outgoing" }));
+ * ```
+ */
+export declare function getTransferHistoryQueryOptions(config: Config, options: GetTransferHistoryOptions): GetTransferHistoryQueryOptions;
+//# sourceMappingURL=query.d.ts.map

package/dist/transfers/get-transfer-history/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/transfers/get-transfer-history/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnF,OAAO,EAEL,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,EAClC,MAAM,wBAAwB,CAAC;AAEhC,yEAAyE;AACzE,MAAM,MAAM,sBAAsB,GAAG,4BAA4B,CAAC;AAElE;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,CAAC,4BAA4B,GAAG,kBAAkB,CAAC,4DAE7G;AAED,qEAAqE;AACrE,MAAM,MAAM,0BAA0B,GAAG,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEvF;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAC7C,4BAA4B,GAC1B,cAAc,CAAC,sBAAsB,EAAE,KAAK,EAAE,sBAAsB,EAAE,0BAA0B,CAAC,CACpG,CAAC;AAEF,iFAAiF;AACjF,MAAM,MAAM,8BAA8B,GAAG,kBAAkB,CAC7D,sBAAsB,EACtB,KAAK,EACL,sBAAsB,EACtB,0BAA0B,CAC3B,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,yBAAyB,GACjC,8BAA8B,CAoBhC"}

package/dist/transfers/get-transfer-history/query.js

@@ -0,0 +1,30 @@
+import { filterQueryOptions as e } from "../../shared/utils/query.js";
+import { getTransferHistory as t } from "./get-transfer-history.js";
+//#region src/transfers/get-transfer-history/query.ts
+function n(t) {
+	return ["getTransferHistory", e(t)];
+}
+function r(e, r) {
+	return {
+		...r.query,
+		queryKey: n({
+			...r,
+			configKey: e.getChainConfigKey(r.chainId)
+		}),
+		enabled: (r.query?.enabled ?? !0) && r.accounts.length > 0,
+		queryFn: () => t(e, {
+			chainId: r.chainId,
+			accounts: r.accounts,
+			direction: r.direction,
+			first: r.first,
+			skip: r.skip,
+			startTime: r.startTime,
+			endTime: r.endTime,
+			orderDirection: r.orderDirection
+		})
+	};
+}
+//#endregion
+export { n as getTransferHistoryQueryKey, r as getTransferHistoryQueryOptions };
+
+//# sourceMappingURL=query.js.map

package/dist/transfers/get-transfer-history/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../../src/transfers/get-transfer-history/query.ts"],"sourcesContent":["import type { Config } from \"../../core/config\";\nimport type { Compute, ConfigKeyParameter } from \"../../shared/types/properties\";\nimport type { QueryParameter, SymmioQueryOptions } from \"../../shared/types/query\";\nimport { filterQueryOptions } from \"../../shared/utils/query\";\nimport {\n  getTransferHistory,\n  type GetTransferHistoryParameters,\n  type GetTransferHistoryReturnType,\n} from \"./get-transfer-history\";\n\n/** Data resolved by the {@link getTransferHistoryQueryOptions} query. */\nexport type GetTransferHistoryData = GetTransferHistoryReturnType;\n\n/**\n * Build the TanStack Query key for {@link getTransferHistoryQueryOptions}.\n *\n * @param options - Query parameters (accounts, direction, paging, time range, chain id, config key).\n * @returns A stable, hashable query key.\n */\nexport function getTransferHistoryQueryKey(options: Compute<GetTransferHistoryParameters & ConfigKeyParameter>) {\n  return [\"getTransferHistory\", filterQueryOptions(options)] as const;\n}\n\n/** Query-key type produced by {@link getTransferHistoryQueryKey}. */\nexport type GetTransferHistoryQueryKey = ReturnType<typeof getTransferHistoryQueryKey>;\n\n/**\n * Options accepted by {@link getTransferHistoryQueryOptions}: the action's\n * parameters plus TanStack overrides.\n */\nexport type GetTransferHistoryOptions = Compute<\n  GetTransferHistoryParameters &\n    QueryParameter<GetTransferHistoryData, Error, GetTransferHistoryData, GetTransferHistoryQueryKey>\n>;\n\n/** TanStack Query options returned by {@link getTransferHistoryQueryOptions}. */\nexport type GetTransferHistoryQueryOptions = SymmioQueryOptions<\n  GetTransferHistoryData,\n  Error,\n  GetTransferHistoryData,\n  GetTransferHistoryQueryKey\n>;\n\n/**\n * Build TanStack Query options for {@link getTransferHistory}. Pass\n * `query.refetchInterval` to poll; the query is disabled until at least one\n * `account` is supplied.\n *\n * @param config - The SDK config.\n * @param options - Query parameters and TanStack overrides.\n * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.\n *\n * @example\n * ```ts\n * useQuery(getTransferHistoryQueryOptions(config, { accounts: [\"0xsub…\"], direction: \"outgoing\" }));\n * ```\n */\nexport function getTransferHistoryQueryOptions(\n  config: Config,\n  options: GetTransferHistoryOptions,\n): GetTransferHistoryQueryOptions {\n  return {\n    ...options.query,\n    queryKey: getTransferHistoryQueryKey({\n      ...options,\n      configKey: config.getChainConfigKey(options.chainId),\n    }),\n    enabled: (options.query?.enabled ?? true) && options.accounts.length > 0,\n    queryFn: () =>\n      getTransferHistory(config, {\n        chainId: options.chainId,\n        accounts: options.accounts,\n        direction: options.direction,\n        first: options.first,\n        skip: options.skip,\n        startTime: options.startTime,\n        endTime: options.endTime,\n        orderDirection: options.orderDirection,\n      }),\n  };\n}\n"],"mappings":";;;AAmBA,SAAgB,EAA2B,GAAqE;CAC9G,OAAO,CAAC,sBAAsB,EAAmB,CAAO,CAAC;AAC3D;AAoCA,SAAgB,EACd,GACA,GACgC;CAChC,OAAO;EACL,GAAG,EAAQ;EACX,UAAU,EAA2B;GACnC,GAAG;GACH,WAAW,EAAO,kBAAkB,EAAQ,OAAO;EACrD,CAAC;EACD,UAAU,EAAQ,OAAO,WAAW,OAAS,EAAQ,SAAS,SAAS;EACvE,eACE,EAAmB,GAAQ;GACzB,SAAS,EAAQ;GACjB,UAAU,EAAQ;GAClB,WAAW,EAAQ;GACnB,OAAO,EAAQ;GACf,MAAM,EAAQ;GACd,WAAW,EAAQ;GACnB,SAAS,EAAQ;GACjB,gBAAgB,EAAQ;EAC1B,CAAC;CACL;AACF"}

package/dist/transfers/get-transfer-history/to-transfer-row.d.ts

@@ -0,0 +1,16 @@
+import { TransferHistoryQuery } from '../../symmio-subgraph/types/generated/events/graphql';
+import { TransferRow } from './types';
+/** A single `internalTransfers` row as returned by the transfer-history query. */
+export type RawInternalTransferRow = TransferHistoryQuery["internalTransfers"][number];
+/**
+ * Build a {@link TransferRow} from one `internalTransfers` row: parse the wei
+ * `amount` / `blockTimestamp` strings, checksum the endpoints, and tag the
+ * direction. A row is `"outgoing"` when its `sender` is one of the queried
+ * accounts, otherwise `"incoming"` (the account matched on the `user` side).
+ *
+ * @param row - One `internalTransfers` row from {@link "InternalTransfersDocument"}.
+ * @param accountSet - The queried account addresses, lowercased, for direction tagging.
+ * @returns The decoded transfer row.
+ */
+export declare function toTransferRow(row: RawInternalTransferRow, accountSet: ReadonlySet<string>): TransferRow;
+//# sourceMappingURL=to-transfer-row.d.ts.map

package/dist/transfers/get-transfer-history/to-transfer-row.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-transfer-row.d.ts","sourceRoot":"","sources":["../../../src/transfers/get-transfer-history/to-transfer-row.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sDAAsD,CAAC;AACjG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,kFAAkF;AAClF,MAAM,MAAM,sBAAsB,GAAG,oBAAoB,CAAC,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvF;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,sBAAsB,EAAE,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,WAAW,CAUvG"}

package/dist/transfers/get-transfer-history/to-transfer-row.js

@@ -0,0 +1,17 @@
+import { getAddress as e } from "viem";
+//#region src/transfers/get-transfer-history/to-transfer-row.ts
+function t(t, n) {
+	return {
+		id: t.id,
+		from: e(t.sender),
+		to: e(t.user),
+		amount: BigInt(t.amount),
+		timestamp: Number(t.blockTimestamp),
+		transaction: t.transactionHash,
+		direction: n.has(t.sender.toLowerCase()) ? "outgoing" : "incoming"
+	};
+}
+//#endregion
+export { t as toTransferRow };
+
+//# sourceMappingURL=to-transfer-row.js.map

package/dist/transfers/get-transfer-history/to-transfer-row.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-transfer-row.js","names":[],"sources":["../../../src/transfers/get-transfer-history/to-transfer-row.ts"],"sourcesContent":["import { getAddress, type Hex } from \"viem\";\nimport type { TransferHistoryQuery } from \"../../symmio-subgraph/types/generated/events/graphql\";\nimport type { TransferRow } from \"./types\";\n\n/** A single `internalTransfers` row as returned by the transfer-history query. */\nexport type RawInternalTransferRow = TransferHistoryQuery[\"internalTransfers\"][number];\n\n/**\n * Build a {@link TransferRow} from one `internalTransfers` row: parse the wei\n * `amount` / `blockTimestamp` strings, checksum the endpoints, and tag the\n * direction. A row is `\"outgoing\"` when its `sender` is one of the queried\n * accounts, otherwise `\"incoming\"` (the account matched on the `user` side).\n *\n * @param row - One `internalTransfers` row from {@link \"InternalTransfersDocument\"}.\n * @param accountSet - The queried account addresses, lowercased, for direction tagging.\n * @returns The decoded transfer row.\n */\nexport function toTransferRow(row: RawInternalTransferRow, accountSet: ReadonlySet<string>): TransferRow {\n  return {\n    id: row.id,\n    from: getAddress(row.sender),\n    to: getAddress(row.user),\n    amount: BigInt(row.amount),\n    timestamp: Number(row.blockTimestamp),\n    transaction: row.transactionHash as Hex,\n    direction: accountSet.has(row.sender.toLowerCase()) ? \"outgoing\" : \"incoming\",\n  };\n}\n"],"mappings":";;AAiBA,SAAgB,EAAc,GAA6B,GAA8C;CACvG,OAAO;EACL,IAAI,EAAI;EACR,MAAM,EAAW,EAAI,MAAM;EAC3B,IAAI,EAAW,EAAI,IAAI;EACvB,QAAQ,OAAO,EAAI,MAAM;EACzB,WAAW,OAAO,EAAI,cAAc;EACpC,aAAa,EAAI;EACjB,WAAW,EAAW,IAAI,EAAI,OAAO,YAAY,CAAC,IAAI,aAAa;CACrE;AACF"}

package/dist/transfers/get-transfer-history/types.d.ts

@@ -0,0 +1,43 @@
+import { Address, Hex } from 'viem';
+/**
+ * Which transfers a {@link "getTransferHistory"} read returns, relative to the
+ * queried accounts. Maps to the `sender_in` / `user_in` halves of the subgraph
+ * `or` filter.
+ */
+export type TransferDirection = 
+/** Both directions — the queried account is the sender or the recipient. */
+"all"
+/** Only transfers sent FROM a queried account. */
+ | "outgoing"
+/** Only transfers received BY a queried account. */
+ | "incoming";
+/** Direction of a single {@link TransferRow} relative to the queried accounts. */
+export type TransferRowDirection = "outgoing" | "incoming";
+/**
+ * One internal transfer — a margin move between SYMMIO accounts, from the
+ * **events** subgraph's `internalTransfers` collection (the source behind a
+ * "Transfer" tab).
+ *
+ * @remarks
+ * `from` / `to` are the raw on-chain endpoints (SubAccount / Virtual Account
+ * addresses), not necessarily the controlling wallet. `amount` is a raw `bigint`
+ * in **18 decimals** (account-balance units) — NOT the 6-decimal collateral units
+ * used by `BalanceHistoryRow`; divide by `10^18` for display.
+ */
+export interface TransferRow {
+    /** Subgraph entity id (use as a stable row key). */
+    id: string;
+    /** Sender (the `from` endpoint), checksummed. */
+    from: Address;
+    /** Recipient (the `to` endpoint), checksummed. */
+    to: Address;
+    /** Amount, raw `bigint` in 18 decimals. */
+    amount: bigint;
+    /** Block timestamp, unix seconds. */
+    timestamp: number;
+    /** Transaction hash of the transfer. */
+    transaction: Hex;
+    /** Whether this transfer is outgoing or incoming relative to the queried accounts. */
+    direction: TransferRowDirection;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/transfers/get-transfer-history/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/transfers/get-transfer-history/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAEzC;;;;GAIG;AACH,MAAM,MAAM,iBAAiB;AAC3B,4EAA4E;AAC1E,KAAK;AACP,kDAAkD;GAChD,UAAU;AACZ,oDAAoD;GAClD,UAAU,CAAC;AAEf,kFAAkF;AAClF,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,UAAU,CAAC;AAE3D;;;;;;;;;;GAUG;AACH,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,iDAAiD;IACjD,IAAI,EAAE,OAAO,CAAC;IACd,kDAAkD;IAClD,EAAE,EAAE,OAAO,CAAC;IACZ,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,WAAW,EAAE,GAAG,CAAC;IACjB,sFAAsF;IACtF,SAAS,EAAE,oBAAoB,CAAC;CACjC"}

package/dist/transfers/index.d.ts

@@ -0,0 +1,2 @@
+export * from './get-transfer-history';
+//# sourceMappingURL=index.d.ts.map

package/dist/transfers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transfers/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC"}

package/dist/websocket/index.d.ts

@@ -0,0 +1,4 @@
+export * from './notifications';
+export * from './prices';
+export * from './socket';
+//# sourceMappingURL=index.d.ts.map

package/dist/websocket/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/websocket/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}

package/dist/websocket/notifications/build-subscribe-message.d.ts

@@ -0,0 +1,24 @@
+import { Address } from 'viem';
+import { SymmioNotificationsProtocol } from '../../core/chains';
+/**
+ * Inputs for {@link buildSubscribeMessage}.
+ */
+export interface BuildSubscribeMessageParameters {
+    /** SubAccount address to subscribe for. */
+    account: Address;
+    /** Channel / `app_name` configured for the endpoint. */
+    channel: string;
+    /** Wire protocol the endpoint speaks. */
+    protocol: SymmioNotificationsProtocol;
+}
+/**
+ * Build the subscribe frame to send on (re)connect for a notifications endpoint.
+ *
+ * For `defilytics`, this is a `channel_patterns` frame scoped to the account
+ * with wildcard identifiers (every quote id for the account).
+ *
+ * @returns The frame serialized as a JSON string, ready to send.
+ * @throws {SymmError} for an unsupported protocol.
+ */
+export declare function buildSubscribeMessage(parameters: BuildSubscribeMessageParameters): string;
+//# sourceMappingURL=build-subscribe-message.d.ts.map

package/dist/websocket/notifications/build-subscribe-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-subscribe-message.d.ts","sourceRoot":"","sources":["../../../src/websocket/notifications/build-subscribe-message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAGrE;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,QAAQ,EAAE,2BAA2B,CAAC;CACvC;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,+BAA+B,GAAG,MAAM,CAoBzF"}

package/dist/websocket/notifications/build-subscribe-message.js

@@ -0,0 +1,17 @@
+import { SymmError as e } from "../../shared/errors/symm-error.js";
+//#region src/websocket/notifications/build-subscribe-message.ts
+function t(t) {
+	switch (t.protocol) {
+		case "defilytics": return JSON.stringify({ channel_patterns: [{
+			app_name: t.channel,
+			address: t.account,
+			primary_identifier: "*",
+			secondary_identifier: "*"
+		}] });
+		default: throw new e("config", "UNSUPPORTED_NOTIFICATIONS_PROTOCOL", `Unsupported notifications protocol: ${t.protocol}`);
+	}
+}
+//#endregion
+export { t as buildSubscribeMessage };
+
+//# sourceMappingURL=build-subscribe-message.js.map

package/dist/websocket/notifications/build-subscribe-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-subscribe-message.js","names":[],"sources":["../../../src/websocket/notifications/build-subscribe-message.ts"],"sourcesContent":["import type { Address } from \"viem\";\nimport type { SymmioNotificationsProtocol } from \"../../core/chains\";\nimport { SymmError } from \"../../shared/errors/symm-error\";\n\n/**\n * Inputs for {@link buildSubscribeMessage}.\n */\nexport interface BuildSubscribeMessageParameters {\n  /** SubAccount address to subscribe for. */\n  account: Address;\n  /** Channel / `app_name` configured for the endpoint. */\n  channel: string;\n  /** Wire protocol the endpoint speaks. */\n  protocol: SymmioNotificationsProtocol;\n}\n\n/**\n * Build the subscribe frame to send on (re)connect for a notifications endpoint.\n *\n * For `defilytics`, this is a `channel_patterns` frame scoped to the account\n * with wildcard identifiers (every quote id for the account).\n *\n * @returns The frame serialized as a JSON string, ready to send.\n * @throws {SymmError} for an unsupported protocol.\n */\nexport function buildSubscribeMessage(parameters: BuildSubscribeMessageParameters): string {\n  switch (parameters.protocol) {\n    case \"defilytics\":\n      return JSON.stringify({\n        channel_patterns: [\n          {\n            app_name: parameters.channel,\n            address: parameters.account,\n            primary_identifier: \"*\",\n            secondary_identifier: \"*\",\n          },\n        ],\n      });\n    default:\n      throw new SymmError(\n        \"config\",\n        \"UNSUPPORTED_NOTIFICATIONS_PROTOCOL\",\n        `Unsupported notifications protocol: ${parameters.protocol}`,\n      );\n  }\n}\n"],"mappings":";;AAyBA,SAAgB,EAAsB,GAAqD;CACzF,QAAQ,EAAW,UAAnB;EACE,KAAK,cACH,OAAO,KAAK,UAAU,EACpB,kBAAkB,CAChB;GACE,UAAU,EAAW;GACrB,SAAS,EAAW;GACpB,oBAAoB;GACpB,sBAAsB;EACxB,CACF,EACF,CAAC;EACH,SACE,MAAM,IAAI,EACR,UACA,sCACA,uCAAuC,EAAW,UACpD;CACJ;AACF"}

package/dist/websocket/notifications/index.d.ts

@@ -0,0 +1,6 @@
+export * from './build-subscribe-message';
+export * from './normalize-notification';
+export * from './parse-notification-frame';
+export * from './types';
+export * from './watch-notifications';
+//# sourceMappingURL=index.d.ts.map

package/dist/websocket/notifications/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/websocket/notifications/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,SAAS,CAAC;AACxB,cAAc,uBAAuB,CAAC"}

package/dist/websocket/notifications/normalize-notification.d.ts

@@ -0,0 +1,17 @@
+import { NotificationType, Notification, RawPositionNotification } from './types';
+/**
+ * Classify a raw `action_status` into a {@link NotificationType}. Unknown or
+ * missing statuses are treated as {@link NotificationType.FAILED}.
+ *
+ * @param actionStatus - The raw `action_status` field.
+ */
+export declare function classifyNotification(actionStatus: string | null): NotificationType;
+/**
+ * Normalize a raw wire frame into a {@link Notification}: camelCase fields, a
+ * resolved `quoteId` (on-chain id when present, else the temp id), and a
+ * classified `type`.
+ *
+ * @param raw - The raw position-state frame.
+ */
+export declare function normalizeNotification(raw: RawPositionNotification): Notification;
+//# sourceMappingURL=normalize-notification.d.ts.map

package/dist/websocket/notifications/normalize-notification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-notification.d.ts","sourceRoot":"","sources":["../../../src/websocket/notifications/normalize-notification.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,gBAAgB,EAAE,KAAK,YAAY,EAAE,KAAK,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAE1G;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,gBAAgB,CAWlF;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,uBAAuB,GAAG,YAAY,CAyBhF"}

package/dist/websocket/notifications/normalize-notification.js

@@ -0,0 +1,39 @@
+import { ActionStatus as e, NotificationType as t } from "./types.js";
+//#region src/websocket/notifications/normalize-notification.ts
+function n(n) {
+	switch (n) {
+		case e.SUCCESS: return t.SUCCESS;
+		case e.SEEN: return t.SEEN;
+		case e.FAILED: return t.FAILED;
+		default: return t.FAILED;
+	}
+}
+function r(e) {
+	let t = (!e.quote_id || e.quote_id === 0 ? e.temp_quote_id : e.quote_id) || 0;
+	return {
+		id: e.id ?? "",
+		quoteId: `${t}`,
+		tempQuoteId: e.temp_quote_id ?? 0,
+		type: n(e.action_status ?? null),
+		actionStatus: e.action_status ?? null,
+		lastSeenAction: e.last_seen_action ?? null,
+		account: e.address ?? null,
+		vaAddress: e.va_address ?? null,
+		counterpartyAddress: e.counterparty_address ?? "",
+		filledAmountOpen: e.filled_amount_open ?? null,
+		filledAmountClose: e.filled_amount_close ?? null,
+		avgPriceOpen: e.avg_price_open ?? "",
+		avgPriceClose: e.avg_price_close ?? "",
+		failureType: e.failure_type ?? null,
+		failureMessage: e.failure_message ?? null,
+		errorCode: e.error_code ?? null,
+		stateType: e.state_type ?? null,
+		createTime: `${e.create_time ?? ""}`,
+		modifyTime: `${e.modify_time ?? ""}`,
+		raw: e
+	};
+}
+//#endregion
+export { n as classifyNotification, r as normalizeNotification };
+
+//# sourceMappingURL=normalize-notification.js.map

package/dist/websocket/notifications/normalize-notification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-notification.js","names":[],"sources":["../../../src/websocket/notifications/normalize-notification.ts"],"sourcesContent":["import { ActionStatus, NotificationType, type Notification, type RawPositionNotification } from \"./types\";\n\n/**\n * Classify a raw `action_status` into a {@link NotificationType}. Unknown or\n * missing statuses are treated as {@link NotificationType.FAILED}.\n *\n * @param actionStatus - The raw `action_status` field.\n */\nexport function classifyNotification(actionStatus: string | null): NotificationType {\n  switch (actionStatus) {\n    case ActionStatus.SUCCESS:\n      return NotificationType.SUCCESS;\n    case ActionStatus.SEEN:\n      return NotificationType.SEEN;\n    case ActionStatus.FAILED:\n      return NotificationType.FAILED;\n    default:\n      return NotificationType.FAILED;\n  }\n}\n\n/**\n * Normalize a raw wire frame into a {@link Notification}: camelCase fields, a\n * resolved `quoteId` (on-chain id when present, else the temp id), and a\n * classified `type`.\n *\n * @param raw - The raw position-state frame.\n */\nexport function normalizeNotification(raw: RawPositionNotification): Notification {\n  const resolvedQuoteId = (!raw.quote_id || raw.quote_id === 0 ? raw.temp_quote_id : raw.quote_id) || 0;\n\n  return {\n    id: raw.id ?? \"\",\n    quoteId: `${resolvedQuoteId}`,\n    tempQuoteId: raw.temp_quote_id ?? 0,\n    type: classifyNotification(raw.action_status ?? null),\n    actionStatus: raw.action_status ?? null,\n    lastSeenAction: raw.last_seen_action ?? null,\n    account: raw.address ?? null,\n    vaAddress: raw.va_address ?? null,\n    counterpartyAddress: raw.counterparty_address ?? \"\",\n    filledAmountOpen: raw.filled_amount_open ?? null,\n    filledAmountClose: raw.filled_amount_close ?? null,\n    avgPriceOpen: raw.avg_price_open ?? \"\",\n    avgPriceClose: raw.avg_price_close ?? \"\",\n    failureType: raw.failure_type ?? null,\n    failureMessage: raw.failure_message ?? null,\n    errorCode: raw.error_code ?? null,\n    stateType: raw.state_type ?? null,\n    createTime: `${raw.create_time ?? \"\"}`,\n    modifyTime: `${raw.modify_time ?? \"\"}`,\n    raw,\n  };\n}\n"],"mappings":";;AAQA,SAAgB,EAAqB,GAA+C;CAClF,QAAQ,GAAR;EACE,KAAK,EAAa,SAChB,OAAO,EAAiB;EAC1B,KAAK,EAAa,MAChB,OAAO,EAAiB;EAC1B,KAAK,EAAa,QAChB,OAAO,EAAiB;EAC1B,SACE,OAAO,EAAiB;CAC5B;AACF;AASA,SAAgB,EAAsB,GAA4C;CAChF,IAAM,KAAmB,CAAC,EAAI,YAAY,EAAI,aAAa,IAAI,EAAI,gBAAgB,EAAI,aAAa;CAEpG,OAAO;EACL,IAAI,EAAI,MAAM;EACd,SAAS,GAAG;EACZ,aAAa,EAAI,iBAAiB;EAClC,MAAM,EAAqB,EAAI,iBAAiB,IAAI;EACpD,cAAc,EAAI,iBAAiB;EACnC,gBAAgB,EAAI,oBAAoB;EACxC,SAAS,EAAI,WAAW;EACxB,WAAW,EAAI,cAAc;EAC7B,qBAAqB,EAAI,wBAAwB;EACjD,kBAAkB,EAAI,sBAAsB;EAC5C,mBAAmB,EAAI,uBAAuB;EAC9C,cAAc,EAAI,kBAAkB;EACpC,eAAe,EAAI,mBAAmB;EACtC,aAAa,EAAI,gBAAgB;EACjC,gBAAgB,EAAI,mBAAmB;EACvC,WAAW,EAAI,cAAc;EAC7B,WAAW,EAAI,cAAc;EAC7B,YAAY,GAAG,EAAI,eAAe;EAClC,YAAY,GAAG,EAAI,eAAe;EAClC;CACF;AACF"}

package/dist/websocket/notifications/parse-notification-frame.d.ts

@@ -0,0 +1,15 @@
+import { SymmioNotificationsProtocol } from '../../core/chains';
+import { RawPositionNotification } from './types';
+/**
+ * Parse an inbound socket frame into a {@link RawPositionNotification}, or
+ * `null` when the frame is not a notification (control/ack frames, malformed
+ * JSON, or a missing payload — all skipped silently by the caller).
+ *
+ * For `defilytics`, the notification is unwrapped from its `{ data, address }`
+ * envelope and the top-level `address` is hoisted onto the frame.
+ *
+ * @param data - The raw `event.data` (a JSON string, or an already-parsed object).
+ * @param protocol - The endpoint's wire protocol.
+ */
+export declare function parseNotificationFrame(data: unknown, protocol: SymmioNotificationsProtocol): RawPositionNotification | null;
+//# sourceMappingURL=parse-notification-frame.d.ts.map

package/dist/websocket/notifications/parse-notification-frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-notification-frame.d.ts","sourceRoot":"","sources":["../../../src/websocket/notifications/parse-notification-frame.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAkC,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAEvF;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,2BAA2B,GACpC,uBAAuB,GAAG,IAAI,CAsBhC"}

package/dist/websocket/notifications/parse-notification-frame.js

@@ -0,0 +1,22 @@
+//#region src/websocket/notifications/parse-notification-frame.ts
+function e(e, t) {
+	let n = e;
+	if (typeof e == "string") try {
+		n = JSON.parse(e);
+	} catch {
+		return null;
+	}
+	if (!n || typeof n != "object") return null;
+	if (t === "defilytics") {
+		let e = n, t = e.data;
+		return !t || typeof t != "object" ? null : {
+			...t,
+			address: e.address ?? t.address
+		};
+	}
+	return n;
+}
+//#endregion
+export { e as parseNotificationFrame };
+
+//# sourceMappingURL=parse-notification-frame.js.map

package/dist/websocket/notifications/parse-notification-frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-notification-frame.js","names":[],"sources":["../../../src/websocket/notifications/parse-notification-frame.ts"],"sourcesContent":["import type { SymmioNotificationsProtocol } from \"../../core/chains\";\nimport type { DefilyticsNotificationEnvelope, RawPositionNotification } from \"./types\";\n\n/**\n * Parse an inbound socket frame into a {@link RawPositionNotification}, or\n * `null` when the frame is not a notification (control/ack frames, malformed\n * JSON, or a missing payload — all skipped silently by the caller).\n *\n * For `defilytics`, the notification is unwrapped from its `{ data, address }`\n * envelope and the top-level `address` is hoisted onto the frame.\n *\n * @param data - The raw `event.data` (a JSON string, or an already-parsed object).\n * @param protocol - The endpoint's wire protocol.\n */\nexport function parseNotificationFrame(\n  data: unknown,\n  protocol: SymmioNotificationsProtocol,\n): RawPositionNotification | null {\n  let parsed: unknown = data;\n  if (typeof data === \"string\") {\n    try {\n      parsed = JSON.parse(data);\n    } catch {\n      return null;\n    }\n  }\n  if (!parsed || typeof parsed !== \"object\") return null;\n\n  if (protocol === \"defilytics\") {\n    const envelope = parsed as Partial<DefilyticsNotificationEnvelope>;\n    const inner = envelope.data;\n    // A notification frame nests its payload under `data`; control/ack frames\n    // (no `data` object) are skipped. The payload itself may omit `id`.\n    if (!inner || typeof inner !== \"object\") return null;\n    return { ...inner, address: envelope.address ?? inner.address };\n  }\n\n  // Non-enveloped protocols deliver the notification frame directly.\n  return parsed as RawPositionNotification;\n}\n"],"mappings":";AAcA,SAAgB,EACd,GACA,GACgC;CAChC,IAAI,IAAkB;CACtB,IAAI,OAAO,KAAS,UAClB,IAAI;EACF,IAAS,KAAK,MAAM,CAAI;CAC1B,QAAQ;EACN,OAAO;CACT;CAEF,IAAI,CAAC,KAAU,OAAO,KAAW,UAAU,OAAO;CAElD,IAAI,MAAa,cAAc;EAC7B,IAAM,IAAW,GACX,IAAQ,EAAS;EAIvB,OADI,CAAC,KAAS,OAAO,KAAU,WAAiB,OACzC;GAAE,GAAG;GAAO,SAAS,EAAS,WAAW,EAAM;EAAQ;CAChE;CAGA,OAAO;AACT"}

package/dist/websocket/notifications/types.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Raw position-state notification frame as it arrives on the wire (snake_case),
+ * mirroring the hedger/solver payload. Consumers normally receive the
+ * normalized {@link Notification}; the raw frame is retained on it as `raw`.
+ *
+ * The endpoint omits fields that do not apply to a given frame (e.g. an
+ * `InstantRFQ` report carries no `id`), so almost every field is optional;
+ * {@link normalizeNotification} fills sensible defaults.
+ */
+export interface RawPositionNotification {
+    id?: string;
+    /** On-chain quote id, or `0` while the order is still off-chain. */
+    quote_id?: number;
+    /** Negative placeholder id assigned before the on-chain quote id exists. */
+    temp_quote_id?: number;
+    create_time?: number;
+    modify_time?: number;
+    counterparty_address?: string;
+    /** SubAccount address the notification belongs to. */
+    address?: string;
+    /** Solver-assigned Virtual Account address (lowcap), when present. */
+    va_address?: string;
+    filled_amount_open?: string | null;
+    filled_amount_close?: string | null;
+    /** Last solver action seen for this quote (e.g. `SendQuoteTransaction`). */
+    last_seen_action?: string | null;
+    /** `success` | `failed` | `seen`. */
+    action_status?: string | null;
+    failure_type?: string | null;
+    failure_message?: string | null;
+    error_code?: number | null;
+    /** `report` | `alert`. */
+    state_type?: string | null;
+    version?: number;
+    avg_price_open?: string;
+    avg_price_close?: string;
+}
+/**
+ * Envelope used by the `defilytics` endpoint: the notification is nested under
+ * `data`, with the SubAccount address hoisted to the top level.
+ */
+export interface DefilyticsNotificationEnvelope {
+    data: RawPositionNotification;
+    address: string;
+}
+/**
+ * The `action_status` values a notification can carry.
+ */
+export declare enum ActionStatus {
+    SUCCESS = "success",
+    FAILED = "failed",
+    SEEN = "seen"
+}
+/**
+ * Classification of a notification, derived from its {@link ActionStatus}.
+ * Unknown statuses are treated as {@link NotificationType.FAILED}.
+ */
+export declare enum NotificationType {
+    SUCCESS = "success",
+    FAILED = "failed",
+    SEEN = "seen"
+}
+/**
+ * A normalized, classified notification the SDK delivers to consumers.
+ *
+ * camelCase, with `quoteId` resolved to the on-chain id when available (falling
+ * back to the temp id), and `type` classified from `actionStatus`. The original
+ * wire frame is preserved on `raw` for advanced use.
+ */
+export interface Notification {
+    id: string;
+    /** On-chain quote id as a string, or the temp id when no on-chain id exists yet. */
+    quoteId: string;
+    /** The temp (pre-chain) quote id; negative until the on-chain id is assigned. */
+    tempQuoteId: number;
+    /** Classification derived from {@link Notification.actionStatus}. */
+    type: NotificationType;
+    /** Raw `action_status` (`success` | `failed` | `seen`), or `null`. */
+    actionStatus: string | null;
+    /** Last solver action seen for this quote. */
+    lastSeenAction: string | null;
+    /** SubAccount address this notification belongs to. */
+    account: string | null;
+    /** Solver-assigned Virtual Account address (lowcap), when present. */
+    vaAddress: string | null;
+    counterpartyAddress: string;
+    filledAmountOpen: string | null;
+    filledAmountClose: string | null;
+    avgPriceOpen: string;
+    avgPriceClose: string;
+    failureType: string | null;
+    failureMessage: string | null;
+    errorCode: number | null;
+    stateType: string | null;
+    createTime: string;
+    modifyTime: string;
+    /** The original wire frame. */
+    raw: RawPositionNotification;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/websocket/notifications/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/websocket/notifications/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,uBAAuB;IACtC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,qCAAqC;IACrC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,0BAA0B;IAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,uBAAuB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,oBAAY,YAAY;IACtB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,IAAI,SAAS;CACd;AAED;;;GAGG;AACH,oBAAY,gBAAgB;IAC1B,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,IAAI,SAAS;CACd;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,IAAI,EAAE,gBAAgB,CAAC;IACvB,sEAAsE;IACtE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,8CAA8C;IAC9C,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,uDAAuD;IACvD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,sEAAsE;IACtE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,GAAG,EAAE,uBAAuB,CAAC;CAC9B"}

package/dist/websocket/notifications/types.js

@@ -0,0 +1,10 @@
+//#region src/websocket/notifications/types.ts
+var e = /* @__PURE__ */ function(e) {
+	return e.SUCCESS = "success", e.FAILED = "failed", e.SEEN = "seen", e;
+}({}), t = /* @__PURE__ */ function(e) {
+	return e.SUCCESS = "success", e.FAILED = "failed", e.SEEN = "seen", e;
+}({});
+//#endregion
+export { e as ActionStatus, t as NotificationType };
+
+//# sourceMappingURL=types.js.map

package/dist/websocket/notifications/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../../../src/websocket/notifications/types.ts"],"sourcesContent":["/**\n * Raw position-state notification frame as it arrives on the wire (snake_case),\n * mirroring the hedger/solver payload. Consumers normally receive the\n * normalized {@link Notification}; the raw frame is retained on it as `raw`.\n *\n * The endpoint omits fields that do not apply to a given frame (e.g. an\n * `InstantRFQ` report carries no `id`), so almost every field is optional;\n * {@link normalizeNotification} fills sensible defaults.\n */\nexport interface RawPositionNotification {\n  id?: string;\n  /** On-chain quote id, or `0` while the order is still off-chain. */\n  quote_id?: number;\n  /** Negative placeholder id assigned before the on-chain quote id exists. */\n  temp_quote_id?: number;\n  create_time?: number;\n  modify_time?: number;\n  counterparty_address?: string;\n  /** SubAccount address the notification belongs to. */\n  address?: string;\n  /** Solver-assigned Virtual Account address (lowcap), when present. */\n  va_address?: string;\n  filled_amount_open?: string | null;\n  filled_amount_close?: string | null;\n  /** Last solver action seen for this quote (e.g. `SendQuoteTransaction`). */\n  last_seen_action?: string | null;\n  /** `success` | `failed` | `seen`. */\n  action_status?: string | null;\n  failure_type?: string | null;\n  failure_message?: string | null;\n  error_code?: number | null;\n  /** `report` | `alert`. */\n  state_type?: string | null;\n  version?: number;\n  avg_price_open?: string;\n  avg_price_close?: string;\n}\n\n/**\n * Envelope used by the `defilytics` endpoint: the notification is nested under\n * `data`, with the SubAccount address hoisted to the top level.\n */\nexport interface DefilyticsNotificationEnvelope {\n  data: RawPositionNotification;\n  address: string;\n}\n\n/**\n * The `action_status` values a notification can carry.\n */\nexport enum ActionStatus {\n  SUCCESS = \"success\",\n  FAILED = \"failed\",\n  SEEN = \"seen\",\n}\n\n/**\n * Classification of a notification, derived from its {@link ActionStatus}.\n * Unknown statuses are treated as {@link NotificationType.FAILED}.\n */\nexport enum NotificationType {\n  SUCCESS = \"success\",\n  FAILED = \"failed\",\n  SEEN = \"seen\",\n}\n\n/**\n * A normalized, classified notification the SDK delivers to consumers.\n *\n * camelCase, with `quoteId` resolved to the on-chain id when available (falling\n * back to the temp id), and `type` classified from `actionStatus`. The original\n * wire frame is preserved on `raw` for advanced use.\n */\nexport interface Notification {\n  id: string;\n  /** On-chain quote id as a string, or the temp id when no on-chain id exists yet. */\n  quoteId: string;\n  /** The temp (pre-chain) quote id; negative until the on-chain id is assigned. */\n  tempQuoteId: number;\n  /** Classification derived from {@link Notification.actionStatus}. */\n  type: NotificationType;\n  /** Raw `action_status` (`success` | `failed` | `seen`), or `null`. */\n  actionStatus: string | null;\n  /** Last solver action seen for this quote. */\n  lastSeenAction: string | null;\n  /** SubAccount address this notification belongs to. */\n  account: string | null;\n  /** Solver-assigned Virtual Account address (lowcap), when present. */\n  vaAddress: string | null;\n  counterpartyAddress: string;\n  filledAmountOpen: string | null;\n  filledAmountClose: string | null;\n  avgPriceOpen: string;\n  avgPriceClose: string;\n  failureType: string | null;\n  failureMessage: string | null;\n  errorCode: number | null;\n  stateType: string | null;\n  createTime: string;\n  modifyTime: string;\n  /** The original wire frame. */\n  raw: RawPositionNotification;\n}\n"],"mappings":";AAkDA,IAAY,IAAL,yBAAA,GAAA;QACL,EAAA,UAAA,WACA,EAAA,SAAA,UACA,EAAA,OAAA;AACF,EAAA,CAAA,CAAA,GAMY,IAAL,yBAAA,GAAA;QACL,EAAA,UAAA,WACA,EAAA,SAAA,UACA,EAAA,OAAA;AACF,EAAA,CAAA,CAAA"}

package/dist/websocket/notifications/watch-notifications.d.ts

@@ -0,0 +1,53 @@
+import { Address } from 'viem';
+import { Config } from '../../core/config';
+import { SymmError } from '../../shared/errors/symm-error';
+import { SocketStatus } from '../socket/socket-status';
+import { Notification } from './types';
+/**
+ * Stop a {@link watchNotifications} subscription. Idempotent; the shared socket
+ * closes once the last watcher on an endpoint+account releases.
+ */
+export type Unwatch = () => void;
+/**
+ * Parameters for {@link watchNotifications}.
+ */
+export interface WatchNotificationsParameters {
+    /** SubAccount address to subscribe for. */
+    account: Address;
+    /** Target chain id. Defaults to the config's `defaultChainId`. */
+    chainId?: number;
+    /** Called for every normalized notification frame. */
+    onNotification: (notification: Notification) => void;
+    /** Called whenever the underlying connection status changes. */
+    onStatusChange?: (status: SocketStatus) => void;
+    /** Called on a transport or parse error; does not stop the subscription. */
+    onError?: (error: SymmError) => void;
+}
+/**
+ * Subscribe to live position/quote state notifications for an account.
+ *
+ * Opens (or reuses) one reconnecting socket to the chain's notifications
+ * endpoint, sends the subscribe frame on every (re)connect, normalizes inbound
+ * frames into {@link Notification}s, and invokes the handlers. Watchers sharing
+ * the same endpoint+account share one socket; it closes when the last one
+ * unwatches.
+ *
+ * @param config - The SDK config.
+ * @param parameters - The account to watch and the handlers to invoke.
+ * @returns An unwatch function that releases this subscription.
+ * @throws {SymmError} synchronously when the chain is unsupported or no
+ *   `WebSocket` implementation is available.
+ *
+ * @example
+ * ```ts
+ * const unwatch = watchNotifications(config, {
+ *   account: "0xabc…",
+ *   onNotification: (n) => console.log(n.type, n.quoteId),
+ *   onStatusChange: (status) => console.log(status),
+ * });
+ * // later
+ * unwatch();
+ * ```
+ */
+export declare function watchNotifications(config: Config, parameters: WatchNotificationsParameters): Unwatch;
+//# sourceMappingURL=watch-notifications.d.ts.map

package/dist/websocket/notifications/watch-notifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-notifications.d.ts","sourceRoot":"","sources":["../../../src/websocket/notifications/watch-notifications.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAG3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAI5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC;AAEjC;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,cAAc,EAAE,CAAC,YAAY,EAAE,YAAY,KAAK,IAAI,CAAC;IACrD,gEAAgE;IAChE,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IAChD,4EAA4E;IAC5E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;CACtC;AAeD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,4BAA4B,GAAG,OAAO,CA4CpG"}