bitcoin-wallet-connector 0.1.0 → 0.2.0

package/lib/utils/UnisatCompatibleWalletAdapterImpl.d.ts

@@ -1,4 +1,4 @@
-import { SignMessageResult, WalletAdapter, WalletAdapter_onAddressesChanged_callback, WalletAdapterAddress } from '../WalletAdapters.types';
+import { SignMessageResult, WalletAdapter, WalletAdapter_onAddressesChanged_callback, WalletAdapterAddress, WalletAdapterSendBitcoinCapability } from '../WalletAdapters.types';
 /**
  * https://docs.unisat.io/dev-center/open-api-documentation/unisat-wallet#events
  */
@@ -69,13 +69,21 @@ export declare class UnisatCompatibleWalletAdapterImpl implements WalletAdapter
     disconnect(): Promise<void>;
     getAddresses(): Promise<UnisatCompatibleWalletAdapterAddresses>;
     signMessage(address: string, message: string): Promise<SignMessageResult>;
-    sendBitcoinFeeRateCapability: WalletAdapter["sendBitcoinFeeRateCapability"];
+    sendBitcoinFeeRateCapability: WalletAdapterSendBitcoinCapability;
     sendBitcoin(fromAddress: string, receiverAddress: string, satoshiAmount: bigint, options?: {
         feeRate?: number;
     }): Promise<{
         txid: string;
     }>;
