@talken/talkenkit 2.7.5-beta.2 → 2.7.5-beta.4

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 (176) hide show
  1. package/README.md +287 -0
  2. package/dist/AbcCredentialManager-6FBGTSSM.js +7 -0
  3. package/dist/abcWallet-6BIO6Q6T.js +184 -0
  4. package/dist/abcWallet-LKCI4CKL.js +184 -0
  5. package/dist/chunk-AUHDS56C.js +7852 -0
  6. package/dist/chunk-PZ4TCLAJ.js +7816 -0
  7. package/dist/chunk-SUYKWM5G.js +451 -0
  8. package/dist/components/ConfirmationModal/NonEvmSignConfirmationModal.d.ts +1 -1
  9. package/dist/components/ConfirmationModal/NonEvmTransferConfirmationModal.d.ts +1 -1
  10. package/dist/components/ConfirmationModal/SignConfirmationModal.d.ts +1 -1
  11. package/dist/components/ConfirmationModal/TransactionConfirmationModal.d.ts +2 -1
  12. package/dist/components/ConfirmationModal/constants.d.ts +0 -4
  13. package/dist/components/RainbowKitProvider/RainbowKitProvider.d.ts +31 -1
  14. package/dist/components/TransactionResultModal/TransactionResultModal.css.d.ts +3 -0
  15. package/dist/components/TransactionResultModal/TransactionResultModal.d.ts +1 -1
  16. package/dist/config/networks.d.ts +2 -1
  17. package/dist/gasless/GaslessConfigSingleton.d.ts +11 -0
  18. package/dist/gasless/api/ChainConfigApi.d.ts +20 -0
  19. package/dist/gasless/api/RelayerApi.d.ts +25 -0
  20. package/dist/gasless/api/TokenCapabilityApi.d.ts +12 -0
  21. package/dist/gasless/config.d.ts +12 -0
  22. package/dist/gasless/hooks/useGaslessTransfer.d.ts +18 -0
  23. package/dist/gasless/index.d.ts +12 -0
  24. package/dist/gasless/services/Eip7702Service.d.ts +80 -0
  25. package/dist/gasless/services/GaslessFeeService.d.ts +55 -0
  26. package/dist/gasless/services/GaslessTransferService.d.ts +61 -0
  27. package/dist/gasless/services/PermitSignService.d.ts +28 -0
  28. package/dist/gasless/signer/AbcWaasSigner.d.ts +27 -0
  29. package/dist/gasless/signer/GaslessSigner.d.ts +43 -0
  30. package/dist/gasless/signer/WagmiSigner.d.ts +63 -0
  31. package/dist/gasless/signer/index.d.ts +4 -0
  32. package/dist/gasless/types.d.ts +298 -0
  33. package/dist/gasless/utils/delegationGuard.d.ts +50 -0
  34. package/dist/gasless/utils/feeTokenResolver.d.ts +35 -0
  35. package/dist/gasless/utils/revokeDelegation.d.ts +55 -0
  36. package/dist/gasless/utils/transferDetector.d.ts +20 -0
  37. package/dist/hooks/internal/abcEmbeddedWallet.d.ts +1 -1
  38. package/dist/hooks/useMultiChainBalances.d.ts +1 -1
  39. package/dist/hooks/useXrplWallet.d.ts +79 -0
  40. package/dist/index.css +1348 -1344
  41. package/dist/index.d.ts +7 -2
  42. package/dist/index.js +2840 -1990
  43. package/dist/providers/AbcAuthProvider.d.ts +2 -1
  44. package/dist/providers/SignConfirmationProvider/SignConfirmationProvider.d.ts +1 -1
  45. package/dist/providers/SignConfirmationProvider/index.d.ts +1 -1
  46. package/dist/providers/SignConfirmationProvider/types.d.ts +14 -1
  47. package/dist/providers/SignConfirmationProvider/useTransactionResolver.d.ts +2 -1
  48. package/dist/providers/TransactionResultProvider/types.d.ts +7 -1
  49. package/dist/wallets/walletConnectors/abcWallet/AbcCredentialManager.d.ts +2 -0
  50. package/dist/wallets/walletConnectors/abcWallet/AbcCredentialManager.js +3 -3
  51. package/dist/wallets/walletConnectors/abcWallet/AbcEvmAutoConnector.js +4 -4
  52. package/dist/wallets/walletConnectors/abcWallet/AbstractChainProvider.d.ts +5 -0
  53. package/dist/wallets/walletConnectors/abcWallet/AbstractChainProvider.js +2 -2
  54. package/dist/wallets/walletConnectors/abcWallet/ProviderError.d.ts +3 -0
  55. package/dist/wallets/walletConnectors/abcWallet/ProviderError.js +5 -3
  56. package/dist/wallets/walletConnectors/abcWallet/StorageService.js +2 -2
  57. package/dist/wallets/walletConnectors/abcWallet/abcBitcoinConnector.js +6 -6
  58. package/dist/wallets/walletConnectors/abcWallet/abcBitcoinProvider.js +6 -6
  59. package/dist/wallets/walletConnectors/abcWallet/abcConnector.js +19 -18
  60. package/dist/wallets/walletConnectors/abcWallet/abcProvider.d.ts +16 -0
  61. package/dist/wallets/walletConnectors/abcWallet/abcProvider.js +8 -8
  62. package/dist/wallets/walletConnectors/abcWallet/abcSolanaProvider.js +19 -18
  63. package/dist/wallets/walletConnectors/abcWallet/abcSolanaWalletAdapter.js +3 -3
  64. package/dist/wallets/walletConnectors/abcWallet/abcTronProvider.js +6 -6
  65. package/dist/wallets/walletConnectors/abcWallet/abcWallet.js +20 -19
  66. package/dist/wallets/walletConnectors/abcWallet/abcXrplProvider.d.ts +103 -0
  67. package/dist/wallets/walletConnectors/abcWallet/abcXrplProvider.js +19 -0
  68. package/dist/wallets/walletConnectors/abcWallet/api/ConfigApi.js +2 -2
  69. package/dist/wallets/walletConnectors/abcWallet/api/TalkenApiClient.d.ts +3 -0
  70. package/dist/wallets/walletConnectors/abcWallet/api/TalkenApiClient.js +13 -12
  71. package/dist/wallets/walletConnectors/abcWallet/api/TokenApi.js +2 -2
  72. package/dist/wallets/walletConnectors/abcWallet/api/WalletscanApi.js +3 -3
  73. package/dist/wallets/walletConnectors/abcWallet/api/index.js +18 -17
  74. package/dist/wallets/walletConnectors/abcWallet/api/modules/auth.js +3 -3
  75. package/dist/wallets/walletConnectors/abcWallet/api/modules/bitcoin.js +5 -5
  76. package/dist/wallets/walletConnectors/abcWallet/api/modules/evm.js +4 -4
  77. package/dist/wallets/walletConnectors/abcWallet/api/modules/solana.js +2 -2
  78. package/dist/wallets/walletConnectors/abcWallet/api/modules/tron.js +2 -2
  79. package/dist/wallets/walletConnectors/abcWallet/api/modules/wallet.d.ts +1 -1
  80. package/dist/wallets/walletConnectors/abcWallet/api/modules/wallet.js +2 -2
  81. package/dist/wallets/walletConnectors/abcWallet/api/modules/walletscan.js +2 -2
  82. package/dist/wallets/walletConnectors/abcWallet/api/modules/xrp.d.ts +90 -0
  83. package/dist/wallets/walletConnectors/abcWallet/api/modules/xrp.js +8 -0
  84. package/dist/wallets/walletConnectors/abcWallet/constants.d.ts +9 -0
  85. package/dist/wallets/walletConnectors/abcWallet/constants.js +1 -1
  86. package/dist/wallets/walletConnectors/abcWallet/index.d.ts +5 -0
  87. package/dist/wallets/walletConnectors/abcWallet/index.js +47 -32
  88. package/dist/wallets/walletConnectors/abcWallet/networkConfig.d.ts +31 -3
  89. package/dist/wallets/walletConnectors/abcWallet/networkConfig.js +11 -3
  90. package/dist/wallets/walletConnectors/abcWallet/sessionUtils.js +3 -3
  91. package/dist/wallets/walletConnectors/abcWallet/types/api.types.d.ts +16 -1
  92. package/dist/wallets/walletConnectors/abcWallet/types/auth.types.d.ts +3 -1
  93. package/dist/wallets/walletConnectors/abcWallet/types/config.types.d.ts +1 -0
  94. package/dist/wallets/walletConnectors/abcWallet/types/config.types.js +1 -1
  95. package/dist/wallets/walletConnectors/abcWallet/types/wallet.types.d.ts +15 -1
  96. package/dist/wallets/walletConnectors/abcWallet/types.js +1 -1
  97. package/dist/wallets/walletConnectors/abcWallet/utils.js +4 -4
  98. package/dist/wallets/walletConnectors/abcWallet/walletGeneration.d.ts +2 -1
  99. package/dist/wallets/walletConnectors/abcWallet/walletGeneration.js +6 -6
  100. package/dist/wallets/walletConnectors/berasigWallet/berasigWallet.js +2 -2
  101. package/dist/wallets/walletConnectors/bifrostWallet/bifrostWallet.js +2 -2
  102. package/dist/wallets/walletConnectors/binanceWallet/binanceWallet.js +2 -2
  103. package/dist/wallets/walletConnectors/bitgetWallet/bitgetWallet.js +2 -2
  104. package/dist/wallets/walletConnectors/bybitWallet/bybitWallet.js +2 -2
  105. package/dist/wallets/walletConnectors/chunk-2LH53QET.js +71 -0
  106. package/dist/wallets/walletConnectors/chunk-2LOET2LX.js +64 -0
  107. package/dist/wallets/walletConnectors/chunk-2XNFYA54.js +492 -0
  108. package/dist/wallets/walletConnectors/chunk-326CQ42T.js +378 -0
  109. package/dist/wallets/walletConnectors/chunk-3F5K7F23.js +370 -0
  110. package/dist/wallets/walletConnectors/chunk-3NWM24MH.js +61 -0
  111. package/dist/wallets/walletConnectors/chunk-3Z5DO42M.js +240 -0
  112. package/dist/wallets/walletConnectors/chunk-4Y7YP4IR.js +115 -0
  113. package/dist/wallets/walletConnectors/chunk-6NCKGQS2.js +58 -0
  114. package/dist/wallets/walletConnectors/chunk-AJ2YNYCD.js +277 -0
  115. package/dist/wallets/walletConnectors/chunk-BOHX6ZNO.js +3030 -0
  116. package/dist/wallets/walletConnectors/chunk-C3HMOBQJ.js +370 -0
  117. package/dist/wallets/walletConnectors/chunk-DPQKYZHU.js +341 -0
  118. package/dist/wallets/walletConnectors/chunk-E4B4UELA.js +3030 -0
  119. package/dist/wallets/walletConnectors/chunk-EVRAPZ3L.js +3030 -0
  120. package/dist/wallets/walletConnectors/chunk-F74FF7OS.js +370 -0
  121. package/dist/wallets/walletConnectors/chunk-FNGIOKCY.js +341 -0
  122. package/dist/wallets/walletConnectors/chunk-FWX2HD26.js +30 -0
  123. package/dist/wallets/walletConnectors/chunk-ICGK5DGY.js +146 -0
  124. package/dist/wallets/walletConnectors/chunk-IGZOEVKN.js +58 -0
  125. package/dist/wallets/walletConnectors/chunk-IJJQA3AB.js +218 -0
  126. package/dist/wallets/walletConnectors/chunk-JU6AJBYS.js +20 -0
  127. package/dist/wallets/walletConnectors/chunk-KTVJLN3O.js +58 -0
  128. package/dist/wallets/walletConnectors/chunk-KXPCOVNY.js +215 -0
  129. package/dist/wallets/walletConnectors/chunk-L3EPZ4NZ.js +52 -0
  130. package/dist/wallets/walletConnectors/chunk-LQI5HRAB.js +218 -0
  131. package/dist/wallets/walletConnectors/chunk-LTN4JK3R.js +340 -0
  132. package/dist/wallets/walletConnectors/chunk-MGVZ2TUF.js +318 -0
  133. package/dist/wallets/walletConnectors/chunk-MU46EEQT.js +128 -0
  134. package/dist/wallets/walletConnectors/chunk-MY7UE4VE.js +240 -0
  135. package/dist/wallets/walletConnectors/chunk-ND2EIWHQ.js +345 -0
  136. package/dist/wallets/walletConnectors/chunk-NEMEHJ72.js +93 -0
  137. package/dist/wallets/walletConnectors/chunk-NF72HTDP.js +378 -0
  138. package/dist/wallets/walletConnectors/chunk-QI5BHIHY.js +318 -0
  139. package/dist/wallets/walletConnectors/chunk-QLPGMWGT.js +132 -0
  140. package/dist/wallets/walletConnectors/chunk-QODJUJ3A.js +370 -0
  141. package/dist/wallets/walletConnectors/chunk-SFDW4JEL.js +218 -0
  142. package/dist/wallets/walletConnectors/chunk-TBWPVX5M.js +148 -0
  143. package/dist/wallets/walletConnectors/chunk-TLRR3FFT.js +132 -0
  144. package/dist/wallets/walletConnectors/chunk-TM6YD43A.js +341 -0
  145. package/dist/wallets/walletConnectors/chunk-TYJR3KGY.js +46 -0
  146. package/dist/wallets/walletConnectors/chunk-UPQCNBIW.js +341 -0
  147. package/dist/wallets/walletConnectors/chunk-VVXSRRXI.js +189 -0
  148. package/dist/wallets/walletConnectors/chunk-WHL6MSKS.js +492 -0
  149. package/dist/wallets/walletConnectors/chunk-WZ4ZJB74.js +340 -0
  150. package/dist/wallets/walletConnectors/chunk-X3DT5G3F.js +215 -0
  151. package/dist/wallets/walletConnectors/chunk-XDNFWX2X.js +199 -0
  152. package/dist/wallets/walletConnectors/chunk-Y27URHIQ.js +58 -0
  153. package/dist/wallets/walletConnectors/chunk-YNE2UX2Z.js +137 -0
  154. package/dist/wallets/walletConnectors/chunk-YXWHHI4S.js +64 -0
  155. package/dist/wallets/walletConnectors/chunk-ZOBSRU6L.js +137 -0
  156. package/dist/wallets/walletConnectors/clvWallet/clvWallet.js +2 -2
  157. package/dist/wallets/walletConnectors/coin98Wallet/coin98Wallet.js +2 -2
  158. package/dist/wallets/walletConnectors/coreWallet/coreWallet.js +2 -2
  159. package/dist/wallets/walletConnectors/foxWallet/foxWallet.js +2 -2
  160. package/dist/wallets/walletConnectors/frontierWallet/frontierWallet.js +2 -2
  161. package/dist/wallets/walletConnectors/gateWallet/gateWallet.js +2 -2
  162. package/dist/wallets/walletConnectors/index.js +100 -99
  163. package/dist/wallets/walletConnectors/iopayWallet/iopayWallet.js +2 -2
  164. package/dist/wallets/walletConnectors/kaiaWallet/kaiaWallet.js +2 -2
  165. package/dist/wallets/walletConnectors/kaikasWallet/kaikasWallet.js +2 -2
  166. package/dist/wallets/walletConnectors/metaMaskWallet/metaMaskWallet.js +2 -2
  167. package/dist/wallets/walletConnectors/okxWallet/okxWallet.js +2 -2
  168. package/dist/wallets/walletConnectors/rainbowWallet/rainbowWallet.js +2 -2
  169. package/dist/wallets/walletConnectors/roninWallet/roninWallet.js +2 -2
  170. package/dist/wallets/walletConnectors/safepalWallet/safepalWallet.js +2 -2
  171. package/dist/wallets/walletConnectors/subWallet/subWallet.js +2 -2
  172. package/dist/wallets/walletConnectors/tokenPocketWallet/tokenPocketWallet.js +2 -2
  173. package/dist/wallets/walletConnectors/trustWallet/trustWallet.js +2 -2
  174. package/dist/wallets/walletConnectors/zealWallet/zealWallet.js +2 -2
  175. package/dist/wallets/walletConnectors/zerionWallet/zerionWallet.js +2 -2
  176. package/package.json +2 -2
