@bestinslot/wallet-kit 0.10.0 → 0.11.0

package/dist/node.js

@@ -1,7 +1,7 @@
-import { x as fI, y as KA, B as f, z as eI, A as tI, C as RA, D as d, E as SI, F as ZA, G as e, H as UA, I as nI, J as pI, K as rI, L as FI, M as sI, N as KI, O as BA, d as zA, i as eA, c as RI, P as UI, Q as qI, W as VI, a as lI, b as dI, e as xI, f as YI, h as JI, s as PI, j as vI, k as OI, l as uI, m as jI } from "./mint-CA_-62SJ.js";
-import { o as LQ, v as TQ, n as ZQ, r as zQ, p as mQ, q as XQ, t as WQ, w as _Q, u as $Q } from "./mint-CA_-62SJ.js";
-import { s as bI } from "./balances-BWhpck6N.js";
-import { c as IC, b as gC, m as QC, a as CC } from "./balances-BWhpck6N.js";
+import { x as fI, y as KA, B as f, z as eI, A as tI, C as RA, D as d, E as SI, F as ZA, G as e, H as UA, I as nI, J as pI, K as rI, L as FI, M as sI, N as KI, O as BA, d as zA, i as eA, P as RI, c as UI, Q as qI, W as VI, a as lI, b as dI, e as xI, f as YI, h as JI, s as PI, j as vI, k as OI, l as uI, m as jI } from "./mint-Dm67SjcM.js";
+import { o as LQ, v as TQ, n as ZQ, r as zQ, p as mQ, q as XQ, t as WQ, w as _Q, u as $Q } from "./mint-Dm67SjcM.js";
+import { s as bI } from "./balances-BobNsn2Y.js";
+import { c as IC, b as gC, m as QC, a as CC } from "./balances-BobNsn2Y.js";
 var LI = fI();
 const qA = {
   messagePrefix: `Bitcoin Signed Message:
@@ -1334,7 +1334,7 @@ async function MI(A, I, g = "p2wpkh", Q = "unisat") {
     pubkey: e.from(C.keyPair.publicKey).toString("hex"),
     purpose: "all"
   };
-  return UI({
+  return RI({
     provider: "local",
     wallets: [D],
     signature: null
@@ -1398,8 +1398,7 @@ async function VQ() {
 async function lQ() {
   await gA();
   const A = await z();
-  if (!A)
-    throw new Error("No private key found.");
+  if (!A) throw new Error("No private key found.");
   return [
     {
       address: A.address,
@@ -1412,8 +1411,7 @@ async function dQ(A) {
   await gA();
   try {
     const I = await z();
-    if (!I)
-      throw new Error("No private key found.");
+    if (!I) throw new Error("No private key found.");
     if (I.walletType === "p2wpkh" || I.walletType === "p2tr")
       return e.from(
         sI.Signer.sign(I.keyPair.toWIF(), I.address, A),
@@ -1427,8 +1425,7 @@ async function dQ(A) {
 async function xQ(A) {
   await gA();
   const I = await z();
-  if (!I)
-    throw new Error("No payment wallet found.");
+  if (!I) throw new Error("No payment wallet found.");
   const g = I.address;
   try {
     if (I.walletType === "p2wpkh" || I.walletType === "p2tr") {
@@ -1446,8 +1443,7 @@ async function xQ(A) {
 async function fA(A, I, g) {
   await gA();
   const Q = await z();
-  if (!Q)
-    throw new Error("No private key found.");
+  if (!Q) throw new Error("No private key found.");
   const C = d.Psbt.fromBase64(A);
   let D = null;
   if (g.length === 0)
@@ -1532,7 +1528,7 @@ async function YQ(A, I, g) {
   return y.txId;
 }
 function JQ() {
-  S.remove(GA), S.remove(IA), S.remove(wA), S.remove(HI), RI();
+  S.remove(GA), S.remove(IA), S.remove(wA), S.remove(HI), UI();
 }
 const PQ = {
   getWallets: lQ,

package/dist/react.js

@@ -1,5 +1,5 @@
 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-CA_-62SJ.js";
+import { R as c, d as t, i as l, h as n } from "./mint-Dm67SjcM.js";
 function m() {
   const e = u(c, t, t), s = r((o) => l(o), []);
   return [e, s];

package/dist/{register-browser-providers-_EU6DoLd.js → register-browser-providers-BTO9Kyf2.js}

@@ -1,10 +1,8 @@
-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-CA_-62SJ.js";
+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-Dm67SjcM.js";
 async function X() {
-  if (!window.LeatherProvider)
-    throw new Error("Leather extension not found.");
+  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.");
+  if (!e) throw new Error("Failed to get wallets.");
   return e.result.addresses.map((t) => ({
     address: t.address,
     pubkey: t.publicKey || null,
@@ -12,10 +10,8 @@ async function X() {
   }));
 }
 async function $(e, n) {
-  if (!window.LeatherProvider)
-    throw new Error("Leather extension not found.");
-  if (!n)
-    throw new Error("Wallet type is required for signing messages with Leather.");
+  if (!window.LeatherProvider) throw new Error("Leather extension not found.");
+  if (!n) throw new Error("Wallet type is required for signing messages with Leather.");
   try {
     const t = await window.LeatherProvider.request("signMessage", {
       message: e,
@@ -28,8 +24,7 @@ async function $(e, n) {
   }
 }
 async function L(e) {
-  if (!window.LeatherProvider)
-    throw new Error("Leather extension not found.");
+  if (!window.LeatherProvider) throw new Error("Leather extension not found.");
   try {
     const n = await window.LeatherProvider.request("signMessage", {
       message: e,
@@ -45,8 +40,7 @@ async function L(e) {
   }
 }
 async function F(e, n) {
-  if (!window.LeatherProvider)
-    throw new Error("Leather extension not found.");
+  if (!window.LeatherProvider) throw new Error("Leather extension not found.");
   try {
     return (await window.LeatherProvider.request("sendTransfer", {
       recipients: [
@@ -62,8 +56,7 @@ async function F(e, n) {
   }
 }
 async function M(e, n, t) {
-  if (!window.LeatherProvider)
-    throw new Error("Leather extension not found.");
+  if (!window.LeatherProvider) throw new Error("Leather extension not found.");
   const s = [];
   for (let i = 0; i < t.length; i++)
     for (let r = 0; r < t[i].signingIndexes.length; r++)
@@ -107,19 +100,14 @@ const A = {
   sign: I
 };
 async function K() {
-  if (!window.okxwallet)
-    throw new Error("OKX extension not found.");
+  if (!window.okxwallet) throw new Error("OKX extension not found.");
   const e = d();
   let n;
-  if (e === "mainnet")
-    n = await window.okxwallet.bitcoin.connect();
-  else if (e === "testnet")
-    n = await window.okxwallet.bitcoinTestnet.connect();
-  else if (e === "signet")
-    n = await window.okxwallet.bitcoinSignet.connect();
+  if (e === "mainnet") n = await window.okxwallet.bitcoin.connect();
+  else if (e === "testnet") n = await window.okxwallet.bitcoinTestnet.connect();
+  else if (e === "signet") n = await window.okxwallet.bitcoinSignet.connect();
   else throw new Error("Unsupported network for OKX.");
-  if (!n)
-    throw new Error("Error fetching wallet data.");
+  if (!n) throw new Error("Error fetching wallet data.");
   return [
     {
       address: n.address,
@@ -130,12 +118,9 @@ async function K() {
 }
 function C() {
   const e = d();
-  if (e === "mainnet")
-    return window.okxwallet?.bitcoin;
-  if (e === "testnet")
-    return window.okxwallet?.bitcoinTestnet;
-  if (e === "signet")
-    return window.okxwallet?.bitcoinSignet;
+  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();
@@ -143,15 +128,13 @@ async function U() {
 }
 function D(e) {
   const n = C();
-  if (typeof n?.on != "function")
-    return () => {
-    };
+  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) {
-  if (!window.okxwallet)
-    throw new Error("OKX extension not found.");
+  if (!window.okxwallet) throw new Error("OKX extension not found.");
   const n = d();
   let t;
   if (n === "mainnet")
@@ -164,11 +147,9 @@ async function N(e) {
   return p.from(t, "base64").toString("hex");
 }
 async function q(e) {
-  if (!window.okxwallet)
-    throw new Error("OKX extension not found.");
+  if (!window.okxwallet) throw new Error("OKX extension not found.");
   const n = S();
-  if (!n)
-    throw new Error("No payment wallet found.");
+  if (!n) throw new Error("No payment wallet found.");
   const t = n.address, s = d();
   let o;
   if (s === "mainnet")
@@ -184,8 +165,7 @@ async function q(e) {
   };
 }
 async function O(e, n) {
-  if (!window.okxwallet)
-    throw new Error("OKX extension not found.");
+  if (!window.okxwallet) throw new Error("OKX extension not found.");
   const t = d();
   let s;
   if (t === "mainnet")
@@ -269,16 +249,14 @@ const _ = {
   sign: W
 };
 async function k() {
-  if (!window.unisat)
-    throw new Error("UniSat not found.");
+  if (!window.unisat) throw new Error("UniSat not found.");
   const e = await window.unisat.getNetwork(), n = d();
   e !== "livenet" && n === "mainnet" ? await window.unisat.switchNetwork("livenet") : e === "livenet" && (n === "testnet" || n === "signet") && await window.unisat.switchNetwork("testnet");
 }
 async function G() {
   await k();
   const e = await window.unisat?.requestAccounts(), n = await window.unisat?.getPublicKey();
-  if (!e)
-    throw new Error("Failed to get wallets.");
+  if (!e) throw new Error("Failed to get wallets.");
   return e.map((s) => ({
     address: s,
     pubkey: n,
@@ -290,9 +268,8 @@ async function z() {
 }
 function R(e) {
   const n = window.unisat;
-  if (!n?.on)
-    return () => {
-    };
+  if (!n?.on) return () => {
+  };
   const t = (s) => e(s ?? []);
   return n.on("accountsChanged", t), () => n.removeListener?.("accountsChanged", t);
 }
@@ -308,8 +285,7 @@ async function j(e) {
 async function Q(e) {
   await k();
   const n = S();
-  if (!n)
-    throw new Error("No payment wallet found.");
+  if (!n) throw new Error("No payment wallet found.");
   const t = n.address;
   try {
     const s = await window.unisat.signMessage(e, "ecdsa");
@@ -330,8 +306,7 @@ async function V(e, n) {
   }
 }
 async function E(e, n, t) {
-  if (await k(), !window.unisat)
-    throw new Error("UniSat not found.");
+  if (await k(), !window.unisat) throw new Error("UniSat not found.");
   const s = B(e);
   let o = null;
   if (t.length === 0)
@@ -401,17 +376,13 @@ const Y = {
 };
 function y() {
   const e = d();
-  if (e === "mainnet")
-    return "Mainnet";
-  if (e === "testnet")
-    return "Testnet4";
-  if (e === "signet")
-    return "Signet";
+  if (e === "mainnet") return "Mainnet";
+  if (e === "testnet") return "Testnet4";
+  if (e === "signet") return "Signet";
   throw new Error("Unknown BTC network type.");
 }
 async function Z() {
-  if (!window.XverseProviders?.BitcoinProvider)
-    throw new Error("Xverse extension not found.");
+  if (!window.XverseProviders?.BitcoinProvider) throw new Error("Xverse extension not found.");
   const e = T({
     purposes: ["ordinals", "payment"],
     message: "[Best in Slot] wants to know your addresses!",
@@ -419,8 +390,7 @@ async function Z() {
       type: y()
     }
   }), n = await window.XverseProviders.BitcoinProvider?.connect(e);
-  if (!n)
-    throw new Error("Error fetching wallet data.");
+  if (!n) throw new Error("Error fetching wallet data.");
   return n.addresses.map((s) => ({
     address: s.address,
     pubkey: s.publicKey,
@@ -428,8 +398,7 @@ async function Z() {
   }));
 }
 async function ee(e, n, t) {
-  if (!window.XverseProviders?.BitcoinProvider)
-    throw new Error("Xverse extension not found.");
+  if (!window.XverseProviders?.BitcoinProvider) throw new Error("Xverse extension not found.");
   const s = T({
     address: t,
     message: e,
@@ -445,11 +414,9 @@ async function ee(e, n, t) {
   return p.from(o, "base64").toString("hex");
 }
 async function ne(e) {
-  if (!window.XverseProviders?.BitcoinProvider)
-    throw new Error("Xverse extension not found.");
+  if (!window.XverseProviders?.BitcoinProvider) throw new Error("Xverse extension not found.");
   const n = S();
-  if (!n)
-    throw new Error("No payment wallet found.");
+  if (!n) throw new Error("No payment wallet found.");
   const t = n.address, s = T({
     address: t,
     message: e,
@@ -468,8 +435,7 @@ async function ne(e) {
   };
 }
 async function te(e, n) {
-  if (!window.XverseProviders?.BitcoinProvider)
-    throw new Error("Xverse extension not found.");
+  if (!window.XverseProviders?.BitcoinProvider) throw new Error("Xverse extension not found.");
   return (await window.XverseProviders.BitcoinProvider.request("sendTransfer", {
     recipients: [
       {
@@ -480,8 +446,7 @@ async function te(e, n) {
   })).result.txid;
 }
 async function H(e, n, t, s) {
-  if (!window.XverseProviders?.BitcoinProvider)
-    throw new Error("Xverse extension not found.");
+  if (!window.XverseProviders?.BitcoinProvider) throw new Error("Xverse extension not found.");
   const o = T({
     network: {
       type: y()

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

@@ -2,6 +2,7 @@ export { generateAndStoreSwapWallet as createSwapWallet, ensureSwapWallet, getAd
 export type { EnsureSwapWalletResult, GetActivityOfPairResponse, GetKlinesRequest, GetKlinesResponse, GetPairVolumeRequest, GetPairVolumeResponse, GetSwapStatusResponse, GetTvlHistoryRequest, GetTvlHistoryResponse, GetWalletActivitiesResponse, ImportSwapWalletOptions, Kline, ListPairsOrderBy, ListPairsRequest, ListPairsResponse, PairActivityEntry, PairInfo, PairReserves, SwapBalance, SwapInfo, TokenInfo, TvlPoint, WalletActivityEntry, } from '../core/bis_swap';
 export type { AllBalanceDetails } from '../core/helpers';
 export type { BISSwapWalletInfo } from '../core/store';
+export type { FeePolicy } from '../lib/fee-policy';
 export type { SwapFees } from '../lib/swap-reporting';
 export { satsToBtc, satsToUsd, swapSide } from '../lib/swap-reporting';
 export { calculatePairAddress as getPairAddress } from '../lib/uniswap_ops';
@@ -24,7 +25,11 @@ export declare function getActivityOfPair(pairAddress: string, limit?: number, o
 /**
  * Adds liquidity to a specified token pair with the desired amounts and slippage tolerance.
  *
- * One of the two tokens must be WBTC; the order is rejected otherwise.
+ * Either token may be WBTC or a BRC-20 token. Adding to a pair that doesn't exist
+ * yet creates it; the swap backend rejects a new pair unless each side is WBTC or
+ * a BRC-20 token. Beyond that, the swap backend decides which new pairs it
+ * accepts, and rejects a pair it does not allow with its own error message,
+ * which the kit passes through unchanged.
  *
  * @param token1Address - The address of the first token in the pair.
  * @param token2Address - The address of the second token in the pair.
@@ -38,7 +43,7 @@ export declare function addLiquidity(token1Address: string, token2Address: strin
  * Removes liquidity from a specified token pair, burning `liquidity` LP tokens and
  * returning both underlying tokens.
  *
- * One of the two tokens must be WBTC; the order is rejected otherwise.
+ * Works for any existing pair, including token/token pairs with no WBTC side.
  *
  * @param token1Address - The address of the first token in the pair.
  * @param token2Address - The address of the second token in the pair.

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

@@ -1,4 +1,4 @@
 import { LocalWalletSource, LocalWalletType } from '../provider/local';
-export { createWallet, lockLocalWallet, saveWallet as connectLocalWallet } from '../provider/local';
+export { saveWallet as connectLocalWallet, createWallet, lockLocalWallet } from '../provider/local';
 export * from './wallet';
 export type { LocalWalletSource, LocalWalletType };

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

@@ -1,3 +1,4 @@
+import { FeePolicy } from '../lib/fee-policy';
 import { SwapFees } from '../lib/swap-reporting';
 import { BISSwapWalletInfo } from './store';
 /**
@@ -100,13 +101,18 @@ export interface SwapInfo {
     factory_address: string;
     wbtc_address: string;
     wbtc_handler_address: string;
+    fee_policy: FeePolicy | null;
 }
 /**
- * Fetches the swap's deployment info — the factory, WBTC and WBTC handler addresses — for the current network, by making an API call to the swap backend. The result is fetched once per network and cached.
+ * Fetches the swap's deployment info (the factory, WBTC and WBTC handler addresses, and the
+ * backend-owned swap fee policy) for the current network, by making an API call to the swap
+ * backend. The result is cached per network for 60 seconds; a response without a fee policy (an
+ * older backend) is returned but not cached, so the policy is picked up once the backend is
+ * upgraded.
  *
  * This does not require a connected wallet or a smart wallet.
  *
- * @returns {Promise<SwapInfo>} A promise that resolves to a SwapInfo object containing the factory address, the WBTC token address, and the WBTC handler address.
+ * @returns {Promise<SwapInfo>} A promise that resolves to a SwapInfo object containing the factory address, the WBTC token address, the WBTC handler address, and the fee policy (`null` if the backend does not serve one).
  */
 export declare function getSwapInfo(): Promise<SwapInfo>;
 /**
@@ -122,11 +128,12 @@ export interface SwapBalance {
     ticker: string;
     decimals: number;
     is_lp: boolean;
-    price_sats: number;
+    price_sats: number | null;
     reserve_token_amt?: string;
     token_decimals?: number;
     reserve_btc_amt?: string;
     btc_decimals?: number;
+    quote_token?: string;
     lp_total_supply?: string;
 }
 /**
@@ -205,11 +212,13 @@ export interface PairInfo {
     price: number;
     price_change_24h: number;
     price_change_7d: number;
-    volume_24h: bigint;
-    volume_7d: bigint;
+    volume_24h: bigint | null;
+    volume_7d: bigint | null;
     lp_fee_tier: number;
-    tvl: bigint;
-    apr: number;
+    tvl: bigint | null;
+    apr: number | null;
+    price_quote_token: string;
+    exposure_sats: bigint;
 }
 export interface ListPairsResponse {
     page: number;
@@ -223,7 +232,7 @@ export interface ListPairsResponse {
  * This does not require a connected wallet or a smart wallet, so it can be used to populate a market table or pair selector before the user connects.
  *
  * @param params (Optional) An object containing the sort order (defaults to 'tvl_desc'), the page to fetch (defaults to 1), and the number of pairs per page (defaults to 20, max 100).
- * @returns {Promise<ListPairsResponse>} A promise that resolves to an object containing the current page, page size, total number of pairs, and an array of PairInfo objects. Each pair includes both token addresses and symbols, price, 24h/7d price change, 24h/7d volume, LP fee tier, TVL, and APR. The volumes and TVL are returned as strings from the API and converted to bigint in this function.
+ * @returns {Promise<ListPairsResponse>} A promise that resolves to an object containing the current page, page size, total number of pairs, and an array of PairInfo objects. Each pair includes both token addresses and symbols, price and the token it is quoted in, 24h/7d price change, 24h/7d volume, LP fee tier, TVL, APR, and BTC exposure. The volumes, TVL and exposure are returned as strings from the API and converted to bigint in this function; volume, TVL and APR are `null` for a token/token pair below the backend's BTC-exposure threshold.
  */
 export declare function listPairs(params?: ListPairsRequest): Promise<ListPairsResponse>;
 export interface GetPairVolumeRequest {
@@ -237,7 +246,7 @@ export interface GetPairVolumeResponse {
     token_b_address: string;
     token_b_symbol: string;
     period_days: number;
-    total_volume_wbtc: string;
+    total_volume_wbtc: string | null;
     total_trades: number;
     start_time: string;
     end_time: string;
@@ -246,7 +255,7 @@ export interface GetPairVolumeResponse {
  * Fetches the trading volume and number of trades for a specific token pair over a given number of days by making an API call to the swap backend.
  *
  * @param params An object containing the pair address and the number of days to look back for volume data.
- * @returns {Promise<GetPairVolumeResponse>} A promise that resolves to an object containing the pair address, token addresses and symbols, period in days, total volume in WBTC, total number of trades, and the start and end time of the period. The total volume is returned as a string from the API and can be converted to bigint if needed.
+ * @returns {Promise<GetPairVolumeResponse>} A promise that resolves to an object containing the pair address, token addresses and symbols, period in days, total volume in WBTC, total number of trades, and the start and end time of the period. The total volume is returned as a string from the API and can be converted to bigint if needed; it is `null` for a token/token pair below the backend's BTC-exposure threshold.
  */
 export declare function getPairVolumeOverDays(params: GetPairVolumeRequest): Promise<GetPairVolumeResponse>;
 export interface GetKlinesRequest {
@@ -272,6 +281,7 @@ export interface GetKlinesResponse {
     token_a_symbol: string;
     token_b_address: string;
     token_b_symbol: string;
+    price_quote_token: string | null;
     interval: string;
     klines: Kline[];
 }
@@ -279,7 +289,7 @@ export interface GetKlinesResponse {
  * Fetches the historical price and volume data (klines) for a specific token pair and time interval by making an API call to the swap backend.
  *
  * @param params An object containing the pair address, desired time interval for the klines, limit on the number of klines to fetch (max 1000), and optional start and end timestamps to filter the klines.
- * @returns {Promise<GetKlinesResponse>} A promise that resolves to an object containing the pair address, token addresses and symbols, interval, and an array of kline data. Each kline includes open time, close time, open price, high price, low price, close price, volume in WBTC, and number of trades. The volume is returned as a string from the API and can be converted to bigint if needed.
+ * @returns {Promise<GetKlinesResponse>} A promise that resolves to an object containing the pair address, token addresses and symbols, the token prices are quoted in (`price_quote_token`), interval, and an array of kline data. Each kline includes open time, close time, open price, high price, low price, close price, volume in WBTC, and number of trades. For a token/token pair the prices are the raw base/quote ratio (quote-token base units per whole base token), with no BTC conversion. The volume is returned as a string from the API and can be converted to bigint if needed.
  */
 export declare function getKlines(params: GetKlinesRequest): Promise<GetKlinesResponse>;
 export interface GetTvlHistoryRequest {
@@ -289,7 +299,7 @@ export interface GetTvlHistoryRequest {
 export interface TvlPoint {
     timestamp: number;
     block_height: number;
-    tvl: string;
+    tvl: string | null;
 }
 export interface GetTvlHistoryResponse {
     pair_address: string;
@@ -304,10 +314,10 @@ export interface GetTvlHistoryResponse {
 /**
  * Fetches a daily Total Value Locked (TVL) series for a token pair from the swap backend, for charting TVL over time.
  *
- * TVL is valued in WBTC sats (2 x the WBTC-side reserve). Points are one per day, oldest first, each carrying the pair's reserves as of that day (carried forward across days with no on-chain change). A pair with no WBTC side reports `wbtc_side: ''` and a zero series.
+ * TVL is valued in WBTC sats: 2 x the WBTC-side reserve for a WBTC pair. A token/token pair (`wbtc_side: ''`) is valued through each token's direct BTC pool as of that day, and its point is `tvl: null` on days its BTC exposure is below the backend's threshold. Points are one per day, oldest first, each carrying the pair's reserves as of that day (carried forward across days with no on-chain change).
  *
  * @param params An object with the pair address and the number of days to look back (max 365; the backend clamps out-of-range values).
- * @returns {Promise<GetTvlHistoryResponse>} A promise that resolves to the pair address, token addresses and symbols, which side is WBTC, the period in days, and the ascending array of `{ timestamp, block_height, tvl }` points. Each `tvl` is a string of sats and can be converted to bigint if needed.
+ * @returns {Promise<GetTvlHistoryResponse>} A promise that resolves to the pair address, token addresses and symbols, which side is WBTC, the period in days, and the ascending array of `{ timestamp, block_height, tvl }` points. Each `tvl` is a string of sats (or `null`, see above) and can be converted to bigint if needed.
  */
 export declare function getTvlHistory(params: GetTvlHistoryRequest): Promise<GetTvlHistoryResponse>;
 export interface GetActivityOfPairRequest {
@@ -517,6 +527,19 @@ interface RemoveLiquidityOrderResponse {
  * @returns A promise that resolves to an object indicating the success of the remove liquidity order request.
  */
 export declare function prepareAndSendRemoveLiquidityOrder(token1Addr: string, token2Addr: string, lpAmt: bigint, amt1: bigint, amt2: bigint, slippageBPS: bigint): Promise<RemoveLiquidityOrderResponse>;
+/**
+ * The protocol-fee split the swap backend requires for a swap, from its
+ * `fee_policy` (see `swapFeeBps`). Exported for tests; not part of the public API.
+ *
+ * @param token1Addr The input token address (for both exact-input and exact-output swaps).
+ * @param token2Addr The output token address.
+ * @returns The fee bps on the input (`token1FeeBps`) and output (`token2FeeBps`) legs.
+ * @throws {Error} `MISSING_FEE_POLICY_ERROR` if the backend does not serve a fee policy.
+ */
+export declare function getSwapFeesBps(token1Addr: string, token2Addr: string): Promise<{
+    token1FeeBps: bigint;
+    token2FeeBps: bigint;
+}>;
 /**
  * Calculates the expected output amount, quoted price, and price impact for a token swap operation. The function retrieves the necessary swap information and connected wallet details, then uses a proxy to check the current balances and reserves of the tokens in the liquidity pool. It also requests the miner fee for swapping and gets the fee basis points for the tokens involved in the swap. Finally, it calls the swapRequest function to get the expected results based on the input parameters.
  *
@@ -524,7 +547,7 @@ export declare function prepareAndSendRemoveLiquidityOrder(token1Addr: string, t
  * @param tokenOutAddr The address of the token being swapped to.
  * @param amtIn The amount of the input token to be swapped, represented as a bigint.
  *
- * @returns A promise that resolves to an object containing the expected output amount of the token being swapped to, the quoted price for the swap, the price impact in basis points, and the fee breakdown (see `SwapFees` — `amount_out` is net of the pool fee only, with the rest charged on top).
+ * @returns A promise that resolves to an object containing the expected output amount of the token being swapped to, the quoted price for the swap (sats per whole token when either side is WBTC; for a token/token swap, output-token base units per whole input token, see `quotedPrice`), the price impact in basis points, and the fee breakdown (see `SwapFees`: `amount_out` is net of the pool fee only, with the rest charged on top).
  */
 export declare function getSwapResult(tokenInAddr: string, tokenOutAddr: string, amtIn: bigint): Promise<{
     amount_out: bigint;
@@ -557,7 +580,7 @@ export declare function prepareAndSendSwapOrder(token1Addr: string, token2Addr:
  * @param tokenOutAddr The address of the token being swapped to.
  * @param amtOut The amount of the output token expected from the swap, represented as a bigint.
  *
- * @returns A promise that resolves to an object containing the expected input amount of the token being swapped from, the quoted price for the swap, the price impact in basis points, and the fee breakdown (see `SwapFees` — `amount_in` covers the pool fee only, with the rest charged on top).
+ * @returns A promise that resolves to an object containing the expected input amount of the token being swapped from, the quoted price for the swap (sats per whole token when either side is WBTC; for a token/token swap, output-token base units per whole input token, see `quotedPrice`), the price impact in basis points, and the fee breakdown (see `SwapFees`: `amount_in` covers the pool fee only, with the rest charged on top).
  */
 export declare function getSwap2Result(tokenInAddr: string, tokenOutAddr: string, amtOut: bigint): Promise<{
     amount_in: bigint;

package/dist/types/lib/fee-policy.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The swap protocol-fee policy served by the swap backend (`/get_swap_info` →
+ * `fee_policy`).
+ */
+export interface FeePolicy {
+    /** Total protocol fee on a swap, in basis points. */
+    swap_fee_bps: number;
+    /** Lowercased token addresses that take the whole fee, highest priority first. WBTC is always first. */
+    priority_tokens: string[];
+    /** Minimum BTC exposure (sats) for a token/token pair's volume/TVL to be reported. A decimal string. */
+    min_btc_exposure_sats: string;
+}
+export declare const MISSING_FEE_POLICY_ERROR: string;
+/**
+ * Validates and normalises the raw `fee_policy` object from `/get_swap_info`.
+ * Priority addresses are lowercased.
+ *
+ * @param raw The `fee_policy` value exactly as the backend returned it.
+ * @returns The validated policy.
+ * @throws {Error} `MISSING_FEE_POLICY_ERROR` when `raw` is null/undefined (backend too old),
+ * or an `Invalid fee_policy…` error when a field is malformed.
+ */
+export declare function parseFeePolicy(raw: unknown): FeePolicy;
+/**
+ * The protocol-fee split for a swap. `token1` is always the input token, for both
+ * exact-input and exact-output swaps.
+ *
+ * If either side is a priority token, the higher-priority side (lower index in
+ * `priority_tokens`) pays the full rate and the other side pays 0. Otherwise the
+ * rate is split, with the odd bp on the input side: input `ceil(rate/2)`, output
+ * `floor(rate/2)`. Addresses are compared lowercased.
+ *
+ * @param tokenIn The input token address.
+ * @param tokenOut The output token address.
+ * @param policy The backend's fee policy.
+ * @returns The fee bps on the input (`token1FeeBps`) and output (`token2FeeBps`) legs.
+ */
+export declare function swapFeeBps(tokenIn: string, tokenOut: string, policy: FeePolicy): {
+    token1FeeBps: bigint;
+    token2FeeBps: bigint;
+};

package/dist/types/lib/swap-reporting.d.ts

@@ -78,3 +78,25 @@ export interface SwapFees {
  * @returns The fee breakdown for the quote.
  */
 export declare function buildSwapFees(amountIn: bigint, amountOut: bigint, token1FeeBps: bigint, token2FeeBps: bigint, btcFee: bigint): SwapFees;
+/**
+ * The `quoted_price` that the swap quote functions report. The price is floored
+ * to hundredths in bigint arithmetic, then converted to a `number`; above
+ * `Number.MAX_SAFE_INTEGER` hundredths (common for token/token quotes) that
+ * conversion rounds to the nearest representable value. Its unit depends on the
+ * direction:
+ *
+ * - WBTC in: sats per whole output token.
+ * - Any other input, WBTC out included: output-token base units per whole input
+ *   token. With WBTC out that is sats per whole input token. For a token/token swap
+ *   the output is **not** scaled by its decimals, so 1 XYZ in for 2 ABC out (18
+ *   decimals) quotes `2e18`.
+ *
+ * @param tokenInAddress The input token address.
+ * @param wbtcAddress The WBTC token address.
+ * @param amountIn The input amount, in input-token base units.
+ * @param amountOut The output amount, in output-token base units.
+ * @param decimalsIn The input token's decimals.
+ * @param decimalsOut The output token's decimals.
+ * @returns The quoted price.
+ */
+export declare function quotedPrice(tokenInAddress: string, wbtcAddress: string, amountIn: bigint, amountOut: bigint, decimalsIn: number, decimalsOut: number): number;

package/dist/vue.js

@@ -1,5 +1,5 @@
 import { ref as s, onScopeDispose as i, watch as u } from "vue";
-import { d as r, R as c, i as a } from "./mint-CA_-62SJ.js";
+import { d as r, R as c, i as a } from "./mint-Dm67SjcM.js";
 function w() {
   const e = s(r()), t = c((o) => {
     e.value !== o && (e.value = o);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bestinslot/wallet-kit",
   "type": "module",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "private": false,
   "description": "A lightweight JavaScript library for connecting Bitcoin wallets with a unified API.",
   "license": "MIT",
@@ -92,8 +92,10 @@
     "dotenv": "^17.3.1",
     "eslint": "^9.39.2",
     "eslint-plugin-jsdoc": "^62.6.1",
+    "husky": "9.1.7",
     "jsdom": "^29.1.1",
-    "prettier": "^3.8.1",
+    "lint-staged": "16.4.0",
+    "prettier": "3.9.9",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
     "solc": "^0.8.33",
@@ -113,13 +115,18 @@
   "publishConfig": {
     "access": "public"
   },
+  "lint-staged": {
+    "*": "prettier --write --ignore-unknown"
+  },
   "scripts": {
     "dev": "vite",
     "build": "vue-tsc -b && vite build",
     "build:debug": "vue-tsc -b && vite build --minify=false",
     "preview": "vite preview",
     "lint": "eslint",
-    "lint:fix": "prettier --write . && eslint --fix",
+    "lint:fix": "eslint --fix && prettier --write .",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
     "test": "vitest run",
     "release": "node scripts/release.mjs",
     "release:tag": "node scripts/release.mjs --tag",