@covalenthq/goldrush-kit

Beautifully designed React components for your dApp frontend.

200+ Chains. Open-source. Customizable.

Explore the docs »

Setup

Install goldrush-kit using npm:

npm install @covalenthq/goldrush-kit

or yarn:

yarn add @covalenthq/goldrush-kit

Implementation

1. Import GoldRushProvider

import { GoldRushProvider } from "@covalenthq/goldrush-kit";

1. Wrap GoldRushProvider around the application.
2. Configure the provider and add it to the apikey props with your Covalent API key. You can register for a free key on Covalent's website.

<GoldRushProvider apikey="<YOUR_API_KEY>">{children}</GoldRushProvider>

1. Add the stylesheet to your application.

import "@covalenthq/goldrush-kit/styles.css";

1. Add desired components. If you're using next.js versions ^13.0 and are using app router, make sure you have use client; at the top of the file to disable Next's server component modules. Visit GoldRush's component documentation for more information.

import {
    GoldRushProvider,
    NFTWalletTokenListView,
    TokenBalancesListView,
    TokenTransfersListView,
    AddressActivityListView,
} from "@covalenthq/goldrush-kit";

Ready-to-go React Component example

Here's a full example to get you started. If you're using next.js versions ^13.0 and are using app router, make sure you have use client; at the top of the file to disable Next's server component modules.

Note: You should always keep your API key private, never put it directly into your code, especially front end code. Instead, use an environment variable to inject the key into your code.

Be sure to secure your key to prevent unauthorized use in the Covalent platform by restricting usage to specific URLs.

"use client";
import "@covalenthq/goldrush-kit/styles.css";
import {
    GoldRushProvider,
    NFTWalletTokenListView,
    TokenBalancesListView,
    TokenTransfersListView,
    AddressActivityListView,
} from "@covalenthq/goldrush-kit";

export default function GoldRushExample() {
    return (
        <main className="">
            <GoldRushProvider
                apikey={process.env.NEXT_PUBLIC_API_KEY}
                mode="dark"
                color="emerald"
            >
                <TokenBalancesListView
                    chain_names={[
                        "eth-mainnet",
                        "matic-mainnet",
                        "bsc-mainnet",
                        "avalanche-mainnet",
                        "optimism-mainnet",
                    ]}
                    hide_small_balances
                    address="0xfc43f5f9dd45258b3aff31bdbe6561d97e8b71de"
                />
                <TokenTransfersListView
                    chain_name="eth-mainnet"
                    address="0xfc43f5f9dd45258b3aff31bdbe6561d97e8b71de"
                    contract_address="0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
                />
                <AddressActivityListView address="0xfc43f5f9dd45258b3aff31bdbe6561d97e8b71de" />
                <NFTWalletTokenListView
                    address="0xfc43f5f9dd45258b3aff31bdbe6561d97e8b71de"
                    chain_names={[
                        "eth-mainnet",
                        "matic-mainnet",
                        "bsc-mainnet",
                        "avalanche-mainnet",
                        "optimism-mainnet",
                    ]}
                />
            </GoldRushProvider>
        </main>
    );
}

GoldRush Templates

Template	Description	Link
Wallet & Portfolio UI	Display your tokens and NFTs across multiple chains.	https://github.com/covalenthq/goldrush-wallet-portfolio-ui
NFT Collection Gallery & Analytics UI	Display NFTs by collection and see their details.	https://github.com/covalenthq/goldrush-nft-gallery-ui
Uniswap-like Analytics UI	Display Uniswap-like analytics for the dex of your choice.	https://github.com/covalenthq/goldrush-uniswap-dex-dashboard
Transaction Receipt View	A beautifully designed view for blockchain transactions.	https://github.com/covalenthq/goldrush-tx-receipt-ui

HIGHLIGHT: GoldRush Transaction Receipt View

Designed to transform cluttered blockchain transaction data into meaningful summaries useful to the user. Receipts are fully extensible and enhance the clarity and understanding of various blockchain activities. Imagine a transaction view that shows Game-Fi quest achievements, swap pool position data, or even staking impact on network security—this is all possible with GoldRush-Kit.

https://goldrush-tx-receipt-ui.vercel.app/

https://github.com/covalenthq/goldrush-tx-receipt-ui

GoldRush Decoder

Decode transaction log events to display them in a human-readable format. Useful for understanding the data that is emitted from smart contracts and is a critical component of any dApp. Works in tandem with GoldRush-Kit to provide a seamless experience for developers and users alike.

https://github.com/covalenthq/goldrush-decoder

Build and customize with Storybook

The components used above are built React, Tailwind, and TypeScript. You can preview and customize the components using Storybook.

Storybook provides developers with a way to quickly prototype and develop components in isolation, while React provides the tools to quickly build out a web application. Tailwind provides a library of pre-built UI components and utility classes, while TypeScript adds type safety and autocompletion to the development process. Together, these tools provide developers with the tools they need to quickly and easily build complex, modern web applications.

Storybook Environmental Variable

Create and add a .env file to the root directory of your project and the following to the file.

STORYBOOK_COVALENT_API_KEY = "<YOUR_API_KEY>"

Start

npm run dev

Build/Bundle Component Library

npm run build:library

Build/Bundle Storybook For Deployment

npm run build:storybook

Contributing

Contributions, issues and feature requests are welcome! Feel free to check issues page.

Show your support

Give a ⭐️ if this project helped you!

License

This project is Apache 2.0 licensed.

Changelog

0.6.5

Features

• Exported types of the entire project
• Removed deprecated exports
• Update AddressAvatar render options for its usage
• Update TokenAvatar for clearer usage
• Update NFTWalletCollectionList UI
• Added autodocs for stories

Fixes

• Fix value parsing in multiple places
• Fix theme colors in TokenAvatar
• Fix table wrapping
• Fix toasts
• Create AddressAvatar types enum
• actionables of multiple components
• Misc DX fixes
• Misc HTML element nesting
• Prune unnecessary static assets