@dfns/sdk 0.7.12-rc.1 → 0.7.13-rc.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.
@@ -1,14 +1,20 @@
1
1
  export type CreateDepositBody = {
2
2
  kind: "Native";
3
+ /** The amount of native tokens to transfer in minimum denomination. */
3
4
  amount: string;
5
+ /** The priority that determines the fees paid for the transfer. All EVM compatible networks and Bitcoin support `priority`. Not supported for other networks. It uses the [estimate fees](https://docs.dfns.co/api-reference/networks/estimate-fees) API to calculate the transfer fees. When not specified, defaults to `Standard` priority. */
4
6
  priority?: ("Slow" | "Standard" | "Fast") | undefined;
7
+ /** Whether to create the destination account on chains that require account creation (e.g., Stellar, Kadena). Only valid for chains that require the receiver account to exist before transfer. */
5
8
  createDestinationAccount?: boolean | undefined;
6
- /** Optional field for Canton, if true it will create a transfer offer */
9
+ /** Optional field for Canton, if true it will create a transfer offer. */
7
10
  offer?: boolean | undefined;
8
11
  /** Optional field for Canton, especially useful in the context of offers */
9
12
  expiresAt?: string | undefined;
13
+ /** For multi-chain networks (e.g., Kadena), specify the destination chain for cross-chain transfers. */
10
14
  targetChain?: string | undefined;
15
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
11
16
  externalId?: string | undefined;
17
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
12
18
  travelRule?: ({
13
19
  kind: "Notabene";
14
20
  beneficiaryVASPdid?: string | undefined;
@@ -22,16 +28,21 @@ export type CreateDepositBody = {
22
28
  [x: string]: any;
23
29
  };
24
30
  }) | undefined;
25
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
31
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
26
32
  feeSponsorId?: string | undefined;
27
33
  walletId: string;
28
34
  otp?: string | undefined;
29
35
  } | {
30
36
  kind: "Erc20";
37
+ /** The ERC-20 contract address. */
31
38
  contract: string;
39
+ /** The amount of tokens to transfer in minimum denomination. */
32
40
  amount: string;
41
+ /** The priority that determines the fees paid for the transfer. */
33
42
  priority?: ("Slow" | "Standard" | "Fast") | undefined;
43
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
34
44
  externalId?: string | undefined;
45
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
35
46
  travelRule?: ({
36
47
  kind: "Notabene";
37
48
  beneficiaryVASPdid?: string | undefined;
@@ -45,15 +56,19 @@ export type CreateDepositBody = {
45
56
  [x: string]: any;
46
57
  };
47
58
  }) | undefined;
48
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
59
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
49
60
  feeSponsorId?: string | undefined;
50
61
  walletId: string;
51
62
  otp?: string | undefined;
52
63
  } | {
53
64
  kind: "Trc10";
65
+ /** The token ID. */
54
66
  tokenId: string;
67
+ /** The amount of tokens to transfer in minimum denomination. */
55
68
  amount: string;
69
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
56
70
  externalId?: string | undefined;
71
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
57
72
  travelRule?: ({
58
73
  kind: "Notabene";
59
74
  beneficiaryVASPdid?: string | undefined;
@@ -67,15 +82,19 @@ export type CreateDepositBody = {
67
82
  [x: string]: any;
68
83
  };
69
84
  }) | undefined;
70
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
85
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
71
86
  feeSponsorId?: string | undefined;
72
87
  walletId: string;
73
88
  otp?: string | undefined;
74
89
  } | {
75
90
  kind: "Trc20";
91
+ /** The smart contract address. */
76
92
  contract: string;
93
+ /** The amount of tokens to transfer in minimum denomination. */
77
94
  amount: string;
95
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
78
96
  externalId?: string | undefined;
97
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
79
98
  travelRule?: ({
80
99
  kind: "Notabene";
81
100
  beneficiaryVASPdid?: string | undefined;
@@ -89,15 +108,19 @@ export type CreateDepositBody = {
89
108
  [x: string]: any;
90
109
  };
91
110
  }) | undefined;
92
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
111
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
93
112
  feeSponsorId?: string | undefined;
94
113
  walletId: string;
95
114
  otp?: string | undefined;
96
115
  } | {
97
116
  kind: "Asa";
117
+ /** The token asset id. */
98
118
  assetId: string;
119
+ /** The amount of tokens to transfer in minimum denomination. */
99
120
  amount: string;
121
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
100
122
  externalId?: string | undefined;
123
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
101
124
  travelRule?: ({
102
125
  kind: "Notabene";
103
126
  beneficiaryVASPdid?: string | undefined;
@@ -111,16 +134,21 @@ export type CreateDepositBody = {
111
134
  [x: string]: any;
112
135
  };
113
136
  }) | undefined;
114
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
137
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
115
138
  feeSponsorId?: string | undefined;
116
139
  walletId: string;
117
140
  otp?: string | undefined;
118
141
  } | {
119
142
  kind: "Sep41";
143
+ /** The asset issuer address. */
120
144
  issuer: string;
145
+ /** The asset code. */
121
146
  assetCode: string;
147
+ /** The amount of tokens to transfer in minimum denomination. */
122
148
  amount: string;
149
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
123
150
  externalId?: string | undefined;
151
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
124
152
  travelRule?: ({
125
153
  kind: "Notabene";
126
154
  beneficiaryVASPdid?: string | undefined;
@@ -134,16 +162,21 @@ export type CreateDepositBody = {
134
162
  [x: string]: any;
135
163
  };
136
164
  }) | undefined;
137
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
165
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
138
166
  feeSponsorId?: string | undefined;
139
167
  walletId: string;
140
168
  otp?: string | undefined;
141
169
  } | {
142
170
  kind: "Spl" | "Spl2022";
171
+ /** The amount of tokens to transfer in minimum denomination. */
143
172
  amount: string;
173
+ /** The mint account address. */
144
174
  mint: string;
175
+ /** If `true`, pay to create the associated token account for the recipient if it doesn't exist. Defaults to `false`. */
145
176
  createDestinationAccount?: boolean | undefined;
177
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
146
178
  externalId?: string | undefined;
179
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
147
180
  travelRule?: ({
148
181
  kind: "Notabene";
149
182
  beneficiaryVASPdid?: string | undefined;
@@ -157,15 +190,19 @@ export type CreateDepositBody = {
157
190
  [x: string]: any;
158
191
  };
159
192
  }) | undefined;
160
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
193
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
161
194
  feeSponsorId?: string | undefined;
162
195
  walletId: string;
163
196
  otp?: string | undefined;
164
197
  } | {
165
198
  kind: "Tep74";
199
+ /** The Jetton master contract address. */
166
200
  master: string;
201
+ /** The amount of tokens to transfer in minimum denomination. */
167
202
  amount: string;
203
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
168
204
  externalId?: string | undefined;
205
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
169
206
  travelRule?: ({
170
207
  kind: "Notabene";
171
208
  beneficiaryVASPdid?: string | undefined;
@@ -179,13 +216,15 @@ export type CreateDepositBody = {
179
216
  [x: string]: any;
180
217
  };
181
218
  }) | undefined;
182
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
219
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
183
220
  feeSponsorId?: string | undefined;
184
221
  walletId: string;
185
222
  otp?: string | undefined;
186
223
  };
