@privy-io/api-types 0.15.0 → 0.17.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 (158) hide show
  1. package/CHANGELOG.md +141 -0
  2. package/client.d.mts +30 -33
  3. package/client.d.mts.map +1 -1
  4. package/client.d.ts +30 -33
  5. package/client.d.ts.map +1 -1
  6. package/client.js +9 -4
  7. package/client.js.map +1 -1
  8. package/client.mjs +9 -4
  9. package/client.mjs.map +1 -1
  10. package/package.json +1 -1
  11. package/resources/accounts.d.mts +6 -2
  12. package/resources/accounts.d.mts.map +1 -1
  13. package/resources/accounts.d.ts +6 -2
  14. package/resources/accounts.d.ts.map +1 -1
  15. package/resources/aggregations.d.mts +14 -4
  16. package/resources/aggregations.d.mts.map +1 -1
  17. package/resources/aggregations.d.ts +14 -4
  18. package/resources/aggregations.d.ts.map +1 -1
  19. package/resources/apps.d.mts +44 -23
  20. package/resources/apps.d.mts.map +1 -1
  21. package/resources/apps.d.ts +44 -23
  22. package/resources/apps.d.ts.map +1 -1
  23. package/resources/client-auth.d.mts +32 -8
  24. package/resources/client-auth.d.mts.map +1 -1
  25. package/resources/client-auth.d.ts +32 -8
  26. package/resources/client-auth.d.ts.map +1 -1
  27. package/resources/embedded-wallets.d.mts +6 -0
  28. package/resources/embedded-wallets.d.mts.map +1 -1
  29. package/resources/embedded-wallets.d.ts +6 -0
  30. package/resources/embedded-wallets.d.ts.map +1 -1
  31. package/resources/index.d.mts +15 -16
  32. package/resources/index.d.mts.map +1 -1
  33. package/resources/index.d.ts +15 -16
  34. package/resources/index.d.ts.map +1 -1
  35. package/resources/index.js +1 -3
  36. package/resources/index.js.map +1 -1
  37. package/resources/index.mjs +0 -1
  38. package/resources/index.mjs.map +1 -1
  39. package/resources/intents.d.mts +65 -79
  40. package/resources/intents.d.mts.map +1 -1
  41. package/resources/intents.d.ts +65 -79
  42. package/resources/intents.d.ts.map +1 -1
  43. package/resources/intents.js.map +1 -1
  44. package/resources/intents.mjs.map +1 -1
  45. package/resources/key-quorums.d.mts +9 -8
  46. package/resources/key-quorums.d.mts.map +1 -1
  47. package/resources/key-quorums.d.ts +9 -8
  48. package/resources/key-quorums.d.ts.map +1 -1
  49. package/resources/kraken-embed.d.mts +208 -218
  50. package/resources/kraken-embed.d.mts.map +1 -1
  51. package/resources/kraken-embed.d.ts +208 -218
  52. package/resources/kraken-embed.d.ts.map +1 -1
  53. package/resources/kraken-embed.js.map +1 -1
  54. package/resources/kraken-embed.mjs.map +1 -1
  55. package/resources/onramps.d.mts +50 -48
  56. package/resources/onramps.d.mts.map +1 -1
  57. package/resources/onramps.d.ts +50 -48
  58. package/resources/onramps.d.ts.map +1 -1
  59. package/resources/policies.d.mts +93 -24
  60. package/resources/policies.d.mts.map +1 -1
  61. package/resources/policies.d.ts +93 -24
  62. package/resources/policies.d.ts.map +1 -1
  63. package/resources/shared.d.mts +15 -3
  64. package/resources/shared.d.mts.map +1 -1
  65. package/resources/shared.d.ts +15 -3
  66. package/resources/shared.d.ts.map +1 -1
  67. package/resources/swaps.d.mts +3 -2
  68. package/resources/swaps.d.mts.map +1 -1
  69. package/resources/swaps.d.ts +3 -2
  70. package/resources/swaps.d.ts.map +1 -1
  71. package/resources/transactions.d.mts +9 -2
  72. package/resources/transactions.d.mts.map +1 -1
  73. package/resources/transactions.d.ts +9 -2
  74. package/resources/transactions.d.ts.map +1 -1
  75. package/resources/users.d.mts +33 -7
  76. package/resources/users.d.mts.map +1 -1
  77. package/resources/users.d.ts +33 -7
  78. package/resources/users.d.ts.map +1 -1
  79. package/resources/{wallet-actions.d.ts → wallets/actions.d.mts} +383 -68
  80. package/resources/wallets/actions.d.mts.map +1 -0
  81. package/resources/{wallet-actions.d.mts → wallets/actions.d.ts} +383 -68
  82. package/resources/wallets/actions.d.ts.map +1 -0
  83. package/resources/wallets/actions.js +9 -0
  84. package/resources/wallets/actions.js.map +1 -0
  85. package/resources/wallets/actions.mjs +5 -0
  86. package/resources/wallets/actions.mjs.map +1 -0
  87. package/resources/wallets/balance.d.mts +11 -4
  88. package/resources/wallets/balance.d.mts.map +1 -1
  89. package/resources/wallets/balance.d.ts +11 -4
  90. package/resources/wallets/balance.d.ts.map +1 -1
  91. package/resources/wallets/index.d.mts +2 -1
  92. package/resources/wallets/index.d.mts.map +1 -1
  93. package/resources/wallets/index.d.ts +2 -1
  94. package/resources/wallets/index.d.ts.map +1 -1
  95. package/resources/wallets/index.js +3 -1
  96. package/resources/wallets/index.js.map +1 -1
  97. package/resources/wallets/index.mjs +1 -0
  98. package/resources/wallets/index.mjs.map +1 -1
  99. package/resources/wallets/transactions.d.mts +14 -3
  100. package/resources/wallets/transactions.d.mts.map +1 -1
  101. package/resources/wallets/transactions.d.ts +14 -3
  102. package/resources/wallets/transactions.d.ts.map +1 -1
  103. package/resources/wallets/transactions.js.map +1 -1
  104. package/resources/wallets/transactions.mjs.map +1 -1
  105. package/resources/wallets/wallets.d.mts +846 -97
  106. package/resources/wallets/wallets.d.mts.map +1 -1
  107. package/resources/wallets/wallets.d.ts +846 -97
  108. package/resources/wallets/wallets.d.ts.map +1 -1
  109. package/resources/wallets/wallets.js +19 -2
  110. package/resources/wallets/wallets.js.map +1 -1
  111. package/resources/wallets/wallets.mjs +19 -2
  112. package/resources/wallets/wallets.mjs.map +1 -1
  113. package/resources/webhooks.d.mts +596 -108
  114. package/resources/webhooks.d.mts.map +1 -1
  115. package/resources/webhooks.d.ts +596 -108
  116. package/resources/webhooks.d.ts.map +1 -1
  117. package/resources/webhooks.js.map +1 -1
  118. package/resources/webhooks.mjs.map +1 -1
  119. package/resources/yield.d.mts +30 -30
  120. package/resources/yield.d.mts.map +1 -1
  121. package/resources/yield.d.ts +30 -30
  122. package/resources/yield.d.ts.map +1 -1
  123. package/resources/yield.js.map +1 -1
  124. package/resources/yield.mjs.map +1 -1
  125. package/src/client.ts +223 -76
  126. package/src/resources/accounts.ts +7 -1
  127. package/src/resources/aggregations.ts +16 -3
  128. package/src/resources/apps.ts +60 -30
  129. package/src/resources/client-auth.ts +41 -7
  130. package/src/resources/embedded-wallets.ts +7 -0
  131. package/src/resources/index.ts +107 -36
  132. package/src/resources/intents.ts +73 -91
  133. package/src/resources/key-quorums.ts +11 -9
  134. package/src/resources/kraken-embed.ts +560 -1065
  135. package/src/resources/onramps.ts +69 -54
  136. package/src/resources/policies.ts +162 -52
  137. package/src/resources/shared.ts +18 -2
  138. package/src/resources/swaps.ts +3 -2
  139. package/src/resources/transactions.ts +18 -9
  140. package/src/resources/users.ts +38 -6
  141. package/src/resources/{wallet-actions.ts → wallets/actions.ts} +496 -78
  142. package/src/resources/wallets/balance.ts +26 -56
  143. package/src/resources/wallets/index.ts +93 -0
  144. package/src/resources/wallets/transactions.ts +17 -10
  145. package/src/resources/wallets/wallets.ts +1312 -177
  146. package/src/resources/webhooks.ts +729 -118
  147. package/src/resources/yield.ts +33 -41
  148. package/src/version.ts +1 -1
  149. package/version.d.mts +1 -1
  150. package/version.d.ts +1 -1
  151. package/version.js +1 -1
  152. package/version.mjs +1 -1
  153. package/resources/wallet-actions.d.mts.map +0 -1
  154. package/resources/wallet-actions.d.ts.map +0 -1
  155. package/resources/wallet-actions.js +0 -9
  156. package/resources/wallet-actions.js.map +0 -1
  157. package/resources/wallet-actions.mjs +0 -5
  158. package/resources/wallet-actions.mjs.map +0 -1
@@ -4,6 +4,53 @@ import { APIResource } from '../../core/resource';
4
4
  import * as WalletsAPI from './wallets';
5
5
  import * as AppsAPI from '../apps';
6
6
  import * as SharedAPI from '../shared';
7
+ import * as ActionsAPI from './actions';
8
+ import {
9
+ AaveVaultDetails,
10
+ Actions,
11
+ CustodianTransactionWalletActionStep,
12
+ CustodianTransactionWalletActionStepStatus,
13
+ EarnAsset,
14
+ EarnDepositActionResponse,
15
+ EarnDepositRequestBody,
16
+ EarnFeeCollectActionResponse,
17
+ EarnFeeCollectRequestBody,
18
+ EarnIncentiveClaimActionResponse,
19
+ EarnIncentiveClaimRequestBody,
20
+ EarnIncentiveRewardEntry,
21
+ EarnIncentiveRewardsQuery,
22
+ EarnIncentiveRewardsResponse,
23
+ EarnIncetiveClaimRewardEntry,
24
+ EarnWithdrawActionResponse,
25
+ EarnWithdrawRequestBody,
26
+ EthereumEarnPositionQuery,
27
+ EthereumEarnPositionResponse,
28
+ EthereumEarnProvider,
29
+ EthereumEarnVaultDetailsResponse,
30
+ EvmTransactionWalletActionStep,
31
+ EvmUserOperationEntrypointVersion,
32
+ EvmUserOperationWalletActionStep,
33
+ EvmWalletActionStepStatus,
34
+ ExternalTransactionWalletActionStep,
35
+ ExternalTransactionWalletActionStepStatus,
36
+ FailureReason,
37
+ ListWalletActionsQuery,
38
+ ListWalletActionsResponse,
39
+ MorphoVaultDetails,
40
+ SvmTransactionWalletActionStep,
41
+ SvmWalletActionStepStatus,
42
+ SwapActionResponse,
43
+ TransferActionResponse,
44
+ TvmTransactionWalletActionStep,
45
+ TvmWalletActionStepStatus,
46
+ VedaVaultDetails,
47
+ WalletActionInclude,
48
+ WalletActionResponse,
49
+ WalletActionStatus,
50
+ WalletActionStep,
51
+ WalletActionStepType,
52
+ WalletActionType,
53
+ } from './actions';
7
54
  import * as BalanceAPI from './balance';
8
55
  import { Balance, BalanceGetParams, BalanceGetResponse } from './balance';
9
56
  import * as TransactionsAPI from './transactions';
