@meshconnect/uwc-bitcoin 0.2.3 → 0.2.4-snapshot.aa56682

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/wallet-standard.d.ts

@@ -0,0 +1,79 @@
+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;
+    constructor(wallet: WalletStandardBitcoinWallet);
+    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;IAG9D,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAuD;gBAE1C,MAAM,EAAE,2BAA2B;IAE1D,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;IAc5B,OAAO,CAAC,WAAW;CAMpB"}

package/dist/adapters/wallet-standard.js

@@ -0,0 +1,101 @@
+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;
+    constructor(wallet) {
+        this.wallet = wallet;
+    }
+    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);
+        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/adapters/walletconnect.d.ts

@@ -0,0 +1,36 @@
+import type { BitcoinAccount, BitcoinPsbtSignRequest, BitcoinSendTransferRequest, BitcoinSignMessageParams, SignatureType, TransactionResult } from '@meshconnect/uwc-types';
+import type { BitcoinTransportAdapter } from '../adapter';
+/**
+ * Issues a WalletConnect JSON-RPC request for a bip122 method. The WalletConnect
+ * transport binds this to its live `SignClient` + session topic + chainId, e.g.
+ * `(method, params) => signClient.request({ topic, chainId, request: { method, params } })`.
+ * Kept as a plain function so `uwc-bitcoin` needs no `@walletconnect/*` dependency.
+ */
+export type BitcoinWalletConnectRequest = (method: string, params: Record<string, unknown>) => Promise<unknown>;
+/**
+ * WalletConnect (bip122) transport adapter — the Path A / mobile path (Trust
+ * Wallet, …). The WalletConnect transport pairs the session and constructs this
+ * adapter bound to the connected account's first external address plus a
+ * `request` function; this adapter maps our domain shapes onto the Reown/CAIP-2
+ * bip122 JSON-RPC methods (`getAccountAddresses`, `signMessage`, `signPsbt`,
+ * `sendTransfer`).
+ *
+ * Wire format follows the Reown Bitcoin RPC reference (what wallets implement
+ * over WalletConnect) — all-JSON strings, `account` on every request. NOTE:
+ * untested end-to-end; grounded on the spec, not a live wallet.
+ */
+export declare class WalletConnectBitcoinAdapter implements BitcoinTransportAdapter {
+    private readonly account;
+    private readonly request;
+    /**
+     * @param account The connected account's first external address — the
+     *   `account` parameter every bip122 method requires.
+     * @param request Issues the bound WalletConnect JSON-RPC request.
+     */
+    constructor(account: string, request: BitcoinWalletConnectRequest);
+    getAccounts(): Promise<BitcoinAccount[]>;
+    signMessage(params: BitcoinSignMessageParams): Promise<SignatureType>;
+    signPsbt(request: BitcoinPsbtSignRequest): Promise<string>;
+    sendTransfer(request: BitcoinSendTransferRequest): Promise<TransactionResult>;
+}
+//# sourceMappingURL=walletconnect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"walletconnect.d.ts","sourceRoot":"","sources":["../../src/adapters/walletconnect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,sBAAsB,EACtB,0BAA0B,EAE1B,wBAAwB,EACxB,aAAa,EACb,iBAAiB,EAClB,MAAM,wBAAwB,CAAA;AAE/B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AAEzD;;;;;GAKG;AACH,MAAM,MAAM,2BAA2B,GAAG,CACxC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,OAAO,CAAC,OAAO,CAAC,CAAA;AAmBrB;;;;;;;;;;;GAWG;AACH,qBAAa,2BAA4B,YAAW,uBAAuB;IAOvE,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAP1B;;;;OAIG;gBAEgB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,2BAA2B;IAGjD,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAgBxC,WAAW,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,aAAa,CAAC;IAUrE,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC;IA0B1D,YAAY,CAChB,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,iBAAiB,CAAC;CAQ9B"}

package/dist/adapters/walletconnect.js

