@symmio/trading-core 0.1.0 → 0.2.0

package/README.md

@@ -1,67 +1,40 @@
 # @symmio/trading-core
 
-Framework-agnostic SYMMIO SDK.
+> Framework-agnostic SYMMIO SDK. Contract calls, calculations, and transformations with no framework assumptions.
 
-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.
+`@symmio/trading-core` is the base layer of the SYMMIO SDK: contract reads and writes (via viem), REST and GraphQL calls, and the calculations and transformations that turn raw protocol data into typed results. It has no framework dependency, so React (`@symmio/trading-react`) and other framework bindings build on top of it.
 
-## Status
+**[Documentation](https://symmio-frontier.vercel.app/core) · [Live SDK console](https://symm-frontier-web.vercel.app/)**
 
-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
+## Installation
 
 ```sh
-pnpm add @symmio/trading-core viem
+npm install @symmio/trading-core viem
 ```
 
-`viem` is a peer dependency.
+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() });
+import { createConfig, getMarkets } from "@symmio/trading-core";
+import { createPublicClient, http } from "viem";
+import { hyperEvm } from "viem/chains";
 
-const subs = await getUserSubAccounts(publicClient, {
-  user: "0xabc...",
-  limit: 100n,
-});
-
-const walletClient = createWalletClient({
-  chain: hyperevm,
-  transport: custom(window.ethereum),
-});
+const publicClient = createPublicClient({ chain: hyperEvm, transport: http() });
 
