@bestinslot/wallet-kit 0.14.0 → 0.14.2

package/dist/types/core/brc20-send.d.ts

@@ -64,6 +64,8 @@ export declare function callInscription(contractAddress: string, calldata: strin
  * @param label - The argument name used in error messages.
  */
 export declare function parseBrc20Amount(value: string, label: string): bigint;
+/** Formats an 18-decimal bigint as the shortest BRC-20 decimal string, such as `"7.5"`. */
+export declare function formatBrc20Amount(value: bigint): string;
 export declare function assertRecipient(recipient: string): void;
 export declare function assertFeeRate(feeRate: number): void;
 export declare function runChain(steps: ChainStep[], feeRate: number, dryRun: boolean, options: SignProgressOptions): Promise<Brc20SendQuote | ChainResult>;
@@ -79,18 +81,27 @@ export interface SendAsBrc20Args extends SignProgressOptions {
     dryRun: boolean;
 }
 export interface SendAsBrc20Result {
-    /** The BRC-20 transfer inscription sent to the recipient, or null when `fromBrc20Amount` is 0. */
+    /**
+     * The BRC-20 transfer inscription sent to the recipient. It carries both parts when the recipient
+     * is another address, and only `fromBrc20Amount` when the recipient is the sender's own ordinals
+     * address. Null when it would carry nothing.
+     */
     brc20Transfer: Brc20SendPart | null;
-    /** The BRC2.0 withdraw inscription sent to the recipient, or null when `fromProgAmount` is 0. */
+    /**
+     * The BRC2.0 withdraw inscription, sent to the sender's own ordinals address (the recipient's, when
+     * that is the sender), or null when `fromProgAmount` is 0.
+     */
     progWithdraw: Brc20SendPart | null;
     /** Every broadcast transaction id, in chain order. */
     txIds: string[];
 }
 /**
  * Sends a ticker so the recipient receives plain BRC-20, drawing on the sender's base BRC-20 balance
- * first and its BRC2.0 balance second. The base part is a BRC-20 transfer inscription sent to the
- * recipient; the BRC2.0 part is a `brc20-module` withdraw inscription sent to the recipient. Both
- * parts are signed as one chain and broadcast together.
+ * and its BRC2.0 balance. To another address, a `brc20-module` withdraw first moves the BRC2.0 part
+ * into the sender's own base balance, then one BRC-20 transfer inscription of both parts goes to the
+ * recipient: exchanges and other wallets credit only transfer inscriptions. To the sender's own
+ * ordinals address, the withdraw alone credits it. All steps are signed as one chain and broadcast
+ * together, and the chain order makes the withdraw index before the transfer is inscribed.
  */
 export declare function sendAsBrc20(args: SendAsBrc20Args): Promise<Brc20SendQuote | SendAsBrc20Result>;
 export interface SendAsBrc20ProgArgs extends SignProgressOptions {

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

@@ -220,15 +220,13 @@ export declare function verifySignature(message: string, signatureHex: string, a
  */
 export declare function verifySignatureLocal(message: string, signatureHex: string, address: string): boolean;
 /**
- * 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
- * in the JSON response body, throwing a descriptive error in either case.
+ * Fetches a backend JSON route.
  *
  * @param url The URL to fetch.
  * @param options The standard RequestInit options for the fetch call.
  * @returns A promise that resolves with the parsed JSON data of type T.
- * @throws {Error} Throws an error if the network request fails, the HTTP
- * status is not ok, or the response body contains an error field.
+ * @throws {BackendError} When the request does not complete, the HTTP status is not ok, the body
+ * is not JSON, or the body carries an `error` field. It holds the status and the backend's `code`.
  */
 export declare function fetchWithErrors<T>(url: string, options: RequestInit): Promise<T>;
 /**

package/dist/vue.js

@@ -1,5 +1,5 @@
 import { ref as s, onScopeDispose as u, watch as i } from "vue";
-import { e as r, T as c, k as a } from "./mint-Cyl31b8y.js";
+import { e as r, U as c, k as a } from "./mint-CSk_3TfL.js";
 function n() {
   const o = s(r()), t = c((e) => {
     o.value !== e && (o.value = e);

package/package.json

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