@meshconnect/uwc-bitcoin 0.2.4 → 0.3.0

package/dist/adapter.d.ts

@@ -1,24 +1,37 @@
-import type { BitcoinAccount, BitcoinSignMessageParams, SignatureType } from '@meshconnect/uwc-types';
+import type { BitcoinAccount, BitcoinPsbtSignRequest, BitcoinSendTransferRequest, BitcoinSignMessageParams, SignatureType, TransactionResult } from '@meshconnect/uwc-types';
 /**
  * The seam between the Bitcoin namespace module and a single transport.
  *
- * A concrete adapter (Phase 3) is constructed by its transport bound to an
+ * A concrete adapter is constructed by its transport bound to an
  * already-connected provider/session — Wallet Standard `bitcoin:*` for the
  * injected transport, WalletConnect bip122 for the WalletConnect transport —
  * so the port carries no `connect`/provider argument: connecting is the
  * transport's job. Each adapter converts between these transport-agnostic
- * domain shapes and its wallet's native interface (e.g. hex ↔ `Uint8Array`).
+ * domain shapes and its wallet's native interface (e.g. hex/base64 strings ↔
+ * `Uint8Array`).
  *
- * Phase 2 locks the grounded verify-flow methods. `signPsbt` (Path B, returns a
- * signed PSBT the module then finalizes + broadcasts) and `sendTransfer`
- * (Path A) are added alongside their concrete adapters in Phase 3 rather than
- * guessed here.
+ * `getAccounts` + `signMessage` are the always-present verify-flow methods.
+ * `signPsbt` and `sendTransfer` are optional because they map to distinct wallet
+ * paths — a Wallet Standard wallet signs a PSBT (Path B); a WalletConnect wallet
+ * does a high-level `sendTransfer` (Path A) — and not every adapter offers both.
  */
 export interface BitcoinTransportAdapter {
     /** Enumerate the bip122 accounts available on the connected session. */
     getAccounts(): Promise<BitcoinAccount[]>;
     /** Sign a message with the given account. */
     signMessage(params: BitcoinSignMessageParams): Promise<SignatureType>;
+    /**
+     * Sign a PSBT (Path B). Returns the wallet-signed PSBT, base64-encoded — the
+     * wallet does NOT broadcast; finalizing + broadcasting is a separate step.
+     * Optional: only adapters whose wallet exposes PSBT signing implement it.
+     */
+    signPsbt?(request: BitcoinPsbtSignRequest): Promise<string>;
+    /**
+     * High-level transfer (Path A): the wallet does coin selection, fee, signing,
+     * and broadcast, returning a txid. Optional: only adapters whose transport
+     * offers it (e.g. WalletConnect `sendTransfer`) implement it.
+     */
+    sendTransfer?(request: BitcoinSendTransferRequest): Promise<TransactionResult>;
     /** Release any session resources the adapter holds. Optional. */
     disconnect?(): Promise<void>;
 }

package/dist/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,wBAAwB,EACxB,aAAa,EACd,MAAM,wBAAwB,CAAA;AAE/B;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,uBAAuB;IACtC,wEAAwE;IACxE,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAA;IAExC,6CAA6C;IAC7C,WAAW,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;IAErE,iEAAiE;IACjE,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,aAAa,EACb,iBAAiB,EAClB,MAAM,wBAAwB,CAAA;AAE/B;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,uBAAuB;IACtC,wEAAwE;IACxE,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAA;IAExC,6CAA6C;IAC7C,WAAW,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;IAErE;;;;OAIG;IACH,QAAQ,CAAC,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAE3D;;;;OAIG;IACH,YAAY,CAAC,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAE9E,iEAAiE;IACjE,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B"}

package/dist/adapters/okx.d.ts