-const hash = await editAccountName(walletClient, {
-  account: "0xsub...",
-  name: "My Trading Account",
+const config = createConfig({
+  getClient: () => publicClient,
 });
-```
-
-### 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..." });
+const markets = await getMarkets(config, {});
+console.log(markets[0]?.name);
 ```
 
-## Documentation
+Every action ships a matching TanStack Query / Mutation options factory (e.g. `getMarketsQueryOptions`) for wiring into a query client.
 
-Full reference and concept docs: see `apps/docs` in the monorepo (or [the published docs site] once available).
+See the [full API reference](https://symmio-frontier.vercel.app/core) for every action, options factory, and type.
 
-## Contributing
+## License
 
-See [`AGENTS.md`](./AGENTS.md) for package-specific rules and the repo-root [`AGENTS.md`](../../AGENTS.md) for monorepo conventions.
+[MIT](./LICENSE)

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

@@ -1,4 +1,4 @@
-import { BalanceChangeType, BalanceHistoryFilter } from './types';
+import { BalanceChangeType, BalanceHistoryFilter } from './types.js';
 /**
  * Map a {@link BalanceHistoryFilter} to the subgraph `BalanceChange.type` values
  * it selects (the `type_in` clause of the history query). A withdraw filter

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

@@ -1,7 +1,7 @@
 import { Address } from 'viem';
-import { Config } from '../../core/config';
-import { ChainIdParameter, Compute } from '../../shared/types/properties';
-import { BalanceHistoryFilter, BalanceHistoryRow, InternalTransfersMode } from './types';
+import { Config } from '../../core/config/index.js';
+import { ChainIdParameter, Compute } from '../../shared/types/properties.js';
+import { BalanceHistoryFilter, BalanceHistoryRow, InternalTransfersMode } from './types.js';
 /**
  * Parameters for {@link getBalanceHistory}.
  */

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

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

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

@@ -12,13 +12,13 @@
  * 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, {
+export declare const BalanceChangesDocument: import('../../symmio-subgraph/types/generated/analytics/graphql.js').TypedDocumentString<import('../../symmio-subgraph/types/generated/analytics/graphql.js').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;
+    orderDirection: import('../../symmio-subgraph/types/generated/analytics/graphql.js').OrderDirection;
     startDate: string;
     endDate: string;
 }>;

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

@@ -1,7 +1,7 @@
-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';
+import { Config } from '../../core/config/index.js';
+import { Compute, ConfigKeyParameter } from '../../shared/types/properties.js';
+import { QueryParameter, SymmioQueryOptions } from '../../shared/types/query.js';
+import { GetBalanceHistoryParameters, GetBalanceHistoryReturnType } from './get-balance-history.js';
 /** Data resolved by the {@link getBalanceHistoryQueryOptions} query. */
 export type GetBalanceHistoryData = GetBalanceHistoryReturnType;
 /**

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

@@ -1,5 +1,5 @@
-import { BalanceChangesQuery } from '../../symmio-subgraph/types/generated/analytics/graphql';
-import { BalanceHistoryRow } from './types';
+import { BalanceChangesQuery } from '../../symmio-subgraph/types/generated/analytics/graphql.js';
+import { BalanceHistoryRow } from './types.js';
 /** A single `balanceChanges` row as returned by the history query. */
 export type RawBalanceChangeRow = BalanceChangesQuery["balanceChanges"][number];
 /**

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

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

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

@@ -1,4 +1,4 @@
-import { SymmioChainConfig } from '../types';
+import { SymmioChainConfig } from '../types.js';
 /**
  * Get the complete config for a chain.
  *

package/dist/core/chains/actions/list-supported-chains.d.ts

@@ -1,4 +1,4 @@
-import { SymmioSupportedChainId } from '../supported-chains';
+import { SymmioSupportedChainId } from '../supported-chains.js';
 /**
  * List all chain IDs with built-in configs.
  *

package/dist/core/chains/index.d.ts

@@ -1,6 +1,6 @@
-export * from './actions/get-chain-config';
-export * from './actions/is-chain-supported';
-export * from './actions/list-supported-chains';
-export * from './supported-chains';
-export * from './types';
+export * from './actions/get-chain-config.js';
+export * from './actions/is-chain-supported.js';
+export * from './actions/list-supported-chains.js';
+export * from './supported-chains.js';
+export * from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/chains/registry.d.ts

@@ -1,4 +1,4 @@
-import { SymmioChainConfig } from './types';
+import { SymmioChainConfig } from './types.js';
 /**
  * Built-in SYMMIO deployment configs keyed by chain ID.
  *

package/dist/core/config/config-key.d.ts

@@ -1,4 +1,4 @@
-import { SymmioChainConfig } from '../chains';
+import { SymmioChainConfig } from '../chains/index.js';
 /**
  * A short, stable fingerprint of a fully-resolved chain config. Derived purely
  * from the config's content — `ohash` serializes deterministically regardless of

package/dist/core/config/create-config.d.ts

@@ -1,9 +1,9 @@
 import { Address, PublicClient } from 'viem';
-import { DeepPartial } from '../../shared/types/properties';
-import { WebSocketConstructor } from '../../shared/types/websocket';
-import { SymmioChainConfig } from '../chains';
-import { SymmioWalletClient } from './types';
-export type { SymmioWalletClient } from './types';
+import { DeepPartial } from '../../shared/types/properties.js';
+import { WebSocketConstructor } from '../../shared/types/websocket.js';
+import { SymmioChainConfig } from '../chains/index.js';
+import { SymmioWalletClient } from './types.js';
+export type { SymmioWalletClient } from './types.js';
 /** Resolve a viem `PublicClient` for reads, optionally for a specific chain. */
 export type GetClientFn = (parameters?: {
     chainId?: number;

package/dist/core/config/index.d.ts

@@ -1,2 +1,2 @@
-export * from './create-config';
+export * from './create-config.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/config/merge-chain-config.d.ts

@@ -1,5 +1,5 @@
-import { DeepPartial } from '../../shared/types/properties';
-import { SymmioChainConfig } from '../chains';
+import { DeepPartial } from '../../shared/types/properties.js';
+import { SymmioChainConfig } from '../chains/index.js';
 /**
  * Build the per-chain config registry a {@link Config} holds: every built-in
  * supported chain, deep-merged with the caller's overrides.