Skip to main content

Overview

The autoSign object provides methods and properties for managing autosign functionality. It is available via the useInterwovenKit() hook.

Accessing the API

Type Definitions

AutoSign Object

Properties

isLoading

Indicates whether autosign status is currently being checked.
boolean
Returns true when autosign status is being initialized or checked, false otherwise. Use this to show loading indicators in your UI.
Example:

expiration

Expiration date for autosign on the default chain.
Date | null
Returns a Date object representing when autosign expires on the default chain, or null if autosign is not enabled. Use this to display expiration information and check if autosign is currently active.
Example:

expirations

Map of chain IDs to expiration timestamps for all configured chains.
Record<string, number | null>
Returns an object mapping chain IDs to expiration timestamps (in milliseconds since epoch). Use this for multi-chain applications to check autosign status across multiple chains. Returns null for chains where autosign is not enabled.
Example:

Methods

enable()

Enables autosign for a specific chain or the default chain.
(chainId?: string) => Promise<void>
Opens a drawer for user confirmation and creates the necessary authz and feegrant permissions. Returns a Promise that resolves when autosign is successfully enabled or rejects if the user cancels or an error occurs.Parameters: - chainId (optional): Chain ID to enable autosign for. If not provided, uses the default chain ID from InterwovenKitProvider.Returns: Promise that resolves when autosign is enabledThrows: Error if user rejects, permissions are not configured, or autosign is already enabled
Example:
Error Cases:
  • "User rejected auto sign setup": User canceled the confirmation dialog
  • "Auto sign permissions are not configured": enableAutoSign is not configured in the provider
  • "Auto sign is already enabled": Autosign is already active for the specified chain ID

disable()

Disables autosign for a specific chain or the default chain.
(chainId?: string) => Promise<void>
Revokes all authz and feegrant permissions for the specified chain, preventing further automatic signing. Returns a Promise that resolves when autosign is successfully disabled.Parameters: - chainId (optional): Chain ID to disable autosign for. If not provided, uses the default chain ID from InterwovenKitProvider.Returns: Promise that resolves when autosign is disabledThrows: Error if permissions are not configured or autosign is not enabled
Example: