useSetAccountNameByAddress

Hook to set the name for an account by its address.

Usage

Accounts.tsx

import { useAccounts, useSetAccountNameByAddress } from '@kibisis/katavault-react';

function Accounts() {
  const accounts = useAccounts();
  const setAccountNameByAddress = useSetAccountNameByAddress();
  const handleOnUpdateAccountClick = useCallback((address: string) => () => {
    setAccountNameByAddress({
      address,
      name: 'New name',
    }, {
      onError: (error) => {
        console.error(error);
      },
      onSuccess: ({ name }) => {
        console.log(`updated account ${address} with name ${name}`);
      },
    });
  }, [setAccountNameByAddress]);

  return (
    <div>
      {accounts.map(({ address, name }) => (
        <div>
          <p>Address: {address}</p>
          <p>Name: {name ?? '-'}</p>
          <button onClick={handleOnUpdateAccountClick(address)}>Update</button>
        </div>
      ))}
    </div>
  );
}

App.tsx

import { KatavaultProvider } from '@kibisis/katavault-react';
import { Accounts } from './Accounts';
import { AuthScript } from './AuthScript';
import config from './config';

function App() {
  return (
    <KatavaultProvider config={config}>
      <AuthScript />
      <Accounts />
    </KatavaultProvider>
  );
}

AuthScript.tsx

import { useAuthenticate } from '@kibisis/katavault-react';
import { useEffect } from 'react';

export function AuthScript() {
  const {
    authenticateWithPasskey,
    isAuthenticated,
  } = useAuthenticate();

  useEffect(() => {
    authenticateWithPasskey({
      user: {
        name: 'Kibi',
        username: 'kibi@kibis.is',
      },
    }, {
      onError: (error) => console.error(error),
      onSuccess: () => console.log('authenticated successfully!'), // for successful authentication, you can listen to this call back
    });
  }, []);
  useEffect(() => {
    console.log('is authenticated', isAuthenticated); // ... and/or check this variable
  }, [isAuthenticated]);

  return null;
}

config.ts

import { voi } from '@kibisis/chains';
import { CreateKatavaultParameters } from '@kibisis/katavault-core';

const config: CreateKatavaultParameters = {
  chains: [voi],
  client: {
    name: 'Awesome App!!',
  },
};

export default config;

Returns

(params: SetAccountNameByAddressParameters, options?: { onError, onSuccess }) => void

The function can be called with callbacks that are invoked on error/success.

onError

(error: BaseError, params: SetAccountNameByAddressParameters) => void | Promimse<void>

This will be invoked if there was an error.

onSuccess

(result: undefined, params: SetAccountNameByAddressParameters) => void | Promimse<void>

This will be invoked if the account update was successful.

See also

• setAccountNameByAddress