@mysten/sui 2.20.3 → 2.21.0

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 (79) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/dist/bcs/bcs.d.mts +6 -6
  3. package/dist/bcs/index.d.mts +20 -20
  4. package/dist/client/core.d.mts.map +1 -1
  5. package/dist/client/core.mjs +4 -1
  6. package/dist/client/core.mjs.map +1 -1
  7. package/dist/client/mvr.d.mts.map +1 -1
  8. package/dist/client/mvr.mjs +29 -7
  9. package/dist/client/mvr.mjs.map +1 -1
  10. package/dist/cryptography/signature.d.mts +6 -6
  11. package/dist/grpc/client.d.mts.map +1 -1
  12. package/dist/grpc/client.mjs +1 -1
  13. package/dist/grpc/client.mjs.map +1 -1
  14. package/dist/grpc/core.d.mts +13 -5
  15. package/dist/grpc/core.d.mts.map +1 -1
  16. package/dist/grpc/core.mjs +68 -46
  17. package/dist/grpc/core.mjs.map +1 -1
  18. package/dist/grpc/index.d.mts +2 -2
  19. package/dist/grpc/index.mjs +2 -2
  20. package/dist/grpc/proto/sui/forking/v1alpha/forking_service.client.d.mts +4 -4
  21. package/dist/grpc/proto/sui/rpc/v2/name_service.client.d.mts +4 -4
  22. package/dist/grpc/proto/sui/rpc/v2/state_service.client.d.mts +4 -4
  23. package/dist/grpc/proto/sui/rpc/v2/subscription_service.client.d.mts +4 -4
  24. package/dist/jsonRpc/client.d.mts +160 -0
  25. package/dist/jsonRpc/client.d.mts.map +1 -1
  26. package/dist/jsonRpc/client.mjs +142 -0
  27. package/dist/jsonRpc/client.mjs.map +1 -1
  28. package/dist/jsonRpc/core.d.mts +80 -0
  29. package/dist/jsonRpc/core.d.mts.map +1 -1
  30. package/dist/jsonRpc/core.mjs +80 -0
  31. package/dist/jsonRpc/core.mjs.map +1 -1
  32. package/dist/jsonRpc/errors.d.mts +12 -0
  33. package/dist/jsonRpc/errors.d.mts.map +1 -1
  34. package/dist/jsonRpc/errors.mjs +12 -0
  35. package/dist/jsonRpc/errors.mjs.map +1 -1
  36. package/dist/jsonRpc/http-transport.d.mts +30 -0
  37. package/dist/jsonRpc/http-transport.d.mts.map +1 -1
  38. package/dist/jsonRpc/http-transport.mjs +16 -0
  39. package/dist/jsonRpc/http-transport.mjs.map +1 -1
  40. package/dist/jsonRpc/network.d.mts +4 -0
  41. package/dist/jsonRpc/network.d.mts.map +1 -1
  42. package/dist/jsonRpc/network.mjs +4 -0
  43. package/dist/jsonRpc/network.mjs.map +1 -1
  44. package/dist/jsonRpc/types/chain.d.mts +68 -0
  45. package/dist/jsonRpc/types/chain.d.mts.map +1 -1
  46. package/dist/jsonRpc/types/changes.d.mts +24 -0
  47. package/dist/jsonRpc/types/changes.d.mts.map +1 -1
  48. package/dist/jsonRpc/types/coins.d.mts +4 -0
  49. package/dist/jsonRpc/types/coins.d.mts.map +1 -1
  50. package/dist/jsonRpc/types/common.d.mts +4 -0
  51. package/dist/jsonRpc/types/common.d.mts.map +1 -1
  52. package/dist/jsonRpc/types/generated.d.mts +497 -16
  53. package/dist/jsonRpc/types/generated.d.mts.map +1 -1
  54. package/dist/jsonRpc/types/params.d.mts +289 -41
  55. package/dist/jsonRpc/types/params.d.mts.map +1 -1
  56. package/dist/transactions/Transaction.d.mts +9 -9
  57. package/dist/transactions/Transaction.d.mts.map +1 -1
  58. package/dist/version.mjs +1 -1
  59. package/dist/version.mjs.map +1 -1
  60. package/dist/zklogin/bcs.d.mts +14 -14
  61. package/dist/zklogin/bcs.d.mts.map +1 -1
  62. package/package.json +1 -1
  63. package/src/client/core.ts +1 -0
  64. package/src/client/mvr.ts +39 -6
  65. package/src/grpc/client.ts +10 -7
  66. package/src/grpc/core.ts +251 -168
  67. package/src/grpc/index.ts +5 -1
  68. package/src/jsonRpc/client.ts +160 -0
  69. package/src/jsonRpc/core.ts +80 -0
  70. package/src/jsonRpc/errors.ts +12 -0
  71. package/src/jsonRpc/http-transport.ts +30 -0
  72. package/src/jsonRpc/network.ts +4 -0
  73. package/src/jsonRpc/types/chain.ts +68 -0
  74. package/src/jsonRpc/types/changes.ts +24 -0
  75. package/src/jsonRpc/types/coins.ts +4 -0
  76. package/src/jsonRpc/types/common.ts +4 -0
  77. package/src/jsonRpc/types/generated.ts +497 -16
  78. package/src/jsonRpc/types/params.ts +289 -41
  79. package/src/version.ts +1 -1
