useAddChain

Hook to add a chain.

Usage

Chains.tsx

import { algorand, type ChainWithNetworkParameters } from '@kibisis/chains';
import { useAddChain, useChains } from '@kibisis/katavault-react';

function Chains() {
  const chains = useChains();
  const addChain = useAddChain();
  const handleOnAddAlgorandClick = useCallback(() => {
    addChain(algorand, {
      onError: (error) => {
        console.error(error);
      },
      onSuccess: (result: ChainWithNetworkParameters) => {
        console.log(`added new chain ${account.genesisID}`);
      },
    });
  }, [addChain]);

  return (
    <div>
      {chains.map(({ displayName, genesisID }) => (
        <div>
          <p>Name: {displayName}</p>
          <p>ID: {genesisID}</p>
        </div>
      )}

      <button onClick={handleOnAddAlgorandClick}>Add Algorand</button>
    </div>
  );
}

App.tsx

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

function App() {
  return (
    <KatavaultProvider config={config}>
      <AuthScript />
      <Chains />
    </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?: Chain, options?: { onError, onSuccess }) => void

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

onError

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

This will be invoked if there was an error.

onSuccess

(result: ChainWithNetworkParameters, params?: Chain) => void | Promimse<void>

This will be invoked if the chain was added successfully.

See also

• chains