@@ -0,0 +1,60 @@
+import type { BitcoinAccount, BitcoinPsbtSignRequest, BitcoinSignMessageParams, SignatureType } from '@meshconnect/uwc-types';
+import type { BitcoinTransportAdapter } from '../adapter';
+/**
+ * The subset of OKX's injected Bitcoin provider this adapter drives
+ * (`window.okxwallet.bitcoin`). OKX does NOT expose Bitcoin through Wallet
+ * Standard — only this legacy injected provider — so it needs a dedicated
+ * adapter, not `WalletStandardBitcoinAdapter`.
+ *
+ * Wire conventions the provider follows:
+ * - `requestAccounts()` prompts + returns the authorized addresses; the caller
+ *   pairs `getPublicKey()` for the active account's compressed key (hex).
+ * - `signMessage(msg, type)` returns a base64 signature.
+ * - `signPsbt(psbtHex, options)` takes AND returns PSBT as HEX — so this adapter
+ *   converts base64 ↔ hex at the boundary (our domain is base64/BIP-174).
+ */
+export interface OkxBitcoinProvider {
+    /** Prompt for connection; returns the authorized addresses. */
+    requestAccounts(): Promise<string[]>;
+    /** Non-prompting: the already-authorized addresses ([] if not connected). */
+    getAccounts(): Promise<string[]>;
+    /** The active account's compressed public key, hex-encoded. */
+    getPublicKey(): Promise<string>;
+    /** Sign a message; returns a base64 signature. */
+    signMessage(message: string, type?: 'ecdsa' | 'bip322-simple'): Promise<string>;
+    /**
+     * Sign a PSBT (hex in, signed PSBT hex out). `toSignInputs` scopes which
+     * inputs to sign (index + expected address, optional sighash), mirroring the
+     * Wallet Standard adapter's `inputsToSign`; omitted → the wallet signs all it
+     * can.
+     */
+    signPsbt(psbtHex: string, options?: {
+        autoFinalized?: boolean;
+        toSignInputs?: {
+            index: number;
+            address: string;
+            sighashTypes?: number[];
+        }[];
+    }): Promise<string>;
+    on(event: string, handler: (accounts: string[]) => void): void;
+    removeListener(event: string, handler: (accounts: string[]) => void): void;
+}
+/**
+ * OKX (legacy injected) Bitcoin transport adapter — the non-Wallet-Standard
+ * injected path. The injected transport resolves `window.okxwallet.bitcoin` by
+ * its `injectedId` and hands it here; this adapter maps our domain shapes onto
+ * the provider's methods.
+ *
+ * `sendTransfer` is intentionally not implemented — that is the WalletConnect
+ * high-level path. (OKX has `sendBitcoin`, but broadcast is out of scope here:
+ * this stays sign-only, matching `WalletStandardBitcoinAdapter`.)
+ */
+export declare class OkxBitcoinAdapter implements BitcoinTransportAdapter {
+    private readonly provider;
+    constructor(provider: OkxBitcoinProvider);
+    getAccounts(): Promise<BitcoinAccount[]>;
+    signMessage(params: BitcoinSignMessageParams): Promise<SignatureType>;
+    signPsbt(request: BitcoinPsbtSignRequest): Promise<string>;
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=okx.d.ts.map

package/dist/adapters/okx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"okx.d.ts","sourceRoot":"","sources":["../../src/adapters/okx.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,sBAAsB,EAEtB,wBAAwB,EACxB,aAAa,EACd,MAAM,wBAAwB,CAAA;AAE/B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AAQzD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACpC,6EAA6E;IAC7E,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAChC,+DAA+D;IAC/D,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;IAC/B,kDAAkD;IAClD,WAAW,CACT,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,OAAO,GAAG,eAAe,GAC/B,OAAO,CAAC,MAAM,CAAC,CAAA;IAClB;;;;;OAKG;IACH,QAAQ,CACN,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,aAAa,CAAC,EAAE,OAAO,CAAA;QACvB,YAAY,CAAC,EAAE;YACb,KAAK,EAAE,MAAM,CAAA;YACb,OAAO,EAAE,MAAM,CAAA;YACf,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;SACxB,EAAE,CAAA;KACJ,GACA,OAAO,CAAC,MAAM,CAAC,CAAA;IAClB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,IAAI,GAAG,IAAI,CAAA;IAC9D,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,IAAI,GAAG,IAAI,CAAA;CAC3E;AAaD;;;;;;;;;GASG;AACH,qBAAa,iBAAkB,YAAW,uBAAuB;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,kBAAkB;IAEnD,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAgBxC,WAAW,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,aAAa,CAAC;IAgBrE,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC;IA+BhE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAK5B"}

package/dist/adapters/okx.js

@@ -0,0 +1,93 @@
+import { WalletConnectorError } from '@meshconnect/uwc-types';
+import { base64ToBytes, bytesToBase64, bytesToHex, hexToBytes } from '../encoding';
+/** Bitcoin SIGHASH flag → numeric value (Bitcoin Core encoding) for the
+ * provider's `toSignInputs.sighashTypes`. */
+const SIGHASH_VALUES = {
+    ALL: 0x01,
+    NONE: 0x02,
+    SINGLE: 0x03,
+    'ALL|ANYONECANPAY': 0x81,
+    'NONE|ANYONECANPAY': 0x82,
+    'SINGLE|ANYONECANPAY': 0x83
+};
+/**
+ * OKX (legacy injected) Bitcoin transport adapter — the non-Wallet-Standard
+ * injected path. The injected transport resolves `window.okxwallet.bitcoin` by
+ * its `injectedId` and hands it here; this adapter maps our domain shapes onto
+ * the provider's methods.
+ *
+ * `sendTransfer` is intentionally not implemented — that is the WalletConnect
+ * high-level path. (OKX has `sendBitcoin`, but broadcast is out of scope here:
+ * this stays sign-only, matching `WalletStandardBitcoinAdapter`.)
+ */
+export class OkxBitcoinAdapter {
+    provider;
+    constructor(provider) {
+        this.provider = provider;
+    }
+    async getAccounts() {
+        const addresses = await this.provider.requestAccounts();
+        // The provider exposes one active public key; pair it with the first
+        // (active) address. Tolerate a missing key rather than failing the connect.
+        let publicKey = '';
+        try {
+            publicKey = await this.provider.getPublicKey();
+        }
+        catch {
+            publicKey = '';
+        }
+        return addresses.map((address, index) => ({
+            address,
+            publicKey: index === 0 ? publicKey : ''
+        }));
+    }
+    async signMessage(params) {
+        // OKX signs with its OWN active account (no address param), so the caller's
+        // `params.account` is advisory here. Map our protocol name to the
+        // provider's ('bip322' → 'bip322-simple').
+        const type = params.protocol === 'bip322' ? 'bip322-simple' : 'ecdsa';
+        const signature = await this.provider.signMessage(params.message, type);
+        if (!signature) {
+            throw new WalletConnectorError({
+                type: 'unknown',
+                message: 'okx bitcoin: signMessage returned no signature'
+            });
+        }
+        // OKX returns a base64 signature — matches our contract.
+        return { type: 'standard', signature };
+    }
+    async signPsbt(request) {
+        // Our domain is base64 (BIP-174); OKX speaks hex. autoFinalized:false keeps
+        // this sign-only (the wallet returns the signed-but-unfinalized PSBT).
+        const psbtHex = bytesToHex(base64ToBytes(request.psbt));
+        // Forward which inputs to sign (index + address, optional sighash) so the
+        // wallet signs exactly the requested set — matching the Wallet Standard
+        // adapter's `inputsToSign`. `request.from` isn't forwarded: OKX signs with
+        // its single active account, so there's no per-`from` routing. Omitted →
+        // OKX signs all inputs it can.
+        const toSignInputs = request.inputsToSign?.flatMap(input => input.signingIndexes.map(index => ({
+            index,
+            address: input.address,
+            ...(input.sigHash
+                ? { sighashTypes: [SIGHASH_VALUES[input.sigHash]] }
+                : {})
+        })));
+        const signedHex = await this.provider.signPsbt(psbtHex, {
+            autoFinalized: false,
+            ...(toSignInputs ? { toSignInputs } : {})
+        });
+        if (!signedHex) {
+            throw new WalletConnectorError({
+                type: 'unknown',
+                message: 'okx bitcoin: signPsbt returned no PSBT'
+            });
+        }
+        return bytesToBase64(hexToBytes(signedHex));
+    }
+    disconnect() {
+        // OKX's injected provider has no disconnect RPC; clearing session state is
+        // the caller's job.
+        return Promise.resolve();
+    }
+}
+//# sourceMappingURL=okx.js.map

package/dist/adapters/okx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"okx.js","sourceRoot":"","sources":["../../src/adapters/okx.ts"],"names":[],"mappings":"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"}

