@symmio/trading-core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SYMMIO
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,67 @@
+# @symmio/trading-core
+
+Framework-agnostic SYMMIO SDK.
+
+This package wraps SYMMIO contract calls behind a small, typed API built on [viem](https://viem.sh). It has no framework dependencies — `@symmio/trading-react` (and future Vue / Solid layers) sit on top of it.
+
+## Status
+
+Early. This first slice ships the `AccountLayer` domain (v0.8.5) on HyperEVM with two methods:
+
+- `getUserSubAccounts(publicClient, params)` — list a user's subaccounts.
+- `editAccountName(walletClient, params)` — rename a subaccount.
+
+## Install
+
+```sh
+pnpm add @symmio/trading-core viem
+```
+
+`viem` is a peer dependency.
+
+## Usage
+
+### Free functions
+
+```ts
+import { createPublicClient, createWalletClient, http, custom } from "viem";
+import { hyperevm } from "viem/chains";
+import { getUserSubAccounts, editAccountName } from "@symmio/trading-core";
+
+const publicClient = createPublicClient({ chain: hyperevm, transport: http() });
+
+const subs = await getUserSubAccounts(publicClient, {
+  user: "0xabc...",
+  limit: 100n,
+});
+
+const walletClient = createWalletClient({
+  chain: hyperevm,
+  transport: custom(window.ethereum),
+});
+
+const hash = await editAccountName(walletClient, {
+  account: "0xsub...",
+  name: "My Trading Account",
+});
+```
+
+### viem actions
+
+Attach SDK methods to a viem client via `.extend()`:
+
+```ts
+import { accountLayerReadActions, accountLayerWriteActions } from "@symmio/trading-core";
+
+const reader = createPublicClient({ chain: hyperevm, transport: http() }).extend(accountLayerReadActions);
+
+await reader.getUserSubAccounts({ user: "0xabc..." });
+```
+
+## Documentation
+
+Full reference and concept docs: see `apps/docs` in the monorepo (or [the published docs site] once available).
+
+## Contributing
+
+See [`AGENTS.md`](./AGENTS.md) for package-specific rules and the repo-root [`AGENTS.md`](../../AGENTS.md) for monorepo conventions.

package/dist/balance-history/get-balance-history/balance-history-filter.d.ts

@@ -0,0 +1,8 @@
+import { BalanceChangeType, BalanceHistoryFilter } from './types';
+/**
+ * Map a {@link BalanceHistoryFilter} to the subgraph `BalanceChange.type` values
+ * it selects (the `type_in` clause of the history query). A withdraw filter
+ * includes bridge withdraws.
+ */
+export declare const balanceHistoryFilterToTypes: Record<BalanceHistoryFilter, readonly BalanceChangeType[]>;
+//# sourceMappingURL=balance-history-filter.d.ts.map

package/dist/balance-history/get-balance-history/balance-history-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance-history-filter.d.ts","sourceRoot":"","sources":["../../../src/balance-history/get-balance-history/balance-history-filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AASlE;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,oBAAoB,EAAE,SAAS,iBAAiB,EAAE,CAIlG,CAAC"}

package/dist/balance-history/get-balance-history/balance-history-filter.js

@@ -0,0 +1,15 @@
+import { BalanceChangeType as e, BalanceHistoryFilter as t } from "./types.js";
+//#region src/balance-history/get-balance-history/balance-history-filter.ts
+var n = [
+	e.Deposit,
+	e.Withdraw,
+	e.Bridge
+], r = {
+	[t.All]: n,
+	[t.Deposit]: [e.Deposit],
+	[t.Withdraw]: [e.Withdraw, e.Bridge]
+};
+//#endregion
+export { r as balanceHistoryFilterToTypes };
+
+//# sourceMappingURL=balance-history-filter.js.map

package/dist/balance-history/get-balance-history/balance-history-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance-history-filter.js","names":[],"sources":["../../../src/balance-history/get-balance-history/balance-history-filter.ts"],"sourcesContent":["import { BalanceChangeType, BalanceHistoryFilter } from \"./types\";\n\n/** Every deposit / withdraw movement type, in display order. */\nconst ALL_BALANCE_CHANGE_TYPES: readonly BalanceChangeType[] = [\n  BalanceChangeType.Deposit,\n  BalanceChangeType.Withdraw,\n  BalanceChangeType.Bridge,\n];\n\n/**\n * Map a {@link BalanceHistoryFilter} to the subgraph `BalanceChange.type` values\n * it selects (the `type_in` clause of the history query). A withdraw filter\n * includes bridge withdraws.\n */\nexport const balanceHistoryFilterToTypes: Record<BalanceHistoryFilter, readonly BalanceChangeType[]> = {\n  [BalanceHistoryFilter.All]: ALL_BALANCE_CHANGE_TYPES,\n  [BalanceHistoryFilter.Deposit]: [BalanceChangeType.Deposit],\n  [BalanceHistoryFilter.Withdraw]: [BalanceChangeType.Withdraw, BalanceChangeType.Bridge],\n};\n"],"mappings":";;AAGA,IAAM,IAAyD;CAC7D,EAAkB;CAClB,EAAkB;CAClB,EAAkB;AACpB,GAOa,IAA0F;EACpG,EAAqB,MAAM;EAC3B,EAAqB,UAAU,CAAC,EAAkB,OAAO;EACzD,EAAqB,WAAW,CAAC,EAAkB,UAAU,EAAkB,MAAM;AACxF"}

package/dist/balance-history/get-balance-history/get-balance-history.d.ts