@@ -7,6 +7,9 @@ import "../../transactions/index.mjs";
7
7
  * Runs the transaction in dev-inspect mode. Which allows for nearly any transaction (or Move call)
8
8
  * with any arguments. Detailed results are provided, including both the transaction effects and any
9
9
  * return values.
10
+ *
11
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
12
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
10
13
  */
11
14
  interface DevInspectTransactionBlockParams {
12
15
  sender: string;
@@ -23,6 +26,9 @@ interface DevInspectTransactionBlockParams {
23
26
  /**
24
27
  * Return transaction execution effects including the gas cost summary, while the effects are not
25
28
  * committed to the chain.
29
+ *
30
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
31
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
26
32
  */
27
33
  interface DryRunTransactionBlockParams {
28
34
  transactionBlock: Uint8Array | string;
@@ -37,6 +43,9 @@ interface DryRunTransactionBlockParams {
37
43
  * the transaction locally in a timely manner, a bool type in the response is set to false to indicated
38
44
  * the case. request_type is default to be `WaitForEffectsCert` unless options.show_events or
39
45
  * options.show_effects is true
46
+ *
47
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
48
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
40
49
  */
41
50
  interface ExecuteTransactionBlockParams {
42
51
  /** BCS serialized transaction data bytes without its type tag, as base-64 encoded string. */
@@ -48,21 +57,36 @@ interface ExecuteTransactionBlockParams {
48
57
  signature: string | string[];
49
58
  /** options for specifying the content to be returned */
50
59
  options?: SuiTransactionBlockResponseOptions | null | undefined;
51
- /** @deprecated requestType will be ignored by JSON RPC in the future */
60
+ /** @deprecated requestType is deprecated and should not be used */
52
61
  requestType?: ExecuteTransactionRequestType | null | undefined;
53
62
  signal?: AbortSignal;
54
63
  }
55
- /** Return the first four bytes of the chain's genesis checkpoint digest. */
64
+ /**
65
+ * Return the first four bytes of the chain's genesis checkpoint digest.
66
+ *
67
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
68
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
69
+ */
56
70
  interface GetChainIdentifierParams {
57
71
  signal?: AbortSignal;
58
72
  }
59
- /** Return a checkpoint */
73
+ /**
74
+ * Return a checkpoint
75
+ *
76
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
77
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
78
+ */
60
79
  interface GetCheckpointParams {
61
80
  /** Checkpoint identifier, can use either checkpoint digest, or checkpoint sequence number as input. */
62
81
  id: CheckpointId;
63
82
  signal?: AbortSignal;
64
83
  }
65
- /** Return paginated list of checkpoints */
84
+ /**
85
+ * Return paginated list of checkpoints
86
+ *
87
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
88
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
89
+ */
66
90
  interface GetCheckpointsParams {
67
91
  /**
68
92
  * An optional paging cursor. If provided, the query will start from the next item after the specified
@@ -75,49 +99,89 @@ interface GetCheckpointsParams {
75
99
  descendingOrder: boolean;
76
100
  signal?: AbortSignal;
77
101
  }
78
- /** Return transaction events. */
102
+ /**
103
+ * Return transaction events.
104
+ *
105
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
106
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
107
+ */
79
108
  interface GetEventsParams {
80
109
  /** the event query criteria. */
81
110
  transactionDigest: string;
82
111
  signal?: AbortSignal;
83
112
  }
84
- /** Return the sequence number of the latest checkpoint that has been executed */
113
+ /**
114
+ * Return the sequence number of the latest checkpoint that has been executed
115
+ *
116
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
117
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
118
+ */
85
119
  interface GetLatestCheckpointSequenceNumberParams {
86
120
  signal?: AbortSignal;
87
121
  }
88
- /** Return the argument types of a Move function, based on normalized Type. */
122
+ /**
123
+ * Return the argument types of a Move function, based on normalized Type.
124
+ *
125
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
126
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
127
+ */
89
128
  interface GetMoveFunctionArgTypesParams {
90
129
  package: string;
91
130
  module: string;
92
131
  function: string;
93
132
  signal?: AbortSignal;
94
133
  }
95
- /** Return a structured representation of Move function */
134
+ /**
135
+ * Return a structured representation of Move function
136
+ *
137
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
138
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
139
+ */
96
140
  interface GetNormalizedMoveFunctionParams {
97
141
  package: string;
98
142
  module: string;
99
143
  function: string;
100
144
  signal?: AbortSignal;
101
145
  }
102
- /** Return a structured representation of Move module */
146
+ /**
147
+ * Return a structured representation of Move module
148
+ *
149
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
150
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
151
+ */
103
152
  interface GetNormalizedMoveModuleParams {
104
153
  package: string;
105
154
  module: string;
106
155
  signal?: AbortSignal;
107
156
  }
108
- /** Return structured representations of all modules in the given package */
157
+ /**
158
+ * Return structured representations of all modules in the given package
159
+ *
160
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
161
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
162
+ */
109
163
  interface GetNormalizedMoveModulesByPackageParams {
110
164
  package: string;
111
165
  signal?: AbortSignal;
112
166
  }
113
- /** Return a structured representation of Move struct */
167
+ /**
168
+ * Return a structured representation of Move struct
169
+ *
170
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
171
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
172
+ */
114
173
  interface GetNormalizedMoveStructParams {
115
174
  package: string;
116
175
  module: string;
117
176
  struct: string;
118
177
  signal?: AbortSignal;
119
178
  }
120
- /** Return the object information for a specified object */
179
+ /**
180
+ * Return the object information for a specified object
181
+ *
182
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
183
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
184
+ */
121
185
  interface GetObjectParams {
122
186
  /** the ID of the queried object */
123
187
  id: string;
@@ -128,6 +192,9 @@ interface GetObjectParams {
128
192
  /**
129
193
  * Return the protocol config table for the given version number. If none is specified, the node uses
130
194
  * the version of the latest epoch it has processed.
195
+ *
196
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
197
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
131
198
  */
132
199
  interface GetProtocolConfigParams {
133
200
  /**
@@ -137,11 +204,21 @@ interface GetProtocolConfigParams {
137
204
  version?: string | null | undefined;
138
205
  signal?: AbortSignal;
139
206
  }
140
- /** Return the total number of transaction blocks known to the server. */
207
+ /**
208
+ * Return the total number of transaction blocks known to the server.
209
+ *
210
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
211
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
212
+ */
141
213
  interface GetTotalTransactionBlocksParams {
142
214
  signal?: AbortSignal;
143
215
  }
144
- /** Return the transaction response object. */
216
+ /**
217
+ * Return the transaction response object.
218
+ *
219
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
220
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
221
+ */
145
222
  interface GetTransactionBlockParams {
146
223
  /** the digest of the queried transaction */
147
224
  digest: string;
@@ -149,7 +226,12 @@ interface GetTransactionBlockParams {
149
226
  options?: SuiTransactionBlockResponseOptions | null | undefined;
150
227
  signal?: AbortSignal;
151
228
  }
152
- /** Return the object data for a list of objects */
229
+ /**
230
+ * Return the object data for a list of objects
231
+ *
232
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
233
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
234
+ */
153
235
  interface MultiGetObjectsParams {
154
236
  /** the IDs of the queried objects */
155
237
  ids: string[];
@@ -160,6 +242,9 @@ interface MultiGetObjectsParams {
160
242
  /**
161
243
  * Returns an ordered list of transaction responses The method will throw an error if the input
162
244
  * contains any duplicate or the input size exceeds QUERY_MAX_RESULT_LIMIT
245
+ *
246
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
247
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
163
248
  */
164
249
  interface MultiGetTransactionBlocksParams {
165
250
  /** A list of transaction digests. */
@@ -172,6 +257,9 @@ interface MultiGetTransactionBlocksParams {
172
257
  * Note there is no software-level guarantee/SLA that objects with past versions can be retrieved by
173
258
  * this API, even if the object and version exists/existed. The result may vary across nodes depending
174
259
  * on their pruning policies. Return the object information for a specified version
260
+ *
261
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
262
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
175
263
  */
176
264
  interface TryGetPastObjectParams {
177
265
  /** the ID of the queried object */
@@ -186,6 +274,9 @@ interface TryGetPastObjectParams {
186
274
  * Note there is no software-level guarantee/SLA that objects with past versions can be retrieved by
187
275
  * this API, even if the object and version exists/existed. The result may vary across nodes depending
188
276
  * on their pruning policies. Return the object information for a specified version
277
+ *
278
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
279
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
189
280
  */
190
281
  interface TryMultiGetPastObjectsParams {
191
282
  /** a vector of object and versions to be queried */
@@ -194,7 +285,12 @@ interface TryMultiGetPastObjectsParams {
194
285
  options?: SuiObjectDataOptions | null | undefined;
195
286
  signal?: AbortSignal;
196
287
  }
197
- /** Verify a zklogin signature for the given bytes, intent scope and author. */
288
+ /**
289
+ * Verify a zklogin signature for the given bytes, intent scope and author.
290
+ *
291
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
292
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
293
+ */
198
294
  interface VerifyZkLoginSignatureParams {
199
295
  /**
200
296
  * The Base64 string of bcs bytes for raw transaction data or personal message indicated by
@@ -209,13 +305,23 @@ interface VerifyZkLoginSignatureParams {
209
305
  author: string;
210
306
  signal?: AbortSignal;
211
307
  }
212
- /** Return the total coin balance for all coin type, owned by the address owner. */
308
+ /**
309
+ * Return the total coin balance for all coin type, owned by the address owner.
310
+ *
311
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
312
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
313
+ */
213
314
  interface GetAllBalancesParams {
214
315
  /** the owner's Sui address */
215
316
  owner: string;
216
317
  signal?: AbortSignal;
217
318
  }
218
- /** Return all Coin objects owned by an address. */
319
+ /**
320
+ * Return all Coin objects owned by an address.
321
+ *
322
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
323
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
324
+ */
219
325
  interface GetAllCoinsParams {
220
326
  /** the owner's Sui address */
221
327
  owner: string;
@@ -225,7 +331,12 @@ interface GetAllCoinsParams {
225
331
  limit?: number | null | undefined;
226
332
  signal?: AbortSignal;
227
333
  }
228
- /** Return the total coin balance for one coin type, owned by the address owner. */
334
+ /**
335
+ * Return the total coin balance for one coin type, owned by the address owner.
336
+ *
337
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
338
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
339
+ */
229
340
  interface GetBalanceParams {
230
341
  /** the owner's Sui address */
231
342
  owner: string;
@@ -240,13 +351,21 @@ interface GetBalanceParams {
240
351
  * Return metadata (e.g., symbol, decimals) for a coin. Note that if the coin's metadata was wrapped in
241
352
  * the transaction that published its marker type, or the latest version of the metadata object is
242
353
  * wrapped or deleted, it will not be found.
354
+ *
355
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
356
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
243
357
  */
244
358
  interface GetCoinMetadataParams {
245
359
  /** type name for the coin (e.g., 0x168da5bf1f48dafc111b0a488fa454aca95e0b5e::usdc::USDC) */
246
360
  coinType: string;
247
361
  signal?: AbortSignal;
248
362
  }
249
- /** Return all Coin<`coin_type`> objects owned by an address. */
363
+ /**
364
+ * Return all Coin<`coin_type`> objects owned by an address.
365
+ *
366
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
367
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
368
+ */
250
369
  interface GetCoinsParams {
251
370
  /** the owner's Sui address */
252
371
  owner: string;
@@ -261,13 +380,23 @@ interface GetCoinsParams {
261
380
  limit?: number | null | undefined;
262
381
  signal?: AbortSignal;
263
382
  }
264
- /** Return the committee information for the asked `epoch`. */
383
+ /**
384
+ * Return the committee information for the asked `epoch`.
385
+ *
386
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
387
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
388
+ */
265
389
  interface GetCommitteeInfoParams {
266
390
  /** The epoch of interest. If None, default to the latest epoch */
267
391
  epoch?: string | null | undefined;
268
392
  signal?: AbortSignal;
269
393
  }
270
- /** Return the dynamic field object information for a specified object */
394
+ /**
395
+ * Return the dynamic field object information for a specified object
396
+ *
397
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
398
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
399
+ */
271
400
  interface GetDynamicFieldObjectParams {
272
401
  /** The ID of the queried parent object */
273
402
  parentId: string;
@@ -275,7 +404,12 @@ interface GetDynamicFieldObjectParams {
275
404
  name: DynamicFieldName;
276
405
  signal?: AbortSignal;
277
406
  }
278
- /** Return the list of dynamic field objects owned by an object. */
407
+ /**
408
+ * Return the list of dynamic field objects owned by an object.
409
+ *
410
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
411
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
412
+ */
279
413
  interface GetDynamicFieldsParams {
280
414
  /** The ID of the parent object */
281
415
  parentId: string;
@@ -288,7 +422,12 @@ interface GetDynamicFieldsParams {
288
422
  limit?: number | null | undefined;
289
423
  signal?: AbortSignal;
290
424
  }
291
- /** Return the latest SUI system state object on-chain. */
425
+ /**
426
+ * Return the latest SUI system state object on-chain.
427
+ *
428
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
429
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
430
+ */
292
431
  interface GetLatestSuiSystemStateParams {
293
432
  signal?: AbortSignal;
294
433
  }
@@ -296,6 +435,9 @@ interface GetLatestSuiSystemStateParams {
296
435
  * Return the list of objects owned by an address. Note that if the address owns more than
297
436
  * `QUERY_MAX_RESULT_LIMIT` objects, the pagination is not accurate, because previous page may have
298
437
  * been updated when the next page is fetched. Please use suix_queryObjects if this is a concern.
438
+ *
439
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
440
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
299
441
  */
300
442
  type GetOwnedObjectsParams = {
301
443
  /** the owner's Sui address */owner: string;
@@ -307,31 +449,61 @@ type GetOwnedObjectsParams = {
307
449
  limit?: number | null | undefined;
308
450
  signal?: AbortSignal;
309
451
  } & SuiObjectResponseQuery;
310
- /** Return the reference gas price for the network */
452
+ /**
453
+ * Return the reference gas price for the network
454
+ *
455
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
456
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
457
+ */
311
458
  interface GetReferenceGasPriceParams {
312
459
  signal?: AbortSignal;
313
460
  }
314
- /** Return all [DelegatedStake]. */
461
+ /**
462
+ * Return all [DelegatedStake].
463
+ *
464
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
465
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
466
+ */
315
467
  interface GetStakesParams {
316
468
  owner: string;
317
469
  signal?: AbortSignal;
318
470
  }
319
- /** Return one or more [DelegatedStake]. If a Stake was withdrawn its status will be Unstaked. */
471
+ /**
472
+ * Return one or more [DelegatedStake]. If a Stake was withdrawn its status will be Unstaked.
473
+ *
474
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
475
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
476
+ */
320
477
  interface GetStakesByIdsParams {
321
478
  stakedSuiIds: string[];
322
479
  signal?: AbortSignal;
323
480
  }
324
- /** Return total supply for a coin */
481
+ /**
482
+ * Return total supply for a coin
483
+ *
484
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
485
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
486
+ */
325
487
  interface GetTotalSupplyParams {
326
488
  /** type name for the coin (e.g., 0x168da5bf1f48dafc111b0a488fa454aca95e0b5e::usdc::USDC) */
327
489
  coinType: string;
328
490
  signal?: AbortSignal;
329
491
  }
330
- /** Return the validator APY */
492
+ /**
493
+ * Return the validator APY
494
+ *
495
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
496
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
497
+ */
331
498
  interface GetValidatorsApyParams {
332
499
  signal?: AbortSignal;
333
500
  }
334
- /** Return list of events for a specified query criteria. */
501
+ /**
502
+ * Return list of events for a specified query criteria.
503
+ *
504
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
505
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
506
+ */
335
507
  interface QueryEventsParams {
336
508
  /**
337
509
  * The event query criteria. See [Event filter](https://docs.sui.io/build/event_api#event-filters)
@@ -346,7 +518,12 @@ interface QueryEventsParams {
346
518
  order?: 'ascending' | 'descending' | null | undefined;
347
519
  signal?: AbortSignal;
348
520
  }
349
- /** Return list of transactions for a specified query criteria. */
521
+ /**
522
+ * Return list of transactions for a specified query criteria.
523
+ *
524
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
525
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
526
+ */
350
527
  type QueryTransactionBlocksParams = {
351
528
  /**
352
529
  * An optional paging cursor. If provided, the query will start from the next item after the specified
@@ -357,7 +534,12 @@ type QueryTransactionBlocksParams = {
357
534
  order?: 'ascending' | 'descending' | null | undefined;
358
535
  signal?: AbortSignal;
359
536
  } & SuiTransactionBlockResponseQuery;
360
- /** Return the resolved address given resolver and name */
537
+ /**
538
+ * Return the resolved address given resolver and name
539
+ *
540
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
541
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
542
+ */
361
543
  interface ResolveNameServiceAddressParams {
362
544
  /** The name to resolve */
363
545
  name: string;
@@ -366,6 +548,9 @@ interface ResolveNameServiceAddressParams {
366
548
  /**
367
549
  * Return the resolved names given address, if multiple names are resolved, the first one is the
368
550
  * primary name.
551
+ *
552
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
553
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
369
554
  */
370
555
  interface ResolveNameServiceNamesParams {
371
556
  /** The address to resolve */
@@ -374,7 +559,12 @@ interface ResolveNameServiceNamesParams {
374
559
  limit?: number | null | undefined;
375
560
  signal?: AbortSignal;
376
561
  }
377
- /** Subscribe to a stream of Sui event */
562
+ /**
563
+ * Subscribe to a stream of Sui event
564
+ *
565
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
566
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
567
+ */
378
568
  interface SubscribeEventParams {
379
569
  /**
380
570
  * The filter criteria of the event stream. See
@@ -383,12 +573,22 @@ interface SubscribeEventParams {
383
573
  filter: SuiEventFilter;
384
574
  signal?: AbortSignal;
385
575
  }
386
- /** Subscribe to a stream of Sui transaction effects */
576
+ /**
577
+ * Subscribe to a stream of Sui transaction effects
578
+ *
579
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
580
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
581
+ */
387
582
  interface SubscribeTransactionParams {
388
583
  filter: TransactionFilter;
389
584
  signal?: AbortSignal;
390
585
  }
391
- /** Create an unsigned batched transaction. */
586
+ /**
587
+ * Create an unsigned batched transaction.
588
+ *
589
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
590
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
591
+ */
392
592
  interface UnsafeBatchTransactionParams {
393
593
  /** the transaction signer's Sui address */
394
594
  signer: string;
@@ -405,7 +605,12 @@ interface UnsafeBatchTransactionParams {
405
605
  txnBuilderMode?: SuiTransactionBlockBuilderMode | null | undefined;
406
606
  signal?: AbortSignal;
407
607
  }
408
- /** Create an unsigned transaction to merge multiple coins into one coin. */
608
+ /**
609
+ * Create an unsigned transaction to merge multiple coins into one coin.
610
+ *
611
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
612
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
613
+ */
409
614
  interface UnsafeMergeCoinsParams {
410
615
  /** the transaction signer's Sui address */
411
616
  signer: string;
@@ -428,6 +633,9 @@ interface UnsafeMergeCoinsParams {
428
633
  /**
429
634
  * Create an unsigned transaction to execute a Move call on the network, by calling the specified
430
635
  * function in the module of a given package.
636
+ *
637
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
638
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
431
639
  */
432
640
  interface UnsafeMoveCallParams {
433
641
  /** the transaction signer's Sui address */
@@ -464,6 +672,9 @@ interface UnsafeMoveCallParams {
464
672
  * The object specified in the `gas` field will be used to pay the gas fee for the transaction. The gas
465
673
  * object can not appear in `input_coins`. If the gas object is not specified, the RPC server will
466
674
  * auto-select one.
675
+ *
676
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
677
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
467
678
  */
468
679
  interface UnsafePayParams {
469
680
  /** the transaction signer's Sui address */
@@ -489,6 +700,9 @@ interface UnsafePayParams {
489
700
  * deposit all SUI to the first input coin 2. transfer the updated first coin to the recipient and also
490
701
  * use this first coin as gas coin object. 3. the balance of the first input coin after tx is
491
702
  * sum(input_coins) - actual_gas_cost. 4. all other input coins other than the first are deleted.
703
+ *
704
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
705
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
492
706
  */
493
707
  interface UnsafePayAllSuiParams {
494
708
  /** the transaction signer's Sui address */
@@ -509,6 +723,9 @@ interface UnsafePayAllSuiParams {
509
723
  * input coin, then use the first input coin as the gas coin object. 3. the balance of the first input
510
724
  * coin after tx is sum(input_coins) - sum(amounts) - actual_gas_cost 4. all other input coins other
511
725
  * than the first one are deleted.
726
+ *
727
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
728
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
512
729
  */
513
730
  interface UnsafePaySuiParams {
514
731
  /** the transaction signer's Sui address */
@@ -523,7 +740,12 @@ interface UnsafePaySuiParams {
523
740
  gasBudget: string;
524
741
  signal?: AbortSignal;
525
742
  }
526
- /** Create an unsigned transaction to publish a Move package. */
743
+ /**
744
+ * Create an unsigned transaction to publish a Move package.
745
+ *
746
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
747
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
748
+ */
527
749
  interface UnsafePublishParams {
528
750
  /** the transaction signer's Sui address */
529
751
  sender: string;
@@ -540,7 +762,12 @@ interface UnsafePublishParams {
540
762
  gasBudget: string;
541
763
  signal?: AbortSignal;
542
764
  }
543
- /** Add stake to a validator's staking pool using multiple coins and amount. */
765
+ /**
766
+ * Add stake to a validator's staking pool using multiple coins and amount.
767
+ *
768
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
769
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
770
+ */
544
771
  interface UnsafeRequestAddStakeParams {
545
772
  /** the transaction signer's Sui address */
546
773
  signer: string;
@@ -559,7 +786,12 @@ interface UnsafeRequestAddStakeParams {
559
786
  gasBudget: string;
560
787
  signal?: AbortSignal;
561
788
  }
562
- /** Withdraw stake from a validator's staking pool. */
789
+ /**
790
+ * Withdraw stake from a validator's staking pool.
791
+ *
792
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
793
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
794
+ */
563
795
  interface UnsafeRequestWithdrawStakeParams {
564
796
  /** the transaction signer's Sui address */
565
797
  signer: string;
@@ -574,7 +806,12 @@ interface UnsafeRequestWithdrawStakeParams {
574
806
  gasBudget: string;
575
807
  signal?: AbortSignal;
576
808
  }
577
- /** Create an unsigned transaction to split a coin object into multiple coins. */
809
+ /**
810
+ * Create an unsigned transaction to split a coin object into multiple coins.
811
+ *
812
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
813
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
814
+ */
578
815
  interface UnsafeSplitCoinParams {
579
816
  /** the transaction signer's Sui address */
580
817
  signer: string;
@@ -591,7 +828,12 @@ interface UnsafeSplitCoinParams {
591
828
  gasBudget: string;
592
829
  signal?: AbortSignal;
593
830
  }
594
- /** Create an unsigned transaction to split a coin object into multiple equal-size coins. */
831
+ /**
832
+ * Create an unsigned transaction to split a coin object into multiple equal-size coins.
833
+ *
834
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
835
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
836
+ */
595
837
  interface UnsafeSplitCoinEqualParams {
596
838
  /** the transaction signer's Sui address */
597
839
  signer: string;
@@ -611,6 +853,9 @@ interface UnsafeSplitCoinEqualParams {
611
853
  /**
612
854
  * Create an unsigned transaction to transfer an object from one address to another. The object's type
613
855
  * must allow public transfers
856
+ *
857
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
858
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
614
859
  */
615
860
  interface UnsafeTransferObjectParams {
616
861
  /** the transaction signer's Sui address */
@@ -631,6 +876,9 @@ interface UnsafeTransferObjectParams {
631
876
  /**
632
877
  * Create an unsigned transaction to send SUI coin object to a Sui address. The SUI object is also used
633
878
  * as the gas object.
879
+ *
880
+ * @deprecated JSON-RPC APIs are deprecated in the Sui TypeScript SDK. Use `SuiGrpcClient` from
881
+ * `@mysten/sui/grpc` or `SuiGraphQLClient` from `@mysten/sui/graphql` instead.
634
882
  */
635
883
  interface UnsafeTransferSuiParams {
636
884
  /** the transaction signer's Sui address */