@noditlabs/nodit-mcp-server 1.0.9 → 1.0.11

package/LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright [yyyy] [name of copyright owner]
+   Copyright Nodit
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

package/README.md

@@ -22,7 +22,7 @@ With Nodit's MCP, you can:
 - Leverage Nodit's **reliable node infrastructure, Web3 Data APIs, and GraphQL indexing services** through a unified access layer.
 - Easily develop with blockchain MCP in **both local and remote integration**, depending on your workflow needs.
 
-Supported networks include Ethereum, Base, Optimism, Arbitrum, Polygon, Aptos, Bitcoin, Dogecoin, TRON, XRPL, and more.
+Supported networks include Ethereum, Base, Optimism, Arbitrum, Polygon, Aptos, Bitcoin, Dogecoin, TRON, XRPL, GIWA(Sepolia) and more.
 
 ## Table of Contents
 - [How Nodit MCP Tools Work](#how-nodit-mcp-tools-work)
@@ -71,8 +71,8 @@ For detailed API specifications and usage guidelines, please refer to the [Nodit
   Query detailed Aptos blockchain activities through GraphQL endpoints.
 
 - **Supported Networks**  
-  - EVM-Compatible: Ethereum, Arbitrum, Avalanche, Base, Chiliz, Kaia, Optimism, Polygon
-  - Non-EVM: Aptos, Bitcoin, Dogecoin, TRON, XRPL
+  - EVM-Compatible: Ethereum, Arbitrum, Avalanche, Base, Chiliz, Kaia, Optimism, Polygon, BNB Chain, GIWA(Sepolia)
+  - Non-EVM: Aptos, Bitcoin, Dogecoin, TRON, XRPL, Sui
 
 
 ## Prerequisites

package/build/helper/nodit-apidoc-helper.js

@@ -4,6 +4,20 @@ import path from 'path';
 import { fileURLToPath } from 'url';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
+export const BLOCKED_OPERATION_IDS = new Set([
+    "solana-getProgramAccounts",
+    "solana-getClusterNodes",
+    "solana-getLeaderSchedule",
+    "solana-getSignaturesForAddress",
+    "solana-getBlock",
+    "solana-getBlocks",
+    "solana-getBlocksWithLimit",
+    "solana-getVoteAccounts",
+    "solana-getInflationGovernor",
+    "solana-getInflationRate",
+    "solana-getInflationReward",
+    "solana-getSupply",
+]);
 export function log(message, ...args) {
     console.error(message, ...args);
 }
@@ -53,6 +67,17 @@ export function loadNoditNodeApiSpecMap() {
                 });
             }
         }
