web3-covalent-sdk
v0.1.3
Published
A full-fledged sdk for the Covalent Unified API
Downloads
4
Readme
web3-covalent-sdk
A full-fledged sdk for the Covalent Unified API for querying on-chain data across mutliple chains.
Check out Covalent API for more info.
Quick Start
Installation
If using npm:
npm i web3-covalent-sdk
or with Yarn:
yarn add web3-covalent-sdk
Usecase addressed
A unified JavaScript SDK written in TypeScript that can be used in any Reactjs web application (in the Model Layer, taking into account that React applications follow the MVVM pattern) to access the Covalent Unified API as all-in-one library for Frontend projects.
Pitch Deck
Usage
Create a config object:
const sdKConfig: SDKConfig = {
// obtain key from: https://www.covalenthq.com/platform/#/
apiKey: process.env.COVALENT_API_KEY as string,
apiV1Url: 'https://api.covalenthq.com/v1/',
};
Create an instance of the Web3CovalentSDK class:
import { Web3CovalentSDK } from 'web3-covalent-sdk';
const web3CovalentSDK = new Web3CovalentSDK(sdKConfig)
1. Query NFT data
To query NFT TokenIds:
const contractAddress = '0xBd3531dA5CF5857e7CfAA92426877b022e612cf';
const ethereumChainId = 1;
const nftData = await web3CovalentSDK.nfts.getNFTTokenIDsForContract(
ethereumChainId,
tokenId,
contractAddress
);
console.info(nftData.items);
2. Query Transactions
To fetch a transaction based on the Transaction Hash:
const ethereumChainId = 1;
const txhash =
'0x9508e372d64c9dd36befe55ba58d66bbbc67f07ceff05c55b2ad2795bbf13a7a';
const transaction = await web3CovalentSDK.transactions.getTransaction(
ethereumChainId,
txhash
);
console.info(transaction);
3. Query Block Data
To fetch a block at a certain height:
const chainId = 1;
const blockHeight = 15410959;
const result = await web3CovalentSDK.base.getBlock(chainId, blockHeight);
const block = result.items[0];
console.info(block);
4. Query xy=k Data
To query xy=k data:
const ethereumChainId = 1;
const dexname = 'uniswap_v2';
const xyPools = await web3CovalentSDK.dexes.getXYPools(
ethereumChainId,
dexname
);
console.info(xypools.items);
5. Query Token Balances for an Address
To query token balance balance of and address:
const ethereumChainId = 1;
const address = '0xDaF81c3603C83f952376F5829a360A5822f5B5Da';
const tokenBalances = await web3CovalentSDK.balances.getTokenBalancesForAddress(
ethereumChainId,
TEST_ADDRESS
);
console.info(tokenBalances.items);
Docs
Read more in the docs
Try out in Code Sandbox
Changelog
view api changelogs