package/dist/adapters/wallet-standard.d.ts

@@ -0,0 +1,88 @@
+import type { BitcoinAccount, BitcoinPsbtSignRequest, BitcoinSignMessageParams, SignatureType } from '@meshconnect/uwc-types';
+import type { BitcoinTransportAdapter } from '../adapter';
+/**
+ * The subset of the Wallet Standard `bitcoin:*` interface this adapter drives.
+ * Structural (no `@wallet-standard/*` dependency); grounded on the community
+ * bitcoin-wallet-standard interface that MetaMask exposes. (OKX signs BTC too,
+ * but via a legacy injected provider, not Wallet Standard — it needs a separate
+ * adapter, not this one.)
+ * @see https://github.com/ExodusMovement/bitcoin-wallet-standard
+ */
+export interface WalletStandardBitcoinAccount {
+    address: string;
+    publicKey: Uint8Array;
+    purpose?: 'payment' | 'ordinals';
+}
+interface BitcoinConnectFeature {
+    connect(input: {
+        purposes: ('payment' | 'ordinals')[];
+    }): Promise<{
+        accounts: WalletStandardBitcoinAccount[];
+    }>;
+}
+interface BitcoinSignMessageFeature {
+    signMessage(input: {
+        account: WalletStandardBitcoinAccount;
+        message: Uint8Array;
+        protocol?: 'ecdsa' | 'bip322';
+    }): Promise<{
+        signature: Uint8Array;
+        signedMessage: Uint8Array;
+    }[]>;
+}
+interface BitcoinSignTransactionFeature {
+    signTransaction(input: {
+        account: WalletStandardBitcoinAccount;
+        psbt: Uint8Array;
+        inputsToSign?: {
+            account: WalletStandardBitcoinAccount;
+            signingIndexes: number[];
+            sigHash?: string;
+        }[];
+    }): Promise<{
+        psbt: Uint8Array;
+    }[]>;
+}
+/** The handle the injected transport passes in (a discovered `bitcoin:*` wallet). */
+export interface WalletStandardBitcoinWallet {
+    name: string;
+    accounts: readonly WalletStandardBitcoinAccount[];
+    features: Record<string, unknown> & {
+        'bitcoin:connect'?: BitcoinConnectFeature;
+        'bitcoin:signMessage'?: BitcoinSignMessageFeature;
+        'bitcoin:signTransaction'?: BitcoinSignTransactionFeature;
+    };
+}
+/**
+ * Wallet Standard (`bitcoin:*`) transport adapter — the injected path for
+ * wallets that speak Wallet Standard (verified: MetaMask). The injected
+ * transport discovers the wallet and hands it here; this adapter performs the
+ * bip122-specific operations against it, converting hex/base64 ↔ `Uint8Array`
+ * at the boundary.
+ *
+ * `sendTransfer` is intentionally not implemented — Wallet Standard has no
+ * high-level transfer; that is the WalletConnect adapter's path.
+ */
+export declare class WalletStandardBitcoinAdapter implements BitcoinTransportAdapter {
+    private readonly wallet;
+    private accounts;
+    /**
+     * @param wallet The discovered `bitcoin:*` wallet.
+     * @param initialAccounts Optional already-authorized accounts to seed the
+     *   cache with. Passed on the SILENT restore path so the first
+     *   `signMessage`/`signPsbt` doesn't re-invoke `bitcoin:connect` (which some
+     *   wallets surface as UI) via `requireAccount`→`getAccounts`. Omit on a
+     *   fresh connect, where `getAccounts()` should call `bitcoin:connect` to
+     *   authorize.
+     */
+    constructor(wallet: WalletStandardBitcoinWallet, initialAccounts?: readonly WalletStandardBitcoinAccount[]);
+    getAccounts(): Promise<BitcoinAccount[]>;
+    signMessage(params: BitcoinSignMessageParams): Promise<SignatureType>;
+    signPsbt(request: BitcoinPsbtSignRequest): Promise<string>;
+    disconnect(): Promise<void>;
+    /** Look up the wallet-native account for an address, connecting first if needed. */
+    private requireAccount;
+    private unsupported;
+}
+export {};
+//# sourceMappingURL=wallet-standard.d.ts.map