@@ -0,0 +1,50 @@
1
+ /**
2
+ * EIP-7702 Delegation Guard
3
+ *
4
+ * Checks for stale delegations and actively revokes them before
5
+ * starting a new relay. Prevents nonce collisions caused by a pending
6
+ * revoke tx from a previous relay.
7
+ *
8
+ * Pattern: matches Chrome Extension's ensureDelegationCleared logic.
9
+ * - Detect delegation via eth_getCode (Talken API proxy)
10
+ * - If found, send revoke type-4 tx and wait for confirmation
11
+ */
12
+ import type { GaslessConfig } from '../types';
13
+ import { type RevokeCapableClient } from './revokeDelegation';
14
+ /**
15
+ * Check if an address has an active EIP-7702 delegation.
16
+ *
17
+ * Uses Talken API `GET /wallet/code/:chainKey/:address` (eth_getCode)
18
+ * to avoid direct RPC calls and 429 rate limiting.
19
+ */
20
+ export declare function checkDelegation(chainKey: string, address: string): Promise<{
21
+ hasDelegation: boolean;
22
+ delegateAddress: string;
23
+ code: string;
24
+ }>;
25
+ /** Options for ensureDelegationCleared */
26
+ export interface EnsureDelegationClearedOptions {
27
+ /**
28
+ * External wallet client for sending the revoke tx.
29
+ * When provided, uses walletClient.signAuthorization + sendTransaction
30
+ * instead of MPC signing. Pass viem's WalletClient directly.
31
+ */
32
+ walletClient?: RevokeCapableClient;
33
+ /** Called when delegation cannot be cleared within the timeout. */
34
+ onDelegationError?: GaslessConfig['onDelegationError'];
35
+ }
36
+ /**
37
+ * Ensure no stale EIP-7702 delegation exists before starting a relay.
38
+ *
39
+ * If a delegation is detected:
40
+ * 1. Send a revoke type-4 tx (MPC or external wallet)
41
+ * 2. Poll until delegation clears or timeout
42
+ *
43
+ * Revoke path:
44
+ * - options.walletClient provided → external wallet (sendRevokeViaWalletClient)
45
+ * - otherwise → ABC WaaS MPC (sendRevokeTx)
46
+ *
47
+ * Uses a per-(chainKey, address) lock so concurrent calls for
48
+ * different wallets don't block each other.
49
+ */
50
+ export declare function ensureDelegationCleared(chainKey: string, chainId: number, address: string, options?: EnsureDelegationClearedOptions): Promise<void>;
@@ -0,0 +1,35 @@
1
+ import type { FeeToken, GaslessConfig, RuntimeChainConfig } from '../types';
2
+ /**
3
+ * Resolve available fee tokens for gasless transfer on a specific chain.
4
+ *
5
+ * Sources:
6
+ * 1. Server-provided chain config (USDT, USDC addresses)
7
+ * 2. Consumer-injected project tokens (via GaslessConfig.projectFeeTokens)
8
+ *
9
+ * No hardcoded token lists — everything comes from config.
10
+ */
11
+ export declare function resolveFeeTokensFromConfig(chainConfig: RuntimeChainConfig, chainId: number, gaslessConfig: GaslessConfig): FeeToken[];
12
+ /**
13
+ * Sort and filter fee tokens by the user's priority list.
14
+ *
15
+ * - Tokens in the priority list come first, in the specified order.
16
+ * - Tokens NOT in the priority list are excluded.
17
+ * - If no priority list is provided, all tokens are returned as-is.
18
+ */
19
+ export declare function applyFeeTokenPriority(tokens: FeeToken[], priority?: string[]): FeeToken[];
20
+ /**
21
+ * Select the default fee token for a chain.
22
+ *
23
+ * Priority:
24
+ * 1. Consumer-specified default (GaslessConfig.defaultFeeToken[chainId])
25
+ * 2. First available token in the resolved list
26
+ */
27
+ export declare function selectDefaultFeeToken(feeTokens: FeeToken[], chainId: number, gaslessConfig: GaslessConfig): FeeToken | null;
28
+ /**
29
+ * Find a fee token by symbol in the resolved list.
30
+ */
31
+ export declare function findFeeTokenBySymbol(feeTokens: FeeToken[], symbol: string): FeeToken | null;
32
+ /**
33
+ * Find a fee token by address in the resolved list.
34
+ */
35
+ export declare function findFeeTokenByAddress(feeTokens: FeeToken[], address: string): FeeToken | null;
@@ -0,0 +1,55 @@
1
+ /**
2
+ * EIP-7702 Delegation Revoke Utility
3
+ *
4
+ * Two paths for clearing delegation:
5
+ * 1. MPC (ABC WaaS): signAuthorization(ZeroAddress) → build type-4 tx → signHash(MPC) → broadcast
6
+ * 2. External wallet: walletClient.signAuthorization → walletClient.sendTransaction (type-4)
7
+ */
8
+ /**
9
+ * Send a revoke type-4 transaction to clear EIP-7702 delegation.
10
+ *
11
+ * Uses Talken API for signing (MPC) and direct RPC for broadcast.
12
+ * Requires PIN hash from AbcCredentialManager.
13
+ */
14
+ export declare function sendRevokeTx(userAddress: string, _chainKey: string, chainId: number): Promise<{
15
+ txHash: string;
16
+ }>;
17
+ /**
18
+ * Minimal interface for a wallet client capable of sending EIP-7702 revoke tx.
19
+ * Compatible with viem's WalletClient + PublicClient — pass them directly.
20
+ *
21
+ * Only sendTransaction is required. The wallet signs the unsigned
22
+ * authorization entry internally as part of the type-4 tx, resulting
23
+ * in a single user approval popup.
24
+ *
25
+ * If waitForTransactionReceipt is provided, the revoke function waits
26
+ * for on-chain confirmation before returning (same guarantee as MPC path).
27
+ */
28
+ export interface RevokeCapableClient {
29
+ sendTransaction(args: {
30
+ authorizationList: Array<{
31
+ contractAddress: `0x${string}`;
32
+ chainId?: number;
33
+ }>;
34
+ to: `0x${string}`;
35
+ value: bigint;
36
+ }): Promise<`0x${string}`>;
37
+ /** Optional: wait for tx confirmation. Pass viem publicClient.waitForTransactionReceipt. */
38
+ waitForTransactionReceipt?(args: {
39
+ hash: `0x${string}`;
40
+ }): Promise<{
41
+ status: 'success' | 'reverted';
42
+ }>;
43
+ }
44
+ /**
45
+ * Send a revoke type-4 transaction via an external wallet (MetaMask, etc.).
46
+ *
47
+ * Passes an unsigned authorization (ZeroAddress) in authorizationList.
48
+ * The wallet handles signing internally — only 1 user popup.
49
+ *
50
+ * If walletClient provides waitForTransactionReceipt, waits for on-chain
51
+ * confirmation before returning (aligned with MPC path's waitForConfirmation).
52
+ */
53
+ export declare function sendRevokeViaWalletClient(walletClient: RevokeCapableClient, chainId: number, userAddress: string): Promise<{
54
+ txHash: string;
55
+ }>;
@@ -0,0 +1,20 @@
1
+ import type { DetectedErc20Transfer } from '../types';
2
+ /**
3
+ * Decode ERC-20 transfer(address,uint256) calldata.
4
+ * Returns the decoded recipient and amount, or null if not a transfer.
5
+ */
6
+ export declare function detectErc20Transfer(data: string | undefined): DetectedErc20Transfer | null;
7
+ /**
8
+ * Check if a raw transaction object is eligible for gasless routing.
9
+ *
10
+ * Eligible when ALL of:
11
+ * - `to` is set (the ERC-20 token contract)
12
+ * - `data` is a valid ERC-20 transfer(address,uint256)
13
+ * - `value` is zero or absent (pure token transfer, no native value)
14
+ * - Decoded amount > 0
15
+ */
16
+ export declare function isGaslessEligible(tx: {
17
+ to?: string | null;
18
+ data?: string;
19
+ value?: string;
20
+ }): boolean;
@@ -23,7 +23,7 @@ export declare function hasAbcEmbeddedSession(evmConnected: boolean, connector:
23
23
  id?: string;
24
24
  } | null | undefined): boolean;
