GoldRush is a set of data tools that enable easy web3 development across 200+ supported blockchains. 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 onchain data, GoldRush helps scale hundreds of projects from crypto native teams to Fortune 500 companies.
With GoldRush, you have access to:
Use GoldRush if you need:
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:
There are 4 primary developer tools for using the APIs:
GoldRush API - REST API with enterprise-grade endpoints to use with any programming language. Switch blockchains with one path parameter.
curl -X GET https://api.covalenthq.com/v1/eth-mainnet/address/demo.eth/balances_v2/ \
-H 'Content-Type: application/json' \
-u YOUR_API_KEY:
GoldRush SDKs - official client libraries for 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("eth-mainnet", "demo.eth");
for await (const tx of transactions) {
console.log("tx", tx);
}
} catch (error) {
console.log(error.message);
}
})();
GoldRush UI Kit - beautifully designed 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": "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": "0xca5f3AF7c961Ded8E7Aa3e10c041BAe35aC29E7E",
"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"
}
]
}
}
