1.0.4 β’ Published 4 months ago
blockradar-sdk v1.0.4
Blockradar Node.js SDK π
A powerful SDK to interact with Blockradar APIs seamlessly.
π Features
- Wallet Management: Manage, and interact with wallets.
- Asset Management: Retrieves the assets associated with a specific wallet, add assets to wallet and more.
- Address Operations: Retrieve addresses associated with a specific wallet, withdrawal and more.
- Transactions Management: Fetch transactions, initiate a sweep of assets and more.
- AML(Anti Money Laundering) Module: Perform an anti-money laundering (AML) lookup for a given address and blockchain.
- Auto Settlements Module: Add a beneficiary to a specific wallet, fetch beneficiaries, and more.
- Asset Recovery Module: Calculates and returns the estimated network fee and more.
- Payment Links Module: create a payment link, retrieve links, and more.
- Custom Smart Contracts: Interacting with smart contracts on the blockchain.
- Miscellaneous Module: Additional operations & utilities.
- Easy-to-Use API: Designed for Node.js developers.
- Type Safety: Fully typed methods for params & responses.
π¦ Installation
npm install blockradar-sdk
π Quick Start
const BlockRadar = require("blockradar-sdk");
// ππ½ for ES6 & TS
import BlockRadar from "blockradar-sdk";
// ----- Initialize the SDK ----------
const sdk = new BlockRadar(process.env.API_KEY, "<wallet_id>");
async function main() {
const wallet = await sdk.wallet.retrieve();
console.log("Wallet:", wallet);
const balance = await sdk.address.getBalance({ addressId: "<addressid>" });
console.log("Balance:", balance);
}
main();
π Modules Overview
1οΈβ£ Wallet Module
Retrieve wallet information
(async () => {
const wallet = await sdk.wallet.retrieve();
console.log("Wallet: ", wallet);
})();
Update wallet information
(async () => {
const wallet = await sdk.wallet.updateWallet({ name: "", description: "" });
console.log("Update wallet: ", wallet);
})();
2οΈβ£ Asset Module
Retrieve assets associated with a specific wallet
(async () => {
const assets = await sdk.asset.getWalletAssets();
console.log("Wallet assets: ", assets);
})();
π Development Progress
Features & Tasks | Status | Notes |
---|---|---|
BlockRadar API implementation | β Done | Supports creating and managing wallets, address operations, payment links, etc |
README Docs | π In Progress | SDK usage docs |
Tests | π In Progress | Tests for each module |
Types & interfaces | π In Progress | Types & interfaces for all function params & responses |
Github workflow for npm package CD | β Not Done | Planned for future updates |
π¨βπ» Contributing β We Welcome PRs! π€
We love contributions! If you have suggestions, bug reports, or improvements, feel free to open an issue or submit a pull request (PR).
π How to Contribute
Follow these simple steps to fork, edit, and submit a PR:
1οΈβ£ Fork the Repository
Click the "Fork" button at the top right of the repo to create your own copy.
2οΈβ£ Clone Your Fork
Once forked, clone the repo to your local machine:
git clone https://github.com/your-username/repo-name.git
cd repo-name
3οΈβ£ Create a New Branch
Before making changes, create a new branch:
git checkout -b feature-or-bugfix-name
4οΈβ£ Make Your Changes & Commit
Edit the code, then commit your changes:
git add .
git commit -m "feat: Add awesome new feature"
5οΈβ£ Push to Your Fork
git push origin feature-or-bugfix-name
6οΈβ£ Open a Pull Request (PR)
- Go to the original repo on GitHub.
- Click "Compare & pull request".
- Add a clear title and description of your changes.
- Click "Create pull request"! π
β Contribution Guidelines
β Keep PRs focused on one feature or fix.
β Follow the projectβs code style & linting rules.
β Link any related issues in the PR description.
β Be respectful & collaborative in discussions.
π License
MIT License