@quicknode/sdk 0.1.0 → 0.3.0

package/README.md

@@ -111,6 +111,69 @@ client.nft
   .then((response) => console.log(response));
 ```
 
+### nft.getCollectionDetails
+
+| Argument | Values | Optional | Description             | Example                                    |
+| -------- | ------ | -------- | ----------------------- | ------------------------------------------ |
+| address  | string | ❌       | Contract address of NFT | 0x2106C00Ac7dA0A3430aE667879139E832307AeAa |
+
+```ts
+import { QuickNodeSDK } from '@quicknode/sdk';
+
+const client = new QuickNodeSDK();
+
+client.nft
+  .getCollectionDetails({
+    address: '0x2106C00Ac7dA0A3430aE667879139E832307AeAa',
+  })
+  .then((response) => console.log(response));
+```
+
+### nft.getNFTEventLogs
+
+| Argument | Values | Optional | Description                                                                       | Example                                    |
+| -------- | ------ | -------- | --------------------------------------------------------------------------------- | ------------------------------------------ |
+| address  | string | ❌       | Contract address of NFT                                                           | 0x2106C00Ac7dA0A3430aE667879139E832307AeAa |
+| tokenId  | string | ❌       | NFT ID                                                                            | 100                                        |
+| types    | array  | ✅       | An array of event types 'TRANSFER', 'ORDER', and/or 'MINT'. Defaults to all types | ['TRANSFER', 'ORDER', 'MINT]               |
+| first    | number | ✅       | Number of results to return                                                       | 10                                         |
+| after    | string | ✅       | Return results after end cursor                                                   | YXJyYXljb25uZWN0aW9uOjUwNQ=                |
+
+```ts
+import { QuickNodeSDK } from '@quicknode/sdk';
+
+const client = new QuickNodeSDK();
+
+client.nft
+  .getNFTEventLogs({
+    address: '0x60E4d786628Fea6478F785A6d7e704777c86a7c6',
+    tokenId: '100',
+    types: ['TRANSFER', 'ORDER'],
+  })
+  .then((response) => console.log(response));
+```
+
+### nft.getNFTDetails
+
+Returns the details for a single NFT
+| Argument | Values | Optional | Description | Example |
+| --------------- | ------ | -------- | --------------------------------- | ------------------------------------------ |
+| contractAddress | string | ❌ | Contract address of NFT Collection | 0x2106C00Ac7dA0A3430aE667879139E832307AeAa |
+| tokenId | string | ❌ | NFT ID | 5020 |
+
+```ts
+import { QuickNodeSDK } from '@quicknode/sdk';
+
+const client = new QuickNodeSDK();
+
+client.nft
+  .getNFTDetails({
+    contractAddress: '0x23581767a106ae21c074b2276D25e5C3e136a68b',
+    tokenId: '400',
+  })
+  .then((response) => console.log(response));
+```
+
 ## Pagination
 
 For functions that support pagination, use the `first` property to specify the amount of results to return.

package/package.json

@@ -6,7 +6,7 @@
     "directory": "packages/libs/api/sdk"
   },
   "license": "MIT",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "main": "./src/index.js",
   "module": "./src/index.esm.js",
   "types": "./src/index.d.ts",

package/src/index.esm.js

@@ -8010,6 +8010,113 @@ const getContractAddressNFTsRawQuery = gql `
   }
 `;
 
+const getCollectionDetailsRawQuery = gql `
+  query CollectionDetails($address: String!) {
+    contract(address: $address) {
+      ... on ERC721Contract {
+        address
+        isVerified
+        tokenStandard
+        attributes {
+          name
+          rarity
+          value
+          valueCount
+        }
+        circulatingSupply
+        name
+        stats {
+          average
+          ceiling
+          floor
+          totalSales
+          volume
+        }
+        symbol
+      }
+    }
+  }
+`;
+
+const getNFTEventLogsRawQuery = gql `
+  query NFTEvents(
+    $address: String!
+    $tokenId: String!
+    $filter: LogsFilterInputType
+    $first: Int
+    $after: String
+  ) {
+    token(contractAddress: $address, tokenId: $tokenId) {
+      ... on ERC721Token {
+        tokenId
+        contract {
+          address # Included key field for caching
+        }
+        logs(filter: $filter, first: $first, after: $after) {
+          edges {
+            node {
+              blockNumber
+              type
+              fromAddress
+              toAddress
+              estimatedConfirmedAt
+              transactionHash
+              ... on OrderLog {
+                marketplace
+                priceInEth
+              }
+            }
+          }
+          pageInfo {
+            hasNextPage
+            endCursor
+          }
+        }
+      }
+    }
+  }
+`;
+
+const getNFTDetailsRawQuery = gql `
+  query Token($contractAddress: String!, $tokenId: String!) {
+    token(contractAddress: $contractAddress, tokenId: $tokenId) {
+      ... on ERC721Token {
+        tokenId
+        attributes {
+          name
+          value
+        }
+        contract {
+          address
+          isVerified
+          tokenStandard
+          ... on ERC721Contract {
+            name
+          }
+        }
+        images {
+          height
+          mimeType
+          url
+          width
+        }
+        name
+        symbol
+        metadata {
+          animation_url
+          background_color
+          description
+          external_url
+          image
+          image_data
+          name
+          youtube_url
+        }
+      }
+    }
+  }
+`;
+
 class NFTQueries {
     constructor(client) {
         this.client = client;
@@ -8038,6 +8145,33 @@ class NFTQueries {
             });
         });
     }
+    getCollectionDetails(variables) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this.client.query({
+                query: getCollectionDetailsRawQuery,
+                variables,
+            });
+        });
+    }
+    getNFTEventLogs(variables) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { types = ['TRANSFER', 'ORDER', 'MINT'] } = variables, otherVariables = __rest(variables, ["types"]);
+            return yield this.client.query({
+                query: getNFTEventLogsRawQuery,
+                variables: Object.assign(Object.assign({}, otherVariables), { filter: {
+                        typeIn: types,
+                    } }),
+            });
+        });
+    }
+    getNFTDetails(variables) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this.client.query({
+                query: getNFTDetailsRawQuery,
+                variables,
+            });
+        });
+    }
 }
 
 /**

package/src/index.js

@@ -8018,6 +8018,113 @@ const getContractAddressNFTsRawQuery = gql `
   }
 `;
 
+const getCollectionDetailsRawQuery = gql `
+  query CollectionDetails($address: String!) {
+    contract(address: $address) {
+      ... on ERC721Contract {
+        address
+        isVerified
+        tokenStandard
+        attributes {
+          name
+          rarity
+          value
+          valueCount
+        }
+        circulatingSupply
+        name
+        stats {
+          average
+          ceiling
+          floor
+          totalSales
+          volume
+        }
+        symbol
+      }
+    }
+  }
+`;
+
+const getNFTEventLogsRawQuery = gql `
+  query NFTEvents(
+    $address: String!
+    $tokenId: String!
+    $filter: LogsFilterInputType
+    $first: Int
+    $after: String
+  ) {
+    token(contractAddress: $address, tokenId: $tokenId) {
+      ... on ERC721Token {
+        tokenId
+        contract {
+          address # Included key field for caching
+        }
+        logs(filter: $filter, first: $first, after: $after) {
+          edges {
+            node {
+              blockNumber
+              type
+              fromAddress
+              toAddress
+              estimatedConfirmedAt
+              transactionHash
+              ... on OrderLog {
+                marketplace
+                priceInEth
+              }
+            }
+          }
+          pageInfo {
+            hasNextPage
+            endCursor
+          }
+        }
+      }
+    }
+  }
+`;
+
+const getNFTDetailsRawQuery = gql `
+  query Token($contractAddress: String!, $tokenId: String!) {
+    token(contractAddress: $contractAddress, tokenId: $tokenId) {
+      ... on ERC721Token {
+        tokenId
+        attributes {
+          name
+          value
+        }
+        contract {
+          address
+          isVerified
+          tokenStandard
+          ... on ERC721Contract {
+            name
+          }
+        }
+        images {
+          height
+          mimeType
+          url
+          width
+        }
+        name
+        symbol
+        metadata {
+          animation_url
+          background_color
+          description
+          external_url
+          image
+          image_data
+          name
+          youtube_url
+        }
+      }
+    }
+  }
+`;
+
 class NFTQueries {
     constructor(client) {
         this.client = client;
@@ -8046,6 +8153,33 @@ class NFTQueries {
             });
         });
     }
+    getCollectionDetails(variables) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this.client.query({
+                query: getCollectionDetailsRawQuery,
+                variables,
+            });
+        });
+    }
+    getNFTEventLogs(variables) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { types = ['TRANSFER', 'ORDER', 'MINT'] } = variables, otherVariables = __rest(variables, ["types"]);
+            return yield this.client.query({
+                query: getNFTEventLogsRawQuery,
+                variables: Object.assign(Object.assign({}, otherVariables), { filter: {
+                        typeIn: types,
+                    } }),
+            });
+        });
+    }
+    getNFTDetails(variables) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this.client.query({
+                query: getNFTDetailsRawQuery,
+                variables,
+            });
+        });
+    }
 }
 
 /**

package/src/queries/nft/getCollectionDetails/getCollectionDetails.d.ts

@@ -0,0 +1,4 @@
+export declare const getCollectionDetailsRawQuery: import("graphql/language/ast").DocumentNode;
+export interface CollectionDetailsQueryVariables {
+    address: string;
+}

package/src/queries/nft/getNFTDetails/getNFTDetails.d.ts

@@ -0,0 +1,5 @@
+export declare const getNFTDetailsRawQuery: import("graphql/language/ast").DocumentNode;
+export interface NFTDetailsQueryVariables {
+    contractAddress: string;
+    tokenId: string;
+}

package/src/queries/nft/getNFTEventLogs/getNFTEventLogs.d.ts

@@ -0,0 +1,9 @@
+import { PaginationArgs } from '../../../types';
+export declare const getNFTEventLogsRawQuery: import("graphql/language/ast").DocumentNode;
+declare type LogEvents = 'TRANSFER' | 'ORDER' | 'MINT';
+export interface EventLogsQueryVariables extends PaginationArgs {
+    address: string;
+    tokenId: string;
+    types?: LogEvents[];
+}
+export {};

package/src/queries/nft/nftQueries.d.ts

@@ -3,11 +3,17 @@ import { CustomApolloClient } from '../../client/customApolloClient';
 import { WalletAddressNFTsQueryVariables } from './getNFTsByWalletAddress/getNFTsByWalletAddress';
 import { WalletENSNFTsQueryVariables } from './getNFTsByWalletENS/getNFTsByWalletENS';
 import { ContractAddressNFTsQueryVariables } from './getNFTsByContractAddress/getNFTsByContractAddress';
-import { ContractNFTsQueryResponse, WalletNFTsQueryResponse } from './sharedTypes';
+import { CollectionDetailsQueryVariables } from './getCollectionDetails/getCollectionDetails';
+import { EventLogsQueryVariables } from './getNFTEventLogs/getNFTEventLogs';
+import { NFTDetailsQueryVariables } from './getNFTDetails/getNFTDetails';
+import { ContractNFTsQueryResponse, WalletNFTsQueryResponse, CollectionDetailsQueryResponse, EventLogsQueryResponse, NFTDetailsQueryResponse } from './sharedTypes';
 export declare class NFTQueries {
     private client;
     constructor(client: CustomApolloClient);
     getNFTsByWalletAddress(variables: WalletAddressNFTsQueryVariables): Promise<ApolloQueryResult<WalletNFTsQueryResponse>>;
     getNFTsByWalletENS(variables: WalletENSNFTsQueryVariables): Promise<ApolloQueryResult<WalletNFTsQueryResponse>>;
     getNFTsByContractAddress(variables: ContractAddressNFTsQueryVariables): Promise<ApolloQueryResult<ContractNFTsQueryResponse>>;
+    getCollectionDetails(variables: CollectionDetailsQueryVariables): Promise<ApolloQueryResult<CollectionDetailsQueryResponse>>;
+    getNFTEventLogs(variables: EventLogsQueryVariables): Promise<ApolloQueryResult<EventLogsQueryResponse>>;
+    getNFTDetails(variables: NFTDetailsQueryVariables): Promise<ApolloQueryResult<NFTDetailsQueryResponse>>;
 }