@luxexchange/api 1.0.0 → 1.0.1

package/src/clients/graphql/schema.graphql

@@ -1,76 +1,130 @@
-"""This directive allows results to be deferred during execution"""
-directive @defer on FIELD
-
-"""
-Tells the service which subscriptions will be published to when this mutation is
-called. This directive is deprecated use @aws_susbscribe directive instead.
-"""
-directive @aws_publish(
-  """
-  List of subscriptions which will be published to when this mutation is called.
-  """
-  subscriptions: [String]
-) on FIELD_DEFINITION
-
-"""
-Tells the service this field/object has access authorized by an API key.
-"""
-directive @aws_api_key on OBJECT | FIELD_DEFINITION
-
-"""
-Tells the service this field/object has access authorized by an OIDC token.
-"""
-directive @aws_oidc on OBJECT | FIELD_DEFINITION
-
-"""Directs the schema to enforce authorization on a field"""
-directive @aws_auth(
-  """List of cognito user pool groups which have access on this field"""
-  cognito_groups: [String]
-) on FIELD_DEFINITION
-
-"""Tells the service which mutation triggers this subscription."""
-directive @aws_subscribe(
-  """
-  List of mutations which will trigger this subscription when they are called.
-  """
-  mutations: [String]
-) on FIELD_DEFINITION
-
-"""
-Tells the service this field/object has access authorized by a Lambda Authorizer.
-"""
-directive @aws_lambda on OBJECT | FIELD_DEFINITION
-
-"""
-Tells the service this field/object has access authorized by a Cognito User Pools token.
-"""
-directive @aws_cognito_user_pools(
-  """List of cognito user pool groups which have access on this field"""
-  cognito_groups: [String]
-) on OBJECT | FIELD_DEFINITION
-
-"""
-Tells the service this field/object has access authorized by sigv4 signing.
-"""
-directive @aws_iam on OBJECT | FIELD_DEFINITION
-
-"""
-  Types, unions, and inputs (alphabetized):
- These are colocated to highlight the relationship between some types and their inputs.
-"""
-union ActivityDetails = TransactionDetails | SwapOrderDetails | OnRampTransactionDetails | OffRampTransactionDetails
+# To update this file, run `bun api graphql:schema`
+schema {
+  query: Query
+  mutation: Mutation
+  subscription: Subscription
+}
 
