@rango-dev/wallets-react 0.0.0-experimental-936229e8-20251208

package/dist/legacy/types.d.ts

@@ -0,0 +1,143 @@
+import type { Provider, ProviderMetadata, VersionedProviders } from '@rango-dev/wallets-core';
+import type { LegacyNamespaceInputForConnect, LegacyProviderInterface, LegacyNetwork as Network, LegacyEventHandler as WalletEventHandler, LegacyWalletInfo as WalletInfo, LegacyState as WalletState, LegacyWalletType as WalletType } from '@rango-dev/wallets-core/legacy';
+import type { Namespace } from '@rango-dev/wallets-core/namespaces/common';
+import type { NamespaceData } from '@rango-dev/wallets-core/store';
+import type { BlockchainMeta, SignerFactory } from 'rango-types';
+import type { PropsWithChildren } from 'react';
+import { LegacyEvents as Events } from '@rango-dev/wallets-core/legacy';
+type InstanceType = any;
+export type State = {
+    [key: string]: WalletState | undefined;
+};
+export type ConnectResult = {
+    accounts: string[] | null;
+    network: Network | null;
+    provider: InstanceType;
+};
+export type Providers = {
+    [type in WalletType]?: InstanceType;
+};
+export type ExtendedWalletInfo = WalletInfo & {
+    properties?: ProviderMetadata['properties'];
+    isHub?: boolean;
+};
+export type ProviderContext = {
+    connect(type: WalletType, namespaces?: LegacyNamespaceInputForConnect[]): Promise<ConnectResult[]>;
+    disconnect(type: WalletType, namespaces?: Namespace[]): Promise<void>;
+    disconnectAll(): Promise<PromiseSettledResult<any>[]>;
+    state(type: WalletType): WalletState & {
+        namespaces?: Map<Namespace, NamespaceData>;
+    };
+    canSwitchNetworkTo(type: WalletType, network: Network, namespace?: LegacyNamespaceInputForConnect): boolean;
+    /**
+     * `Provider` in legacy terms means injected instances by wallets into window (e.g. window.ethereum)
+     * that can be retrieved by `getInstance`.
+     *
+     * Note 1: Providers are lazy evaluated, which means you need to call `connect` (or `state`) first, then the value will be shown in object.
+     *         before doing that, it's a key (wallet name or we call it `type` to be more specific) with null value. (e.g. {metamask: null})
+     */
+    providers(): Providers;
+    getSigners(type: WalletType): Promise<SignerFactory>;
+    getWalletInfo(type: WalletType): ExtendedWalletInfo;
+    suggestAndConnect(type: WalletType, network: Network): Promise<ConnectResult>;
+    hubProvider(type: WalletType): Provider;
+};
+export type ProviderProps = PropsWithChildren<{
+    onUpdateState?: WalletEventHandler;
+    allBlockChains?: BlockchainMeta[];
+    autoConnect?: boolean;
+    providers: VersionedProviders[];
+    configs?: {
+        wallets?: (WalletType | LegacyProviderInterface | Provider)[];
+    };
+}>;
+export { Events };
+export type ProviderConnectResult = {
+    accounts: string[];
+    chainId: string;
+    derivationPath?: string;
+};
+export type GetInstanceOptions = {
+    network?: Network;
+    currentProvider: InstanceType;
+    meta: BlockchainMeta[];
+    getState: () => WalletState;
+    /**
+     * We always get the instance once and reuse it whenever we needs. By using this option
+     * We can force the library to get a new instance and replace it with the old one.
+     *
+     * Originally, we used this option for wallet connect 1 and its switching network challenge.
+     */
+    force?: boolean;
+    updateChainId: (chainId: number | string) => void;
+};
+export type GetInstance = (() => InstanceType) | ((options: GetInstanceOptions) => Promise<InstanceType>);
+export type TryGetInstance = (() => InstanceType) | ((options: Pick<GetInstanceOptions, 'force' | 'network'>) => Promise<InstanceType>);
+export type Connect = (options: {
+    instance: InstanceType;
+    network?: Network;
+    meta: BlockchainMeta[];
+}) => Promise<ProviderConnectResult | ProviderConnectResult[]>;
+export type Disconnect = (options: {
+    instance: InstanceType;
+    destroyInstance: () => void;
+}) => Promise<void>;
+type CleanupSubscribe = () => void;
+export type Subscribe = (options: {
+    instance: InstanceType;
+    state: WalletState;
+    meta: BlockchainMeta[];
+    updateChainId: (chainId: string) => void;
+    updateAccounts: (accounts: string[], chainId?: string) => void;
+    connect: (network?: Network) => void;
+    disconnect: () => void;
+}) => CleanupSubscribe | void;
+export type SwitchNetwork = (options: {
+    instance: InstanceType;
+    network: Network;
+    meta: BlockchainMeta[];
+    newInstance?: TryGetInstance;
+    getState?: () => WalletState;
+    updateChainId: (chainId: string) => void;
+}) => Promise<void>;
+export type Suggest = (options: {
+    instance: InstanceType;
+    network: Network;
+    meta: BlockchainMeta[];
+}) => Promise<void>;
+export type CanSwitchNetwork = (options: {
+    network: Network;
+    meta: BlockchainMeta[];
+    provider: InstanceType;
+}) => boolean;
+export type CanEagerConnect = (options: {
+    instance: InstanceType;
+    meta: BlockchainMeta[];
+}) => Promise<boolean>;
+export interface WalletActions {
+    connect: Connect;
+    getInstance: InstanceType;
+    disconnect?: Disconnect;
+    subscribe?: Subscribe;
+    suggest?: Suggest;
+    switchNetwork?: SwitchNetwork;
+    getSigners: (provider: InstanceType) => Promise<SignerFactory>;
+    canSwitchNetworkTo?: CanSwitchNetwork;
+    canEagerConnect?: CanEagerConnect;
+    getWalletInfo(allBlockChains: BlockchainMeta[]): WalletInfo;
+}
+export interface WalletConfig {
+    type: WalletType;
+    defaultNetwork?: Network;
+    checkInstallation?: boolean;
+    isAsyncInstance?: boolean;
+    isAsyncSwitchNetwork?: boolean;
+}
+export type WalletProviders = Map<WalletType, {
+    actions: WalletActions;
+    config: WalletConfig;
+}>;
+export type ProviderInterface = {
+    config: WalletConfig;
+} & WalletActions;
+//# sourceMappingURL=types.d.ts.map

