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

import { useInterwovenKit } from '@initia/interwovenkit-react'

function MyComponent() {
  const { autoSign } = useInterwovenKit()

  // Use autoSign methods and properties
}

​
Type Definitions

​
AutoSign Object

interface AutoSign {
  isLoading: boolean
  enable: (chainId?: string) => Promise<void>
  disable: (chainId?: string) => Promise<void>
  expiredAtByChain: Record<string, Date | null | undefined>
  isEnabledByChain: Record<string, boolean>
  granteeByChain: Record<string, string | undefined>
}

​
Properties

​
isLoading

Indicates whether autosign status is currently being checked.
​
isLoading
boolean
Returns true when autosign status is being initialized or checked, false otherwise. Use this to show loading indicators in your UI.
Example: 
function AutosignButton() {
  const { autoSign } = useInterwovenKit()

  if (autoSign.isLoading) {
    return <button disabled>Loading...</button>
  }

  return <button>Enable Autosign</button>
}

​
isEnabledByChain

Map of chain IDs to their autosign enabled status.
​
isEnabledByChain
Record<string, boolean>
Returns an object mapping chain IDs to boolean values indicating whether autosign is currently enabled for each chain. Use this to check autosign status and conditionally render UI elements.
Example: 
function AutosignStatus({ chainId }: { chainId: string }) {
  const { autoSign } = useInterwovenKit()

  if (autoSign.isEnabledByChain[chainId]) {
    return <p>Autosign is enabled for {chainId}</p>
  }

  return <p>Autosign is not enabled</p>
}

​
expiredAtByChain

Map of chain IDs to their expiration dates.
​
expiredAtByChain
Record<string, Date | null | undefined>
Returns an object mapping chain IDs to expiration dates. Values can be: - Date: The date when autosign expires - null: Autosign is not enabled for this chain - undefined: Autosign is enabled with no expiration (permanent)
Example: 
function ExpirationDisplay({ chainId }: { chainId: string }) {
  const { autoSign } = useInterwovenKit()
  const expiration = autoSign.expiredAtByChain[chainId]

  if (expiration === null) {
    return <p>Autosign is not enabled</p>
  }

  if (expiration === undefined) {
    return <p>Autosign is enabled (no expiration)</p>
  }

  return <p>Autosign expires: {expiration.toLocaleString()}</p>
}

​
granteeByChain

Map of chain IDs to grantee addresses (the derived AutoSign wallet addresses).
​
granteeByChain
Record<string, string | undefined>
Returns an object mapping chain IDs to the grantee addresses that have been authorized to sign transactions. Use this for debugging or displaying which address is authorized for autosign.
Example: 
function MultiChainStatus() {
  const { autoSign } = useInterwovenKit()

  return (
    <div>
      {Object.entries(autoSign.isEnabledByChain).map(([chainId, isEnabled]) => {
        const expiration = autoSign.expiredAtByChain[chainId]

        return (
          <div key={chainId}>
            {chainId}: {isEnabled ? 'Enabled' : 'Disabled'}
            {isEnabled &&
              expiration &&
              ` (until ${expiration.toLocaleString()})`}
          </div>
        )
      })}
    </div>
  )
}

​
Methods

​
enable()

Enables autosign for a specific chain or the default chain.
​
enable
(chainId?: string) => Promise<void>
Opens a drawer for user confirmation, derives the AutoSign wallet for the current app origin, 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 the derivation or grant flow, or if the selected chain has no configured AutoSign message types
Example: 
async function enableAutosign() {
  try {
    await autoSign.enable()
    console.log('Autosign enabled for default chain')
  } catch (error) {
    console.error('Failed to enable autosign:', error)
  }
}

async function enableForChain() {
  try {
    await autoSign.enable('minievm-2')
    console.log('Autosign enabled for minievm-2')
  } catch (error) {
    console.error('Failed to enable autosign:', error)
  }
}
Common Failure Cases:
  • "User cancelled": The user closes the AutoSign flow before approving it.
  • No message types configured for chain ${chainId}: The selected chain does not resolve to any allowed AutoSign message types.
  • Grant creation fails on-chain or during the wallet/signature flow.

​
disable()

Disables autosign for a specific chain or the default chain.
​
disable
(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: 
async function disableAutosign() {
  try {
    await autoSign.disable()
    console.log('Autosign disabled for default chain')
  } catch (error) {
    console.error('Failed to disable autosign:', error)
  }
}

async function disableForChain() {
  try {
    await autoSign.disable('minievm-2')
    console.log('Autosign disabled for minievm-2')
  } catch (error) {
    console.error('Failed to disable autosign:', error)
  }
}