@@ -0,0 +1,66 @@
+import { Address } from 'viem';
+import { Config } from '../../core/config';
+import { ChainIdParameter, Compute } from '../../shared/types/properties';
+import { BalanceHistoryFilter, BalanceHistoryRow, InternalTransfersMode } from './types';
+/**
+ * Parameters for {@link getBalanceHistory}.
+ */
+export type GetBalanceHistoryParameters = Compute<ChainIdParameter & {
+    /**
+     * The sub-accounts whose deposit / withdraw history to read (e.g. the
+     * addresses from `getUserSubAccounts`). The query filters on the movement's
+     * `account`, so pass every sub-account to cover. Required; an empty array
+     * reads nothing.
+     */
+    accounts: readonly Address[];
+    /** Movement-type filter. @default BalanceHistoryFilter.All */
+    filter?: BalanceHistoryFilter;
+    /**
+     * How to treat internal margin-transfer legs — the `WITHDRAW` / `DEPOSIT`
+     * rows that are bookkeeping side effects of moving margin between the user's
+     * own SubAccount and a Virtual Account, not real protocol in/out movements.
+     * Orthogonal to {@link filter}. @default "exclude"
+     */
+    internalTransfers?: InternalTransfersMode;
+    /** Page size. @default 1000 */
+    first?: number;
+    /** Page offset. @default 0 */
+    skip?: number;
+    /** Lower bound on the movement timestamp (unix seconds). @default 0 */
+    startTime?: number;
+    /** Upper bound on the movement timestamp (unix seconds). @default 2_000_000_000 */
+    endTime?: number;
+    /** Sort direction on the movement timestamp. @default "desc" */
+    orderDirection?: "asc" | "desc";
+}>;
+/** Return type of {@link getBalanceHistory}. */
+export interface GetBalanceHistoryReturnType {
+    /** The decoded deposit / withdraw rows, newest first by default. */
+    rows: BalanceHistoryRow[];
+}
+/**
+ * Read a sub-account's deposit / withdraw history from the analytics subgraph's
+ * `balanceChanges` collection.
+ *
+ * Each row is one settled collateral movement (deposit, withdraw, or bridge
+ * withdraw). Filtering by movement type, time range, and pagination all happen
+ * server-side. A bridge withdraw is returned as its own {@link BalanceChangeType}
+ * but is selected by the `Withdraw` filter.
+ *
+ * @param config - The SDK config.
+ * @param parameters - Accounts, optional type filter, pagination, time range, sort, chain id.
+ * @returns The deposit / withdraw rows.
+ * @throws {SymmError} when the chain is unsupported or has no analytics subgraph.
+ * @throws {SymmApiError} when the subgraph request fails.
+ *
+ * @example
+ * ```ts
+ * const { rows } = await getBalanceHistory(config, {
+ *   accounts: ["0xsub…"],
+ *   filter: BalanceHistoryFilter.Withdraw,
+ *   first: 100,
+ * });
+ * ```
+ */
+export declare function getBalanceHistory(config: Config, parameters: GetBalanceHistoryParameters): Promise<GetBalanceHistoryReturnType>;
+//# sourceMappingURL=get-balance-history.d.ts.map

package/dist/balance-history/get-balance-history/get-balance-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-balance-history.d.ts","sourceRoot":"","sources":["../../../src/balance-history/get-balance-history/get-balance-history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAK/E,OAAO,EAAE,oBAAoB,EAAE,KAAK,iBAAiB,EAAE,KAAK,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAkBnG;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG,OAAO,CAC/C,gBAAgB,GAAG;IACjB;;;;;OAKG;IACH,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,8DAA8D;IAC9D,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,qBAAqB,CAAC;IAC1C,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mFAAmF;IACnF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,cAAc,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACjC,CACF,CAAC;AAEF,gDAAgD;AAChD,MAAM,WAAW,2BAA2B;IAC1C,oEAAoE;IACpE,IAAI,EAAE,iBAAiB,EAAE,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,2BAA2B,GACtC,OAAO,CAAC,2BAA2B,CAAC,CA+BtC"}

package/dist/balance-history/get-balance-history/get-balance-history.js

@@ -0,0 +1,32 @@
+import { querySubgraph as e } from "../../symmio-subgraph/query-subgraph/query-subgraph.js";
+import { BalanceHistoryFilter as t } from "./types.js";
+import { balanceHistoryFilterToTypes as n } from "./balance-history-filter.js";
+import { BalanceChangesDocument as r } from "./query-document.js";
+import { toBalanceHistoryRow as i } from "./to-balance-history-row.js";
+//#region src/balance-history/get-balance-history/get-balance-history.ts
+var a = 1e3, o = 2e9, s = {
+	exclude: [!1],
+	only: [!0],
+	include: [!0, !1]
+};
+async function c(c, l) {
+	let { chainId: u, accounts: d, filter: f = t.All, internalTransfers: p = "exclude", first: m = a, skip: h = 0, startTime: g = 0, endTime: _ = o, orderDirection: v = "desc" } = l;
+	return d.length === 0 ? { rows: [] } : { rows: (await e(c, {
+		chainId: u,
+		document: r,
+		variables: {
+			accounts: d.map((e) => e.toLowerCase()),
+			typeIn: n[f],
+			isMarginTransferSideEffectIn: s[p],
+			first: m,
+			skip: h,
+			orderDirection: v,
+			startDate: g.toString(),
+			endDate: _.toString()
+		}
+	})).balanceChanges.map(i) };
+}
+//#endregion
+export { c as getBalanceHistory };
+
+//# sourceMappingURL=get-balance-history.js.map

