@initia/interwovenkit-react 2.12.0 → 2.13.0

package/dist/index.d.ts

@@ -26,12 +26,36 @@ declare interface AssetOption {
     chainId: string;
 }
 
-declare interface AutoSignFeePolicy {
+export declare type AutoSignChainStatus = "enabled" | "disabled" | "expired" | "needs-permission-update" | "unknown";
+
+export declare interface AutoSignFeePolicy {
     gasMultiplier?: number;
     maxGasMultiplierFromSim?: number;
     allowedFeeDenoms?: string[];
 }
 
+export declare interface AutoSignGrantPolicy {
+    /** Enables this chain with the specified scope; overrides its legacy message list. */
+    authorization?: AutoSignPermissionPolicy;
+}
+
+export declare type AutoSignPermissionPolicy = GenericPermissionPolicy | MovePermissionPolicy | EvmPermissionPolicy;
+
+export declare interface AutoSignResult extends AutoSignStatusResult {
+    isLoading: boolean;
+    enable: (chainId?: string, options?: EnableAutoSignOptions) => Promise<void>;
+    disable: (chainId?: string) => Promise<void>;
+}
+
+export declare interface AutoSignStatusResult {
+    expiredAtByChain: Record<string, Date | null | undefined>;
+    feegrantByChain: Record<string, FeegrantAllowance | undefined>;
+    isEnabledByChain: Record<string, boolean>;
+    granteeByChain: Record<string, string | undefined>;
+    requestedDurationInMsByChain: Record<string, number | undefined>;
+    statusByChain: Record<string, AutoSignChainStatus>;
+}
+
 declare interface Config {
     /** Chain id the widget targets by default. */
     defaultChainId: string;
@@ -71,10 +95,14 @@ declare interface Config {
     container?: HTMLElement;
     /** Disables usage analytics. */
     disableAnalytics?: boolean;
-    /** Auto-sign opt-in: `true`, or a chain id → allowed message type URLs map. */
+    /** Legacy generic auto-sign opt-in; explicit false also disables scoped policies. */
     enableAutoSign?: boolean | Record<string, string[]>;
     /** Per-chain fee policy for auto-signed transactions. */
     autoSignFeePolicy?: Record<string, AutoSignFeePolicy>;
+    /** Per-chain authorization scopes; a configured authorization opts its chain in. */
+    autoSignGrantPolicy?: Record<string, AutoSignGrantPolicy>;
+    /** Browser storage supports Stay connected; memory disables all signer persistence. */
+    autoSignStorage?: "browser" | "memory";
     /** Cosmos wallets offered in the connect list. */
     cosmosWallets?: CosmosWallet[];
 }
@@ -195,6 +223,27 @@ export declare type CreateTestWalletConfig = CreateTestWalletOptions & {
         maxFeePerGas?: bigint;
         maxPriorityFeePerGas?: bigint;
     };
+    /**
+     * Open a blank window before every signing request and fail with the same error as
+     * popup-based wallets (Privy) when the browser blocks it. Like Privy, it then signs
+     * transactions on their own `chainId` instead of the wallet's current chain. Lets browser tests check that
+     * signing is still inside the click's user activation when the wallet is asked.
+     * `delayMs` waits that long before opening the window, which is useful as a negative
+     * control since the activation expires during the wait.
+     * @default false
+     */
+    simulatePopup?: boolean | {
+        delayMs: number;
+    };
+    /**
+     * Confirm chain switches the way extension wallets do: the page loses focus to a wallet
+     * window for `delayMs` (500 by default) before the switch takes effect. Without it the switch
+     * is instant, like Privy's.
+     * @default false
+     */
+    simulateExtension?: boolean | {
+        delayMs: number;
+    };
 };
 
 /**
@@ -387,8 +436,36 @@ export declare const DEFAULT_GAS_ADJUSTMENT = 1.4;
 
 export declare const DEFAULT_GAS_PRICE_MULTIPLIER = 1.05;
 
-declare interface EnableAutoSignOptions {
+export declare interface EnableAutoSignOptions {
     defaultDuration?: number;
+    /** Selects browser persistence when true or tab-only storage when false.
+     * Omit it to use the saved preference, which defaults to browser persistence.
+     * The provider's memory-only mode always takes precedence. */
+    stayConnected?: boolean;
+}
+
+export declare interface EvmPermissionPolicy {
+    kind: "evm";
+    contracts: string[];
+    /** Four-byte selector validation is SDK-only; chain authz only restricts targets. */
+    selectors?: string[];
+}
+
+declare interface FeegrantAllowance {
+    granter: string;
+    grantee: string;
+    allowance: {
+        "@type": string;
+        expiration?: string;
+        allowance?: {
+            "@type": string;
+            expiration?: string;
+            spend_limit?: Coin[];
+            spendLimit?: Coin[];
+        };
+        allowed_messages?: string[];
+        allowedMessages?: string[];
+    };
 }
 
 declare interface FormValues {
@@ -403,6 +480,11 @@ declare interface FormValues {
     slippagePercent: string;
 }
 
+export declare interface GenericPermissionPolicy {
+    kind: "generic";
+    messageTypes: string[];
+}
+
 export declare const initiaPrivyWallet: () => Wallet;
 
 export declare const initiaPrivyWalletConnector: CreateConnectorFn<    {
@@ -438,12 +520,22 @@ export declare class MoveError extends Error {
     constructor(message: string, originalError: Error, moduleAddress: string, moduleName: string, errorCode: string, errorCodeHex: string, isFromRegistry: boolean);
 }
 
+export declare interface MovePermissionPolicy {
+    kind: "move";
+    items: Array<{
+        moduleAddress: string;
+        moduleName: string;
+        functionNames: string[];
+    }>;
+}
+
 declare class OfflineSigner implements OfflineAminoSigner {
     private address;
     private signMessage;
     private restUrl;
     constructor(address: string, signMessage: (message: string) => Promise<string>, restUrl: string);
     private cachedPublicKey;
+    private setCachedPublicKey;
     private getCachedPublicKey;
     private getPublicKeyFromRestApi;
     private getPublicKey;
@@ -559,14 +651,7 @@ export declare function useInterwovenKit(): {
         recipientAddress?: string;
     }) => void;
     disconnect: () => void;
-    autoSign: {
-        isLoading: boolean;
-        enable: (chainId?: string, options?: EnableAutoSignOptions) => Promise<void>;
-        disable: (chainId?: string) => Promise<void>;
-        expiredAtByChain: Record<string, Date | null | undefined>;
-        isEnabledByChain: Record<string, boolean>;
-        granteeByChain: Record<string, string | undefined>;
-    };
+    autoSign: AutoSignResult;
 };
 
 export declare function usePortfolio(): {