Class BitcoinSigner

constructor

• new BitcoinSigner(
      client: Client,
      name: string,
      icon: string,
      preferredNetworks?: NetworkPreference[],
      addressType?: "auto" | "p2wpkh" | "p2tr",
      _appUri?: string,
      connectionsRepo?: ConnectionsRepo,
  ): JoyId.BitcoinSigner

  Creates an instance of BitcoinSigner.

  Parameters

  • client: Client

    The client instance.
  • name: string

    The name of the signer.
  • icon: string

    The icon URL of the signer.
  • preferredNetworks: NetworkPreference[] = ...
  • addressType: "auto" | "p2wpkh" | "p2tr" = "auto"

    The address type.
  • Optional_appUri: string

    The application URI.
  • connectionsRepo: ConnectionsRepo = ...

    The connections repository.

  Returns JoyId.BitcoinSigner

Readonlyname

Readonlyicon

ReadonlyaddressType

supportsSingleCallSignAndBroadcast

• get supportsSingleCallSignAndBroadcast(): boolean

  Whether the wallet supports a single call to sign + broadcast (combined flow). Default false; override in implementations like Xverse/JoyID.

  Returns boolean

disconnect

• disconnect(): Promise<void>

  Disconnects to the signer.

  Returns Promise<void>

  A promise that resolves when the signer is disconnected.

getBtcAccount

• getBtcAccount(): Promise<string>

  Gets the Bitcoin account address.

  Returns Promise<string>

  A promise that resolves to the Bitcoin account address.

getBtcPublicKey

• getBtcPublicKey(): Promise<`0x${string}`>

  Gets the Bitcoin public key.

  Returns Promise<`0x${string}`>

  A promise that resolves to the Bitcoin public key.

connect

• connect(): Promise<void>

  Connects to the provider by requesting authentication.

  Returns Promise<void>

  A promise that resolves when the connection is established.

isConnected

• isConnected(): Promise<boolean>

  Checks if the signer is connected.

  Returns Promise<boolean>

  A promise that resolves to true if connected, false otherwise.

signMessageRaw

• signMessageRaw(message: BytesLike): Promise<string>

  Signs a raw message with the Bitcoin account.

  Parameters

  • message: BytesLike

    The message to sign.

  Returns Promise<string>

  A promise that resolves to the signed message.

signPsbt

• signPsbt(psbtHex: string, options?: SignPsbtOptions): Promise<string>

  Signs a PSBT using JoyID wallet.

  Parameters

  • psbtHex: string

    The hex string of PSBT to sign
  • Optionaloptions: SignPsbtOptions

  Returns Promise<string>

  A promise that resolves to the signed PSBT hex string

pushPsbt

• pushPsbt(psbtHex: string, _options?: SignPsbtOptions): Promise<string>

  Signs and broadcasts a PSBT to the Bitcoin network using JoyID wallet.

  This method combines both signing and broadcasting in a single operation.

  Parameters

  • psbtHex: string

    The hex string of PSBT to sign and broadcast
  • Optional_options: SignPsbtOptions

  Returns Promise<string>

  A promise that resolves to the transaction ID

  Remarks

  Use this method directly for sign+broadcast operations to avoid double popups. While calling signPsbt() then pushPsbt() will still work, it triggers two popups and requires double signing.