package/dist/balance-history/get-balance-history/get-balance-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-balance-history.js","names":[],"sources":["../../../src/balance-history/get-balance-history/get-balance-history.ts"],"sourcesContent":["import type { Address } from \"viem\";\nimport type { Config } from \"../../core/config\";\nimport type { ChainIdParameter, Compute } from \"../../shared/types/properties\";\nimport { querySubgraph } from \"../../symmio-subgraph/query-subgraph\";\nimport { balanceHistoryFilterToTypes } from \"./balance-history-filter\";\nimport { BalanceChangesDocument } from \"./query-document\";\nimport { toBalanceHistoryRow } from \"./to-balance-history-row\";\nimport { BalanceHistoryFilter, type BalanceHistoryRow, type InternalTransfersMode } from \"./types\";\n\n/** Default page size when `first` is omitted. */\nconst DEFAULT_PAGE_SIZE = 1000;\n/** Default upper time bound (far-future unix seconds) when `endTime` is omitted. */\nconst DEFAULT_END_TIME = 2_000_000_000;\n\n/**\n * Map an {@link InternalTransfersMode} to the subgraph `isMarginTransferSideEffect_in`\n * list. `\"include\"` passes both values so the no-constraint case is explicit\n * rather than relying on null-omission semantics.\n */\nconst INTERNAL_TRANSFERS_TO_MARGIN_SIDE_EFFECT_IN: Record<InternalTransfersMode, boolean[]> = {\n  exclude: [false],\n  only: [true],\n  include: [true, false],\n};\n\n/**\n * Parameters for {@link getBalanceHistory}.\n */\nexport type GetBalanceHistoryParameters = Compute<\n  ChainIdParameter & {\n    /**\n     * The sub-accounts whose deposit / withdraw history to read (e.g. the\n     * addresses from `getUserSubAccounts`). The query filters on the movement's\n     * `account`, so pass every sub-account to cover. Required; an empty array\n     * reads nothing.\n     */\n    accounts: readonly Address[];\n    /** Movement-type filter. @default BalanceHistoryFilter.All */\n    filter?: BalanceHistoryFilter;\n    /**\n     * How to treat internal margin-transfer legs — the `WITHDRAW` / `DEPOSIT`\n     * rows that are bookkeeping side effects of moving margin between the user's\n     * own SubAccount and a Virtual Account, not real protocol in/out movements.\n     * Orthogonal to {@link filter}. @default \"exclude\"\n     */\n    internalTransfers?: InternalTransfersMode;\n    /** Page size. @default 1000 */\n    first?: number;\n    /** Page offset. @default 0 */\n    skip?: number;\n    /** Lower bound on the movement timestamp (unix seconds). @default 0 */\n    startTime?: number;\n    /** Upper bound on the movement timestamp (unix seconds). @default 2_000_000_000 */\n    endTime?: number;\n    /** Sort direction on the movement timestamp. @default \"desc\" */\n    orderDirection?: \"asc\" | \"desc\";\n  }\n>;\n\n/** Return type of {@link getBalanceHistory}. */\nexport interface GetBalanceHistoryReturnType {\n  /** The decoded deposit / withdraw rows, newest first by default. */\n  rows: BalanceHistoryRow[];\n}\n\n/**\n * Read a sub-account's deposit / withdraw history from the analytics subgraph's\n * `balanceChanges` collection.\n *\n * Each row is one settled collateral movement (deposit, withdraw, or bridge\n * withdraw). Filtering by movement type, time range, and pagination all happen\n * server-side. A bridge withdraw is returned as its own {@link BalanceChangeType}\n * but is selected by the `Withdraw` filter.\n *\n * @param config - The SDK config.\n * @param parameters - Accounts, optional type filter, pagination, time range, sort, chain id.\n * @returns The deposit / withdraw rows.\n * @throws {SymmError} when the chain is unsupported or has no analytics subgraph.\n * @throws {SymmApiError} when the subgraph request fails.\n *\n * @example\n * ```ts\n * const { rows } = await getBalanceHistory(config, {\n *   accounts: [\"0xsub…\"],\n *   filter: BalanceHistoryFilter.Withdraw,\n *   first: 100,\n * });\n * ```\n */\nexport async function getBalanceHistory(\n  config: Config,\n  parameters: GetBalanceHistoryParameters,\n): Promise<GetBalanceHistoryReturnType> {\n  const {\n    chainId,\n    accounts,\n    filter = BalanceHistoryFilter.All,\n    internalTransfers = \"exclude\",\n    first = DEFAULT_PAGE_SIZE,\n    skip = 0,\n    startTime = 0,\n    endTime = DEFAULT_END_TIME,\n    orderDirection = \"desc\",\n  } = parameters;\n\n  if (accounts.length === 0) return { rows: [] };\n\n  const data = await querySubgraph(config, {\n    chainId,\n    document: BalanceChangesDocument,\n    variables: {\n      accounts: accounts.map((account) => account.toLowerCase()),\n      typeIn: balanceHistoryFilterToTypes[filter] as string[],\n      isMarginTransferSideEffectIn: INTERNAL_TRANSFERS_TO_MARGIN_SIDE_EFFECT_IN[internalTransfers],\n      first,\n      skip,\n      orderDirection,\n      startDate: startTime.toString(),\n      endDate: endTime.toString(),\n    },\n  });\n\n  return { rows: data.balanceChanges.map(toBalanceHistoryRow) };\n}\n"],"mappings":";;;;;;AAUA,IAAM,IAAoB,KAEpB,IAAmB,KAOnB,IAAwF;CAC5F,SAAS,CAAC,EAAK;CACf,MAAM,CAAC,EAAI;CACX,SAAS,CAAC,IAAM,EAAK;AACvB;AAkEA,eAAsB,EACpB,GACA,GACsC;CACtC,IAAM,EACJ,YACA,aACA,YAAS,EAAqB,KAC9B,uBAAoB,WACpB,WAAQ,GACR,UAAO,GACP,eAAY,GACZ,aAAU,GACV,oBAAiB,WACf;CAmBJ,OAjBI,EAAS,WAAW,IAAU,EAAE,MAAM,CAAC,EAAE,IAiBtC,EAAE,OAAM,MAfI,EAAc,GAAQ;EACvC;EACA,UAAU;EACV,WAAW;GACT,UAAU,EAAS,KAAK,MAAY,EAAQ,YAAY,CAAC;GACzD,QAAQ,EAA4B;GACpC,8BAA8B,EAA4C;GAC1E;GACA;GACA;GACA,WAAW,EAAU,SAAS;GAC9B,SAAS,EAAQ,SAAS;EAC5B;CACF,CAAC,GAEmB,eAAe,IAAI,CAAmB,EAAE;AAC9D"}

package/dist/balance-history/get-balance-history/index.d.ts

@@ -0,0 +1,6 @@
+export * from './balance-history-filter';
+export * from './get-balance-history';
+export * from './query';
+export * from './to-balance-history-row';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/balance-history/get-balance-history/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/balance-history/get-balance-history/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,SAAS,CAAC;AACxB,cAAc,0BAA0B,CAAC;AACzC,cAAc,SAAS,CAAC"}

package/dist/balance-history/get-balance-history/query-document.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Deposit / withdraw history over the analytics subgraph's `balanceChanges`
+ * collection. Filtered server-side by `account_in`, movement `type_in`
+ * (deposit / withdraw / bridge), a `timestamp` range, and
+ * `isMarginTransferSideEffect_in` (which internal-transfer legs to keep); sorted
+ * by `timestamp`.
+ *
+ * `account` is a `Bytes` scalar (so `account_in` takes `[Bytes!]`) and `type` is
+ * a `String` scalar (`type_in` takes `[String!]`); the codegen `Bytes` scalar is
+ * a plain string, so lowercased addresses pass straight through. The
+ * `isMarginTransferSideEffect_in` list ( `[false]` / `[true]` / `[true, false]` )
+ * makes the include-both case explicit rather than relying on null-omission. The
+ * document compiles to a typed query string via graphql-codegen.
+ */
+export declare const BalanceChangesDocument: import('../../symmio-subgraph/types/generated/analytics/graphql').TypedDocumentString<import('../../symmio-subgraph/types/generated/analytics/graphql').BalanceChangesQuery, {
+    accounts: Array<string> | string;
+    typeIn: Array<string> | string;
+    isMarginTransferSideEffectIn: Array<boolean> | boolean;
+    first: number;
+    skip: number;
+    orderDirection: import('../../symmio-subgraph/types/generated/analytics/graphql').OrderDirection;
+    startDate: string;
+    endDate: string;
+}>;
+//# sourceMappingURL=query-document.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query-document.d.ts","sourceRoot":"","sources":["../../../src/balance-history/get-balance-history/query-document.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;EAkCjC,CAAC"}