package/dist/adapters/wallet-standard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-standard.d.ts","sourceRoot":"","sources":["../../src/adapters/wallet-standard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,sBAAsB,EACtB,wBAAwB,EACxB,aAAa,EACd,MAAM,wBAAwB,CAAA;AAE/B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AAQzD;;;;;;;GAOG;AACH,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,UAAU,CAAA;IACrB,OAAO,CAAC,EAAE,SAAS,GAAG,UAAU,CAAA;CACjC;AAED,UAAU,qBAAqB;IAC7B,OAAO,CAAC,KAAK,EAAE;QACb,QAAQ,EAAE,CAAC,SAAS,GAAG,UAAU,CAAC,EAAE,CAAA;KACrC,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,4BAA4B,EAAE,CAAA;KAAE,CAAC,CAAA;CAC1D;AAED,UAAU,yBAAyB;IACjC,WAAW,CAAC,KAAK,EAAE;QACjB,OAAO,EAAE,4BAA4B,CAAA;QACrC,OAAO,EAAE,UAAU,CAAA;QACnB,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAA;KAC9B,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,UAAU,CAAC;QAAC,aAAa,EAAE,UAAU,CAAA;KAAE,EAAE,CAAC,CAAA;CACpE;AAED,UAAU,6BAA6B;IACrC,eAAe,CAAC,KAAK,EAAE;QACrB,OAAO,EAAE,4BAA4B,CAAA;QACrC,IAAI,EAAE,UAAU,CAAA;QAChB,YAAY,CAAC,EAAE;YACb,OAAO,EAAE,4BAA4B,CAAA;YACrC,cAAc,EAAE,MAAM,EAAE,CAAA;YACxB,OAAO,CAAC,EAAE,MAAM,CAAA;SACjB,EAAE,CAAA;KACJ,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,UAAU,CAAA;KAAE,EAAE,CAAC,CAAA;CACpC;AAED,qFAAqF;AACrF,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,SAAS,4BAA4B,EAAE,CAAA;IACjD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QAClC,iBAAiB,CAAC,EAAE,qBAAqB,CAAA;QACzC,qBAAqB,CAAC,EAAE,yBAAyB,CAAA;QACjD,yBAAyB,CAAC,EAAE,6BAA6B,CAAA;KAC1D,CAAA;CACF;AAED;;;;;;;;;GASG;AACH,qBAAa,4BAA6B,YAAW,uBAAuB;IAaxE,OAAO,CAAC,QAAQ,CAAC,MAAM;IAZzB,OAAO,CAAC,QAAQ,CAAuD;IAEvE;;;;;;;;OAQG;gBAEgB,MAAM,EAAE,2BAA2B,EACpD,eAAe,CAAC,EAAE,SAAS,4BAA4B,EAAE;IAOrD,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAexC,WAAW,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,aAAa,CAAC;IAoBrE,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC;IA6BhE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,oFAAoF;YACtE,cAAc;IAoB5B,OAAO,CAAC,WAAW;CAMpB"}

package/dist/adapters/wallet-standard.js