package/dist/legacy/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/legacy/types.ts"],"names":[],"mappings":"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"}

package/dist/legacy/useAutoConnect.d.ts

@@ -0,0 +1,8 @@
+import type { ProviderProps } from './types.js';
+export declare function useAutoConnect(props: Pick<ProviderProps, 'allBlockChains' | 'autoConnect'> & {
+    /**
+     * A function to run autoConnect on instances
+     */
+    autoConnectHandler: () => void;
+}): void;
+//# sourceMappingURL=useAutoConnect.d.ts.map

package/dist/legacy/useAutoConnect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAutoConnect.d.ts","sourceRoot":"","sources":["../../src/legacy/useAutoConnect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAMhD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,gBAAgB,GAAG,aAAa,CAAC,GAAG;IAC7D;;OAEG;IACH,kBAAkB,EAAE,MAAM,IAAI,CAAC;CAChC,QAUF"}

package/dist/legacy/useLegacyProviders.d.ts

@@ -0,0 +1,7 @@
+import type { ProviderContext, ProviderProps } from './types.js';
+import type { LegacyProviderInterface } from '@rango-dev/wallets-core/legacy';
+export type LegacyProviderProps = Omit<ProviderProps, 'providers'> & {
+    providers: LegacyProviderInterface[];
+};
+export declare function useLegacyProviders(props: LegacyProviderProps): ProviderContext;
+//# sourceMappingURL=useLegacyProviders.d.ts.map

package/dist/legacy/useLegacyProviders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLegacyProviders.d.ts","sourceRoot":"","sources":["../../src/legacy/useLegacyProviders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAuB9E,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,GAAG;IACnE,SAAS,EAAE,uBAAuB,EAAE,CAAC;CACtC,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,mBAAmB,GACzB,eAAe,CAkNjB"}

package/dist/legacy/utils.d.ts

@@ -0,0 +1,3 @@
+import type { ProviderProps } from './types.js';
+export declare function shouldTryAutoConnect(props: Pick<ProviderProps, 'allBlockChains' | 'autoConnect'>): boolean;
+//# sourceMappingURL=utils.d.ts.map

package/dist/legacy/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/legacy/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,gBAAgB,GAAG,aAAa,CAAC,GAC3D,OAAO,CAET"}

package/dist/provider.d.ts

@@ -0,0 +1,5 @@
+import type { ProviderProps } from './legacy/types.js';
+import React from 'react';
+declare function Provider(props: ProviderProps): React.JSX.Element;
+export default Provider;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,iBAAS,QAAQ,CAAC,KAAK,EAAE,aAAa,qBAQrC;AAED,eAAe,QAAQ,CAAC"}

