@1sat/wallet-toolbox 0.0.73 → 0.0.75

package/dist/api/balance/index.d.ts

@@ -36,15 +36,5 @@ export type GetExchangeRateInput = Record<string, never>;
  * Get current BSV/USD exchange rate.
  */
 export declare const getExchangeRate: Skill<GetExchangeRateInput, number>;
-/** Input for getChainInfo skill (no required params) */
-export type GetChainInfoInput = Record<string, never>;
-/** Output for getChainInfo skill */
-export interface ChainInfo {
-    blocks: number;
-}
-/**
- * Get chain info from WhatsOnChain.
- */
-export declare const getChainInfo: Skill<GetChainInfoInput, ChainInfo | null>;
 /** All balance skills for registry */
-export declare const balanceSkills: (Skill<GetBalanceInput, Balance> | Skill<GetPaymentUtxosInput, PaymentUtxo[]> | Skill<GetExchangeRateInput, number> | Skill<GetChainInfoInput, ChainInfo | null>)[];
+export declare const balanceSkills: (Skill<GetBalanceInput, Balance> | Skill<GetPaymentUtxosInput, PaymentUtxo[]> | Skill<GetExchangeRateInput, number>)[];

package/dist/api/balance/index.js

@@ -103,42 +103,8 @@ export const getExchangeRate = {
         return fetchExchangeRate(ctx.chain, ctx.wocApiKey);
     },
 };
-/**
- * Get chain info from WhatsOnChain.
- */
-export const getChainInfo = {
-    meta: {
-        name: "getChainInfo",
-        description: "Get current chain info (block height) from WhatsOnChain",
-        category: "balance",
-        inputSchema: {
-            type: "object",
-            properties: {},
-        },
-    },
-    async execute(ctx) {
-        const baseUrl = ctx.chain === "main" ? WOC_MAINNET_URL : WOC_TESTNET_URL;
-        const headers = {};
-        if (ctx.wocApiKey)
-            headers["woc-api-key"] = ctx.wocApiKey;
-        try {
-            const response = await fetch(`${baseUrl}/chain/info`, { headers });
-            if (!response.ok)
-                return null;
-            return await response.json();
-        }
-        catch {
-            return null;
-        }
-    },
-};
 // ============================================================================
 // Module exports
 // ============================================================================
 /** All balance skills for registry */
-export const balanceSkills = [
-    getBalance,
-    getPaymentUtxos,
-    getExchangeRate,
-    getChainInfo,
-];
+export const balanceSkills = [getBalance, getPaymentUtxos, getExchangeRate];

package/dist/api/locks/index.js

@@ -4,7 +4,7 @@
  * Skills for time-locking BSV.
  */
 import { Hash, PublicKey, Script, Transaction, TransactionSignature, Utils, } from "@bsv/sdk";
-import { LOCK_BASKET, LOCK_PREFIX, LOCK_SUFFIX, MIN_UNLOCK_SATS, WOC_MAINNET_URL, WOC_TESTNET_URL, } from "../constants";
+import { LOCK_BASKET, LOCK_PREFIX, LOCK_SUFFIX, MIN_UNLOCK_SATS, } from "../constants";
 // ============================================================================
 // Constants
 // ============================================================================
@@ -21,21 +21,6 @@ function buildLockScript(address, until) {
         .writeNumber(until)
         .writeScript(Script.fromHex(LOCK_SUFFIX));
 }
-async function getChainInfoInternal(chain, wocApiKey) {
-    const baseUrl = chain === "main" ? WOC_MAINNET_URL : WOC_TESTNET_URL;
-    const headers = {};
-    if (wocApiKey)
-        headers["woc-api-key"] = wocApiKey;
-    try {
-        const response = await fetch(`${baseUrl}/chain/info`, { headers });
-        if (!response.ok)
-            return null;
-        return await response.json();
-    }
-    catch {
-        return null;
-    }
-}
 /**
  * Get lock data summary.
  */