25
25
  export declare function subscribeToAbcStorageUpdates(refresh: StorageRefreshHandler): () => void;
26
- export declare function loadEmbeddedWalletFromAuthState<TKey extends 'solanaWallet' | 'bitcoinWallet' | 'tronWallet'>(walletKey: TKey): NonNullable<import("../../wallets/walletConnectors/abcWallet").AbcAuthStorageState[TKey]> | null;
26
+ export declare function loadEmbeddedWalletFromAuthState<TKey extends 'solanaWallet' | 'bitcoinWallet' | 'tronWallet' | 'xrplWallet'>(walletKey: TKey): NonNullable<import("../../wallets/walletConnectors/abcWallet").AbcAuthStorageState[TKey]> | null;
27
27
  export declare function restoreEmbeddedWalletState<TWallet extends {
28
28
  address: string;
29
29
  }, TProvider extends AbcWalletCarrier<TWallet> & AbcRequestInterceptorCarrier, TState>(params: RestoreEmbeddedWalletParams<TWallet, TProvider, TState>): Promise<TState>;
@@ -1,6 +1,6 @@
1
1
  import type { ProfileBalance } from './useProfile';
2
2
  export interface ChainAddressInfo {
3
- chainType: 'evm' | 'solana' | 'bitcoin' | 'tron';
3
+ chainType: 'evm' | 'solana' | 'bitcoin' | 'tron' | 'xrpl';
4
4
  address: string;
5
5
  network: string;
6
6
  symbol: string;
@@ -0,0 +1,79 @@
1
+ /**
2
+ * XRPL Wallet Hook
3
+ *
4
+ * Provides XRP Ledger wallet state and provider from ABC WaaS
5
+ * Auto-restores wallet from localStorage when available
6
+ * Follows useTronWallet pattern
7
+ */
8
+ import type { AbcXrplProvider } from '../wallets/walletConnectors/abcWallet/abcXrplProvider';
9
+ import type { XrplSendTransactionParams } from '../wallets/walletConnectors/abcWallet/abcXrplProvider';
10
+ export interface XrplWalletState {
11
+ /** XRP address (starts with r) */
12
+ address: string | null;
13
+ /** Public key */
14
+ publicKey: string | null;
15
+ /** Network (xrpl or xrpl_testnet) */
16
+ network: 'xrpl' | 'xrpl_testnet' | null;
17
+ /** Whether wallet is connected */
18
+ isConnected: boolean;
19
+ /** XRPL provider instance */
20
+ provider: AbcXrplProvider | null;
21
+ }
22
+ export interface UseXrplWalletReturn {
23
+ /** XRP address (starts with r) */
24
+ address: string | null;
25
+ /** Public key */
26
+ publicKey: string | null;
27
+ /** Network (xrpl or xrpl_testnet) */
28
+ network: 'xrpl' | 'xrpl_testnet' | null;
29
+ /** Whether wallet is connected */
30
+ isConnected: boolean;
31
+ /** Whether XRPL wallet is loading */
32
+ isLoading: boolean;
33
+ /** Error if any */
34
+ error: Error | null;
35
+ /** Send XRP/token transaction (requires PIN) */
36
+ sendTransaction: (params: XrplSendTransactionParams) => Promise<string>;
37
+ /** Get XRP balance */
38
+ getBalance: () => Promise<{
39
+ balance: string;
40
+ balanceXrp: string;
41
+ activated: boolean;
42
+ }>;
43
+ /** Get fungible token balances */
44
+ getFtBalances: (issuer?: string) => Promise<any[]>;
45
+ /** Estimate transfer fee */
46
+ estimateFee: (destination?: string, amount?: string) => Promise<any>;
47
+ /** Calculate max sendable amount */
48
+ prepareMax: (fee?: string) => Promise<any>;
49
+ /** Check trustline status */
50
+ getTrustlineStatus: (issuer: string, currency: string) => Promise<any>;
51
+ /** Create trustline */
52
+ createTrustline: (issuer: string, currency: string, limit?: string) => Promise<string>;
53
+ /** Validate XRP address */
54
+ validateAddress: (address: string) => Promise<boolean>;
55
+ /** Get XRP server info (reserve, fee, ledger state) */
56
+ getServerInfo: () => Promise<any>;
57
+ /** Manually refresh wallet state */
58
+ refresh: () => Promise<void>;
59
+ }
60
+ /**
61
+ * Hook to access XRPL wallet state from ABC WaaS
62
+ *
63
+ * @example
64
+ * ```tsx
65
+ * import { useXrplWallet } from '@talken/talkenkit';
66
+ *
67
+ * function MyComponent() {
68
+ * const { address, isConnected, sendTransaction } = useXrplWallet();
69
+ *
70
+ * const handleSend = async () => {
71
+ * const txHash = await sendTransaction({
72
+ * toAddress: 'rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh',
73
+ * amount: '10', // in XRP (not drops)
74
+ * });
75
+ * };
76
+ * }
77
+ * ```
78
+ */
79
+ export declare function useXrplWallet(): UseXrplWalletReturn;