-    sendInscriptionFeeRateCapability: WalletAdapter["sendInscriptionFeeRateCapability"];
+    /**
+     * @internal
+     * @experimental
+     */
+    sendInscriptionFeeRateCapability: "unavailable" | "available" | "required";
+    /**
+     * @internal
+     * @experimental
+     */
     sendInscription(fromAddress: string, receiverAddress: string, inscriptionId: string, options?: {
         feeRate?: number;
     }): Promise<{

package/lib/utils/XverseCompatibleWalletAdapterImpl.d.ts

@@ -26,6 +26,10 @@ export declare class XverseCompatibleWalletAdapterImpl implements WalletAdapter
     sendBitcoin(fromAddress: string, receiverAddress: string, satoshiAmount: bigint): Promise<{
         txid: string;
     }>;
+    /**
+     * @internal
+     * @experimental
+     */
     sendInscriptionFeeRateCapability: "unavailable";
     signAndFinalizePsbt(psbtHex: string, signIndices: [address: string, signIndex: number][]): Promise<{
         signedPsbtHex: string;

package/lib/utils/XverseCompatibleWalletAdapterImpl_legacy.d.ts

@@ -10,18 +10,19 @@ export type XverseCompatibleWalletAdapterImplAddress = WalletAdapterAddress & {
 };
 export declare class XverseCompatibleWalletAdapterImpl_legacy implements WalletAdapter {
     protected readonly network: WalletAdapterBitcoinNetwork;
-    protected readonly localStorageKey: string;
+    protected readonly localStorageKeyPrefix: string;
     protected readonly walletDisplayName: string;
     protected readonly getProvider: XverseCompatibleWalletAdapterGetProviderFn;
     protected readonly parseAddresses: XverseCompatibleWalletAdapterParsedAddressesFn;
     constructor(info: {
         network: WalletAdapterBitcoinNetwork;
-        localStorageKey: string;
+        localStorageKeyPrefix: string;
         walletDisplayName: string;
         getProvider: XverseCompatibleWalletAdapterGetProviderFn;
         parseAddresses: XverseCompatibleWalletAdapterParsedAddressesFn;
     });
     private getSdk;
+    protected get connectAddresses_localStorageKey(): string;
     protected retrieveConnectedAddress(): GetAddressResponse | undefined;
     protected updateConnectedAddress(addresses: GetAddressResponse["addresses"]): Promise<void>;
     connect(): Promise<void>;
@@ -33,6 +34,10 @@ export declare class XverseCompatibleWalletAdapterImpl_legacy implements WalletA
     sendBitcoin(fromAddress: string, receiverAddress: string, satoshiAmount: bigint): Promise<{
         txid: string;
     }>;
+    /**
+     * @internal
+     * @experimental
+     */
     sendInscriptionFeeRateCapability: "unavailable";
     signAndFinalizePsbt(psbtHex: string, signIndices: [address: string, signIndex: number][]): Promise<{
         signedPsbtHex: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bitcoin-wallet-connector",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "A Bitcoin wallet connector with various adapters.",
   "main": "lib/index.js",
   "module": "lib/index.mjs",
@@ -26,14 +26,6 @@
     "lib",
     "src"
   ],
-  "scripts": {
-    "prepare": "pnpm run build",
-    "postinstall": "git-hook-pure install",
-    "build": "vite build",
-    "test": "vitest",
-    "storybook": "storybook dev -p 6006",
-    "build-storybook": "storybook build"
-  },
   "devDependencies": {
     "@commitlint/cli": "^20.3.0",
     "@commitlint/config-conventional": "^20.3.0",
@@ -82,5 +74,12 @@
     "sats-connect": {
       "optional": true
     }
+  },
+  "scripts": {
+    "postinstall": "git-hook-pure install",
+    "build": "vite build",
+    "test": "vitest",
+    "storybook": "storybook dev -p 6006",
+    "build-storybook": "storybook build"
   }
-}
+}

package/src/BitcoinConnectionProvider.stories.tsx

@@ -1,30 +1,34 @@
 import { Meta, StoryFn } from "@storybook/react-vite"
-import React, { useState } from "react"
+import React, { FC, useEffect, useState } from "react"
 import {
   BitcoinConnectionProvider,
   useBitcoinConnectionContext,
   WalletSession,
 } from "./BitcoinConnectionProvider"
 import {
+  WalletAdapter,
   WalletAdapterAddress,
   WalletAdapterBitcoinNetwork,
+  WalletAdapterFactory,
 } from "./WalletAdapters.types"
 import {
-  UnisatWalletAdapter,
-  XverseWalletAdapter,
-  OkxWalletAdapter,
-  LeatherWalletAdapter,
-  BitgetWalletAdapter,
+  UnisatWalletAdapterFactory,
+  XverseWalletAdapterFactory,
+  OkxWalletAdapterFactory,
+  LeatherWalletAdapterFactory,
+  BitgetWalletAdapterFactory,
   MagicEdenWalletAdapterFactory,
 } from "./adapters"
 
-const adapterFactories = [
-  UnisatWalletAdapter,
-  XverseWalletAdapter,
-  OkxWalletAdapter,
-  LeatherWalletAdapter,
-  BitgetWalletAdapter,
-  MagicEdenWalletAdapterFactory(WalletAdapterBitcoinNetwork.MAINNET),
+const adapterFactories: WalletAdapterFactory<WalletAdapter>[] = [
+  UnisatWalletAdapterFactory(),
+  XverseWalletAdapterFactory(),
+  OkxWalletAdapterFactory(),
+  LeatherWalletAdapterFactory(),
+  BitgetWalletAdapterFactory(),
+  MagicEdenWalletAdapterFactory({
+    network: WalletAdapterBitcoinNetwork.MAINNET,
+  }),
 ]
 
 export default {
@@ -104,34 +108,49 @@ const WalletConnectionContent = (): React.ReactElement => {
       <div style={{ marginBottom: "16px" }}>
         <h3>Available Wallets ({ctx.availableAdapters.length})</h3>
         <div style={{ display: "flex", flexWrap: "wrap", gap: "8px" }}>
-          {ctx.availableAdapters.map(([adapterId, adapter]) => (
-            <button
-              key={adapterId}
-              onClick={() => {
-                addDebugInfo(`Connecting to ${adapterId}...`)
-                ctx
-                  .connect(adapterId, adapter)
-                  .then(() => {
-                    addDebugInfo(`Connected to ${adapterId}`)
-                  })
-                  .catch(err => {
-                    addDebugInfo(`Failed to connect: ${err.message}`)
-                  })
-              }}
-              disabled={ctx.isConnectionInitializing}
-              style={{
-                padding: "8px 16px",
-                cursor: ctx.isConnectionInitializing
-                  ? "not-allowed"
-                  : "pointer",
-                border: "1px solid #ccc",
-                borderRadius: "4px",
-                background: "#fff",
-              }}
-            >
-              {adapterId}
-            </button>
-          ))}
+          {ctx.availableAdapters.map(([adapterId, adapter]) => {
+            const factory = adapterFactories.find(
+              factory => factory.adapterId === adapterId,
+            )!
+
+            return (
+              <div
+                key={adapterId}
+                onClick={() => {
+                  addDebugInfo(`Connecting to ${adapterId}...`)
+                  ctx
+                    .connect(adapterId, adapter)
+                    .then(() => {
+                      addDebugInfo(`Connected to ${adapterId}`)
+                    })
+                    .catch(err => {
+                      addDebugInfo(`Failed to connect: ${err.message}`)
+                    })
+                }}
+                style={{
+                  display: "flex",
+                  alignItems: "center",
+                  justifyContent: "center",
+                  padding: "8px 16px",
+                  cursor: ctx.isConnectionInitializing
+                    ? "not-allowed"
+                    : "pointer",
+                  border: "1px solid #ccc",
+                  borderRadius: "4px",
+                  background: "#fff",
+                }}
+              >
+                {ctx.isConnectionInitializing ? (
+                  "Connecting..."
+                ) : (
+                  <>
+                    <WalletIcon adapterFactory={factory} />
+                    <span>{factory.metadata.name}</span>
+                  </>
+                )}
+              </div>
+            )
+          })}
         </div>
       </div>
 
@@ -248,7 +267,7 @@ const WalletConnectionContent = (): React.ReactElement => {
         <h3>Registered Adapter Factories ({ctx.adapterFactories.length})</h3>
         <ul>
           {ctx.adapterFactories.map((factory, i) => (
-            <li key={i}>{factory.adapterId}</li>
+            <li key={i}>{factory.metadata.name}</li>
           ))}
         </ul>
       </div>
@@ -303,7 +322,6 @@ export const Default: StoryFn<typeof BitcoinConnectionProvider> = () => {
         addEvent(`Addresses changed: ${addresses.length} addresses`)
       }}
       onWalletDisconnected={() => {
-        debugger
         addEvent("Wallet disconnected")
       }}
     >
@@ -327,3 +345,53 @@ export const Default: StoryFn<typeof BitcoinConnectionProvider> = () => {
     </BitcoinConnectionProvider>
   )
 }
+
+const WalletIcon: FC<{
+  adapterFactory: WalletAdapterFactory<WalletAdapter>
+}> = ({ adapterFactory }) => {
+  const [iconUrl, setIconUrl] = useState<null | string>(null)
+
+  useEffect(() => {
+    const abortController = new AbortController()
+
+    void adapterFactory.metadata
+      .iconUrl()
+      .then(url => {
+        if (abortController.signal.aborted) return
+        setIconUrl(url)
+      })
+      .catch(err => {
+        console.error(
+          "Failed to load icon for ",
+          adapterFactory.metadata.name,
+          err,
+        )
+      })
+
+    return () => {
+      abortController.abort()
+    }
+  }, [adapterFactory.metadata])
+
+  if (!iconUrl) {
+    return (
+      <div
+        style={{
+          width: "24px",
+          height: "24px",
+          marginRight: "8px",
+          borderRadius: "4px",
+          background: "#eaeaea",
+        }}
+      ></div>
+    )
+  }
+
+  return (
+    <img
+      src={iconUrl}
+      alt={adapterFactory.metadata.name}
+      style={{ width: "24px", height: "24px", marginRight: "8px" }}
+    />
+  )
+}

package/src/BitcoinConnectionProvider.tsx

@@ -9,11 +9,11 @@ import {
   useRef,
   useState,
 } from "react"
-import { BitcoinWalletAdapterConnector } from "./BitcoinWalletAdapterConnector"
+import { BitcoinWalletConnector } from "./BitcoinWalletConnector"
 import {
   WalletAdapter,
   WalletAdapterAddress,
-  WalletAdapterStatic,
+  WalletAdapterFactory,
 } from "./WalletAdapters.types"
 
 export interface WalletSession {
@@ -30,7 +30,7 @@ export interface BitcoinConnectionContextValue {
   disconnect: () => Promise<void>
 
   // Wallet management (for UI)
-  adapterFactories: WalletAdapterStatic<WalletAdapter>[]
+  adapterFactories: WalletAdapterFactory<WalletAdapter>[]
   availableAdapters: (readonly [adapterId: string, adapter: WalletAdapter])[]
 }
 
@@ -55,7 +55,7 @@ function useConnectorState<T>(
 
 export const BitcoinConnectionProvider: FC<{
   children: ReactNode
-  adapterFactories: WalletAdapterStatic<WalletAdapter>[]
+  adapterFactories: WalletAdapterFactory<WalletAdapter>[]
   onWalletConnected?: (session: WalletSession) => void
   onWalletAddressesChanged?: (addresses: WalletAdapterAddress[]) => void
   onWalletDisconnected?: () => void
@@ -71,7 +71,7 @@ export const BitcoinConnectionProvider: FC<{
   const onWalletDisconnected = usePersistFn(props.onWalletDisconnected ?? noop)
 
   const connector = useMemo(
-    () => new BitcoinWalletAdapterConnector(props.adapterFactories),
+    () => new BitcoinWalletConnector(props.adapterFactories),
     [props.adapterFactories],
   )
 

package/src/{BitcoinWalletAdapterConnector.ts → BitcoinWalletConnector.ts}

@@ -1,14 +1,14 @@
+import { LOCAL_STORAGE_KEY_PREFIX } from "./constants"
 import { AvailabilitySubscription } from "./utils/createAdapterAvailability"
-import { BitcoinWalletAdapterError } from "./utils/error"
 import { StateChannel, StateChannelListener } from "./utils/StateChannel"
 import {
   WalletAdapter,
+  WalletAdapterFactory,
   WalletAdapterNotConnectedError,
-  WalletAdapterStatic,
 } from "./WalletAdapters.types"
 
-const previousConnectWalletAdapterIdLocalStorageKey =
-  "app:BitcoinWalletAdapterConnector:previousConnectWallet"
+const localStorageKeyPrefix = `${LOCAL_STORAGE_KEY_PREFIX}:BitcoinWalletConnector`
+const previousConnectWalletAdapterId_localStorageKey = `${localStorageKeyPrefix}:previousConnectWallet`
 
 export interface ConnectInfo {
   adapterId: string
@@ -17,16 +17,16 @@ export interface ConnectInfo {
 
 export type AdapterEntry = readonly [string, WalletAdapter]
 
-export class BitcoinWalletAdapterConnector {
+export class BitcoinWalletConnector {
   private availableAdaptersState = new StateChannel<AdapterEntry[]>([])
   private connectedInfoState = new StateChannel<null | ConnectInfo>(null)
   private autoConnectRunning = false
   private availabilitySubscriptions: AvailabilitySubscription[] = []
   private adapterOrder = new Map<string, number>()
 
-  constructor(private Adapters: WalletAdapterStatic<WalletAdapter>[]) {
+  constructor(private factories: WalletAdapterFactory<WalletAdapter>[]) {
     this.adapterOrder = new Map(
-      Adapters.map((adapter, index) => [adapter.adapterId, index]),
+      factories.map((factory, index) => [factory.adapterId, index]),
     )
     this.initializeAdapterAvailability()
   }
@@ -57,9 +57,9 @@ export class BitcoinWalletAdapterConnector {
   }
 
   private initializeAdapterAvailability(): void {
-    this.availabilitySubscriptions = this.Adapters.map(Adapter => {
-      return Adapter.getAdapter().subscribe(adapter => {
-        this.addOrUpdateAvailableAdapter(Adapter.adapterId, adapter)
+    this.availabilitySubscriptions = this.factories.map(factory => {
+      return factory.getAdapter().subscribe(adapter => {
+        this.addOrUpdateAvailableAdapter(factory.adapterId, adapter)
       })
     })
   }
@@ -91,16 +91,9 @@ export class BitcoinWalletAdapterConnector {
   async connect(adapterId: string, adapter: WalletAdapter): Promise<void> {
     const finalAdapter = adapter
 
-    await finalAdapter.connect().catch(err => {
-      if (err instanceof BitcoinWalletAdapterError) {
-        alert(err.message)
-        return
-      }
-      throw err
-    })
-
+    await finalAdapter.connect()
     localStorage.setItem(
-      previousConnectWalletAdapterIdLocalStorageKey,
+      previousConnectWalletAdapterId_localStorageKey,
       adapterId,
     )
 
@@ -110,13 +103,12 @@ export class BitcoinWalletAdapterConnector {
   async disconnect(): Promise<void> {
     const info = this.connectedInfoState.getValue()
     if (info == null) return
-    await this.disconnectAdapter(info.adapter)
+
+    await info.adapter.disconnect()
+    localStorage.removeItem(previousConnectWalletAdapterId_localStorageKey)
+
     this.connectedInfoState.setValue(null)
   }
-  private async disconnectAdapter(adapter: WalletAdapter): Promise<void> {
-    await adapter.disconnect()
-    localStorage.removeItem(previousConnectWalletAdapterIdLocalStorageKey)
-  }
 
   private async autoConnect(): Promise<void> {
     if (this.isConnected || this.autoConnectRunning) return
@@ -151,10 +143,10 @@ export class BitcoinWalletAdapterConnector {
 
   private get previousConnectedWallet(): string | undefined {
     const adapterId =
-      localStorage.getItem(previousConnectWalletAdapterIdLocalStorageKey) ||
+      localStorage.getItem(previousConnectWalletAdapterId_localStorageKey) ||
       undefined
 
-    if (this.Adapters.some(adapter => adapter.adapterId === adapterId)) {
+    if (this.factories.some(factory => factory.adapterId === adapterId)) {
       return adapterId
     }
     return undefined

package/src/WalletAdapters.types.ts

@@ -84,12 +84,12 @@ export interface WalletAdapterAddress extends Partial<
 
 export interface WalletAdapterMetadata {
   name: string
-  iconUrl: Promise<string>
+  iconUrl: () => Promise<string>
   websiteUrl: string
   downloadUrl: string
 }
 
-export interface WalletAdapterStatic<T extends WalletAdapter> {
+export interface WalletAdapterFactory<T extends WalletAdapter> {
   adapterId: string
   metadata: WalletAdapterMetadata
   getAdapter(): Availability<T>
@@ -111,34 +111,25 @@ export interface WalletAdapter {
 
   signMessage(address: string, message: string): Promise<SignMessageResult>
 
-  readonly sendBitcoinFeeRateCapability:
-    | "unavailable"
-    | "available"
-    | "required"
+  signAndFinalizePsbt(
+    psbtHex: string,
+    signIndices: [address: string, signIndex: number][],
+  ): Promise<{ signedPsbtHex: string }>
+
+  sendBitcoinFeeRateCapability: WalletAdapterSendBitcoinCapability
   sendBitcoin(
     fromAddress: string,
     receiverAddress: string,
     satoshiAmount: bigint,
     options?: { feeRate?: number },
   ): Promise<{ txid: string }>
-
-  readonly sendInscriptionFeeRateCapability:
-    | "unavailable"
-    | "available"
-    | "required"
-  sendInscription?(
-    fromAddress: string,
-    receiverAddress: string,
-    inscriptionId: string,
-    options?: { feeRate?: number },
-  ): Promise<{ txid: string }>
-
-  signAndFinalizePsbt(
-    psbtHex: string,
-    signIndices: [address: string, signIndex: number][],
-  ): Promise<{ signedPsbtHex: string }>
 }
 
+export type WalletAdapterSendBitcoinCapability =
+  | "unavailable"
+  | "available"
+  | "required"
+
 export class WalletAdapterErrorBase extends Error {
   constructor(message: string) {
     super(message)

package/src/adapters/BitgetWalletAdapter.impl.ts

@@ -3,6 +3,7 @@ import {
   UnisatCompatibleWalletAdapterImpl,
 } from "../utils/UnisatCompatibleWalletAdapterImpl"
 import { WalletAdapter } from "../WalletAdapters.types"
+import { metadata } from "./BitgetWalletAdapter"
 
 /**
  * Derivation path (BIP-44): m/44'/0'/0'/0/ address_index
@@ -17,6 +18,6 @@ export class BitgetWalletAdapterImpl
      *
      * https://web3.bitget.com/zh-CN/docs/provider-api/btc.html
      */
-    super(provider, "Bitget")
+    super(provider, metadata.name)
   }
 }

package/src/adapters/BitgetWalletAdapter.ts

@@ -3,7 +3,7 @@ import type { UnisatCompatibleProviderAPI } from "../utils/UnisatCompatibleWalle
 import type {
   WalletAdapter,
   WalletAdapterMetadata,
-  WalletAdapterStatic,
+  WalletAdapterFactory,
 } from "../WalletAdapters.types"
 
 /**
@@ -15,9 +15,9 @@ const adapterId = "bitget.bitcoin"
 /**
  * https://web3.bitget.com/en/docs/wallet/brand-assets.html
  */
-const metadata: WalletAdapterMetadata = {
+export const metadata: WalletAdapterMetadata = {
   name: "Bitget",
-  iconUrl: import("../_/bitget.png").then(m => m.default),
+  iconUrl: () => import("../_/bitget.png").then(m => m.default),
   websiteUrl: "https://web3.bitget.com/",
   downloadUrl: "https://web3.bitget.com/en/wallet-download",
 }
@@ -37,8 +37,10 @@ const availability = createAvailability<
   },
 })
 
-export const BitgetWalletAdapter: WalletAdapterStatic<WalletAdapter> = {
-  adapterId,
-  metadata,
-  getAdapter: () => availability,
+export function BitgetWalletAdapterFactory(): WalletAdapterFactory<WalletAdapter> {
+  return {
+    adapterId,
+    metadata,
+    getAdapter: () => availability,
+  }
 }

package/src/adapters/LeatherWalletAdapter.impl.ts

@@ -1,11 +1,12 @@
 import type { RequestFn, RpcErrorBody, RpcErrorResponse } from "@leather.io/rpc"
 import { hex } from "@scure/base"
+import { LOCAL_STORAGE_KEY_PREFIX } from "../constants"
 import {
   addressToScriptPubKey,
   getTapInternalKeyOf_P2TR_publicKey,
 } from "../utils/bitcoinAddressHelpers"
 import { getBitcoinNetwork } from "../utils/bitcoinNetworkHelpers"
-import { UserRejectError, BitcoinWalletAdapterError } from "../utils/error"
+import { BitcoinWalletAdapterError, UserRejectError } from "../utils/error"
 import {
   SignMessageAlgorithm,
   SignMessageResult,
@@ -17,6 +18,7 @@ import {
   WalletAdapterBitcoinNetwork,
   WalletAdapterNotConnectedError,
 } from "../WalletAdapters.types"
+import { adapterId, metadata } from "./LeatherWalletAdapter"
 
 type GetAddressesResponseData = any
 
@@ -41,9 +43,8 @@ enum RpcErrorCode {
 
 type Addresses = (WalletAdapterAddress & { publicKey: string })[]
 
-const LEATHER_PROVIDER_ID = "LeatherProvider.BitcoinProvider"
-
-const localStorageKey = `app:${LEATHER_PROVIDER_ID}:`
+const localStorageKeyPrefix = `${LOCAL_STORAGE_KEY_PREFIX}:${adapterId}`
+const connectedAddress_localStorageKey = `${localStorageKeyPrefix}:connectedAddress`
 
 /**
  * Derivation path (BIP-84): m/84'/0'/ account_index '/0/0
@@ -51,11 +52,10 @@ const localStorageKey = `app:${LEATHER_PROVIDER_ID}:`
 export class LeatherWalletAdapterImpl implements WalletAdapter {
   constructor(private request: RequestFn) {}
 
-  private readonly walletDisplayName = "Leather"
-
   private retrieveConnectedAddress(): GetAddressesResponseData | undefined {
     let resp: GetAddressesResponseData | undefined
-    const stored = localStorage.getItem(localStorageKey) || undefined
+    const stored =
+      localStorage.getItem(connectedAddress_localStorageKey) || undefined
     if (stored != null) {
       try {
         resp = JSON.parse(stored)
@@ -67,7 +67,7 @@ export class LeatherWalletAdapterImpl implements WalletAdapter {
           throw new Error("Invalid stored addresses")
         }
       } catch {
-        localStorage.removeItem(localStorageKey)
+        localStorage.removeItem(connectedAddress_localStorageKey)
       }
     }
     return resp
@@ -81,12 +81,15 @@ export class LeatherWalletAdapterImpl implements WalletAdapter {
          */
         this.request("getAddresses"),
       )
-      localStorage.setItem(localStorageKey, JSON.stringify(resp))
+      localStorage.setItem(
+        connectedAddress_localStorageKey,
+        JSON.stringify(resp),
+      )
     }
   }
 
   async disconnect(): Promise<void> {
-    localStorage.removeItem(localStorageKey)
+    localStorage.removeItem(connectedAddress_localStorageKey)
     return Promise.resolve()
   }
 
@@ -94,7 +97,7 @@ export class LeatherWalletAdapterImpl implements WalletAdapter {
     const resp = this.retrieveConnectedAddress()
 
     if (resp == null) {
-      throw new WalletAdapterNotConnectedError(this.walletDisplayName)
+      throw new WalletAdapterNotConnectedError(metadata.name)
     }
 
     const addresses = resp.addresses.filter(
@@ -200,8 +203,15 @@ export class LeatherWalletAdapterImpl implements WalletAdapter {
     return { txid: resp.txid }
   }
 
+  /**
+   * @internal
+   * @experimental
+   */
   sendInscriptionFeeRateCapability = "available" as const
-
+  /**
+   * @internal
+   * @experimental
+   */
   async sendInscription(
     fromAddress: string,
     receiverAddress: string,
@@ -238,7 +248,7 @@ export class LeatherWalletAdapterImpl implements WalletAdapter {
       account => account.address === signIndices[0]?.[0],
     )
     if (signingAccount == null) {
-      throw new WalletAdapterNotConnectedError(this.walletDisplayName)
+      throw new WalletAdapterNotConnectedError(metadata.name)
     }
 
     const resp: any = await handleRpcError(