bloctoWallet

A wallet configurator for MetaMask which allows integrating the wallet with React

import { bloctoWallet } from "@thirdweb-dev/react";

const bloctoWalletConfig = bloctoWallet(options);

customize (optional)

bloctoWalletConfig contains the default config for metadata and UI. you can optionally choose to override the defaults to customize the wallet. Learn more about these configs

const bloctoWalletConfig = bloctoWallet({ ... });

// override metadata
bloctoWalletConfig.meta.name = "..."; // change the name
bloctoWalletConfig.meta.iconURL = "..."; // change the icon
bloctoWalletConfig.meta.urls = {
  // change urls to download the wallet on various platforms
  android: "https://...",
  ios: "https://...",
  chrome: "https://...",
  firefox: "https://...",
};

// override connection UI
bloctoWalletConfig.connectUI = BloctoWalletConnectUI; // react component

// custom selection UI
bloctoWalletConfig.selectUI = BloctoWalletSelectUI; // react component

// custom logic to check if the wallet is installed or not
bloctoWalletConfig.isInstalled = isBloctoWalletInstalled; // function

Once the config is ready, you can use it with ConnectWallet component or useConnect hook as shown below

// add to ThirdwebProvider to add it in ConnectWallet's modal
<ThirdwebProvider supportedWallets={[bloctoWalletConfig]} clientId="your-client-id"/>;

// or use it with useConnect hook
const connect = useConnect();
connect(bloctoWalletConfig, { ... });

options

appId (recommended)

To get advanced features and support from Blocto, you can create an appId from blocto dashboard

import { bloctoWallet } from "@thirdweb-dev/react";

bloctoWallet({
  appId: "YOUR_BLOCTO_APP_ID",
});

recommended (optional)

Show this wallet as "recommended" in the ConnectWallet Modal.

bloctoWallet({
  recommended: true,
});

Usage with ConnectWallet

To allow users to connect to this wallet using the ConnectWallet component, you can add it to ThirdwebProvider's supportedWallets prop.

<ThirdwebProvider supportedWallets={[bloctoWallet()]} clientId="your-client-id">
  <YourApp />
</ThirdwebProvider>

Usage with useConnect

you can use the useConnect hook to programmatically connect to the wallet without using the ConnectWallet component.

The wallet also needs to be added in ThirdwebProvider's supportedWallets if you want the wallet to auto-connect on next page load.

const bloctoWalletConfig = bloctoWallet();

function App() {
  const connect = useConnect();

  const handleConnect = async () => {
    await connect(bloctoWalletConfig, connectOptions);
  };

  return <div> ... </div>;
}

connectOptions

{ chainId?: number } | undefined

chainId (optional)

If chainId is provided, wallet will be connected and immediately switch to network with given chainId.

Chain object corresponding to this chainId from @thirdweb-dev/chains package must be specified in ThirdwebProvider's supportedChains prop as shown below

import { Polygon } from "@thirdweb-dev/chains";
import { ThirdwebProvider } from "@thirdweb-dev/react";

export function YourApp() {
  return (
    <ThirdwebProvider
      supportedChains={[Polygon]}
      clientId="your-client-id"
    >
      <App />
    </ThirdwebProvider>
  );
}