package/dist/balance-history/get-balance-history/query-document.js

@@ -0,0 +1,7 @@
+import { graphql as e } from "../../symmio-subgraph/types/generated/analytics/gql.js";
+//#region src/balance-history/get-balance-history/query-document.ts
+var t = e("\n  query BalanceChanges(\n    $accounts: [Bytes!]!\n    $typeIn: [String!]!\n    $isMarginTransferSideEffectIn: [Boolean!]!\n    $first: Int!\n    $skip: Int!\n    $orderDirection: OrderDirection!\n    $startDate: BigInt!\n    $endDate: BigInt!\n  ) {\n    balanceChanges(\n      first: $first\n      skip: $skip\n      orderBy: timestamp\n      orderDirection: $orderDirection\n      where: {\n        account_in: $accounts\n        type_in: $typeIn\n        isMarginTransferSideEffect_in: $isMarginTransferSideEffectIn\n        timestamp_gte: $startDate\n        timestamp_lte: $endDate\n      }\n    ) {\n      id\n      type\n      amount\n      account\n      timestamp\n      transaction\n      isMarginTransferSideEffect\n      marginTransferType\n    }\n  }\n");
+//#endregion
+export { t as BalanceChangesDocument };
+
+//# sourceMappingURL=query-document.js.map

package/dist/balance-history/get-balance-history/query-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-document.js","names":[],"sources":["../../../src/balance-history/get-balance-history/query-document.ts"],"sourcesContent":["import { graphql } from \"../../symmio-subgraph/types/generated/analytics\";\n\n/**\n * Deposit / withdraw history over the analytics subgraph's `balanceChanges`\n * collection. Filtered server-side by `account_in`, movement `type_in`\n * (deposit / withdraw / bridge), a `timestamp` range, and\n * `isMarginTransferSideEffect_in` (which internal-transfer legs to keep); sorted\n * by `timestamp`.\n *\n * `account` is a `Bytes` scalar (so `account_in` takes `[Bytes!]`) and `type` is\n * a `String` scalar (`type_in` takes `[String!]`); the codegen `Bytes` scalar is\n * a plain string, so lowercased addresses pass straight through. The\n * `isMarginTransferSideEffect_in` list ( `[false]` / `[true]` / `[true, false]` )\n * makes the include-both case explicit rather than relying on null-omission. The\n * document compiles to a typed query string via graphql-codegen.\n */\nexport const BalanceChangesDocument = graphql(`\n  query BalanceChanges(\n    $accounts: [Bytes!]!\n    $typeIn: [String!]!\n    $isMarginTransferSideEffectIn: [Boolean!]!\n    $first: Int!\n    $skip: Int!\n    $orderDirection: OrderDirection!\n    $startDate: BigInt!\n    $endDate: BigInt!\n  ) {\n    balanceChanges(\n      first: $first\n      skip: $skip\n      orderBy: timestamp\n      orderDirection: $orderDirection\n      where: {\n        account_in: $accounts\n        type_in: $typeIn\n        isMarginTransferSideEffect_in: $isMarginTransferSideEffectIn\n        timestamp_gte: $startDate\n        timestamp_lte: $endDate\n      }\n    ) {\n      id\n      type\n      amount\n      account\n      timestamp\n      transaction\n      isMarginTransferSideEffect\n      marginTransferType\n    }\n  }\n`);\n"],"mappings":";;AAgBA,IAAa,IAAyB,EAAQ,kwBAkC7C"}

package/dist/balance-history/get-balance-history/query.d.ts

@@ -0,0 +1,43 @@
+import { Config } from '../../core/config';
+import { Compute, ConfigKeyParameter } from '../../shared/types/properties';
+import { QueryParameter, SymmioQueryOptions } from '../../shared/types/query';
+import { GetBalanceHistoryParameters, GetBalanceHistoryReturnType } from './get-balance-history';
+/** Data resolved by the {@link getBalanceHistoryQueryOptions} query. */
+export type GetBalanceHistoryData = GetBalanceHistoryReturnType;
+/**
+ * Build the TanStack Query key for {@link getBalanceHistoryQueryOptions}.
+ *
+ * @param options - Query parameters (accounts, filter, paging, time range, chain id, config key).
+ * @returns A stable, hashable query key.
+ */
+export declare function getBalanceHistoryQueryKey(options: Compute<GetBalanceHistoryParameters & ConfigKeyParameter>): readonly ["getBalanceHistory", Record<string, unknown>];
+/** Query-key type produced by {@link getBalanceHistoryQueryKey}. */
+export type GetBalanceHistoryQueryKey = ReturnType<typeof getBalanceHistoryQueryKey>;
+/**
+ * Options accepted by {@link getBalanceHistoryQueryOptions}: the action's
+ * parameters plus TanStack overrides.
+ */
+export type GetBalanceHistoryOptions = Compute<GetBalanceHistoryParameters & QueryParameter<GetBalanceHistoryData, Error, GetBalanceHistoryData, GetBalanceHistoryQueryKey>>;
+/** TanStack Query options returned by {@link getBalanceHistoryQueryOptions}. */
+export type GetBalanceHistoryQueryOptions = SymmioQueryOptions<GetBalanceHistoryData, Error, GetBalanceHistoryData, GetBalanceHistoryQueryKey>;
+/**
+ * Build TanStack Query options for {@link getBalanceHistory}. 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(
+ *   getBalanceHistoryQueryOptions(config, {
+ *     accounts: ["0xsub…"],
+ *     filter: BalanceHistoryFilter.Deposit,
+ *   }),
+ * );
+ * ```
+ */
+export declare function getBalanceHistoryQueryOptions(config: Config, options: GetBalanceHistoryOptions): GetBalanceHistoryQueryOptions;
+//# sourceMappingURL=query.d.ts.map