@@ -0,0 +1,90 @@
+import { WalletConnectorError } from '@meshconnect/uwc-types';
+/** Maps a SIGHASH flag to its numeric value (Bitcoin Core encoding). */
+const SIGHASH_VALUES = {
+    ALL: 0x01,
+    NONE: 0x02,
+    SINGLE: 0x03,
+    'ALL|ANYONECANPAY': 0x81,
+    'NONE|ANYONECANPAY': 0x82,
+    'SINGLE|ANYONECANPAY': 0x83
+};
+/**
+ * WalletConnect (bip122) transport adapter — the Path A / mobile path (Trust
+ * Wallet, …). The WalletConnect transport pairs the session and constructs this
+ * adapter bound to the connected account's first external address plus a
+ * `request` function; this adapter maps our domain shapes onto the Reown/CAIP-2
+ * bip122 JSON-RPC methods (`getAccountAddresses`, `signMessage`, `signPsbt`,
+ * `sendTransfer`).
+ *
+ * Wire format follows the Reown Bitcoin RPC reference (what wallets implement
+ * over WalletConnect) — all-JSON strings, `account` on every request. NOTE:
+ * untested end-to-end; grounded on the spec, not a live wallet.
+ */
+export class WalletConnectBitcoinAdapter {
+    account;
+    request;
+    /**
+     * @param account The connected account's first external address — the
+     *   `account` parameter every bip122 method requires.
+     * @param request Issues the bound WalletConnect JSON-RPC request.
+     */
+    constructor(account, request) {
+        this.account = account;
+        this.request = request;
+    }
+    async getAccounts() {
+        const result = (await this.request('getAccountAddresses', {
+            account: this.account
+        }));
+        return result.map(entry => ({
+            address: entry.address,
+            // WalletConnect wallets MAY omit the public key; empty when absent.
+            publicKey: entry.publicKey ?? '',
+            ...(entry.intention === 'ordinal'
+                ? { purpose: 'ordinals' }
+                : entry.intention === 'payment'
+                    ? { purpose: 'payment' }
+                    : {})
+        }));
+    }
+    async signMessage(params) {
+        const result = (await this.request('signMessage', {
+            account: this.account,
+            message: params.message,
+            address: params.account.address,
+            ...(params.protocol ? { protocol: params.protocol } : {})
+        }));
+        return { type: 'standard', signature: result.signature };
+    }
+    async signPsbt(request) {
+        if (!request.inputsToSign?.length) {
+            throw new WalletConnectorError({
+                type: 'unknown',
+                message: 'walletconnect bitcoin: signPsbt requires inputsToSign (the WC signPsbt method has no "sign all" mode)'
+            });
+        }
+        const signInputs = request.inputsToSign.flatMap(input => input.signingIndexes.map(index => ({
+            address: input.address,
+            index,
+            ...(input.sigHash
+                ? { sighashTypes: [SIGHASH_VALUES[input.sigHash]] }
+                : {})
+        })));
+        const result = (await this.request('signPsbt', {
+            account: this.account,
+            psbt: request.psbt,
+            signInputs,
+            broadcast: false
+        }));
+        return result.psbt;
+    }
+    async sendTransfer(request) {
+        const result = (await this.request('sendTransfer', {
+            account: this.account,
+            recipientAddress: request.to,
+            amount: request.amount.toString()
+        }));
+        return result.txid;
+    }
+}
+//# sourceMappingURL=walletconnect.js.map

package/dist/adapters/walletconnect.js.map

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

package/dist/bitcoin-namespace.d.ts

@@ -1,4 +1,4 @@
-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;
@@ -38,7 +38,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;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;;;;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

@@ -52,9 +52,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,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;;;;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,11 @@
+/**
+ * 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;
+//# 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"}

package/dist/encoding.js

@@ -0,0 +1,29 @@
+/**
+ * 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;
+}
+//# 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"}

package/dist/index.d.ts

@@ -1,3 +1,7 @@
 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 { WalletConnectBitcoinAdapter } from './adapters/walletconnect';
+export type { BitcoinWalletConnectRequest } from './adapters/walletconnect';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAA;AACxD,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAA;AACzE,YAAY,EACV,2BAA2B,EAC3B,4BAA4B,EAC7B,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAA;AACtE,YAAY,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAA"}

package/dist/index.js

@@ -1,2 +1,4 @@
 export { BitcoinNamespace, assertBitcoinNetwork, BITCOIN_NAMESPACE } from './bitcoin-namespace';
+export { WalletStandardBitcoinAdapter } from './adapters/wallet-standard';
+export { WalletConnectBitcoinAdapter } from './adapters/walletconnect';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAA;AAKzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meshconnect/uwc-bitcoin",
-  "version": "0.2.3",
+  "version": "0.2.4-snapshot.aa56682",
   "description": "Mesh-owned Bitcoin (bip122) namespace module for Universal Wallet Connector — network-specific logic (PSBT, address/network handling, mempool broadcast) with pluggable transport adapters (Wallet Standard bitcoin:* and WalletConnect bip122), consumed by the injected and walletConnect transport connectors",
   "type": "module",
   "main": "dist/index.js",
@@ -16,7 +16,7 @@
     "src"
   ],
   "dependencies": {
-    "@meshconnect/uwc-types": "0.26.0"
+    "@meshconnect/uwc-types": "0.26.1-snapshot.aa56682"
   },
   "devDependencies": {
     "typescript": "^5.9.3"

package/src/adapter.ts

@@ -1,23 +1,27 @@
 import type {
   BitcoinAccount,
+  BitcoinPsbtSignRequest,
+  BitcoinSendTransferRequest,
   BitcoinSignMessageParams,
-  SignatureType
+  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. */
@@ -26,6 +30,20 @@ export interface BitcoinTransportAdapter {
   /** 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>
 }