feat(btc): add PSBT signing and broadcasting support

packages/core/src/signer/btc/index.ts

@@ -1,3 +1,4 @@
+export * from "./psbt.js";
 export * from "./signerBtc.js";
 export * from "./signerBtcPublicKeyReadonly.js";
 export * from "./verify.js";

packages/core/src/signer/btc/psbt.ts

@@ -0,0 +1,56 @@
+/**
+ * Options for signing a PSBT (Partially Signed Bitcoin Transaction)
+ */
+export type SignPsbtOptions = {
+  /**
+   * Whether to finalize the PSBT after signing.
+   * Default is true.
+   */
+  autoFinalized?: boolean;
+  /**
+   * Array of inputs to sign
+   */
+  toSignInputs?: ToSignInput[];
+};
+
+/**
+ * Specification for an input to sign in a PSBT.
+ * Must specify at least one of: address or pubkey.
+ */
+export type ToSignInput = {
+  /**
+   * Which input to sign (index in the PSBT inputs array)
+   */
+  index: number;
+  /**
+   * (Optional) Sighash types to use for signing.
+   */
+  sighashTypes?: number[];
+  /**
+   * (Optional) When signing and unlocking Taproot addresses, the tweakSigner is used by default
+   * for signature generation. Setting this to true allows for signing with the original private key.
+   * Default value is false.
+   */
+  disableTweakSigner?: boolean;
+} & (
+  | {
+      /**
+       * The address whose corresponding private key to use for signing.
+       */
+      address: string;
+      /**
+       * The public key whose corresponding private key to use for signing.
+       */
+      publicKey?: string;
+    }
+  | {
+      /**
+       * The address whose corresponding private key to use for signing.
+       */
+      address?: string;
+      /**
+       * The public key whose corresponding private key to use for signing.
+       */
+      publicKey: string;
+    }
+);

packages/core/src/signer/btc/signerBtc.ts

@@ -5,6 +5,7 @@ import { KnownScript } from "../../client/index.js";
 import { HexLike, hexFrom } from "../../hex/index.js";
 import { numToBytes } from "../../num/index.js";
 import { Signer, SignerSignType, SignerType } from "../signer/index.js";
+import { SignPsbtOptions } from "./psbt.js";
 import { btcEcdsaPublicKeyHash } from "./verify.js";
 
 /**
@@ -22,6 +23,22 @@ export abstract class SignerBtc extends Signer {
     return SignerSignType.BtcEcdsa;
   }
 
+  /**
+   * Sign and broadcast a PSBT.
+   *
+   * @param psbtHex - The hex string (without 0x prefix) of PSBT to sign and broadcast.
+   * @param options - Options for signing the PSBT.
+   * @returns A promise that resolves to the transaction ID (non-0x prefixed hex).
+   */
+  async signAndBroadcastPsbt(
+    psbtHex: HexLike,
+    options?: SignPsbtOptions,
+  ): Promise<string> {
+    // ccc.hexFrom adds 0x prefix, but BTC expects non-0x
+    const signedPsbt = await this.signPsbt(hexFrom(psbtHex).slice(2), options);
+    return this.broadcastPsbt(signedPsbt, options);
+  }
+
   /**
    * Gets the Bitcoin account associated with the signer.
    *
@@ -123,4 +140,30 @@ export abstract class SignerBtc extends Signer {
     tx.setWitnessArgsAt(info.position, witness);
     return tx;
   }
+
+  /**
+   * Signs a Partially Signed Bitcoin Transaction (PSBT).
+   *
+   * @param psbtHex - The hex string (without 0x prefix) of PSBT to sign.
+   * @param options - Options for signing the PSBT
+   * @returns A promise that resolves to the signed PSBT hex string (without 0x prefix)
+   */
+  abstract signPsbt(
+    psbtHex: HexLike,
+    options?: SignPsbtOptions,
+  ): Promise<string>;
+
+  /**
+   * Broadcasts a PSBT to the Bitcoin network.
+   *
+   * @param psbtHex - The hex string (without 0x prefix) of the PSBT to broadcast.
+   * @param options - Options for broadcasting the PSBT.
+   * @returns A promise that resolves to the transaction ID (without 0x prefix).
+   */
+  async broadcastPsbt(
+    _psbtHex: HexLike,
+    _options?: SignPsbtOptions,
+  ): Promise<string> {
+    throw new Error("Not implemented");
+  }
 }

packages/core/src/signer/btc/signerBtcPublicKeyReadonly.ts

@@ -1,5 +1,6 @@
 import { Client } from "../../client/index.js";
 import { Hex, HexLike, hexFrom } from "../../hex/index.js";