+        const solanaNodeApiSpecDir = path.resolve(__dirname, '../spec/reference/solana-node-api/http-methods');
+        const solanaNodeApiSpecFiles = fs.readdirSync(solanaNodeApiSpecDir);
+        for (const file of solanaNodeApiSpecFiles) {
+            if (file.endsWith('.yaml')) {
+                const filePath = path.join(solanaNodeApiSpecDir, file);
+                const solanaNodeApiSpecMap = loadMultiPathApiSpec(filePath);
+                solanaNodeApiSpecMap.forEach((spec, operationId) => {
+                    noditApiSpecMap.set(operationId, spec);
+                });
+            }
+        }
         return noditApiSpecMap;
     }
     catch (error) {
@@ -82,7 +107,7 @@ export function loadNoditAptosIndexerApiSpec() {
     return loadOpenapiSpecFile(schemaPath);
 }
 export function isNodeApi(operationId) {
-    return operationId.includes("_");
+    return operationId.includes("_") || operationId.startsWith("solana-");
 }
 export function isEthereumNodeApi(operationId) {
     return !operationId.includes("-");
@@ -90,6 +115,9 @@ export function isEthereumNodeApi(operationId) {
 export function isWebhookApi(operationId) {
     return operationId.includes("Webhook");
 }
+export function isBlockedOperationId(operationId) {
+    return BLOCKED_OPERATION_IDS.has(operationId);
+}
 export function findNoditNodeApiSpec(operationId, noditNodeApiSpecMap) {
     let key = operationId;
     if (isEthereumNodeApi(operationId)) {

package/build/spec/reference/arbitrum.yaml

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: arbitrum
-  version: 1.2.14
+  version: 1.2.18
 servers:
   - url: https://web3.nodit.io/v1
 components:
@@ -506,7 +506,7 @@ paths:
                         - totalBalance
                         - uniqueBalance
                       properties:
-                        ownerAddress: &ref_22
+                        ownerAddress: &ref_23
                           type: string
                           description: 소유자 주소를 나타내는 필드입니다.
                           pattern: ^0[xX][0-9a-fA-F]{40}$
@@ -797,6 +797,8 @@ paths:
                             - tokenId
                             - tokenUri
                             - tokenUriSyncedAt
+                            - rawMetadata
+                            - metadataSyncedAt
                           properties:
                             tokenId:
                               type: string
@@ -813,14 +815,10 @@ paths:
                               description: NFT의 tokenUri가 동기화 된 시점을 나타내는 필드입니다.
                             rawMetadata:
                               type: string
-                              description: >-
-                                NFT의 rawMetadata를 나타내는 필드입니다. 이 필드는 withMetadata
-                                파라미터에 true를 입력한 경우에만 응답에 포함됩니다.
+                              description: NFT의 rawMetadata를 나타내는 필드입니다.
                             metadataSyncedAt:
                               type: string
-                              description: >-
-                                NFT의 metadata가 동기화 된 시점을 나타내는 필드입니다. 이 필드는
-                                withMetadata 파라미터에 true를 입력한 경우에만 응답에 포함됩니다.
+                              description: NFT의 metadata가 동기화 된 시점을 나타내는 필드입니다.
                         - type: object
                           properties:
                             contract:
@@ -1411,7 +1409,7 @@ paths:
                         형태로 입력할 수 있습니다.
                       pattern: ^0[xX][0-9a-fA-F]{40}$
                       default: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
-                    relation: &ref_24
+                    relation: &ref_25
                       type: string
                       description: |-
                         조회 대상 계정 주소가 송신자 또는 수신자에 속한 트랜잭션만 필터링하기 위한 파라미터입니다.  
@@ -1628,7 +1626,7 @@ paths:
                                 - selector
                                 - input
                               properties:
-                                selector: &ref_30
+                                selector: &ref_32
                                   type: string
                                   description: >-
                                     호출된 함수를 식별하는 4바이트 함수 셀렉터 값입니다. 함수 셀렉터는 함수
@@ -1644,7 +1642,7 @@ paths:
                                 args:
                                   type: array
                                   description: 호출 함수의 인자를 나타내는 필드입니다.
-                                  items: &ref_29
+                                  items: &ref_31
                                     type: object
                                     properties:
                                       name:
@@ -1668,7 +1666,36 @@ paths:
                               allOf:
                                 - *ref_1
                                 - *ref_2
-                            nft: *ref_12
+                            nft: &ref_22
+                              type: object
+                              required:
+                                - tokenId
+                                - tokenUri
+                                - tokenUriSyncedAt
+                              properties:
+                                tokenId:
+                                  type: string
+                                  description: >-
+                                    NFT 토큰의 고유 ID를 나타내는 필드입니다. 이 ID는 해당 NFT를
+                                    식별하는 데 사용됩니다.
+                                tokenUri:
+                                  type: string
+                                  description: >-
+                                    NFT의 원본 메타데이터가 위치한 URI를 나타냅니다. 컨트랙트 구현에 따라
+                                    다르지만, 일반적으로 IPFS 주소나 웹 URL 형식으로 제공됩니다.
+                                tokenUriSyncedAt:
+                                  type: string
+                                  description: NFT의 tokenUri가 동기화 된 시점을 나타내는 필드입니다.
+                                rawMetadata:
+                                  type: string
+                                  description: >-
+                                    NFT의 rawMetadata를 나타내는 필드입니다. 이 필드는
+                                    withMetadata 파라미터에 true를 입력한 경우에만 응답에 포함됩니다.
+                                metadataSyncedAt:
+                                  type: string
+                                  description: >-
+                                    NFT의 metadata가 동기화 된 시점을 나타내는 필드입니다. 이 필드는
+                                    withMetadata 파라미터에 true를 입력한 경우에만 응답에 포함됩니다.
               example:
                 rpp: 20
                 cursor: >-
@@ -2238,7 +2265,7 @@ paths:
                               allOf:
                                 - *ref_1
                                 - *ref_2
-                            nft: *ref_12
+                            nft: *ref_22
               example:
                 rpp: 20
                 cursor: >-
@@ -2817,7 +2844,7 @@ paths:
                               allOf:
                                 - *ref_1
                                 - *ref_2
-                            nft: *ref_12
+                            nft: *ref_22
               example:
                 rpp: 20
                 cursor: null
@@ -2963,7 +2990,7 @@ paths:
                               allOf:
                                 - *ref_1
                                 - *ref_2
-                            nft: *ref_12
+                            nft: *ref_22
               example:
                 rpp: 20
                 cursor: >-
@@ -3546,18 +3573,28 @@ paths:
                     description: 조회된 데이터의 목록을 나타내는 필드입니다.
                     items:
                       allOf:
-                        - &ref_23
+                        - &ref_24
                           type: object
                           required:
                             - ownerAddress
                             - balance
+                            - lastTransferredAt
                           properties:
-                            ownerAddress: *ref_22
-                            balance:
+                            ownerAddress: *ref_23
+                            balance: &ref_26
                               type: string
                               description: 잔고 나타내는 필드입니다.
                               pattern: ^[0-9]+$
-                        - *ref_12
+                            lastTransferredAt:
+                              type: string
+                              description: >-
+                                해당 토큰 또는 NFT가 소유자에게 마지막으로 전송된 시간을 ISO 8601 형식으로
+                                나타내는 필드입니다. 표준 토큰 규격(ERC20, ERC721, ERC1155)과
+                                동일한 Transfer 이벤트로 전송된 경우만 반영되며, 비표준 이벤트로 인해 전송된
+                                경우는 반영되지 않을 수 있습니다.
+                              pattern: >-
+                                ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(?:\.[0-9]{1,3})?(?:Z|[+-][0-9]{2}:[0-9]{2})$
+                        - *ref_22
                         - type: object
                           properties:
                             contract:
@@ -4453,7 +4490,7 @@ paths:
                   items:
                     type: array
                     description: 조회된 데이터의 목록을 나타내는 필드입니다.
-                    items: *ref_23
+                    items: *ref_24
               example:
                 rpp: 10
                 cursor: >-
@@ -4723,7 +4760,7 @@ paths:
                         형태로 입력할 수 있습니다.
                       pattern: ^0[xX][0-9a-fA-F]{40}$
                       default: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
-                    relation: *ref_24
+                    relation: *ref_25
                     contractAddresses: *ref_13
                     fromBlock: *ref_14
                     toBlock: *ref_15
@@ -5716,7 +5753,7 @@ paths:
                     description: 조회된 데이터의 목록을 나타내는 필드입니다.
                     items:
                       allOf:
-                        - *ref_23
+                        - *ref_24
                         - type: object
                           properties:
                             contract:
@@ -6275,7 +6312,14 @@ paths:
           description: Successful Response
           content:
             application/json:
-              schema: *ref_23
+              schema:
+                type: object
+                required:
+                  - ownerAddress
+                  - balance
+                properties:
+                  ownerAddress: *ref_23
+                  balance: *ref_26
               example:
                 ownerAddress: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
                 balance: '1085515662023271641379'
@@ -6342,7 +6386,7 @@ paths:
             application/json:
               schema:
                 type: object
-                required: &ref_25
+                required: &ref_27
                   - hash
                   - number
                   - timestamp
@@ -6363,7 +6407,7 @@ paths:
                   - sha3Uncles
                   - transactionCount
                   - transactions
-                properties: &ref_26
+                properties: &ref_28
                   hash:
                     type: string
                     description: 블록 해시를 나타내는 필드입니다. 0x로 시작하는 64자리 16진수 문자열 형태로 제공됩니다.
@@ -6641,8 +6685,8 @@ paths:
                     description: 조회된 데이터의 목록을 나타내는 필드입니다.
                     items:
                       type: object
-                      required: *ref_25
-                      properties: *ref_26
+                      required: *ref_27
+                      properties: *ref_28
               example:
                 rpp: 20
                 cursor: >-
@@ -7387,7 +7431,7 @@ paths:
                         형태로 입력할 수 있습니다.
                       pattern: ^0[xX][0-9a-fA-F]{40}$
                       default: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
-                    relation: *ref_24
+                    relation: *ref_25
                     fromBlock: *ref_14
                     toBlock: *ref_15
                     fromDate: *ref_16
@@ -7398,7 +7442,7 @@ paths:
                 - type: object
                   properties:
                     withZeroValue: *ref_19
-                    withExternalTransaction: &ref_27
+                    withExternalTransaction: &ref_29
                       type: boolean
                       description: >-
                         응답에 external transaction 포함 여부를 결정하는 파라미터입니다. external
@@ -7437,7 +7481,7 @@ paths:
                   items:
                     type: array
                     description: 조회된 데이터의 목록을 나타내는 필드입니다.
-                    items: &ref_28
+                    items: &ref_30
                       type: object
                       required: []
                       properties:
@@ -7729,7 +7773,7 @@ paths:
                 - type: object
                   properties:
                     withZeroValue: *ref_19
-                    withExternalTransaction: *ref_27
+                    withExternalTransaction: *ref_29
       responses:
         '200':
           description: Successful Response
@@ -7761,7 +7805,7 @@ paths:
                   items:
                     type: array
                     description: 조회된 데이터의 목록을 나타내는 필드입니다.
-                    items: *ref_28
+                    items: *ref_30
               example:
                 rpp: 10
                 page: 1
@@ -8053,13 +8097,13 @@ paths:
                       pattern: ^0[xX][0-9a-fA-F]{64}$
                       default: >-
                         0x1632ac1627903e586c8ea0b1c134908c34ee95e84face9a303abd63686eb2022
-                    withLogs: &ref_31
+                    withLogs: &ref_33
                       type: boolean
                       description: >-
                         응답에 logs 필드의 포함 여부를 지정하는 파라미터입니다. 이 파라미터에 true를 입력한 경우,
                         응답속도가 느려질 수 있습니다.
                       default: false
-                    withDecode: &ref_32
+                    withDecode: &ref_34
                       type: boolean
                       description: >-
                         응답에 decodedInput, decodedLog 필드의 포함 여부를 지정하는 파라미터입니다. 이
@@ -8078,7 +8122,7 @@ paths:
             application/json:
               schema:
                 allOf:
-                  - &ref_33
+                  - &ref_35
                     type: object
                     required:
                       - transactionHash
@@ -8161,8 +8205,8 @@ paths:
                             description: 트랜잭션의 함수 시그니처를 나타내는 필드입니다.
                           args:
                             type: array
-                            items: *ref_29
-                      functionSelector: *ref_30
+                            items: *ref_31
+                      functionSelector: *ref_32
                       nonce:
                         type: string
                         description: >-
@@ -8331,7 +8375,7 @@ paths:
                     properties:
                       logs:
                         type: object
-                        required: &ref_34
+                        required: &ref_36
                           - contractAddress
                           - transactionHash
                           - transactionIndex
@@ -8341,53 +8385,53 @@ paths:
                           - logIndex
                           - removed
                           - topics
-                        properties: &ref_35
-                          contractAddress: &ref_37
+                        properties: &ref_37
+                          contractAddress: &ref_39
                             type: string
                             description: >-
                               로그를 생성한 컨트랙트 주소를 나타내는 필드입니다. 0x로 시작하는 40자리의 16진수
                               문자열 형태로 제공됩니다.
                             pattern: ^0[xX][0-9a-fA-F]{40}$
-                          transactionHash: &ref_38
+                          transactionHash: &ref_40
                             type: string
                             description: >-
                               로그를 생성한 트랜잭션의 해시를 나타내는 필드입니다. 0x로 시작하는 64자리 16진수
                               문자열 형태로 제공됩니다.
                             pattern: ^0[xX][0-9a-fA-F]{64}$
-                          transactionIndex: &ref_39
+                          transactionIndex: &ref_41
                             type: string
                             description: >-
                               로그를 생성한 트랜잭션의 인덱스를 나타내는 필드입니다. 블록 내에서의 순서를 나타냅니다.
                               10진수 문자열 형태로 제공됩니다.
                             pattern: ^[0-9]+$
-                          blockHash: &ref_40
+                          blockHash: &ref_42
                             type: string
                             description: >-
                               로그를 생성한 블록의 해시를 나타내는 필드입니다. 0x로 시작하는 64자리 16진수 문자열
                               형태로 제공됩니다.
                             pattern: ^0[xX][0-9a-fA-F]{64}
-                          blockNumber: &ref_41
+                          blockNumber: &ref_43
                             type: integer
                             description: 로그를 생성한 블록 번호를 나타내는 필드입니다.
                             pattern: ^[0-9]+$
-                          data: &ref_42
+                          data: &ref_44
                             type: string
                             description: >-
                               로그의 데이터를 나타내는 필드입니다. 0x로 시작하는 16진수 문자열 형태로 제공됩니다.
                               이 필드는 로그의 이벤트 데이터를 나타냅니다.
                             pattern: ^0[xX][0-9a-fA-F]+$
-                          logIndex: &ref_43
+                          logIndex: &ref_45
                             type: string
                             description: >-
                               로그의 인덱스를 나타내는 필드입니다. 트랜잭션에서 발생한 이벤트의 순서를 의미합니다.
                               10진수 문자열 형태로 제공됩니다.
                             pattern: ^[0-9]+$
-                          removed: &ref_44
+                          removed: &ref_46
                             type: boolean
                             description: >-
                               로그가 제거되었는지 여부를 나타내는 필드입니다. 체인의 재구성(Reorg)으로 인해 로그가
                               제거된 경우 true를 반환합니다.
-                          topics: &ref_45
+                          topics: &ref_47
                             type: array
                             description: 인덱스된 로그의 인자를 나타내는 필드입니다. 최대 4개의 토픽을 가질 수 있습니다.
                             items:
@@ -8420,7 +8464,7 @@ paths:
                               args:
                                 type: array
                                 description: 로그의 인자를 나타내는 필드입니다.
-                                items: *ref_29
+                                items: *ref_31
               example:
                 transactionHash: >-
                   0x75f0194c076da2fbcf09b7e5cd302ee25a8b97ec5110bb89184682170e7dd5c4
@@ -8653,7 +8697,7 @@ paths:
                         형태로 입력할 수 있습니다.
                       pattern: ^0[xX][0-9a-fA-F]{40}$
                       default: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
-                    relation: *ref_24
+                    relation: *ref_25
                     fromBlock: *ref_14
                     toBlock: *ref_15
                     fromDate: *ref_16
@@ -8663,8 +8707,8 @@ paths:
                 - *ref_8
                 - type: object
                   properties:
-                    withLogs: *ref_31
-                    withDecode: *ref_32
+                    withLogs: *ref_33
+                    withDecode: *ref_34
               required:
                 - accountAddress
       responses:
@@ -8700,15 +8744,15 @@ paths:
                     description: 조회된 데이터의 목록을 나타내는 필드입니다.
                     items:
                       allOf:
-                        - *ref_33
+                        - *ref_35
                         - type: object
                           properties:
                             logs:
                               type: array
-                              items: &ref_36
+                              items: &ref_38
                                 type: object
-                                required: *ref_34
-                                properties: *ref_35
+                                required: *ref_36
+                                properties: *ref_37
               example:
                 rpp: 10
                 page: 1
@@ -9533,8 +9577,8 @@ paths:
                     - transactionHashes
                 - type: object
                   properties:
-                    withLogs: *ref_31
-                    withDecode: *ref_32
+                    withLogs: *ref_33
+                    withDecode: *ref_34
       responses:
         '200':
           description: Successful Response
@@ -9544,12 +9588,12 @@ paths:
                 type: array
                 items:
                   allOf:
-                    - *ref_33
+                    - *ref_35
                     - type: object
                       properties:
                         logs:
                           type: array
-                          items: *ref_36
+                          items: *ref_38
               example:
                 - transactionHash: >-
                     0x75f0194c076da2fbcf09b7e5cd302ee25a8b97ec5110bb89184682170e7dd5c4
@@ -9865,8 +9909,8 @@ paths:
                 - *ref_8
                 - type: object
                   properties:
-                    withLogs: *ref_31
-                    withDecode: *ref_32
+                    withLogs: *ref_33
+                    withDecode: *ref_34
       responses:
         '200':
           description: Successful Response
@@ -9900,12 +9944,12 @@ paths:
                     description: 조회된 데이터의 목록을 나타내는 필드입니다.
                     items:
                       allOf:
-                        - *ref_33
+                        - *ref_35
                         - type: object
                           properties:
                             logs:
                               type: array
-                              items: *ref_36
+                              items: *ref_38
               example:
                 rpp: 10
                 page: 1
@@ -10882,15 +10926,15 @@ paths:
                         - removed
                         - topics
                       properties:
-                        contractAddress: *ref_37
-                        transactionHash: *ref_38
-                        transactionIndex: *ref_39
-                        blockHash: *ref_40
-                        blockNumber: *ref_41
-                        data: *ref_42
-                        logIndex: *ref_43
-                        removed: *ref_44
-                        topics: *ref_45
+                        contractAddress: *ref_39
+                        transactionHash: *ref_40
+                        transactionIndex: *ref_41
+                        blockHash: *ref_42
+                        blockNumber: *ref_43
+                        data: *ref_44
+                        logIndex: *ref_45
+                        removed: *ref_46
+                        topics: *ref_47
               example:
                 rpp: 5
                 page: 1