@@ -0,0 +1,118 @@
+import { WalletConnectorError } from '@meshconnect/uwc-types';
+import { base64ToBytes, bytesToBase64, bytesToHex, utf8ToBytes } from '../encoding';
+/**
+ * Wallet Standard (`bitcoin:*`) transport adapter — the injected path for
+ * wallets that speak Wallet Standard (verified: MetaMask). The injected
+ * transport discovers the wallet and hands it here; this adapter performs the
+ * bip122-specific operations against it, converting hex/base64 ↔ `Uint8Array`
+ * at the boundary.
+ *
+ * `sendTransfer` is intentionally not implemented — Wallet Standard has no
+ * high-level transfer; that is the WalletConnect adapter's path.
+ */
+export class WalletStandardBitcoinAdapter {
+    wallet;
+    accounts = null;
+    /**
+     * @param wallet The discovered `bitcoin:*` wallet.
+     * @param initialAccounts Optional already-authorized accounts to seed the
+     *   cache with. Passed on the SILENT restore path so the first
+     *   `signMessage`/`signPsbt` doesn't re-invoke `bitcoin:connect` (which some
+     *   wallets surface as UI) via `requireAccount`→`getAccounts`. Omit on a
+     *   fresh connect, where `getAccounts()` should call `bitcoin:connect` to
+     *   authorize.
+     */
+    constructor(wallet, initialAccounts) {
+        this.wallet = wallet;
+        if (initialAccounts && initialAccounts.length > 0) {
+            this.accounts = initialAccounts;
+        }
+    }
+    async getAccounts() {
+        const connect = this.wallet.features['bitcoin:connect'];
+        // The wallet exposes accounts only after `bitcoin:connect`; fall back to any
+        // it already lists (a wallet without the connect feature).
+        this.accounts = connect
+            ? (await connect.connect({ purposes: ['payment'] })).accounts
+            : this.wallet.accounts;
+        return this.accounts.map(account => ({
+            address: account.address,
+            publicKey: bytesToHex(account.publicKey),
+            ...(account.purpose ? { purpose: account.purpose } : {})
+        }));
+    }
+    async signMessage(params) {
+        const feature = this.wallet.features['bitcoin:signMessage'];
+        if (!feature) {
+            throw this.unsupported('signMessage');
+        }
+        const account = await this.requireAccount(params.account.address);
+        const [result] = await feature.signMessage({
+            account,
+            message: utf8ToBytes(params.message),
+            ...(params.protocol ? { protocol: params.protocol } : {})
+        });
+        if (!result) {
+            throw new WalletConnectorError({
+                type: 'unknown',
+                message: 'wallet-standard bitcoin: signMessage returned no signature'
+            });
+        }
+        return { type: 'standard', signature: bytesToBase64(result.signature) };
+    }
+    async signPsbt(request) {
+        const feature = this.wallet.features['bitcoin:signTransaction'];
+        if (!feature) {
+            throw this.unsupported('signPsbt');
+        }
+        const account = await this.requireAccount(request.from);
+        const inputsToSign = request.inputsToSign
+            ? await Promise.all(request.inputsToSign.map(async (input) => ({
+                account: await this.requireAccount(input.address),
+                signingIndexes: input.signingIndexes,
+                ...(input.sigHash ? { sigHash: input.sigHash } : {})
+            })))
+            : undefined;
+        const [result] = await feature.signTransaction({
+            account,
+            psbt: base64ToBytes(request.psbt),
+            ...(inputsToSign ? { inputsToSign } : {})
+        });
+        if (!result) {
+            throw new WalletConnectorError({
+                type: 'unknown',
+                message: 'wallet-standard bitcoin: signTransaction returned no PSBT'
+            });
+        }
+        return bytesToBase64(result.psbt);
+    }
+    disconnect() {
+        this.accounts = null;
+        return Promise.resolve();
+    }
+    /** Look up the wallet-native account for an address, connecting first if needed. */
+    async requireAccount(address) {
+        if (!this.accounts)
+            await this.getAccounts();
+        const account = this.accounts?.find(a => a.address === address) ??
+            // The cached set is from an earlier authorize; the wallet may have since
+            // switched accounts (its `accounts` update in place). Re-check the
+            // wallet's CURRENT accounts before failing — so signing the live account
+            // after a switch resolves without re-invoking `bitcoin:connect`.
+            this.wallet.accounts?.find(a => a.address === address);
+        if (!account) {
+            throw new WalletConnectorError({
+                type: 'unknown',
+                message: `wallet-standard bitcoin: no connected account for "${address}"`
+            });
+        }
+        return account;
+    }
+    unsupported(method) {
+        return new WalletConnectorError({
+            type: 'unknown',
+            message: `wallet-standard bitcoin: this wallet does not support ${method}`
+        });
+    }
+}
+//# sourceMappingURL=wallet-standard.js.map

package/dist/adapters/wallet-standard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-standard.js","sourceRoot":"","sources":["../../src/adapters/wallet-standard.ts"],"names":[],"mappings":"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"}

package/dist/bitcoin-namespace.d.ts