package/dist/test-utils/env.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Detecting wether our code is running in a test environment or not.
+ *
+ * Note: This is only useful when HappyDOM or jsdom has been added to test runner.
+ */
+export declare function isRunningInTestEnvironmentWithDom(): boolean;
+//# sourceMappingURL=env.d.ts.map

package/dist/test-utils/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/test-utils/env.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,iCAAiC,IAAI,OAAO,CAE3D"}

package/dist/test-utils/fixtures.d.ts

@@ -0,0 +1,14 @@
+import type { LegacyProviderInterface } from '@rango-dev/wallets-core/legacy';
+import type { BlockchainMeta, GenericSigner } from 'rango-types';
+import type { EvmTransaction } from 'rango-types/mainApi';
+export declare const legacyAddress = "0x000000000000000000000000000000000000dead";
+export declare class MockEvmSigner implements GenericSigner<EvmTransaction> {
+    signMessage(_msg: string, _address: string, _chainId: string | null): Promise<string>;
+    signAndSendTx(_tx: EvmTransaction, _address: string, _chainId: string | null): Promise<{
+        hash: string;
+        response?: any;
+    }>;
+}
+export declare const legacyProvider: LegacyProviderInterface;
+export declare const blockchainsMeta: BlockchainMeta[];
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/test-utils/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/test-utils/fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAI1D,eAAO,MAAM,aAAa,+CAA+C,CAAC;AAE1E,qBAAa,aAAc,YAAW,aAAa,CAAC,cAAc,CAAC;IAC3D,WAAW,CACf,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,GACtB,OAAO,CAAC,MAAM,CAAC;IAGZ,aAAa,CACjB,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,GACtB,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;CAK7C;AAED,eAAO,MAAM,cAAc,EAAE,uBA0C5B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAAc,EAsK3C,CAAC"}

package/dist/useProviders.d.ts

@@ -0,0 +1,4 @@
+import type { ProviderContext, ProviderProps } from './index.js';
+declare function useProviders(props: ProviderProps): ProviderContext;
+export { useProviders };
+//# sourceMappingURL=useProviders.d.ts.map

package/dist/useProviders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useProviders.d.ts","sourceRoot":"","sources":["../src/useProviders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,eAAe,EACf,aAAa,EAEd,MAAM,YAAY,CAAC;AAiBpB,iBAAS,YAAY,CAAC,KAAK,EAAE,aAAa,mBA+FzC;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/wallets-react.build.json