+import { SignPsbtOptions } from "./psbt.js";
 import { SignerBtc } from "./signerBtc.js";
 
 /**
@@ -70,4 +71,12 @@ export class SignerBtcPublicKeyReadonly extends SignerBtc {
   async getBtcPublicKey(): Promise<Hex> {
     return this.publicKey;
   }
+
+  async signPsbt(_: HexLike, __?: SignPsbtOptions): Promise<string> {
+    throw new Error("Read-only signer does not support signPsbt");
+  }
+
+  async broadcastPsbt(_: HexLike, __?: SignPsbtOptions): Promise<string> {
+    throw new Error("Read-only signer does not support broadcastPsbt");
+  }
 }

packages/joy-id/src/btc/index.ts

@@ -198,4 +198,78 @@ export class BitcoinSigner extends ccc.SignerBtc {
     );
     return signature;
   }
+
+  /**
+   * Signs a PSBT using JoyID wallet.
+   *
+   * @param psbtHex - The hex string (without 0x prefix) of PSBT to sign.
+   * @returns A promise that resolves to the signed PSBT hex string (without 0x prefix)
+   */
+  async signPsbt(
+    psbtHex: ccc.HexLike,
+    options?: ccc.SignPsbtOptions,
+  ): Promise<string> {
+    const { address } = await this.assertConnection();
+
+    const config = this.getConfig();
+    const { tx: signedPsbtHex } = await createPopup(
+      buildJoyIDURL(
+        {
+          ...config,
+          tx: ccc.hexFrom(psbtHex).slice(2),
+          options,
+          signerAddress: address,
+          autoFinalized: options?.autoFinalized ?? true,
+        },
+        "popup",
+        "/sign-psbt",
+      ),
+      { ...config, type: DappRequestType.SignPsbt },
+    );
+
+    return signedPsbtHex;
+  }
+
+  /**
+   * Broadcasts a PSBT to the Bitcoin network.
+   *
+   * @remarks
+   * JoyID does not support broadcasting a signed PSBT directly.
+   * It only supports "Sign and Broadcast" as a single atomic operation via `signAndBroadcastPsbt`.
+   */
+  async broadcastPsbt(
+    _psbtHex: ccc.HexLike,
+    _options?: ccc.SignPsbtOptions,
+  ): Promise<string> {
+    throw new Error(
+      "JoyID does not support broadcasting signed PSBTs directly. Use signAndBroadcastPsbt instead.",
+    );
+  }
+
+  async signAndBroadcastPsbt(
+    psbtHex: ccc.HexLike,
+    options?: ccc.SignPsbtOptions,
+  ): Promise<string> {
+    const { address } = await this.assertConnection();
+
+    const config = this.getConfig();
+    // ccc.hexFrom adds 0x prefix, but BTC expects non-0x
+    const { tx: txid } = await createPopup(
+      buildJoyIDURL(
+        {
+          ...config,
+          tx: ccc.hexFrom(psbtHex).slice(2),
+          options,
+          signerAddress: address,
+          autoFinalized: true, // sendPsbt always finalizes
+          isSend: true,
+        },
+        "popup",
+        "/sign-psbt",
+      ),
+      { ...config, type: DappRequestType.SignPsbt }, // Use SignPsbt type for both operations
+    );
+
+    return txid;
+  }
 }

packages/okx/src/advancedBarrel.ts

@@ -2,8 +2,21 @@ import { Nip07A } from "@ckb-ccc/nip07/advanced";
 import { UniSatA } from "@ckb-ccc/uni-sat/advanced";
 
 export interface BitcoinProvider