187
224
  export type CreateDepositParams = {
225
+ /** The exchange id obtained from the Create Exchange endpoint. Ex: `ex-1f04s-lqc9q-xxxxxxxxxxxxxxxx` */
188
226
  exchangeId: string;
227
+ /** Unique identifier for the account like "spot" */
189
228
  accountId: string;
190
229
  };
191
230
  export type CreateDepositResponse = {
@@ -202,15 +241,21 @@ export type CreateDepositResponse = {
202
241
  };
203
242
  requestBody: {
204
243
  kind: "Native";
244
+ /** The amount of native tokens to transfer in minimum denomination. */
205
245
  amount: string;
246
+ /** The priority that determines the fees paid for the transfer. All EVM compatible networks and Bitcoin support `priority`. Not supported for other networks. It uses the [estimate fees](https://docs.dfns.co/api-reference/networks/estimate-fees) API to calculate the transfer fees. When not specified, defaults to `Standard` priority. */
206
247
  priority?: ("Slow" | "Standard" | "Fast") | undefined;
248
+ /** Whether to create the destination account on chains that require account creation (e.g., Stellar, Kadena). Only valid for chains that require the receiver account to exist before transfer. */
207
249
  createDestinationAccount?: boolean | undefined;
208
- /** Optional field for Canton, if true it will create a transfer offer */
250
+ /** Optional field for Canton, if true it will create a transfer offer. */
209
251
  offer?: boolean | undefined;
210
252
  /** Optional field for Canton, especially useful in the context of offers */
211
253
  expiresAt?: string | undefined;
254
+ /** For multi-chain networks (e.g., Kadena), specify the destination chain for cross-chain transfers. */
212
255
  targetChain?: string | undefined;
256
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
213
257
  externalId?: string | undefined;
258
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
214
259
  travelRule?: ({
215
260
  kind: "Notabene";
216
261
  beneficiaryVASPdid?: string | undefined;
@@ -224,16 +269,21 @@ export type CreateDepositResponse = {
224
269
  [x: string]: any;
225
270
  };
226
271
  }) | undefined;
227
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
272
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
228
273
  feeSponsorId?: string | undefined;
229
274
  walletId: string;
230
275
  otp?: string | undefined;
231
276
  } | {
232
277
  kind: "Erc20";
278
+ /** The ERC-20 contract address. */
233
279
  contract: string;
280
+ /** The amount of tokens to transfer in minimum denomination. */
234
281
  amount: string;
282
+ /** The priority that determines the fees paid for the transfer. */
235
283
  priority?: ("Slow" | "Standard" | "Fast") | undefined;
284
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
236
285
  externalId?: string | undefined;
286
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
237
287
  travelRule?: ({
238
288
  kind: "Notabene";
239
289
  beneficiaryVASPdid?: string | undefined;
@@ -247,15 +297,19 @@ export type CreateDepositResponse = {
247
297
  [x: string]: any;
248
298
  };
249
299
  }) | undefined;
250
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
300
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
251
301
  feeSponsorId?: string | undefined;
252
302
  walletId: string;
253
303
  otp?: string | undefined;
254
304
  } | {
255
305
  kind: "Trc10";
306
+ /** The token ID. */
256
307
  tokenId: string;
308
+ /** The amount of tokens to transfer in minimum denomination. */
257
309
  amount: string;
310
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
258
311
  externalId?: string | undefined;
312
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
259
313
  travelRule?: ({
260
314
  kind: "Notabene";
261
315
  beneficiaryVASPdid?: string | undefined;
@@ -269,15 +323,19 @@ export type CreateDepositResponse = {
269
323
  [x: string]: any;
270
324
  };
271
325
  }) | undefined;
272
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
326
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
273
327
  feeSponsorId?: string | undefined;
274
328
  walletId: string;
275
329
  otp?: string | undefined;
276
330
  } | {
277
331
  kind: "Trc20";
332
+ /** The smart contract address. */
278
333
  contract: string;
334
+ /** The amount of tokens to transfer in minimum denomination. */
279
335
  amount: string;
336
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
280
337
  externalId?: string | undefined;
338
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
281
339
  travelRule?: ({
282
340
  kind: "Notabene";
283
341
  beneficiaryVASPdid?: string | undefined;
@@ -291,15 +349,19 @@ export type CreateDepositResponse = {
291
349
  [x: string]: any;
292
350
  };
293
351
  }) | undefined;
294
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
352
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
295
353
  feeSponsorId?: string | undefined;
296
354
  walletId: string;
297
355
  otp?: string | undefined;
298
356
  } | {
299
357
  kind: "Asa";
358
+ /** The token asset id. */
300
359
  assetId: string;
360
+ /** The amount of tokens to transfer in minimum denomination. */
301
361
  amount: string;
362
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
302
363
  externalId?: string | undefined;
364
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
303
365
  travelRule?: ({
304
366
  kind: "Notabene";
305
367
  beneficiaryVASPdid?: string | undefined;
@@ -313,16 +375,21 @@ export type CreateDepositResponse = {
313
375
  [x: string]: any;
314
376
  };
315
377
  }) | undefined;
316
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
378
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
317
379
  feeSponsorId?: string | undefined;
318
380
  walletId: string;
319
381
  otp?: string | undefined;
320
382
  } | {
321
383
  kind: "Sep41";
384
+ /** The asset issuer address. */
322
385
  issuer: string;
386
+ /** The asset code. */
323
387
  assetCode: string;
388
+ /** The amount of tokens to transfer in minimum denomination. */
324
389
  amount: string;
390
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
325
391
  externalId?: string | undefined;
392
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
326
393
  travelRule?: ({
327
394
  kind: "Notabene";
328
395
  beneficiaryVASPdid?: string | undefined;
@@ -336,16 +403,21 @@ export type CreateDepositResponse = {
336
403
  [x: string]: any;
337
404
  };
338
405
  }) | undefined;
339
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
406
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
340
407
  feeSponsorId?: string | undefined;
341
408
  walletId: string;
342
409
  otp?: string | undefined;
343
410
  } | {
344
411
  kind: "Spl" | "Spl2022";
412
+ /** The amount of tokens to transfer in minimum denomination. */
345
413
  amount: string;
414
+ /** The mint account address. */
346
415
  mint: string;
416
+ /** If `true`, pay to create the associated token account for the recipient if it doesn't exist. Defaults to `false`. */
347
417
  createDestinationAccount?: boolean | undefined;
418
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
348
419
  externalId?: string | undefined;
420
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
349
421
  travelRule?: ({
350
422
  kind: "Notabene";
351
423
  beneficiaryVASPdid?: string | undefined;
@@ -359,15 +431,19 @@ export type CreateDepositResponse = {
359
431
  [x: string]: any;
360
432
  };
361
433
  }) | undefined;
362
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
434
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
363
435
  feeSponsorId?: string | undefined;
364
436
  walletId: string;
365
437
  otp?: string | undefined;
366
438
  } | {
367
439
  kind: "Tep74";
440
+ /** The Jetton master contract address. */
368
441
  master: string;
442
+ /** The amount of tokens to transfer in minimum denomination. */
369
443
  amount: string;
444
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
370
445
  externalId?: string | undefined;
446
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
371
447
  travelRule?: ({
372
448
  kind: "Notabene";
373
449
  beneficiaryVASPdid?: string | undefined;
@@ -381,7 +457,7 @@ export type CreateDepositResponse = {
381
457
  [x: string]: any;
382
458
  };
383
459
  }) | undefined;
384
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
460
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
385
461
  feeSponsorId?: string | undefined;
386
462
  walletId: string;
387
463
  otp?: string | undefined;
@@ -418,15 +494,21 @@ export type CreateExchangeRequest = {
418
494
  };
419
495
  export type CreateWithdrawalBody = {
420
496
  kind: "Native";
497
+ /** The amount of native tokens to transfer in minimum denomination. */
421
498
  amount: string;
499
+ /** The priority that determines the fees paid for the transfer. All EVM compatible networks and Bitcoin support `priority`. Not supported for other networks. It uses the [estimate fees](https://docs.dfns.co/api-reference/networks/estimate-fees) API to calculate the transfer fees. When not specified, defaults to `Standard` priority. */
422
500
  priority?: ("Slow" | "Standard" | "Fast") | undefined;
501
+ /** Whether to create the destination account on chains that require account creation (e.g., Stellar, Kadena). Only valid for chains that require the receiver account to exist before transfer. */
423
502
  createDestinationAccount?: boolean | undefined;
424
- /** Optional field for Canton, if true it will create a transfer offer */
503
+ /** Optional field for Canton, if true it will create a transfer offer. */
425
504
  offer?: boolean | undefined;
426
505
  /** Optional field for Canton, especially useful in the context of offers */
427
506
  expiresAt?: string | undefined;
507
+ /** For multi-chain networks (e.g., Kadena), specify the destination chain for cross-chain transfers. */
428
508
  targetChain?: string | undefined;
509
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
429
510
  externalId?: string | undefined;
511
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
430
512
  travelRule?: ({
431
513
  kind: "Notabene";
432
514
  beneficiaryVASPdid?: string | undefined;
@@ -440,16 +522,21 @@ export type CreateWithdrawalBody = {
440
522
  [x: string]: any;
441
523
  };
442
524
  }) | undefined;
443
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
525
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
444
526
  feeSponsorId?: string | undefined;
445
527
  walletId: string;
446
528
  otp?: string | undefined;
447
529
  } | {
448
530
  kind: "Erc20";
531
+ /** The ERC-20 contract address. */
449
532
  contract: string;
533
+ /** The amount of tokens to transfer in minimum denomination. */
450
534
  amount: string;
535
+ /** The priority that determines the fees paid for the transfer. */
451
536
  priority?: ("Slow" | "Standard" | "Fast") | undefined;
537
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
452
538
  externalId?: string | undefined;
539
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
453
540
  travelRule?: ({
454
541
  kind: "Notabene";
455
542
  beneficiaryVASPdid?: string | undefined;
@@ -463,15 +550,19 @@ export type CreateWithdrawalBody = {
463
550
  [x: string]: any;
464
551
  };
465
552
  }) | undefined;
466
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
553
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
467
554
  feeSponsorId?: string | undefined;
468
555
  walletId: string;
469
556
  otp?: string | undefined;
470
557
  } | {
471
558
  kind: "Trc10";
559
+ /** The token ID. */
472
560
  tokenId: string;
561
+ /** The amount of tokens to transfer in minimum denomination. */
473
562
  amount: string;
563
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
474
564
  externalId?: string | undefined;
565
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
475
566
  travelRule?: ({
476
567
  kind: "Notabene";
477
568
  beneficiaryVASPdid?: string | undefined;
@@ -485,15 +576,19 @@ export type CreateWithdrawalBody = {
485
576
  [x: string]: any;
486
577
  };
487
578
  }) | undefined;
488
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
579
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
489
580
  feeSponsorId?: string | undefined;
490
581
  walletId: string;
491
582
  otp?: string | undefined;
492
583
  } | {
493
584
  kind: "Trc20";
585
+ /** The smart contract address. */
494
586
  contract: string;
587
+ /** The amount of tokens to transfer in minimum denomination. */
495
588
  amount: string;
589
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
496
590
  externalId?: string | undefined;
591
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
497
592
  travelRule?: ({
498
593
  kind: "Notabene";
499
594
  beneficiaryVASPdid?: string | undefined;
@@ -507,15 +602,19 @@ export type CreateWithdrawalBody = {
507
602
  [x: string]: any;
508
603
  };
509
604
  }) | undefined;
510
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
605
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
511
606
  feeSponsorId?: string | undefined;
512
607
  walletId: string;
513
608
  otp?: string | undefined;
514
609
  } | {
515
610
  kind: "Asa";
611
+ /** The token asset id. */
516
612
  assetId: string;
613
+ /** The amount of tokens to transfer in minimum denomination. */
517
614
  amount: string;
615
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
518
616
  externalId?: string | undefined;
617
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
519
618
  travelRule?: ({
520
619
  kind: "Notabene";
521
620
  beneficiaryVASPdid?: string | undefined;
@@ -529,16 +628,21 @@ export type CreateWithdrawalBody = {
529
628
  [x: string]: any;
530
629
  };
531
630
  }) | undefined;
532
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
631
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
533
632
  feeSponsorId?: string | undefined;
534
633
  walletId: string;
535
634
  otp?: string | undefined;
536
635
  } | {
537
636
  kind: "Sep41";
637
+ /** The asset issuer address. */
538
638
  issuer: string;
639
+ /** The asset code. */
539
640
  assetCode: string;
641
+ /** The amount of tokens to transfer in minimum denomination. */
540
642
  amount: string;
643
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
541
644
  externalId?: string | undefined;
645
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
542
646
  travelRule?: ({
543
647
  kind: "Notabene";
544
648
  beneficiaryVASPdid?: string | undefined;
@@ -552,16 +656,21 @@ export type CreateWithdrawalBody = {
552
656
  [x: string]: any;
553
657
  };
554
658
  }) | undefined;
555
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
659
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
556
660
  feeSponsorId?: string | undefined;
557
661
  walletId: string;
558
662
  otp?: string | undefined;
559
663
  } | {
560
664
  kind: "Spl" | "Spl2022";
665
+ /** The amount of tokens to transfer in minimum denomination. */
561
666
  amount: string;
667
+ /** The mint account address. */
562
668
  mint: string;
669
+ /** If `true`, pay to create the associated token account for the recipient if it doesn't exist. Defaults to `false`. */
563
670
  createDestinationAccount?: boolean | undefined;
671
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
564
672
  externalId?: string | undefined;
673
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
565
674
  travelRule?: ({
566
675
  kind: "Notabene";
567
676
  beneficiaryVASPdid?: string | undefined;
@@ -575,15 +684,19 @@ export type CreateWithdrawalBody = {
575
684
  [x: string]: any;
576
685
  };
577
686
  }) | undefined;
578
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
687
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
579
688
  feeSponsorId?: string | undefined;
580
689
  walletId: string;
581
690
  otp?: string | undefined;
582
691
  } | {
583
692
  kind: "Tep74";
693
+ /** The Jetton master contract address. */
584
694
  master: string;
695
+ /** The amount of tokens to transfer in minimum denomination. */
585
696
  amount: string;
697
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
586
698
  externalId?: string | undefined;
699
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
587
700
  travelRule?: ({
588
701
  kind: "Notabene";
589
702
  beneficiaryVASPdid?: string | undefined;
@@ -597,13 +710,15 @@ export type CreateWithdrawalBody = {
597
710
  [x: string]: any;
598
711
  };
599
712
  }) | undefined;
600
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
713
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
601
714
  feeSponsorId?: string | undefined;
602
715
  walletId: string;
603
716
  otp?: string | undefined;
604
717
  };
605
718
  export type CreateWithdrawalParams = {
719
+ /** The exchange id obtained from the Create Exchange endpoint. Ex: `ex-1f04s-lqc9q-xxxxxxxxxxxxxxxx` */
606
720
  exchangeId: string;
721
+ /** Unique identifier for the account like "spot" */
607
722
  accountId: string;
608
723
  };
609
724
  export type CreateWithdrawalResponse = {
@@ -620,15 +735,21 @@ export type CreateWithdrawalResponse = {
620
735
  };
621
736
  requestBody: {
622
737
  kind: "Native";
738
+ /** The amount of native tokens to transfer in minimum denomination. */
623
739
  amount: string;
740
+ /** The priority that determines the fees paid for the transfer. All EVM compatible networks and Bitcoin support `priority`. Not supported for other networks. It uses the [estimate fees](https://docs.dfns.co/api-reference/networks/estimate-fees) API to calculate the transfer fees. When not specified, defaults to `Standard` priority. */
624
741
  priority?: ("Slow" | "Standard" | "Fast") | undefined;
742
+ /** Whether to create the destination account on chains that require account creation (e.g., Stellar, Kadena). Only valid for chains that require the receiver account to exist before transfer. */
625
743
  createDestinationAccount?: boolean | undefined;
626
- /** Optional field for Canton, if true it will create a transfer offer */
744
+ /** Optional field for Canton, if true it will create a transfer offer. */
627
745
  offer?: boolean | undefined;
628
746
  /** Optional field for Canton, especially useful in the context of offers */
629
747
  expiresAt?: string | undefined;
748
+ /** For multi-chain networks (e.g., Kadena), specify the destination chain for cross-chain transfers. */
630
749
  targetChain?: string | undefined;
750
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
631
751
  externalId?: string | undefined;
752
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
632
753
  travelRule?: ({
633
754
  kind: "Notabene";
634
755
  beneficiaryVASPdid?: string | undefined;
@@ -642,16 +763,21 @@ export type CreateWithdrawalResponse = {
642
763
  [x: string]: any;
643
764
  };
644
765
  }) | undefined;
645
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
766
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
646
767
  feeSponsorId?: string | undefined;
647
768
  walletId: string;
648
769
  otp?: string | undefined;
649
770
  } | {
650
771
  kind: "Erc20";
772
+ /** The ERC-20 contract address. */
651
773
  contract: string;
774
+ /** The amount of tokens to transfer in minimum denomination. */
652
775
  amount: string;
776
+ /** The priority that determines the fees paid for the transfer. */
653
777
  priority?: ("Slow" | "Standard" | "Fast") | undefined;
778
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
654
779
  externalId?: string | undefined;
780
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
655
781
  travelRule?: ({
656
782
  kind: "Notabene";
657
783
  beneficiaryVASPdid?: string | undefined;
@@ -665,15 +791,19 @@ export type CreateWithdrawalResponse = {
665
791
  [x: string]: any;
666
792
  };
667
793
  }) | undefined;
668
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
794
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
669
795
  feeSponsorId?: string | undefined;
670
796
  walletId: string;
671
797
  otp?: string | undefined;
672
798
  } | {
673
799
  kind: "Trc10";
800
+ /** The token ID. */
674
801
  tokenId: string;
802
+ /** The amount of tokens to transfer in minimum denomination. */
675
803
  amount: string;
804
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
676
805
  externalId?: string | undefined;
806
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
677
807
  travelRule?: ({
678
808
  kind: "Notabene";
679
809
  beneficiaryVASPdid?: string | undefined;
@@ -687,15 +817,19 @@ export type CreateWithdrawalResponse = {
687
817
  [x: string]: any;
688
818
  };
689
819
  }) | undefined;
690
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
820
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
691
821
  feeSponsorId?: string | undefined;
692
822
  walletId: string;
693
823
  otp?: string | undefined;
694
824
  } | {
695
825
  kind: "Trc20";
826
+ /** The smart contract address. */
696
827
  contract: string;
828
+ /** The amount of tokens to transfer in minimum denomination. */
697
829
  amount: string;
830
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
698
831
  externalId?: string | undefined;
832
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
699
833
  travelRule?: ({
700
834
  kind: "Notabene";
701
835
  beneficiaryVASPdid?: string | undefined;
@@ -709,15 +843,19 @@ export type CreateWithdrawalResponse = {
709
843
  [x: string]: any;
710
844
  };
711
845
  }) | undefined;
712
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
846
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
713
847
  feeSponsorId?: string | undefined;
714
848
  walletId: string;
715
849
  otp?: string | undefined;
716
850
  } | {
717
851
  kind: "Asa";
852
+ /** The token asset id. */
718
853
  assetId: string;
854
+ /** The amount of tokens to transfer in minimum denomination. */
719
855
  amount: string;
856
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
720
857
  externalId?: string | undefined;
858
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
721
859
  travelRule?: ({
722
860
  kind: "Notabene";
723
861
  beneficiaryVASPdid?: string | undefined;
@@ -731,16 +869,21 @@ export type CreateWithdrawalResponse = {
731
869
  [x: string]: any;
732
870
  };
733
871
  }) | undefined;
734
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
872
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
735
873
  feeSponsorId?: string | undefined;
736
874
  walletId: string;
737
875
  otp?: string | undefined;
738
876
  } | {
739
877
  kind: "Sep41";
878
+ /** The asset issuer address. */
740
879
  issuer: string;
880
+ /** The asset code. */
741
881
  assetCode: string;
882
+ /** The amount of tokens to transfer in minimum denomination. */
742
883
  amount: string;
884
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
743
885
  externalId?: string | undefined;
886
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
744
887
  travelRule?: ({
745
888
  kind: "Notabene";
746
889
  beneficiaryVASPdid?: string | undefined;
@@ -754,16 +897,21 @@ export type CreateWithdrawalResponse = {
754
897
  [x: string]: any;
755
898
  };
756
899
  }) | undefined;
757
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
900
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
758
901
  feeSponsorId?: string | undefined;
759
902
  walletId: string;
760
903
  otp?: string | undefined;
761
904
  } | {
762
905
  kind: "Spl" | "Spl2022";
906
+ /** The amount of tokens to transfer in minimum denomination. */
763
907
  amount: string;
908
+ /** The mint account address. */
764
909
  mint: string;
910
+ /** If `true`, pay to create the associated token account for the recipient if it doesn't exist. Defaults to `false`. */
765
911
  createDestinationAccount?: boolean | undefined;
912
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
766
913
  externalId?: string | undefined;
914
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
767
915
  travelRule?: ({
768
916
  kind: "Notabene";
769
917
  beneficiaryVASPdid?: string | undefined;
@@ -777,15 +925,19 @@ export type CreateWithdrawalResponse = {
777
925
  [x: string]: any;
778
926
  };
779
927
  }) | undefined;
780
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
928
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
781
929
  feeSponsorId?: string | undefined;
782
930
  walletId: string;
783
931
  otp?: string | undefined;
784
932
  } | {
785
933
  kind: "Tep74";
934
+ /** The Jetton master contract address. */
786
935
  master: string;
936
+ /** The amount of tokens to transfer in minimum denomination. */
787
937
  amount: string;
938
+ /** A unique ID from your system. It can be leveraged to be used as an idempotency key. (read more [here](https://docs.dfns.co/api-reference/idempotency)) */
788
939
  externalId?: string | undefined;
940
+ /** A travel rule payload to associate with the transfer. (read more [here](https://docs.dfns.co/features/travel-rule)) */
789
941
  travelRule?: ({
790
942
  kind: "Notabene";
791
943
  beneficiaryVASPdid?: string | undefined;
@@ -799,7 +951,7 @@ export type CreateWithdrawalResponse = {
799
951
  [x: string]: any;
800
952
  };
801
953
  }) | undefined;
802
- /** Id of the fee sponsor that will be used to pay for your transfer fee, it might not be available for all blockchains */
954
+ /** Id of the fee sponsor that will be used to pay for your transfer fees, it might not be available for all blockchains. (read more [here](https://docs.dfns.co/features/fee-sponsors)) */
803
955
  feeSponsorId?: string | undefined;
804
956
  walletId: string;
805
957
  otp?: string | undefined;