@@ -1,10 +1,15 @@
-import type { BitcoinAccount, BitcoinSignMessageParams, Namespace, Network, SignatureType } from '@meshconnect/uwc-types';
+import type { BitcoinAccount, BitcoinPsbtSignRequest, BitcoinSendTransferRequest, BitcoinSignMessageParams, Namespace, Network, SignatureType, TransactionResult } from '@meshconnect/uwc-types';
 import type { BitcoinTransportAdapter } from './adapter';
 /** CAIP-2 namespace this module serves. */
 export declare const BITCOIN_NAMESPACE: Namespace;
 /**
- * Assert `network` is a bip122 network, else throw. Shared by the namespace
- * module and its transport adapters so the boundary check lives in one place.
+ * Assert `network` is the bip122 network this module actually supports
+ * (Bitcoin mainnet), else throw. Other bip122 chains (Dogecoin, Litecoin,
+ * etc.) share the namespace but differ in chain id — accepting them here
+ * would let a Bitcoin-only wallet silently return a Bitcoin address stamped
+ * with the wrong network id, so they must be rejected explicitly rather than
+ * only checking the namespace. Shared by the namespace module and its
+ * transport adapters so the boundary check lives in one place.
  */
 export declare function assertBitcoinNetwork(network: Network, method: string): void;
 /**
@@ -38,7 +43,19 @@ export declare class BitcoinNamespace {
     getAccounts(): Promise<BitcoinAccount[]>;
     /** Sign a message with the given account. */
     signMessage(params: BitcoinSignMessageParams): Promise<SignatureType>;
+    /**
+     * Sign a PSBT (Path B). Returns the wallet-signed PSBT (base64); finalizing +
+     * broadcasting is a separate step. Rejects if the active adapter's wallet
+     * does not support PSBT signing.
+     */
+    signPsbt(request: BitcoinPsbtSignRequest): Promise<string>;
+    /**
+     * High-level transfer (Path A): the wallet signs and broadcasts, returning a
+     * txid. Rejects if the active adapter's transport does not offer it.
+     */
+    sendTransfer(request: BitcoinSendTransferRequest): Promise<TransactionResult>;
     /** Release any session resources the adapter holds. */
     disconnect(): Promise<void>;
+    private unsupported;
 }
 //# sourceMappingURL=bitcoin-namespace.d.ts.map

package/dist/bitcoin-namespace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bitcoin-namespace.d.ts","sourceRoot":"","sources":["../src/bitcoin-namespace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,wBAAwB,EACxB,SAAS,EACT,OAAO,EACP,aAAa,EACd,MAAM,wBAAwB,CAAA;AAE/B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAA;AAExD,2CAA2C;AAC3C,eAAO,MAAM,iBAAiB,EAAE,SAAoB,CAAA;AAEpD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAO3E;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,gBAAgB;IAIf,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,YAAoB;gBAET,OAAO,EAAE,uBAAuB;IAE7D,mDAAmD;IACnD,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAI9C,8DAA8D;IAC9D,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAIxC,6CAA6C;IAC7C,WAAW,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,aAAa,CAAC;IAIrE,uDAAuD;IACjD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAGlC"}
+{"version":3,"file":"bitcoin-namespace.d.ts","sourceRoot":"","sources":["../src/bitcoin-namespace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,SAAS,EACT,OAAO,EACP,aAAa,EACb,iBAAiB,EAClB,MAAM,wBAAwB,CAAA;AAG/B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAA;AAExD,2CAA2C;AAC3C,eAAO,MAAM,iBAAiB,EAAE,SAAoB,CAAA;AAEpD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAa3E;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,gBAAgB;IAIf,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,YAAoB;gBAET,OAAO,EAAE,uBAAuB;IAE7D,mDAAmD;IACnD,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAI9C,8DAA8D;IAC9D,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAIxC,6CAA6C;IAC7C,WAAW,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,aAAa,CAAC;IAIrE;;;;OAIG;IACG,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC;IAKhE;;;OAGG;IACG,YAAY,CAChB,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,iBAAiB,CAAC;IAK7B,uDAAuD;IACjD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,OAAO,CAAC,WAAW;CAMpB"}

package/dist/bitcoin-namespace.js

@@ -1,9 +1,15 @@
+import { bitcoinNetwork } from '@meshconnect/uwc-constants';
 import { WalletConnectorError } from '@meshconnect/uwc-types';
 /** CAIP-2 namespace this module serves. */
 export const BITCOIN_NAMESPACE = 'bip122';
 /**
- * Assert `network` is a bip122 network, else throw. Shared by the namespace
- * module and its transport adapters so the boundary check lives in one place.
+ * Assert `network` is the bip122 network this module actually supports
+ * (Bitcoin mainnet), else throw. Other bip122 chains (Dogecoin, Litecoin,
+ * etc.) share the namespace but differ in chain id — accepting them here
+ * would let a Bitcoin-only wallet silently return a Bitcoin address stamped
+ * with the wrong network id, so they must be rejected explicitly rather than
+ * only checking the namespace. Shared by the namespace module and its
+ * transport adapters so the boundary check lives in one place.
  */
 export function assertBitcoinNetwork(network, method) {
     if (network.namespace !== BITCOIN_NAMESPACE) {
@@ -12,6 +18,12 @@ export function assertBitcoinNetwork(network, method) {
             message: `${method}: expected a bip122 network but got "${network.id}"`
         });
     }
+    if (network.id !== bitcoinNetwork.id) {
+        throw new WalletConnectorError({
+            type: 'unknown',
+            message: `${method}: unsupported bip122 chain "${network.id}" — only Bitcoin mainnet ("${bitcoinNetwork.id}") is supported`
+        });
+    }
 }
 /**
  * Bitcoin (bip122) namespace module.
@@ -52,9 +64,34 @@ export class BitcoinNamespace {
     signMessage(params) {
         return this.adapter.signMessage(params);
     }
+    /**
+     * Sign a PSBT (Path B). Returns the wallet-signed PSBT (base64); finalizing +
+     * broadcasting is a separate step. Rejects if the active adapter's wallet
+     * does not support PSBT signing.
+     */
+    async signPsbt(request) {
+        if (!this.adapter.signPsbt)
+            throw this.unsupported('signPsbt');
+        return this.adapter.signPsbt(request);
+    }
+    /**
+     * High-level transfer (Path A): the wallet signs and broadcasts, returning a
+     * txid. Rejects if the active adapter's transport does not offer it.
+     */
+    async sendTransfer(request) {
+        if (!this.adapter.sendTransfer)
+            throw this.unsupported('sendTransfer');
+        return this.adapter.sendTransfer(request);
+    }
     /** Release any session resources the adapter holds. */
     async disconnect() {
         await this.adapter.disconnect?.();
     }
