Ctrl+K

Create a signature share for a transaction on a transaction request

post/api/v2/wallet/{walletId}/txrequests/{id}/transactions/{transactionIdx}/signatureshares

Allows users to supply their signature share for signing.

This route is only valid for transaction request full. Use only with MPC wallets.

Path Parameters

  • walletIdstringRequired
    Example: 59cd72485007a239fb00282ed480da1f
    Pattern: ^[0-9a-f]{32}$
  • idstringRequired
    Example: 59cd72485007a239fb00282ed480da1f
    Pattern: ^[0-9a-f]{32}$
  • transactionIdxstringRequired

Request Body

signatureShare object
A user-provided share to be used in the ECDSA or EDDSA MPC signing flow. Please use signatureShares instead
from string required
The source of the signature share.
Allowed values: user backup bitgo
Example: user
to string required
The recipient of the signature share.
Allowed values: user backup bitgo
Example: user
share string required
The signature share.
signatureShares array[object]
User-provided shares to be used in the ECDSA or EDDSA MPC signing flow.
from string required
The source of the signature share.
Allowed values: user backup bitgo
Example: user
to string required
The recipient of the signature share.
Allowed values: user backup bitgo
Example: user
share string required
The signature share.
signerShare string
An openPGP ascii armored message (encrypted to the known HSM public key) containing the previous signer’s offset secret share as a 128 character hex string (64 bytes) consisting of the new offset “u” private component from the user [or backup] new offset Y-share as a 64 character hex string (32 bytes) concatenated with the new offset “chaincode” component of the new offset Y-share as a 64 character hex string (32 bytes). Must be provided when uploading an R share.
userPublicGpgKey string
User’s public key of the gpg key.

201 Response

from string required
The source of the signature share.
Allowed values: user backup bitgo
Example: user
to string required
The recipient of the signature share.
Allowed values: user backup bitgo
Example: user
share string required
The signature share.

400 Response

error string required
Human-readable error message
requestId string required
Client request id
context object
Properties that apply to a specific error name
name string required
Error code

401 Response

error string required
Human-readable error message
requestId string required
Client request id
context object
Properties that apply to a specific error name
name string required
Error code

403 Response

error string required
Human-readable error message
requestId string required
Client request id
context object
Properties that apply to a specific error name
name string required
Error code

404 Response

error string required
Human-readable error message
requestId string required
Client request id
context object
Properties that apply to a specific error name
name string required
Error code