Web3 react components for Chakra on Next

React(18) components for chakra(2) using next(13).

This is a website building bricks package such as navbar, footer, cards, layouts etc.

It is intended to be used for Web3 specific projects - grants you a web3 provider interface, chain selector drop down, and allows to build generic smart contract interface by just pointing address and ABI. How cool is that?

Use case

https://peersky.github.io/daococoa/

How to use

Getting started

Install yarn add @peersky/next-web3-chakra

Create config.ts that has exports SITEMAP:

import { SiteMap, SiteMapItemType } from "@peersky/next-web3-chakra/types";
export const SITEMAP: SiteMap = [
  {
    title: "Blog",
    path: "/blog",
    type: SiteMapItemType.CONTENT,
  }]

create your theme. Here is how you start with default theme:

1import { default as defaultTheme } from "@peersky/next-web3-chakra/theme/";
2
3import { extendTheme } from "@chakra-ui/react";
4
5const theme = extendTheme({
6  ...defaultTheme,
7  //Here can override library theme items
8});
9
10export default theme;

Wrap your application:

1import { UIProvider, Web3Provider } from "@peersky/next-web3-chakra/providers";
2import { SITEMAP } from "./config";
3import theme from "./theme";
4....
5 <ChakraProvider theme={theme}>
6      {/* <Fonts /> */}
7      <Web3Provider>
8        <UIProvider config={{ SITEMAP: SITEMAP }}>{props.children}</UIProvider>
9      </Web3Provider>
10</ChakraProvider>

Layouts

This package does not use next13 layouts. Instead old fashioned way is preserved. Use as follows to ensure items defined in layouts do not rerender when you switch between pages:

1import { getLayout } from "@peersky/next-web3-chakra/layouts/BlogLayout";
2const Blog = <div>lorem<div>
3Blog.getLayout = getLayout();
4export default Blog;

Components

Import from @peersky/next-web3-chakra/components see inside repository for more details

Providers

Import from @peersky/next-web3-chakra/providers

UI Provider gives you general information about state of UI:

1export interface UIProviderInterface {
2  sidebarVisible: boolean | undefined;
3  searchBarActive: boolean | undefined;
4  isMobileView: boolean | undefined;
5  sidebarCollapsed: boolean | undefined;
6  sidebarToggled: boolean | undefined;
7  searchTerm: string | undefined;
8  setSearchBarActive: Function;
9  setSidebarCollapsed: Function;
10  setSearchTerm: Function;
11  setSidebarToggled: Function;
12  setSidebarVisible: Function;
13  sessionId: string | undefined;
14  webSiteConfig: WebSiteConfig;
15}

Web3 Provider gives a convinient access to blockchain related operations:

1export interface Web3ProviderInterface {
2  web3: Web3; //web3js
3  onConnectWalletClick: Function;
4  buttonText: String;
5  WALLET_STATES: WalletStatesInterface; //onboard/conect/connected/unknown-chain
6  account: string; //address
7  chainId: number;
8  defaultTxConfig: Object;
9  // signAccessToken: Function;
10  getMethodsABI: typeof GetMethodsAbiType; //Takes contract ABI and returns method with given name
11  changeChain: typeof ChangeChain; //Request wallet to switch chain
12  targetChain: ChainInterface | undefined; //Desired chain
13  getChainFromId: typeof getChainFromId; //Read chain name from chain id
14}

Why there is no <you_name_it>

Author works on this package for pure enthusiasm. If you want to contribute or request a feature: please contact on github: https://github.com/peersky/daococoa/issues

Fund

You can fund this project to make it more fun.