package/dist/balance-history/get-balance-history/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/balance-history/get-balance-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,2BAA2B,EAChC,KAAK,2BAA2B,EACjC,MAAM,uBAAuB,CAAC;AAE/B,wEAAwE;AACxE,MAAM,MAAM,qBAAqB,GAAG,2BAA2B,CAAC;AAEhE;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,CAAC,2BAA2B,GAAG,kBAAkB,CAAC,2DAE3G;AAED,oEAAoE;AACpE,MAAM,MAAM,yBAAyB,GAAG,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAErF;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAC5C,2BAA2B,GACzB,cAAc,CAAC,qBAAqB,EAAE,KAAK,EAAE,qBAAqB,EAAE,yBAAyB,CAAC,CACjG,CAAC;AAEF,gFAAgF;AAChF,MAAM,MAAM,6BAA6B,GAAG,kBAAkB,CAC5D,qBAAqB,EACrB,KAAK,EACL,qBAAqB,EACrB,yBAAyB,CAC1B,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,wBAAwB,GAChC,6BAA6B,CAqB/B"}

package/dist/balance-history/get-balance-history/query.js

@@ -0,0 +1,31 @@
+import { filterQueryOptions as e } from "../../shared/utils/query.js";
+import { getBalanceHistory as t } from "./get-balance-history.js";
+//#region src/balance-history/get-balance-history/query.ts
+function n(t) {
+	return ["getBalanceHistory", 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,
+			filter: r.filter,
+			internalTransfers: r.internalTransfers,
+			first: r.first,
+			skip: r.skip,
+			startTime: r.startTime,
+			endTime: r.endTime,
+			orderDirection: r.orderDirection
+		})
+	};
+}
+//#endregion
+export { n as getBalanceHistoryQueryKey, r as getBalanceHistoryQueryOptions };
+
+//# sourceMappingURL=query.js.map

package/dist/balance-history/get-balance-history/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../../src/balance-history/get-balance-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  getBalanceHistory,\n  type GetBalanceHistoryParameters,\n  type GetBalanceHistoryReturnType,\n} from \"./get-balance-history\";\n\n/** Data resolved by the {@link getBalanceHistoryQueryOptions} query. */\nexport type GetBalanceHistoryData = GetBalanceHistoryReturnType;\n\n/**\n * Build the TanStack Query key for {@link getBalanceHistoryQueryOptions}.\n *\n * @param options - Query parameters (accounts, filter, paging, time range, chain id, config key).\n * @returns A stable, hashable query key.\n */\nexport function getBalanceHistoryQueryKey(options: Compute<GetBalanceHistoryParameters & ConfigKeyParameter>) {\n  return [\"getBalanceHistory\", filterQueryOptions(options)] as const;\n}\n\n/** Query-key type produced by {@link getBalanceHistoryQueryKey}. */\nexport type GetBalanceHistoryQueryKey = ReturnType<typeof getBalanceHistoryQueryKey>;\n\n/**\n * Options accepted by {@link getBalanceHistoryQueryOptions}: the action's\n * parameters plus TanStack overrides.\n */\nexport type GetBalanceHistoryOptions = Compute<\n  GetBalanceHistoryParameters &\n    QueryParameter<GetBalanceHistoryData, Error, GetBalanceHistoryData, GetBalanceHistoryQueryKey>\n>;\n\n/** TanStack Query options returned by {@link getBalanceHistoryQueryOptions}. */\nexport type GetBalanceHistoryQueryOptions = SymmioQueryOptions<\n  GetBalanceHistoryData,\n  Error,\n  GetBalanceHistoryData,\n  GetBalanceHistoryQueryKey\n>;\n\n/**\n * Build TanStack Query options for {@link getBalanceHistory}. 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(\n *   getBalanceHistoryQueryOptions(config, {\n *     accounts: [\"0xsub…\"],\n *     filter: BalanceHistoryFilter.Deposit,\n *   }),\n * );\n * ```\n */\nexport function getBalanceHistoryQueryOptions(\n  config: Config,\n  options: GetBalanceHistoryOptions,\n): GetBalanceHistoryQueryOptions {\n  return {\n    ...options.query,\n    queryKey: getBalanceHistoryQueryKey({\n      ...options,\n      configKey: config.getChainConfigKey(options.chainId),\n    }),\n    enabled: (options.query?.enabled ?? true) && options.accounts.length > 0,\n    queryFn: () =>\n      getBalanceHistory(config, {\n        chainId: options.chainId,\n        accounts: options.accounts,\n        filter: options.filter,\n        internalTransfers: options.internalTransfers,\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,EAA0B,GAAoE;CAC5G,OAAO,CAAC,qBAAqB,EAAmB,CAAO,CAAC;AAC1D;AAyCA,SAAgB,EACd,GACA,GAC+B;CAC/B,OAAO;EACL,GAAG,EAAQ;EACX,UAAU,EAA0B;GAClC,GAAG;GACH,WAAW,EAAO,kBAAkB,EAAQ,OAAO;EACrD,CAAC;EACD,UAAU,EAAQ,OAAO,WAAW,OAAS,EAAQ,SAAS,SAAS;EACvE,eACE,EAAkB,GAAQ;GACxB,SAAS,EAAQ;GACjB,UAAU,EAAQ;GAClB,QAAQ,EAAQ;GAChB,mBAAmB,EAAQ;GAC3B,OAAO,EAAQ;GACf,MAAM,EAAQ;GACd,WAAW,EAAQ;GACnB,SAAS,EAAQ;GACjB,gBAAgB,EAAQ;EAC1B,CAAC;CACL;AACF"}

package/dist/balance-history/get-balance-history/to-balance-history-row.d.ts

@@ -0,0 +1,16 @@
+import { BalanceChangesQuery } from '../../symmio-subgraph/types/generated/analytics/graphql';
+import { BalanceHistoryRow } from './types';
+/** A single `balanceChanges` row as returned by the history query. */
+export type RawBalanceChangeRow = BalanceChangesQuery["balanceChanges"][number];
+/**
+ * Build a {@link BalanceHistoryRow} from one immutable `balanceChanges` row:
+ * parse the wei `amount` / `timestamp` strings to numbers, checksum the account
+ * address, and decode the internal-transfer tags. The `type` is one of the
+ * deposit / withdraw / bridge values the query filtered on, so the narrowing cast
+ * is safe; `marginTransferType` is `null` on genuine user movements.
+ *
+ * @param row - One `balanceChanges` row from {@link "BalanceChangesDocument"}.
+ * @returns The decoded history row.
+ */
+export declare function toBalanceHistoryRow(row: RawBalanceChangeRow): BalanceHistoryRow;
+//# sourceMappingURL=to-balance-history-row.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"to-balance-history-row.d.ts","sourceRoot":"","sources":["../../../src/balance-history/get-balance-history/to-balance-history-row.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yDAAyD,CAAC;AACnG,OAAO,EAAyC,KAAK,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAExF,sEAAsE;AACtE,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhF;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,mBAAmB,GAAG,iBAAiB,CAW/E"}