@@ -51,8 +36,9 @@ export const getLockData = {
     },
     async execute(ctx) {
         const lockData = { totalLocked: 0, unlockable: 0, nextUnlock: 0 };
-        const chainInfo = await getChainInfoInternal(ctx.chain, ctx.wocApiKey);
-        const currentHeight = chainInfo?.blocks || 0;
+        if (!ctx.services)
+            return lockData;
+        const currentHeight = await ctx.services.chaintracks.currentHeight();
         const result = await ctx.wallet.listOutputs({
             basket: LOCK_BASKET,
             includeTags: true,
@@ -178,11 +164,9 @@ export const unlockBsv = {
     },
     async execute(ctx) {
         try {
-            const chainInfo = await getChainInfoInternal(ctx.chain, ctx.wocApiKey);
-            const currentHeight = chainInfo?.blocks || 0;
-            if (currentHeight === 0) {
-                return { error: "could-not-get-block-height" };
-            }
+            if (!ctx.services)
+                return { error: "services-required" };
+            const currentHeight = await ctx.services.chaintracks.currentHeight();
             const result = await ctx.wallet.listOutputs({
                 basket: LOCK_BASKET,
                 includeTags: true,
@@ -244,6 +228,9 @@ export const unlockBsv = {
             for (let i = 0; i < maturedLocks.length; i++) {
                 const lock = maturedLocks[i];
                 const input = tx.inputs[i];
+                if (!lock.output.lockingScript || !input.sourceTXID) {
+                    return { error: "missing-lock-data" };
+                }
                 const lockingScript = Script.fromHex(lock.output.lockingScript);
                 const preimage = TransactionSignature.format({
                     sourceTXID: input.sourceTXID,

package/dist/api/ordinals/index.js

@@ -175,9 +175,12 @@ export async function buildTransferOrdinals(ctx, request) {
             });
             recipientAddress = PublicKey.fromString(publicKey).toAddress();
         }
-        else {
+        else if (address) {
             recipientAddress = address;
         }
+        else {
+            return { error: "must-provide-counterparty-or-address" };
+        }
         // Preserve important tags from source output
         const tags = [];
         for (const tag of ordinal.tags ?? []) {
@@ -188,7 +191,7 @@ export async function buildTransferOrdinals(ctx, request) {
             }
         }
         const sourceName = extractName(ordinal.customInstructions);
-        inputs.push({
+        inputs?.push({
             outpoint,
             inputDescription: "Ordinal to transfer",
             unlockingScriptLength: 108,
@@ -196,7 +199,7 @@ export async function buildTransferOrdinals(ctx, request) {
         // Only track output in wallet when transferring to a counterparty (wallet can derive keys to spend it)
         // External address transfers are NOT tracked since the wallet cannot spend them
         if (counterparty) {
-            outputs.push({
+            outputs?.push({
                 lockingScript: new P2PKH().lock(recipientAddress).toHex(),
                 satoshis: 1,
                 outputDescription: "Ordinal transfer",
@@ -211,7 +214,7 @@ export async function buildTransferOrdinals(ctx, request) {
         }
         else {
             // External address - output is not tracked in wallet
-            outputs.push({
+            outputs?.push({
                 lockingScript: new P2PKH().lock(recipientAddress).toHex(),
                 satoshis: 1,
                 outputDescription: "Ordinal transfer to external address",
@@ -396,7 +399,7 @@ export const transferOrdinals = {
                 inputs: params.inputs,
                 outputs: params.outputs?.map((o) => ({
                     ...o,
-                    lockingScript: o.lockingScript?.slice(0, 20) + "...",
+                    lockingScript: `${o.lockingScript?.slice(0, 20)}...`,
                 })),
             }, null, 2));
             // Debug: Check if BEEF contains the source transactions

package/dist/api/sweep/index.js

@@ -5,8 +5,7 @@
  */
 import { BSV21 } from "@bopen-io/templates";
 import { P2PKH, PrivateKey, PublicKey, Transaction, Utils, } from "@bsv/sdk";
-import { deriveFundAddress } from "../../indexers";
-import { BSV21_BASKET, BSV21_FEE_SATS, BSV21_PROTOCOL, ONESAT_PROTOCOL, } from "../constants";
+import { BSV21_BASKET, BSV21_PROTOCOL, ONESAT_PROTOCOL } from "../constants";
 export * from "./types";
 /**
  * Prepare sweep inputs from IndexedOutput objects by fetching locking scripts.
@@ -359,19 +358,19 @@ export const sweepOrdinals = {
                 outputs,
                 options: { signAndProcess: false, randomizeOutputs: false },
             };
-            console.log(`[sweepOrdinals] === CREATE ACTION ARGS ===`);
+            console.log("[sweepOrdinals] === CREATE ACTION ARGS ===");
             console.log(`[sweepOrdinals] description: ${createActionArgs.description}`);
             console.log(`[sweepOrdinals] inputBEEF length: ${beefData.length} bytes`);
             console.log(`[sweepOrdinals] inputs count: ${inputDescriptors.length}`);
             console.log(`[sweepOrdinals] outputs count: ${outputs.length}`);
-            console.log(`[sweepOrdinals] inputs:`, JSON.stringify(inputDescriptors, null, 2));
-            console.log(`[sweepOrdinals] outputs:`, JSON.stringify(outputs, null, 2));
-            console.log(`[sweepOrdinals] options:`, JSON.stringify(createActionArgs.options));
-            console.log(`[sweepOrdinals] Calling createAction...`);
+            console.log("[sweepOrdinals] inputs:", JSON.stringify(inputDescriptors, null, 2));
+            console.log("[sweepOrdinals] outputs:", JSON.stringify(outputs, null, 2));
+            console.log("[sweepOrdinals] options:", JSON.stringify(createActionArgs.options));
+            console.log("[sweepOrdinals] Calling createAction...");
             let createResult;
             try {
                 createResult = await ctx.wallet.createAction(createActionArgs);
-                console.log(`[sweepOrdinals] createAction returned:`, JSON.stringify(createResult, (key, value) => {
+                console.log("[sweepOrdinals] createAction returned:", JSON.stringify(createResult, (key, value) => {
                     // Don't stringify large binary data
                     if (key === "tx" && value instanceof Uint8Array)
                         return `<Uint8Array ${value.length} bytes>`;
@@ -381,12 +380,12 @@ export const sweepOrdinals = {
                 }, 2));
             }
             catch (createError) {
-                console.error(`[sweepOrdinals] createAction threw:`, createError);
+                console.error("[sweepOrdinals] createAction threw:", createError);
                 const errorMsg = createError instanceof Error
                     ? createError.message
                     : String(createError);
                 const errorStack = createError instanceof Error ? createError.stack : undefined;
-                console.error(`[sweepOrdinals] Stack:`, errorStack);
+                console.error("[sweepOrdinals] Stack:", errorStack);
                 return { error: `createAction failed: ${errorMsg}` };
             }
             if ("error" in createResult && createResult.error) {
@@ -398,7 +397,7 @@ export const sweepOrdinals = {
             // Sign each input with our external key
             const tx = Transaction.fromBEEF(createResult.signableTransaction.tx);
             // Log transaction structure for debugging
-            console.log(`[sweepOrdinals] === Transaction Structure ===`);
+            console.log("[sweepOrdinals] === Transaction Structure ===");
             console.log(`[sweepOrdinals] Inputs (${tx.inputs.length}):`);
             let totalInputSats = 0;
             for (let i = 0; i < tx.inputs.length; i++) {
@@ -417,7 +416,7 @@ export const sweepOrdinals = {
             }
             console.log(`[sweepOrdinals] Total in: ${totalInputSats}, Total out: ${totalOutputSats}, Fee: ${totalInputSats - totalOutputSats}`);
             console.log(`[sweepOrdinals] Signable tx hex: ${Utils.toHex(createResult.signableTransaction.tx)}`);
-            console.log(`[sweepOrdinals] ==============================`);
+            console.log("[sweepOrdinals] ==============================");
             // Build a set of outpoints we control
             const ourOutpoints = new Set(inputs.map((input) => {
                 const [txid, vout] = input.outpoint.split("_");
@@ -435,12 +434,12 @@ export const sweepOrdinals = {
             await tx.sign();
             // Log signed transaction details for debugging
             const localTxid = tx.id("hex");
-            console.log(`[sweepOrdinals] === LOCAL SIGNED TX ===`);
+            console.log("[sweepOrdinals] === LOCAL SIGNED TX ===");
             console.log(`[sweepOrdinals] Local txid: ${localTxid}`);
             console.log(`[sweepOrdinals] Signed tx hex: ${tx.toHex()}`);
             // Extract unlocking scripts for signAction
             const spends = {};
-            console.log(`[sweepOrdinals] === UNLOCKING SCRIPTS FOR SIGNACTION ===`);
+            console.log("[sweepOrdinals] === UNLOCKING SCRIPTS FOR SIGNACTION ===");
             for (let i = 0; i < tx.inputs.length; i++) {
                 const txInput = tx.inputs[i];
                 const inputOutpoint = `${txInput.sourceTXID}.${txInput.sourceOutputIndex}`;
@@ -463,18 +462,18 @@ export const sweepOrdinals = {
                 return { error: String(signResult.error) };
             }
             // Debug: compare local vs signAction result
-            console.log(`[sweepOrdinals] === SIGN ACTION RESULT ===`);
+            console.log("[sweepOrdinals] === SIGN ACTION RESULT ===");
             console.log(`[sweepOrdinals] signAction txid: ${signResult.txid}`);
             // Log broadcast results if available
             if ("sendWithResults" in signResult) {
-                console.log(`[sweepOrdinals] sendWithResults:`, JSON.stringify(signResult.sendWithResults));
+                console.log("[sweepOrdinals] sendWithResults:", JSON.stringify(signResult.sendWithResults));
             }
             console.log(`[sweepOrdinals] Local txid (partial): ${localTxid}`);
-            console.log(`[sweepOrdinals] Note: TXIDs differ because local is partial (wallet input unsigned)`);
+            console.log("[sweepOrdinals] Note: TXIDs differ because local is partial (wallet input unsigned)");
             if (signResult.tx) {
                 // Parse returned BEEF to show final transaction structure
                 const returnedTx = Transaction.fromBEEF(signResult.tx);
-                console.log(`[sweepOrdinals] === FINAL TX STRUCTURE (broadcast) ===`);
+                console.log("[sweepOrdinals] === FINAL TX STRUCTURE (broadcast) ===");
                 console.log(`[sweepOrdinals] Final inputs (${returnedTx.inputs.length}):`);
                 let returnedInputSats = 0;
                 for (let i = 0; i < returnedTx.inputs.length; i++) {
@@ -501,7 +500,7 @@ export const sweepOrdinals = {
                 const satPerByte = finalFee / txSize;
                 console.log(`[sweepOrdinals] Tx size: ${txSize} bytes, Fee rate: ${satPerByte.toFixed(2)} sat/byte`);
                 if (satPerByte < 0.5) {
-                    console.warn(`[sweepOrdinals] WARNING: Fee rate seems very low!`);
+                    console.warn("[sweepOrdinals] WARNING: Fee rate seems very low!");
                 }
             }
             return {
@@ -583,6 +582,12 @@ export const sweepBsv21 = {
             if (!inputs.every((i) => i.tokenId === tokenId)) {
                 return { error: "mixed-token-ids" };
             }
+            // Lookup token details to verify it's active and get fee info
+            const tokenDetails = await ctx.services.bsv21.getTokenDetails(tokenId);
+            if (!tokenDetails.status.is_active) {
+                return { error: "token-not-active" };
+            }
+            const { fee_address, fee_per_output } = tokenDetails.status;
             // Parse WIF
             const privateKey = PrivateKey.fromWif(wif);
             // Sum all input amounts
@@ -636,11 +641,10 @@ export const sweepBsv21 = {
                     keyID,
                 }),
             });
-            // 2. Fee output (1000 sats) to overlay fund address
-            const fundAddress = deriveFundAddress(tokenId);
+            // 2. Fee output to overlay fund address
             outputs.push({
-                lockingScript: p2pkh.lock(fundAddress).toHex(),
-                satoshis: BSV21_FEE_SATS,
+                lockingScript: p2pkh.lock(fee_address).toHex(),
+                satoshis: fee_per_output,
                 outputDescription: "Overlay processing fee",
                 tags: [],
             });
@@ -698,13 +702,12 @@ export const sweepBsv21 = {
             // Submit to overlay service for indexing
             if (signResult.tx) {
                 try {
-                    const services = ctx.services;
-                    const overlayResult = await services.overlay.submitBsv21(signResult.tx, tokenId);
-                    console.log(`[sweepBsv21] Overlay submission result:`, overlayResult);
+                    const overlayResult = await ctx.services.overlay.submitBsv21(signResult.tx, tokenId);
+                    console.log("[sweepBsv21] Overlay submission result:", overlayResult);
                 }
                 catch (overlayError) {
                     // Log but don't fail the sweep - tx is already broadcast
-                    console.warn(`[sweepBsv21] Overlay submission failed:`, overlayError);
+                    console.warn("[sweepBsv21] Overlay submission failed:", overlayError);
                 }
             }
             return {

package/dist/api/tokens/index.js

@@ -252,9 +252,12 @@ export const sendBsv21 = {
             else if (paymail) {
                 return { error: "paymail-not-yet-implemented" };
             }
-            else {
+            else if (address) {
                 recipientAddress = address;
             }
+            else {
+                return { error: "must-provide-counterparty-or-address" };
+            }
             const outputs = [];
             const p2pkh = new P2PKH();
             const destinationLockingScript = p2pkh.lock(recipientAddress);
@@ -324,12 +327,11 @@ export const sendBsv21 = {
             // Submit to overlay service for indexing
             if (signResult.tx && ctx.services) {
                 try {
-                    const services = ctx.services;
-                    const overlayResult = await services.overlay.submitBsv21(signResult.tx, tokenId);
-                    console.log(`[sendBsv21] Overlay submission result:`, overlayResult);
+                    const overlayResult = await ctx.services.overlay.submitBsv21(signResult.tx, tokenId);
+                    console.log("[sendBsv21] Overlay submission result:", overlayResult);
                 }
                 catch (overlayError) {
-                    console.warn(`[sendBsv21] Overlay submission failed:`, overlayError);
+                    console.warn("[sendBsv21] Overlay submission failed:", overlayError);
                 }
             }
             return {
@@ -488,12 +490,11 @@ export const purchaseBsv21 = {
             // Submit to overlay service for indexing
             if (signResult.tx && ctx.services) {
                 try {
-                    const services = ctx.services;
-                    const overlayResult = await services.overlay.submitBsv21(signResult.tx, tokenId);
-                    console.log(`[purchaseBsv21] Overlay submission result:`, overlayResult);
+                    const overlayResult = await ctx.services.overlay.submitBsv21(signResult.tx, tokenId);
+                    console.log("[purchaseBsv21] Overlay submission result:", overlayResult);
                 }
                 catch (overlayError) {
-                    console.warn(`[purchaseBsv21] Overlay submission failed:`, overlayError);
+                    console.warn("[purchaseBsv21] Overlay submission failed:", overlayError);
                 }
             }
             return {

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export * from "./api";
 export { OneSatServices, type SyncOutput } from "./services/OneSatServices";
-export type { IndexedOutput, OrdfsMetadata, OrdfsContentOptions, OrdfsContentResponse, OrdfsResponseHeaders, Capability, } from "./services/types";
+export type { IndexedOutput, OrdfsMetadata, OrdfsContentOptions, OrdfsContentResponse, OrdfsResponseHeaders, Capability, TokenDetailResponse, TokenStatus, Bsv21TokenData, Bsv21OutputData, Bsv21TransactionData, } from "./services/types";
 export * from "./services/client";
 export { ReadOnlySigner } from "./signers/ReadOnlySigner";
 export * from "./indexers";

package/dist/indexers/Bsv21Indexer.js

@@ -56,9 +56,9 @@ export class Bsv21Indexer extends Indexer {
         if (!isDeploy) {
             try {
                 const details = await this.services.bsv21.getTokenDetails(tokenId);
-                bsv21.sym = details.sym;
-                bsv21.icon = resolveIcon(details.icon, tokenId);
-                bsv21.dec = details.dec;
+                bsv21.sym = details.token.sym;
+                bsv21.icon = resolveIcon(details.token.icon, tokenId);
+                bsv21.dec = Number(details.token.dec) || 0;
             }
             catch (e) {
                 // Token not found on server - could be unconfirmed or invalid

package/dist/indexers/types.d.ts

@@ -8,7 +8,7 @@ export interface Bsv21TokenData {
     op: string;
     amt: string;
     sym?: string;
-    dec?: number;
+    dec?: string;
     icon?: string;
     address?: string;
 }
@@ -16,15 +16,13 @@ export interface Bsv21TokenData {
  * BSV21 output data from overlay API
  */
 export interface Bsv21OutputData {
-    txid: string;
+    txid?: string;
     vout: number;
     data: {
         bsv21: Bsv21TokenData;
     };
-    script: string;
-    satoshis: number;
-    spend: string | null;
-    score: number;
+    spend?: string | null;
+    score?: number;
 }
 /**
  * BSV21 transaction data from overlay API
@@ -34,6 +32,7 @@ export interface Bsv21TransactionData {
     inputs: Bsv21OutputData[];
     outputs: Bsv21OutputData[];
     beef?: string;
+    block_height?: number;
 }
 /**
  * IndexData contains the parsed data and tags from an indexer

package/dist/services/OneSatServices.js

@@ -139,7 +139,7 @@ export class OneSatServices {
     }
     async postBeef(beef, txids) {
         console.log("[OneSatServices] postBeef called with txids:", txids);
-        console.log("[OneSatServices] BEEF structure:\n" + beef.toLogString());
+        console.log(`[OneSatServices] BEEF structure:\n${beef.toLogString()}`);
         const results = [];
         for (const txid of txids) {
             try {
@@ -149,7 +149,7 @@ export class OneSatServices {
                 console.log("[OneSatServices] AtomicBEEF length:", atomicBeef.length, "bytes");
                 // Parse back to verify structure
                 const verifyBeef = Beef.fromBinary(atomicBeef);
-                console.log("[OneSatServices] AtomicBEEF parsed back:\n" + verifyBeef.toLogString());
+                console.log(`[OneSatServices] AtomicBEEF parsed back:\n${verifyBeef.toLogString()}`);
                 // TODO: Remove hardcoded callback headers after server testing
                 const status = await this.arcade.submitTransaction(atomicBeef, {
                     callbackUrl: `${this.baseUrl}/1sat/arc/callback`,
@@ -292,10 +292,8 @@ export class OneSatServices {
                 const depth = currentHeight - tx.merklePath.blockHeight + 1;
                 return { txid, status: "mined", depth };
             }
-            else {
-                // No merkle path = known but not yet mined
-                return { txid, status: "known", depth: 0 };
-            }
+            // No merkle path = known but not yet mined
+            return { txid, status: "known", depth: 0 };
         }
         catch {
             // 404 or error from Beef = unknown

package/dist/services/client/Bsv21Client.d.ts

@@ -1,36 +1,45 @@
-import type { Bsv21TokenDetails, Bsv21TransactionData, ClientOptions, IndexedOutput } from "../types";
+import type { Bsv21TransactionData, ClientOptions, IndexedOutput, TokenDetailResponse } from "../types";
 import { BaseClient } from "./BaseClient";
 /**
  * Client for /1sat/bsv21/* routes.
  * Provides BSV21 token queries.
  *
  * Routes:
- * - GET /:tokenId - Get token details
- * - GET /:tokenId/blk/:height - Get token data at block height
- * - GET /:tokenId/tx/:txid - Get token data for transaction
+ * - POST /lookup - Bulk lookup token details with funding status
+ * - GET /:tokenId - Get token details with funding status
+ * - GET /:tokenId/tx/:txid - Get token transaction data
  * - GET /:tokenId/:lockType/:address/balance - Get token balance
  * - GET /:tokenId/:lockType/:address/unspent - Get unspent token UTXOs
  * - GET /:tokenId/:lockType/:address/history - Get token transaction history
+ * - POST /:tokenId/:lockType/balance - Multi-address token balance
+ * - POST /:tokenId/:lockType/unspent - Multi-address unspent token UTXOs
+ * - POST /:tokenId/:lockType/history - Multi-address token transaction history
  */
 export declare class Bsv21Client extends BaseClient {
     private cache;
     constructor(baseUrl: string, options?: ClientOptions);
     /**
-     * Get token details (deploy data).
-     * Results are cached since token details are immutable.
+     * Bulk lookup token details with funding status.
+     * Returns details and active status for multiple tokens in one request.
+     * @param tokenIds - Array of token IDs (max 100)
      */
-    getTokenDetails(tokenId: string): Promise<Bsv21TokenDetails>;
+    lookupTokens(tokenIds: string[]): Promise<TokenDetailResponse[]>;
+    /**
+     * Get token details with funding status.
+     * Results are cached since token deploy data is immutable.
+     */
+    getTokenDetails(tokenId: string): Promise<TokenDetailResponse>;
     /**
      * Get token transaction data for a specific txid
      */
     getTokenByTxid(tokenId: string, txid: string): Promise<Bsv21TransactionData>;
     /**
      * Get token balance for an address
-     * @param tokenId - Token ID (outpoint of deploy tx)
-     * @param lockType - Lock type (e.g., 'p2pkh', 'ordlock')
-     * @param address - Address to check
      */
-    getBalance(tokenId: string, lockType: string, address: string): Promise<bigint>;
+    getBalance(tokenId: string, lockType: string, address: string): Promise<{
+        balance: number;
+        utxoCount: number;
+    }>;
     /**
      * Get unspent token UTXOs for an address
      */
@@ -39,6 +48,24 @@ export declare class Bsv21Client extends BaseClient {
      * Get token transaction history for an address
      */
     getHistory(tokenId: string, lockType: string, address: string): Promise<IndexedOutput[]>;
+    /**
+     * Get token balance for multiple addresses
+     * @param addresses - Array of addresses (max 100)
+     */
+    getBalanceMulti(tokenId: string, lockType: string, addresses: string[]): Promise<{
+        balance: number;
+        utxoCount: number;
+    }>;
+    /**
+     * Get unspent token UTXOs for multiple addresses
+     * @param addresses - Array of addresses (max 100)
+     */
+    getUnspentMulti(tokenId: string, lockType: string, addresses: string[]): Promise<IndexedOutput[]>;
+    /**
+     * Get token transaction history for multiple addresses
+     * @param addresses - Array of addresses (max 100)
+     */
+    getHistoryMulti(tokenId: string, lockType: string, addresses: string[]): Promise<IndexedOutput[]>;
     /**
      * Clear the token details cache
      */

package/dist/services/client/Bsv21Client.js

@@ -4,12 +4,15 @@ import { BaseClient } from "./BaseClient";
  * Provides BSV21 token queries.
  *
  * Routes:
- * - GET /:tokenId - Get token details
- * - GET /:tokenId/blk/:height - Get token data at block height
- * - GET /:tokenId/tx/:txid - Get token data for transaction
+ * - POST /lookup - Bulk lookup token details with funding status
+ * - GET /:tokenId - Get token details with funding status
+ * - GET /:tokenId/tx/:txid - Get token transaction data
  * - GET /:tokenId/:lockType/:address/balance - Get token balance
  * - GET /:tokenId/:lockType/:address/unspent - Get unspent token UTXOs
  * - GET /:tokenId/:lockType/:address/history - Get token transaction history
+ * - POST /:tokenId/:lockType/balance - Multi-address token balance
+ * - POST /:tokenId/:lockType/unspent - Multi-address unspent token UTXOs
+ * - POST /:tokenId/:lockType/history - Multi-address token transaction history
  */
 export class Bsv21Client extends BaseClient {
     cache = new Map();
@@ -17,8 +20,20 @@ export class Bsv21Client extends BaseClient {
         super(`${baseUrl}/1sat/bsv21`, options);
     }
     /**
-     * Get token details (deploy data).
-     * Results are cached since token details are immutable.
+     * Bulk lookup token details with funding status.
+     * Returns details and active status for multiple tokens in one request.
+     * @param tokenIds - Array of token IDs (max 100)
+     */
+    async lookupTokens(tokenIds) {
+        return this.request("/lookup", {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(tokenIds),
+        });
+    }
+    /**
+     * Get token details with funding status.
+     * Results are cached since token deploy data is immutable.
      */
     async getTokenDetails(tokenId) {
         const cached = this.cache.get(tokenId);
@@ -36,13 +51,9 @@ export class Bsv21Client extends BaseClient {
     }
     /**
      * Get token balance for an address
-     * @param tokenId - Token ID (outpoint of deploy tx)
-     * @param lockType - Lock type (e.g., 'p2pkh', 'ordlock')
-     * @param address - Address to check
      */
     async getBalance(tokenId, lockType, address) {
-        const data = await this.request(`/${tokenId}/${lockType}/${address}/balance`);
-        return BigInt(data.balance);
+        return this.request(`/${tokenId}/${lockType}/${address}/balance`);
     }
     /**
      * Get unspent token UTXOs for an address
@@ -56,6 +67,39 @@ export class Bsv21Client extends BaseClient {
     async getHistory(tokenId, lockType, address) {
         return this.request(`/${tokenId}/${lockType}/${address}/history`);
     }
+    /**
+     * Get token balance for multiple addresses
+     * @param addresses - Array of addresses (max 100)
+     */
+    async getBalanceMulti(tokenId, lockType, addresses) {
+        return this.request(`/${tokenId}/${lockType}/balance`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(addresses),
+        });
+    }
+    /**
+     * Get unspent token UTXOs for multiple addresses
+     * @param addresses - Array of addresses (max 100)
+     */
+    async getUnspentMulti(tokenId, lockType, addresses) {
+        return this.request(`/${tokenId}/${lockType}/unspent`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(addresses),
+        });
+    }
+    /**
+     * Get token transaction history for multiple addresses
+     * @param addresses - Array of addresses (max 100)
+     */
+    async getHistoryMulti(tokenId, lockType, addresses) {
+        return this.request(`/${tokenId}/${lockType}/history`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(addresses),
+        });
+    }
     /**
      * Clear the token details cache
      */

package/dist/services/client/OverlayClient.d.ts

@@ -11,12 +11,6 @@ export interface TopicManagerInfo {
 export interface LookupServiceInfo {
     [key: string]: unknown;
 }
-/** BSV-21 token info extracted from topic managers */
-export interface Bsv21TokenInfo {
-    tokenId: string;
-    symbol?: string;
-    icon?: string;
-}
 /**
  * Client for overlay service routes.
  * Handles topic manager queries and overlay lookups.
@@ -25,23 +19,12 @@ export declare class OverlayClient extends BaseClient {
     constructor(baseUrl: string, options?: ClientOptions);
     /**
      * List all registered topic managers.
-     * BSV-21 tokens have topic managers named `tm_{tokenId}`.
      */
     listTopicManagers(): Promise<Record<string, TopicManagerInfo>>;
     /**
      * List all registered lookup service providers.
      */
     listLookupServiceProviders(): Promise<Record<string, LookupServiceInfo>>;
-    /**
-     * Get list of active BSV-21 token IDs from topic managers.
-     * Extracts tokenIds from topics matching the `tm_{tokenId}` pattern.
-     */
-    getActiveBsv21TokenIds(): Promise<string[]>;
-    /**
-     * Get active BSV-21 tokens with metadata from topic managers.
-     * Returns tokenId, symbol (from name), and icon for each active token.
-     */
-    getActiveBsv21Tokens(): Promise<Bsv21TokenInfo[]>;
     /**
      * Submit a transaction to the overlay service for indexing.
      * @param beef - BEEF data as Uint8Array or number[]

package/dist/services/client/OverlayClient.js

@@ -9,7 +9,6 @@ export class OverlayClient extends BaseClient {
     }
     /**
      * List all registered topic managers.
-     * BSV-21 tokens have topic managers named `tm_{tokenId}`.
      */
     async listTopicManagers() {
         return this.request("/1sat/overlay/listTopicManagers");
@@ -20,38 +19,6 @@ export class OverlayClient extends BaseClient {
     async listLookupServiceProviders() {
         return this.request("/1sat/overlay/listLookupServiceProviders");
     }
-    /**
-     * Get list of active BSV-21 token IDs from topic managers.
-     * Extracts tokenIds from topics matching the `tm_{tokenId}` pattern.
-     */
-    async getActiveBsv21TokenIds() {
-        const topicManagers = await this.listTopicManagers();
-        const tokenIds = [];
-        for (const topic of Object.keys(topicManagers)) {
-            if (topic.startsWith("tm_")) {
-                tokenIds.push(topic.slice(3));
-            }
-        }
-        return tokenIds;
-    }
-    /**
-     * Get active BSV-21 tokens with metadata from topic managers.
-     * Returns tokenId, symbol (from name), and icon for each active token.
-     */
-    async getActiveBsv21Tokens() {
-        const topicManagers = await this.listTopicManagers();
-        const tokens = [];
-        for (const [topic, info] of Object.entries(topicManagers)) {
-            if (topic.startsWith("tm_")) {
-                tokens.push({
-                    tokenId: topic.slice(3),
-                    symbol: info.name,
-                    icon: info.icon,
-                });
-            }
-        }
-        return tokens;
-    }
     /**
      * Submit a transaction to the overlay service for indexing.
      * @param beef - BEEF data as Uint8Array or number[]

package/dist/services/types.d.ts

@@ -195,19 +195,6 @@ export interface OrdfsContentResponse {
     data: Uint8Array;
     headers: OrdfsResponseHeaders;
 }
-/**
- * BSV21 token details (deploy data)
- */
-export interface Bsv21TokenDetails {
-    id: string;
-    txid: string;
-    vout: number;
-    op: string;
-    amt: string;
-    sym?: string;
-    dec: number;
-    icon?: string;
-}
 /**
  * BSV21 token data structure from overlay API
  */
@@ -216,23 +203,44 @@ export interface Bsv21TokenData {
     op: string;
     amt: string;
     sym?: string;
-    dec?: number;
+    dec?: string;
     icon?: string;
     address?: string;
 }
+/**
+ * BSV21 token detail response from GET /bsv21/:tokenId and POST /bsv21/lookup
+ */
+export interface TokenDetailResponse {
+    tokenId: string;
+    token: Bsv21TokenData;
+    status: TokenStatus;
+}
+/**
+ * BSV21 token funding/activity status
+ */
+export interface TokenStatus {
+    token_id: string;
+    is_active: boolean;
+    balance: number;
+    credits: number;
+    debits: number;
+    output_count: number;
+    fee_per_output: number;
+    fee_address: string;
+    is_whitelisted: boolean;
+    is_blacklisted: boolean;
+}
 /**
  * BSV21 output data from overlay API
  */
 export interface Bsv21OutputData {
-    txid: string;
+    txid?: string;
     vout: number;
     data: {
         bsv21: Bsv21TokenData;
     };
-    script: string;
-    satoshis: number;
-    spend: string | null;
-    score: number;
+    spend?: string | null;
+    score?: number;
 }
 /**
  * BSV21 transaction data from overlay API
@@ -242,6 +250,7 @@ export interface Bsv21TransactionData {
     inputs: Bsv21OutputData[];
     outputs: Bsv21OutputData[];
     beef?: string;
+    block_height?: number;
 }
 /**
  * Event from SSE subscription

package/dist/sync/SyncManager.d.ts

@@ -81,13 +81,13 @@ export interface SyncProcessorOptions {
     indexers?: Indexer[];
 }
 export interface SyncProcessorEvents {
-    "process:start": {};
+    "process:start": Record<string, never>;
     "process:progress": {
         pending: number;
         done: number;
         failed: number;
     };
-    "process:complete": {};
+    "process:complete": Record<string, never>;
     "process:error": {
         message: string;
     };
@@ -161,7 +161,7 @@ export interface SyncEvents {
         done: number;
         failed: number;
     };
-    "sync:complete": {};
+    "sync:complete": Record<string, never>;
     "sync:error": {
         message: string;
     };

package/dist/sync/SyncManager.js

@@ -44,7 +44,7 @@ export class SyncFetcher {
         }
         this.listeners
             .get(event)
-            .add(listener);
+            ?.add(listener);
     }
     off(event, listener) {
         this.listeners
@@ -52,7 +52,9 @@ export class SyncFetcher {
             ?.delete(listener);
     }
     emit(event, data) {
-        this.listeners.get(event)?.forEach((listener) => listener(data));
+        for (const listener of this.listeners.get(event) ?? []) {
+            listener(data);
+        }
     }
     /**
      * Fetch new outputs via SSE and enqueue them.
@@ -161,7 +163,7 @@ export class SyncProcessor {
         }
         this.listeners
             .get(event)
-            .add(listener);
+            ?.add(listener);
     }
     off(event, listener) {
         this.listeners
@@ -169,7 +171,9 @@ export class SyncProcessor {
             ?.delete(listener);
     }
     emit(event, data) {
-        this.listeners.get(event)?.forEach((listener) => listener(data));
+        for (const listener of this.listeners.get(event) ?? []) {
+            listener(data);
+        }
     }
     /**
      * Start processing the queue.
@@ -379,18 +383,16 @@ export class SyncProcessor {
                 },
             };
         }
-        else {
-            // P2PKH-based output - use wallet payment for auto-signing
-            return {
-                outputIndex: vout,
-                protocol: "wallet payment",
-                paymentRemittance: {
-                    derivationPrefix: derivation.derivationPrefix,
-                    derivationSuffix: derivation.derivationSuffix,
-                    senderIdentityKey: derivation.senderIdentityKey,
-                },
-            };
-        }
+        // P2PKH-based output - use wallet payment for auto-signing
+        return {
+            outputIndex: vout,
+            protocol: "wallet payment",
+            paymentRemittance: {
+                derivationPrefix: derivation.derivationPrefix,
+                derivationSuffix: derivation.derivationSuffix,
+                senderIdentityKey: derivation.senderIdentityKey,
+            },
+        };
     }
     collectTags(txo) {
         const tags = [];
@@ -467,7 +469,7 @@ export class SyncManager {
         }
         this.listeners
             .get(event)
-            .add(listener);
+            ?.add(listener);
     }
     off(event, listener) {
         this.listeners
@@ -475,7 +477,9 @@ export class SyncManager {
             ?.delete(listener);
     }
     emit(event, data) {
-        this.listeners.get(event)?.forEach((listener) => listener(data));
+        for (const listener of this.listeners.get(event) ?? []) {
+            listener(data);
+        }
     }
     // ===== Sync Control =====
     /**

package/dist/wallet/factory.js

@@ -73,7 +73,7 @@ export async function createWebWallet(config) {
     const localStorage = new StorageIdb(storageOptions);
     await localStorage.migrate(DEFAULT_DATABASE_NAME, config.storageIdentityKey);
     // 4. Create storage manager with local-only storage initially (empty backups)
-    let storage = new WalletStorageManager(identityPubKey, localStorage, []);
+    const storage = new WalletStorageManager(identityPubKey, localStorage, []);
     await storage.makeAvailable();
     // 5. Create the underlying Wallet FIRST (needed for StorageClient signing)
     const underlyingWallet = new Wallet({
@@ -175,7 +175,7 @@ export async function createWebWallet(config) {
         unprovenAttemptsLimitMain: 144,
     });
     monitor.addDefaultTasks();
-    console.log("[createWebWallet] Monitor created with tasks:", monitor["_tasks"].map((t) => t.name));
+    console.log("[createWebWallet] Monitor created with tasks:", monitor._tasks.map((t) => t.name));
     // 11. Wire up monitor callbacks - sync to remote first, then call user callbacks
     // Note: For delayed broadcasts, the monitor triggers these. For immediate broadcasts,
     // the interception in step 8 handles the sync, but these still fire for the user callback.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1sat/wallet-toolbox",
-  "version": "0.0.73",
+  "version": "0.0.75",
   "description": "BSV wallet library extending @bsv/wallet-toolbox with 1Sat Ordinals protocol support",
   "author": "1Sat Team",
   "license": "MIT",