@bestinslot/wallet-kit 0.13.6 → 0.13.7

package/dist/react.js

@@ -1,12 +1,12 @@
 import { useSyncExternalStore as u, useCallback as r, useState as w } from "react";
-import { R as c, d as t, i as l, h as n } from "./mint-C_wN10-d.js";
+import { T as c, e, k as l, i as n } from "./mint-D4wMHU5r.js";
 function m() {
-  const e = u(c, t, t), s = r((o) => l(o), []);
-  return [e, s];
+  const t = u(c, e, e), s = r((o) => l(o), []);
+  return [t, s];
 }
 function S() {
-  const e = u(c, t, t), [s, o] = w(() => n() ?? null), a = r(() => o(n() ?? null), []), k = r((i) => l(i), []);
-  return { session: s, network: e, setNetwork: k, refresh: a };
+  const t = u(c, e, e), [s, o] = w(() => n() ?? null), a = r(() => o(n() ?? null), []), k = r((i) => l(i), []);
+  return { session: s, network: t, setNetwork: k, refresh: a };
 }
 export {
   m as useNetwork,

package/dist/{register-browser-providers-J2bm6PEo.js → register-browser-providers-B5u1iRRq.js}

@@ -1,5 +1,5 @@
-import { D as l, C as x, E as b, d, S as B, G as p, f as S, T, Q as P } from "./mint-C_wN10-d.js";
-async function X() {
+import { F as l, E as x, G as b, e as d, U as B, I as p, h as S, V as P, S as T } from "./mint-D4wMHU5r.js";
+async function C() {
   if (!window.LeatherProvider) throw new Error("Leather extension not found.");
   const e = await window.LeatherProvider.request("getAddresses");
   if (!e) throw new Error("Failed to get wallets.");
@@ -92,14 +92,14 @@ async function I(e, n, t, s, o, i) {
   };
 }
 const A = {
-  getWallets: X,
+  getWallets: C,
   signMessage: $,
   signMessageDeterministic: L,
   sendBTC: F,
   signPSBT: M,
   sign: I
 };
-async function K() {
+async function U() {
   if (!window.okxwallet) throw new Error("OKX extension not found.");
   const e = d();
   let n;
@@ -116,24 +116,24 @@ async function K() {
     }
   ];
 }
-function C() {
+function H() {
   const e = d();
   if (e === "mainnet") return window.okxwallet?.bitcoin;
   if (e === "testnet") return window.okxwallet?.bitcoinTestnet;
   if (e === "signet") return window.okxwallet?.bitcoinSignet;
 }
-async function U() {
-  const e = C();
+async function K() {
+  const e = H();
   return typeof e?.getAccounts != "function" ? [] : await e.getAccounts() ?? [];
 }
-function D(e) {
-  const n = C();
+function N(e) {
+  const n = H();
   if (typeof n?.on != "function") return () => {
   };
   const t = (s) => e(s?.address ? [s.address] : []);
   return n.on("accountChanged", t), () => n.removeListener?.("accountChanged", t);
 }
-async function N(e) {
+async function q(e) {
   if (!window.okxwallet) throw new Error("OKX extension not found.");
   const n = d();
   let t;
@@ -146,7 +146,7 @@ async function N(e) {
   else throw new Error("Unsupported network for OKX.");
   return p.from(t, "base64").toString("hex");
 }
-async function q(e) {
+async function D(e) {
   if (!window.okxwallet) throw new Error("OKX extension not found.");
   const n = S();
   if (!n) throw new Error("No payment wallet found.");
@@ -239,11 +239,11 @@ async function W(e, n, t, s, o, i) {
   };
 }
 const _ = {
-  getWallets: K,
-  getAccounts: U,
-  onAccountsChanged: D,
-  signMessage: N,
-  signMessageDeterministic: q,
+  getWallets: U,
+  getAccounts: K,
+  onAccountsChanged: N,
+  signMessage: q,
+  signMessageDeterministic: D,
   sendBTC: O,
   signPSBT: v,
   sign: W
@@ -273,7 +273,7 @@ function R(e) {
   const t = (s) => e(s ?? []);
   return n.on("accountsChanged", t), () => n.removeListener?.("accountsChanged", t);
 }
-async function j(e) {
+async function V(e) {
   await k();
   try {
     const n = await window.unisat.signMessage(e, "bip322-simple");
@@ -282,7 +282,7 @@ async function j(e) {
     throw console.error("Failed to sign message", n), new Error("Failed to sign message.");
   }
 }
-async function Q(e) {
+async function j(e) {
   await k();
   const n = S();
   if (!n) throw new Error("No payment wallet found.");
@@ -297,7 +297,7 @@ async function Q(e) {
     throw console.error("Failed to sign message", s), new Error("Failed to sign message.");
   }
 }
-async function V(e, n) {
+async function J(e, n) {
   await k();
   try {
     return await window.unisat.sendBitcoin(n, e);
@@ -328,7 +328,7 @@ async function E(e, n, t) {
   }
   return n && (o = await window.unisat.pushPsbt(o)), o;
 }
-async function J(e, n, t, s, o, i) {
+async function Q(e, n, t, s, o, i) {
   let r = null;
   if (!n)
     r = await E(x(e), !1, []);
@@ -368,11 +368,11 @@ const Y = {
   getWallets: G,
   getAccounts: z,
   onAccountsChanged: R,
-  signMessage: j,
-  signMessageDeterministic: Q,
-  sendBTC: V,
+  signMessage: V,
+  signMessageDeterministic: j,
+  sendBTC: J,
   signPSBT: E,
-  sign: J
+  sign: Q
 };
 function y() {
   const e = d();
@@ -383,7 +383,7 @@ function y() {
 }
 async function Z() {
   if (!window.XverseProviders?.BitcoinProvider) throw new Error("Xverse extension not found.");
-  const e = T({
+  const e = P({
     purposes: ["ordinals", "payment"],
     message: "[Best in Slot] wants to know your addresses!",
     network: {
@@ -399,7 +399,7 @@ async function Z() {
 }
 async function ee(e, n, t) {
   if (!window.XverseProviders?.BitcoinProvider) throw new Error("Xverse extension not found.");
-  const s = T({
+  const s = P({
     address: t,
     message: e,
     protocol: "BIP322",
@@ -417,7 +417,7 @@ async function ne(e) {
   if (!window.XverseProviders?.BitcoinProvider) throw new Error("Xverse extension not found.");
   const n = S();
   if (!n) throw new Error("No payment wallet found.");
-  const t = n.address, s = T({
+  const t = n.address, s = P({
     address: t,
     message: e,
     protocol: "ECDSA",
@@ -445,9 +445,9 @@ async function te(e, n) {
     ]
   })).result.txid;
 }
-async function H(e, n, t, s) {
+async function X(e, n, t, s) {
   if (!window.XverseProviders?.BitcoinProvider) throw new Error("Xverse extension not found.");
-  const o = T({
+  const o = P({
     network: {
       type: y()
     },
@@ -462,7 +462,7 @@ async function se(e, n, t, s, o, i) {
   const r = l.Psbt.fromHex(e), a = [];
   for (let w = 0; w < r.inputCount; w++)
     i && i.includes(w) || s.includes(w) || a.push(w);
-  const c = await H(
+  const c = await X(
     x(e),
     !1,
     [
@@ -491,10 +491,10 @@ const ie = {
   signMessage: ee,
   signMessageDeterministic: ne,
   sendBTC: te,
-  signPSBT: H,
+  signPSBT: X,
   sign: se
 };
-P("leather", A);
-P("okx", _);
-P("unisat", Y);
-P("xverse", ie);
+T("leather", A);
+T("okx", _);
+T("unisat", Y);
+T("xverse", ie);

package/dist/types/api/wallet.d.ts

@@ -1,6 +1,6 @@
 import { WalletInfo } from '../types/wallet';
-export { getAllBalanceDetails, getCardinalBalance, getOrdinalsWallet, getPaymentWallet, getSession, sendBTC, sendInscription, setNetwork, signMessage, signMessageLocalVerify, signMessageLocalVerifyDeterministic, subscribeToAccountChanges, WalletAccountChangedError, } from '../core/bis';
-export type { AccountChangeEvent } from '../core/bis';
+export { getAllBalanceDetails, getCardinalBalance, getEndpoints, getOrdinalsWallet, getPaymentWallet, getSession, sendBTC, sendInscription, setEndpoints, setNetwork, signMessage, signMessageLocalVerify, signMessageLocalVerifyDeterministic, subscribeToAccountChanges, WalletAccountChangedError, } from '../core/bis';
+export type { AccountChangeEvent, Endpoints, EndpointsConfig } from '../core/bis';
 export type { WalletInfo };
 export { getNetwork } from '../core/store-network';
 export type { BISNetwork, BISSession, BISWallet, BISWalletProvider, BISWalletPurpose, } from '../types/common';

package/dist/types/core/bis.d.ts

@@ -5,7 +5,8 @@ export { getAllBalanceDetails, getCardinalBalance } from './helpers';
 export { getOrdinalsWallet, getPaymentWallet, sendBTC, signMessage, signMessageLocalVerify, signMessageLocalVerifyDeterministic, subscribeToAccountChanges, WalletAccountChangedError, } from './providers';
 export type { AccountChangeEvent } from './providers';
 export { getWalletInfo as getSession } from './store';
-export { getNetwork, setNetwork } from './store-network';
+export { getEndpoints, getNetwork, setEndpoints, setNetwork } from './store-network';
+export type { Endpoints, EndpointsConfig } from './store-network';
 /**
  * Sends an inscription to a target wallet with the specified postage, fee rate, and dry run option. The function determines the appropriate method for sending the inscription based on the target wallet's properties and the specified wallet type. It uses the provided signing function to sign the necessary transactions for sending the inscription.
  *

package/dist/types/core/helpers.d.ts

@@ -1,7 +1,41 @@
+import { Endpoints } from './store-network';
 import * as bitcoinjs from 'bitcoinjs-lib';
 export declare const txHexByIdCache: {
     [txid: string]: any;
 };
+/**
+ * Returns the base URL configured for an endpoint on the selected network.
+ *
+ * @param key The endpoint to resolve.
+ * @returns The base URL, without a trailing slash.
+ * @throws {Error} If the selected network has no such endpoint configured.
+ */
+export declare function getEndpointBase(key: keyof Endpoints): string;
+/**
+ * Picks the sequencer endpoint for a route: `sequencerRead` for display reads,
+ * `sequencer` for writes and pre-sign reads.
+ *
+ * @param path The route path, optionally with a sub-path and query string.
+ * @returns The endpoint key that serves the route.
+ */
+export declare function sequencerEndpointFor(path: string): 'sequencerRead' | 'sequencer';
+/**
+ * Builds the full URL for a route on a configured endpoint, after checking that
+ * a `/v1` service serves the selected network.
+ *
+ * @param key The endpoint that serves the route.
+ * @param path The route path, with any query string, relative to the endpoint base.
+ * @returns The full URL.
+ */
+export declare function getEndpointUrl(key: keyof Endpoints, path: string): Promise<string>;
+/**
+ * Builds the full URL for a swap sequencer route, routed to `sequencerRead` or
+ * `sequencer` by {@link sequencerEndpointFor}.
+ *
+ * @param path The route path, with any query string.
+ * @returns The full URL.
+ */
+export declare function getSwapBackendUrl(path: string): Promise<string>;
 /**
  * Creates an unsecured JWT token with the given payload.
  *
@@ -185,13 +219,6 @@ export declare function verifySignature(message: string, signatureHex: string, a
  * @throws An error if the verification process fails, such as due to invalid input parameters.
  */
 export declare function verifySignatureLocal(message: string, signatureHex: string, address: string): boolean;
-/**
- * Fetches the current chain tip (the latest block height) from the backend API. The function sends a request to the backend to retrieve the current chain tip and returns it as a number. If the request fails, it throws an error indicating that the chain tip could not be retrieved.
- *
- * @returns A promise that resolves to the current chain tip (latest block height) as a number, or throws an error if the request fails.
- * @throws An error if the request to fetch the chain tip fails, indicating that the chain tip could not be retrieved.
- */
-export declare function getChainTip(): Promise<number>;
 /**
  * A generic helper function to handle fetch requests with consistent error handling.
  * It automatically checks for non-ok HTTP responses and for an 'error' field
@@ -205,13 +232,14 @@ export declare function getChainTip(): Promise<number>;
  */
 export declare function fetchWithErrors<T>(url: string, options: RequestInit): Promise<T>;
 /**
- * Retrieves the appropriate BRC2.0 public RPC URL based on the current network (signet or mainnet). The function checks the current network using the getNetwork function and returns the corresponding public RPC URL for that network. If the network is not supported, it throws an error indicating that the network is unsupported for the public RPC URL.
+ * Retrieves the BRC2.0 JSON-RPC URL configured as the `rpc` endpoint for the selected network.
  *
- * @returns The public RPC URL corresponding to the current network (signet or mainnet).
+ * @returns The RPC URL.
+ * @throws {Error} If the selected network has no RPC endpoint configured.
  */
-export declare function getPublicRpcUrl(): string;
+export declare function getPublicRpcUrl(): Promise<string>;
 /**
- * Executes an eth_call on the appropriate public RPC URL based on the current network (signet or mainnet). The function constructs the JSON-RPC request payload with the provided data and sends it to the public RPC URL for execution. It returns a promise that resolves to the result of the eth_call, or throws an error if the request fails.
+ * Executes an eth_call on the BRC2.0 RPC configured for the selected network. The function constructs the JSON-RPC request payload with the provided data and sends it to the RPC URL for execution. It returns a promise that resolves to the result of the eth_call, or throws an error if the request fails.
  *
  * @param to The address of the contract to call.
  * @param abi The ABI of the contract to call.
@@ -220,10 +248,3 @@ export declare function getPublicRpcUrl(): string;
  * @returns A promise that resolves to the result of the eth_call as a string, or throws an error if the request fails.
  */
 export declare function ethCallOnPublicRpc(to: string, abi: any, functionName: string, params: any): Promise<string>;
-/**
- * Constructs the appropriate backend URL for a given API path based on the current network (signet or mainnet). The function checks the current network using the getNetwork function and returns the corresponding URL for the swap backend API. If the network is not supported, it throws an error indicating that the network is unsupported for the orderbook backend URL.
- *
- * @param path The specific API path to append to the base URL for the swap backend.
- * @returns The full URL for the swap backend API corresponding to the current network and the provided path.
- */
-export declare function getSwapBackendUrl(path: string): string;

package/dist/types/core/store-network.d.ts

@@ -18,3 +18,45 @@ export declare function setNetwork(newNetwork: BISNetwork): void;
  * @returns An unsubscribe function that removes the listener.
  */
 export declare function subscribeToNetwork(listener: (network: BISNetwork) => void): () => void;
+/**
+ * Base URLs of the backend services the kit talks to on one network. Each is
+ * joined with a route path (`<base>/<route>`), so a trailing slash is optional.
+ */
+export interface Endpoints {
+    /** Indexer reads: UTXOs, balances, raw transactions, BIP-322 verification. */
+    indexer: string;
+    /** Bitcoin transaction submission: `testmempoolaccept` and `sendrawtransactions`. */
+    tx: string;
+    /** Swap sequencer display reads: tokens, pairs table, volume, klines, TVL, activity feeds, token decimals. */
+    sequencerRead: string;
+    /** Swap sequencer writes and the fresh reads taken right before signing (status, fees, nonce, balances, reserves, deposit, swap, withdraw, ...). */
+    sequencer: string;
+    /** BRC2.0 JSON-RPC endpoint used for `eth_call`. */
+    rpc: string;
+}
+/** Per-network endpoint overrides accepted by {@link setEndpoints}. */
+export type EndpointsConfig = {
+    [N in BISNetwork]?: Partial<Endpoints>;
+};
+/**
+ * Overrides the backend base URLs per network. Each network's entry is merged
+ * over the built-in defaults, so only the keys you pass change. Every call
+ * replaces the previous overrides; `setEndpoints({})` restores the defaults.
+ *
+ * A base URL whose path starts with `/v1` is checked against its server's
+ * `/v1/info` before the first request to that origin, and requests fail if the
+ * server reports a different network than the one selected.
+ *
+ * @param config Per-network partial endpoint maps, e.g. `{ signet: { rpc: 'https://my-rpc.example' } }`.
+ * @throws {Error} If a key is unknown or a value is not an absolute http(s) URL.
+ */
+export declare function setEndpoints(config: EndpointsConfig): void;
+/**
+ * Returns the effective base URLs for a network: the defaults with any
+ * {@link setEndpoints} overrides applied. Testnet has no `sequencerRead`,
+ * `sequencer` or `rpc` unless configured.
+ *
+ * @param network The network to read. Defaults to the selected network.
+ * @returns The endpoint map for that network.
+ */
+export declare function getEndpoints(network?: BISNetwork): Partial<Endpoints>;

package/dist/types/core.d.ts

@@ -4,7 +4,8 @@ export * as brc20 from './api/brc20';
 export * as mint from './api/mint';
 export * as balances from './api/balances';
 export * from './api/helpers';
-export { getNetwork, setNetwork, subscribeToNetwork } from './core/store-network';
+export { getEndpoints, getNetwork, setEndpoints, setNetwork, subscribeToNetwork, } from './core/store-network';
+export type { Endpoints, EndpointsConfig } from './core/store-network';
 export type { PaymentOpts } from './types/common';
 export * as bitcoinjs from 'bitcoinjs-lib';
 export * as Buff from '@cmdcode/buff-utils';

package/dist/vue.js

@@ -1,13 +1,13 @@
-import { ref as s, onScopeDispose as i, watch as u } from "vue";
-import { d as r, R as c, i as a } from "./mint-C_wN10-d.js";
-function w() {
-  const e = s(r()), t = c((o) => {
-    e.value !== o && (e.value = o);
+import { ref as s, onScopeDispose as u, watch as i } from "vue";
+import { e as r, T as c, k as a } from "./mint-D4wMHU5r.js";
+function n() {
+  const o = s(r()), t = c((e) => {
+    o.value !== e && (o.value = e);
   });
-  return i(t, !0), u(e, (o) => {
-    o !== r() && a(o);
-  }), e;
+  return u(t, !0), i(o, (e) => {
+    e !== r() && a(e);
+  }), o;
 }
 export {
-  w as useNetwork
+  n as useNetwork
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bestinslot/wallet-kit",
   "type": "module",
-  "version": "0.13.6",
+  "version": "0.13.7",
   "private": false,
   "description": "A lightweight JavaScript library for connecting Bitcoin wallets with a unified API.",
   "license": "MIT",