package/dist/balance-history/get-balance-history/to-balance-history-row.js

@@ -0,0 +1,18 @@
+import { getAddress as e } from "viem";
+//#region src/balance-history/get-balance-history/to-balance-history-row.ts
+function t(t) {
+	return {
+		id: t.id,
+		type: t.type,
+		amount: BigInt(t.amount),
+		account: e(t.account),
+		timestamp: Number(t.timestamp),
+		transaction: t.transaction,
+		isInternalTransfer: t.isMarginTransferSideEffect,
+		marginTransferType: t.marginTransferType ? t.marginTransferType : null
+	};
+}
+//#endregion
+export { t as toBalanceHistoryRow };
+
+//# sourceMappingURL=to-balance-history-row.js.map

package/dist/balance-history/get-balance-history/to-balance-history-row.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-balance-history-row.js","names":[],"sources":["../../../src/balance-history/get-balance-history/to-balance-history-row.ts"],"sourcesContent":["import { getAddress, type Hex } from \"viem\";\nimport type { BalanceChangesQuery } from \"../../symmio-subgraph/types/generated/analytics/graphql\";\nimport { BalanceChangeType, MarginTransferType, type BalanceHistoryRow } from \"./types\";\n\n/** A single `balanceChanges` row as returned by the history query. */\nexport type RawBalanceChangeRow = BalanceChangesQuery[\"balanceChanges\"][number];\n\n/**\n * Build a {@link BalanceHistoryRow} from one immutable `balanceChanges` row:\n * parse the wei `amount` / `timestamp` strings to numbers, checksum the account\n * address, and decode the internal-transfer tags. The `type` is one of the\n * deposit / withdraw / bridge values the query filtered on, so the narrowing cast\n * is safe; `marginTransferType` is `null` on genuine user movements.\n *\n * @param row - One `balanceChanges` row from {@link \"BalanceChangesDocument\"}.\n * @returns The decoded history row.\n */\nexport function toBalanceHistoryRow(row: RawBalanceChangeRow): BalanceHistoryRow {\n  return {\n    id: row.id,\n    type: row.type as BalanceChangeType,\n    amount: BigInt(row.amount),\n    account: getAddress(row.account),\n    timestamp: Number(row.timestamp),\n    transaction: row.transaction as Hex,\n    isInternalTransfer: row.isMarginTransferSideEffect,\n    marginTransferType: row.marginTransferType ? (row.marginTransferType as MarginTransferType) : null,\n  };\n}\n"],"mappings":";;AAiBA,SAAgB,EAAoB,GAA6C;CAC/E,OAAO;EACL,IAAI,EAAI;EACR,MAAM,EAAI;EACV,QAAQ,OAAO,EAAI,MAAM;EACzB,SAAS,EAAW,EAAI,OAAO;EAC/B,WAAW,OAAO,EAAI,SAAS;EAC/B,aAAa,EAAI;EACjB,oBAAoB,EAAI;EACxB,oBAAoB,EAAI,qBAAsB,EAAI,qBAA4C;CAChG;AACF"}

package/dist/balance-history/get-balance-history/types.d.ts

