Chains Lib Documentation
Chainslib is a TypeScript library is designed to provide a unified interface for working with multiple blockchain networks, allowing developers to interact with various blockchain chains seamlessly. It supports a wide range of features and blockchain networks, making it a versatile tool for blockchain development.
Features
Chainslib offers the following key features:
- Hardware Wallet Support: It provides integration with Ledger and Trezor hardware wallets for enhanced security in blockchain transactions.
- Wallet Types: You can work with both seed phrase and private key wallets for managing your blockchain assets.
- Standardized RPC Interface: The library offers a consistent RPC interface for fetching blockchain information and broadcasting transactions across different supported chains.
Supported Chains
Chainslib currently supports the following blockchain networks:
- Bitcoin
- Bitcoin Cash
- Litecoin
- Dogecoin
- Ethereum
- BNB Smart Chain
- Avalanche
- Polygon
- Optimism
- Arbitrum
- Fantom
- Other EVM-compatible chains
- Cosmos
- Osmosis
- Juno
- Other IBC-Compatible Chains
- THORChain
- BNB Beacon Chain
- Solana
Installation
To use Chainslib in your TypeScript project, you can install it via npm or yarn:
npm install @xdefi-tech/chains
# or
yarn add @xdefi-tech/chains
Usage
Here's a basic example of how to use this library in your TypeScript application:
1. Import Required Modules
import { BitcoinProvider } from "./chain.provider";
import LedgerSigner from "./ledger.signer";
import { MsgBody, Msg } from "../msg";
2. Initialize Bitcoin Provider
Initialize the Bitcoin provider with the necessary configurations:
const provider = new BitcoinProvider(new IndexerDataSource(BITCOIN_MANIFEST));
3. Create Transaction Input
Define the transaction input data, including the sender (from), recipient (to), and the amount to send.
const txInput: MsgBody = {
from: "FROM ADDRESS",
to: "TO ADDRESS",
amount: 0.000001,
};
4. Create a Transaction Message
Create a transaction message using the provider:
const message: Msg = provider.createMsg(txInput);
5. Sign the Transaction with Ledger
Use the LedgerSigner to sign the transaction. Provide the message and the derivation path:
const transport = await Transport.create();
const signer = new LedgerSigner(transport);
const derivationPath = "m/84'/0'/0'/0/0";
await signer.sign(message, derivationPath);
// finally close
transport.close();
6. Broadcast the Transaction
Now that the transaction is signed, you can broadcast it to the Bitcoin network using the BitcoinProvider. This step assumes that the transaction is already signed within the message
.
await provider.broadcast([message]);
Retrieving a Transaction
1. Get Transaction Hash
If you have a transaction hash, you can retrieve the transaction details. Use the getTransaction
method of the BitcoinProvider:
const txHash = "TX HAS";
const txData = await provider.getTransaction(txHash);
The txData
object will contain transaction details, including the transaction hash.
Disclaimer
This library is provided as-is, and we make no warranties or guarantees regarding its functionality or security. Always exercise caution and proper security practices when working with blockchain assets.
Happy blockchain development! 🚀🔗