LogoLogo
  • Introduction
  • Foundation Initiatives and Grants
    • Users
    • Ambassadors
    • Developers
    • Validators
  • Bug Bounty Program
  • The Unique Value of CrossFi Grants
  • FAQ Public Testnet
  • XFI PAD
  • How to do tasks
    • Test XFI Console
    • Faucets
      • Telagram faucet
      • Discord faucet
    • How to verify the task
    • Unique tasks
      • Social media
      • Delegate MPX to validator
    • Daily tasks
      • Send MPX
      • Send MPX to different addresses in the same transaction
      • Claim XFI reward
      • Send Cosmos XFI
      • Send EVM XFI
      • Send XFI to different addresses in the same transaction
      • Send XFI and MPX to different addresses in the same transaction
  • Additional MPX
  • CrossFi Evolution Hackathons
    • Hackaton # 1 - Boost XFI utility
      • Workshops Roadmap & Timeline
        • CrossFi Workshop #1
        • CrossFi Workshop #2
        • Partner Workshop: DEX Guru
          • Block Explorer & Data Warehouse Walkthrough
          • Quick Start Guide for Developers at XFI Hackathon
          • Data Warehouse
            • Query, Dashboard, API
          • Block Explorer
          • XFI Swap
          • Data Warehouse API
        • Partner Workshop: Bware Labs
          • Roadmap
          • Introduction
          • A Guide to Blast
          • Breaking DeFi Barriers with Blast
            • Using CrossFi with Blast
          • Public CrossFi Gateway
            • Public API
          • CrossFi RPC
            • CrossFi RPC Method Calls
          • Blast Intoduction
            • API Docs
            • Things to Know
            • Tutorials & Guides
            • Blast SDK
            • Blast Protocol
        • Partner Workshop: Covalent
          • A Guide to GoldRush
        • Partner Workshop: DIA
        • Workshop FAQs
      • Hackathon Judges
        • Interested in Becoming a Judge?
      • Hackathon FAQs
Powered by GitBook
On this page
  • GoldRush - powered by Covalent
  • Developer Tools​
  • Get started​
  1. CrossFi Evolution Hackathons
  2. Hackaton # 1 - Boost XFI utility
  3. Workshops Roadmap & Timeline
  4. Partner Workshop: Covalent

A Guide to GoldRush

GoldRush - powered by Covalent

PreviousPartner Workshop: CovalentNextPartner Workshop: DIA

Last updated 10 months ago

GoldRush - powered by Covalent

is a set of data tools that enable easy web3 development across , including CrossFi Chain. The mission of GoldRush is to improve the lives of developers by providing structured onchain data for dapps.

Developers can utilize GoldRush via SDKs, APIs, UI Kits, human-readable transactions and pre-built templates for a number of web3 use cases. The GoldRush suite is powered by Covalent, which is decentralized and cryptographically secure. Whether you are fetching NFTs, DeFi transactions, or other on-chain data, GoldRush helps scale hundreds of projects from crypto native teams to Fortune 500 companies.

With GoldRush, you have access to:

  • Every wallet's token balances

  • Full transaction histories

  • Every contract log event

  • All NFTs including assets and metadata

Use GoldRush if you need:

  • Wallet, Transactions, NFT, DEX, Staking or core blockchain data (i.e. log events, blocks, gas)

  • Normalized, aggregated and enhanced multichain data, well beyond what you get from RPC providers

  • Enterprise-grade performance

APIs

The GoldRush APIs enables developers to quickly and easily access structured onchain data. This means consistent response schemas that are blockchain agnostic. Available APIs and corresponding use cases include:

Wallet API

  • Features: All token balances (ERC20, 721, 1155, native), token transfers and prices (spot and historical) for a wallet.

  • Features: All historical transactions with human-readable log events. Includes gas usage/spend summaries.

  • Features: Media assets, metadata, sales, owners, trait & attribute filters, thumbnails, and previews.

  • Features: Single API call to fetch a list of active chains and the latest transaction date on each for an address.

  • Features: NFT and ERC20 token allowances, including value-at-risk.

  • Use cases: Revoke in wallets, security applications.

  • Features: Block details, log events by contract address or topic hash, gas prices, token prices and holders.

  • Use cases: Custom block explorers.

