FutureverseWagmiProvider

FutureverseWagmiProvider enables your application to connect with Wagmi's default Ethereum wallets, including Coinbase Wallet, MetaMask, WalletConnect, and the custom-built XRP wallet, Xaman. It supports any chain compatible with Wagmi such as, Mainnet, Root, Sepolia, polygonAmoy, and Porcini. FutureverseWagmiProvider includes the following properties:

• walletConnectProjectId

• xamanApiKey

• xamanOnQRCode

• xamanOnSigned

• authClient

• ssr

• storage

• flow

The code below shows the hierarchical sequence of providers starting with QueryClientProvider , which wraps FutureverseWagmiProvider and ending with FutureverseAuthProvider, which wraps the children.

FutureverseWagmiProvider passes the getWagmiConfig from the Config.ts file and an initialState for Wagmi as properties to the children.

Example:

import {
  FutureverseAuthProvider,
  FutureverseWagmiProvider,
} from '@futureverse/auth-react';
import { QueryClientProvider } from '@tanstack/react-query';
import { State } from 'wagmi';
import { authClient, getWagmiConfig, queryClient } from './config';

export default function Providers({
  children,
  initialWagmiState,
}: {
  children: React.ReactNode;
  initialWagmiState?: State;
}) {
  return (
    <QueryClientProvider client={queryClient}>
      <FutureverseWagmiProvider
        getWagmiConfig={getWagmiConfig}
        initialState={initialWagmiState}
      >
        <FutureverseAuthProvider authClient={authClient}>
            {children}
        </FutureverseAuthProvider>
      </FutureverseWagmiProvider>
    </QueryClientProvider>
  );
}

FutureverseWagmiProvider properties

walletConnectProjectId

Optional property. It’s obtained from WalletConnect Cloud Dashboard. More information on the WalletConnect documentation.

xamanApiKey

Optional property. It is an ApiKey obtained from Xaman. More information on the Xumm documentation.

xamanOnQRCode

Optional property. It is a callback function that is fired with the Xaman App QR Code is displayed when a message or signature requires signing.

xamanOnSigned

Optional property. Is a callback function that is fired when the Xaman message/transaction is signed in the Xaman app.

authClient

Required property. Initialization of FutureverseAuthClient.

ssr

Optional property. Boolean used for manage Server Side Rendering in Next.js applications.

storage

Optional property. To define the Wagmi storage option you want to use in your application (e.g.: local storage, cookies, etc). Defaults to local storage and also enables you to create custom storage between sessions. More information on the Wagmi documentation for storage.

flow

Optional property. Sets the flow you want: popup or redirect. It defaults to redirect.