@initia/interwovenkit-react 2.11.1 → 2.12.0

package/dist/index.d.ts

@@ -164,12 +164,14 @@ export declare interface CreateTestCosmosWalletConfig {
 export declare type CreateTestWalletConfig = CreateTestWalletOptions & {
     /**
      * Wagmi connector id. Useful when running multiple test wallets.
-     * @default "testWallet"
+     * Defaults to `"testWallet"` when `addressIndex` is omitted, or
+     * `"testWallet-${addressIndex}"` when it is provided.
      */
     id?: string;
     /**
      * Display name shown in wallet selection UI.
-     * @default "Test Wallet"
+     * Defaults to `"Test Wallet"` when `addressIndex` is omitted, or
+     * `"Test Wallet ${addressIndex}"` when it is provided.
      */
     name?: string;
     /**
@@ -214,6 +216,15 @@ export declare type CreateTestWalletConfig = CreateTestWalletOptions & {
  *   mnemonic: process.env.TEST_MNEMONIC!,
  * })
  *
+ * // Derive multiple connectors from one mnemonic. Explicit indexes also
+ * // produce unique default ids and names for wagmi and wallet selection UIs.
+ * const testConnectors = Array.from({ length: 40 }, (_, addressIndex) =>
+ *   createTestWalletConnector({
+ *     mnemonic: process.env.TEST_MNEMONIC!,
+ *     addressIndex,
+ *   }),
+ * )
+ *
  * // Or from private key
  * const connector = createTestWalletConnector({
  *   privateKey: process.env.TEST_PRIVATE_KEY as `0x${string}`,
@@ -356,9 +367,15 @@ export declare type CreateTestWalletOptions = {
      * BIP-39 mnemonic phrase. Provide either `mnemonic` or `privateKey`.
      */
     mnemonic: string;
+    /**
+     * Address index in the HD path (`m/44'/60'/0'/0/${addressIndex}`).
+     * @default 0
+     */
+    addressIndex?: number;
     privateKey?: never;
 } | {
     mnemonic?: never;
+    addressIndex?: never;
     /**
      * Hex-encoded private key (with `0x` prefix).
      * Provide either `mnemonic` or `privateKey`.