@bestinslot/wallet-kit 0.12.1 → 0.13.1

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

@@ -1,3 +1,4 @@
+import { APIOrdinalUtxoInfo, APIUtxoInfo } from '../core/helpers';
 import { SignFunction, SignResponse } from '../provider/api';
 import { PaymentOpts } from '../types/common';
 import { InscribeFees, InscribeMultipleResult, InscribeResult, SendInscriptionResult, InscriptionDetails } from '../types/inscription';
@@ -184,6 +185,19 @@ export declare function sendMultiInscriptionWithBuffer(inscriptionIds: string[],
  * @returns an object containing the transaction ID, signed transaction hex, vout index of the output containing the inscription, and the value of the output containing the inscription
  */
 export declare function sendInscriptionAll(inscriptionId: string, targetWallet: WalletInfo, targetPostage: number | null, feeRate: number, dryRun: boolean, signFunc: SignFunction): Promise<SendInscriptionResult>;
+export interface InscriptionUTXODetails {
+    satpoint: string;
+    value: number;
+    script_type: 'pubkeyhash' | 'scripthash' | 'witness_v0_keyhash' | 'witness_v0_scripthash' | 'witness_v1_taproot' | 'pubkey' | 'anchor' | 'witness_unknown' | 'nulldata' | 'multisig' | 'nonstandard';
+    block_height: number | null;
+    utxo: string;
+}
+/**
+ * Locates an inscription's UTXO on `inscriptionAddr`. Searches `ordinalUtxos` when given.
+ * Otherwise an inscription created by the saved extra transactions resolves from them
+ * directly, and any other inscription is looked up in the backend's `ordinal_utxos` list.
+ */
+export declare function getInscriptionDetails(inscriptionId: string, inscriptionAddr: string, ordinalUtxos?: APIOrdinalUtxoInfo[]): Promise<InscriptionUTXODetails | null>;
 /**
  * Sends multiple inscriptions in one transaction with a buffer output and returns the fee paid for the transaction. This is used for batch minting or batch sending when the user wants to know the fee before actually sending the transaction.
  *
@@ -329,10 +343,11 @@ interface SendInscriptionFeeRateResult {
  * @param targetPostage - postage amount in satoshis to include in the target output
  * @param extraOutputUtxos - array of extra output UTXOs to include in the transaction, each with its associated wallet information and value
  * @param feeRate - fee rate in sat/vbyte to use for the transaction
+ * @param fetchedCardinalUtxos - the payer's `fetchCardinalUtxos` response to fund from in place of a new fetch
  *
  * @returns an object containing the transaction ID, unsigned transaction hex, and calculated transaction fee
  */
-export declare function sendInscriptionToOpReturnWithExtraInputsAndExtraOutputFeeRate(inscriptionId: string, extraInputUtxos: UtxoInfoWithWallet[], targetWallet: WalletInfo, targetPostage: number, extraOutputUtxos: OutputUtxoInfo[], feeRate: number): Promise<SendInscriptionFeeRateResult>;
+export declare function sendInscriptionToOpReturnWithExtraInputsAndExtraOutputFeeRate(inscriptionId: string, extraInputUtxos: UtxoInfoWithWallet[], targetWallet: WalletInfo, targetPostage: number, extraOutputUtxos: OutputUtxoInfo[], feeRate: number, fetchedCardinalUtxos?: APIUtxoInfo[]): Promise<SendInscriptionFeeRateResult>;
 /**
  * Mints an inscription with extra input UTXOs included in the commit transaction. This function builds and signs the commit and reveal transactions for minting an inscription, while allowing the user to include additional input UTXOs in the commit transaction. This can be useful in cases where the user wants to fund the commit transaction with specific UTXOs or needs to include additional inputs for other reasons. The function retrieves the connected wallets, builds and signs the transactions, validates them, and broadcasts them to the network. If dryRun is true, it returns the signed transaction hex without broadcasting.
  *
@@ -357,8 +372,9 @@ export declare function mintWithExtraInputInCommitAll(inscriptionDetails: Inscri
  * @param postage - postage amount in satoshis to use for the transactions
  * @param paymentAddr - address to send the payment to (if payment is not null)
  * @param payment - amount to pay (if payment is not null)
+ * @param fetchedCardinalUtxos - the payer's `fetchCardinalUtxos` response to fund the commit from in place of a new fetch
  *
  * @returns an object containing the estimated commit fee, reveal fee, total fee, unsigned commit transaction hex, signed reveal transaction hex, inscription ID, and postage used
  */
-export declare function mintWithExtraInputInCommitFeeRate(inscriptionDetails: InscriptionDetails, extraInputUtxos: UtxoInfoWithWallet[], feeRate: number, postage: number | null, paymentAddr: string | null, payment: number | null): Promise<InscribeCheckFeesResult>;
+export declare function mintWithExtraInputInCommitFeeRate(inscriptionDetails: InscriptionDetails, extraInputUtxos: UtxoInfoWithWallet[], feeRate: number, postage: number | null, paymentAddr: string | null, payment: number | null, fetchedCardinalUtxos?: APIUtxoInfo[]): Promise<InscribeCheckFeesResult>;
 export {};

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

@@ -3,8 +3,13 @@
  * `fee_policy`).
  */
 export interface FeePolicy {
-    /** Total protocol fee on a swap, in basis points. */
+    /** Total protocol fee on a swap where either token is WBTC, in basis points. */
     swap_fee_bps: number;
+    /**
+     * Total protocol fee on a swap where neither token is WBTC, in basis points.
+     * Equals `swap_fee_bps` when the backend does not serve a separate token-pair rate.
+     */
+    token_pair_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. */
@@ -13,7 +18,8 @@ export interface FeePolicy {
 export declare const MISSING_FEE_POLICY_ERROR: string;
 /**
  * Validates and normalises the raw `fee_policy` object from `/get_swap_info`.
- * Priority addresses are lowercased.
+ * Priority addresses are lowercased. An absent `token_pair_swap_fee_bps` takes
+ * the value of `swap_fee_bps`.
  *
  * @param raw The `fee_policy` value exactly as the backend returned it.
  * @returns The validated policy.
@@ -25,10 +31,13 @@ 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.
+ * The rate is `swap_fee_bps` when either side is WBTC (`priority_tokens[0]`) and
+ * `token_pair_swap_fee_bps` otherwise. 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, so a priority token on a token/token pair pays the whole
+ * token-pair rate. 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.

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-Dm67SjcM.js";
+import { d as r, R as c, i as a } from "./mint-A-bG5QIH.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.12.1",
+  "version": "0.13.1",
   "private": false,
   "description": "A lightweight JavaScript library for connecting Bitcoin wallets with a unified API.",
   "license": "MIT",