@@ -0,0 +1,97 @@
+import { Address, Hex } from 'viem';
+/**
+ * Subgraph `BalanceChange.type` values for the collateral movements that make up
+ * deposit / withdraw history.
+ *
+ * @remarks
+ * Mirrors the `type` strings emitted by the SYMMIO analytics subgraph. The
+ * subgraph also emits margin moves (`ALLOCATE` / `DEALLOCATE`); those are out of
+ * scope for this slice and are never returned by {@link "getBalanceHistory"}.
+ */
+export declare enum BalanceChangeType {
+    /** Collateral deposited into a sub-account. */
+    Deposit = "DEPOSIT",
+    /** Collateral withdrawn from a sub-account. */
+    Withdraw = "WITHDRAW",
+    /** A withdraw routed through a bridge (instant / CCTP). Treated as a withdraw. */
+    Bridge = "BRIDGE"
+}
+/**
+ * Filter selecting which movements a {@link "getBalanceHistory"} read returns.
+ * Maps to the subgraph `type_in` clause via {@link "balanceHistoryFilterToTypes"}.
+ */
+export declare enum BalanceHistoryFilter {
+    /** Deposits and withdraws (including bridge withdraws). */
+    All = "All",
+    /** Deposits only. */
+    Deposit = "Deposit",
+    /** Withdraws, including bridge withdraws. */
+    Withdraw = "Withdraw"
+}
+/**
+ * The kind of margin transfer an internal-transfer leg belongs to (subgraph
+ * `BalanceChange.marginTransferType`). Present only on rows where
+ * {@link BalanceHistoryRow.isInternalTransfer} is `true`.
+ *
+ * @remarks
+ * A margin transfer moves collateral between a user's own SubAccount and one of
+ * its Virtual Accounts; it expands into a cluster of primitive balance legs that
+ * carry this tag (verified against the live analytics subgraph).
+ */
+export declare enum MarginTransferType {
+    /** Funding a Virtual Account's margin from the SubAccount. */
+    Add = "ADD",
+    /** Pulling margin out of a Virtual Account back to the SubAccount. */
+    Remove = "REMOVE",
+    /** Margin automatically returned to the SubAccount (e.g. on close / deallocate). */
+    AutoReturn = "AUTO_RETURN"
+}
+/**
+ * How a {@link "getBalanceHistory"} read treats **internal margin-transfer legs**
+ * — the `WITHDRAW` / `DEPOSIT` rows that are bookkeeping side effects of moving
+ * margin between a user's own accounts, not real collateral movements in or out
+ * of the protocol. Maps to the subgraph `isMarginTransferSideEffect` filter.
+ *
+ * @remarks
+ * Orthogonal to {@link BalanceHistoryFilter} (which chooses deposit vs withdraw):
+ * `filter` picks the direction, `internalTransfers` picks real-vs-transfer.
+ */
+export type InternalTransfersMode = 
+/** Only genuine user deposits / withdrawals (`isMarginTransferSideEffect: false`). The default. */
+"exclude"
+/** Only internal-transfer legs (`isMarginTransferSideEffect: true`). */
+ | "only"
+/** Both — no constraint on `isMarginTransferSideEffect`. */
+ | "include";
+/**
+ * One settled collateral movement (deposit or withdraw) on a sub-account.
+ *
+ * @remarks
+ * `amount` is a raw `bigint` in the **collateral token's decimals** (not 18) —
+ * scale it with `config.getChainConfig(chainId).addresses.collateralDecimals`
+ * (6 on HyperEVM) for display.
+ */
+export interface BalanceHistoryRow {
+    /** Subgraph entity id (use as a stable row key). */
+    id: string;
+    /** Movement kind, decoded from the subgraph `type`. */
+    type: BalanceChangeType;
+    /** Amount, raw `bigint` in collateral decimals. */
+    amount: bigint;
+    /** The sub-account the movement belongs to. */
+    account: Address;
+    /** Block timestamp, unix seconds. */
+    timestamp: number;
+    /** Transaction hash of the movement. */
+    transaction: Hex;
+    /**
+     * `true` when this row is an internal margin-transfer leg (a side effect of
+     * moving margin between the user's own SubAccount and a Virtual Account) rather
+     * than a real user deposit / withdrawal. Always `false` under the default
+     * `internalTransfers: "exclude"`; only meaningful when transfers are included.
+     */
+    isInternalTransfer: boolean;
+    /** The margin-transfer kind when {@link isInternalTransfer} is `true`; otherwise `null`. */
+    marginTransferType: MarginTransferType | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/balance-history/get-balance-history/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/balance-history/get-balance-history/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAEzC;;;;;;;;GAQG;AACH,oBAAY,iBAAiB;IAC3B,+CAA+C;IAC/C,OAAO,YAAY;IACnB,+CAA+C;IAC/C,QAAQ,aAAa;IACrB,kFAAkF;IAClF,MAAM,WAAW;CAClB;AAED;;;GAGG;AACH,oBAAY,oBAAoB;IAC9B,2DAA2D;IAC3D,GAAG,QAAQ;IACX,qBAAqB;IACrB,OAAO,YAAY;IACnB,6CAA6C;IAC7C,QAAQ,aAAa;CACtB;AAED;;;;;;;;;GASG;AACH,oBAAY,kBAAkB;IAC5B,8DAA8D;IAC9D,GAAG,QAAQ;IACX,sEAAsE;IACtE,MAAM,WAAW;IACjB,oFAAoF;IACpF,UAAU,gBAAgB;CAC3B;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,qBAAqB;AAC/B,mGAAmG;AACjG,SAAS;AACX,wEAAwE;GACtE,MAAM;AACR,4DAA4D;GAC1D,SAAS,CAAC;AAEd;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,uDAAuD;IACvD,IAAI,EAAE,iBAAiB,CAAC;IACxB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,WAAW,EAAE,GAAG,CAAC;IACjB;;;;;OAKG;IACH,kBAAkB,EAAE,OAAO,CAAC;IAC5B,4FAA4F;IAC5F,kBAAkB,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAC/C"}

package/dist/balance-history/get-balance-history/types.js

@@ -0,0 +1,12 @@
+//#region src/balance-history/get-balance-history/types.ts
+var e = /* @__PURE__ */ function(e) {
+	return e.Deposit = "DEPOSIT", e.Withdraw = "WITHDRAW", e.Bridge = "BRIDGE", e;
+}({}), t = /* @__PURE__ */ function(e) {
+	return e.All = "All", e.Deposit = "Deposit", e.Withdraw = "Withdraw", e;
+}({}), n = /* @__PURE__ */ function(e) {
+	return e.Add = "ADD", e.Remove = "REMOVE", e.AutoReturn = "AUTO_RETURN", e;
+}({});
+//#endregion
+export { e as BalanceChangeType, t as BalanceHistoryFilter, n as MarginTransferType };
+
+//# sourceMappingURL=types.js.map

package/dist/balance-history/get-balance-history/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../../../src/balance-history/get-balance-history/types.ts"],"sourcesContent":["import type { Address, Hex } from \"viem\";\n\n/**\n * Subgraph `BalanceChange.type` values for the collateral movements that make up\n * deposit / withdraw history.\n *\n * @remarks\n * Mirrors the `type` strings emitted by the SYMMIO analytics subgraph. The\n * subgraph also emits margin moves (`ALLOCATE` / `DEALLOCATE`); those are out of\n * scope for this slice and are never returned by {@link \"getBalanceHistory\"}.\n */\nexport enum BalanceChangeType {\n  /** Collateral deposited into a sub-account. */\n  Deposit = \"DEPOSIT\",\n  /** Collateral withdrawn from a sub-account. */\n  Withdraw = \"WITHDRAW\",\n  /** A withdraw routed through a bridge (instant / CCTP). Treated as a withdraw. */\n  Bridge = \"BRIDGE\",\n}\n\n/**\n * Filter selecting which movements a {@link \"getBalanceHistory\"} read returns.\n * Maps to the subgraph `type_in` clause via {@link \"balanceHistoryFilterToTypes\"}.\n */\nexport enum BalanceHistoryFilter {\n  /** Deposits and withdraws (including bridge withdraws). */\n  All = \"All\",\n  /** Deposits only. */\n  Deposit = \"Deposit\",\n  /** Withdraws, including bridge withdraws. */\n  Withdraw = \"Withdraw\",\n}\n\n/**\n * The kind of margin transfer an internal-transfer leg belongs to (subgraph\n * `BalanceChange.marginTransferType`). Present only on rows where\n * {@link BalanceHistoryRow.isInternalTransfer} is `true`.\n *\n * @remarks\n * A margin transfer moves collateral between a user's own SubAccount and one of\n * its Virtual Accounts; it expands into a cluster of primitive balance legs that\n * carry this tag (verified against the live analytics subgraph).\n */\nexport enum MarginTransferType {\n  /** Funding a Virtual Account's margin from the SubAccount. */\n  Add = \"ADD\",\n  /** Pulling margin out of a Virtual Account back to the SubAccount. */\n  Remove = \"REMOVE\",\n  /** Margin automatically returned to the SubAccount (e.g. on close / deallocate). */\n  AutoReturn = \"AUTO_RETURN\",\n}\n\n/**\n * How a {@link \"getBalanceHistory\"} read treats **internal margin-transfer legs**\n * — the `WITHDRAW` / `DEPOSIT` rows that are bookkeeping side effects of moving\n * margin between a user's own accounts, not real collateral movements in or out\n * of the protocol. Maps to the subgraph `isMarginTransferSideEffect` filter.\n *\n * @remarks\n * Orthogonal to {@link BalanceHistoryFilter} (which chooses deposit vs withdraw):\n * `filter` picks the direction, `internalTransfers` picks real-vs-transfer.\n */\nexport type InternalTransfersMode =\n  /** Only genuine user deposits / withdrawals (`isMarginTransferSideEffect: false`). The default. */\n  | \"exclude\"\n  /** Only internal-transfer legs (`isMarginTransferSideEffect: true`). */\n  | \"only\"\n  /** Both — no constraint on `isMarginTransferSideEffect`. */\n  | \"include\";\n\n/**\n * One settled collateral movement (deposit or withdraw) on a sub-account.\n *\n * @remarks\n * `amount` is a raw `bigint` in the **collateral token's decimals** (not 18) —\n * scale it with `config.getChainConfig(chainId).addresses.collateralDecimals`\n * (6 on HyperEVM) for display.\n */\nexport interface BalanceHistoryRow {\n  /** Subgraph entity id (use as a stable row key). */\n  id: string;\n  /** Movement kind, decoded from the subgraph `type`. */\n  type: BalanceChangeType;\n  /** Amount, raw `bigint` in collateral decimals. */\n  amount: bigint;\n  /** The sub-account the movement belongs to. */\n  account: Address;\n  /** Block timestamp, unix seconds. */\n  timestamp: number;\n  /** Transaction hash of the movement. */\n  transaction: Hex;\n  /**\n   * `true` when this row is an internal margin-transfer leg (a side effect of\n   * moving margin between the user's own SubAccount and a Virtual Account) rather\n   * than a real user deposit / withdrawal. Always `false` under the default\n   * `internalTransfers: \"exclude\"`; only meaningful when transfers are included.\n   */\n  isInternalTransfer: boolean;\n  /** The margin-transfer kind when {@link isInternalTransfer} is `true`; otherwise `null`. */\n  marginTransferType: MarginTransferType | null;\n}\n"],"mappings":";AAWA,IAAY,IAAL,yBAAA,GAAA;QAEL,EAAA,UAAA,WAEA,EAAA,WAAA,YAEA,EAAA,SAAA;AACF,EAAA,CAAA,CAAA,GAMY,IAAL,yBAAA,GAAA;QAEL,EAAA,MAAA,OAEA,EAAA,UAAA,WAEA,EAAA,WAAA;AACF,EAAA,CAAA,CAAA,GAYY,IAAL,yBAAA,GAAA;QAEL,EAAA,MAAA,OAEA,EAAA,SAAA,UAEA,EAAA,aAAA;AACF,EAAA,CAAA,CAAA"}