@@ -0,0 +1 @@
+{"inputs":{"src/hub/constants.ts":{"bytes":146,"imports":[],"format":"esm"},"src/hub/lastConnectedWallets.ts":{"bytes":5519,"imports":[{"path":"@rango-dev/wallets-core/legacy","kind":"import-statement","external":true},{"path":"src/hub/constants.ts","kind":"import-statement","original":"./constants.js"},{"path":"<runtime>","kind":"import-statement","external":true}],"format":"esm"},"src/legacy/helpers.ts":{"bytes":4652,"imports":[{"path":"@rango-dev/wallets-core/legacy","kind":"import-statement","external":true},{"path":"src/hub/constants.ts","kind":"import-statement","original":"../hub/constants.js"},{"path":"src/hub/lastConnectedWallets.ts","kind":"import-statement","original":"../hub/lastConnectedWallets.js"},{"path":"<runtime>","kind":"import-statement","external":true}],"format":"esm"},"src/legacy/context.ts":{"bytes":960,"imports":[{"path":"react","kind":"import-statement","external":true}],"format":"esm"},"src/legacy/autoConnect.ts":{"bytes":2046,"imports":[{"path":"src/hub/lastConnectedWallets.ts","kind":"import-statement","original":"../hub/lastConnectedWallets.js"},{"path":"src/legacy/mod.ts","kind":"import-statement","original":"./mod.js"},{"path":"<runtime>","kind":"import-statement","external":true}],"format":"esm"},"src/legacy/hooks.ts":{"bytes":1545,"imports":[{"path":"@rango-dev/wallets-core/legacy","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"src/legacy/context.ts","kind":"import-statement","original":"./context.js"},{"path":"<runtime>","kind":"import-statement","external":true}],"format":"esm"},"src/legacy/utils.ts":{"bytes":230,"imports":[{"path":"<runtime>","kind":"import-statement","external":true}],"format":"esm"},"src/legacy/useAutoConnect.ts":{"bytes":628,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"src/legacy/utils.ts","kind":"import-statement","original":"./utils.js"},{"path":"<runtime>","kind":"import-statement","external":true}],"format":"esm"},"src/legacy/useLegacyProviders.ts":{"bytes":7510,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"src/legacy/autoConnect.ts","kind":"import-statement","original":"./autoConnect.js"},{"path":"src/legacy/helpers.ts","kind":"import-statement","original":"./helpers.js"},{"path":"src/legacy/hooks.ts","kind":"import-statement","original":"./hooks.js"},{"path":"src/legacy/useAutoConnect.ts","kind":"import-statement","original":"./useAutoConnect.js"},{"path":"<runtime>","kind":"import-statement","external":true}],"format":"esm"},"src/legacy/mod.ts":{"bytes":321,"imports":[{"path":"src/hub/constants.ts","kind":"import-statement","original":"../hub/constants.js"},{"path":"src/legacy/context.ts","kind":"import-statement","original":"./context.js"},{"path":"src/legacy/useLegacyProviders.ts","kind":"import-statement","original":"./useLegacyProviders.js"}],"format":"esm"},"src/hub/helpers.ts":{"bytes":5339,"imports":[{"path":"@rango-dev/wallets-core/legacy","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/namespaces/cosmos","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/namespaces/tron","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/namespaces/utxo","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/utils","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-shared","kind":"import-statement","external":true},{"path":"ts-results","kind":"import-statement","external":true},{"path":"<runtime>","kind":"import-statement","external":true}],"format":"esm"},"src/hub/utils.ts":{"bytes":11267,"imports":[{"path":"@rango-dev/wallets-core/legacy","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/utils","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/utils","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-shared","kind":"import-statement","external":true},{"path":"rango-types","kind":"import-statement","external":true},{"path":"src/legacy/mod.ts","kind":"import-statement","original":"../legacy/mod.js"},{"path":"src/hub/helpers.ts","kind":"import-statement","original":"./helpers.js"},{"path":"src/hub/lastConnectedWallets.ts","kind":"import-statement","original":"./lastConnectedWallets.js"},{"path":"<runtime>","kind":"import-statement","external":true}],"format":"esm"},"src/hub/autoConnect.ts":{"bytes":9242,"imports":[{"path":"@rango-dev/wallets-core","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/legacy","kind":"import-statement","external":true},{"path":"rango-types","kind":"import-statement","external":true},{"path":"ts-results","kind":"import-statement","external":true},{"path":"src/legacy/mod.ts","kind":"import-statement","original":"../legacy/mod.js"},{"path":"src/hub/helpers.ts","kind":"import-statement","original":"./helpers.js"},{"path":"src/hub/lastConnectedWallets.ts","kind":"import-statement","original":"./lastConnectedWallets.js"},{"path":"src/hub/utils.ts","kind":"import-statement","original":"./utils.js"},{"path":"<runtime>","kind":"import-statement","external":true}],"format":"esm"},"src/hub/useHubRefs.ts":{"bytes":1271,"imports":[{"path":"@rango-dev/wallets-core","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"src/hub/utils.ts","kind":"import-statement","original":"./utils.js"},{"path":"<runtime>","kind":"import-statement","external":true}],"format":"esm"},"src/hub/useHubAdapter.ts":{"bytes":17100,"imports":[{"path":"@rango-dev/wallets-core/namespaces/evm","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-shared","kind":"import-statement","external":true},{"path":"rango-types","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"ts-results","kind":"import-statement","external":true},{"path":"src/legacy/mod.ts","kind":"import-statement","original":"../legacy/mod.js"},{"path":"src/legacy/useAutoConnect.ts","kind":"import-statement","original":"../legacy/useAutoConnect.js"},{"path":"src/hub/autoConnect.ts","kind":"import-statement","original":"./autoConnect.js"},{"path":"src/hub/helpers.ts","kind":"import-statement","original":"./helpers.js"},{"path":"src/hub/lastConnectedWallets.ts","kind":"import-statement","original":"./lastConnectedWallets.js"},{"path":"src/hub/useHubRefs.ts","kind":"import-statement","original":"./useHubRefs.js"},{"path":"src/hub/utils.ts","kind":"import-statement","original":"./utils.js"},{"path":"<runtime>","kind":"import-statement","external":true}],"format":"esm"},"src/hub/mod.ts":{"bytes":162,"imports":[{"path":"src/hub/utils.ts","kind":"import-statement","original":"./utils.js"},{"path":"src/hub/useHubAdapter.ts","kind":"import-statement","original":"./useHubAdapter.js"}],"format":"esm"},"src/useProviders.ts":{"bytes":3661,"imports":[{"path":"src/hub/mod.ts","kind":"import-statement","original":"./hub/mod.js"},{"path":"src/legacy/mod.ts","kind":"import-statement","original":"./legacy/mod.js"},{"path":"<runtime>","kind":"import-statement","external":true}],"format":"esm"},"src/provider.tsx":{"bytes":405,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"src/legacy/context.ts","kind":"import-statement","original":"./legacy/context.js"},{"path":"src/useProviders.ts","kind":"import-statement","original":"./useProviders.js"},{"path":"<runtime>","kind":"import-statement","external":true}],"format":"esm"},"src/legacy/types.ts":{"bytes":5763,"imports":[{"path":"@rango-dev/wallets-core/legacy","kind":"import-statement","external":true}],"format":"esm"},"src/index.ts":{"bytes":173,"imports":[{"path":"src/legacy/helpers.ts","kind":"import-statement","original":"./legacy/helpers.js"},{"path":"src/provider.tsx","kind":"import-statement","original":"./provider.js"},{"path":"src/legacy/hooks.ts","kind":"import-statement","original":"./legacy/hooks.js"},{"path":"src/legacy/types.ts","kind":"import-statement","original":"./legacy/types.js"}],"format":"esm"},"src/helpers/index.ts":{"bytes":55,"imports":[{"path":"src/hub/mod.ts","kind":"import-statement","original":"../hub/mod.js"}],"format":"esm"}},"outputs":{"dist/index.js.map":{"imports":[],"exports":[],"inputs":{},"bytes":115562},"dist/index.js":{"imports":[{"path":"@rango-dev/wallets-core/legacy","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/legacy","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/legacy","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/utils","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/utils","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-shared","kind":"import-statement","external":true},{"path":"rango-types","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/legacy","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/legacy","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/namespaces/cosmos","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/namespaces/tron","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/namespaces/utxo","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/utils","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-shared","kind":"import-statement","external":true},{"path":"ts-results","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/namespaces/evm","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-shared","kind":"import-statement","external":true},{"path":"rango-types","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"ts-results","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/legacy","kind":"import-statement","external":true},{"path":"rango-types","kind":"import-statement","external":true},{"path":"ts-results","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/legacy","kind":"import-statement","external":true}],"exports":["Events","Provider","availableWallets","checkWalletProviders","choose","clearPersistance","connectedWallets","defaultWalletState","isAsync","makeEventHandler","needsCheckInstallation","stateReducer","tryPersistWallet","tryRemoveWalletFromPersistance","useWallets"],"entryPoint":"src/index.ts","inputs":{"src/legacy/helpers.ts":{"bytesInOutput":1407},"src/hub/constants.ts":{"bytesInOutput":65},"src/hub/lastConnectedWallets.ts":{"bytesInOutput":1311},"src/index.ts":{"bytesInOutput":0},"src/provider.tsx":{"bytesInOutput":133},"src/legacy/context.ts":{"bytesInOutput":465},"src/hub/utils.ts":{"bytesInOutput":3150},"src/legacy/mod.ts":{"bytesInOutput":0},"src/legacy/useLegacyProviders.ts":{"bytesInOutput":2214},"src/legacy/autoConnect.ts":{"bytesInOutput":395},"src/legacy/hooks.ts":{"bytesInOutput":460},"src/legacy/useAutoConnect.ts":{"bytesInOutput":197},"src/legacy/utils.ts":{"bytesInOutput":94},"src/hub/helpers.ts":{"bytesInOutput":1994},"src/hub/mod.ts":{"bytesInOutput":0},"src/hub/useHubAdapter.ts":{"bytesInOutput":6023},"src/hub/autoConnect.ts":{"bytesInOutput":2524},"src/hub/useHubRefs.ts":{"bytesInOutput":497},"src/useProviders.ts":{"bytesInOutput":1026},"src/legacy/types.ts":{"bytesInOutput":63}},"bytes":22460},"dist/helpers/index.js.map":{"imports":[],"exports":[],"inputs":{},"bytes":73180},"dist/helpers/index.js":{"imports":[{"path":"@rango-dev/wallets-core/legacy","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/utils","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/utils","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-shared","kind":"import-statement","external":true},{"path":"rango-types","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/legacy","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/legacy","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/legacy","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/legacy","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/namespaces/cosmos","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/namespaces/tron","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/namespaces/utxo","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/utils","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-shared","kind":"import-statement","external":true},{"path":"ts-results","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/namespaces/evm","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-shared","kind":"import-statement","external":true},{"path":"rango-types","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"ts-results","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core/legacy","kind":"import-statement","external":true},{"path":"rango-types","kind":"import-statement","external":true},{"path":"ts-results","kind":"import-statement","external":true},{"path":"@rango-dev/wallets-core","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true}],"exports":["getAllLegacyProviders"],"entryPoint":"src/helpers/index.ts","inputs":{"src/hub/utils.ts":{"bytesInOutput":421},"src/hub/constants.ts":{"bytesInOutput":65},"src/legacy/mod.ts":{"bytesInOutput":0},"src/legacy/context.ts":{"bytesInOutput":461},"src/legacy/useLegacyProviders.ts":{"bytesInOutput":52},"src/hub/lastConnectedWallets.ts":{"bytesInOutput":1311},"src/legacy/helpers.ts":{"bytesInOutput":59},"src/legacy/hooks.ts":{"bytesInOutput":109},"src/legacy/useAutoConnect.ts":{"bytesInOutput":48},"src/hub/helpers.ts":{"bytesInOutput":482},"src/hub/mod.ts":{"bytesInOutput":0},"src/hub/useHubAdapter.ts":{"bytesInOutput":256},"src/hub/autoConnect.ts":{"bytesInOutput":225},"src/hub/useHubRefs.ts":{"bytesInOutput":97},"src/helpers/index.ts":{"bytesInOutput":0}},"bytes":3735}}}

