@bestinslot/wallet-kit 0.10.0 → 0.12.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-Ci1sYbGa.js";
+import { c as IC, b as gC, m as QC, a as CC } from "./balances-Ci1sYbGa.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,17 +2,26 @@ 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';
 /**
  * Retrieves the wallet activities for a given public key and pair address.
  *
+ *
+ * Activities come back unconfirmed first, then newest first. Pass `limit` and `offset` to page
+ * through them and read `has_more` on the response to know whether another page exists. Backends
+ * that predate pagination ignore both parameters, return the full list, and omit `has_more`.
+ *
  * @param pubkey - The public key of the wallet for which to retrieve activities.
  * @param pairAddress - The address of the pair for which to retrieve activities.
- * @returns A promise that resolves to an array of wallet activities.
+ * @param limit - (Optional) Page size, an integer from 1 to 200. When omitted, the backend returns every activity.
+ * @param offset - (Optional) Number of activities to skip, a non-negative integer. The backend defaults to 0 when omitted.
+ * @returns A promise that resolves to the wallet's activities for the pair, with pagination fields when the backend supports them.
+ * @throws If `limit` or `offset` is out of range, before any request is sent.
  */
-export declare function getWalletActivities(pubkey: string, pairAddress: string): Promise<import('./swap').GetWalletActivitiesResponse>;
+export declare function getWalletActivities(pubkey: string, pairAddress: string, limit?: number, offset?: number): Promise<import('./swap').GetWalletActivitiesResponse>;
 /**
  * Retrieves activities for a pair.
  *
@@ -24,7 +33,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 +51,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,19 @@ export interface SwapInfo {
     factory_address: string;
     wbtc_address: string;
     wbtc_handler_address: string;
+    fee_policy: FeePolicy | null;
+    allow_token_token_pairs: boolean;
 }
 /**
- * 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, the fee policy (`null` if the backend does not serve one), and whether the backend accepts new token/token pools.
  */
 export declare function getSwapInfo(): Promise<SwapInfo>;
 /**
@@ -122,11 +129,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 +213,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 +233,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 +247,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 +256,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 +282,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 +290,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 +300,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 +315,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 {
@@ -342,6 +353,12 @@ export interface GetActivityOfPairResponse {
         decimals: number;
     };
     activities: PairActivityEntry[];
+    /** Page size the backend applied. Absent on older backends. */
+    limit?: number;
+    /** Offset the backend applied. Absent on older backends. */
+    offset?: number;
+    /** Whether more activities exist past this page. Absent on older backends. */
+    has_more?: boolean;
 }
 /**
  * Fetches the recent swap activities for a specific token pair by making an API call to the swap backend.
@@ -353,6 +370,10 @@ export declare function getActivityOfPair(params: GetActivityOfPairRequest): Pro
 interface GetWalletActivitiesRequest {
     pubkey: string;
     pairAddress: string;
+    /** Page size, 1-200. When omitted, the backend returns every activity. */
+    limit?: number;
+    /** Number of activities to skip. The backend defaults to 0 when omitted. */
+    offset?: number;
 }
 export interface WalletActivityEntry {
     id: string;
@@ -382,12 +403,25 @@ export interface GetWalletActivitiesResponse {
     btc_address: string;
     pair_address: string;
     activities: WalletActivityEntry[];
+    /** Page size the backend applied, or null when no `limit` was sent. Absent on older backends. */
+    limit?: number | null;
+    /** Offset the backend applied. Absent on older backends. */
+    offset?: number;
+    /** Whether more activities exist past this page. Absent on older backends. */
+    has_more?: boolean;
 }
 /**
  * Fetches the swap activities associated with a specific wallet public key and pair address by making an API call to the swap backend.
  *
- * @param params An object containing the wallet public key and pair address to query activities for.
+ * Activities come back unconfirmed first (null timestamp), then newest first. `limit` and
+ * `offset` page through them; each is sent only when given. Without `limit` the backend
+ * returns every activity from `offset` on, with `limit: null` and `has_more: false`.
+ * Backends that predate pagination ignore both and return the full list without `has_more`,
+ * `limit` or `offset`.
+ *
+ * @param params An object containing the wallet public key and pair address to query activities for, plus optional `limit` (1-200) and `offset` (>= 0).
  * @returns {Promise<GetWalletActivitiesResponse>} A promise that resolves to an object containing the wallet public key, associated Bitcoin address, pair address, and a list of swap activities (deposits, swaps, liquidity changes, withdrawals) related to that wallet and pair.
+ * @throws If `limit` is not an integer from 1 to 200, or `offset` is not a non-negative integer.
  */
 export declare function getWalletActivities(params: GetWalletActivitiesRequest): Promise<GetWalletActivitiesResponse>;
 /**
@@ -517,6 +551,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 +571,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 +604,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;
+};