@reown/appkit-core 0.0.5 → 1.0.0

package/dist/types/exports/index.d.ts

@@ -23,7 +23,7 @@ export type { AssetControllerState } from '../src/controllers/AssetController.js
 export { ThemeController } from '../src/controllers/ThemeController.js';
 export type { ThemeControllerState } from '../src/controllers/ThemeController.js';
 export { OptionsController } from '../src/controllers/OptionsController.js';
-export type { OptionsControllerState } from '../src/controllers/OptionsController.js';
+export type { OptionsControllerStatePublic as OptionsControllerState } from '../src/controllers/OptionsController.js';
 export { BlockchainApiController } from '../src/controllers/BlockchainApiController.js';
 export { PublicStateController } from '../src/controllers/PublicStateController.js';
 export type { PublicStateControllerState } from '../src/controllers/PublicStateController.js';

package/dist/types/exports/react.d.ts

@@ -1,6 +1,6 @@
-export declare function useWeb3ModalNetwork(): {
+export declare function useAppKitNetwork(): {
     caipNetwork: {
-        readonly id: `solana:${string}` | `solana:${number}` | `polkadot:${string}` | `polkadot:${number}` | `eip155:${string}` | `eip155:${number}`;
+        readonly id: `eip155:${string}` | `eip155:${number}` | `solana:${string}` | `solana:${number}` | `polkadot:${string}` | `polkadot:${number}`;
         readonly chainId: import("@reown/appkit-common").ChainId;
         readonly chainNamespace: import("@reown/appkit-common").ChainNamespace;
         readonly name: string;
@@ -12,7 +12,7 @@ export declare function useWeb3ModalNetwork(): {
     } | undefined;
     chainId: import("@reown/appkit-common").ChainId | undefined;
 };
-export declare function useWeb3ModalAccount(): {
+export declare function useAppKitAccount(): {
     address: string | undefined;
     isConnected: boolean;
     status: "reconnecting" | "connected" | "disconnected" | "connecting" | undefined;

package/dist/types/src/controllers/AccountController.d.ts

@@ -35,7 +35,7 @@ export declare const AccountController: {
     setIsConnected(isConnected: AccountControllerState['isConnected'], chain: ChainNamespace | undefined): void;
     setStatus(status: AccountControllerState['status'], chain: ChainNamespace | undefined): void;
     getChainIsConnected(chain: ChainNamespace | undefined): boolean | undefined;
-    getCaipAddress(chain: ChainNamespace | undefined): `solana:${string}:${string}` | `solana:${number}:${string}` | `polkadot:${string}:${string}` | `polkadot:${number}:${string}` | `eip155:${string}:${string}` | `eip155:${number}:${string}` | undefined;
+    getCaipAddress(chain: ChainNamespace | undefined): `eip155:${string}:${string}` | `eip155:${number}:${string}` | `solana:${string}:${string}` | `solana:${number}:${string}` | `polkadot:${string}:${string}` | `polkadot:${number}:${string}` | undefined;
     setProvider(provider: AccountControllerState['provider'], chain: ChainNamespace | undefined): void;
     setCaipAddress(caipAddress: AccountControllerState['caipAddress'], chain: ChainNamespace | undefined): void;
     setBalance(balance: AccountControllerState['balance'], balanceSymbol: AccountControllerState['balanceSymbol'], chain: ChainNamespace): void;

package/dist/types/src/controllers/ChainController.d.ts

@@ -11,7 +11,7 @@ export interface ChainControllerState {
     universalAdapter: Pick<ChainAdapter, 'networkControllerClient' | 'connectionControllerClient'>;
     noAdapters: boolean;
 }
-type ChainsInitializerAdapter = Pick<ChainAdapter, 'connectionControllerClient' | 'networkControllerClient' | 'defaultNetwork' | 'chainNamespace' | 'adapterType'>;
+type ChainsInitializerAdapter = Pick<ChainAdapter, 'connectionControllerClient' | 'networkControllerClient' | 'defaultNetwork' | 'chainNamespace' | 'adapterType' | 'caipNetworks'>;
 export declare const ChainController: {
     state: ChainControllerState;
     subscribeKey<K extends keyof ChainControllerState>(key: K, callback: (value: ChainControllerState[K]) => void): () => void;

package/dist/types/src/controllers/NetworkController.d.ts

@@ -31,7 +31,7 @@ export declare const NetworkController: {
     setSmartAccountEnabledNetworks(smartAccountEnabledNetworks: NetworkControllerState['smartAccountEnabledNetworks'], chain: ChainNamespace | undefined): void;
     getRequestedCaipNetworks(chainToFilter?: ChainNamespace): CaipNetwork[];
     switchActiveNetwork(network: NetworkControllerState['caipNetwork']): Promise<void>;
-    getApprovedCaipNetworkIds(chainToFilter?: ChainNamespace): (`solana:${string}` | `solana:${number}` | `polkadot:${string}` | `polkadot:${number}` | `eip155:${string}` | `eip155:${number}`)[] | undefined;
+    getApprovedCaipNetworkIds(chainToFilter?: ChainNamespace): (`eip155:${string}` | `eip155:${number}` | `solana:${string}` | `solana:${number}` | `polkadot:${string}` | `polkadot:${number}`)[] | undefined;
     setApprovedCaipNetworksData(chain: ChainNamespace | undefined): Promise<void>;
     checkIfSupportedNetwork(): boolean;
     checkIfSmartAccountEnabled(): boolean;

package/dist/types/src/controllers/OptionsController.d.ts

@@ -1,29 +1,111 @@
 import type { CustomWallet, Features, Metadata, ProjectId, SdkVersion, Tokens } from '../utils/TypeUtil.js';
-export interface OptionsControllerState {
-    projectId: ProjectId;
-    sdkType: 'appkit';
-    sdkVersion: SdkVersion;
+export interface OptionsControllerStatePublic {
+    /**
+     * A boolean that allows you to add or remove the "All Wallets" button on the modal
+     * @default 'SHOW'
+     * @see https://docs.walletconnect.com/appkit/react/core/options#allwallets
+     */
     allWallets?: 'SHOW' | 'HIDE' | 'ONLY_MOBILE';
+    /**
+     * The project ID for the AppKit. You can find or create your project ID in the Cloud.
+     * @see https://cloud.walletconnect.com/
+     */
+    projectId: ProjectId;
+    /**
+     * Array of wallet ids to be shown in the modal's connection view with priority. These wallets will also show up first in `All Wallets` view
+     * @default []
+     * @see https://docs.walletconnect.com/appkit/react/core/options#featuredwalletids
+     */
     featuredWalletIds?: string[];
+    /**
+     * Array of wallet ids to be shown (order is respected). Unlike `featuredWalletIds`, these wallets will be the only ones shown in `All Wallets` view and as recommended wallets.
+     * @default []
+     * @see https://docs.walletconnect.com/appkit/react/core/options#includewalletids
+     */
     includeWalletIds?: string[];
+    /**
+     * Array of wallet ids to be excluded from the wallet list in the modal.
+     * @default []
+     * @see https://docs.walletconnect.com/appkit/react/core/options#excludewalletids
+     */
     excludeWalletIds?: string[];
+    /**
+     * Array of tokens to show the user's balance of. Each key represents the chain id of the token's blockchain
+     * @default {}
+     * @see https://docs.walletconnect.com/appkit/react/core/options#tokens
+     */
     tokens?: Tokens;
+    /**
+     * Add custom wallets to the modal. CustomWallets is an array of objects, where each object contains specific information of a custom wallet.
+     * @default []
+     * @see https://docs.walletconnect.com/appkit/react/core/options#customwallets
+     *
+     */
     customWallets?: CustomWallet[];
+    /**
+     * You can add an url for the terms and conditions link.
+     * @default undefined
+     */
     termsConditionsUrl?: string;
+    /**
+     * You can add an url for the privacy policy link.
+     * @default undefined
+     */
     privacyPolicyUrl?: string;
-    isSiweEnabled?: boolean;
+    /**
+     * Set of fields that related to your project which will be used to populate the metadata of the modal.
+     * @default {}
+     */
     metadata?: Metadata;
+    /**
+     * Enable or disable the appending the AppKit to the DOM. Created for specific use cases like WebGL.
+     * @default false
+     */
     disableAppend?: boolean;
+    /**
+     * Enable or disable the all the wallet options (injected, Coinbase, QR, etc.). This is useful if you want to use only email and socials.
+     * @default true
+     */
     enableWallets?: boolean;
+    /**
+     * Enable or disable the EIP6963 feature in your AppKit.
+     * @default false
+     */
     enableEIP6963?: boolean;
+    /**
+     * Enable or disable the Coinbase wallet in your AppKit.
+     * @default true
+     */
+    enableCoinbase?: boolean;
+    /**
+     * Enable or disable the Injected wallet in your AppKit.
+     * @default true
+     */
+    enableInjected?: boolean;
+    /**
+     * Enable or disable the WalletConnect QR code in your AppKit.
+     * @default true
+     */
     enableWalletConnect?: boolean;
+    /**
+     * Features configuration object.
+     * @default { swaps: true, onramp: true, email: true, socials: ['google', 'x', 'discord', 'farcaster', 'github', 'apple', 'facebook'], history: true, analytics: true, allWallets: true }
+     * @see https://docs.walletconnect.com/appkit/react/core/options#features
+     */
+    features?: Features;
+}
+export interface OptionsControllerStateInternal {
+    sdkType: 'appkit';
+    sdkVersion: SdkVersion;
+    isSiweEnabled?: boolean;
     isUniversalProvider?: boolean;
     hasMultipleAddresses?: boolean;
-    features: Features;
 }
+type StateKey = keyof OptionsControllerStatePublic | keyof OptionsControllerStateInternal;
+type OptionsControllerState = OptionsControllerStatePublic & OptionsControllerStateInternal;
 export declare const OptionsController: {
-    state: OptionsControllerState;
-    subscribeKey<K extends keyof OptionsControllerState>(key: K, callback: (value: OptionsControllerState[K]) => void): () => void;
+    state: OptionsControllerStatePublic & OptionsControllerStateInternal;
+    subscribeKey<K extends StateKey>(key: K, callback: (value: OptionsControllerState[K]) => void): () => void;
     setOptions(options: OptionsControllerState): void;
     setFeatures(features: OptionsControllerState['features'] | undefined): void;
     setProjectId(projectId: OptionsControllerState['projectId']): void;
@@ -45,3 +127,4 @@ export declare const OptionsController: {
     setEnableWallets(enableWallets: OptionsControllerState['enableWallets']): void;
     setHasMultipleAddresses(hasMultipleAddresses: OptionsControllerState['hasMultipleAddresses']): void;
 };
+export {};

package/dist/types/src/controllers/SwapController.d.ts

@@ -63,9 +63,9 @@ export declare const SwapController: {
     getParams(): {
         networkAddress: string;
         fromAddress: string;
-        fromCaipAddress: `solana:${string}:${string}` | `solana:${number}:${string}` | `polkadot:${string}:${string}` | `polkadot:${number}:${string}` | `eip155:${string}:${string}` | `eip155:${number}:${string}` | undefined;
-        sourceTokenAddress: `solana:${string}:${string}` | `solana:${number}:${string}` | `polkadot:${string}:${string}` | `polkadot:${number}:${string}` | `eip155:${string}:${string}` | `eip155:${number}:${string}` | undefined;
-        toTokenAddress: `solana:${string}:${string}` | `solana:${number}:${string}` | `polkadot:${string}:${string}` | `polkadot:${number}:${string}` | `eip155:${string}:${string}` | `eip155:${number}:${string}` | undefined;
+        fromCaipAddress: `eip155:${string}:${string}` | `eip155:${number}:${string}` | `solana:${string}:${string}` | `solana:${number}:${string}` | `polkadot:${string}:${string}` | `polkadot:${number}:${string}` | undefined;
+        sourceTokenAddress: `eip155:${string}:${string}` | `eip155:${number}:${string}` | `solana:${string}:${string}` | `solana:${number}:${string}` | `polkadot:${string}:${string}` | `polkadot:${number}:${string}` | undefined;
+        toTokenAddress: `eip155:${string}:${string}` | `eip155:${number}:${string}` | `solana:${string}:${string}` | `solana:${number}:${string}` | `polkadot:${string}:${string}` | `polkadot:${number}:${string}` | undefined;
         toTokenAmount: string;
         toTokenDecimals: number | undefined;
         sourceTokenAmount: string;

package/dist/types/src/utils/StorageUtil.d.ts

@@ -6,7 +6,7 @@ export declare const StorageUtil: {
     }): void;
     getWalletConnectDeepLink(): any;
     deleteWalletConnectDeepLink(): void;
-    setWeb3ModalRecent(wallet: WcWallet): void;
+    setAppKitRecent(wallet: WcWallet): void;
     getRecentWallets(): WcWallet[];
     setConnectedConnector(connectorType: ConnectorType): void;
     getConnectedConnector(): ConnectorType | undefined;

package/dist/types/src/utils/TypeUtil.d.ts

@@ -665,6 +665,7 @@ export type ChainAdapter = {
     chainNamespace: ChainNamespace;
     isUniversalAdapterClient?: boolean;
     adapterType?: AdapterType;
+    caipNetworks: CaipNetwork[];
     getAddress?: () => string | undefined;
     getError?: () => unknown;
     getChainId?: () => number | string | undefined;
@@ -724,7 +725,7 @@ export type Features = {
      * @description Enable or disable the socials feature. Enabled by default.
      * @type {FeaturesSocials[]}
      */
-    socials?: FeaturesSocials[];
+    socials?: FeaturesSocials[] | false;
     /**
      * @description Enable or disable the history feature. Enabled by default.
      * @type {boolean}

package/dist/types/tests/mocks/SwapController.d.ts

@@ -2,7 +2,7 @@ export declare const tokensResponse: {
     tokens: {
         name: string;
         symbol: string;
-        address: `solana:${string}:${string}` | `solana:${number}:${string}` | `polkadot:${string}:${string}` | `polkadot:${number}:${string}` | `eip155:${string}:${string}` | `eip155:${number}:${string}`;
+        address: `eip155:${string}:${string}` | `eip155:${number}:${string}` | `solana:${string}:${string}` | `solana:${number}:${string}` | `polkadot:${string}:${string}` | `polkadot:${number}:${string}`;
         decimals: number;
         logoUri: string;
         eip2612: boolean;
@@ -57,8 +57,8 @@ export declare const swapQuoteResponse: {
 };
 export declare const swapCalldataResponse: {
     tx: {
-        from: `solana:${string}:${string}` | `solana:${number}:${string}` | `polkadot:${string}:${string}` | `polkadot:${number}:${string}` | `eip155:${string}:${string}` | `eip155:${number}:${string}`;
-        to: `solana:${string}:${string}` | `solana:${number}:${string}` | `polkadot:${string}:${string}` | `polkadot:${number}:${string}` | `eip155:${string}:${string}` | `eip155:${number}:${string}`;
+        from: `eip155:${string}:${string}` | `eip155:${number}:${string}` | `solana:${string}:${string}` | `solana:${number}:${string}` | `polkadot:${string}:${string}` | `polkadot:${number}:${string}`;
+        to: `eip155:${string}:${string}` | `eip155:${number}:${string}` | `solana:${string}:${string}` | `solana:${number}:${string}` | `polkadot:${string}:${string}` | `polkadot:${number}:${string}`;
         data: `0x${string}`;
         amount: string;
         eip155: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reown/appkit-core",
-  "version": "0.0.5",
+  "version": "1.0.0",
   "type": "module",
   "main": "./dist/esm/exports/index.js",
   "types": "./dist/types/exports/index.d.ts",
@@ -23,23 +23,23 @@
   "dependencies": {
     "@walletconnect/universal-provider": "2.16.1",
     "valtio": "1.11.2",
-    "@reown/appkit-common": "0.0.5",
-    "@reown/appkit-wallet": "0.0.5"
+    "@reown/appkit-common": "1.0.0",
+    "@reown/appkit-wallet": "1.0.0"
   },
   "devDependencies": {
     "vitest": "2.0.5",
     "@vitest/coverage-v8": "2.0.5",
     "viem": "2.21.4"
   },
-  "author": "reown <reown.com>",
+  "author": "Reown <support@reown.com> (https://reown.com)",
   "license": "Apache-2.0",
-  "homepage": "https://github.com/web3modal/web3modal",
+  "homepage": "https://github.com/reown-com/appkit",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/WalletConnect/shadow-appkit.git"
   },
   "bugs": {
-    "url": "https://github.com/web3modal/web3modal/issues"
+    "url": "https://github.com/reown-com/appkit/issues"
   },
   "scripts": {
     "build:clean": "rm -rf dist",

package/readme.md

@@ -1,10 +1,10 @@
-#### 📚 [Documentation](https://docs.walletconnect.com/2.0/web3modal/about)
+#### 📚 [Documentation](https://docs.walletconnect.com/2.0/appkit/about)
 
-#### 🔗 [Website](https://web3modal.com)
+#### 🔗 [Website](https://reown.com/appkit)
 
-# Web3Modal
+# AppKit
 
-Your on-ramp to web3 multichain. Web3Modal is a versatile library that makes it super easy to connect users with your Dapp and start interacting with the blockchain.
+Your on-ramp to web3 multichain. AppKit is a versatile library that makes it super easy to connect users with your Dapp and start interacting with the blockchain.
 
 <p align="center">
   <img src="./.github/assets/header.png" alt="" border="0">