package/helpers/package.json

@@ -0,0 +1,8 @@
+{
+  "name": "@rango-dev/wallets-react/helpers",
+  "type": "module",
+  "main": "../dist/helpers/index.js",
+  "module": "../dist/helpers/index.js",
+  "types": "../dist/helpers/index.d.ts",
+  "sideEffects": false
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@rango-dev/wallets-react",
+  "version": "0.0.0-experimental-936229e8-20251208",
+  "license": "MIT",
+  "type": "module",
+  "source": "./src/index.ts",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./helpers": {
+      "types": "./dist/helpers/index.d.ts",
+      "default": "./dist/helpers/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "helpers"
+  ],
+  "scripts": {
+    "build": "node ../../scripts/build/command.mjs --path wallets/react --inputs src/index.ts,src/helpers/index.ts",
+    "ts-check": "tsc --declaration --emitDeclarationOnly -p ./tsconfig.json",
+    "clean": "rimraf dist",
+    "format": "prettier --write '{.,src}/**/*.{ts,tsx}'",
+    "lint": "eslint \"**/*.{ts,tsx}\"",
+    "test": "vitest",
+    "coverage": "vitest run --coverage"
+  },
+  "peerDependencies": {
+    "@types/react": "^17.0.0 || ^18.0.0",
+    "react": "^17.0.0 || ^18.0.0",
+    "react-dom": "^17.0.0 || ^18.0.0"
+  },
+  "dependencies": {
+    "@rango-dev/wallets-core": "^0.0.0-experimental-936229e8-20251208",
+    "@rango-dev/wallets-shared": "^0.0.0-experimental-936229e8-20251208",
+    "rango-types": "^0.1.89",
+    "ts-results": "^3.3.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.0.25",
+    "@types/react-dom": "^18.0.25"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/readme.md

@@ -0,0 +1,3 @@
+# @rango-dev/wallets-react
+
+React package for handling web3 wallets supported by Rango

package/src/helpers/index.ts

@@ -0,0 +1 @@
+export { getAllLegacyProviders } from '../hub/mod.js';

package/src/hub/autoConnect.ts

@@ -0,0 +1,276 @@
+import type { AllProxiedNamespaces } from './types.js';
+import type { UseAdapterParams } from './useHubAdapter.js';
+import type { Hub } from '@rango-dev/wallets-core';
+import type {
+  LegacyNamespaceInputForConnect,
+  LegacyProviderInterface,
+} from '@rango-dev/wallets-core/legacy';
+import type {
+  Accounts,
+  AccountsWithActiveChain,
+  Namespace,
+} from '@rango-dev/wallets-core/namespaces/common';
+import type { WalletType } from '@rango-dev/wallets-shared';
+
+import { Provider } from '@rango-dev/wallets-core';
+import { legacyIsEvmNamespace } from '@rango-dev/wallets-core/legacy';
+import { cosmosBlockchains } from 'rango-types';
+import { Result } from 'ts-results';
+
+import { HUB_LAST_CONNECTED_WALLETS } from '../legacy/mod.js';
+
+import { runSequentiallyWithoutFailure } from './helpers.js';
+import { LastConnectedWalletsFromStorage } from './lastConnectedWallets.js';
+import {
+  convertNamespaceNetworkToEvmChainId,
+  isCosmosNamespace,
+  isEvmNamespace,
+} from './utils.js';
+
+// Getting connected wallets from storage
+const lastConnectedWalletsFromStorage = new LastConnectedWalletsFromStorage(
+  HUB_LAST_CONNECTED_WALLETS
+);
+
+/**
+ * Run `.connect` action on some selected namespaces (passed as param) for a provider.
+ */
+async function eagerConnect(
+  type: string,
+  namespacesInput: LegacyNamespaceInputForConnect[] | undefined,
+  params: {
+    getHub: () => Hub;
+    allBlockChains: UseAdapterParams['allBlockChains'];
+  }
+) {
+  const { getHub, allBlockChains } = params;
+  const wallet = getHub().get(type);
+  if (!wallet) {
+    throw new Error(
+      `You should add ${type} to provider first then call 'connect'.`
+    );
+  }
+
+  if (!namespacesInput) {
+    throw new Error('Passing namespace to `connect` is required. ');
+  }
+
+  const targetNamespaces: [
+    LegacyNamespaceInputForConnect,
+    AllProxiedNamespaces
+  ][] = [];
+  namespacesInput.forEach((namespaceInput) => {
+    const targetNamespace: Namespace = namespaceInput.namespace;
+
+    const result = wallet.findByNamespace(targetNamespace);
+
+    if (!result) {
+      throw new Error(
+        `We couldn't find any provider matched with your request namespace. (requested namespace: ${namespaceInput.namespace})`
+      );
+    }
+
+    targetNamespaces.push([namespaceInput, result]);
+  });
+
+  const connectNamespacesPromises = targetNamespaces.map(
+    ([info, namespace]) => {
+      const evmChain = legacyIsEvmNamespace(info)
+        ? convertNamespaceNetworkToEvmChainId(info, allBlockChains || [])
+        : undefined;
+      const chain = evmChain || info.network;
+
+      return async () => {
+        let connectNamespacePromise: () => Promise<
+          Accounts | AccountsWithActiveChain
+        >;
+        if (isEvmNamespace(namespace)) {
+          connectNamespacePromise = async () => namespace.connect(chain);
+        } else if (isCosmosNamespace(namespace)) {
+          const cosmosBlockChains = cosmosBlockchains(
+            params.allBlockChains || []
+          ).filter((chain) => !!chain.chainId);
+          connectNamespacePromise = async () => {
+            return namespace.connect({
+              chainIds: cosmosBlockChains
+                .filter((chain) => chain.info && !chain.info.experimental)
+                ?.map((chain) => chain.chainId!),
+              customChainIds: cosmosBlockChains
+                .filter((chain) => chain.info?.experimental)
+                .map((chain) => chain.chainId!),
+            });
+          };
+        } else {
+          connectNamespacePromise = async () => namespace.connect();
+        }
+        try {
+          await connectNamespacePromise();
+          // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        } catch (e: any) {
+          /*
+           * Since we check for connect failures using `instanceof Error`
+           * this check is added here to make sure the thrown error always is an instance of `Error`
+           */
+          if (e instanceof Error) {
+            throw e;
+          }
+          throw new Error(e);
+        }
+      };
+    }
+  );
+
+  /**
+   * Sometimes calling methods on a instance in parallel, would cause an error in wallet.
+   * We are running a method at a time to make sure we are covering this.
+   * e.g. when we are trying to eagerConnect evm and solana on phantom at the same time, the last namespace throw an error.
+   */
+  const connectNamespacesResult = await runSequentiallyWithoutFailure(
+    connectNamespacesPromises
+  );
+
+  const failedNamespaces: LegacyNamespaceInputForConnect[] = targetNamespaces
+    .filter((_, index) => connectNamespacesResult[index].err)
+    .map((targetNamespace) => targetNamespace[0]);
+
+  if (failedNamespaces.length > 0) {
+    lastConnectedWalletsFromStorage.removeNamespacesFromWallet(
+      type,
+      failedNamespaces.map((namespace) => namespace.namespace)
+    );
+  }
+
+  const atLeastOneNamespaceConnectedSuccessfully = connectNamespacesResult.some(
+    (result) => result.ok
+  );
+  if (!atLeastOneNamespaceConnectedSuccessfully) {
+    throw new Error(`No namespace connected for ${type}`);
+  }
+  return Result.all(
+    ...connectNamespacesResult.filter((result) => result.ok)
+  ).unwrap();
+}
+
+/**
+ * Run `.canEagerConnect` action on some selected namespaces of a wallet.
+ */
+async function tryRunCanEagerConnect(
+  namespaces: LegacyNamespaceInputForConnect[],
+  wallet: Provider
+): Promise<{
+  successNamespaces: LegacyNamespaceInputForConnect[];
+  failedNamespaces: LegacyNamespaceInputForConnect[];
+}> {
+  const foundNamespaces: LegacyNamespaceInputForConnect[] = [];
+  const successNamespaces: LegacyNamespaceInputForConnect[] = [];
+  const failedNamespaces: LegacyNamespaceInputForConnect[] = [];
+  const canEagerConnectPromises: (() => Promise<boolean>)[] = [];
+
+  // 1. Try find namespace instances and create canEagerConnect promises
+  namespaces.forEach((namespace) => {
+    const namespaceInstance = wallet.findByNamespace(namespace.namespace);
+    if (namespaceInstance) {
+      foundNamespaces.push(namespace);
+      canEagerConnectPromises.push(
+        async () => await namespaceInstance.canEagerConnect()
+      );
+    } else {
+      failedNamespaces.push(namespace);
+    }
+  });
+
+  // 2. Run canEagerConnect sequentially on namespaces
+  const canEagerConnectResults = await runSequentiallyWithoutFailure(
+    canEagerConnectPromises
+  );
+
+  // 3. Separate success and failed namespaces based on canEagerConnect result
+  foundNamespaces.forEach((namespace, index) => {
+    if (canEagerConnectResults[index].ok && canEagerConnectResults[index].val) {
+      successNamespaces.push(namespace);
+    } else {
+      failedNamespaces.push(namespace);
+    }
+  });
+
+  return { successNamespaces, failedNamespaces };
+}
+
+/*
+ * Get last connected wallets and last connected namespaces for each of them from storage
+ * Then run `.connect` on each namespace if `.canEagerConnect` returns true.
+ */
+export async function autoConnect(deps: {
+  getHub: () => Hub;
+  allBlockChains: UseAdapterParams['allBlockChains'];
+  wallets?: (WalletType | LegacyProviderInterface | Provider)[];
+}): Promise<void> {
+  const { getHub, allBlockChains, wallets } = deps;
+  const lastConnectedWallets = lastConnectedWalletsFromStorage.list();
+  const walletIds = Object.keys(lastConnectedWallets);
+
+  const walletsToRemoveFromPersistence: string[] = [];
+
+  if (walletIds.length) {
+    const eagerConnectQueue: Promise<unknown>[] = [];
+
+    const configWalletNames = wallets?.map((wallet) => {
+      if (typeof wallet === 'string') {
+        return wallet;
+      }
+      if (wallet instanceof Provider) {
+        return wallet.id;
+      }
+      return wallet.config.type;
+    });
+    // Run `.connect` if `.canEagerConnect` returns `true`.
+    walletIds.forEach(async (providerName) => {
+      if (configWalletNames && !configWalletNames.includes(providerName)) {
+        console.warn(
+          'Trying to run auto connect for a wallet which is not included in config. Desired wallet:',
+          providerName
+        );
+        walletsToRemoveFromPersistence.push(providerName);
+        return;
+      }
+
+      const wallet = getHub().get(providerName);
+
+      const lastConnectedNamespaces: LegacyNamespaceInputForConnect[] =
+        lastConnectedWallets[providerName].map((namespace) => ({
+          namespace: namespace.namespace,
+          network: namespace.network,
+        }));
+
+      if (!lastConnectedNamespaces.length || !wallet) {
+        walletsToRemoveFromPersistence.push(providerName);
+        return;
+      }
+
+      const { successNamespaces, failedNamespaces } =
+        await tryRunCanEagerConnect(lastConnectedNamespaces, wallet);
+
+      if (!successNamespaces.length) {
+        walletsToRemoveFromPersistence.push(providerName);
+        return;
+      } else if (failedNamespaces.length) {
+        lastConnectedWalletsFromStorage.removeNamespacesFromWallet(
+          wallet.id,
+          failedNamespaces.map((namespace) => namespace.namespace)
+        );
+      }
+      eagerConnectQueue.push(
+        eagerConnect(providerName, successNamespaces, {
+          allBlockChains,
+          getHub,
+        }).catch((error) => console.warn(error))
+      );
+    });
+
+    lastConnectedWalletsFromStorage.removeWallets(
+      walletsToRemoveFromPersistence
+    );
+
+    await Promise.all(eagerConnectQueue);
+  }
+}

package/src/hub/constants.ts

@@ -0,0 +1,2 @@
+export const LEGACY_LAST_CONNECTED_WALLETS = 'last-connected-wallets';
+export const HUB_LAST_CONNECTED_WALLETS = 'hub-v1-last-connected-wallets';