+    unsupported(method) {
+        return new WalletConnectorError({
+            type: 'unknown',
+            message: `BitcoinNamespace.${method}: the active adapter does not support it`
+        });
+    }
 }
 //# sourceMappingURL=bitcoin-namespace.js.map

package/dist/bitcoin-namespace.js.map

@@ -1 +1 @@
-{"version":3,"file":"bitcoin-namespace.js","sourceRoot":"","sources":["../src/bitcoin-namespace.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAG7D,2CAA2C;AAC3C,MAAM,CAAC,MAAM,iBAAiB,GAAc,QAAQ,CAAA;AAEpD;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAgB,EAAE,MAAc;IACnE,IAAI,OAAO,CAAC,SAAS,KAAK,iBAAiB,EAAE,CAAC;QAC5C,MAAM,IAAI,oBAAoB,CAAC;YAC7B,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,GAAG,MAAM,wCAAwC,OAAO,CAAC,EAAE,GAAG;SACxE,CAAC,CAAA;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,gBAAgB;IAIE;IAH7B,2CAA2C;IAClC,SAAS,GAAG,iBAAiB,CAAA;IAEtC,YAA6B,OAAgC;QAAhC,YAAO,GAAP,OAAO,CAAyB;IAAG,CAAC;IAEjE,mDAAmD;IACnD,sBAAsB,CAAC,OAAgB;QACrC,oBAAoB,CAAC,OAAO,EAAE,yCAAyC,CAAC,CAAA;IAC1E,CAAC;IAED,8DAA8D;IAC9D,WAAW;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAA;IACnC,CAAC;IAED,6CAA6C;IAC7C,WAAW,CAAC,MAAgC;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;IACzC,CAAC;IAED,uDAAuD;IACvD,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAA;IACnC,CAAC;CACF"}
+{"version":3,"file":"bitcoin-namespace.js","sourceRoot":"","sources":["../src/bitcoin-namespace.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAG7D,2CAA2C;AAC3C,MAAM,CAAC,MAAM,iBAAiB,GAAc,QAAQ,CAAA;AAEpD;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAgB,EAAE,MAAc;IACnE,IAAI,OAAO,CAAC,SAAS,KAAK,iBAAiB,EAAE,CAAC;QAC5C,MAAM,IAAI,oBAAoB,CAAC;YAC7B,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,GAAG,MAAM,wCAAwC,OAAO,CAAC,EAAE,GAAG;SACxE,CAAC,CAAA;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,EAAE,KAAK,cAAc,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,IAAI,oBAAoB,CAAC;YAC7B,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,GAAG,MAAM,+BAA+B,OAAO,CAAC,EAAE,8BAA8B,cAAc,CAAC,EAAE,iBAAiB;SAC5H,CAAC,CAAA;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,gBAAgB;IAIE;IAH7B,2CAA2C;IAClC,SAAS,GAAG,iBAAiB,CAAA;IAEtC,YAA6B,OAAgC;QAAhC,YAAO,GAAP,OAAO,CAAyB;IAAG,CAAC;IAEjE,mDAAmD;IACnD,sBAAsB,CAAC,OAAgB;QACrC,oBAAoB,CAAC,OAAO,EAAE,yCAAyC,CAAC,CAAA;IAC1E,CAAC;IAED,8DAA8D;IAC9D,WAAW;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAA;IACnC,CAAC;IAED,6CAA6C;IAC7C,WAAW,CAAC,MAAgC;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;IACzC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAQ,CAAC,OAA+B;QAC5C,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ;YAAE,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAA;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IACvC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAChB,OAAmC;QAEnC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY;YAAE,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,CAAA;QACtE,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA;IAC3C,CAAC;IAED,uDAAuD;IACvD,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAA;IACnC,CAAC;IAEO,WAAW,CAAC,MAAc;QAChC,OAAO,IAAI,oBAAoB,CAAC;YAC9B,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,oBAAoB,MAAM,0CAA0C;SAC9E,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/encoding.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Minimal encoding helpers for the boundary between our transport-agnostic
+ * domain shapes (hex/base64 strings, JSON-safe) and the Wallet Standard
+ * `bitcoin:*` interface (raw `Uint8Array`). Uses only Web-standard APIs
+ * (`TextEncoder`, `atob`/`btoa`) so `uwc-bitcoin` stays dependency-free.
+ */
+export declare function utf8ToBytes(text: string): Uint8Array;
+export declare function bytesToHex(bytes: Uint8Array): string;
+export declare function bytesToBase64(bytes: Uint8Array): string;
+export declare function base64ToBytes(base64: string): Uint8Array;
+export declare function hexToBytes(hex: string): Uint8Array;
+//# sourceMappingURL=encoding.d.ts.map

package/dist/encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.d.ts","sourceRoot":"","sources":["../src/encoding.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAEpD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAIpD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAIvD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAKxD;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAgBlD"}

package/dist/encoding.js

@@ -0,0 +1,46 @@
+/**
+ * Minimal encoding helpers for the boundary between our transport-agnostic
+ * domain shapes (hex/base64 strings, JSON-safe) and the Wallet Standard
+ * `bitcoin:*` interface (raw `Uint8Array`). Uses only Web-standard APIs
+ * (`TextEncoder`, `atob`/`btoa`) so `uwc-bitcoin` stays dependency-free.
+ */
+export function utf8ToBytes(text) {
+    return new TextEncoder().encode(text);
+}
+export function bytesToHex(bytes) {
+    let hex = '';
+    for (const byte of bytes)
+        hex += byte.toString(16).padStart(2, '0');
+    return hex;
+}
+export function bytesToBase64(bytes) {
+    let binary = '';
+    for (const byte of bytes)
+        binary += String.fromCharCode(byte);
+    return btoa(binary);
+}
+export function base64ToBytes(base64) {
+    const binary = atob(base64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++)
+        bytes[i] = binary.charCodeAt(i);
+    return bytes;
+}
+export function hexToBytes(hex) {
+    const clean = /^0x/i.test(hex) ? hex.slice(2) : hex;
+    if (clean.length % 2 !== 0) {
+        throw new Error('hexToBytes: odd-length hex string');
+    }
+    // Validate before parsing: `parseInt` on a non-hex pair yields NaN, which a
+    // Uint8Array silently coerces to 0 — so bad input would corrupt data (a PSBT
+    // or public key) instead of failing fast. Reject it.
+    if (!/^[0-9a-fA-F]*$/.test(clean)) {
+        throw new Error('hexToBytes: non-hex characters');
+    }
+    const bytes = new Uint8Array(clean.length / 2);
+    for (let i = 0; i < bytes.length; i++) {
+        bytes[i] = parseInt(clean.slice(i * 2, i * 2 + 2), 16);
+    }
+    return bytes;
+}
+//# sourceMappingURL=encoding.js.map

package/dist/encoding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.js","sourceRoot":"","sources":["../src/encoding.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;AACvC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAiB;IAC1C,IAAI,GAAG,GAAG,EAAE,CAAA;IACZ,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IACnE,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAiB;IAC7C,IAAI,MAAM,GAAG,EAAE,CAAA;IACf,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAA;IAC7D,OAAO,IAAI,CAAC,MAAM,CAAC,CAAA;AACrB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAA;IAC3B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;IACvE,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;IACnD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;IACtD,CAAC;IACD,4EAA4E;IAC5E,6EAA6E;IAC7E,qDAAqD;IACrD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAA;IACnD,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAC9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,KAAK,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IACxD,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,8 @@
 export { BitcoinNamespace, assertBitcoinNetwork, BITCOIN_NAMESPACE } from './bitcoin-namespace';
 export type { BitcoinTransportAdapter } from './adapter';
+export { WalletStandardBitcoinAdapter } from './adapters/wallet-standard';
+export type { WalletStandardBitcoinWallet, WalletStandardBitcoinAccount } from './adapters/wallet-standard';
+export { OkxBitcoinAdapter } from './adapters/okx';
+export type { OkxBitcoinProvider } from './adapters/okx';
+export { bytesToHex, hexToBytes } from './encoding';
 //# sourceMappingURL=index.d.ts.map