package/dist/balance-history/index.d.ts

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

package/dist/balance-history/index.d.ts.map

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

package/dist/core/chains/actions/get-chain-config.d.ts

@@ -0,0 +1,16 @@
+import { SymmioChainConfig } from '../types';
+/**
+ * Get the complete config for a chain.
+ *
+ * @param chainId - The chain ID to look up
+ * @returns The resolved chain config
+ * @throws {SymmError} when the chain is not supported
+ *
+ * @example
+ * ```ts
+ * const config = getChainConfig(SymmioSupportedChainId.HYPER_EVM);
+ * console.log(config.addresses.accountLayerAddress);
+ * ```
+ */
+export declare function getChainConfig(chainId: number): SymmioChainConfig;
+//# sourceMappingURL=get-chain-config.d.ts.map

package/dist/core/chains/actions/get-chain-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-chain-config.d.ts","sourceRoot":"","sources":["../../../../src/core/chains/actions/get-chain-config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAQjE"}

package/dist/core/chains/actions/get-chain-config.js

@@ -0,0 +1,12 @@
+import { SymmError as e } from "../../../shared/errors/symm-error.js";
+import { CHAIN_CONFIGS as t } from "../registry.js";
+//#region src/core/chains/actions/get-chain-config.ts
+function n(n) {
+	let r = t[n];
+	if (!r) throw new e("config", "UNSUPPORTED_CHAIN", `No config registered for chain ${n}.`);
+	return r;
+}
+//#endregion
+export { n as getChainConfig };
+
+//# sourceMappingURL=get-chain-config.js.map

package/dist/core/chains/actions/get-chain-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-chain-config.js","names":[],"sources":["../../../../src/core/chains/actions/get-chain-config.ts"],"sourcesContent":["import { SymmError } from \"../../../shared/errors/symm-error\";\nimport { CHAIN_CONFIGS } from \"../registry\";\nimport type { SymmioChainConfig } from \"../types\";\n\n/**\n * Get the complete config for a chain.\n *\n * @param chainId - The chain ID to look up\n * @returns The resolved chain config\n * @throws {SymmError} when the chain is not supported\n *\n * @example\n * ```ts\n * const config = getChainConfig(SymmioSupportedChainId.HYPER_EVM);\n * console.log(config.addresses.accountLayerAddress);\n * ```\n */\nexport function getChainConfig(chainId: number): SymmioChainConfig {\n  const config = CHAIN_CONFIGS[chainId];\n\n  if (!config) {\n    throw new SymmError(\"config\", \"UNSUPPORTED_CHAIN\", `No config registered for chain ${chainId}.`);\n  }\n\n  return config;\n}\n"],"mappings":";;;AAiBA,SAAgB,EAAe,GAAoC;CACjE,IAAM,IAAS,EAAc;CAE7B,IAAI,CAAC,GACH,MAAM,IAAI,EAAU,UAAU,qBAAqB,kCAAkC,EAAQ,EAAE;CAGjG,OAAO;AACT"}

package/dist/core/chains/actions/is-chain-supported.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Check if a chain has a built-in config.
+ *
+ * @param chainId - The chain ID to check
+ * @returns `true` if the chain is supported
+ */
+export declare function isChainSupported(chainId: number): boolean;
+//# sourceMappingURL=is-chain-supported.d.ts.map