@1sat/wallet-toolbox 0.0.73 → 0.0.74

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,35 +103,6 @@ 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
 // ============================================================================
@@ -140,5 +111,4 @@ export const balanceSkills = [
     getBalance,
     getPaymentUtxos,
     getExchangeRate,
-    getChainInfo,
 ];

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,

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/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/package.json

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