@noditlabs/nodit-mcp-server 1.0.14 → 1.0.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (45) hide show
  1. package/build/spec/reference/evm-arc-debug_traceblockbyhash.yaml +197 -0
  2. package/build/spec/reference/evm-arc-debug_traceblockbynumber.yaml +225 -0
  3. package/build/spec/reference/evm-arc-debug_tracecall.yaml +260 -0
  4. package/build/spec/reference/evm-arc-debug_tracetransaction.yaml +172 -0
  5. package/build/spec/reference/evm-arc-eth_blocknumber.yaml +95 -0
  6. package/build/spec/reference/evm-arc-eth_call.yaml +232 -0
  7. package/build/spec/reference/evm-arc-eth_chainid.yaml +97 -0
  8. package/build/spec/reference/evm-arc-eth_createaccesslist.yaml +220 -0
  9. package/build/spec/reference/evm-arc-eth_estimategas.yaml +155 -0
  10. package/build/spec/reference/evm-arc-eth_feehistory.yaml +187 -0
  11. package/build/spec/reference/evm-arc-eth_gasprice.yaml +95 -0
  12. package/build/spec/reference/evm-arc-eth_getbalance.yaml +175 -0
  13. package/build/spec/reference/evm-arc-eth_getblockbyhash.yaml +188 -0
  14. package/build/spec/reference/evm-arc-eth_getblockbynumber.yaml +210 -0
  15. package/build/spec/reference/evm-arc-eth_getblockreceipts.yaml +209 -0
  16. package/build/spec/reference/evm-arc-eth_getblocktransactioncountbyhash.yaml +114 -0
  17. package/build/spec/reference/evm-arc-eth_getblocktransactioncountbynumber.yaml +149 -0
  18. package/build/spec/reference/evm-arc-eth_getcode.yaml +162 -0
  19. package/build/spec/reference/evm-arc-eth_getfilterchanges.yaml +134 -0
  20. package/build/spec/reference/evm-arc-eth_getfilterlogs.yaml +134 -0
  21. package/build/spec/reference/evm-arc-eth_getlogs.yaml +215 -0
  22. package/build/spec/reference/evm-arc-eth_getproof.yaml +224 -0
  23. package/build/spec/reference/evm-arc-eth_getstorageat.yaml +169 -0
  24. package/build/spec/reference/evm-arc-eth_gettransactionbyblockhashandindex.yaml +211 -0
  25. package/build/spec/reference/evm-arc-eth_gettransactionbyblocknumberandindex.yaml +245 -0
  26. package/build/spec/reference/evm-arc-eth_gettransactionbyhash.yaml +201 -0
  27. package/build/spec/reference/evm-arc-eth_gettransactioncount.yaml +168 -0
  28. package/build/spec/reference/evm-arc-eth_gettransactionreceipt.yaml +147 -0
  29. package/build/spec/reference/evm-arc-eth_getunclebyblockhashandindex.yaml +152 -0
  30. package/build/spec/reference/evm-arc-eth_getunclebyblocknumberandindex.yaml +186 -0
  31. package/build/spec/reference/evm-arc-eth_getunclecountbyblockhash.yaml +114 -0
  32. package/build/spec/reference/evm-arc-eth_getunclecountbyblocknumber.yaml +149 -0
  33. package/build/spec/reference/evm-arc-eth_maxpriorityfeepergas.yaml +97 -0
  34. package/build/spec/reference/evm-arc-eth_newblockfilter.yaml +97 -0
  35. package/build/spec/reference/evm-arc-eth_newfilter.yaml +197 -0
  36. package/build/spec/reference/evm-arc-eth_newpendingtransactionfilter.yaml +97 -0
  37. package/build/spec/reference/evm-arc-eth_sendrawtransaction.yaml +129 -0
  38. package/build/spec/reference/evm-arc-eth_uninstallfilter.yaml +116 -0
  39. package/build/spec/reference/evm-arc-net_version.yaml +99 -0
  40. package/build/spec/reference/evm-arc-web3_clientversion.yaml +95 -0
  41. package/build/spec/reference/evm-arc-web3_sha3.yaml +121 -0
  42. package/build/spec/reference/multichain-api.yaml +32 -36
  43. package/build/spec/reference/solana-node-api/websocket-methods/slotsUpdatesSubscribe.md +1 -1
  44. package/build/tools/api-categories.js +1 -0
  45. package/package.json +2 -2
