@codex-data/sdk 1.0.0-rc2 → 1.0.0

package/src/resources/schema.graphql

@@ -443,9 +443,7 @@ input CreateApiTokensInput {
   """
   requestLimit: String
 
-  """
-  Number of milliseconds until the token expires, defaults to 1 hour (3600000)
-  """
+  """Number of seconds until the token expires, defaults to 1 hour (3600)"""
   expiresIn: Int
 }
 
@@ -460,6 +458,7 @@ input CreateNftEventWebhookArgs {
   bucketId: String
   bucketSortkey: String
   publishingType: PublishingType
+  deduplicate: Boolean
 }
 
 input CreateNftEventWebhooksInput {
@@ -477,6 +476,7 @@ input CreatePriceWebhookArgs {
   bucketId: String
   bucketSortkey: String
   publishingType: PublishingType
+  deduplicate: Boolean
 }
 
 input CreatePriceWebhooksInput {
@@ -494,6 +494,7 @@ input CreateRawTransactionWebhookArgs {
   bucketId: String
   bucketSortkey: String
   publishingType: PublishingType
+  deduplicate: Boolean
 }
 
 input CreateRawTransactionWebhooksInput {
@@ -511,6 +512,7 @@ input CreateTokenPairEventWebhookArgs {
   bucketId: String
   bucketSortkey: String
   publishingType: PublishingType
+  deduplicate: Boolean
 }
 
 input CreateTokenPairEventWebhooksInput {
@@ -1473,6 +1475,7 @@ input GetGasEstimateInput {
   walletId: Int
   customGas: String
   sendWithPrivateRpc: Boolean
+  slippage: Float
 }
 
 """Response returned by `getNetworkStats`."""
@@ -1519,6 +1522,9 @@ input GetPriceInput {
   """The unix timestamp for the price."""
   timestamp: Int
 
+  """The address of the pool, when omitted the top pool is used."""
+  poolAddress: String
+
   """
   The maximum number of deviations from the token's Liquidity-Weighted Mean Price. This is used to mitigate low liquidity pairs producing prices that are not representative of reality. Default is `1`.
   """
@@ -1534,6 +1540,7 @@ input GetQuoteInput {
   exchangeAddress: String
   userId: Int
   customGas: String
+  slippage: Float
 }
 
 type GetSimulateTokenContractResultsConnection {
@@ -5667,6 +5674,9 @@ type OnBarsUpdatedResponse {
 
   """The quote token within the pair."""
   quoteToken: QuoteToken
+
+  """The address of the token being quoted"""
+  quoteTokenAddress: String!
 }
 
 type OneOfNumberCondition {
@@ -5682,11 +5692,77 @@ input OnPricesUpdatedInput {
   networkId: Int!
 }
 
+"""Response returned by `onBarsUpdated`."""
+type OnTokenBarsUpdatedResponse {
+  """The contract address for the pair."""
+  pairAddress: String!
+
+  """The network ID the pair is deployed on."""
+  networkId: Int!
+
+  """The ID for the pair (`pairAddress`:`networkId`)."""
+  pairId: String!
+
+  """The unix timestamp for the new bar."""
+  timestamp: Int!
+
+  """The type of statistics used. Can be `Filtered` or `Unfiltered`."""
+  statsType: TokenPairStatisticsType!
+
+  """
+  The sortKey for the bar (`blockNumber`#`transactionIndex`#`logIndex`, zero padded).
+  For example, `0000000016414564#00000224#00000413`.
+  """
+  eventSortKey: String!
+
+  """Price data broken down by resolution."""
+  aggregates: ResolutionBarData!
+
+  """The quote token within the pair."""
+  quoteToken: QuoteToken
+
+  """The address of the token being quoted"""
+  tokenAddress: String!
+
+  """The address of the token being quoted"""
+  tokenId: String!
+}
+
 input OnTokenEventsCreatedInput {
   tokenAddress: String!
   networkId: Int!
 }
 
+"""Response returned by `onUnconfirmedBarsUpdated`."""
+type OnUnconfirmedBarsUpdated {
+  """The contract address for the pair."""
+  pairAddress: String!
+
+  """The network ID the pair is deployed on."""
+  networkId: Int!
+
+  """The ID for the pair (`pairAddress`:`networkId`)."""
+  pairId: String!
+
+  """The unix timestamp for the new bar."""
+  timestamp: Int!
+
+  """
+  The sortKey for the bar (`blockNumber`#`transactionIndex`#`logIndex`, zero padded).
+  For example, `0000000016414564#00000224#00000413`.
+  """
+  eventSortKey: String!
+
+  """Price data broken down by resolution."""
+  aggregates: UnconfirmedResolutionBarData!
+
+  """The quote token within the pair."""
+  quoteToken: QuoteToken
+
+  """The address of the token being quoted"""
+  quoteTokenAddress: String!
+}
+
 enum OrderState {
   CREATED
   PENDING
@@ -5882,6 +5958,18 @@ type PairFilterResult {
   """The percent price change in the past 24 hours. Decimal format."""
   priceChange24: String
 
+  """The percent volume change in the past hour. Decimal format."""
+  volumeChange1: String
+
+  """The percent volume change in the past 4 hours. Decimal format."""
+  volumeChange4: String
+
+  """The percent volume change in the past 12 hours. Decimal format."""
+  volumeChange12: String
+
+  """The percent volume change in the past 24 hours. Decimal format."""
+  volumeChange24: String
+
   """The number of sells in the past hour."""
   sellCount1: Int
 
@@ -6032,6 +6120,18 @@ input PairFilters {
   """The percent price change in the past 4 hours. Decimal format."""
   priceChange4: NumberFilter
 
+  """The percent volume change in the past hour. Decimal format."""
+  volumeChange1: NumberFilter
+
+  """The percent volume change in the past 4 hours. Decimal format."""
+  volumeChange4: NumberFilter
+
+  """The percent volume change in the past 12 hours. Decimal format."""
+  volumeChange12: NumberFilter
+
+  """The percent volume change in the past 24 hours. Decimal format."""
+  volumeChange24: NumberFilter
+
   """The number of sells in the past hour."""
   sellCount1: NumberFilter
 
@@ -6196,6 +6296,10 @@ enum PairRankingAttribute {
   priceChange4
   priceChange12
   priceChange24
+  volumeChange1
+  volumeChange4
+  volumeChange12
+  volumeChange24
   sellCount1
   sellCount4
   sellCount12
@@ -6698,6 +6802,9 @@ type Price {
   """The unix timestamp for the price."""
   timestamp: Int!
 
+  """The pool that emitted the swap generating this price"""
+  poolAddress: String!
+
   """Ratio of how confident we are in the price"""
   confidence: Float
 }
@@ -7868,7 +7975,7 @@ type Query {
     phrase: String
 
     """
-    A list of token IDs (`address:networkId`). Can be left blank to discover new tokens.
+    A list of token IDs (`address:networkId`) or addresses. Can be left blank to discover new tokens.
     """
     tokens: [String]
 
@@ -8359,6 +8466,7 @@ type Quote {
   poolFee: String
   poolFeeBps: Float
   quotedAmount: String!
+  outputAmountMin: String
   quoteType: QuoteType!
   tradeFee: String!
   tradeFeeBps: Float!
@@ -8392,16 +8500,6 @@ enum QuoteType {
   OUTPUT
 }
 
-type QuoteV2 {
-  poolFee: String
-  poolFeeBps: Float
-  quotedAmount: String!
-  quoteType: QuoteType!
-  tradeFee: String!
-  tradeFeeBps: Float!
-  exchange: QuoteExchange!
-}
-
 """The order of ranking."""
 enum RankingDirection {
   ASC
@@ -8486,6 +8584,9 @@ type ResolutionBarData {
   """15 second resolution."""
   r15S: CurrencyBarData
 
+  """30 second resolution."""
+  r30S: CurrencyBarData
+
   """1 minute resolution."""
   r1: CurrencyBarData
 
@@ -8954,6 +9055,28 @@ type Subscription {
     statsType: TokenPairStatisticsType
   ): OnBarsUpdatedResponse
 
+  """
+  Unconfirmed live-streamed bar chart data to track price changes over time. (Solana only)
+  """
+  onUnconfirmedBarsUpdated(
+    """The ID of the pair (`address`:`networkId`)."""
+    pairId: String
+
+    """The token of interest within the pair. Can be `token0` or `token1`."""
+    quoteToken: QuoteToken
+  ): OnUnconfirmedBarsUpdated
+
+  """
+  Live-streamed bar chart data to track price changes over time for a token.
+  """
+  onTokenBarsUpdated(
+    """The ID of the pair (`address`:`networkId`)."""
+    tokenId: String
+
+    """docs: hide"""
+    statsType: TokenPairStatisticsType
+  ): OnTokenBarsUpdatedResponse
+
   """Live-streamed transactions for a token."""
   onEventsCreated(
     """The pair contract address."""
@@ -9422,6 +9545,18 @@ type TokenFilterResult {
   """The percent price change in the past 4 hours. Decimal format."""
   change4: String
 
+  """The percent volume change in the past hour. Decimal format."""
+  volumeChange1: String
+
+  """The percent volume change in the past 4 hours. Decimal format."""
+  volumeChange4: String
+
+  """The percent volume change in the past 12 hours. Decimal format."""
+  volumeChange12: String
+
+  """The percent volume change in the past 24 hours. Decimal format."""
+  volumeChange24: String
+
   """The exchanges the token is listed on."""
   exchanges: [Exchange]
   fdv: String @deprecated(reason: "FDV isn't supported - use marketCap instead")
@@ -9582,6 +9717,18 @@ input TokenFilters {
   """The percent price change in the past 4 hours. Decimal format."""
   change4: NumberFilter
 
+  """The percent volume change in the past hour. Decimal format."""
+  volumeChange1: NumberFilter
+
+  """The percent volume change in the past 4 hours. Decimal format."""
+  volumeChange4: NumberFilter
+
+  """The percent volume change in the past 12 hours. Decimal format."""
+  volumeChange12: NumberFilter
+
+  """The percent volume change in the past 24 hours. Decimal format."""
+  volumeChange24: NumberFilter
+
   """
   The list of exchange contract IDs to filter by. Applied in conjunction with `network` filter using an OR condition. When used together, the query returns results that match either the specified exchanges or the specified network.
   """
@@ -9925,6 +10072,10 @@ enum TokenRankingAttribute {
   change4
   change12
   change24
+  volumeChange1
+  volumeChange4
+  volumeChange12
+  volumeChange24
   high1
   high4
   high12
@@ -10183,6 +10334,30 @@ type UnconfirmedEvent {
 
 union UnconfirmedEventData = UnconfirmedSwapEventData | UnconfirmedLiquidityChangeEventData
 
+"""Unconfirmed bar chart data."""
+type UnconfirmedIndividualBarData {
+  """The opening price."""
+  o: Float!
+
+  """The high price."""
+  h: Float!
+
+  """The low price."""
+  l: Float!
+
+  """The closing price."""
+  c: Float!
+
+  """The volume."""
+  v: Int
+
+  """The volume with higher precision."""
+  volume: String!
+
+  """The timestamp for the bar."""
+  t: Int!
+}
+
 type UnconfirmedLiquidityChangeEventData {
   """The amount of `token0` added or removed from the pair."""
   amount0: String
@@ -10204,12 +10379,53 @@ type UnconfirmedLiquidityChangeEventData {
   type: EventType!
 }
 
+"""Unconfirmed price data for each supported resolution."""
+type UnconfirmedResolutionBarData {
+  """1 second resolution."""
+  r1S: UnconfirmedIndividualBarData
+
+  """5 second resolution."""
+  r5S: UnconfirmedIndividualBarData
+
+  """15 second resolution."""
+  r15S: UnconfirmedIndividualBarData
+
+  """1 minute resolution."""
+  r1: UnconfirmedIndividualBarData
+
+  """5 minute resolution."""
+  r5: UnconfirmedIndividualBarData
+
+  """15 minute resolution."""
+  r15: UnconfirmedIndividualBarData
+}
+
 type UnconfirmedSwapEventData {
   """
   The amount of `quoteToken` involved in the swap. For example, if `quoteToken` is USDC for a USDC/WETH pair, `amountNonLiquidityToken` would be the amount of USDC involved in the swap.
   """
   amountNonLiquidityToken: String
 
+  """
+  The price per `quoteToken` at the time of the swap in the network's base token. For example, if `quoteToken` is USDC for a USDC/WETH pair on ETH network, `priceBaseToken` would the price of USDC in ETH.
+  """
+  priceBaseToken: String
+
+  """
+  The total amount of `quoteToken` involved in the swap in the network's base token (`amountNonLiquidityToken` x `priceBaseToken`).
+  """
+  priceBaseTokenTotal: String
+
+  """
+  The price per `quoteToken` at the time of the swap in USD. For example, if `quoteToken` is USDC for a USDC/WETH pair on ETH network, `priceBaseToken` would the price of USDC in USD ($1.00).
+  """
+  priceUsd: String
+
+  """
+  The total amount of `quoteToken` involved in the swap in USD (`amountNonLiquidityToken` x `priceUsd`).
+  """
+  priceUsdTotal: String
+
   """The type of token event, `Swap`."""
   type: EventType!
 }

package/src/resources/subscriptions_override/OnEventLabelCreated.graphql

@@ -0,0 +1,22 @@
+subscription OnEventLabelCreated($id: String) {
+  onEventLabelCreated(id: $id) {
+    data {
+      ... on FrontRunLabelData {
+        index
+        token0DrainedAmount
+        token1DrainedAmount
+      }
+      ... on SandwichedLabelData {
+        token0DrainedAmountSandwich: token0DrainedAmount
+        token1DrainedAmountSandwich: token1DrainedAmount
+      }
+    }
+    id
+    label
+    logIndex
+    networkId
+    timestamp
+    transactionHash
+    transactionIndex
+  }
+}

package/src/scripts/generateGraphql.ts

@@ -25,6 +25,7 @@ type SchemaType = {
   description?: string | null;
   type: SchemaTypeDefinition;
   isDeprecated?: boolean | null;
+  possibleTypes?: SchemaType[];
   fields?: SchemaType[];
 };
 
@@ -41,13 +42,41 @@ export const getLeafType = (
   currentName: string,
   level = 0,
 ): Fields => {
-  if (level > 8 || !type?.kind || type.kind === "UNION" || type.isDeprecated)
-    return result;
+  if (level > 8 || !type?.kind || type.isDeprecated) return result;
 
   // If it's a scalar, return the name
   if (type.kind === "SCALAR" || type.kind === "ENUM")
     return [...result, currentName!];
 
+  if (type.kind === "UNION") {
+    // Find all the possible types
+    const possibleTypes = allTypes.find((t) => t.name === type.name)
+      ?.possibleTypes;
+
+    // For each of the possible types, treat it as a sub object with a set of fields
+    const possibleTypeLeaves = possibleTypes
+      ?.map((f: SchemaType) => {
+        const resolvedType = allTypes.find(
+          (t) => t.name === f.name,
+        ) as unknown as SchemaTypeDefinition;
+        return getLeafType(
+          resolvedType,
+          allTypes,
+          [],
+          `... on ${f.name}`,
+          level + 1,
+        );
+      })
+      .flat();
+
+    if (!possibleTypeLeaves?.length) {
+      console.log("No possible types for union", type);
+      throw new Error(`No possible types for union type ${currentName}`);
+    }
+
+    return [...result, ...[{ [currentName]: possibleTypeLeaves }]];
+  }
+
   // If it's an object resolve it.
   if (type.kind === "OBJECT") {
     // For each of the fields of the subtype, resolve them
@@ -162,12 +191,26 @@ async function run() {
       "generated_mutations",
     );
     await mkdirp(mutationsFolderPath);
-    fs.writeFileSync(
-      path.join(mutationsFolderPath, `${capitalize(field.name)}.graphql`),
-      `mutation ${capitalize(field.name)}${mutationBuilderObject.query
-        .toString()
-        .slice("mutation ".length)}`,
+
+    const overridePath = path.join(
+      __dirname,
+      "..",
+      "resources",
+      "mutations_override",
     );
+    const filename = `${capitalize(field.name)}.graphql`;
+    const filePath = path.join(mutationsFolderPath, filename);
+
+    // If we have an override, use it.
+    if (fs.existsSync(path.join(overridePath, filename)))
+      fs.copyFileSync(path.join(overridePath, filename), filePath);
+    else
+      fs.writeFileSync(
+        filePath,
+        `mutation ${capitalize(field.name)}${mutationBuilderObject.query
+          .toString()
+          .slice("mutation ".length)}`,
+      );
   }
 
   for (const field of subscriptionType.fields) {
@@ -190,14 +233,28 @@ async function run() {
       "generated_subscriptions",
     );
     await mkdirp(subscriptionsFolderPath);
-    fs.writeFileSync(
-      path.join(subscriptionsFolderPath, `${capitalize(field.name)}.graphql`),
-      `subscription ${capitalize(field.name)}${subscriptionBuilderObject.query
-        .toString()
-        .slice("subscription ".length)}`,
+
+    const overridePath = path.join(
+      __dirname,
+      "..",
+      "resources",
+      "subscriptions_override",
     );
+    const filename = `${capitalize(field.name)}.graphql`;
+    const subPath = path.join(subscriptionsFolderPath, filename);
+    // If we have an override, use it.
+    if (fs.existsSync(path.join(overridePath, filename)))
+      fs.copyFileSync(path.join(overridePath, filename), subPath);
+    else
+      fs.writeFileSync(
+        subPath,
+        `subscription ${capitalize(field.name)}${subscriptionBuilderObject.query
+          .toString()
+          .slice("subscription ".length)}`,
+      );
   }
 
+  // Write queries
   for (const field of queryType.fields) {
     if (field.isDeprecated) {
       console.log("Skipping deprecated field", field.name);
@@ -224,12 +281,25 @@ async function run() {
       "generated_queries",
     );
     await mkdirp(queriesFolderPath);
-    fs.writeFileSync(
-      path.join(queriesFolderPath, `${capitalize(field.name)}.graphql`),
-      `query ${capitalize(field.name)}${queryBuilderObject.query
-        .toString()
-        .slice("query ".length)}`,
+
+    const overridePath = path.join(
+      __dirname,
+      "..",
+      "resources",
+      "queries_override",
     );
+    const queryFileName = `${capitalize(field.name)}.graphql`;
+    const queryPath = path.join(queriesFolderPath, queryFileName);
+    // If we have an override, use it.
+    if (fs.existsSync(path.join(overridePath, queryFileName)))
+      fs.copyFileSync(path.join(overridePath, queryFileName), queryPath);
+    else
+      fs.writeFileSync(
+        queryPath,
+        `query ${capitalize(field.name)}${queryBuilderObject.query
+          .toString()
+          .slice("query ".length)}`,
+      );
   }
 }