@dogeos/dogeos-sdk 4.0.7 → 4.1.0-beta.1

package/dist/index.d.ts

@@ -352,6 +352,24 @@ export declare type EvmChain = Chain_2;
 
 declare type FlowId = BrandedId<"FlowId">;
 
+/** Options for `WalletConnectKitConfig.forceAccountSelection`. */
+export declare interface ForceAccountSelectionOptions {
+    /**
+     * Revoke this site's existing account permission first, so wallets that
+     * skip their picker for an approved site show it again. The permission is
+     * per site, so this also ends a main connection to the same wallet on the
+     * page; leave it off when the page has one.
+     * @default false
+     */
+    revokePermissions?: boolean;
+    /**
+     * Addresses the user has already linked. If the wallet returns one of them
+     * and supports neither permission request, the connection fails and asks
+     * the user to disconnect the site in their wallet and try again.
+     */
+    blockedAddresses?: readonly string[];
+}
+
 /**
  * Get all available chains
  * Fetches chains from backend API and returns all supported chains in config format
@@ -581,9 +599,9 @@ export declare const useWalletHost: () => UseWalletHost;
  * Uses a hidden Modal wrapper to provide required Modal context for UI components
  * but renders as inline content instead of an overlay, so it can be used as a child element
  */
-export declare const WalletConnectEmbed: ({ className, style }: WalletConnectEmbedProps) => JSX_2.Element | null;
+export declare const WalletConnectEmbed: ({ className, style, initialView, hideHeader, keepPickerAfterConnect, }: WalletConnectEmbedProps) => JSX_2.Element | null;
 
-declare interface WalletConnectEmbedProps {
+export declare interface WalletConnectEmbedProps {
     /**
      * Optional container class name
      */
@@ -592,8 +610,28 @@ declare interface WalletConnectEmbedProps {
      * Optional container style
      */
     style?: React.CSSProperties;
+    /**
+     * Picker the embed starts on and returns to. Defaults to the provider's
+     * starting view, which follows `config.login`. Ignored inside MyDoge.
+     */
+    initialView?: WalletConnectEmbedView;
+    /**
+     * Leave out the starting view's title, for pages that give the embed their
+     * own heading. Controls in that row, such as a link to the wallet list,
+     * stay. Later views keep their titles.
+     */
+    hideHeader?: boolean;
+    /**
+     * Keep showing the starting view after a wallet connects, instead of the
+     * account view. For pages that use the connection for one step, such as
+     * proving ownership of a wallet to link it.
+     */
+    keepPickerAfterConnect?: boolean;
 }
 
+/** A wallet picker `WalletConnectEmbed` can start on. */
+export declare type WalletConnectEmbedView = "walletList" | "walletSearch";
+
 export declare interface WalletConnectKitConfig {
     /**
      * Gateway origin for proof-bound product requests such as the wallet
@@ -636,6 +674,32 @@ export declare interface WalletConnectKitConfig {
      * };
      */
     defaultConnectChain?: ChainType;
+    /**
+     * Reconnect a saved connection when the page loads, and inside MyDoge
+     * reconnect silently when MyDoge already approved this dApp.
+     * Set to false for a provider that should connect only on the user's own
+     * action, such as a second provider that links another wallet.
+     * It does not cover the DogeOS sign-in: with social logins enabled, a
+     * signed-in user's Social Wallet still connects on load. Limit `login` to
+     * external wallets to keep it out.
+     * @default true
+     */
+    autoRestore?: boolean;
+    /**
+     * Save this provider's connection so a later page load can restore it.
+     * Set to false so a second provider on the page neither saves its
+     * connection nor replaces or clears the main provider's.
+     * @default true
+     */
+    persistConnection?: boolean;
+    /**
+     * Ask an EVM browser wallet to show its account picker on every connect,
+     * even for a site it already approved. Use it when the user must choose
+     * which account to link. `true` uses the defaults below.
+     * Ignored inside MyDoge and for the embedded wallet, which hold the page's
+     * main session.
+     */
+    forceAccountSelection?: boolean | ForceAccountSelectionOptions;
     /***
      * WalletConnect project ID
      * Supply your application's own project ID to enable WalletConnect.