Covalent

GoldRush, powered by Covalent, is a set of data tools that support web3 development across 200+ supported blockchains, including Linea Mainnet and Linea Sepolia. 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 multiple web3 use cases. The GoldRush suite is powered by Covalent, which is decentralized and cryptographically secure.

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, beyond what you get from RPC providers

Sign up to start building on Linea

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.
Use cases: Wallets, portfolio trackers, token gating, airdrop snapshots.

Transactions API

Features: All historical transactions with human-readable log events. Includes gas usage/spend summaries.
Use cases: Accounting and tax tools, branded in-app transaction receipts.

NFT API

Features: Media assets, metadata, sales, owners, trait & attribute filters, thumbnails, and previews.
Use cases: NFT galleries and marketplaces, real world asset (RWA) tracking, token gating.

Cross-Chain Activity API

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

Security API

Features: NFT and ERC20 token allowances, including value-at-risk.
Use cases: Revoke features in wallets, security applications.

Blockchain API

Features: Block details, log events by contract address or topic hash, gas prices, token prices and holders.
Use cases: Custom block explorers.

Developer Tools

There are four primary developer tools for using the APIs:

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

curl -X GET https://api.covalenthq.com/v1/linea-mainnet/address/0xc882b111a75c0c657fc507c04fbfcd2cc984f071/balances_v2/ \
    -H 'Content-Type: application/json' \
    -u YOUR_API_KEY:

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

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("linea-mainnet", "0xc882b111a75c0c657fc507c04fbfcd2cc984f071");

    for await (const tx of transactions) {
    console.log("tx", tx);
    }
} catch (error) {
    console.log(error.message);
}
})();

GoldRush UI Kit - React components for your dApp frontend.

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

Request:

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

Custom decoded response:

{
    "success": true,
    "events": [
        {
            "action": "Transferred",
            "category": "Token",
            "name": "Transfer",
            "protocol": {
                "logo": "https://logos.covalenthq.com/tokens/59144/0xc1061a8315095945d83650a1ba28cd026d64cdb0.png",
                "name": "SLToken1"
            },
            "details": [
                {
                    "heading": "From",
                    "value": "0xb5c6a0625E6F01CAbF9DDBdf64AaAbd1B178e1E2",
                    "type": "address"
                },
                {
                    "heading": "To",
                    "value": "0xf081470f5C6FBCCF48cC4e5B82Dd926409DcdD67",
                    "type": "address"
                }
            ],
            "tokens": [
                {
                    "decimals": 18,
                    "heading": "Token Amount",
                    "pretty_quote": "$0.00",
                    "ticker_logo": "https://logos.covalenthq.com/tokens/59144/0xc1061a8315095945d83650a1ba28cd026d64cdb0.png",
                    "ticker_symbol": "SLTT1",
                    "value": "1000"
                }
            ]
        },
        {
            "action": "Transferred",
            "category": "Token",
            "name": "Transfer",
            "protocol": {
                "logo": "https://logos.covalenthq.com/tokens/59144/0xc1061a8315095945d83650a1ba28cd026d64cdb0.png",
                "name": "SLToken1"
            },
            "details": [
                {
                    "heading": "From",
                    "value": "0xf081470f5C6FBCCF48cC4e5B82Dd926409DcdD67",
                    "type": "address"
                },
                {
                    "heading": "To",
                    "value": "0x7160570BB153Edd0Ea1775EC2b2Ac9b65F1aB61B",
                    "type": "address"
                }
            ],
            "tokens": [
                {
                    "decimals": 18,
                    "heading": "Token Amount",
                    "pretty_quote": "$0.00",
                    "ticker_logo": "https://logos.covalenthq.com/tokens/59144/0xc1061a8315095945d83650a1ba28cd026d64cdb0.png",
                    "ticker_symbol": "SLTT1",
                    "value": "1000"
                }
            ]
        },
        {
            "action": "Transferred",
            "category": "Token",
            "name": "Transfer",
            "protocol": {
                "logo": "https://logos.covalenthq.com/tokens/59144/0xfe3b40b2d513b8e7ab3c7b6c758df3f00a2772dd.png",
                "name": "SLToken5"
            },
            "details": [
                {
                    "heading": "From",
                    "value": "0x7160570BB153Edd0Ea1775EC2b2Ac9b65F1aB61B",
                    "type": "address"
                },
                {
                    "heading": "To",
                    "value": "0xf081470f5C6FBCCF48cC4e5B82Dd926409DcdD67",
                    "type": "address"
                }
            ],
            "tokens": [
                {
                    "decimals": 18,
                    "heading": "Token Amount",
                    "pretty_quote": "$0.00",
                    "ticker_logo": "https://logos.covalenthq.com/tokens/59144/0xfe3b40b2d513b8e7ab3c7b6c758df3f00a2772dd.png",
                    "ticker_symbol": "SLTT5",
                    "value": "989"
                }
            ]
        },
        {
            "action": "Transferred",
            "category": "Token",
            "name": "Transfer",
            "protocol": {
                "logo": "https://logos.covalenthq.com/tokens/59144/0xfe3b40b2d513b8e7ab3c7b6c758df3f00a2772dd.png",
                "name": "SLToken5"
            },
            "details": [
                {
                    "heading": "From",
                    "value": "0xf081470f5C6FBCCF48cC4e5B82Dd926409DcdD67",
                    "type": "address"
                },
                {
                    "heading": "To",
                    "value": "0xb5c6a0625E6F01CAbF9DDBdf64AaAbd1B178e1E2",
                    "type": "address"
                }
            ],
            "tokens": [
                {
                    "decimals": 18,
                    "heading": "Token Amount",
                    "pretty_quote": "$0.00",
                    "ticker_logo": "https://logos.covalenthq.com/tokens/59144/0xfe3b40b2d513b8e7ab3c7b6c758df3f00a2772dd.png",
                    "ticker_symbol": "SLTT5",
                    "value": "988"
                }
            ]
        },
        {
            "action": "Account Abstraction Transaction",
            "category": "Others",
            "name": "User Operation Event",
            "protocol": {
                "logo": "https://logos.covalenthq.com/tokens/59144/0x5ff137d4b0fdcd49dca30c7cf57e578a026d2789.png",
                "name": "4337 Entry Point"
            },
            "details": [
                {
                    "heading": "Gas Cost",
                    "value": "25590122985514",
                    "type": "text"
                },
                {
                    "heading": "Gas Used",
                    "value": "426502",
                    "type": "text"
                },
                {
                    "heading": "Paymaster",
                    "value": "0x0000000000000000000000000000000000000000",
                    "type": "address"
                },
                {
                    "heading": "Sender",
                    "value": "0xb5c6a0625E6F01CAbF9DDBdf64AaAbd1B178e1E2",
                    "type": "address"
                },
                {
                    "heading": "User Operation Hash",
                    "value": "0xfce86b467cae9f1375483acc23edaf5ead45f1fcff1939f06e00b28b2f776f94",
                    "type": "address"
                }
            ]
        }
    ],
    "tx_metadata": {
        ...
        },
        "explorers": [
            {
                "label": null,
                "url": "https://lineascan.build/tx/0xfb6277bb32b5c5fb9c84925a42406ff47e65efd3b0eeea526f8d270429c9e453"
            }
        ]
    }
}

Get started

API Key - sign up for free
Docs - comprehensive knowledge base for all things GoldRush
Guides - learn how to build for various use cases and expand your onchain knowledge

APIs​

Wallet API​

Transactions API​

NFT API​

Cross-Chain Activity API​

Security API​

Blockchain API​

Developer Tools​

Get started​