@@ -0,0 +1,197 @@
1
+ openapi: 3.1.0
2
+ info:
3
+ title: evm-arc-debug_traceBlockByHash
4
+ version: 1.2.23
5
+ servers:
6
+ - url: https://{arc-network}.nodit.io
7
+ variables:
8
+ arc-network:
9
+ default: arc-testnet
10
+ enum:
11
+ - arc-testnet
12
+ components:
13
+ securitySchemes:
14
+ api_key:
15
+ type: apiKey
16
+ name: X-API-KEY
17
+ in: header
18
+ x-default: nodit-demo
19
+ description: >-
20
+ The default value, `nodit-demo`, is only for use in the developer
21
+ documentation. For real applications or services, use the API key
22
+ obtained from the Nodit console.
23
+ paths:
24
+ /:
25
+ post:
26
+ security:
27
+ - api_key: []
28
+ tags:
29
+ - evm-arc-debug_traceBlockByHash
30
+ description: >
31
+ 특정 블록에 대해 tracer를 설정하여 해당 tracer가 제공하는 정보들을 통해 트랜잭션으로 인한 체인의 상태 변화 및 실제
32
+ call의 발생 이력들을 Debug할 수 있는 도구입니다.
33
+
34
+
35
+
36
+ > 🚧 429 에러가 발생했나요? 구독 중인 플랜을 확인하세요!
37
+
38
+ > 429 에러는 구독 중인 플랜의 Throughput 제한을 초과했을 때 발생할 수 있습니다.
39
+
40
+ > 예를 들어, Starter 플랜은 초당 300CU의 제한이 있기 때문에, Starter 플랜을 사용할 경우 CU 소비량이
41
+ 350인 API를 호출하면 429 오류가 발생할 수 있습니다.
42
+
43
+ > Compute Unit Costs 페이지에서 사용 중인 API의 CU 소비량을 확인하고, 더 많은 Throughput이
44
+ 필요하다면 상위 플랜으로 업그레이드하는 것을 고려하세요!
45
+
46
+ > 👉 [Compute Unit Costs 페이지로
47
+ 이동하기](https://developer.nodit.io/docs/usage-measuringcu)
48
+ summary: debug_traceBlockByHash
49
+ operationId: arc-debug_traceBlockByHash
50
+ parameters: []
51
+ requestBody:
52
+ required: true
53
+ content:
54
+ application/json:
55
+ schema:
56
+ type: object
57
+ required:
58
+ - id
59
+ - jsonrpc
60
+ - method
61
+ - params
62
+ properties:
63
+ id:
64
+ type: integer
65
+ default: 1
66
+ jsonrpc:
67
+ type: string
68
+ default: '2.0'
69
+ method:
70
+ type: string
71
+ default: debug_traceBlockByHash
72
+ params:
73
+ type: array
74
+ items:
75
+ oneOf:
76
+ - title: Block Hash
77
+ type: string
78
+ pattern: ^0[xX][0-9a-fA-F]{64}
79
+ default: >-
80
+ 0x39008d07edf93c03bb9d1cfc80598fcf63f441ec86e9de3733fa6a484980ca48
81
+ description: 블록 해시는 블록의 고유 식별자입니다. 블록 해시값은 64자리 16진수 문자열로 표현됩니다.
82
+ - title: Trace Option Object
83
+ type: object
84
+ properties:
85
+ tracer:
86
+ type: string
87
+ enum:
88
+ - callTracer
89
+ - prestateTracer
90
+ default: callTracer
91
+ description: >-
92
+ tracer의 타입을 지정하는 필드로, "callTracer" 또는
93
+ "prestateTracer" 값 중 하나로 지정합니다.
94
+
95
+ 1. `callTracer` : callTracer는 실행된 트랜잭션의 실행 경로와 결과를
96
+ 확인하는 데 사용됩니다. 트랜잭션의 호출 스택, 반환 값, 가스 소비량, Revert 사유
97
+ 등의 정보를 제공하며, 스마트 계약의 함수 호출과 상호작용하는 과정을 추적할 수 있습니다.
98
+ 실행 옵션(onlyTopCall)에 따라 특정 call의 nested call들을 모두
99
+ 조회하여 추적할 수 있습니다.
100
+
101
+ 2. `prestateTracer`: prestateTracer는 특정 트랜잭션이나 블록이
102
+ 실행되기 전의 상태(pre-state)를 추적하는 도구입니다. 트랜잭션이 실행되기 전의
103
+ 계정 상태와 계약 코드를 기록하며, 트랜잭션의 실행 전과 후의 상태 변화를 분석할 수
104
+ 있습니다. prestateTracer는 스마트 계약의 상태 변경 및 계정 간 상호작용을
105
+ 추적하는 데 사용됩니다.
106
+ tracerConfig:
107
+ type: object
108
+ properties:
109
+ onlyTopCall:
110
+ type: boolean
111
+ default: true
112
+ description: >-
113
+ tracer 설정을 위한 Object입니다. Boolean 타입의 "onlyTopCall"
114
+ 옵션을 사용할 수 있으며, true로 설정하는 경우 main call에 대한 이력만
115
+ trace합니다. false로 설정하는 경우 sub-call 레벨까지 trace합니다.
116
+ description: 'trace 옵션 설정을 위한 object입니다. '
117
+ minItems: 1
118
+ maxItems: 1
119
+ default:
120
+ - >-
121
+ 0x8e38b4dbf6b11fcc3b9dee84fb7986e29ca0a02cecd8977c161ff7333329681e
122
+ - tracer: callTracer
123
+ tracerConfig:
124
+ onlyTopCall: true
125
+ description: |-
126
+ 다음 파라미터들을 타입에 맞게 배열로 입력합니다.
127
+
128
+ 1. `block hash`: 조회하고자 하는 블록 해시를 64자리 16진수 문자열 형식으로 입력합니다.
129
+ 2. `traceOption`: trace 옵션 설정을 위한 object입니다.
130
+ responses:
131
+ '200':
132
+ description: Successful Response
133
+ content:
134
+ application/json:
135
+ example:
136
+ jsonrpc: '2.0'
137
+ id: '1'
138
+ result:
139
+ - result:
140
+ from: '0x39fa8c5f2793459d6622857e7d9fbb4bd91766d3'
141
+ gas: '0x1a6d4'
142
+ gasUsed: '0x723c'
143
+ to: '0xc083e9947cf02b8ffc7d3090ae9aea72df98fd47'
144
+ input: 0x
145
+ output: >-
146
+ 0x0000000000000000000000000000000000000000000000000000000000000000
147
+ calls:
148
+ - from: '0xc083e9947cf02b8ffc7d3090ae9aea72df98fd47'
149
+ gas: '0x18c56'
150
+ gasUsed: '0x5a4'
151
+ to: '0x273930d21e01ee25e4c219b63259d214872220a2'
152
+ input: 0x
153
+ value: '0x56bc75e2d63100000'
154
+ type: CALLCODE
155
+ value: '0x56bc75e2d63100000'
156
+ type: CALL
157
+ - result:
158
+ from: '0x32be343b94f860124dc4fee278fdcbd38c102d88'
159
+ gas: '0x7148'
160
+ gasUsed: '0x5208'
161
+ to: '0xdf190dc7190dfba737d7777a163445b7fff16133'
162
+ input: 0x
163
+ value: '0x6113a84987be800'
164
+ type: CALL
165
+ '400':
166
+ description: Bad Request
167
+ content:
168
+ application/json:
169
+ schema:
170
+ type: object
171
+ required:
172
+ - message
173
+ - error_code
174
+ properties:
175
+ message:
176
+ type: string
177
+ error_code:
178
+ type: string
179
+ description: >-
180
+ These codes provide more granular error information beyond
181
+ just the HTTP status code of the response.
182
+
183
+
184
+ Allowed values: account_not_found, resource_not_found,
185
+ module_not_found, struct_field_not_found,
186
+ version_not_found, transaction_not_found,
187
+ table_item_not_found, block_not_found,
188
+ state_value_not_found, version_pruned, block_pruned,
189
+ invalid_input, invalid_transaction_update,
190
+ sequence_number_too_old, vm_error, health_check_failed,
191
+ mempool_is_full, internal_error, web_framework_error,
192
+ bcs_not_supported, api_disabled
193
+ vm_error_code:
194
+ type: integer
195
+ description: >-
196
+ A code providing VM error details when submitting
197
+ transactions to the VM.
@@ -0,0 +1,225 @@
1
+ openapi: 3.1.0
2
+ info:
3
+ title: evm-arc-debug_traceBlockByNumber
4
+ version: 1.2.23
5
+ servers:
6
+ - url: https://{arc-network}.nodit.io
7
+ variables:
8
+ arc-network:
9
+ default: arc-testnet
10
+ enum:
11
+ - arc-testnet
12
+ components:
13
+ securitySchemes:
14
+ api_key:
15
+ type: apiKey
16
+ name: X-API-KEY
17
+ in: header
18
+ x-default: nodit-demo
19
+ description: >-
20
+ The default value, `nodit-demo`, is only for use in the developer
21
+ documentation. For real applications or services, use the API key
22
+ obtained from the Nodit console.
23
+ paths:
24
+ /:
25
+ post:
26
+ security:
27
+ - api_key: []
28
+ tags:
29
+ - evm-arc-debug_traceBlockByNumber
30
+ description: >
31
+ 특정 블록에 대해 tracer를 설정하여 해당 tracer가 제공하는 정보들을 통해 트랜잭션으로 인한 체인의 상태 변화 및 실제
32
+ call의 발생 이력들을 Debug할 수 있는 도구입니다.
33
+
34
+
35
+
36
+ > 🚧 429 에러가 발생했나요? 구독 중인 플랜을 확인하세요!
37
+
38
+ > 429 에러는 구독 중인 플랜의 Throughput 제한을 초과했을 때 발생할 수 있습니다.
39
+
40
+ > 예를 들어, Starter 플랜은 초당 300CU의 제한이 있기 때문에, Starter 플랜을 사용할 경우 CU 소비량이
41
+ 350인 API를 호출하면 429 오류가 발생할 수 있습니다.
42
+
43
+ > Compute Unit Costs 페이지에서 사용 중인 API의 CU 소비량을 확인하고, 더 많은 Throughput이
44
+ 필요하다면 상위 플랜으로 업그레이드하는 것을 고려하세요!
45
+
46
+ > 👉 [Compute Unit Costs 페이지로
47
+ 이동하기](https://developer.nodit.io/docs/usage-measuringcu)
48
+ summary: debug_traceBlockByNumber
49
+ operationId: arc-debug_traceBlockByNumber
50
+ parameters: []
51
+ requestBody:
52
+ required: true
53
+ content:
54
+ application/json:
55
+ schema:
56
+ type: object
57
+ required:
58
+ - id
59
+ - jsonrpc
60
+ - method
61
+ - params
62
+ properties:
63
+ id:
64
+ type: integer
65
+ default: 1
66
+ jsonrpc:
67
+ type: string
68
+ default: '2.0'
69
+ method:
70
+ type: string
71
+ default: debug_traceBlockByNumber
72
+ params:
73
+ type: array
74
+ items:
75
+ oneOf:
76
+ - title: Block Number or Tag
77
+ type: string
78
+ oneOf:
79
+ - title: Block Number
80
+ type: string
81
+ pattern: ^0[xX][0-9a-fA-F]+$
82
+ default: '0x1076B5A'
83
+ description: 블록 넘버는 블록의 순서를 나타내는 숫자입니다. 블록 넘버는 16진수 문자열로 표현됩니다.
84
+ - title: Block Tag
85
+ type: string
86
+ pattern: ^(latest|earliest|pending|safe|finalized)$
87
+ default: latest
88
+ description: >-
89
+ 블록 태그는 다음 중 하나를 사용하여 블록을 지정할 수 있습니다.
90
+
91
+ * `earliest`: 체인에서 사용 가능한 가장 오래된 블록을 나타냅니다.
92
+
93
+ * `finalized`: 최근에 확정된 블록을 나타내며, 이는 더 이상 변경될 수 없는
94
+ 안정적인 상태의 블록을 의미합니다. 이 용어는 주로 지분 증명(PoS) 블록체인에서
95
+ 사용되며, 블록이 최종적으로 확정되었음을 나타냅니다.
96
+
97
+ * `safe`: 네트워크에 의해 안전하게 간주되는 최근 블록을 나타냅니다. '안전'한
98
+ 블록은 네트워크 재조직(reorgs)의 위험 없이 신뢰할 수 있는 것으로 간주됩니다.
99
+
100
+ * `latest`: 현재 체인의 가장 최근 블록을 나타내며, 아직 최종 확정되지 않았을
101
+ 수 있어 재조직(reorgs)될 가능성이 있습니다. 이는 일반적으로 가장 최신의 상태를
102
+ 조회할 때 사용됩니다.
103
+
104
+ * `pending`: 아직 채굴되지 않은, 메모리 풀에 있는 트랜잭션들을 포함할 예정인
105
+ 다음 블록을 나타냅니다. 이는 주로 예정된 트랜잭션들의 상태를 확인할 때 사용됩니다.
106
+ default: '0x12C1A00'
107
+ description: >-
108
+ 블록 지정을 위해 블록 넘버 또는 블록 태그 중 하나를 사용할 수 있습니다.
109
+
110
+
111
+ * 블록 넘버: 16진수 문자열 (ex. "0x1")
112
+
113
+ * 블록 태그: enum 문자열 (ex. "latest", "earliest",
114
+ "pending")
115
+ - title: Trace Option Object
116
+ type: object
117
+ properties:
118
+ tracer:
119
+ type: string
120
+ enum:
121
+ - callTracer
122
+ - prestateTracer
123
+ default: callTracer
124
+ description: >-
125
+ tracer의 타입을 지정하는 필드로, "callTracer" 또는
126
+ "prestateTracer" 값 중 하나로 지정합니다.
127
+
128
+ 1. `callTracer` : callTracer는 실행된 트랜잭션의 실행 경로와 결과를
129
+ 확인하는 데 사용됩니다. 트랜잭션의 호출 스택, 반환 값, 가스 소비량, Revert 사유
130
+ 등의 정보를 제공하며, 스마트 계약의 함수 호출과 상호작용하는 과정을 추적할 수 있습니다.
131
+ 실행 옵션(onlyTopCall)에 따라 특정 call의 nested call들을 모두
132
+ 조회하여 추적할 수 있습니다.
133
+
134
+ 2. `prestateTracer`: prestateTracer는 특정 트랜잭션이나 블록이
135
+ 실행되기 전의 상태(pre-state)를 추적하는 도구입니다. 트랜잭션이 실행되기 전의
136
+ 계정 상태와 계약 코드를 기록하며, 트랜잭션의 실행 전과 후의 상태 변화를 분석할 수
137
+ 있습니다. prestateTracer는 스마트 계약의 상태 변경 및 계정 간 상호작용을
138
+ 추적하는 데 사용됩니다.
139
+ tracerConfig:
140
+ type: object
141
+ properties:
142
+ onlyTopCall:
143
+ type: boolean
144
+ default: true
145
+ description: >-
146
+ tracer 설정을 위한 Object입니다. Boolean 타입의 "onlyTopCall"
147
+ 옵션을 사용할 수 있으며, true로 설정하는 경우 main call에 대한 이력만
148
+ trace합니다. false로 설정하는 경우 sub-call 레벨까지 trace합니다.
149
+ description: 'trace 옵션 설정을 위한 object입니다. '
150
+ minItems: 1
151
+ maxItems: 1
152
+ default:
153
+ - latest
154
+ - tracer: callTracer
155
+ tracerConfig:
156
+ onlyTopCall: true
157
+ description: "다음 파라미터들을 타입에 맞게 배열로 입력합니다.\n\n1. `block number or block tag`: 조회하고자 하는 블록 넘버를 16진수 문자열 형식으로 입력합니다. \"earliest\", \"latest\", \"pending\" 등의 블록 태그를 입력할 수도 있습니다.\t\n2. `traceOption`: trace 옵션 설정을 위한 object입니다."
158
+ responses:
159
+ '200':
160
+ description: Successful Response
161
+ content:
162
+ application/json:
163
+ example:
164
+ jsonrpc: '2.0'
165
+ id: '1'
166
+ result:
167
+ - result:
168
+ from: '0x39fa8c5f2793459d6622857e7d9fbb4bd91766d3'
169
+ gas: '0x1a6d4'
170
+ gasUsed: '0x723c'
171
+ to: '0xc083e9947cf02b8ffc7d3090ae9aea72df98fd47'
172
+ input: 0x
173
+ output: >-
174
+ 0x0000000000000000000000000000000000000000000000000000000000000000
175
+ calls:
176
+ - from: '0xc083e9947cf02b8ffc7d3090ae9aea72df98fd47'
177
+ gas: '0x18c56'
178
+ gasUsed: '0x5a4'
179
+ to: '0x273930d21e01ee25e4c219b63259d214872220a2'
180
+ input: 0x
181
+ value: '0x56bc75e2d63100000'
182
+ type: CALLCODE
183
+ value: '0x56bc75e2d63100000'
184
+ type: CALL
185
+ - result:
186
+ from: '0x32be343b94f860124dc4fee278fdcbd38c102d88'
187
+ gas: '0x7148'
188
+ gasUsed: '0x5208'
189
+ to: '0xdf190dc7190dfba737d7777a163445b7fff16133'
190
+ input: 0x
191
+ value: '0x6113a84987be800'
192
+ type: CALL
193
+ '400':
194
+ description: Bad Request
195
+ content:
196
+ application/json:
197
+ schema:
198
+ type: object
199
+ required:
200
+ - message
201
+ - error_code
202
+ properties:
203
+ message:
204
+ type: string
205
+ error_code:
206
+ type: string
207
+ description: >-
208
+ These codes provide more granular error information beyond
209
+ just the HTTP status code of the response.
210
+
211
+
212
+ Allowed values: account_not_found, resource_not_found,
213
+ module_not_found, struct_field_not_found,
214
+ version_not_found, transaction_not_found,
215
+ table_item_not_found, block_not_found,
216
+ state_value_not_found, version_pruned, block_pruned,
217
+ invalid_input, invalid_transaction_update,
218
+ sequence_number_too_old, vm_error, health_check_failed,
219
+ mempool_is_full, internal_error, web_framework_error,
220
+ bcs_not_supported, api_disabled
221
+ vm_error_code:
222
+ type: integer
223
+ description: >-
224
+ A code providing VM error details when submitting
225
+ transactions to the VM.
@@ -0,0 +1,260 @@
1
+ openapi: 3.1.0
2
+ info:
3
+ title: evm-arc-debug_traceCall
4
+ version: 1.2.23
5
+ servers:
6
+ - url: https://{arc-network}.nodit.io
7
+ variables:
8
+ arc-network:
9
+ default: arc-testnet
10
+ enum:
11
+ - arc-testnet
12
+ components:
13
+ securitySchemes:
14
+ api_key:
15
+ type: apiKey
16
+ name: X-API-KEY
17
+ in: header
18
+ x-default: nodit-demo
19
+ description: >-
20
+ The default value, `nodit-demo`, is only for use in the developer
21
+ documentation. For real applications or services, use the API key
22
+ obtained from the Nodit console.
23
+ paths:
24
+ /:
25
+ post:
26
+ security:
27
+ - api_key: []
28
+ tags:
29
+ - evm-arc-debug_traceCall
30
+ description: >-
31
+ eth_call을 디버깅 모드로 실행하면서 trace 기능을 제공합니다. 현재 블록의 상태를 기반으로 특정 call을 수행하였을
32
+ 때 발생하는 모든 스택 변화를 추적할 수 있습니다.
33
+ summary: debug_traceCall
34
+ operationId: arc-debug_traceCall
35
+ parameters: []
36
+ requestBody:
37
+ required: true
38
+ content:
39
+ application/json:
40
+ schema:
41
+ type: object
42
+ required:
43
+ - id
44
+ - jsonrpc
45
+ - method
46
+ - params
47
+ properties:
48
+ id:
49
+ type: integer
50
+ default: 1
51
+ jsonrpc:
52
+ type: string
53
+ default: '2.0'
54
+ method:
55
+ type: string
56
+ default: debug_traceCall
57
+ params:
58
+ type: array
59
+ items:
60
+ oneOf:
61
+ - title: Call Object
62
+ type: object
63
+ properties:
64
+ from:
65
+ type: string
66
+ description: 트랜잭션의 from 주소를 문자열 형식으로 입력합니다.
67
+ to:
68
+ type: string
69
+ description: 트랜잭션의 to 주소를 문자열 형식으로 입력합니다.
70
+ default: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48'
71
+ gas:
72
+ type: string
73
+ description: >-
74
+ 해당 트랜잭션을 처리하기 위해 필요한 가스의 소모량을 hex형식의 문자열로 입력합니다.
75
+ 스마트 컨트랙트 call을 수행하는 경우 소모되는 가스가 없으므로 0x0로 입력할 수
76
+ 있습니다.
77
+ gasPrice:
78
+ type: string
79
+ description: 설정하고자 하는 가스당 비용을 hex 형식의 문자열로 입력합니다.
80
+ value:
81
+ type: string
82
+ description: 트랜잭션의 value 값입니다.
83
+ data:
84
+ type: string
85
+ description: >-
86
+ 실행하고자 하는 트랜잭션의 method signature 해시값입니다. ABI에서 참고할
87
+ 수 있습니다.
88
+ default: >-
89
+ 0x70a08231000000000000000000000000d8dA6BF26964aF9D7eEd9e03E53415D37aA96045
90
+ description: >-
91
+ 트랜잭션을 시뮬레이션하기 위한 call object입니다. 다음 필드를 포함할 수 있습니다.
92
+
93
+ * `from`: 트랜잭션의 from 주소를 문자열 형식으로 입력합니다.
94
+
95
+ * `to` : 트랜잭션의 to 주소를 문자열 형식으로 입력합니다.
96
+
97
+ * `gas` : 해당 트랜잭션을 처리하기 위해 필요한 가스의 소모량을 hex형식의 문자열로
98
+ 입력합니다. 스마트 컨트랙트 call을 수행하는 경우 소모되는 가스가 없으므로 0x0로 입력할 수
99
+ 있습니다.
100
+
101
+ * `gasPrice` : 설정하고자 하는 가스당 비용을 hex 형식의 문자열로 입력합니다.
102
+
103
+ * `value` : 트랜잭션의 value 값입니다.
104
+
105
+ * `data` : 실행하고자 하는 트랜잭션의 method signature 해시값입니다.
106
+ ABI에서 참고할 수 있습니다.
107
+ - title: Block Identifier
108
+ type: string
109
+ oneOf:
110
+ - title: Block Number
111
+ type: string
112
+ pattern: ^0[xX][0-9a-fA-F]+$
113
+ default: '0x1076B5A'
114
+ description: 블록 넘버는 블록의 순서를 나타내는 숫자입니다. 블록 넘버는 16진수 문자열로 표현됩니다.
115
+ - title: Block Hash
116
+ type: string
117
+ pattern: ^0[xX][0-9a-fA-F]{64}
118
+ default: >-
119
+ 0x39008d07edf93c03bb9d1cfc80598fcf63f441ec86e9de3733fa6a484980ca48
120
+ description: >-
121
+ 블록 해시는 블록의 고유 식별자입니다. 블록 해시값은 64자리 16진수 문자열로
122
+ 표현됩니다.
123
+ - title: Block Tag
124
+ type: string
125
+ pattern: ^(latest|earliest|pending|safe|finalized)$
126
+ default: latest
127
+ description: >-
128
+ 블록 태그는 다음 중 하나를 사용하여 블록을 지정할 수 있습니다.
129
+
130
+ * `earliest`: 체인에서 사용 가능한 가장 오래된 블록을 나타냅니다.
131
+
132
+ * `finalized`: 최근에 확정된 블록을 나타내며, 이는 더 이상 변경될 수 없는
133
+ 안정적인 상태의 블록을 의미합니다. 이 용어는 주로 지분 증명(PoS) 블록체인에서
134
+ 사용되며, 블록이 최종적으로 확정되었음을 나타냅니다.
135
+
136
+ * `safe`: 네트워크에 의해 안전하게 간주되는 최근 블록을 나타냅니다. '안전'한
137
+ 블록은 네트워크 재조직(reorgs)의 위험 없이 신뢰할 수 있는 것으로 간주됩니다.
138
+
139
+ * `latest`: 현재 체인의 가장 최근 블록을 나타내며, 아직 최종 확정되지 않았을
140
+ 수 있어 재조직(reorgs)될 가능성이 있습니다. 이는 일반적으로 가장 최신의 상태를
141
+ 조회할 때 사용됩니다.
142
+
143
+ * `pending`: 아직 채굴되지 않은, 메모리 풀에 있는 트랜잭션들을 포함할 예정인
144
+ 다음 블록을 나타냅니다. 이는 주로 예정된 트랜잭션들의 상태를 확인할 때 사용됩니다.
145
+ default: '0x12C1A00'
146
+ description: >-
147
+ 블록 지정을 위해 블록 해시, 블록 넘버, 또는 블록 태그 중 하나를 사용할 수 있습니다.
148
+
149
+ * 블록 넘버: 16진수 문자열 (ex. "0x1")
150
+
151
+ * 블록 해시: 64자리 16진수 문자열 (ex.
152
+ "0x39008d07edf93c03bb9d1cfc80598fcf63f441ec86e9de3733fa6a484980ca48")]
153
+
154
+ * 블록 태그: enum 문자열 (ex. "latest", "earliest",
155
+ "pending")
156
+ - title: Trace Option Object
157
+ type: object
158
+ properties:
159
+ tracer:
160
+ type: string
161
+ enum:
162
+ - callTracer
163
+ - prestateTracer
164
+ default: callTracer
165
+ description: >-
166
+ tracer의 타입을 지정하는 필드로, "callTracer" 또는
167
+ "prestateTracer" 값 중 하나로 지정합니다.
168
+
169
+ 1. `callTracer` : callTracer는 실행된 트랜잭션의 실행 경로와 결과를
170
+ 확인하는 데 사용됩니다. 트랜잭션의 호출 스택, 반환 값, 가스 소비량, Revert 사유
171
+ 등의 정보를 제공하며, 스마트 계약의 함수 호출과 상호작용하는 과정을 추적할 수 있습니다.
172
+ 실행 옵션(onlyTopCall)에 따라 특정 call의 nested call들을 모두
173
+ 조회하여 추적할 수 있습니다.
174
+
175
+ 2. `prestateTracer`: prestateTracer는 특정 트랜잭션이나 블록이
176
+ 실행되기 전의 상태(pre-state)를 추적하는 도구입니다. 트랜잭션이 실행되기 전의
177
+ 계정 상태와 계약 코드를 기록하며, 트랜잭션의 실행 전과 후의 상태 변화를 분석할 수
178
+ 있습니다. prestateTracer는 스마트 계약의 상태 변경 및 계정 간 상호작용을
179
+ 추적하는 데 사용됩니다.
180
+ tracerConfig:
181
+ type: object
182
+ properties:
183
+ onlyTopCall:
184
+ type: boolean
185
+ default: true
186
+ description: >-
187
+ tracer 설정을 위한 Object입니다. Boolean 타입의 "onlyTopCall"
188
+ 옵션을 사용할 수 있으며, true로 설정하는 경우 main call에 대한 이력만
189
+ trace합니다. false로 설정하는 경우 sub-call 레벨까지 trace합니다.
190
+ description: 'trace 옵션 설정을 위한 object입니다. '
191
+ minItems: 3
192
+ maxItems: 3
193
+ default:
194
+ - from: '0xc90d3Ac75D1D36dF0b0a229E73D8409FB7F3c4ab'
195
+ to: '0xd3CdA913deB6f67967B99D67aCDFa1712C293601'
196
+ value: '0x186a0'
197
+ - finalized
198
+ - tracer: callTracer
199
+ description: >-
200
+ 다음 파라미터들을 타입에 맞게 배열로 입력합니다.
201
+
202
+
203
+ 1. `call object` - 호출할 컨트랙트의 주소와 호출할 함수의 데이터를 입력합니다.
204
+
205
+ 2. `block identifier` - 조회 대상 블록 식별자로 블록 넘버, 블록 해시, 블록 태그 중
206
+ 하나를 입력할 수 있습니다.
207
+
208
+ 3. `trace option`: trace 옵션 설정을 위한 object입니다.
209
+ responses:
210
+ '200':
211
+ description: Successful Response
212
+ content:
213
+ application/json:
214
+ example:
215
+ jsonrpc: '2.0'
216
+ id: '1'
217
+ result:
218
+ from: '0x0000000000000000000000000000000000000000'
219
+ gas: '0x2faf080'
220
+ gasUsed: '0x5d83'
221
+ to: '0xa3e0dfbf8dbd86e039f7cdb37682a776d66dae4b'
222
+ input: >-
223
+ 0x70a08231000000000000000000000000a03167de1a56160e4647d77d81e9139af55b63d4
224
+ output: >-
225
+ 0x000000000000000000000000000000000000000000000000000003c18cd105e2
226
+ value: '0x0'
227
+ type: CALL
228
+ '400':
229
+ description: Bad Request
230
+ content:
231
+ application/json:
232
+ schema:
233
+ type: object
234
+ required:
235
+ - message
236
+ - error_code
237
+ properties:
238
+ message:
239
+ type: string
240
+ error_code:
241
+ type: string
242
+ description: >-
243
+ These codes provide more granular error information beyond
244
+ just the HTTP status code of the response.
245
+
246
+
247
+ Allowed values: account_not_found, resource_not_found,
248
+ module_not_found, struct_field_not_found,
249
+ version_not_found, transaction_not_found,
250
+ table_item_not_found, block_not_found,
251
+ state_value_not_found, version_pruned, block_pruned,
252
+ invalid_input, invalid_transaction_update,
253
+ sequence_number_too_old, vm_error, health_check_failed,
254
+ mempool_is_full, internal_error, web_framework_error,
255
+ bcs_not_supported, api_disabled
256
+ vm_error_code:
257
+ type: integer
258
+ description: >-
259
+ A code providing VM error details when submitting
260
+ transactions to the VM.