useIdentityKit

Hook, which is needed for getting currently connected user, its wallet address (as a valid ICRC1 Account), balance, disconnect function and other in one place:

Import

import { useIdentityKit } from "@nfid/identitykit/react"

Usage

const {
  isInitializing,
  user,
  isUserConnecting,
  icpBalance,
  signer,
  identity,
  delegationType,
  accounts,
  connect,
  disconnect,
  fetchIcpBalance,
} = useIdentityKit()

Return values

isInitializing

boolean

Boolean representing wether identitykit initialized or not for connected user on page reload (Connect wallet will be disabled until initialization finishes).

user

{ principal: Principal, subaccount?: SubAccount} | undefined

Currently connected user principal and subaccount. Will be undefined until successfull connect.

isUserConnecting

boolean

Boolean representing wether user is connecting or not (signer selected, but user still not connected).

icpBalance

number | undefined

Balance of connected user, will be undefined until successfull connect

signer

Signer<Transport> | undefined

Selected signer, undefined until selection

identity

Identity | PartialIdentity | undefined

If IdentityKitProvider.authType is set to IdentityKitAuthType.DELEGATION value will contain @dfinity identity after successfull connect, will be undefined if other authType is selected or user not connected

delegationType

IdentityKitDelegationType.ACCOUNT | IdentityKitDelegationType.RELYING_PARTY

Equals IdentityKitDelegationType.ACCOUNT if delegation has targets, IdentityKitDelegationType.RELYING_PARTY if delegation doesn’t have targets, and undefined if user is not connected or authType is set to IdentityKitAuthType.ACCOUNTS

accounts

{ principal: Principal, subaccount?: SubAccount}[] | undefined

Will contain connected accounts in case IdentityKitProvider.authType is set to IdentityKitAuthType.ACCOUNTS and user is connected, otherwise will be undefined

connect

(signerIdOrUrl?: string) => void

Function to trigger will open connect wallet modal wihout signerIdOrUrl provided, will open signer if signers includes one with provided id or provided value is valid signer url.

disconnect

() => Promise<void>

Function to trigger manual disconnect

fetchIcpBalance

() => Promise<void> | undefined

Function to manually fetch ICP balance of connected user, will be undefined if user is not connected.