@honeybtc/sdk

TypeScript SDK for interacting with the HoneyB Vault program on Arch Network.

Provides account decoders, PDA derivation, RPC client, and instruction builders. Works in both browser and Node.js environments.

Installation

pnpm add @honeybtc/sdk

Usage

import { HoneyBClient, createHoneyBClient } from "@honeybtc/sdk";

const client = createHoneyBClient("https://rpc.testnet.arch.network");

// Read vault state
const vault = await client.getVault();

// Read token balances
const balance = await client.getTokenBalance(vault.vaultUsdcAccount);

// Build instructions (for wallet signing)
const instructions = client.buildJoinMintQueueIx(pubkeyHex, usdcAta, amount, whitelistIdx);

API

Client

• HoneyBClient / createHoneyBClient(rpcUrl, programIdHex?, vaultId?) - RPC client with account loaders and instruction builders

Account Loaders

• getVault(), getProgramConfig(), getMintQueue(), getMintRecord(pubkey), getRedemptionRecord(pubkey), getEpochRedemption(epoch), getEpochYield(epoch)

Instruction Builders

• buildJoinMintQueueIx / buildLeaveMintQueueIx - Deposit / cancel deposit
• buildClaimMintRecordIx - Claim minted HoneyB
• buildInitiateRedemptionIx / buildCancelRedemptionIx - Redeem / cancel redemption
• buildClaimRedeemAmountIx - Claim redeemed USDC
• buildClaimEpochYieldIx - Claim yield via merkle proof
• buildInitEpochRedemptionIx - Initialize epoch redemption account
• buildCreateUserHoneyBAccountIx - Create user token account

PDA Derivation

All PDA functions are deterministic (no RPC calls):

• deriveVaultPda, deriveProgramConfigPda, deriveMintQueuePda, deriveMintRecordPda, deriveRedemptionRecordPda, deriveEpochRedemptionPda, deriveEpochYieldPda, deriveUserHoneybPda, etc.

Decoders

• decodeVault, decodeProgramConfig, decodeMintQueue, decodeMintRecord, decodeRedemptionRecord, decodeEpochRedemption, decodeEpochYield, decodeEpochYieldClaimRecord, decodeUserWhitelist

Utilities

• BytesReader / BytesWriter - Borsh binary serialization
• TOKEN_DECIMALS_DIVISOR, USDC_MINT, DEFAULT_PROGRAM_ID_HEX - Constants

Testing

pnpm test          # run all tests once
pnpm test:watch    # watch mode

Tests live in src/__tests__/. Uses Vitest.

Building

pnpm install
pnpm build    # produces dist/ with CJS + ESM + types
pnpm dev      # watch mode

Dependencies

• @saturnbtcio/arch-sdk - Arch Network RPC and transaction types
• @scure/base - Hex encoding/decoding