-input ActivityDetailsInput {
-  transactionDetails: TransactionDetailsInput
-  swapOrderDetails: SwapOrderDetailsInput
-  onRampTransactionDetails: OnRampTransactionDetailsInput
-  offRampTransactionDetails: OffRampTransactionDetailsInput
+directive @aws_lambda on FIELD_DEFINITION
+directive @aws_subscribe(mutations: [String!]!) on FIELD_DEFINITION
+
+scalar AWSJSON
+
+type Query {
+  isV3SubgraphStale(chain: Chain!): Boolean
+  historicalProtocolVolume(chain: Chain!, version: ProtocolVersion!, duration: HistoryDuration!): [TimestampedAmount!]
+  dailyProtocolTvl(chain: Chain!, version: ProtocolVersion!): [TimestampedAmount!]
+  # returns top v3 pools sorted by total value locked in desc order
+  topV3Pools(chain: Chain!, first: Int!, tvlCursor: Float, tokenFilter: String, debugMode: Boolean): [V3Pool!]
+  topV4Pools(chain: Chain!, first: Int!, tvlCursor: Float, tokenFilter: String, debugMode: Boolean): [V4Pool!]
+  v3Pool(chain: Chain!, address: String!): V3Pool
+  v4Pool(chain: Chain!, poolId: String!): V4Pool
+  v3PoolsForTokenPair(chain: Chain!, token0: String!, token1: String!): [V3Pool!]
+  v4PoolsForTokenPair(chain: Chain!, token0: String!, token1: String!): [V4Pool!]
+  v3Transactions(chain: Chain!, first: Int!, timestampCursor: Int): [PoolTransaction!]
+  v4Transactions(chain: Chain!, first: Int!, timestampCursor: Int): [PoolTransaction!]
+  # returns top v2 pairs sorted by total value locked in desc order
+  topV2Pairs(chain: Chain!, first: Int!, tvlCursor: Float, tokenFilter: String, debugMode: Boolean): [V2Pair!]
+  v2Pair(chain: Chain!, address: String!): V2Pair
+  v2Transactions(chain: Chain!, first: Int!, timestampCursor: Int): [PoolTransaction]
+  convert(fromAmount: CurrencyAmountInput!, toCurrency: Currency!): Amount
+  tokens(contracts: [ContractInput!]!): [Token]
+  # token consumes chain and address instead of contract because the apollo client request cache can only use
+  # keys from the response, and the token response does not contain a contract, but does contain an unwrapped
+  # contract: chain and address.
+  token(chain: Chain!, address: String): Token
+  tokenProjects(contracts: [ContractInput!]!): [TokenProject]
+  searchTokens(searchQuery: String!, chains: [Chain!], tokenSearchV2Enabled: Boolean): [Token]
+  portfolios(
+    ownerAddresses: [String!]!
+    chains: [Chain!]
+    lookupTokens: [ContractInput!]
+    fungibleIds: [String!]
+    valueModifiers: [PortfolioValueModifier!]
+  ): [Portfolio]
+  "Returns a list of tokens in descending order based on orderBy (default: TOTAL_VALUE_LOCKED)."
+  topTokens(
+    chain: Chain = ETHEREUM
+    page: Int = 1
+    pageSize: Int = 20
+    orderBy: TokenSortableField = TOTAL_VALUE_LOCKED
+  ): [Token]
+  topCollections(
+    chains: [Chain!] = [ETHEREUM]
+    orderBy: CollectionSortableField = VOLUME
+    duration: HistoryDuration = DAY
+    after: String
+    first: Int
+    cursor: String
+    limit: Int
+  ): NftCollectionConnection
+  nftAssets(
+    chain: Chain = ETHEREUM
+    address: String!
+    orderBy: NftAssetSortableField
+    asc: Boolean
+    filter: NftAssetsFilterInput
+    after: String
+    first: Int
+    before: String
+    last: Int
+  ): NftAssetConnection
+  nftCollections(
+    chain: Chain = ETHEREUM
+    filter: NftCollectionsFilterInput
+    after: String
+    first: Int
+  ): NftCollectionConnection
+  nftBalances(
+    chain: Chain = ETHEREUM
+    ownerAddress: String!
+    filter: NftBalancesFilterInput
+    after: String
+    first: Int
+    before: String
+    last: Int
+    chains: [Chain!]
+  ): NftBalanceConnection
+  nftRoute(
+    chain: Chain = ETHEREUM
+    senderAddress: String!
+    nftTrades: [NftTradeInput!]!
+    tokenTrades: [TokenTradeInput!]
+  ): NftRouteResponse
+  nftActivity(chain: Chain = ETHEREUM, filter: NftActivityFilterInput, after: String, first: Int): NftActivityConnection
+  nftCollectionBalances(
+    chain: Chain = ETHEREUM
+    ownerAddress: String!
+    after: String
+    first: Int
+    before: String
+    last: Int
+  ): NftCollectionBalanceConnection
+  transactionNotification(
+    chain: Chain!
+    address: String!
+    transactionHash: String!
+    isBridging: Boolean
+  ): TransactionNotification
+}
+
+type Mutation {
+  "Called by the server to send data to onAssetActivity subscriptions."
+  assetActivity(input: AssetActivityInput!): AssetActivity!
+  "Returns true if the subscription is still alive."
+  heartbeat(subscriptionId: ID!, type: SubscriptionType!): Status!
+  "Returns true if the subscription was unsubscribed, or false if it did not exist."
+  unsubscribe(subscriptionId: ID!, type: SubscriptionType!): Status!
+}
+
+type Subscription {
+  "Subscribes to asset activities. The client must provide their own uuidv4."
+  onAssetActivity(subscriptionId: ID!, addresses: [String!]!): AssetActivity
+    @aws_lambda
+    @aws_subscribe(mutations: ["assetActivity"])
 }
 
-"""
-  Enums (alphabetized):
- deprecated and replaced with TransactionType, please do not use this
-"""
+
 enum ActivityType {
   APPROVE
   CANCEL
@@ -80,23 +134,328 @@ enum ActivityType {
   SWAP
   DEPLOYMENT
   UNKNOWN
-  money
-  market
+
+  #  money market
   LEND
   BORROW
   REPAY
   WITHDRAW
-  NFT
+
+  #  NFT
   MINT
   BURN
-  Staking
+
+  #  Staking
   STAKE
   UNSTAKE
+
+  SWAP_ORDER
+  ON_RAMP
+  OFF_RAMP
+}
+
+enum AssetActivitySwitch {
+  ALTERNATE
+  LEGACY
+}
+
+enum Chain {
+  ARBITRUM
+  AVALANCHE
+  ETHEREUM
+  ETHEREUM_GOERLI
+  ETHEREUM_SEPOLIA
+  OPTIMISM
+  POLYGON
+  CELO
+  BNB
+  BASE
+  BLAST
+  ZORA
+  ZKSYNC
+  UNICHAIN
+  SONEIUM
+  ASTROCHAIN_SEPOLIA
+  WORLDCHAIN
+  MONAD_TESTNET
+  MONAD
+  ARBITRUM_SEPOLIA
+  BASE_SEPOLIA
+  SOLANA
+  LINEA
+  XLAYER
+  MEGAETH
+  TEMPO
+  UNKNOWN_CHAIN
+}
+
+enum Currency {
+  ARS
+  AUD
+  BRL
+  CAD
+  CNY
+  COP
+  ETH
+  EUR
+  GBP
+  HKD
+  IDR
+  INR
+  JPY
+  KRW
+  MATIC
+  MXN
+  NGN
+  NZD
+  PKR
+  RUB
+  SGD
+  THB
+  TRY
+  UAH
+  USD
+  VND
+}
+
+enum TokenSource {
+  TOKEN_FACTORY
+}
+
+enum HighLow {
+  HIGH
+  LOW
+}
+
+enum HistoryDuration {
+  FIVE_MINUTE
+  HOUR
+  DAY
+  WEEK
+  MONTH
+  YEAR
+  MAX
+}
+
+enum MediaType {
+  VIDEO
+  IMAGE
+  RAW
+  AUDIO
+}
+
+enum NftMarketplace {
+  OPENSEA
+  LOOKSRARE
+  X2Y2
+  SUDOSWAP
+  NFTX
+  NFT20
+  FOUNDATION
+  CRYPTOPUNKS
+}
+
+enum OrderStatus {
+  VALID
+  EXECUTED
+  CANCELLED
+  EXPIRED
+}
+
+enum OrderType {
+  LISTING
+  OFFER
+}
+
+enum PoolTransactionType {
+  SWAP
+  ADD
+  REMOVE
+}
+
+enum PriceSource {
+  SUBGRAPH_V2
+  SUBGRAPH_V3
+  SUBGRAPH_V4
+  EXTERNAL
+}
+
+enum ProtocolVersion {
+  V2
+  V3
+  V4
+}
+
+enum SafetyLevel {
+  VERIFIED
+  MEDIUM_WARNING
+  STRONG_WARNING
+  BLOCKED
+}
+
+enum SubscriptionType {
+  ASSET_ACTIVITY
+}
+
+enum SwapOrderStatus {
+  OPEN
+  EXPIRED
+  ERROR
+  INSUFFICIENT_FUNDS
+  FILLED
+  CANCELLED
+}
+
+enum SwapOrderType {
+  DUTCH
+  LIMIT
+  DUTCH_V2
+  PRIORITY
+}
+
+enum TokenStandard {
+  NATIVE
+  ERC20
+  SPL
+}
+
+enum TransactionType {
+  APPROVE
+  BORROW
+  BRIDGING
+  CANCEL
+  CLAIM
+  DEPLOYMENT
+  EXECUTE
+  LEND
+  MINT
+  RECEIVE
+  REPAY
+  SEND
+  STAKE
+  SWAP
   SWAP_ORDER
+  UNKNOWN
+  UNSTAKE
+  WITHDRAW
   ON_RAMP
   OFF_RAMP
 }
 
+enum TokenSortableField {
+  TOTAL_VALUE_LOCKED
+  MARKET_CAP
+  VOLUME
+  POPULARITY
+}
+
+enum TransactionDirection {
+  IN
+  OUT
+  SELF
+}
+
+enum TransactionStatus {
+  FAILED
+  CONFIRMED
+  PENDING
+}
+
+enum NftStandard {
+  ERC721
+  ERC1155
+  NONCOMPLIANT
+}
+
+enum NftAssetSortableField {
+  PRICE
+  RARITY
+}
+
+enum NftRarityProvider {
+  RARITY_SNIPER
+}
+
+enum CollectionSortableField {
+  VOLUME
+}
+
+enum NftActivityType {
+  LISTING
+  SALE
+  CANCEL_LISTING
+  TRANSFER
+}
+
+enum TokenTradeType {
+  EXACT_INPUT
+  EXACT_OUTPUT
+}
+
+enum ProtectionResult {
+  UNKNOWN
+  MALICIOUS
+  BENIGN
+  SPAM
+  WARNING
+}
+
+enum ProtectionAttackType {
+  UNKNOWN
+  METADATA
+  INORGANIC_VOLUME
+  AIRDROP_PATTERN
+  DYNAMIC_ANALYSIS
+  STATIC_CODE_SIGNATURE
+  KNOWN_MALICIOUS
+  IMPERSONATOR
+  UNSTABLE_TOKEN_PRICE
+  RUGPULL
+  HIGH_FEES
+  HONEYPOT
+}
+
+
+interface IAmount {
+  currency: Currency
+  value: Float!
+}
+
+interface IContract {
+  chain: Chain!
+  address: String
+}
+
+interface IPool {
+  id: ID!
+  protocolVersion: ProtocolVersion!
+  chain: Chain!
+  address: String!
+  createdAtTimestamp: Int
+  totalLiquidity: Amount
+  token0: Token
+  token0Supply: Float
+  token1: Token
+  token1Supply: Float
+  txCount: Int
+
+  totalLiquidityPercentChange24h: Amount
+  cumulativeVolume(duration: HistoryDuration!): Amount
+  historicalVolume(duration: HistoryDuration!): [TimestampedAmount]
+  priceHistory(duration: HistoryDuration!): [TimestampedPoolPrice]
+  transactions(first: Int!, timestampCursor: Int): [PoolTransaction]
+}
+
+
+union ActivityDetails = TransactionDetails | SwapOrderDetails | OnRampTransactionDetails | OffRampTransactionDetails
+
+input ActivityDetailsInput {
+  transactionDetails: TransactionDetailsInput
+  swapOrderDetails: SwapOrderDetailsInput
+  onRampTransactionDetails: OnRampTransactionDetailsInput
+  offRampTransactionDetails: OffRampTransactionDetailsInput
+}
+
 type Amount implements IAmount {
   id: ID!
   currency: Currency
@@ -134,126 +493,37 @@ type AssetActivity {
   timestamp: Int!
   type: ActivityType! @deprecated(reason: "use type field in details")
   chain: Chain!
-  gasUsed: Float @deprecated(reason: "not required, remove usage")
-  transaction: Transaction! @deprecated(reason: "use fields from details")
-  assetChanges: [AssetChange]! @deprecated(reason: "use assetChanges field in details")
-  details: ActivityDetails!
-  addresses: [String!]
-}
-
-input AssetActivityInput {
-  timestamp: Int!
-  chain: Chain!
-  details: ActivityDetailsInput!
-}
-
-enum AssetActivitySwitch {
-  ALTERNATE
-  LEGACY
-}
-
-union AssetChange = TokenTransfer | NftTransfer | OnRampTransfer | TokenApproval | NftApproval | NftApproveForAll | OffRampTransfer
-
-input AssetChangeInput {
-  tokenTransfer: TokenTransferInput
-  tokenApproval: TokenApprovalInput
-  nftTransfer: NftTransferInput
-  nftApproval: NftApprovalInput
-  nftApproveForAll: NftApproveForAllInput
-  onRampTransfer: OnRampTransferInput
-  offRampTransfer: OffRampTransferInput
-}
-
-"""
-The `AWSJSON` scalar type provided by AWS AppSync, represents a JSON string that
-complies with [RFC 8259](https://tools.ietf.org/html/rfc8259).  Maps like
-"**{\\"upvotes\\": 10}**", lists like "**[1,2,3]**", and scalar values like
-"**\\"AWSJSON example string\\"**", "**1**", and "**true**" are accepted as
-valid JSON and will automatically be parsed and loaded in the resolver mapping
-templates as Maps, Lists, or Scalar values rather than as the literal input
-strings.  Invalid JSON strings like "**{a: 1}**", "**{'a': 1}**" and "**Unquoted
-string**" will throw GraphQL validation errors.
-"""
-scalar AWSJSON
-
-type BlockaidFees {
-  transfer: Float
-  buy: Float
-  sell: Float
-}
-
-type BridgedWithdrawalInfo {
-  chain: String!
-  provider: String!
-  url: String!
-}
-
-enum Chain {
-  ARBITRUM
-  AVALANCHE
-  ETHEREUM
-  ETHEREUM_GOERLI
-  ETHEREUM_SEPOLIA
-  OPTIMISM
-  POLYGON
-  CELO
-  BNB
-  BASE
-  BLAST
-  ZORA
-  ZKSYNC
-  UNICHAIN
-  SONEIUM
-  ASTROCHAIN_SEPOLIA
-  WORLDCHAIN
-  MONAD_TESTNET
-  MONAD
-  ARBITRUM_SEPOLIA
-  BASE_SEPOLIA
-  SOLANA
-  XLAYER
-  LUX
-  LUX_TESTNET
-  ZOO
-  UNKNOWN_CHAIN
-}
-
-enum CollectionSortableField {
-  VOLUME
+  gasUsed: Float @deprecated(reason: "not required, remove usage")
+  transaction: Transaction! @deprecated(reason: "use fields from details")
+  assetChanges: [AssetChange]! @deprecated(reason: "use assetChanges field in details")
+  details: ActivityDetails!
+  "Addresses that are involved in the activity. Used internally for filtering subscriptions."
+  addresses: [String!]
 }
 
-input ContractInput {
+input AssetActivityInput {
+  timestamp: Int!
   chain: Chain!
-  address: String
+  details: ActivityDetailsInput!
 }
 
-enum Currency {
-  ARS
-  AUD
-  BRL
-  CAD
-  CNY
-  COP
-  ETH
-  EUR
-  GBP
-  HKD
-  IDR
-  INR
-  JPY
-  KRW
-  MATIC
-  MXN
-  NGN
-  NZD
-  PKR
-  RUB
-  SGD
-  THB
-  TRY
-  UAH
-  USD
-  VND
+union AssetChange =
+    TokenTransfer
+  | NftTransfer
+  | OnRampTransfer
+  | TokenApproval
+  | NftApproval
+  | NftApproveForAll
+  | OffRampTransfer
+
+input AssetChangeInput {
+  tokenTransfer: TokenTransferInput
+  tokenApproval: TokenApprovalInput
+  nftTransfer: NftTransferInput
+  nftApproval: NftApprovalInput
+  nftApproveForAll: NftApproveForAllInput
+  onRampTransfer: OnRampTransferInput
+  offRampTransfer: OffRampTransferInput
 }
 
 input CurrencyAmountInput {
@@ -261,6 +531,11 @@ input CurrencyAmountInput {
   value: Float!
 }
 
+input ContractInput {
+  chain: Chain!
+  address: String
+}
+
 type DescriptionTranslations {
   id: ID!
   descriptionZhHans: String
@@ -295,41 +570,6 @@ input DimensionsInput {
   width: Float
 }
 
-type FeeData {
-  sellFeeBps: String
-  buyFeeBps: String
-  feeTakenOnTransfer: Boolean
-  externalTransferFailed: Boolean
-  sellReverted: Boolean
-}
-
-enum HighLow {
-  HIGH
-  LOW
-}
-
-"""  FIVE_MINUTE is only supported for TokenMarket.pricePercentChange"""
-enum HistoryDuration {
-  FIVE_MINUTE
-  HOUR
-  DAY
-  WEEK
-  MONTH
-  YEAR
-  MAX
-}
-
-"""  Interfaces (alphabetized):"""
-interface IAmount {
-  currency: Currency
-  value: Float!
-}
-
-interface IContract {
-  chain: Chain!
-  address: String
-}
-
 type Image {
   id: ID!
   url: String!
@@ -341,45 +581,6 @@ input ImageInput {
   dimensions: DimensionsInput
 }
 
-interface IPool {
-  id: ID!
-  protocolVersion: ProtocolVersion!
-  chain: Chain!
-  address: String!
-  createdAtTimestamp: Int
-  totalLiquidity: Amount
-  token0: Token
-  token0Supply: Float
-  token1: Token
-  token1Supply: Float
-  txCount: Int
-  totalLiquidityPercentChange24h: Amount
-  cumulativeVolume(duration: HistoryDuration!): Amount
-  historicalVolume(duration: HistoryDuration!): [TimestampedAmount]
-  priceHistory(duration: HistoryDuration!): [TimestampedPoolPrice]
-  transactions(first: Int!, timestampCursor: Int): [PoolTransaction]
-}
-
-enum MediaType {
-  VIDEO
-  IMAGE
-  RAW
-  AUDIO
-}
-
-type Mutation {
-  assetActivity(input: AssetActivityInput!): AssetActivity!
-  heartbeat(subscriptionId: ID!, type: SubscriptionType!): Status!
-  unsubscribe(subscriptionId: ID!, type: SubscriptionType!): Status!
-}
-
-type NetworkFee {
-  quantity: String
-  tokenSymbol: String
-  tokenAddress: String
-  tokenChain: String
-}
-
 type NftActivity {
   id: ID!
   address: String!
@@ -413,18 +614,9 @@ input NftActivityFilterInput {
   activityTypes: [NftActivityType!]
 }
 
-enum NftActivityType {
-  LISTING
-  SALE
-  CANCEL_LISTING
-  TRANSFER
-}
-
 type NftApproval {
   id: ID!
-  nftStandard: NftStandard!
-
-  """  can be erc721, erc1155, noncompliant"""
+  nftStandard: NftStandard! # can be erc721, erc1155, noncompliant
   asset: NftAsset!
   approvedAddress: String!
 }
@@ -437,9 +629,7 @@ input NftApprovalInput {
 
 type NftApproveForAll {
   id: ID!
-  nftStandard: NftStandard!
-
-  """  can be erc721, erc1155, noncompliant"""
+  nftStandard: NftStandard! # can be erc721, erc1155, noncompliant
   asset: NftAsset!
   operatorAddress: String!
   approved: Boolean!
@@ -466,14 +656,19 @@ type NftAsset {
   originalImage: Image
   name: String
   nftContract: NftContract
-
-  """  TODO: may need to be array to support erc1155 cases. not needed at the moment so will revisit.
-  """
+  # TODO: may need to be array to support erc1155 cases. not needed at the moment so will revisit.
   ownerAddress: String
   tokenId: String!
   traits: [NftAssetTrait!]
   rarities: [NftAssetRarity!]
-  listings(chain: Chain, asc: Boolean, first: Int, last: Int, after: String, before: String): NftOrderConnection
+  listings(
+    chain: Chain = ETHEREUM
+    asc: Boolean
+    first: Int
+    last: Int
+    after: String
+    before: String
+  ): NftOrderConnection
   suspiciousFlag: Boolean
   flaggedBy: String
   metadataUrl: String
@@ -526,11 +721,6 @@ input NftAssetsFilterInput {
   marketplaces: [NftMarketplace!]
 }
 
-enum NftAssetSortableField {
-  PRICE
-  RARITY
-}
-
 type NftAssetTrait {
   id: ID!
   name: String
@@ -576,11 +766,8 @@ input NftBalancesFilterInput {
 type NftCollection {
   id: ID!
   collectionId: String!
-
-  """
-    TODO: support querying for collection assets here
-   assets(page: Int, pageSize: Int, orderBy: NftAssetSortableField): [NftAsset]
-  """
+  # TODO: support querying for collection assets here
+  # assets(page: Int, pageSize: Int, orderBy: NftAssetSortableField): [NftAsset]
   bannerImageUrl: String @deprecated
   bannerImage: Image
   description: String
@@ -589,7 +776,7 @@ type NftCollection {
   imageUrl: String @deprecated
   image: Image
   instagramName: String
-  markets(currencies: [Currency!]!): [NftCollectionMarket!]
+  markets(currencies: [Currency!]! = [ETH]): [NftCollectionMarket!]
   name: String
   nftContracts: [NftContract!]
   openseaUrl: String @deprecated
@@ -600,6 +787,12 @@ type NftCollection {
   creator: NftProfile
 }
 
+input NftCollectionInput {
+  collectionId: String!
+  name: String
+  nftContracts: [NftContractInput!]
+}
+
 type NftCollectionBalance {
   id: ID!
   address: String!
@@ -628,12 +821,6 @@ type NftCollectionEdge {
   node: NftCollection!
 }
 
-input NftCollectionInput {
-  collectionId: String!
-  name: String
-  nftContracts: [NftContractInput!]
-}
-
 type NftCollectionMarket {
   id: ID!
   nftContracts: [NftContract!]
@@ -703,17 +890,6 @@ type NftFee {
   basisPoints: Int!
 }
 
-enum NftMarketplace {
-  OPENSEA
-  LOOKSRARE
-  X2Y2
-  SUDOSWAP
-  NFTX
-  NFT20
-  FOUNDATION
-  CRYPTOPUNKS
-}
-
 type NftOrder {
   id: ID!
   address: String!
@@ -753,10 +929,6 @@ type NftProfile {
   username: String
 }
 
-enum NftRarityProvider {
-  RARITY_SNIPER
-}
-
 type NftRouteResponse {
   id: ID!
   calldata: String!
@@ -765,12 +937,6 @@ type NftRouteResponse {
   route: [NftTrade!]
 }
 
-enum NftStandard {
-  ERC721
-  ERC1155
-  NONCOMPLIANT
-}
-
 type NftTrade {
   id: ID!
   contractAddress: String!
@@ -778,12 +944,9 @@ type NftTrade {
   tokenType: NftStandard
   marketplace: NftMarketplace!
   amount: Int!
-
-  """  quotePrice represents the last quoted price of the NFT"""
+  # quotePrice represents the last quoted price of the NFT
   quotePrice: TokenAmount
-
-  """  price represents the current price of the NFT, which can be different from quotePrice
-  """
+  # price represents the current price of the NFT, which can be different from quotePrice
   price: TokenAmount!
 }
 
@@ -791,7 +954,7 @@ input NftTradeInput {
   id: ID!
   contractAddress: String!
   tokenId: String!
-  tokenType: NftStandard
+  tokenType: NftStandard @deprecated(reason: "not required, remove usage")
   marketplace: NftMarketplace!
   amount: Int!
   quotePrice: TokenAmountInput
@@ -893,6 +1056,11 @@ input OnRampServiceProviderInput {
   supportUrl: String
 }
 
+input OnRampTransactionsAuth {
+  queryParams: String!
+  signature: String!
+}
+
 type OnRampTransactionDetails {
   id: ID!
   status: TransactionStatus!
@@ -906,11 +1074,6 @@ input OnRampTransactionDetailsInput {
   onRampTransfer: OnRampTransferInput!
 }
 
-input OnRampTransactionsAuth {
-  queryParams: String!
-  signature: String!
-}
-
 type OnRampTransfer {
   id: ID!
   token: Token!
@@ -939,18 +1102,6 @@ input OnRampTransferInput {
   totalFee: Float
 }
 
-enum OrderStatus {
-  VALID
-  EXECUTED
-  CANCELLED
-  EXPIRED
-}
-
-enum OrderType {
-  LISTING
-  OFFER
-}
-
 type PageInfo {
   hasPreviousPage: Boolean
   hasNextPage: Boolean
@@ -958,8 +1109,6 @@ type PageInfo {
   endCursor: String
 }
 
-"""  v2 pool parameters as defined by https://github.com/Lux/v2-sdk/blob/main/src/entities/pair.ts
-"""
 input PairInput {
   tokenAmountA: TokenAmountInput!
   tokenAmountB: TokenAmountInput!
@@ -979,8 +1128,6 @@ input PermitInput {
   sigDeadline: String!
 }
 
-"""  v3 pool parameters as defined by https://github.com/Lux/v3-sdk/blob/main/src/entities/pool.ts
-"""
 input PoolInput {
   tokenA: TokenInput!
   tokenB: TokenInput!
@@ -999,81 +1146,39 @@ type PoolTransaction {
   timestamp: Int!
   usdValue: Amount!
   account: String!
-  token0: Token!
-  token0Quantity: String!
-  token1: Token!
-  token1Quantity: String!
-}
-
-enum PoolTransactionType {
-  SWAP
-  ADD
-  REMOVE
-}
-
-type Portfolio {
-  id: ID!
-  ownerAddress: String!
-  tokensTotalDenominatedValue: Amount
-  tokensTotalDenominatedValueChange(duration: HistoryDuration): AmountChange
-  tokenBalances: [TokenBalance]
-
-  """  TODO: (michael.zhang) replace with paginated query"""
-  nftBalances: [NftBalance]
-  assetActivities(page: Int, pageSize: Int, includeOffChain: Boolean, onRampTransactionsAuth: OnRampTransactionsAuth, onRampTransactionIDs: [String!], chains: [Chain!], includeBridging: Boolean, _fs: AssetActivitySwitch): [AssetActivity]
-}
-
-"""  Specify how the portfolio value should be calculated for each `ownerAddress`.
-"""
-input PortfolioValueModifier {
-  ownerAddress: String!
-  tokenIncludeOverrides: [ContractInput!]
-  tokenExcludeOverrides: [ContractInput!]
-  includeSmallBalances: Boolean
-  includeSpamTokens: Boolean
-  tokenBalancesLimit: Int
-}
-
-enum PriceSource {
-  SUBGRAPH_V2
-  SUBGRAPH_V3
-  SUBGRAPH_V4
-  EXTERNAL
-}
-
-enum ProtectionAttackType {
-  UNKNOWN
-  METADATA
-  INORGANIC_VOLUME
-  AIRDROP_PATTERN
-  DYNAMIC_ANALYSIS
-  STATIC_CODE_SIGNATURE
-  KNOWN_MALICIOUS
-  IMPERSONATOR
-  UNSTABLE_TOKEN_PRICE
-  RUGPULL
-  HIGH_FEES
-  HONEYPOT
-}
-
-type ProtectionInfo {
-  result: ProtectionResult
-  attackTypes: [ProtectionAttackType]
-  blockaidFees: BlockaidFees
+  token0: Token!
+  token0Quantity: String!
+  token1: Token!
+  token1Quantity: String!
 }
 
-enum ProtectionResult {
-  UNKNOWN
-  MALICIOUS
-  BENIGN
-  SPAM
-  WARNING
+type Portfolio {
+  id: ID!
+  ownerAddress: String!
+  tokensTotalDenominatedValue: Amount
+  tokensTotalDenominatedValueChange(duration: HistoryDuration): AmountChange
+  tokenBalances: [TokenBalance]
+  # TODO: (michael.zhang) replace with paginated query
+  nftBalances: [NftBalance]
+  assetActivities(
+    page: Int
+    pageSize: Int
+    includeOffChain: Boolean
+    onRampTransactionsAuth: OnRampTransactionsAuth
+    onRampTransactionIDs: [String!]
+    chains: [Chain!]
+    includeBridging: Boolean
+    _fs: AssetActivitySwitch = LEGACY # This field is now deprecated.
+  ): [AssetActivity]
 }
 
-enum ProtocolVersion {
-  V2
-  V3
-  V4
+input PortfolioValueModifier {
+  ownerAddress: String!
+  tokenIncludeOverrides: [ContractInput!]
+  tokenExcludeOverrides: [ContractInput!]
+  includeSmallBalances: Boolean
+  includeSpamTokens: Boolean
+  tokenBalancesLimit: Int
 }
 
 type PushNotification {
@@ -1084,76 +1189,10 @@ type PushNotification {
   signerHeader: AWSJSON!
 }
 
-type Query {
-  isV3SubgraphStale(chain: Chain!): Boolean
-  historicalProtocolVolume(chain: Chain!, version: ProtocolVersion!, duration: HistoryDuration!): [TimestampedAmount!]
-  dailyProtocolTvl(chain: Chain!, version: ProtocolVersion!): [TimestampedAmount!]
-
-  """  returns top v3 pools sorted by total value locked in desc order"""
-  topV3Pools(chain: Chain!, first: Int!, tvlCursor: Float, tokenFilter: String, debugMode: Boolean): [V3Pool!]
-  topV4Pools(chain: Chain!, first: Int!, tvlCursor: Float, tokenFilter: String, debugMode: Boolean): [V4Pool!]
-  v3Pool(chain: Chain!, address: String!): V3Pool
-  v4Pool(chain: Chain!, poolId: String!): V4Pool
-  v3PoolsForTokenPair(chain: Chain!, token0: String!, token1: String!): [V3Pool!]
-  v4PoolsForTokenPair(chain: Chain!, token0: String!, token1: String!): [V4Pool!]
-  v3Transactions(chain: Chain!, first: Int!, timestampCursor: Int): [PoolTransaction!]
-  v4Transactions(chain: Chain!, first: Int!, timestampCursor: Int): [PoolTransaction!]
-
-  """  returns top v2 pairs sorted by total value locked in desc order"""
-  topV2Pairs(chain: Chain!, first: Int!, tvlCursor: Float, tokenFilter: String, debugMode: Boolean): [V2Pair!]
-  v2Pair(chain: Chain!, address: String!): V2Pair
-  v2Transactions(chain: Chain!, first: Int!, timestampCursor: Int): [PoolTransaction]
-  convert(fromAmount: CurrencyAmountInput!, toCurrency: Currency!): Amount
-  tokens(contracts: [ContractInput!]!): [Token]
-
-  """
-    token consumes chain and address instead of contract because the apollo client request cache can only use
-   keys from the response, and the token response does not contain a contract, but does contain an unwrapped
-   contract: chain and address.
-  """
-  token(chain: Chain!, address: String): Token
-  tokenProjects(contracts: [ContractInput!]!): [TokenProject]
-  searchTokens(searchQuery: String!, chains: [Chain!], tokenSearchV2Enabled: Boolean): [Token]
-  portfolios(ownerAddresses: [String!]!, chains: [Chain!], lookupTokens: [ContractInput!], fungibleIds: [String!], valueModifiers: [PortfolioValueModifier!]): [Portfolio]
-  topTokens(chain: Chain, page: Int, pageSize: Int, orderBy: TokenSortableField): [Token]
-  topCollections(chains: [Chain!], orderBy: CollectionSortableField, duration: HistoryDuration, after: String, first: Int, cursor: String, limit: Int): NftCollectionConnection
-  nftAssets(chain: Chain, address: String!, orderBy: NftAssetSortableField, asc: Boolean, filter: NftAssetsFilterInput, after: String, first: Int, before: String, last: Int): NftAssetConnection
-  nftCollections(chain: Chain, filter: NftCollectionsFilterInput, after: String, first: Int): NftCollectionConnection
-  nftBalances(chain: Chain, ownerAddress: String!, filter: NftBalancesFilterInput, after: String, first: Int, before: String, last: Int, chains: [Chain!]): NftBalanceConnection
-  nftRoute(chain: Chain, senderAddress: String!, nftTrades: [NftTradeInput!]!, tokenTrades: [TokenTradeInput!]): NftRouteResponse
-  nftActivity(chain: Chain, filter: NftActivityFilterInput, after: String, first: Int): NftActivityConnection
-  nftCollectionBalances(chain: Chain, ownerAddress: String!, after: String, first: Int, before: String, last: Int): NftCollectionBalanceConnection
-  transactionNotification(chain: Chain!, address: String!, transactionHash: String!, isBridging: Boolean): TransactionNotification
-}
-
-type RewardsCampaign {
-  id: ID!
-  boostedApr: Float!
-  startTimestamp: Int
-  endTimestamp: Int
-  totalRewardAllocation: String
-  distributedRewards: String
-}
-
-enum SafetyLevel {
-  VERIFIED
-  MEDIUM_WARNING
-  STRONG_WARNING
-  BLOCKED
-}
-
 type Status {
   success: Boolean!
 }
 
-type Subscription {
-  onAssetActivity(subscriptionId: ID!, addresses: [String!]!): AssetActivity
-}
-
-enum SubscriptionType {
-  ASSET_ACTIVITY
-}
-
 type SwapOrderDetails {
   id: ID!
   offerer: String!
@@ -1172,7 +1211,7 @@ type SwapOrderDetails {
 input SwapOrderDetailsInput {
   offerer: String!
   hash: String!
-  status: SwapOrderStatus
+  status: SwapOrderStatus @deprecated(reason: "use swapOrderStatus to disambiguate from transactionStatus")
   swapOrderStatus: SwapOrderStatus!
   inputToken: TokenAssetInput!
   inputAmount: String!
@@ -1183,22 +1222,6 @@ input SwapOrderDetailsInput {
   swapOrderType: SwapOrderType!
 }
 
-enum SwapOrderStatus {
-  OPEN
-  EXPIRED
-  ERROR
-  INSUFFICIENT_FUNDS
-  FILLED
-  CANCELLED
-}
-
-enum SwapOrderType {
-  DUTCH
-  LIMIT
-  DUTCH_V2
-  PRIORITY
-}
-
 type TimestampedAmount implements IAmount {
   id: ID!
   currency: Currency
@@ -1215,13 +1238,6 @@ type TimestampedOhlc {
   close: Amount!
 }
 
-type TimestampedPoolPrice {
-  id: ID!
-  timestamp: Int!
-  token0Price: Float!
-  token1Price: Float!
-}
-
 type Token implements IContract {
   id: ID!
   chain: Chain!
@@ -1231,7 +1247,7 @@ type Token implements IContract {
   name: String
   symbol: String
   project: TokenProject
-  market(currency: Currency): TokenMarket
+  market(currency: Currency = USD, multichain: Boolean = false): TokenMarket
   feeData: FeeData
   protectionInfo: ProtectionInfo
   v4Transactions(first: Int!, timestampCursor: Int): [PoolTransaction]
@@ -1242,6 +1258,32 @@ type Token implements IContract {
   bridgedWithdrawalInfo: BridgedWithdrawalInfo
 }
 
+type BridgedWithdrawalInfo {
+  chain: String!
+  provider: String!
+  url: String!
+}
+
+type ProtectionInfo {
+  result: ProtectionResult
+  attackTypes: [ProtectionAttackType]
+  blockaidFees: BlockaidFees
+}
+
+type BlockaidFees {
+  transfer: Float
+  buy: Float
+  sell: Float
+}
+
+type FeeData {
+  sellFeeBps: String
+  buyFeeBps: String
+  feeTakenOnTransfer: Boolean
+  externalTransferFailed: Boolean
+  sellReverted: Boolean
+}
+
 type TokenAmount {
   id: ID!
   value: String!
@@ -1255,12 +1297,10 @@ input TokenAmountInput {
 
 type TokenApproval {
   id: ID!
-  tokenStandard: TokenStandard!
-
-  """  can be erc20 or native"""
+  tokenStandard: TokenStandard! # can be erc20 or native
   asset: Token!
   approvedAddress: String!
-  quantity: String!
+  quantity: String! # raw value for erc20
 }
 
 input TokenApprovalInput {
@@ -1309,9 +1349,8 @@ type TokenMarket {
   historicalTvl(duration: HistoryDuration!): [TimestampedAmount]
   priceHistory(duration: HistoryDuration!, maxLength: Int): [TimestampedAmount]
   ohlc(duration: HistoryDuration!): [TimestampedOhlc]
-
-  """  this volume is cumulative volume over the specified duration"""
-  volume(duration: HistoryDuration!): Amount
+  # this volume is cumulative volume over the specified duration
+  volume(duration: HistoryDuration!, multichain: Boolean = false): Amount
   pricePercentChange(duration: HistoryDuration!): Amount
   priceHighLow(duration: HistoryDuration!, highLow: HighLow!): Amount
 }
@@ -1330,7 +1369,7 @@ type TokenProject {
   isSpam: Boolean
   spamCode: Int
   safetyLevel: SafetyLevel
-  markets(currencies: [Currency!]!): [TokenProjectMarket]
+  markets(currencies: [Currency!]! = [USD]): [TokenProjectMarket]
 }
 
 type TokenProjectMarket {
@@ -1340,31 +1379,16 @@ type TokenProjectMarket {
   price: Amount
   marketCap: Amount
   fullyDilutedValuation: Amount
+
   pricePercentChange24h: Amount
   priceHigh52w: Amount
   priceLow52w: Amount
+
   priceHistory(duration: HistoryDuration!, maxLength: Int): [TimestampedAmount]
   pricePercentChange(duration: HistoryDuration!): Amount
   priceHighLow(duration: HistoryDuration!, highLow: HighLow!): Amount
 }
 
-enum TokenSortableField {
-  TOTAL_VALUE_LOCKED
-  MARKET_CAP
-  VOLUME
-  POPULARITY
-}
-
-enum TokenSource {
-  TOKEN_FACTORY
-}
-
-enum TokenStandard {
-  NATIVE
-  ERC20
-  SPL
-}
-
 input TokenTradeInput {
   tokenAmount: TokenAmountInput!
   routes: TokenTradeRoutesInput
@@ -1385,11 +1409,6 @@ input TokenTradeRoutesInput {
   tradeType: TokenTradeType!
 }
 
-enum TokenTradeType {
-  EXACT_INPUT
-  EXACT_OUTPUT
-}
-
 type TokenTransfer {
   id: ID!
   tokenStandard: TokenStandard!
@@ -1442,59 +1461,31 @@ type TransactionDetails {
   networkFee: NetworkFee
 }
 
+type NetworkFee {
+  quantity: String
+  tokenSymbol: String
+  tokenAddress: String
+  tokenChain: String
+}
+
 input TransactionDetailsInput {
   type: TransactionType!
   assetChanges: [AssetChangeInput]!
   from: String!
   to: String!
   hash: String!
-  status: TransactionStatus
+  status: TransactionStatus @deprecated(reason: "use transactionStatus to disambiguate from swapOrderStatus")
   transactionStatus: TransactionStatus!
   nonce: Int!
   application: ApplicationContractInput
 }
 
-enum TransactionDirection {
-  IN
-  OUT
-  SELF
-}
-
 type TransactionNotification {
   id: ID!
   hash: String!
   push: [PushNotification!]!
 }
 
-enum TransactionStatus {
-  FAILED
-  CONFIRMED
-  PENDING
-}
-
-enum TransactionType {
-  APPROVE
-  BORROW
-  BRIDGING
-  CANCEL
-  CLAIM
-  DEPLOYMENT
-  EXECUTE
-  LEND
-  MINT
-  RECEIVE
-  REPAY
-  SEND
-  STAKE
-  SWAP
-  SWAP_ORDER
-  UNKNOWN
-  UNSTAKE
-  WITHDRAW
-  ON_RAMP
-  OFF_RAMP
-}
-
 type V2Pair implements IPool {
   id: ID!
   protocolVersion: ProtocolVersion!
@@ -1507,6 +1498,7 @@ type V2Pair implements IPool {
   token1: Token
   token1Supply: Float
   txCount: Int
+
   totalLiquidityPercentChange24h: Amount
   cumulativeVolume(duration: HistoryDuration!): Amount
   historicalVolume(duration: HistoryDuration!): [TimestampedAmount]
@@ -1514,6 +1506,36 @@ type V2Pair implements IPool {
   transactions(first: Int!, timestampCursor: Int): [PoolTransaction]
 }
 
+type TimestampedPoolPrice {
+  id: ID!
+  timestamp: Int!
+  token0Price: Float!
+  token1Price: Float!
+}
+
+type V3PoolTick {
+  id: ID!
+  tickIdx: Int
+  liquidityGross: String
+  liquidityNet: String
+  price0: String
+  price1: String
+}
+
+type V4PoolTick {
+  id: ID!
+  tickIdx: Int
+  liquidityGross: String
+  liquidityNet: String
+  price0: String
+  price1: String
+}
+
+type V4PoolHook {
+  id: ID!
+  address: String!
+}
+
 type V3Pool implements IPool {
   id: ID!
   protocolVersion: ProtocolVersion!
@@ -1527,6 +1549,7 @@ type V3Pool implements IPool {
   token1Supply: Float
   txCount: Int
   feeTier: Float
+
   totalLiquidityPercentChange24h: Amount
   cumulativeVolume(duration: HistoryDuration!): Amount
   historicalVolume(duration: HistoryDuration!): [TimestampedAmount]
@@ -1535,13 +1558,13 @@ type V3Pool implements IPool {
   ticks(skip: Int, first: Int): [V3PoolTick]
 }
 
-type V3PoolTick {
+type RewardsCampaign {
   id: ID!
-  tickIdx: Int
-  liquidityGross: String
-  liquidityNet: String
-  price0: String
-  price1: String
+  boostedApr: Float!
+  startTimestamp: Int
+  endTimestamp: Int
+  totalRewardAllocation: String
+  distributedRewards: String
 }
 
 type V4Pool {
@@ -1560,6 +1583,7 @@ type V4Pool {
   isDynamicFee: Boolean
   hook: V4PoolHook
   tickSpacing: Int
+
   totalLiquidityPercentChange24h: Amount
   cumulativeVolume(duration: HistoryDuration!): Amount
   historicalVolume(duration: HistoryDuration!): [TimestampedAmount]
@@ -1568,18 +1592,3 @@ type V4Pool {
   ticks(skip: Int, first: Int): [V4PoolTick]
   rewardsCampaign: RewardsCampaign
 }
-
-type V4PoolHook {
-  id: ID!
-  address: String!
-}
-
-type V4PoolTick {
-  id: ID!
-  tickIdx: Int
-  liquidityGross: String
-  liquidityNet: String
-  price0: String
-  price1: String
-}
-