@@ -20,6 +67,7 @@ import { path } from '../../internal/utils/path';
20
67
  export class Wallets extends APIResource {
21
68
  balance: BalanceAPI.Balance = new BalanceAPI.Balance(this._client);
22
69
  transactions: TransactionsAPI.Transactions = new TransactionsAPI.Transactions(this._client);
70
+ actions: ActionsAPI.Actions = new ActionsAPI.Actions(this._client);
23
71
 
24
72
  /**
25
73
  * Creates a new wallet on the requested chain and for the requested owner.
@@ -92,6 +140,20 @@ export class Wallets extends APIResource {
92
140
  return this._client.getAPIList('/v1/wallets', Cursor<Wallet>, { query, ...options });
93
141
  }
94
142
 
143
+ /**
144
+ * Archives a wallet, preventing it from being used in any write or signing
145
+ * operations. Archived wallets are hidden from list endpoints by default. Returns
146
+ * 404 if the wallet does not exist or is already archived.
147
+ *
148
+ * @example
149
+ * ```ts
150
+ * const wallet = await client.wallets.archive('wallet_id');
151
+ * ```
152
+ */
153
+ archive(walletID: string, options?: RequestOptions): APIPromise<Wallet> {
154
+ return this._client.post(path`/v1/wallets/${walletID}/archive`, options);
155
+ }
156
+
95
157
  /**
96
158
  * Export a wallet's private key
97
159
  *
@@ -138,8 +200,12 @@ export class Wallets extends APIResource {
138
200
  * const wallet = await client.wallets.get('wallet_id');
139
201
  * ```
140
202
  */
141
- get(walletID: string, options?: RequestOptions): APIPromise<Wallet> {
142
- return this._client.get(path`/v1/wallets/${walletID}`, options);
203
+ get(
204
+ walletID: string,
205
+ query: WalletGetParams | null | undefined = {},
206
+ options?: RequestOptions,
207
+ ): APIPromise<Wallet> {
208
+ return this._client.get(path`/v1/wallets/${walletID}`, { query, ...options });
143
209
  }
144
210
 
145
211
  /**
@@ -233,6 +299,15 @@ export class Wallets extends APIResource {
233
299
 
234
300
  export type WalletsCursor = Cursor<Wallet>;
235
301
 
302
+ /**
303
+ * An entry in an EIP-2930 access list, specifying an address and its storage keys.
304
+ */
305
+ export interface AccessListEntry {
306
+ address: string;
307
+
308
+ storage_keys: Array<Hex>;
309
+ }
310
+
236
311
  /**
237
312
  * Additional signers for the wallet.
238
313
  */
@@ -254,10 +329,145 @@ export interface AdditionalSignerItemInput {
254
329
  }
255
330
 
256
331
  /**
257
- * A blockchain wallet address (Ethereum or Solana).
332
+ * A blockchain wallet address. Ethereum addresses are normalized to EIP-55
333
+ * checksum format. Solana addresses are validated as base58. All other chain
334
+ * addresses (Stellar, Tron, Sui, Aptos, etc.) are accepted as-is.
258
335
  */
259
336
  export type Address = string;
260
337
 
338
+ /**
339
+ * Platform fee collected on a swap.
340
+ */
341
+ export interface AdvancedSwapPlatformFee {
342
+ /**
343
+ * Token the fee was taken from (output token in v1).
344
+ */
345
+ token: string;
346
+
347
+ /**
348
+ * Fee amount in the smallest unit of the fee token.
349
+ */
350
+ amount: string;
351
+
352
+ /**
353
+ * Fee in basis points.
354
+ */
355
+ bps: number;
356
+ }
357
+
358
+ /**
359
+ * Request body for initiating a synchronous Solana token swap through an embedded
360
+ * wallet.
361
+ */
362
+ export interface AdvancedSwapRequestBody {
363
+ /**
364
+ * Amount in the smallest unit of the input token (e.g. lamports for SOL).
365
+ */
366
+ amount: string;
367
+
368
+ /**
369
+ * Input token address (base58 mint address).
370
+ */
371
+ input_token: string;
372
+
373
+ /**
374
+ * Output token address (base58 mint address).
375
+ */
376
+ output_token: string;
377
+
378
+ /**
379
+ * CAIP-2 chain identifier. Defaults to Solana mainnet.
380
+ */
381
+ caip2?: string;
382
+
383
+ /**
384
+ * When true, skip transaction submission (quote + sign only). The signed
385
+ * transaction is still returned.
386
+ */
387
+ dry_run?: boolean;
388
+
389
+ /**
390
+ * Token account (base58) to receive the platform fee. Must exist on-chain for the
391
+ * output token.
392
+ */
393
+ fee_recipient?: string;
394
+
395
+ /**
396
+ * Platform fee in basis points, taken from the output token. Requires
397
+ * fee_recipient when > 0.
398
+ */
399
+ platform_fee_bps?: number;
400
+
401
+ /**
402
+ * Max slippage tolerance in basis points (0-10000), or "auto" for
403
+ * provider-determined. Defaults to "auto".
404
+ */
405
+ slippage_bps?: number | 'auto';
406
+ }
407
+
408
+ /**
409
+ * Response from the synchronous Solana swap endpoint.
410
+ */
411
+ export interface AdvancedSwapResponse {
412
+ /**
413
+ * Input amount consumed (smallest unit).
414
+ */
415
+ in_amount: string;
416
+
417
+ /**
418
+ * Input token address (base58).
419
+ */
420
+ input_token: string;
421
+
422
+ /**
423
+ * Minimum output amount guaranteed by slippage tolerance (smallest unit).
424
+ */
425
+ min_out_amount: string;
426
+
427
+ /**
428
+ * Expected output amount before slippage (smallest unit).
429
+ */
430
+ out_amount: string;
431
+
432
+ /**
433
+ * Output token address (base58).
434
+ */
435
+ output_token: string;
436
+
437
+ /**
438
+ * Which aggregator fulfilled the swap (e.g. "dflow").
439
+ */
440
+ provider: string;
441
+
442
+ /**
443
+ * Fully signed transaction (base64). Callers can re-submit to any Solana RPC for
444
+ * redundancy.
445
+ */
446
+ signed_transaction: string;
447
+
448
+ /**
449
+ * Slippage applied in basis points. Reflects the resolved value if "auto" was
450
+ * requested.
451
+ */
452
+ slippage_bps: number;
453
+
454
+ /**
455
+ * "accepted" if the network has acknowledged the transaction, "rejected" if the
456
+ * network refused it, "skipped" if dry_run was set. Not an onchain confirmation.
457
+ */
458
+ submission_status: SwapSubmissionStatus;
459
+
460
+ /**
461
+ * Solana transaction signature (base58).
462
+ */
463
+ transaction_hash: string;
464
+
465
+ /**
466
+ * Platform fee collected on a swap.
467
+ */
468
+ platform_fee?: AdvancedSwapPlatformFee;
469
+ }
470
+
261
471
  /**
262
472
  * Whether the amount refers to the input token or output token.
263
473
  */
@@ -342,7 +552,10 @@ export interface CustodialWallet {
342
552
  */
343
553
  custody: WalletCustodian;
344
554
 
345
- owner_id: string | null;
555
+ /**
556
+ * A unique identifier for a key quorum.
557
+ */
558
+ owner_id: SharedAPI.KeyQuorumID | null;
346
559
 
347
560
  /**
348
561
  * Additional signers for the wallet.
@@ -404,13 +617,6 @@ export type CustodialWalletProvider = 'bridge';
404
617
  * address (Solana). Use this variant for tokens that are not first-class assets.
405
618
  */
406
619
  export interface CustomTokenTransferSource {
407
- /**
408
- * Amount as a decimal string in the token's standard unit (e.g. "1.5" for 1.5
409
- * USDC, "0.01" for 0.01 ETH). Not in the smallest on-chain unit (wei, lamports,
410
- * etc.). Maximum 100 characters.
411
- */
412
- amount: string;
413
-
414
620
  /**
415
621
  * The token contract address (EVM) or mint address (Solana) of the asset to
416
622
  * transfer.
@@ -423,6 +629,14 @@ export interface CustomTokenTransferSource {
423
629
  * respective testnets.
424
630
  */
425
631
  chain: string;
632
+
633
+ /**
634
+ * @deprecated Amount as a decimal string in the token's standard unit (e.g. "1.5"
635
+ * for 1.5 USDC, "0.01" for 0.01 ETH). For exact_input, specifies the amount to
636
+ * send. Not in the smallest on-chain unit (wei, lamports, etc.). Maximum 100
637
+ * characters. Deprecated: use the top-level `amount` field instead.
638
+ */
639
+ amount?: string;
426
640
  }
427
641
 
428
642
  /**
@@ -439,6 +653,62 @@ export interface DeveloperFee {
439
653
  recipient?: string;
440
654
  }
441
655
 
656
+ /**
657
+ * HPKE-encrypted authorization key with encapsulated key and ciphertext.
658
+ */
659
+ export interface EncryptedAuthorizationKey {
660
+ /**
661
+ * The encrypted authorization key corresponding to the user's current
662
+ * authentication session.
663
+ */
664
+ ciphertext: string;
665
+
666
+ /**
667
+ * Base64-encoded ephemeral public key used in the HPKE encryption process.
668
+ * Required for decryption.
669
+ */
670
+ encapsulated_key: string;
671
+
672
+ /**
673
+ * The encryption type used. Currently only supports HPKE.
674
+ */
675
+ encryption_type: 'HPKE';
676
+ }
677
+
678
+ /**
679
+ * Encrypted response from bound wallet authentication, with bindings.
680
+ */
681
+ export interface EncryptedBoundAuthenticateResponse {
682
+ bindings: Array<UserSigningKeyBinding>;
683
+
684
+ /**
685
+ * HPKE-encrypted authorization key with encapsulated key and ciphertext.
686
+ */
687
+ encrypted_authorization_key: EncryptedAuthorizationKey;
688
+
689
+ expires_at: number;
690
+
691
+ wallets: Array<Wallet>;
692
+ }
693
+
694
+ /**
695
+ * The response from authenticating a wallet with HPKE encryption, containing an
696
+ * encrypted authorization key and wallet data.
697
+ */
698
+ export interface EncryptedWalletAuthenticateResponse {
699
+ /**
700
+ * HPKE-encrypted authorization key with encapsulated key and ciphertext.
701
+ */
702
+ encrypted_authorization_key: EncryptedAuthorizationKey;
703
+
704
+ /**
705
+ * The expiration time of the authorization key in milliseconds since the epoch.
706
+ */
707
+ expires_at: number;
708
+
709
+ wallets: Array<Wallet>;
710
+ }
711
+
442
712
  /**
443
713
  * Executes the EVM `personal_sign` RPC (EIP-191) to sign a message.
444
714
  */
@@ -452,8 +722,19 @@ export interface EthereumPersonalSignRpcInput {
452
722
 
453
723
  address?: string;
454
724
 
725
+ /**
726
+ * A valid CAIP-2 chain ID (e.g. 'eip155:1').
727
+ */
728
+ caip2?: AppsAPI.Caip2;
729
+
455
730
  chain_type?: 'ethereum';
456
731
 
732
+ /**
733
+ * Options controlling signature production for personal_sign and
734
+ * eth_signTypedData_v4.
735
+ */
736
+ signature_options?: SignatureOptions;
737
+
457
738
  wallet_id?: string;
458
739
  }
459
740
 
@@ -889,8 +1170,19 @@ export interface EthereumSignTypedDataRpcInput {
889
1170
 
890
1171
  address?: string;
891
1172
 
1173
+ /**
1174
+ * A valid CAIP-2 chain ID (e.g. 'eip155:1').
1175
+ */
1176
+ caip2?: AppsAPI.Caip2;
1177
+
892
1178
  chain_type?: 'ethereum';
893
1179
 
1180
+ /**
1181
+ * Options controlling signature production for personal_sign and
1182
+ * eth_signTypedData_v4.
1183
+ */
1184
+ signature_options?: SignatureOptions;
1185
+
894
1186
  wallet_id?: string;
895
1187
  }
896
1188
 
@@ -1128,9 +1420,17 @@ export interface Gas {
1128
1420
  */
1129
1421
  export interface GetByWalletAddressRequestBody {
1130
1422
  /**
1131
- * A blockchain wallet address (Ethereum or Solana).
1423
+ * A blockchain wallet address. Ethereum addresses are normalized to EIP-55
1424
+ * checksum format. Solana addresses are validated as base58. All other chain
1425
+ * addresses (Stellar, Tron, Sui, Aptos, etc.) are accepted as-is.
1132
1426
  */
1133
1427
  address: Address;
1428
+
1429
+ /**
1430
+ * Include archived wallets in lookup. Defaults to false (archived wallets return
1431
+ * 404).
1432
+ */
1433
+ include_archived?: boolean;
1134
1434
  }
1135
1435
 
1136
1436
  /**
@@ -1143,8 +1443,8 @@ export interface HDInitInput {
1143
1443
  address: string;
1144
1444
 
1145
1445
  /**
1146
- * The chain type of the wallet to import. Currently supports `ethereum` and
1147
- * `solana`.
1446
+ * The chain type of the wallet to import. Supports `ethereum`, `solana`,
1447
+ * `stellar`, `tron`, `sui`, and `aptos`.
1148
1448
  */
1149
1449
  chain_type: WalletImportSupportedChains;
1150
1450
 
@@ -1179,8 +1479,8 @@ export interface HDSubmitInput {
1179
1479
  address: string;
1180
1480
 
1181
1481
  /**
1182
- * The chain type of the wallet to import. Currently supports `ethereum` and
1183
- * `solana`.
1482
+ * The chain type of the wallet to import. Supports `ethereum`, `solana`,
1483
+ * `stellar`, `tron`, `sui`, and `aptos`.
1184
1484
  */
1185
1485
  chain_type: WalletImportSupportedChains;
1186
1486
 
@@ -1258,18 +1558,20 @@ export interface HpkeImportConfig {
1258
1558
  */
1259
1559
  export type Hex = string;
1260
1560
 
1561
+ /**
1562
+ * A binding that scopes a user signing key to a specific intent.
1563
+ */
1564
+ export interface IntentBinding {
1565
+ intentId: string;
1566
+
1567
+ type: 'intent';
1568
+ }
1569
+
1261
1570
  /**
1262
1571
  * Source for a transfer identified by a named asset (e.g. "usdc", "eth"). Use this
1263
1572
  * variant for first-class assets maintained by Privy.
1264
1573
  */
1265
1574
  export interface NamedTokenTransferSource {
1266
- /**
1267
- * Amount as a decimal string in the token's standard unit (e.g. "1.5" for 1.5
1268
- * USDC, "0.01" for 0.01 ETH). Not in the smallest on-chain unit (wei, lamports,
1269
- * etc.). Maximum 100 characters.
1270
- */
1271
- amount: string;
1272
-
1273
1575
  /**
1274
1576
  * The asset to transfer. Supported: 'usdc', 'usdb', 'usdt' (stablecoins), 'eth'
1275
1577
  * (native Ethereum), 'sol' (native Solana).
@@ -1282,6 +1584,14 @@ export interface NamedTokenTransferSource {
1282
1584
  * respective testnets.
1283
1585
  */
1284
1586
  chain: string;
1587
+
1588
+ /**
1589
+ * @deprecated Amount as a decimal string in the token's standard unit (e.g. "1.5"
1590
+ * for 1.5 USDC, "0.01" for 0.01 ETH). For exact_input, specifies the amount to
1591
+ * send. Not in the smallest on-chain unit (wei, lamports, etc.). Maximum 100
1592
+ * characters. Deprecated: use the top-level `amount` field instead.
1593
+ */
1594
+ amount?: string;
1285
1595
  }
1286
1596
 
1287
1597
  /**
@@ -1351,8 +1661,8 @@ export interface PrivateKeyInitInput {
1351
1661
  address: string;
1352
1662
 
1353
1663
  /**
1354
- * The chain type of the wallet to import. Currently supports `ethereum` and
1355
- * `solana`.
1664
+ * The chain type of the wallet to import. Supports `ethereum`, `solana`,
1665
+ * `stellar`, `tron`, `sui`, and `aptos`.
1356
1666
  */
1357
1667
  chain_type: WalletImportSupportedChains;
1358
1668
 
@@ -1374,8 +1684,8 @@ export interface PrivateKeySubmitInput {
1374
1684
  address: string;
1375
1685
 
1376
1686
  /**
1377
- * The chain type of the wallet to import. Currently supports `ethereum` and
1378
- * `solana`.
1687
+ * The chain type of the wallet to import. Supports `ethereum`, `solana`,
1688
+ * `stellar`, `tron`, `sui`, and `aptos`.
1379
1689
  */
1380
1690
  chain_type: WalletImportSupportedChains;
1381
1691
 
@@ -1425,6 +1735,19 @@ export interface PrivyFee {
1425
1735
  */
1426
1736
  export type Quantity = Hex | number;
1427
1737
 
1738
+ /**
1739
+ * Unencrypted response from bound wallet authentication, with bindings.
1740
+ */
1741
+ export interface RawBoundAuthenticateResponse {
1742
+ authorization_key: string;
1743
+
1744
+ bindings: Array<UserSigningKeyBinding>;
1745
+
1746
+ expires_at: number;
1747
+
1748
+ wallets: Array<Wallet>;
1749
+ }
1750
+
1428
1751
  /**
1429
1752
  * Encoding scheme for bytes in the `raw_sign` RPC.
1430
1753
  */
@@ -1507,6 +1830,24 @@ export interface RawSignResponseData {
1507
1830
  signature: Hex;
1508
1831
  }
1509
1832
 
1833
+ /**
1834
+ * The response from authenticating a wallet without encryption, containing a raw
1835
+ * authorization key and wallet data.
1836
+ */
1837
+ export interface RawWalletAuthenticateResponse {
1838
+ /**
1839
+ * The raw authorization key data.
1840
+ */
1841
+ authorization_key: string;
1842
+
1843
+ /**
1844
+ * The expiration time of the authorization key in milliseconds since the epoch.
1845
+ */
1846
+ expires_at: number;
1847
+
1848
+ wallets: Array<Wallet>;
1849
+ }
1850
+
1510
1851
  /**
1511
1852
  * The recipient public key for HPKE encryption, in PEM or DER (base64-encoded)
1512
1853
  * format.
@@ -1565,6 +1906,26 @@ export interface SeedPhraseExportResponse {
1565
1906
  encryption_type: HpkeEncryption;
1566
1907
  }
1567
1908
 
1909
+ /**
1910
+ * Options controlling signature production for personal_sign and
1911
+ * eth_signTypedData_v4.
1912
+ */
1913
+ export interface SignatureOptions {
1914
+ /**
1915
+ * The type of cryptographic signature to produce. Use "ecdsa" for standard ECDSA
1916
+ * signatures, or "erc1271" for ERC-1271 compliant signatures for smart account
1917
+ * wallets.
1918
+ */
1919
+ type: SignatureType;
1920
+ }
1921
+
1922
+ /**
1923
+ * The type of cryptographic signature to produce. Use "ecdsa" for standard ECDSA
1924
+ * signatures, or "erc1271" for ERC-1271 compliant signatures for smart account
1925
+ * wallets.
1926
+ */
1927
+ export type SignatureType = 'ecdsa' | 'erc1271';
1928
+
1568
1929
  /**
1569
1930
  * The signing algorithm used by the wallet.
1570
1931
  */
@@ -1814,6 +2175,92 @@ export interface SparkClaimStaticDepositRpcResponseData {
1814
2175
  transfer_id: string;
1815
2176
  }
1816
2177
 
2178
+ /**
2179
+ * A fee quote for a cooperative exit from Spark to Bitcoin L1.
2180
+ */
2181
+ export interface SparkCoopExitFeeQuote {
2182
+ id: string;
2183
+
2184
+ created_at: string;
2185
+
2186
+ expires_at: string;
2187
+
2188
+ /**
2189
+ * A currency amount with its original value and unit.
2190
+ */
2191
+ l1_broadcast_fee_fast: SparkCurrencyAmount;
2192
+
2193
+ /**
2194
+ * A currency amount with its original value and unit.
2195
+ */
2196
+ l1_broadcast_fee_medium: SparkCurrencyAmount;
2197
+
2198
+ /**
2199
+ * A currency amount with its original value and unit.
2200
+ */
2201
+ l1_broadcast_fee_slow: SparkCurrencyAmount;
2202
+
2203
+ network: string;
2204
+
2205
+ /**
2206
+ * A currency amount with its original value and unit.
2207
+ */
2208
+ total_amount: SparkCurrencyAmount;
2209
+
2210
+ updated_at: string;
2211
+
2212
+ /**
2213
+ * A currency amount with its original value and unit.
2214
+ */
2215
+ user_fee_fast: SparkCurrencyAmount;
2216
+
2217
+ /**
2218
+ * A currency amount with its original value and unit.
2219
+ */
2220
+ user_fee_medium: SparkCurrencyAmount;
2221
+
2222
+ /**
2223
+ * A currency amount with its original value and unit.
2224
+ */
2225
+ user_fee_slow: SparkCurrencyAmount;
2226
+ }
2227
+
2228
+ /**
2229
+ * A cooperative exit request from Spark to Bitcoin L1.
2230
+ */
2231
+ export interface SparkCoopExitRequest {
2232
+ id: string;
2233
+
2234
+ coop_exit_txid: string;
2235
+
2236
+ created_at: string;
2237
+
2238
+ expires_at: string;
2239
+
2240
+ /**
2241
+ * A currency amount with its original value and unit.
2242
+ */
2243
+ fee: SparkCurrencyAmount;
2244
+
2245
+ /**
2246
+ * A currency amount with its original value and unit.
2247
+ */
2248
+ l1_broadcast_fee: SparkCurrencyAmount;
2249
+
2250
+ network: string;
2251
+
2252
+ status: string;
2253
+
2254
+ updated_at: string;
2255
+
2256
+ /**
2257
+ * The exit speed for a cooperative withdrawal from Spark to L1.
2258
+ */
2259
+ exit_speed?: SparkExitSpeed;
2260
+
2261
+ fee_quote_id?: string;
2262
+ }
2263
+
1817
2264
  /**
1818
2265
  * Creates a Lightning invoice for the Spark wallet.
1819
2266
  */
@@ -1860,6 +2307,20 @@ export interface SparkCreateLightningInvoiceRpcResponse {
1860
2307
  data?: SparkLightningReceiveRequest;
1861
2308
  }
1862
2309
 
2310
+ /**
2311
+ * A currency amount with its original value and unit.
2312
+ */
2313
+ export interface SparkCurrencyAmount {
2314
+ original_unit: string;
2315
+
2316
+ original_value: number;
2317
+ }
2318
+
2319
+ /**
2320
+ * The exit speed for a cooperative withdrawal from Spark to L1.
2321
+ */
2322
+ export type SparkExitSpeed = 'FAST' | 'MEDIUM' | 'SLOW';
2323
+
1863
2324
  /**
1864
2325
  * Gets the balance of the Spark wallet.
1865
2326
  */
@@ -1968,6 +2429,44 @@ export interface SparkGetStaticDepositAddressRpcResponseData {
1968
2429
  address: string;
1969
2430
  }
1970
2431
 
2432
+ /**
2433
+ * Gets a fee quote for withdrawing from Spark to a Bitcoin L1 address.
2434
+ */
2435
+ export interface SparkGetWithdrawalFeeQuoteRpcInput {
2436
+ method: 'getWithdrawalFeeQuote';
2437
+
2438
+ /**
2439
+ * Parameters for the Spark `getWithdrawalFeeQuote` RPC.
2440
+ */
2441
+ params: SparkGetWithdrawalFeeQuoteRpcInputParams;
2442
+
2443
+ /**
2444
+ * The Spark network.
2445
+ */
2446
+ network?: SparkNetwork;
2447
+ }
2448
+
2449
+ /**
2450
+ * Parameters for the Spark `getWithdrawalFeeQuote` RPC.
2451
+ */
2452
+ export interface SparkGetWithdrawalFeeQuoteRpcInputParams {
2453
+ amount_sats: number;
2454
+
2455
+ onchain_address: string;
2456
+ }
2457
+
2458
+ /**
2459
+ * Response to the Spark `getWithdrawalFeeQuote` RPC.
2460
+ */
2461
+ export interface SparkGetWithdrawalFeeQuoteRpcResponse {
2462
+ method: 'getWithdrawalFeeQuote';
2463
+
2464
+ /**
2465
+ * A fee quote for a cooperative exit from Spark to Bitcoin L1.
2466
+ */
2467
+ data?: SparkCoopExitFeeQuote;
2468
+ }
2469
+
1971
2470
  /**
1972
2471
  * The fee for a Spark Lightning payment.
1973
2472
  */
@@ -2096,7 +2595,9 @@ export type SparkRpcInput =
2096
2595
  | SparkClaimStaticDepositRpcInput
2097
2596
  | SparkCreateLightningInvoiceRpcInput
2098
2597
  | SparkPayLightningInvoiceRpcInput
2099
- | SparkSignMessageWithIdentityKeyRpcInput;
2598
+ | SparkSignMessageWithIdentityKeyRpcInput
2599
+ | SparkWithdrawRpcInput
2600
+ | SparkGetWithdrawalFeeQuoteRpcInput;
2100
2601
 
2101
2602
  /**
2102
2603
  * Response body for Spark wallet RPC operations, discriminated by method.
@@ -2110,7 +2611,9 @@ export type SparkRpcResponse =
2110
2611
  | SparkClaimStaticDepositRpcResponse
2111
2612
  | SparkCreateLightningInvoiceRpcResponse
2112
2613
  | SparkPayLightningInvoiceRpcResponse
2113
- | SparkSignMessageWithIdentityKeyRpcResponse;
2614
+ | SparkSignMessageWithIdentityKeyRpcResponse
2615
+ | SparkWithdrawRpcResponse
2616
+ | SparkGetWithdrawalFeeQuoteRpcResponse;
2114
2617
 
2115
2618
  /**
2116
2619
  * Signs a message with the Spark identity key.
@@ -2371,11 +2874,66 @@ export interface SparkWalletLeaf {
2371
2874
  signing_keyshare?: SparkSigningKeyshare;
2372
2875
  }
2373
2876
 
2877
+ /**
2878
+ * Withdraws from Spark to a Bitcoin L1 address (cooperative exit).
2879
+ */
2880
+ export interface SparkWithdrawRpcInput {
2881
+ method: 'withdraw';
2882
+
2883
+ /**
2884
+ * Parameters for the Spark `withdraw` RPC.
2885
+ */
2886
+ params: SparkWithdrawRpcInputParams;
2887
+
2888
+ /**
2889
+ * The Spark network.
2890
+ */
2891
+ network?: SparkNetwork;
2892
+ }
2893
+
2894
+ /**
2895
+ * Parameters for the Spark `withdraw` RPC.
2896
+ */
2897
+ export interface SparkWithdrawRpcInputParams {
2898
+ /**
2899
+ * The exit speed for a cooperative withdrawal from Spark to L1.
2900
+ */
2901
+ exit_speed: SparkExitSpeed;
2902
+
2903
+ onchain_address: string;
2904
+
2905
+ amount_sats?: number;
2906
+
2907
+ deduct_fee_from_withdrawal_amount?: boolean;
2908
+
2909
+ fee_amount_sats?: number;
2910
+
2911
+ fee_quote_id?: string;
2912
+ }
2913
+
2914
+ /**
2915
+ * Response to the Spark `withdraw` RPC.
2916
+ */
2917
+ export interface SparkWithdrawRpcResponse {
2918
+ method: 'withdraw';
2919
+
2920
+ /**
2921
+ * A cooperative exit request from Spark to Bitcoin L1.
2922
+ */
2923
+ data?: SparkCoopExitRequest;
2924
+ }
2925
+
2374
2926
  /**
2375
2927
  * SUI transaction commands allowlist for raw_sign endpoint policy evaluation
2376
2928
  */
2377
2929
  export type SuiCommandName = 'TransferObjects' | 'SplitCoins' | 'MergeCoins';
2378
2930
 
2931
+ /**
2932
+ * "accepted" if the network has acknowledged the transaction, "rejected" if the
2933
+ * network refused it, "skipped" if dry_run was set. Not an onchain confirmation.
2934
+ */
2935
+ export type SwapSubmissionStatus = 'accepted' | 'rejected' | 'skipped';
2936
+
2379
2937
  /**
2380
2938
  * An AA authorization for Tempo transactions with P256/WebAuthn signatures.
2381
2939
  */
@@ -2504,6 +3062,22 @@ export interface TotalFeeConfigurationBps {
2504
3062
  value: number;
2505
3063
  }
2506
3064
 
3065
+ /**
3066
+ * Chains supported for transaction history queries.
3067
+ */
3068
+ export type TransactionChainNameInput =
3069
+ | 'ethereum'
3070
+ | 'arbitrum'
3071
+ | 'avalanche'
3072
+ | 'base'
3073
+ | 'bsc'
3074
+ | 'tempo'
3075
+ | 'linea'
3076
+ | 'optimism'
3077
+ | 'polygon'
3078
+ | 'solana'
3079
+ | 'sepolia';
3080
+
2507
3081
  /**
2508
3082
  * Details of a wallet transaction, varying by transaction type.
2509
3083
  */
@@ -2532,6 +3106,13 @@ export interface TransferQuoteRequestBody {
2532
3106
  */
2533
3107
  source: TokenTransferSource;
2534
3108
 
3109
+ /**
3110
+ * Amount as a decimal string in the token's standard unit (e.g. "1.5" for 1.5
3111
+ * USDC). For exact_input, the amount to send. For exact_output, the exact amount
3112
+ * to receive. Takes precedence over source.amount when both are provided.
3113
+ */
3114
+ amount?: string;
3115
+
2535
3116
  /**
2536
3117
  * Whether the amount refers to the input token or output token.
2537
3118
  */
@@ -2543,7 +3124,8 @@ export interface TransferQuoteRequestBody {
2543
3124
  fee_configuration?: FeeConfiguration;
2544
3125
 
2545
3126
  /**
2546
- * Maximum allowed slippage in basis points (1 bps = 0.01%).
3127
+ * Maximum allowed slippage in basis points (1 bps = 0.01%). Only applicable for
3128
+ * cross-chain or cross-asset transfers; omit to use the provider default.
2547
3129
  */
2548
3130
  slippage_bps?: number;
2549
3131
  }
@@ -2559,17 +3141,25 @@ export interface TransferQuoteResponse {
2559
3141
  destination: TokenTransferDestination;
2560
3142
 
2561
3143
  /**
2562
- * Estimated fees in USD
3144
+ * Estimated fees in USD for the transfer. Only present for cross-chain transfers.
2563
3145
  */
2564
3146
  estimated_fees: Array<FeeLineItem>;
2565
3147
 
2566
3148
  /**
2567
- * Estimated output amount in decimals
3149
+ * Estimated input amount in decimals. For exact_input, this equals source.amount.
3150
+ * For exact_output, this is the estimated amount the sender needs to provide.
3151
+ */
3152
+ estimated_input_amount: string;
3153
+
3154
+ /**
3155
+ * Estimated output amount in decimals. For exact_input, this is an estimate
3156
+ * subject to slippage. For exact_output, this is the guaranteed exact amount to be
3157
+ * received.
2568
3158
  */
2569
3159
  estimated_output_amount: string;
2570
3160
 
2571
3161
  /**
2572
- * Quote expiry as unix timestamp (seconds)
3162
+ * Quote expiry as Unix timestamp (seconds).
2573
3163
  */
2574
3164
  expires_at: number;
2575
3165
 
@@ -2595,26 +3185,104 @@ export interface TransferQuoteResponse {
2595
3185
  * Details for a received transfer transaction.
2596
3186
  */
2597
3187
  export interface TransferReceivedTransactionDetail {
2598
- asset: 'usdc' | 'usdc.e' | 'eth' | 'pol' | 'usdt' | 'eurc' | 'usdb' | 'sol' | (string & {});
2599
-
2600
- chain:
2601
- | 'ethereum'
2602
- | 'arbitrum'
2603
- | 'base'
2604
- | 'tempo'
2605
- | 'linea'
2606
- | 'optimism'
2607
- | 'polygon'
2608
- | 'solana'
2609
- | 'zksync_era'
2610
- | 'sepolia'
2611
- | 'arbitrum_sepolia'
2612
- | 'base_sepolia'
2613
- | 'linea_testnet'
2614
- | 'optimism_sepolia'
2615
- | 'polygon_amoy'
2616
- | 'solana_devnet'
2617
- | 'solana_testnet';
3188
+ asset:
3189
+ | 'usdc'
3190
+ | 'usdc.e'
3191
+ | 'eth'
3192
+ | 'avax'
3193
+ | 'pol'
3194
+ | 'bnb'
3195
+ | 'usdt'
3196
+ | 'eurc'
3197
+ | 'usdb'
3198
+ | 'sol'
3199
+ | 'trx'
3200
+ | (string & {});
3201
+
3202
+ /**
3203
+ * Supported blockchain network names for wallet balance and transaction queries.
3204
+ */
3205
+ chain: WalletAssetChainNameInput;
3206
+
3207
+ display_values: { [key: string]: string };
3208
+
3209
+ raw_value: string;
3210
+
3211
+ raw_value_decimals: number;
3212
+
3213
+ recipient: string;
3214
+
3215
+ recipient_privy_user_id: string | null;
3216
+
3217
+ sender: string;
3218
+
3219
+ sender_privy_user_id: string | null;
3220
+
3221
+ type: 'transfer_received';
3222
+ }
3223
+
3224
+ /**
3225
+ * Request body for initiating a sponsored token transfer from an embedded wallet.
3226
+ */
3227
+ export interface TransferRequestBody {
3228
+ /**
3229
+ * The destination address for a token transfer. Optionally specify a different
3230
+ * asset or chain for cross-asset or cross-chain transfers.
3231
+ */
3232
+ destination: TokenTransferDestination;
3233
+
3234
+ /**
3235
+ * The source asset, amount, and chain for a token transfer. Specify either `asset`
3236
+ * (named) or `asset_address` (custom), not both.
3237
+ */
3238
+ source: TokenTransferSource;
3239
+
3240
+ /**
3241
+ * Amount as a decimal string in the token's standard unit (e.g. "1.5" for 1.5
3242
+ * USDC). For exact_input, the amount to send. For exact_output, the exact amount
3243
+ * to receive. Takes precedence over source.amount when both are provided.
3244
+ */
3245
+ amount?: string;
3246
+
3247
+ /**
3248
+ * Whether the amount refers to the input token or output token.
3249
+ */
3250
+ amount_type?: AmountType;
3251
+
3252
+ /**
3253
+ * Total fees assessed on a transfer, in BPS
3254
+ */
3255
+ fee_configuration?: FeeConfiguration;
3256
+
3257
+ /**
3258
+ * Maximum allowed slippage in basis points (1 bps = 0.01%). Only applicable for
3259
+ * cross-chain or cross-asset transfers; omit to use the provider default.
3260
+ */
3261
+ slippage_bps?: number;
3262
+ }
3263
+
3264
+ /**
3265
+ * Details for a sent transfer transaction.
3266
+ */
3267
+ export interface TransferSentTransactionDetail {
3268
+ asset:
3269
+ | 'usdc'
3270
+ | 'usdc.e'
3271
+ | 'eth'
3272
+ | 'avax'
3273
+ | 'pol'
3274
+ | 'bnb'
3275
+ | 'usdt'
3276
+ | 'eurc'
3277
+ | 'usdb'
3278
+ | 'sol'
3279
+ | 'trx'
3280
+ | (string & {});
3281
+
3282
+ /**
3283
+ * Supported blockchain network names for wallet balance and transaction queries.
3284
+ */
3285
+ chain: WalletAssetChainNameInput;
2618
3286
 
2619
3287
  display_values: { [key: string]: string };
2620
3288
 
@@ -2630,81 +3298,215 @@ export interface TransferReceivedTransactionDetail {
2630
3298
 
2631
3299
  sender_privy_user_id: string | null;
2632
3300
 
2633
- type: 'transfer_received';
3301
+ type: 'transfer_sent';
3302
+ }
3303
+
3304
+ /**
3305
+ * A Tron contract, discriminated by type. Supported types: TransferContract,
3306
+ * TriggerSmartContract.
3307
+ */
3308
+ export type TronContract = TronTransferContract | TronTriggerSmartContract;
3309
+
3310
+ /**
3311
+ * Tron raw_data for tron_sendTransaction. Block reference fields are optional;
3312
+ * Privy fetches fresh values if omitted.
3313
+ */
3314
+ export interface TronRawDataForSend {
3315
+ contract: Array<TronContract>;
3316
+
3317
+ data?: string;
3318
+
3319
+ expiration?: number;
3320
+
3321
+ fee_limit?: number;
3322
+
3323
+ ref_block_bytes?: string;
3324
+
3325
+ ref_block_hash?: string;
3326
+
3327
+ timestamp?: number;
3328
+ }
3329
+
3330
+ /**
3331
+ * Tron raw_data for tron_signTransaction. Block reference fields are required;
3332
+ * caller is responsible for fetching them.
3333
+ */
3334
+ export interface TronRawDataForSign {
3335
+ contract: Array<TronContract>;
3336
+
3337
+ expiration: number;
3338
+
3339
+ ref_block_bytes: string;
3340
+
3341
+ ref_block_hash: string;
3342
+
3343
+ data?: string;
3344
+
3345
+ fee_limit?: number;
3346
+
3347
+ timestamp?: number;
3348
+ }
3349
+
3350
+ /**
3351
+ * Request body for Tron wallet RPC operations, discriminated by method.
3352
+ */
3353
+ export type TronRpcInput = TronSignTransactionRpcInput | TronSendTransactionRpcInput;
3354
+
3355
+ /**
3356
+ * Response body for Tron wallet RPC operations, discriminated by method.
3357
+ */
3358
+ export type TronRpcResponse = TronSignTransactionRpcResponse | TronSendTransactionRpcResponse;
3359
+
3360
+ /**
3361
+ * Executes the Tron `tron_sendTransaction` RPC to sign and broadcast a
3362
+ * transaction.
3363
+ */
3364
+ export interface TronSendTransactionRpcInput {
3365
+ method: 'tron_sendTransaction';
3366
+
3367
+ /**
3368
+ * Parameters for the Tron `tron_sendTransaction` RPC.
3369
+ */
3370
+ params: TronSendTransactionRpcInputParams;
3371
+
3372
+ /**
3373
+ * A valid CAIP-2 chain ID (e.g. 'eip155:1').
3374
+ */
3375
+ caip2?: AppsAPI.Caip2;
3376
+ }
3377
+
3378
+ /**
3379
+ * Parameters for the Tron `tron_sendTransaction` RPC.
3380
+ */
3381
+ export interface TronSendTransactionRpcInputParams {
3382
+ /**
3383
+ * Tron raw_data for tron_sendTransaction. Block reference fields are optional;
3384
+ * Privy fetches fresh values if omitted.
3385
+ */
3386
+ raw_data: TronRawDataForSend;
3387
+
3388
+ reference_id?: string;
3389
+ }
3390
+
3391
+ /**
3392
+ * Response to the Tron `tron_sendTransaction` RPC.
3393
+ */
3394
+ export interface TronSendTransactionRpcResponse {
3395
+ /**
3396
+ * Data returned by the Tron `tron_sendTransaction` RPC.
3397
+ */
3398
+ data: TronSendTransactionRpcResponseData;
3399
+
3400
+ method: 'tron_sendTransaction';
3401
+ }
3402
+
3403
+ /**
3404
+ * Data returned by the Tron `tron_sendTransaction` RPC.
3405
+ */
3406
+ export interface TronSendTransactionRpcResponseData {
3407
+ /**
3408
+ * A valid CAIP-2 chain ID (e.g. 'eip155:1').
3409
+ */
3410
+ caip2: AppsAPI.Caip2;
3411
+
3412
+ hash: string;
3413
+
3414
+ transaction_id: string;
3415
+
3416
+ reference_id?: string;
3417
+ }
3418
+
3419
+ /**
3420
+ * Executes the Tron `tron_signTransaction` RPC to sign a transaction. The caller
3421
+ * is responsible for broadcasting.
3422
+ */
3423
+ export interface TronSignTransactionRpcInput {
3424
+ method: 'tron_signTransaction';
3425
+
3426
+ /**
3427
+ * Parameters for the Tron `tron_signTransaction` RPC.
3428
+ */
3429
+ params: TronSignTransactionRpcInputParams;
3430
+ }
3431
+
3432
+ /**
3433
+ * Parameters for the Tron `tron_signTransaction` RPC.
3434
+ */
3435
+ export interface TronSignTransactionRpcInputParams {
3436
+ /**
3437
+ * Tron raw_data for tron_signTransaction. Block reference fields are required;
3438
+ * caller is responsible for fetching them.
3439
+ */
3440
+ raw_data: TronRawDataForSign;
3441
+ }
3442
+
3443
+ /**
3444
+ * Response to the Tron `tron_signTransaction` RPC.
3445
+ */
3446
+ export interface TronSignTransactionRpcResponse {
3447
+ /**
3448
+ * Data returned by the Tron `tron_signTransaction` RPC.
3449
+ */
3450
+ data: TronSignTransactionRpcResponseData;
3451
+
3452
+ method: 'tron_signTransaction';
3453
+ }
3454
+
3455
+ /**
3456
+ * Data returned by the Tron `tron_signTransaction` RPC.
3457
+ */
3458
+ export interface TronSignTransactionRpcResponseData {
3459
+ encoding: 'hex';
3460
+
3461
+ signed_transaction: string;
2634
3462
  }
2635
3463
 
2636
3464
  /**
2637
- * Request body for initiating a sponsored token transfer from an embedded wallet.
3465
+ * Tron native TRX transfer contract.
2638
3466
  */
2639
- export interface TransferRequestBody {
2640
- /**
2641
- * The destination address for a token transfer. Optionally specify a different
2642
- * asset or chain for cross-asset or cross-chain transfers.
2643
- */
2644
- destination: TokenTransferDestination;
2645
-
2646
- /**
2647
- * The source asset, amount, and chain for a token transfer. Specify either `asset`
2648
- * (named) or `asset_address` (custom), not both.
2649
- */
2650
- source: TokenTransferSource;
3467
+ export interface TronTransferContract {
3468
+ amount: number;
2651
3469
 
2652
3470
  /**
2653
- * Whether the amount refers to the input token or output token.
3471
+ * Tron address in hex format: 41-prefixed, 42 hex characters (21 bytes), no 0x
3472
+ * prefix.
2654
3473
  */
2655
- amount_type?: AmountType;
3474
+ owner_address: SharedAPI.TronHexAddress;
2656
3475
 
2657
3476
  /**
2658
- * Total fees assessed on a transfer, in BPS
3477
+ * Tron address in hex format: 41-prefixed, 42 hex characters (21 bytes), no 0x
3478
+ * prefix.
2659
3479
  */
2660
- fee_configuration?: FeeConfiguration;
3480
+ to_address: SharedAPI.TronHexAddress;
2661
3481
 
2662
- /**
2663
- * Maximum allowed slippage in basis points (1 bps = 0.01%).
2664
- */
2665
- slippage_bps?: number;
3482
+ type: 'TransferContract';
2666
3483
  }
2667
3484
 
2668
3485
  /**
2669
- * Details for a sent transfer transaction.
3486
+ * Tron smart contract call (TRC-20 transfers and general contract interactions).
2670
3487
  */
2671
- export interface TransferSentTransactionDetail {
2672
- asset: 'usdc' | 'usdc.e' | 'eth' | 'pol' | 'usdt' | 'eurc' | 'usdb' | 'sol' | (string & {});
2673
-
2674
- chain:
2675
- | 'ethereum'
2676
- | 'arbitrum'
2677
- | 'base'
2678
- | 'tempo'
2679
- | 'linea'
2680
- | 'optimism'
2681
- | 'polygon'
2682
- | 'solana'
2683
- | 'zksync_era'
2684
- | 'sepolia'
2685
- | 'arbitrum_sepolia'
2686
- | 'base_sepolia'
2687
- | 'linea_testnet'
2688
- | 'optimism_sepolia'
2689
- | 'polygon_amoy'
2690
- | 'solana_devnet'
2691
- | 'solana_testnet';
2692
-
2693
- display_values: { [key: string]: string };
2694
-
2695
- raw_value: string;
3488
+ export interface TronTriggerSmartContract {
3489
+ /**
3490
+ * Tron address in hex format: 41-prefixed, 42 hex characters (21 bytes), no 0x
3491
+ * prefix.
3492
+ */
3493
+ contract_address: SharedAPI.TronHexAddress;
2696
3494
 
2697
- raw_value_decimals: number;
3495
+ /**
3496
+ * Tron address in hex format: 41-prefixed, 42 hex characters (21 bytes), no 0x
3497
+ * prefix.
3498
+ */
3499
+ owner_address: SharedAPI.TronHexAddress;
2698
3500
 
2699
- recipient: string;
3501
+ type: 'TriggerSmartContract';
2700
3502
 
2701
- recipient_privy_user_id: string | null;
3503
+ call_token_value?: number;
2702
3504
 
2703
- sender: string;
3505
+ call_value?: number;
2704
3506
 
2705
- sender_privy_user_id: string | null;
3507
+ data?: string;
2706
3508
 
2707
- type: 'transfer_sent';
3509
+ token_id?: number;
2708
3510
  }
2709
3511
 
2710
3512
  /**
@@ -2804,7 +3606,7 @@ export interface UnsignedTempoTransaction {
2804
3606
 
2805
3607
  aa_authorization_list?: Array<TempoAaAuthorization>;
2806
3608
 
2807
- access_list?: Array<UnsignedTempoTransaction.AccessList>;
3609
+ access_list?: Array<AccessListEntry>;
2808
3610
 
2809
3611
  /**
2810
3612
  * A quantity value that can be either a hex string starting with '0x' or a
@@ -2864,14 +3666,6 @@ export interface UnsignedTempoTransaction {
2864
3666
  valid_before?: Quantity;
2865
3667
  }
2866
3668
 
2867
- export namespace UnsignedTempoTransaction {
2868
- export interface AccessList {
2869
- address: string;
2870
-
2871
- storage_keys: Array<WalletsAPI.Hex>;
2872
- }
2873
- }
2874
-
2875
3669
  /**
2876
3670
  * An ERC-4337 user operation.
2877
3671
  */
@@ -2941,6 +3735,15 @@ export interface UserOperationInput {
2941
3735
  paymaster_verification_gas_limit?: Hex;
2942
3736
  }
2943
3737
 
3738
+ /**
3739
+ * A binding that scopes a user signing key to a specific intent.
3740
+ */
3741
+ export interface UserSigningKeyBinding {
3742
+ intentId: string;
3743
+
3744
+ type: 'intent';
3745
+ }
3746
+
2944
3747
  /**
2945
3748
  * A wallet managed by Privy's wallet infrastructure.
2946
3749
  */
@@ -2993,6 +3796,12 @@ export interface Wallet {
2993
3796
  */
2994
3797
  policy_ids: Array<string>;
2995
3798
 
3799
+ /**
3800
+ * Unix timestamp of when the wallet was archived in milliseconds, or null if the
3801
+ * wallet is active.
3802
+ */
3803
+ archived_at?: number | null;
3804
+
2996
3805
  /**
2997
3806
  * The number of keys that must sign for an action to be valid.
2998
3807
  */
@@ -3067,7 +3876,90 @@ export interface WalletAPIRevokeAuthorizationKeyInput {
3067
3876
  /**
3068
3877
  * A named asset supported across all chains.
3069
3878
  */
3070
- export type WalletAsset = 'usdc' | 'usdc.e' | 'eth' | 'pol' | 'usdt' | 'eurc' | 'usdb' | 'sol';
3879
+ export type WalletAsset =
3880
+ | 'usdc'
3881
+ | 'usdc.e'
3882
+ | 'eth'
3883
+ | 'avax'
3884
+ | 'pol'
3885
+ | 'bnb'
3886
+ | 'usdt'
3887
+ | 'eurc'
3888
+ | 'usdb'
3889
+ | 'sol'
3890
+ | 'trx';
3891
+
3892
+ /**
3893
+ * Supported blockchain network names for wallet balance and transaction queries.
3894
+ */
3895
+ export type WalletAssetChainNameInput =
3896
+ | 'ethereum'
3897
+ | 'arbitrum'
3898
+ | 'avalanche'
3899
+ | 'base'
3900
+ | 'tempo'
3901
+ | 'linea'
3902
+ | 'optimism'
3903
+ | 'polygon'
3904
+ | 'bsc'
3905
+ | 'solana'
3906
+ | 'tron'
3907
+ | 'zksync_era'
3908
+ | 'sepolia'
3909
+ | 'arbitrum_sepolia'
3910
+ | 'avalanche_fuji'
3911
+ | 'base_sepolia'
3912
+ | 'linea_testnet'
3913
+ | 'optimism_sepolia'
3914
+ | 'polygon_amoy'
3915
+ | 'solana_devnet'
3916
+ | 'solana_testnet'
3917
+ | 'tron_nile';
3918
+
3919
+ /**
3920
+ * Request body for creating an encrypted, bound user signing key.
3921
+ */
3922
+ export interface WalletAuthenticateBoundEncryptedRequestBody {
3923
+ /**
3924
+ * Bindings that scope the USK. The key can only authorize the bound values.
3925
+ */
3926
+ bindings: Array<UserSigningKeyBinding>;
3927
+
3928
+ encryption_type: 'HPKE';
3929
+
3930
+ recipient_public_key: string;
3931
+
3932
+ user_jwt: string;
3933
+ }
3934
+
3935
+ /**
3936
+ * Request body for creating a user signing key scoped to specific bindings. The
3937
+ * returned USK can only authorize the bound values and cannot sign other RPC
3938
+ * requests.
3939
+ */
3940
+ export type WalletAuthenticateBoundRequestBody =
3941
+ | WalletAuthenticateBoundEncryptedRequestBody
3942
+ | WalletAuthenticateBoundUnencryptedRequestBody;
3943
+
3944
+ /**
3945
+ * Request body for creating an unencrypted, bound user signing key.
3946
+ */
3947
+ export interface WalletAuthenticateBoundUnencryptedRequestBody {
3948
+ /**
3949
+ * Bindings that scope the USK. The key can only authorize the bound values.
3950
+ */
3951
+ bindings: Array<UserSigningKeyBinding>;
3952
+
3953
+ user_jwt: string;
3954
+ }
3955
+
3956
+ /**
3957
+ * The response from authenticating a wallet with intent bindings, containing an
3958
+ * authorization key, wallet data, and the bindings the key is scoped to.
3959
+ */
3960
+ export type WalletAuthenticateIntentsResponse =
3961
+ | EncryptedBoundAuthenticateResponse
3962
+ | RawBoundAuthenticateResponse;
3071
3963
 
3072
3964
  /**
3073
3965
  * Request body for wallet authentication with HPKE-encrypted response.
@@ -3096,62 +3988,8 @@ export interface WalletAuthenticateRequestBody {
3096
3988
  * wallet data.
3097
3989
  */
3098
3990
  export type WalletAuthenticateWithJwtResponse =
3099
- | WalletAuthenticateWithJwtResponse.WithEncryption
3100
- | WalletAuthenticateWithJwtResponse.WithoutEncryption;
3101
-
3102
- export namespace WalletAuthenticateWithJwtResponse {
3103
- export interface WithEncryption {
3104
- /**
3105
- * The encrypted authorization key data.
3106
- */
3107
- encrypted_authorization_key: WithEncryption.EncryptedAuthorizationKey;
3108
-
3109
- /**
3110
- * The expiration time of the authorization key in milliseconds since the epoch.
3111
- */
3112
- expires_at: number;
3113
-
3114
- wallets: Array<WalletsAPI.Wallet>;
3115
- }
3116
-
3117
- export namespace WithEncryption {
3118
- /**
3119
- * The encrypted authorization key data.
3120
- */
3121
- export interface EncryptedAuthorizationKey {
3122
- /**
3123
- * The encrypted authorization key corresponding to the user's current
3124
- * authentication session.
3125
- */
3126
- ciphertext: string;
3127
-
3128
- /**
3129
- * Base64-encoded ephemeral public key used in the HPKE encryption process.
3130
- * Required for decryption.
3131
- */
3132
- encapsulated_key: string;
3133
-
3134
- /**
3135
- * The encryption type used. Currently only supports HPKE.
3136
- */
3137
- encryption_type: 'HPKE';
3138
- }
3139
- }
3140
-
3141
- export interface WithoutEncryption {
3142
- /**
3143
- * The raw authorization key data.
3144
- */
3145
- authorization_key: string;
3146
-
3147
- /**
3148
- * The expiration time of the authorization key in milliseconds since the epoch.
3149
- */
3150
- expires_at: number;
3151
-
3152
- wallets: Array<WalletsAPI.Wallet>;
3153
- }
3154
- }
3991
+ | EncryptedWalletAuthenticateResponse
3992
+ | RawWalletAuthenticateResponse;
3155
3993
 
3156
3994
  /**
3157
3995
  * Headers required to authorize wallet operations.
@@ -3347,7 +4185,16 @@ export type WalletEntropyType = 'hd' | 'private-key';
3347
4185
  /**
3348
4186
  * A named asset on Ethereum-compatible chains.
3349
4187
  */
3350
- export type WalletEthereumAsset = 'usdc' | 'usdc.e' | 'eth' | 'pol' | 'usdt' | 'eurc' | 'usdb';
4188
+ export type WalletEthereumAsset =
4189
+ | 'usdc'
4190
+ | 'usdc.e'
4191
+ | 'eth'
4192
+ | 'avax'
4193
+ | 'pol'
4194
+ | 'bnb'
4195
+ | 'usdt'
4196
+ | 'eurc'
4197
+ | 'usdb';
3351
4198
 
3352
4199
  /**
3353
4200
  * Request body for exporting a wallet private key.
@@ -3403,10 +4250,10 @@ export interface WalletImportInitResponse {
3403
4250
  }
3404
4251
 
3405
4252
  /**
3406
- * The chain type of the wallet to import. Currently supports `ethereum` and
3407
- * `solana`.
4253
+ * The chain type of the wallet to import. Supports `ethereum`, `solana`,
4254
+ * `stellar`, `tron`, `sui`, and `aptos`.
3408
4255
  */
3409
- export type WalletImportSupportedChains = 'ethereum' | 'solana';
4256
+ export type WalletImportSupportedChains = 'ethereum' | 'solana' | 'stellar' | 'tron' | 'sui' | 'aptos';
3410
4257
 
3411
4258
  /**
3412
4259
  * The entropy type of the wallet to import. Supports `private-key` for raw private
@@ -3445,6 +4292,10 @@ export type WalletRpcRequestBody =
3445
4292
  | SparkCreateLightningInvoiceRpcInput
3446
4293
  | SparkPayLightningInvoiceRpcInput
3447
4294
  | SparkSignMessageWithIdentityKeyRpcInput
4295
+ | SparkWithdrawRpcInput
4296
+ | SparkGetWithdrawalFeeQuoteRpcInput
4297
+ | TronSignTransactionRpcInput
4298
+ | TronSendTransactionRpcInput
3448
4299
  | ExportPrivateKeyRpcInput
3449
4300
  | ExportSeedPhraseRpcInput;
3450
4301
 
@@ -3472,6 +4323,10 @@ export type WalletRpcResponse =
3472
4323
  | SparkCreateLightningInvoiceRpcResponse
3473
4324
  | SparkPayLightningInvoiceRpcResponse
3474
4325
  | SparkSignMessageWithIdentityKeyRpcResponse
4326
+ | SparkWithdrawRpcResponse
4327
+ | SparkGetWithdrawalFeeQuoteRpcResponse
4328
+ | TronSignTransactionRpcResponse
4329
+ | TronSendTransactionRpcResponse
3475
4330
  | ExportPrivateKeyRpcResponse
3476
4331
  | ExportSeedPhraseRpcResponse;
3477
4332
 
@@ -3480,6 +4335,11 @@ export type WalletRpcResponse =
3480
4335
  */
3481
4336
  export type WalletSolanaAsset = 'sol' | 'usdc' | 'eurc' | 'usdb';
3482
4337
 
4338
+ /**
4339
+ * A named asset on Tron.
4340
+ */
4341
+ export type WalletTronAsset = 'trx' | 'usdt' | 'usdc';
4342
+
3483
4343
  /**
3484
4344
  * Request body for updating a wallet. `owner` and `owner_id` are mutually
3485
4345
  * exclusive.
@@ -3604,6 +4464,13 @@ export interface WalletUpdateParams {
3604
4464
  }
3605
4465
 
3606
4466
  export interface WalletListParams extends CursorParams {
4467
+ /**
4468
+ * A blockchain wallet address. Ethereum addresses are normalized to EIP-55
4469
+ * checksum format. Solana addresses are validated as base58. All other chain
4470
+ * addresses (Stellar, Tron, Sui, Aptos, etc.) are accepted as-is.
4471
+ */
4472
+ address?: Address;
4473
+
3607
4474
  /**
3608
4475
  * Filter wallets by authorization public key. Returns wallets owned by key quorums
3609
4476
  * that include the specified P-256 public key (base64-encoded DER format). Cannot
@@ -3621,6 +4488,11 @@ export interface WalletListParams extends CursorParams {
3621
4488
  */
3622
4489
  external_id?: string;
3623
4490
 
4491
+ /**
4492
+ * Include archived wallets in lookup. Defaults to false.
4493
+ */
4494
+ include_archived?: boolean;
4495
+
3624
4496
  /**
3625
4497
  * Filter wallets by user ID. Cannot be used together with authorization_key.
3626
4498
  */
@@ -3658,6 +4530,13 @@ export interface WalletExportParams {
3658
4530
  'privy-request-expiry'?: string;
3659
4531
  }
3660
4532
 
4533
+ export interface WalletGetParams {
4534
+ /**
4535
+ * Include archived wallets in lookup. Defaults to false.
4536
+ */
4537
+ include_archived?: boolean;
4538
+ }
4539
+
3661
4540
  export interface WalletRawSignParams {
3662
4541
  /**
3663
4542
  * Body param: Parameters for the `raw_sign` RPC.
@@ -3704,6 +4583,10 @@ export type WalletRpcParams =
3704
4583
  | WalletRpcParams.SparkCreateLightningInvoiceRpcInput
3705
4584
  | WalletRpcParams.SparkPayLightningInvoiceRpcInput
3706
4585
  | WalletRpcParams.SparkSignMessageWithIdentityKeyRpcInput
4586
+ | WalletRpcParams.SparkWithdrawRpcInput
4587
+ | WalletRpcParams.SparkGetWithdrawalFeeQuoteRpcInput
4588
+ | WalletRpcParams.TronSignTransactionRpcInput
4589
+ | WalletRpcParams.TronSendTransactionRpcInput
3707
4590
  | WalletRpcParams.ExportPrivateKeyRpcInput
3708
4591
  | WalletRpcParams.ExportSeedPhraseRpcInput;
3709
4592
 
@@ -3835,11 +4718,22 @@ export declare namespace WalletRpcParams {
3835
4718
  */
3836
4719
  address?: string;
3837
4720
 
4721
+ /**
4722
+ * Body param: A valid CAIP-2 chain ID (e.g. 'eip155:1').
4723
+ */
4724
+ caip2?: AppsAPI.Caip2;
4725
+
3838
4726
  /**
3839
4727
  * Body param
3840
4728
  */
3841
4729
  chain_type?: 'ethereum';
3842
4730
 
4731
+ /**
4732
+ * Body param: Options controlling signature production for personal_sign and
4733
+ * eth_signTypedData_v4.
4734
+ */
4735
+ signature_options?: SignatureOptions;
4736
+
3843
4737
  /**
3844
4738
  * Body param
3845
4739
  */
@@ -3880,11 +4774,22 @@ export declare namespace WalletRpcParams {
3880
4774
  */
3881
4775
  address?: string;
3882
4776
 
4777
+ /**
4778
+ * Body param: A valid CAIP-2 chain ID (e.g. 'eip155:1').
4779
+ */
4780
+ caip2?: AppsAPI.Caip2;
4781
+
3883
4782
  /**
3884
4783
  * Body param
3885
4784
  */
3886
4785
  chain_type?: 'ethereum';
3887
4786
 
4787
+ /**
4788
+ * Body param: Options controlling signature production for personal_sign and
4789
+ * eth_signTypedData_v4.
4790
+ */
4791
+ signature_options?: SignatureOptions;
4792
+
3888
4793
  /**
3889
4794
  * Body param
3890
4795
  */
@@ -4565,6 +5470,141 @@ export declare namespace WalletRpcParams {
4565
5470
  'privy-request-expiry'?: string;
4566
5471
  }
4567
5472
 
5473
+ export interface SparkWithdrawRpcInput {
5474
+ /**
5475
+ * Body param
5476
+ */
5477
+ method: 'withdraw';
5478
+
5479
+ /**
5480
+ * Body param: Parameters for the Spark `withdraw` RPC.
5481
+ */
5482
+ params: SparkWithdrawRpcInputParams;
5483
+
5484
+ /**
5485
+ * Body param: The Spark network.
5486
+ */
5487
+ network?: SparkNetwork;
5488
+
5489
+ /**
5490
+ * Header param: Request authorization signature. If multiple signatures are
5491
+ * required, they should be comma separated.
5492
+ */
5493
+ 'privy-authorization-signature'?: string;
5494
+
5495
+ /**
5496
+ * Header param: Idempotency keys ensure API requests are executed only once within
5497
+ * a 24-hour window.
5498
+ */
5499
+ 'privy-idempotency-key'?: string;
5500
+
5501
+ /**
5502
+ * Header param: Request expiry. Value is a Unix timestamp in milliseconds
5503
+ * representing the deadline by which the request must be processed.
5504
+ */
5505
+ 'privy-request-expiry'?: string;
5506
+ }
5507
+
5508
+ export interface SparkGetWithdrawalFeeQuoteRpcInput {
5509
+ /**
5510
+ * Body param
5511
+ */
5512
+ method: 'getWithdrawalFeeQuote';
5513
+
5514
+ /**
5515
+ * Body param: Parameters for the Spark `getWithdrawalFeeQuote` RPC.
5516
+ */
5517
+ params: SparkGetWithdrawalFeeQuoteRpcInputParams;
5518
+
5519
+ /**
5520
+ * Body param: The Spark network.
5521
+ */
5522
+ network?: SparkNetwork;
5523
+
5524
+ /**
5525
+ * Header param: Request authorization signature. If multiple signatures are
5526
+ * required, they should be comma separated.
5527
+ */
5528
+ 'privy-authorization-signature'?: string;
5529
+
5530
+ /**
5531
+ * Header param: Idempotency keys ensure API requests are executed only once within
5532
+ * a 24-hour window.
5533
+ */
5534
+ 'privy-idempotency-key'?: string;
5535
+
5536
+ /**
5537
+ * Header param: Request expiry. Value is a Unix timestamp in milliseconds
5538
+ * representing the deadline by which the request must be processed.
5539
+ */
5540
+ 'privy-request-expiry'?: string;
5541
+ }
5542
+
5543
+ export interface TronSignTransactionRpcInput {
5544
+ /**
5545
+ * Body param
5546
+ */
5547
+ method: 'tron_signTransaction';
5548
+
5549
+ /**
5550
+ * Body param: Parameters for the Tron `tron_signTransaction` RPC.
5551
+ */
5552
+ params: TronSignTransactionRpcInputParams;
5553
+
5554
+ /**
5555
+ * Header param: Request authorization signature. If multiple signatures are
5556
+ * required, they should be comma separated.
5557
+ */
5558
+ 'privy-authorization-signature'?: string;
5559
+
5560
+ /**
5561
+ * Header param: Idempotency keys ensure API requests are executed only once within
5562
+ * a 24-hour window.
5563
+ */
5564
+ 'privy-idempotency-key'?: string;
5565
+
5566
+ /**
5567
+ * Header param: Request expiry. Value is a Unix timestamp in milliseconds
5568
+ * representing the deadline by which the request must be processed.
5569
+ */
5570
+ 'privy-request-expiry'?: string;
5571
+ }
5572
+
5573
+ export interface TronSendTransactionRpcInput {
5574
+ /**
5575
+ * Body param
5576
+ */
5577
+ method: 'tron_sendTransaction';
5578
+
5579
+ /**
5580
+ * Body param: Parameters for the Tron `tron_sendTransaction` RPC.
5581
+ */
5582
+ params: TronSendTransactionRpcInputParams;
5583
+
5584
+ /**
5585
+ * Body param: A valid CAIP-2 chain ID (e.g. 'eip155:1').
5586
+ */
5587
+ caip2?: AppsAPI.Caip2;
5588
+
5589
+ /**
5590
+ * Header param: Request authorization signature. If multiple signatures are
5591
+ * required, they should be comma separated.
5592
+ */
5593
+ 'privy-authorization-signature'?: string;
5594
+
5595
+ /**
5596
+ * Header param: Idempotency keys ensure API requests are executed only once within
5597
+ * a 24-hour window.
5598
+ */
5599
+ 'privy-idempotency-key'?: string;
5600
+
5601
+ /**
5602
+ * Header param: Request expiry. Value is a Unix timestamp in milliseconds
5603
+ * representing the deadline by which the request must be processed.
5604
+ */
5605
+ 'privy-request-expiry'?: string;
5606
+ }
5607
+
4568
5608
  export interface ExportPrivateKeyRpcInput {
4569
5609
  /**
4570
5610
  * Body param
@@ -4640,12 +5680,17 @@ export declare namespace WalletRpcParams {
4640
5680
 
4641
5681
  Wallets.Balance = Balance;
4642
5682
  Wallets.Transactions = Transactions;
5683
+ Wallets.Actions = Actions;
4643
5684
 
4644
5685
  export declare namespace Wallets {
4645
5686
  export {
5687
+ type AccessListEntry as AccessListEntry,
4646
5688
  type AdditionalSignerInput as AdditionalSignerInput,
4647
5689
  type AdditionalSignerItemInput as AdditionalSignerItemInput,
4648
5690
  type Address as Address,
5691
+ type AdvancedSwapPlatformFee as AdvancedSwapPlatformFee,
5692
+ type AdvancedSwapRequestBody as AdvancedSwapRequestBody,
5693
+ type AdvancedSwapResponse as AdvancedSwapResponse,
4649
5694
  type AmountType as AmountType,
4650
5695
  type AuthorizationKeyDashboardResponse as AuthorizationKeyDashboardResponse,
4651
5696
  type AuthorizationKeyResponse as AuthorizationKeyResponse,
@@ -4658,6 +5703,9 @@ export declare namespace Wallets {
4658
5703
  type CustodialWalletProvider as CustodialWalletProvider,
4659
5704
  type CustomTokenTransferSource as CustomTokenTransferSource,
4660
5705
  type DeveloperFee as DeveloperFee,
5706
+ type EncryptedAuthorizationKey as EncryptedAuthorizationKey,
5707
+ type EncryptedBoundAuthenticateResponse as EncryptedBoundAuthenticateResponse,
5708
+ type EncryptedWalletAuthenticateResponse as EncryptedWalletAuthenticateResponse,
4661
5709
  type EthereumPersonalSignRpcInput as EthereumPersonalSignRpcInput,
4662
5710
  type EthereumPersonalSignRpcInputParams as EthereumPersonalSignRpcInputParams,
4663
5711
  type EthereumPersonalSignRpcResponse as EthereumPersonalSignRpcResponse,
@@ -4713,6 +5761,7 @@ export declare namespace Wallets {
4713
5761
  type HpkeEncryption as HpkeEncryption,
4714
5762
  type HpkeImportConfig as HpkeImportConfig,
4715
5763
  type Hex as Hex,
5764
+ type IntentBinding as IntentBinding,
4716
5765
  type NamedTokenTransferSource as NamedTokenTransferSource,
4717
5766
  type OutputWithPreviousTransactionData as OutputWithPreviousTransactionData,
4718
5767
  type PolicyInput as PolicyInput,
@@ -4722,6 +5771,7 @@ export declare namespace Wallets {
4722
5771
  type PrivateKeySubmitInput as PrivateKeySubmitInput,
4723
5772
  type PrivyFee as PrivyFee,
4724
5773
  type Quantity as Quantity,
5774
+ type RawBoundAuthenticateResponse as RawBoundAuthenticateResponse,
4725
5775
  type RawSignBytesEncoding as RawSignBytesEncoding,
4726
5776
  type RawSignBytesHashFunction as RawSignBytesHashFunction,
4727
5777
  type RawSignBytesParams as RawSignBytesParams,
@@ -4730,10 +5780,13 @@ export declare namespace Wallets {
4730
5780
  type RawSignInputParams as RawSignInputParams,
4731
5781
  type RawSignResponse as RawSignResponse,
4732
5782
  type RawSignResponseData as RawSignResponseData,
5783
+ type RawWalletAuthenticateResponse as RawWalletAuthenticateResponse,
4733
5784
  type RecipientPublicKey as RecipientPublicKey,
4734
5785
  type RelayerFee as RelayerFee,
4735
5786
  type SeedPhraseExportInput as SeedPhraseExportInput,
4736
5787
  type SeedPhraseExportResponse as SeedPhraseExportResponse,
5788
+ type SignatureOptions as SignatureOptions,
5789
+ type SignatureType as SignatureType,
4737
5790
  type SigningAlgorithm as SigningAlgorithm,
4738
5791
  type SolanaRpcInput as SolanaRpcInput,
4739
5792
  type SolanaRpcResponse as SolanaRpcResponse,
@@ -4755,9 +5808,13 @@ export declare namespace Wallets {
4755
5808
  type SparkClaimStaticDepositRpcInputParams as SparkClaimStaticDepositRpcInputParams,
4756
5809
  type SparkClaimStaticDepositRpcResponse as SparkClaimStaticDepositRpcResponse,
4757
5810
  type SparkClaimStaticDepositRpcResponseData as SparkClaimStaticDepositRpcResponseData,
5811
+ type SparkCoopExitFeeQuote as SparkCoopExitFeeQuote,
5812
+ type SparkCoopExitRequest as SparkCoopExitRequest,
4758
5813
  type SparkCreateLightningInvoiceRpcInput as SparkCreateLightningInvoiceRpcInput,
4759
5814
  type SparkCreateLightningInvoiceRpcInputParams as SparkCreateLightningInvoiceRpcInputParams,
4760
5815
  type SparkCreateLightningInvoiceRpcResponse as SparkCreateLightningInvoiceRpcResponse,
5816
+ type SparkCurrencyAmount as SparkCurrencyAmount,
5817
+ type SparkExitSpeed as SparkExitSpeed,
4761
5818
  type SparkGetBalanceRpcInput as SparkGetBalanceRpcInput,
4762
5819
  type SparkGetBalanceRpcResponse as SparkGetBalanceRpcResponse,
4763
5820
  type SparkGetClaimStaticDepositQuoteRpcInput as SparkGetClaimStaticDepositQuoteRpcInput,
@@ -4767,6 +5824,9 @@ export declare namespace Wallets {
4767
5824
  type SparkGetStaticDepositAddressRpcInput as SparkGetStaticDepositAddressRpcInput,
4768
5825
  type SparkGetStaticDepositAddressRpcResponse as SparkGetStaticDepositAddressRpcResponse,
4769
5826
  type SparkGetStaticDepositAddressRpcResponseData as SparkGetStaticDepositAddressRpcResponseData,
5827
+ type SparkGetWithdrawalFeeQuoteRpcInput as SparkGetWithdrawalFeeQuoteRpcInput,
5828
+ type SparkGetWithdrawalFeeQuoteRpcInputParams as SparkGetWithdrawalFeeQuoteRpcInputParams,
5829
+ type SparkGetWithdrawalFeeQuoteRpcResponse as SparkGetWithdrawalFeeQuoteRpcResponse,
4770
5830
  type SparkLightningFee as SparkLightningFee,
4771
5831
  type SparkLightningReceiveRequest as SparkLightningReceiveRequest,
4772
5832
  type SparkLightningSendRequest as SparkLightningSendRequest,
@@ -4794,7 +5854,11 @@ export declare namespace Wallets {
4794
5854
  type SparkTransferTokensRpcResponseData as SparkTransferTokensRpcResponseData,
4795
5855
  type SparkUserTokenMetadata as SparkUserTokenMetadata,
4796
5856
  type SparkWalletLeaf as SparkWalletLeaf,
5857
+ type SparkWithdrawRpcInput as SparkWithdrawRpcInput,
5858
+ type SparkWithdrawRpcInputParams as SparkWithdrawRpcInputParams,
5859
+ type SparkWithdrawRpcResponse as SparkWithdrawRpcResponse,
4797
5860
  type SuiCommandName as SuiCommandName,
5861
+ type SwapSubmissionStatus as SwapSubmissionStatus,
4798
5862
  type TempoAaAuthorization as TempoAaAuthorization,
4799
5863
  type TempoCall as TempoCall,
4800
5864
  type TempoFeePayerSignature as TempoFeePayerSignature,
@@ -4802,6 +5866,7 @@ export declare namespace Wallets {
4802
5866
  type TokenTransferDestination as TokenTransferDestination,
4803
5867
  type TokenTransferSource as TokenTransferSource,
4804
5868
  type TotalFeeConfigurationBps as TotalFeeConfigurationBps,
5869
+ type TransactionChainNameInput as TransactionChainNameInput,
4805
5870
  type TransactionDetail as TransactionDetail,
4806
5871
  type TransactionTokenAddressInput as TransactionTokenAddressInput,
4807
5872
  type TransferQuoteRequestBody as TransferQuoteRequestBody,
@@ -4809,6 +5874,21 @@ export declare namespace Wallets {
4809
5874
  type TransferReceivedTransactionDetail as TransferReceivedTransactionDetail,
4810
5875
  type TransferRequestBody as TransferRequestBody,
4811
5876
  type TransferSentTransactionDetail as TransferSentTransactionDetail,
5877
+ type TronContract as TronContract,
5878
+ type TronRawDataForSend as TronRawDataForSend,
5879
+ type TronRawDataForSign as TronRawDataForSign,
5880
+ type TronRpcInput as TronRpcInput,
5881
+ type TronRpcResponse as TronRpcResponse,
5882
+ type TronSendTransactionRpcInput as TronSendTransactionRpcInput,
5883
+ type TronSendTransactionRpcInputParams as TronSendTransactionRpcInputParams,
5884
+ type TronSendTransactionRpcResponse as TronSendTransactionRpcResponse,
5885
+ type TronSendTransactionRpcResponseData as TronSendTransactionRpcResponseData,
5886
+ type TronSignTransactionRpcInput as TronSignTransactionRpcInput,
5887
+ type TronSignTransactionRpcInputParams as TronSignTransactionRpcInputParams,
5888
+ type TronSignTransactionRpcResponse as TronSignTransactionRpcResponse,
5889
+ type TronSignTransactionRpcResponseData as TronSignTransactionRpcResponseData,
5890
+ type TronTransferContract as TronTransferContract,
5891
+ type TronTriggerSmartContract as TronTriggerSmartContract,
4812
5892
  type TypedDataDomainInputParams as TypedDataDomainInputParams,
4813
5893
  type TypedDataTypeFieldInput as TypedDataTypeFieldInput,
4814
5894
  type TypedDataTypesInputParams as TypedDataTypesInputParams,
@@ -4816,12 +5896,18 @@ export declare namespace Wallets {
4816
5896
  type UnsignedStandardEthereumTransaction as UnsignedStandardEthereumTransaction,
4817
5897
  type UnsignedTempoTransaction as UnsignedTempoTransaction,
4818
5898
  type UserOperationInput as UserOperationInput,
5899
+ type UserSigningKeyBinding as UserSigningKeyBinding,
4819
5900
  type Wallet as Wallet,
4820
5901
  type WalletAdditionalSigner as WalletAdditionalSigner,
4821
5902
  type WalletAdditionalSignerItem as WalletAdditionalSignerItem,
4822
5903
  type WalletAPIRegisterAuthorizationKeyInput as WalletAPIRegisterAuthorizationKeyInput,
4823
5904
  type WalletAPIRevokeAuthorizationKeyInput as WalletAPIRevokeAuthorizationKeyInput,
4824
5905
  type WalletAsset as WalletAsset,
5906
+ type WalletAssetChainNameInput as WalletAssetChainNameInput,
5907
+ type WalletAuthenticateBoundEncryptedRequestBody as WalletAuthenticateBoundEncryptedRequestBody,
5908
+ type WalletAuthenticateBoundRequestBody as WalletAuthenticateBoundRequestBody,
5909
+ type WalletAuthenticateBoundUnencryptedRequestBody as WalletAuthenticateBoundUnencryptedRequestBody,
5910
+ type WalletAuthenticateIntentsResponse as WalletAuthenticateIntentsResponse,
4825
5911
  type WalletAuthenticateRequestBody as WalletAuthenticateRequestBody,
4826
5912
  type WalletAuthenticateWithJwtResponse as WalletAuthenticateWithJwtResponse,
4827
5913
  type WalletAuthorizationHeaders as WalletAuthorizationHeaders,
@@ -4843,12 +5929,14 @@ export declare namespace Wallets {
4843
5929
  type WalletRpcRequestBody as WalletRpcRequestBody,
4844
5930
  type WalletRpcResponse as WalletRpcResponse,
4845
5931
  type WalletSolanaAsset as WalletSolanaAsset,
5932
+ type WalletTronAsset as WalletTronAsset,
4846
5933
  type WalletUpdateRequestBody as WalletUpdateRequestBody,
4847
5934
  type WalletsCursor as WalletsCursor,
4848
5935
  type WalletCreateParams as WalletCreateParams,
4849
5936
  type WalletUpdateParams as WalletUpdateParams,
4850
5937
  type WalletListParams as WalletListParams,
4851
5938
  type WalletExportParams as WalletExportParams,
5939
+ type WalletGetParams as WalletGetParams,
4852
5940
  type WalletRawSignParams as WalletRawSignParams,
4853
5941
  type WalletRpcParams as WalletRpcParams,
4854
5942
  };
@@ -4864,4 +5952,51 @@ export declare namespace Wallets {
4864
5952
  type TransactionGetResponse as TransactionGetResponse,
4865
5953
  type TransactionGetParams as TransactionGetParams,
4866
5954
  };
5955
+
5956
+ export {
5957
+ Actions as Actions,
5958
+ type AaveVaultDetails as AaveVaultDetails,
5959
+ type CustodianTransactionWalletActionStep as CustodianTransactionWalletActionStep,
5960
+ type CustodianTransactionWalletActionStepStatus as CustodianTransactionWalletActionStepStatus,
5961
+ type EvmTransactionWalletActionStep as EvmTransactionWalletActionStep,
5962
+ type EvmUserOperationEntrypointVersion as EvmUserOperationEntrypointVersion,
5963
+ type EvmUserOperationWalletActionStep as EvmUserOperationWalletActionStep,
5964
+ type EvmWalletActionStepStatus as EvmWalletActionStepStatus,
5965
+ type EarnAsset as EarnAsset,
5966
+ type EarnDepositActionResponse as EarnDepositActionResponse,
5967
+ type EarnDepositRequestBody as EarnDepositRequestBody,
5968
+ type EarnFeeCollectActionResponse as EarnFeeCollectActionResponse,
5969
+ type EarnFeeCollectRequestBody as EarnFeeCollectRequestBody,
5970
+ type EarnIncentiveClaimActionResponse as EarnIncentiveClaimActionResponse,
5971
+ type EarnIncentiveClaimRequestBody as EarnIncentiveClaimRequestBody,
5972
+ type EarnIncentiveRewardEntry as EarnIncentiveRewardEntry,
5973
+ type EarnIncentiveRewardsQuery as EarnIncentiveRewardsQuery,
5974
+ type EarnIncentiveRewardsResponse as EarnIncentiveRewardsResponse,
5975
+ type EarnIncetiveClaimRewardEntry as EarnIncetiveClaimRewardEntry,
5976
+ type EarnWithdrawActionResponse as EarnWithdrawActionResponse,
5977
+ type EarnWithdrawRequestBody as EarnWithdrawRequestBody,
5978
+ type EthereumEarnPositionQuery as EthereumEarnPositionQuery,
5979
+ type EthereumEarnPositionResponse as EthereumEarnPositionResponse,
5980
+ type EthereumEarnProvider as EthereumEarnProvider,
5981
+ type EthereumEarnVaultDetailsResponse as EthereumEarnVaultDetailsResponse,
5982
+ type ExternalTransactionWalletActionStep as ExternalTransactionWalletActionStep,
5983
+ type ExternalTransactionWalletActionStepStatus as ExternalTransactionWalletActionStepStatus,
5984
+ type FailureReason as FailureReason,
5985
+ type ListWalletActionsQuery as ListWalletActionsQuery,
5986
+ type ListWalletActionsResponse as ListWalletActionsResponse,
5987
+ type MorphoVaultDetails as MorphoVaultDetails,
5988
+ type SvmTransactionWalletActionStep as SvmTransactionWalletActionStep,
5989
+ type SvmWalletActionStepStatus as SvmWalletActionStepStatus,
5990
+ type SwapActionResponse as SwapActionResponse,
5991
+ type TvmTransactionWalletActionStep as TvmTransactionWalletActionStep,
5992
+ type TvmWalletActionStepStatus as TvmWalletActionStepStatus,
5993
+ type TransferActionResponse as TransferActionResponse,
5994
+ type VedaVaultDetails as VedaVaultDetails,
5995
+ type WalletActionInclude as WalletActionInclude,
5996
+ type WalletActionResponse as WalletActionResponse,
5997
+ type WalletActionStatus as WalletActionStatus,
5998
+ type WalletActionStep as WalletActionStep,
5999
+ type WalletActionStepType as WalletActionStepType,
6000
+ type WalletActionType as WalletActionType,
6001
+ };
4867
6002
  }