@moon-x/react-sdk 0.11.0 → 0.12.0

package/README.md

@@ -93,7 +93,7 @@ function SignDemo() {
 | `walletChainType` | `"ethereum" \| "solana" \| "ethereum-or-solana"` | Which wallet type to create at signup. |
 | `chains` | `ChainConfigItem[]` | Unified RPC / chain config for **both** EVM and Solana. Each element is a bare viem `Chain` (use its built-in RPC), an `{ chain, rpcUrl?, wsUrl? }` EVM entry (to override the RPC), or a `{ id, rpcUrl, wsUrl? }` Solana entry. Common viem chains are re-exported by this package. See `docs/rpc-configuration.md`. |
 | `defaultChain` | `string \| number` | Which configured chain is the default. Referenced by alias, CAIP-2 id, or numeric chainId — e.g. `"eth:base"`, `"eip155:8453"`, `8453`, `"solana:mainnet"`. Defaults to the first entry in `chains`. |
-| `walletConnect.projectId` | `string` | WalletConnect v2 project ID for external-wallet flows. |
+| `walletConnect.projectId` | `string` | WalletConnect v2 project ID. When set, the connect-wallet modal offers a **WalletConnect (EVM)** option (QR) so mobile / non-injected wallets can connect using the configured/default EVM chain. |
 | `emailConfig`, `passkeyEnrollConfig`, `signMessageConfig`, `signTransactionConfig`, `sendTransactionConfig`, `exportKeyConfig` | various | Per-flow UI overrides — titles, button text, etc. |
 | `security` | `Record<string, never>` | Reserved for future per-app security knobs. The previously-configurable `assertionCacheTtlMs` was removed in Phase 4 of the presence-token gating work — every sensitive op now does a fresh WebAuthn ceremony and mints scope-bound single-use JWTs via the iframe's internal orchestrator, so there is no parent-side cache left to configure. See [Security](#security) below. |
 
@@ -125,7 +125,9 @@ function SignDemo() {
 | `useWallets()` | `{ wallets, loading }` — both Ethereum and Solana, fetched once on mount. |
 | `useCreateWallet()` | Mint a new MPC wallet. Pass `{ walletType: "ethereum" \| "solana" }`. |
 | `useImportKey()` | Two-mode: headless if you pass a key, modal-driven if you don't. |
-| `useConnectWallet()` | External-wallet flow (MetaMask, Phantom, WalletConnect) for both chains. |
+| `useConnectWallet()` | Prebuilt **connect-wallet modal**. Connects an external wallet client-side: injected EVM (EIP-6963), Solana (Wallet Standard), and EVM WalletConnect (QR, when `walletConnect.projectId` is set). Connect-only — `mode` defaults to `"connect"`; `"signIn"`/`"link"` (SIWE/SIWS authentication) are **not implemented yet** and reject rather than silently succeed. |
+| `useExternalWallets({ chain? })` | **Headless** external-wallet connection: `{ wallets, connect, disconnect, connected, status, refresh }`. Covers injected EVM + Solana Wallet Standard. For WalletConnect, use the modal or the standalone `connectWalletConnect()`. |
+| `useConnectedExternalWallets()` | The external wallets connected this session (shared app-wide) for a picker / account switcher; each exposes `signMessage`. |
 | `useAttachOAuth()` / `useDetachOAuth()` | Link / unlink an OAuth provider on an existing user. |
 
 ### Per-chain signing — `/ethereum` and `/solana` subpaths

package/dist/{base-wallet-CzJLpndu.d.mts → base-wallet-SjY7osPg.d.mts}

@@ -2,7 +2,7 @@ import { PublicWallet } from '@moon-x/core/types';
 
 interface BaseWallet {
     id: string;
-    type: "solana" | "ethereum";
+    type: "solana" | "ethereum" | "tron";
     address: string;
     isConnected: boolean;
 }

package/dist/{base-wallet-CzJLpndu.d.ts → base-wallet-SjY7osPg.d.ts}

@@ -2,7 +2,7 @@ import { PublicWallet } from '@moon-x/core/types';
 
 interface BaseWallet {
     id: string;
-    type: "solana" | "ethereum";
+    type: "solana" | "ethereum" | "tron";
     address: string;
     isConnected: boolean;
 }

package/dist/chunk-E7BPHFN5.mjs

@@ -0,0 +1,484 @@
+"use client";
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    } else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
+function _instanceof(left, right) {
+    "@swc/helpers - instanceof";
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else {
+        return left instanceof right;
+    }
+}
+function _ts_generator(thisArg, body) {
+    var f, y, t, _ = {
+        label: 0,
+        sent: function() {
+            if (t[0] & 1) throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
+    }, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype), d = Object.defineProperty;
+    return d(g, "next", {
+        value: verb(0)
+    }), d(g, "throw", {
+        value: verb(1)
+    }), d(g, "return", {
+        value: verb(2)
+    }), typeof Symbol === "function" && d(g, Symbol.iterator, {
+        value: function() {
+            return this;
+        }
+    }), g;
+    function verb(n) {
+        return function(v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while(g && (g = 0, op[0] && (_ = 0)), _)try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [
+                op[0] & 2,
+                t.value
+            ];
+            switch(op[0]){
+                case 0:
+                case 1:
+                    t = op;
+                    break;
+                case 4:
+                    _.label++;
+                    return {
+                        value: op[1],
+                        done: false
+                    };
+                case 5:
+                    _.label++;
+                    y = op[1];
+                    op = [
+                        0
+                    ];
+                    continue;
+                case 7:
+                    op = _.ops.pop();
+                    _.trys.pop();
+                    continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                        _ = 0;
+                        continue;
+                    }
+                    if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                        _.label = op[1];
+                        break;
+                    }
+                    if (op[0] === 6 && _.label < t[1]) {
+                        _.label = t[1];
+                        t = op;
+                        break;
+                    }
+                    if (t && _.label < t[2]) {
+                        _.label = t[2];
+                        _.ops.push(op);
+                        break;
+                    }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop();
+                    continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) {
+            op = [
+                6,
+                e
+            ];
+            y = 0;
+        } finally{
+            f = t = 0;
+        }
+        if (op[0] & 5) throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+}
+import { __export, dispatchSignOp, shouldShowWalletUI, useAuthSDK } from "./chunk-PCEN5CH6.mjs";
+// src/wallets/tron.ts
+var tron_exports = {};
+__export(tron_exports, {
+    useCreateWallet: function useCreateWallet1() {
+        return useCreateWallet;
+    },
+    useExportKey: function useExportKey1() {
+        return useExportKey;
+    },
+    useGetBalance: function useGetBalance1() {
+        return useGetBalance;
+    },
+    useImportKey: function useImportKey1() {
+        return useImportKey;
+    },
+    useSendTransaction: function useSendTransaction1() {
+        return useSendTransaction;
+    },
+    useSignMessage: function useSignMessage1() {
+        return useSignMessage;
+    },
+    useSignTransaction: function useSignTransaction1() {
+        return useSignTransaction;
+    },
+    useWallets: function useWallets1() {
+        return useWallets;
+    }
+});
+import { useGetBalance as useSharedTronGetBalance, useSendTransaction as useSharedTronSendTransaction, useSignMessage as useSharedTronSignMessage, useSignTransaction as useSharedTronSignTransaction } from "@moon-x/core/react/tron";
+import { resolveRpcUrl, resolveTronChainEntry } from "@moon-x/core/lib";
+import { useCreateWallet as useSharedCreateWallet, useImportKey as useSharedImportKey, useWallets as useSharedWallets } from "@moon-x/core/react";
+var useCreateWallet = function useCreateWallet(callbacks) {
+    var createWallet = useSharedCreateWallet().createWallet;
+    return {
+        createWallet: function createWallet1(options) {
+            return _async_to_generator(function() {
+                var _callbacks_onSuccess, response, error, _callbacks_onError, errorObj;
+                return _ts_generator(this, function(_state) {
+                    switch(_state.label){
+                        case 0:
+                            _state.trys.push([
+                                0,
+                                2,
+                                ,
+                                3
+                            ]);
+                            return [
+                                4,
+                                createWallet("tron", options)
+                            ];
+                        case 1:
+                            response = _state.sent();
+                            callbacks === null || callbacks === void 0 ? void 0 : (_callbacks_onSuccess = callbacks.onSuccess) === null || _callbacks_onSuccess === void 0 ? void 0 : _callbacks_onSuccess.call(callbacks, response);
+                            return [
+                                2,
+                                response
+                            ];
+                        case 2:
+                            error = _state.sent();
+                            errorObj = _instanceof(error, Error) ? error : new Error("Unknown error");
+                            callbacks === null || callbacks === void 0 ? void 0 : (_callbacks_onError = callbacks.onError) === null || _callbacks_onError === void 0 ? void 0 : _callbacks_onError.call(callbacks, errorObj);
+                            throw errorObj;
+                        case 3:
+                            return [
+                                2
+                            ];
+                    }
+                });
+            })();
+        }
+    };
+};
+var useWallets = function useWallets() {
+    var _r_error;
+    var r = useSharedWallets("tron");
+    return {
+        wallets: r.wallets,
+        loading: r.loading,
+        error: (_r_error = r.error) !== null && _r_error !== void 0 ? _r_error : void 0,
+        refetch: r.refetch
+    };
+};
+var useSignMessage = function useSignMessage() {
+    var coreSDK = useAuthSDK();
+    var shared = useSharedTronSignMessage();
+    return {
+        signMessage: function signMessage(params) {
+            return _async_to_generator(function() {
+                var _params_options, _coreSDK_config_signMessageConfig, _coreSDK_config, showWalletUI, error;
+                return _ts_generator(this, function(_state) {
+                    switch(_state.label){
+                        case 0:
+                            _state.trys.push([
+                                0,
+                                2,
+                                ,
+                                3
+                            ]);
+                            showWalletUI = shouldShowWalletUI((_params_options = params.options) === null || _params_options === void 0 ? void 0 : _params_options.uiOptions, (_coreSDK_config = coreSDK.config) === null || _coreSDK_config === void 0 ? void 0 : (_coreSDK_config_signMessageConfig = _coreSDK_config.signMessageConfig) === null || _coreSDK_config_signMessageConfig === void 0 ? void 0 : _coreSDK_config_signMessageConfig.uiConfig);
+                            return [
+                                4,
+                                dispatchSignOp({
+                                    params: params,
+                                    showWalletUI: showWalletUI,
+                                    headless: shared.signMessage,
+                                    withUI: coreSDK.signTronMessageWithUI
+                                })
+                            ];
+                        case 1:
+                            return [
+                                2,
+                                _state.sent()
+                            ];
+                        case 2:
+                            error = _state.sent();
+                            throw new Error("Sign message failed: ".concat(_instanceof(error, Error) ? error.message : "Unknown error"));
+                        case 3:
+                            return [
+                                2
+                            ];
+                    }
+                });
+            })();
+        },
+        loading: false,
+        error: void 0
+    };
+};
+var useSignTransaction = function useSignTransaction() {
+    var coreSDK = useAuthSDK();
+    var shared = useSharedTronSignTransaction();
+    return {
+        signTransaction: function signTransaction(params) {
+            return _async_to_generator(function() {
+                var _params_options, _coreSDK_config_signTransactionConfig, _coreSDK_config, showWalletUI, error;
+                return _ts_generator(this, function(_state) {
+                    switch(_state.label){
+                        case 0:
+                            _state.trys.push([
+                                0,
+                                2,
+                                ,
+                                3
+                            ]);
+                            showWalletUI = shouldShowWalletUI((_params_options = params.options) === null || _params_options === void 0 ? void 0 : _params_options.uiOptions, (_coreSDK_config = coreSDK.config) === null || _coreSDK_config === void 0 ? void 0 : (_coreSDK_config_signTransactionConfig = _coreSDK_config.signTransactionConfig) === null || _coreSDK_config_signTransactionConfig === void 0 ? void 0 : _coreSDK_config_signTransactionConfig.uiConfig);
+                            return [
+                                4,
+                                dispatchSignOp({
+                                    params: params,
+                                    showWalletUI: showWalletUI,
+                                    headless: shared.signTransaction,
+                                    withUI: coreSDK.signTronTransactionWithUI
+                                })
+                            ];
+                        case 1:
+                            return [
+                                2,
+                                _state.sent()
+                            ];
+                        case 2:
+                            error = _state.sent();
+                            throw new Error("Sign transaction failed: ".concat(_instanceof(error, Error) ? error.message : "Unknown error"));
+                        case 3:
+                            return [
+                                2
+                            ];
+                    }
+                });
+            })();
+        },
+        loading: false,
+        error: void 0
+    };
+};
+var useSendTransaction = function useSendTransaction() {
+    var coreSDK = useAuthSDK();
+    var shared = useSharedTronSendTransaction();
+    return {
+        // Sign + broadcast via the configured fullnode. With showWalletUI the
+        // sign-transaction modal previews the decoded signed bytes and the
+        // broadcast happens after the user confirms.
+        sendTransaction: function sendTransaction(params) {
+            return _async_to_generator(function() {
+                var _params_rpcUrl, _coreSDK_config, _coreSDK_config1, _params_options, _coreSDK_config_sendTransactionConfig, _coreSDK_config2, entry, rpcUrl, _params_chain, showWalletUI, error;
+                return _ts_generator(this, function(_state) {
+                    switch(_state.label){
+                        case 0:
+                            _state.trys.push([
+                                0,
+                                2,
+                                ,
+                                3
+                            ]);
+                            entry = resolveTronChainEntry((_coreSDK_config = coreSDK.config) === null || _coreSDK_config === void 0 ? void 0 : _coreSDK_config.chains, params.chain, (_coreSDK_config1 = coreSDK.config) === null || _coreSDK_config1 === void 0 ? void 0 : _coreSDK_config1.defaultChain);
+                            rpcUrl = (_params_rpcUrl = params.rpcUrl) !== null && _params_rpcUrl !== void 0 ? _params_rpcUrl : entry ? resolveRpcUrl(entry) : void 0;
+                            if (!rpcUrl) {
+                                ;
+                                throw new Error('No fullnode URL for chain "'.concat((_params_chain = params.chain) !== null && _params_chain !== void 0 ? _params_chain : "tron", '". Add a tron entry to `chains` in MoonXProvider config, or pass an `rpcUrl`.'));
+                            }
+                            showWalletUI = shouldShowWalletUI((_params_options = params.options) === null || _params_options === void 0 ? void 0 : _params_options.uiOptions, (_coreSDK_config2 = coreSDK.config) === null || _coreSDK_config2 === void 0 ? void 0 : (_coreSDK_config_sendTransactionConfig = _coreSDK_config2.sendTransactionConfig) === null || _coreSDK_config_sendTransactionConfig === void 0 ? void 0 : _coreSDK_config_sendTransactionConfig.uiConfig);
+                            return [
+                                4,
+                                dispatchSignOp({
+                                    params: {
+                                        transaction: params.transaction,
+                                        wallet: params.wallet,
+                                        rpcUrl: rpcUrl,
+                                        options: params.options
+                                    },
+                                    showWalletUI: showWalletUI,
+                                    headless: shared.sendTransaction,
+                                    withUI: coreSDK.sendTronTransactionWithUI
+                                })
+                            ];
+                        case 1:
+                            return [
+                                2,
+                                _state.sent()
+                            ];
+                        case 2:
+                            error = _state.sent();
+                            throw new Error("Send transaction failed: ".concat(_instanceof(error, Error) ? error.message : "Unknown error"));
+                        case 3:
+                            return [
+                                2
+                            ];
+                    }
+                });
+            })();
+        },
+        loading: false,
+        error: void 0
+    };
+};
+var useGetBalance = function useGetBalance() {
+    var coreSDK = useAuthSDK();
+    var shared = useSharedTronGetBalance();
+    return {
+        getBalance: function getBalance(params) {
+            return _async_to_generator(function() {
+                var _params_rpcUrl, _coreSDK_config, _coreSDK_config1, entry, rpcUrl, _params_chain, error;
+                return _ts_generator(this, function(_state) {
+                    switch(_state.label){
+                        case 0:
+                            _state.trys.push([
+                                0,
+                                2,
+                                ,
+                                3
+                            ]);
+                            entry = resolveTronChainEntry((_coreSDK_config = coreSDK.config) === null || _coreSDK_config === void 0 ? void 0 : _coreSDK_config.chains, params.chain, (_coreSDK_config1 = coreSDK.config) === null || _coreSDK_config1 === void 0 ? void 0 : _coreSDK_config1.defaultChain);
+                            rpcUrl = (_params_rpcUrl = params.rpcUrl) !== null && _params_rpcUrl !== void 0 ? _params_rpcUrl : entry ? resolveRpcUrl(entry) : void 0;
+                            if (!rpcUrl) {
+                                ;
+                                throw new Error('No fullnode URL for chain "'.concat((_params_chain = params.chain) !== null && _params_chain !== void 0 ? _params_chain : "tron", '". Add a tron entry to `chains` in MoonXProvider config, or pass an `rpcUrl`.'));
+                            }
+                            return [
+                                4,
+                                shared.getBalance({
+                                    wallet: params.wallet,
+                                    rpcUrl: rpcUrl
+                                })
+                            ];
+                        case 1:
+                            return [
+                                2,
+                                _state.sent()
+                            ];
+                        case 2:
+                            error = _state.sent();
+                            throw new Error("Get balance failed: ".concat(_instanceof(error, Error) ? error.message : "Unknown error"));
+                        case 3:
+                            return [
+                                2
+                            ];
+                    }
+                });
+            })();
+        },
+        loading: false,
+        error: void 0
+    };
+};
+var useExportKey = function useExportKey() {
+    var coreSDK = useAuthSDK();
+    return {
+        exportKey: function exportKey(param) {
+            var wallet = param.wallet;
+            return _async_to_generator(function() {
+                return _ts_generator(this, function(_state) {
+                    return [
+                        2,
+                        coreSDK.exportKey(wallet)
+                    ];
+                });
+            })();
+        }
+    };
+};
+var useImportKey = function useImportKey() {
+    var _useSharedImportKey = useSharedImportKey(), sharedImportKey = _useSharedImportKey.importKey;
+    var coreSDK = useAuthSDK();
+    return {
+        // Same two-mode contract as the ethereum/solana hooks: pass `key`
+        // for headless (delegates to the shared hook), omit it for the
+        // SDK's ImportWallet modal. Both branches return
+        // `{ wallet: PublicWallet }`; unwrap so consumers can read
+        // `wallet.public_address` directly.
+        importKey: function importKey(params) {
+            return _async_to_generator(function() {
+                var result2, result;
+                return _ts_generator(this, function(_state) {
+                    switch(_state.label){
+                        case 0:
+                            if (!((params === null || params === void 0 ? void 0 : params.key) !== void 0)) return [
+                                3,
+                                2
+                            ];
+                            return [
+                                4,
+                                sharedImportKey("tron", params.key)
+                            ];
+                        case 1:
+                            result2 = _state.sent();
+                            return [
+                                2,
+                                result2.wallet
+                            ];
+                        case 2:
+                            return [
+                                4,
+                                coreSDK.importKey("tron", void 0)
+                            ];
+                        case 3:
+                            result = _state.sent();
+                            return [
+                                2,
+                                result.wallet
+                            ];
+                    }
+                });
+            })();
+        }
+    };
+};
+export { useCreateWallet, useWallets, useSignMessage, useSignTransaction, useSendTransaction, useGetBalance, useExportKey, useImportKey, tron_exports };