Bear Network Chain SDK

https://github.com/BearNetwork-BRNKC/bearnetworksdk

熊網鏈 SDK 是一個基於 Web3.js 的工具包,旨在幫助開發者輕鬆集成熊網鏈 (Bear Network Chain, BRNKC) 的功能。該 SDK 包含地址驗證、網絡檢查、交易與錢包交互等常用功能,並支持與 MetaMask 錢包的無縫連接。

功能特點

  1. 網絡檢查

    • 確認當前是否連接到熊網鏈 (Bear Network Chain)。

  2. 地址驗證

    • 驗證用戶輸入的地址是否為合法的區塊鏈地址。

  3. 智能合約地址檢查

    • 確認指定的地址是否為智能合約地址。

  4. MetaMask 支援

    • 通過 MetaMask 完成帳戶連接和交易。

  5. 高度可擴展

    • 提供模組化設計,可根據項目需求自定義功能。

安裝

通過 Git 下載安裝:

git clone https://github.com/BearNetwork-BRNKC/bearnetworksdk.git

cd bearnetworksdk

npm install web3

快速開始

1. 錢包自定義參數

在使用 SDK 前,請將 MetaMask 或其他支持自定義 RPC 的錢包配置如下:

  • RPC URL: https://brnkc-mainnet.bearnetwork.net

  • 鏈 ID: 641230

  • 代幣名稱: BRNKC

2. 初始化 SDK

在使用 SDK 前,確保環境中安裝了 MetaMask 並完成上述錢包配置。

const Web3 = require('web3');
const { checkIfOnBearNetwork } = require('./utils');

const web3 = new Web3(window.ethereum);

// 初始化 SDK 並檢查 MetaMask 連接
async function initializeSdk() {
    try {
        const accounts = await window.ethereum.request({ method: 'eth_requestAccounts' });
        console.log('Connected account:', accounts[0]);

        // 檢查是否在熊網鏈上
        const networkStatus = await checkIfOnBearNetwork(web3);
        if (!networkStatus.isBearNetwork) {
            console.error(networkStatus.error);
        } else {
            console.log('You are on Bear Network!');
        }
    } catch (error) {
        console.error('Failed to initialize SDK:', error);
    }
}

initializeSdk();

接口文檔

checkIfOnBearNetwork(web3)

檢查當前網絡是否為熊網鏈。

  • 參數:

    • web3 (Web3 實例): Web3 的初始化實例。

  • 返回值:

    • isBearNetwork (布林值): 是否為熊網鏈。

    • error (字串): 如果非熊網鏈,返回錯誤信息。

isValidAddress(address)

驗證給定地址是否為合法的區塊鏈地址。

  • 參數:

    • address (字串): 欲驗證的地址。

  • 返回值:

    • isValid (布林值): 地址是否合法。

    • error (字串): 如果地址無效,返回錯誤信息。

isContractAddress(web3, address)

檢查指定地址是否為智能合約地址。

  • 參數:

    • web3 (Web3 實例): Web3 的初始化實例。

    • address (字串): 欲檢查的地址。

  • 返回值:

    • isContract (布林值): 是否為智能合約地址。

    • address (字串): 原始地址。

    • error (字串): 如果檢查過程中出現錯誤,返回錯誤信息。

貢獻指南

  1. Fork 本倉庫。

  2. 創建特性分支 (git checkout -b feature/your-feature)。

  3. 提交更改 (git commit -m 'Add your feature')。

  4. 推送到分支 (git push origin feature/your-feature)。

  5. 提交 Pull Request。

聯繫我們

如果您在使用 SDK 的過程中有任何問題,歡迎通過以下方式聯繫我們:

Last updated