diff --git a/content/evm/indexer-providers/goldrush.mdx b/content/evm/indexer-providers/goldrush.mdx index d4a9129e..57d734d4 100644 --- a/content/evm/indexer-providers/goldrush.mdx +++ b/content/evm/indexer-providers/goldrush.mdx @@ -4,118 +4,170 @@ 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'; +import { IconCode, IconChevronRight } from '@tabler/icons-react'; # 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. - -[Sign up to start building on Sei](https://goldrush.dev/platform/?utm_source=sei&utm_medium=partner-docs) - -## 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); - } - })(); - ``` - -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. - - - -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. - -## Get started - -- [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) - +## Overview + +GoldRush offers the most comprehensive Sei Data API suite for developers, analysts, and enterprises. Whether you're +building a DeFi dashboard, a wallet, a trading bot, an AI agent or a compliance platform, +our Sei Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. + +### Supported APIs + +| **Product Name** | **Description** | **Key Data Feeds** | **Use Cases** | +| -------------------- | ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | +| **Foundational API** | Access structured historical blockchain data across 100+ chains via REST APIs | | | + +## Mainnet + +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Property + + Value +
+ Chain Name + + sei-mainnet +
+ Chain ID + + 1329 +
+ Network Type + Frontier Chain
+ Support Level + frontier
+ Block Explorer + + Explorer +
+ Official Website + + Sei Website +
+ Native Gas Token + SEI
+
+
+ +## API Usage + +To use this blockchain network in GoldRush API calls, use: + +#### Chain Name + +- `sei-mainnet` (mainnet) + +#### Example API Calls (bash) + +```bash +curl -X GET "https://api.covalenthq.com/v1/sei-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" +``` + +### SDK Usage (TypeScript) + +```ts +import { GoldRushClient } from '@covalenthq/client-sdk'; + +const client = new GoldRushClient('API_KEY'); + +const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ + chainName: 'sei-mainnet', + walletAddress: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045' +}); +``` + +## Foundational API Support + +This chain supports **34** GoldRush Foundational APIs: + +#### Wallet API + +- **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address)** +- **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance)** +- **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time)** +- **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address)** + +#### Pricing API + +- **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices)** + +#### Security API + +- **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address)** + +#### Activity Feed API + +- **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction)** +- **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address)** +- **[Get earliest transactions for address (v3) ](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3)** +- **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3)** +- **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3)** +- **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3)** +- **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block)** +- **[Get all transactions in a block by page (v3) ](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page)** + +#### Block Explorer API + +- **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block)** +- **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses)** +- **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains)** +- **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights)** +- **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices)** +- **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address)** +- **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash)** +- **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs)** + +## Additional Resources + +- [Goldrush 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 +- [API Reference](https://goldrush.dev/docs/api-reference/) +- [API Key](https://goldrush.dev/platform/auth/register/?utm_source=sei&utm_medium=partner-docs) - + sign up for free