@codex-data/sdk 2.4.11 → 2.5.1

package/dist/sdk/index.d.ts

@@ -21,7 +21,7 @@ export declare class Codex {
     private apiConfig?;
     private client;
     private wsClient;
-    private edgeWsClient;
+    private edgeWsClients;
     private disposed;
     queries: Query;
     mutations: Mutation;

package/dist/sdk/index.js

@@ -35,6 +35,7 @@ class Codex {
         var _a, _b;
         this.apiKey = apiKey;
         this.apiConfig = apiConfig;
+        this.edgeWsClients = new Map();
         this.disposed = false;
         const config = this.parseConfig((_a = this.apiConfig) !== null && _a !== void 0 ? _a : {});
         this.queries = new Query_1.Query(this);
@@ -86,9 +87,9 @@ class Codex {
     updateConfig(incomingConfig) {
         var _a, _b, _c;
         // If we have an existing websocket connection, dispose of it.
-        if (this.wsClient || this.edgeWsClient)
+        if (this.wsClient || this.edgeWsClients.size)
             void this.dispose();
-        this.edgeWsClient = undefined;
+        this.edgeWsClients.clear();
         this.disposed = false;
         this.apiConfig = Object.assign(Object.assign({}, this.apiConfig), incomingConfig);
         // Merge the incoming config with the existing config.
@@ -114,9 +115,12 @@ class Codex {
      */
     dispose() {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
+            var _a;
             this.disposed = true;
-            yield Promise.all([(_a = this.wsClient) === null || _a === void 0 ? void 0 : _a.dispose(), (_b = this.edgeWsClient) === null || _b === void 0 ? void 0 : _b.dispose()]);
+            yield Promise.all([
+                (_a = this.wsClient) === null || _a === void 0 ? void 0 : _a.dispose(),
+                ...Array.from(this.edgeWsClients.values(), (edge) => edge.dispose()),
+            ]);
         });
     }
     /**
@@ -163,7 +167,7 @@ class Codex {
      * @returns A cleanup function to unsubscribe from the subscription.
      */
     subscribe(doc, args, sink, options) {
-        var _a;
+        var _a, _b;
         if (!this.wsClient) {
             throw new Error("Websocket is not enabled in the config");
         }
@@ -173,15 +177,18 @@ class Codex {
         if (!(options === null || options === void 0 ? void 0 : options.useEdge))
             return this.wsClient.subscribe(payload, sink);
         // Validate before creating the edge transport or starting an operation.
-        const snapshot = (0, edge_1.prepareEdgeSubscription)(payload);
-        if (!this.edgeWsClient) {
-            const config = this.parseConfig((_a = this.apiConfig) !== null && _a !== void 0 ? _a : {});
-            this.edgeWsClient = (0, edge_1.createEdgeClient)(Object.assign(Object.assign({}, this.websocketOptions(config)), { url: config.apiEdgeUrl }));
-            this.edgeWsClient.on("error", (error) => {
+        const { payload: snapshot, networkId } = (0, edge_1.prepareEdgeSubscription)(payload);
+        const config = this.parseConfig((_a = this.apiConfig) !== null && _a !== void 0 ? _a : {});
+        const url = (_b = config.apiEdgeUrl) !== null && _b !== void 0 ? _b : (0, edge_1.edgeUrlForNetwork)(networkId);
+        let edge = this.edgeWsClients.get(url);
+        if (!edge) {
+            edge = (0, edge_1.createEdgeClient)(Object.assign(Object.assign({}, this.websocketOptions(config)), { url }));
+            edge.on("error", (error) => {
                 console.error("Websocket error: ", error);
             });
+            this.edgeWsClients.set(url, edge);
         }
-        return this.edgeWsClient.subscribe(snapshot, sink);
+        return edge.subscribe(snapshot, sink);
     }
 }
 exports.Codex = Codex;

package/dist/sdk/index.mjs

@@ -1,7 +1,7 @@
 import { GraphQLClient } from "graphql-request";
 import { createClient, } from "graphql-ws";
 import WebSocket from "isomorphic-ws";
-import { createEdgeClient, prepareEdgeSubscription, } from "./edge";
+import { createEdgeClient, edgeUrlForNetwork, prepareEdgeSubscription, } from "./edge";
 import { invariant } from "./invariant";
 import { Mutation } from "./Mutation";
 import { Query } from "./Query";
@@ -19,6 +19,7 @@ export class Codex {
     constructor(apiKey, apiConfig) {
         this.apiKey = apiKey;
         this.apiConfig = apiConfig;
+        this.edgeWsClients = new Map();
         this.disposed = false;
         const config = this.parseConfig(this.apiConfig ?? {});
         this.queries = new Query(this);
@@ -77,9 +78,9 @@ export class Codex {
      */
     updateConfig(incomingConfig) {
         // If we have an existing websocket connection, dispose of it.
-        if (this.wsClient || this.edgeWsClient)
+        if (this.wsClient || this.edgeWsClients.size)
             void this.dispose();
-        this.edgeWsClient = undefined;
+        this.edgeWsClients.clear();
         this.disposed = false;
         this.apiConfig = { ...this.apiConfig, ...incomingConfig };
         // Merge the incoming config with the existing config.
@@ -105,7 +106,10 @@ export class Codex {
      */
     async dispose() {
         this.disposed = true;
-        await Promise.all([this.wsClient?.dispose(), this.edgeWsClient?.dispose()]);
+        await Promise.all([
+            this.wsClient?.dispose(),
+            ...Array.from(this.edgeWsClients.values(), (edge) => edge.dispose()),
+        ]);
     }
     /**
      * This is the preferred way to execute queries.
@@ -154,17 +158,20 @@ export class Codex {
         if (!options?.useEdge)
             return this.wsClient.subscribe(payload, sink);
         // Validate before creating the edge transport or starting an operation.
-        const snapshot = prepareEdgeSubscription(payload);
-        if (!this.edgeWsClient) {
-            const config = this.parseConfig(this.apiConfig ?? {});
-            this.edgeWsClient = createEdgeClient({
+        const { payload: snapshot, networkId } = prepareEdgeSubscription(payload);
+        const config = this.parseConfig(this.apiConfig ?? {});
+        const url = config.apiEdgeUrl ?? edgeUrlForNetwork(networkId);
+        let edge = this.edgeWsClients.get(url);
+        if (!edge) {
+            edge = createEdgeClient({
                 ...this.websocketOptions(config),
-                url: config.apiEdgeUrl,
+                url,
             });
-            this.edgeWsClient.on("error", (error) => {
+            edge.on("error", (error) => {
                 console.error("Websocket error: ", error);
             });
+            this.edgeWsClients.set(url, edge);
         }
-        return this.edgeWsClient.subscribe(snapshot, sink);
+        return edge.subscribe(snapshot, sink);
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codex-data/sdk",
-  "version": "2.4.11",
+  "version": "2.5.1",
   "engines": {
     "node": ">=17.5.0"
   },

package/schema.graphql

@@ -937,6 +937,8 @@ type Query {
   walletChart(
     input: WalletChartInput!
   ): WalletChartResponse
+  """Returns the compute units charged for the request that carries this field, so you can see what a query costs before you run it at volume. Add it to any query; the field itself is free. `total` is the whole request; `items` lists each priced component. When the whole request was free (every root field errored), all values are zero."""
+  usageData: UsageData!
   """Returns the sniper, bundler and insider wallets that still hold a token, and how much of the supply they hold."""
   tokenWalletStats(
     input: TokenWalletStatsInput!
@@ -6504,6 +6506,20 @@ type SearchPredictionEvent {
   resolvedAt: Int
 }
 
+"""The number of a prediction event's markets in each market status."""
+type PredictionEventMarketCounts {
+  """Markets accepting trades."""
+  open: Int!
+  """Markets with trading temporarily halted. Not derived today, so always 0."""
+  suspended: Int!
+  """Markets whose outcome is determined or that are closed."""
+  resolved: Int!
+  """Markets that were invalidated. Not derived today, so always 0."""
+  cancelled: Int!
+  """Markets that have not opened yet."""
+  pending: Int!
+}
+
 """A prediction event matching a set of filter parameters."""
 type PredictionEventFilterResult {
   """The unique identifier."""
@@ -6540,6 +6556,8 @@ type PredictionEventFilterResult {
   markets: [PredictionEventFilterResultMarket!]!
   """Data for marketCount."""
   marketCount: Int!
+  """The number of the event's markets in each status; the counts add up to marketCount. Null for events not reindexed since this field was added."""
+  marketCounts: PredictionEventMarketCounts
   """Categories associated with this entity."""
   categories: [String!]!
   """The resolution source."""
@@ -9545,23 +9563,23 @@ type TokenFilterResult {
   swapPct1dOldWallet: String
   """The percentage of wallets that are less than 7d old that have traded in the last 24h"""
   swapPct7dOldWallet: String
-  """The number of wallets that have sniped the token"""
+  """The number of wallets that have sniped the token. Null for a token without a launchpad; `tokenWalletStats` serves EVM ones."""
   sniperCount: Int
-  """The percentage of tokens held by snipers"""
+  """The percentage of tokens held by snipers. Null for a token without a launchpad; `tokenWalletStats` serves EVM ones."""
   sniperHeldPercentage: Float
-  """The number of wallets that have bundled the token"""
+  """The number of wallets that have bundled the token. Null for a token without a launchpad; `tokenWalletStats` serves EVM ones."""
   bundlerCount: Int
-  """The percentage of tokens held by bundlers"""
+  """The percentage of tokens held by bundlers. Null for a token without a launchpad; `tokenWalletStats` serves EVM ones."""
   bundlerHeldPercentage: Float
-  """The number of wallets that have been an insider of the token"""
+  """The number of wallets that have been an insider of the token. Null for a token without a launchpad; `tokenWalletStats` serves EVM ones."""
   insiderCount: Int
-  """The percentage of tokens held by insiders"""
+  """The percentage of tokens held by insiders. Null for a token without a launchpad; `tokenWalletStats` serves EVM ones."""
   insiderHeldPercentage: Float
-  """The number of suspicious wallets (deduplicated union of snipers, bundlers, and insiders)"""
+  """The number of suspicious wallets (deduplicated union of snipers, bundlers, and insiders). Null for a token without a launchpad; `tokenWalletStats` serves EVM ones."""
   suspiciousCount: Int
-  """The percentage of tokens held by suspicious wallets"""
+  """The percentage of tokens held by suspicious wallets. Null for a token without a launchpad; `tokenWalletStats` serves EVM ones."""
   suspiciousHeldPercentage: Float
-  """The percentage of tokens held by the dev"""
+  """The percentage of tokens held by the dev. Null for a token without a launchpad; `tokenWalletStats` serves EVM ones."""
   devHeldPercentage: Float
   """The percentage of total supply held by the top 10 holders."""
   top10HoldersPercent: Float
@@ -13205,23 +13223,23 @@ input TokenFilters {
   poolFees24: NumberFilter
   """Filter by fee to volume ratio in the past 24 hours."""
   feeToVolumeRatio24: NumberFilter
-  """Filter by number of wallets that have sniped the token"""
+  """Filter by number of wallets that have sniped the token. Covers launchpad tokens only; any other token never matches."""
   sniperCount: NumberFilter
-  """Filter by percentage of tokens held by snipers"""
+  """Filter by percentage of tokens held by snipers. Covers launchpad tokens only; any other token never matches."""
   sniperHeldPercentage: NumberFilter
-  """Filter by number of wallets that have bundled the token"""
+  """Filter by number of wallets that have bundled the token. Covers launchpad tokens only; any other token never matches."""
   bundlerCount: NumberFilter
-  """Filter by percentage of tokens held by bundlers"""
+  """Filter by percentage of tokens held by bundlers. Covers launchpad tokens only; any other token never matches."""
   bundlerHeldPercentage: NumberFilter
-  """Filter by number of wallets that have been an insider of the token"""
+  """Filter by number of wallets that have been an insider of the token. Covers launchpad tokens only; any other token never matches."""
   insiderCount: NumberFilter
-  """Filter by percentage of tokens held by insiders"""
+  """Filter by percentage of tokens held by insiders. Covers launchpad tokens only; any other token never matches."""
   insiderHeldPercentage: NumberFilter
-  """Filter by number of suspicious wallets (deduplicated union of snipers, bundlers, and insiders)"""
+  """Filter by number of suspicious wallets (deduplicated union of snipers, bundlers, and insiders). Covers launchpad tokens only; any other token never matches."""
   suspiciousCount: NumberFilter
-  """Filter by percentage of tokens held by suspicious wallets"""
+  """Filter by percentage of tokens held by suspicious wallets. Covers launchpad tokens only; any other token never matches."""
   suspiciousHeldPercentage: NumberFilter
-  """Filter by percentage of tokens held by the dev"""
+  """Filter by percentage of tokens held by the dev. Covers launchpad tokens only; any other token never matches."""
   devHeldPercentage: NumberFilter
   """Filter by top 10 holders percentage."""
   top10HoldersPercent: NumberFilter
@@ -17324,6 +17342,36 @@ input WalletAggregateBackfillStateInput {
   walletAddress: String!
 }
 
+"""Response returned by `usageData`: the compute units charged for the request that carried the field."""
+type UsageData {
+  """Each priced component of the request: one entry per operation, per-object type, or priced field."""
+  items: [UsageDataItem!]!
+  """Totals across all items."""
+  total: UsageDataMetrics!
+}
+
+"""Usage metrics for one priced component, or for the whole request. Values are integers returned as strings."""
+type UsageDataMetrics {
+  """Billable units, not requests: 1 per call of a priced field, or the number of objects returned for a per-object cost."""
+  count: String!
+  """Response bytes measured for this component. Reported for reference; standard pricing does not bill it."""
+  bytes: String!
+  """Processing time in milliseconds measured for this component. Reported for reference; standard pricing does not bill it."""
+  durationMs: String!
+  """Compute units charged, with six decimals of precision: 1,000,000 = 1 CU."""
+  computeUnits: String!
+}
+
+"""One priced component of a request."""
+type UsageDataItem {
+  """The operation or field that was priced, for example `filterTokens` or `filterTokens.results.token`."""
+  resource: String!
+  """For a per-object cost, the type of the objects counted (for example `EnhancedToken`). Null for operation and field costs."""
+  entityType: String
+  """The metrics charged for this component."""
+  metrics: UsageDataMetrics!
+}
+
 """Input for `tokenWalletStats`."""
 input TokenWalletStatsInput {
   """The contract address of the token."""
@@ -17332,7 +17380,7 @@ input TokenWalletStatsInput {
   networkId: Int!
 }
 
-"""The sniper, bundler and insider wallets that still hold a token. Counts, amounts and addresses cover current holders only: a labelled wallet that has sold its whole balance is left out, so every figure falls as those wallets sell. Available for launchpad tokens on every network, and for EVM tokens without a launchpad that have a known creator and were created since 2025-10-08. Other tokens return zeros."""
+"""The sniper, bundler and insider wallets that still hold a token. Counts, amounts and addresses cover current holders only: a labelled wallet that has sold its whole balance is left out, so every figure falls as those wallets sell. Each label reads at most 1,000 holders; past that, its count reads 1,000 and its amount and percentage cover those holders only. Available for launchpad tokens on every network, and for EVM tokens without a launchpad that have a known creator and were created since 2025-10-08. Read `covered` first: for any other token it is false, and every figure is 0 because nothing was measured."""
 type TokenWalletStats {
   """The ID of the token (`address:networkId`)."""
   tokenId: String!
@@ -17342,7 +17390,9 @@ type TokenWalletStats {
   networkId: Int!
   """The total supply of the token, unshifted. Every held percentage is measured against it."""
   tokenTotalSupply: String!
-  """The number of sniper wallets that hold this token. A sniper bought within the first 5 seconds of trading."""
+  """Whether Codex tracks snipers, bundlers and insiders for this token. When false, every count and percentage is 0 because nothing was measured, not because none were found."""
+  covered: Boolean!
+  """The number of sniper wallets that hold this token. A sniper bought within the first 5 seconds of trading. The creator's own buy at launch counts."""
   sniperCount: Int!
   """The percentage of token supply held by sniper wallets."""
   sniperHeldPercentage: Float!
@@ -17350,7 +17400,7 @@ type TokenWalletStats {
   sniperAddresses: [String!]!
   """The amount of the token held by sniper wallets, unshifted."""
   sniperHeldAmount: String!
-  """The number of bundler wallets that hold this token. A bundler is one of 4 or more wallets that bought the token in the same block at launch."""
+  """The number of bundler wallets that hold this token. A bundler is one of 4 or more wallets that bought the token in the same block while it was on its launchpad, or in its first hour when it has none. A wallet one sender bought a large share for, alongside other wallets in the same block, is a bundler too."""
   bundlerCount: Int!
   """The percentage of token supply held by bundler wallets."""
   bundlerHeldPercentage: Float!
@@ -17358,7 +17408,7 @@ type TokenWalletStats {
   bundlerAddresses: [String!]!
   """The amount of the token held by bundler wallets, unshifted."""
   bundlerHeldAmount: String!
-  """The number of insider wallets that hold this token. An insider received the token through a link to its creator rather than by buying it on the open market."""
+  """The number of insider wallets that hold this token. An insider got the token through a link to its creator rather than by buying it on the open market: it bought in the creation transaction, received the token from the creator, or was first funded by the creator. On Solana, a wallet seeded with the token in its first minutes without buying it is an insider too."""
   insiderCount: Int!
   """The percentage of token supply held by insider wallets."""
   insiderHeldPercentage: Float!