Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
117 changes: 11 additions & 106 deletions content/evm/indexer-providers/goldrush.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,118 +4,23 @@ description: 'Learn how to integrate GoldRush indexing services with Sei network
keywords: ['goldrush', 'blockchain indexing', 'api integration', 'data analysis']
---

import { ImageWithCaption } from '../../../src/components';
import { Callout } from 'nextra/components';

import imgWalletUiComponent from '../../../public/assets/ecosystem/resources/goldrush/wallet_ui_component.png';

# GoldRush - powered by Covalent

[GoldRush](https://goldrush.dev/?utm_source=sei&utm_medium=partner-docs) is a
set foundational multichain data APIs and toolkits for easy web3 development
across [100+ supported blockchains](https://goldrush.dev/docs/networks/?utm_source=sei&utm_medium=partner-docs),
including Sei mainnet (EVM only). GoldRush offers structured onchain data,
including token balances, transactions and event logs through powerful APIs,
SDKs and UI Kits for building dapps.

<Callout type="info">[Sign up to start building on Sei](https://goldrush.dev/platform/?utm_source=sei&utm_medium=partner-docs)</Callout>

## APIs

The GoldRush APIs enable 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](https://goldrush-wallet-portfolio-ui.vercel.app/?utm_source=sei&utm_medium=partner-docs),
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](https://bit.ly/crypto-tax-tool),
branded in-app
[transaction receipts](https://goldrush-dfk-tx-receipt-ui.vercel.app/tx/defi-kingdoms-mainnet/0x4e5c0af28b2cea27d06677fae1f573572e0ff863c43ae42d2959ca67b90c4390/?utm_source=sei&utm_medium=partner-docs).

### 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](https://goldrush-wallet-portfolio-ui.vercel.app/activity/0x6d68A318D0632f7B9Ce9d6757Dea0e9dE19D7CCA/?utm_source=sei&utm_medium=partner-docs).

### Security API

- **Features:** NFT and ERC20 token allowances, including value-at-risk.
- **Use cases:**
[Revoke features](https://goldrush-revokehub.vercel.app/?utm_source=sei&utm_medium=partner-docs)
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](https://goldrush-block-explorer-ui.vercel.app/?utm_source=sei&utm_medium=partner-docs).

## Developer Tools

There are 4 primary developer tools for using the APIs:

1. [GoldRush APIs](https://goldrush.dev/docs/api) - enterprise-grade REST APIs
to use with any programming language. Switch blockchains with one path
parameter.

```sh copy
curl -X GET https://api.covalenthq.com/v1/sei-mainnet/address/0x6d68A318D0632f7B9Ce9d6757Dea0e9dE19D7CCA/balances_v2/ \
-H 'Content-Type: application/json' \
-u YOUR_API_KEY:
```

2. [GoldRush SDKs](https://goldrush.mintlify.app/docs/goldrush-sdks?utm_source=sei&utm_medium=partner-docs) -
official client libraries including TypeScript and Python.

```sh copy
npm install @covalenthq/client-sdk
```

```ts copy
import { GoldRushClient } from '@covalenthq/client-sdk';

(async () => {
try {
const client = new GoldRushClient('YOUR_API_KEY');
const transactions = client.TransactionService.getAllTransactionsForAddress('sei-mainnet', '0x6d68A318D0632f7B9Ce9d6757Dea0e9dE19D7CCA');

for await (const tx of transactions) {
console.log('tx', tx);
}
} catch (error) {
console.log(error.message);
}
})();
```
GoldRush offers the most comprehensive Blockchain Data API suite for developers, analysts, and enterprises. Whether you are building a DeFi dashboard, a wallet, a trading bot, an AI agent or a compliance platform, the Data APIs provide fast, accurate, and developer-friendly access to the essential on-chain data you need.

3. [GoldRush UI Kit](https://github.com/covalenthq/goldrush-kit/?utm_source=sei&utm_medium=partner-docs) -
beautifully designed React components for your dApp frontend.
<Callout type="info">Learn more about GoldRush's integration with Sei network [here](https://goldrush.dev/docs/chains/sei?utm_source=sei&utm_medium=partner-docs).</Callout>

<ImageWithCaption img={imgWalletUiComponent} alt="GoldRush UI Kit Wallet Component" caption="Example of a Wallet Component using the GoldRush UI Kit" />
GoldRush consists of the following self-serve products that can be used independently or together to power your application:

4. [GoldRush Decoder](https://github.com/covalenthq/goldrush-decoder/?utm_source=sei&utm_medium=partner-docs) -
decode any raw event logs into human-readable structured data.
| **Product Name** | **Description** | **Key Data Feeds** | **Use Cases** |
| -------------------- | ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **Foundational API** | Access structured historical blockchain data across 100+ chains via REST APIs | <ul><li>Token balances (spot & historical)</li><li>Token transfers</li><li>Token holders (spot & historical)</li><li>Token prices (onchain)</li><li>Wallet transactions</li><li>Get logs</li></ul> | <ul><li>Wallets</li><li>Portfolio trackers</li><li>Crypto accounting & tax tools</li><li>DeFi dashboards</li><li>Activity feeds</li></ul> |
| **Streaming API** | Subscribe to real-time blockchain events with sub-second latency using GraphQL over WebSockets | <ul><li>OHLCV tokens & pairs</li><li>New & updated DEX pairs</li><li>Wallet activity</li><li>Token balances</li></ul> | <ul><li>Trading dashboards</li><li>Sniper bots</li><li>Gaming</li><li>Agentic workflows</li></ul> |

## Get started
The **[GoldRush TypeScript SDK](https://www.npmjs.com/package/@covalenthq/client-sdk)** is the fastest way to integrate the GoldRush APIs. Install with:

- [API Key](https://goldrush.dev/platform/auth/register/?utm_source=sei&utm_medium=partner-docs) -
sign up for free
- [Docs](https://goldrush.dev/docs/?utm_source=sei&utm_medium=partner-docs) -
comprehensive knowledge base for all things GoldRush including a quickstart
- [Sei Network Details](https://goldrush.dev/chains/sei/?utm_source=sei&utm_medium=partner-docs) -
setup details and supported APIs for Sei
- [Guides](https://goldrush.dev/guides/?utm_source=sei&utm_medium=partner-docs) -
learn how to build for various use cases and expand your onchain knowledge
```bash
npm install @covalenthq/client-sdk
```
Binary file not shown.