There are 4 primary developer tools for using the APIs:

  1. npm install @covalenthq/client-sdk
    import { CovalentClient } from "@covalenthq/client-sdk";
    
    (async () => {
    try {
        const client = new CovalentClient("YOUR_API_KEY");
        const transactions = client.TransactionService.getAllTransactionsForAddress("eth-mainnet", "demo.eth");
    
        for await (const tx of transactions) {
        console.log("tx", tx);
        }
    } catch (error) {
        console.log(error.message);
    }
    })();

  2. Request:

    curl -X POST http://localhost:8080/api/v1/tx/decode \
        -H 'Content-Type: application/json' \
        -d '{
              "chain_name": "eth-mainnet",
              "tx_hash": "0xe49fd91eac1a322f24474b8db74394b8889115283ea8d53fe7111d6ef5476540"
            }'

    Custom decoded response:

    {
        "success": true,
        "events": [
            {
                "action": "Transferred",
                "category": "Token",
                "name": "Transfer",
                "protocol": {
                    "logo": "https://logos.covalenthq.com/tokens/1/0x17d50ab23eb75192e2a1e882cfaae59fbddce300.png",
                    "name": "Hash War"
                },
                "details": [
                    {
                        "heading": "From",
                        "value": "0xb5c6a0625E6F01CAbF9DDBdf64AaAbd1B178e1E2",
                        "type": "address"
                    },
                    {
                        "heading": "To",
                        "value": "0x883a8bADdE2005198e666Ce9314bB545aD531CdF",
                        "type": "address"
                    }
                ],
                "nfts": [
                    {
                        "heading": "NFT Transferred",
                        "collection_address": "0x17d50ab23eb75192e2a1e882cfaae59fbddce300",
                        "collection_name": "Sank",
                        "token_identifier": "5",
                        "images": { 
                        "256": "https://image-proxy.svc.prod.covalenthq.com/cdn-cgi/image/width=256,fit/https://app.hawahash.xyz/image/280d288654643776778c923de0573ccb.png",
                        "512": "https://image-proxy.svc.prod.covalenthq.com/cdn-cgi/image/width=512,fit/https://app.hawahash.xyz/image/280d288654643776778c923de0573ccb.png",
                        "1024": "https://image-proxy.svc.prod.covalenthq.com/cdn-cgi/image/width=1024,fit/https://app.hawahash.xyz/image/280d288654643776778c923de0573ccb.png",
                        "default": "https://app.hawahash.xyz/image/280d288654643776778c923de0573ccb.png"
                       }
                        }
                    ]
                },
                {
                "action": "Account Abstraction Transaction",
                "category": "Others",
                "name": "User Operation Event",
                "protocol": {
                    "logo": "https://logos.covalenthq.com/tokens/1/0x5ff137d4b0fdcd49dca30c7cf57e578a026d2789.png",
                        "name": "4337 Entry Point"
                    },
                    "details": [
                        {
                            "heading": "Gas Cost",
                            "value": "4932185464241550",
                            "type": "text"
                        },
                        {
                            "heading": "Gas Used",
                            "value": "837831",
                            "type": "text"
                        },
                        {
                            "heading": "Paymaster",
                            "value": "0x0000000000000000000000000000000000000000",
                            "type": "address"
                        },
                        {
                            "heading": "Sender",
                            "value": "0x883a8bADdE2005198e666Ce9314bB545aD531CdF",
                            "type": "address"
                        },
                        {
                            "heading": "User Operation Hash",
                            "value": "0x035da1900dc84351768836d4281839373f17da35de0f901c69904e09f5144f6d",
                            "type": "address"
                        }
                    ]
                }
            ],
            "tx_metadata": {
                ...
                },
                "explorers": [
                    {
                        "label": null,
                        "url": "https://etherscan.io/tx/0xe49fd91eac1a322f24474b8db74394b8889115283ea8d53fe7111d6ef5476540"
                    }
                ]
            }
        }

Use cases: , token gating, airdrop snapshots.

Transactions API

Use cases: , branded in-app .

NFT API

Use cases: , real world asset (RWA) tracking, token gating.

Cross-Chain Activity API

Use cases: .

Security API

Blockchain API

Developer Tools

- REST API with enterprise-grade endpoints to use with any programming language. Switch blockchains with one path parameter.

- official client libraries including TypeScript, Python, Go and Viem.

- beautifully designed React components for your dApp frontend

- beautifully designed React components for your dApp frontend.

- decode any raw event logs into human-readable structured data.

Get started

- sign up for free

- comprehensive knowledge base for all things GoldRush

- learn how to build for various use cases and expand your on-chain knowledge

GoldRush
200+ supported blockchains
Sign up to start building on CrossFi Chain
​
​
Wallets, portfolio trackers
​
Accounting and tax tools
transaction receipts
​
NFT galleries and marketplaces
​
App onboarding
​
​
​
GoldRush API
GoldRush SDKs
GoldRush UI Kit
GoldRush
Component Example
GoldRush Decoder
​
API Key
Docs
Guides