-  extends Pick<UniSatA.Provider, "on" | "removeListener" | "signMessage">,
-    Partial<Omit<UniSatA.Provider, "on" | "removeListener" | "signMessage">> {
+  extends Pick<
+      UniSatA.Provider,
+      "on" | "removeListener" | "signMessage" | "signPsbt" | "pushPsbt"
+    >,
+    Partial<
+      Omit<
+        UniSatA.Provider,
+        | "on"
+        | "removeListener"
+        | "signMessage"
+        | "signPsbt"
+        | "pushPsbt"
+        | "pushTx"
+      >
+    > {
   connect?(): Promise<{
     address: string;
     publicKey: string;

packages/okx/src/btc/index.ts

@@ -176,4 +176,31 @@ export class BitcoinSigner extends ccc.SignerBtc {
 
     return this.provider.signMessage(challenge, "ecdsa");
   }
+
+  /**
+   * Signs a PSBT using OKX wallet.
+   *
+   * @param psbtHex - The hex string (without 0x prefix) of PSBT to sign.
+   * @param options - Options for signing the PSBT
+   * @returns A promise that resolves to the signed PSBT hex string (without 0x prefix)
+   */
+  async signPsbt(
+    psbtHex: ccc.HexLike,
+    options?: ccc.SignPsbtOptions,
+  ): Promise<string> {
+    return this.provider.signPsbt(ccc.hexFrom(psbtHex).slice(2), options);
+  }
+
+  /**
+   * Broadcasts a signed PSBT to the Bitcoin network.
+   *
+   * @param psbtHex - The hex string (without 0x prefix) of signed PSBT to broadcast.
+   * @returns A promise that resolves to the transaction ID (without 0x prefix)
+   */
+  async broadcastPsbt(
+    psbtHex: ccc.HexLike,
+    _options?: ccc.SignPsbtOptions,
+  ): Promise<string> {
+    return this.provider.pushPsbt(ccc.hexFrom(psbtHex).slice(2));
+  }
 }

packages/uni-sat/src/advancedBarrel.ts

@@ -1,7 +1,26 @@
+import { ccc } from "@ckb-ccc/core";
+
 /**
  * Interface representing a provider for interacting with accounts and signing messages.
  */
 export interface Provider {
+  /**
+   * Signs a PSBT using UniSat wallet.
+   *
+   * @param psbtHex - The hex string of PSBT to sign
+   * @param options - Options for signing the PSBT
+   * @returns A promise that resolves to the signed PSBT hex string
+   */
+  signPsbt(psbtHex: string, options?: ccc.SignPsbtOptions): Promise<string>;
+
+  /**
+   * Broadcasts a signed PSBT to the Bitcoin network.
+   *
+   * @param psbtHex - The hex string of the signed PSBT to broadcast.
+   * @returns A promise that resolves to the transaction ID.
+   */
+  pushPsbt(psbtHex: string): Promise<string>;
+
   /**
    * Requests user accounts.
    * @returns A promise that resolves to an array of account addresses.

packages/uni-sat/src/signer.ts

@@ -150,4 +150,31 @@ export class Signer extends ccc.SignerBtc {
 
     return this.provider.signMessage(challenge, "ecdsa");
   }
+
+  /**
+   * Signs a PSBT using UniSat wallet.
+   *
+   * @param psbtHex - The hex string (without 0x prefix) of PSBT to sign.
+   * @param options - Options for signing the PSBT
+   * @returns A promise that resolves to the signed PSBT hex string (without 0x prefix)
+   */
+  async signPsbt(
+    psbtHex: ccc.HexLike,
+    options?: ccc.SignPsbtOptions,
+  ): Promise<string> {
+    return this.provider.signPsbt(ccc.hexFrom(psbtHex).slice(2), options);
+  }
+
+  /**
+   * Broadcasts a signed PSBT to the Bitcoin network.
+   *
+   * @param psbtHex - The hex string (without 0x prefix) of signed PSBT to broadcast.
+   * @returns A promise that resolves to the transaction ID (without 0x prefix)
+   */
+  async broadcastPsbt(
+    psbtHex: ccc.HexLike,
+    _options?: ccc.SignPsbtOptions,
+  ): Promise<string> {
+    return this.provider.pushPsbt(ccc.hexFrom(psbtHex).slice(2));
+  }
 }

packages/utxo-global/src/btc/index.ts

@@ -127,4 +127,32 @@ export class SignerBtc extends ccc.SignerBtc {
       this.accountCache ?? (await this.getBtcAccount()),
     );
   }
+
+  /**
+   * Signs a PSBT using UTXO Global wallet.
+   *
+   * @param psbtHex - The hex string (without 0x prefix) of PSBT to sign.
+   * @param options - Options for signing the PSBT
+   * @returns A promise that resolves to the signed PSBT hex string (without 0x prefix)
+   */
+  async signPsbt(
+    _psbtHex: ccc.HexLike,
+    _options?: ccc.SignPsbtOptions,
+  ): Promise<string> {
+    throw new Error("UTXO Global PSBT signing not implemented yet");
+  }
+
+  /**
+   * Broadcasts a signed PSBT to the Bitcoin network.
+   *
+   * @param psbtHex - The hex string (without 0x prefix) of signed PSBT to broadcast.
+   * @returns A promise that resolves to the transaction ID (without 0x prefix)
+   * @todo Implement PSBT broadcasting with UTXO Global
+   */
+  async broadcastPsbt(
+    _: ccc.HexLike,
+    __?: ccc.SignPsbtOptions,
+  ): Promise<string> {
+    throw new Error("UTXO Global PSBT broadcasting not implemented yet");
+  }
 }

packages/xverse/package.json

@@ -57,6 +57,7 @@
   },
   "dependencies": {
     "@ckb-ccc/core": "workspace:*",
+    "bitcoinjs-lib": "^7.0.0",
     "valibot": "^1.1.0"
   },
   "packageManager": "pnpm@10.8.1"