Ctrl+K

Create a signature share for a message on a transaction request

post/api/v2/wallet/{walletId}/txrequests/{txRequestId}/messages/{messageIdx}/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}$
  • txRequestIdstring<uuid>Required
    Example: 123e4567-e89b-12d3-a456-426614174000
  • messageIdxstring<number>Required

Request Body

signatureShare object
A user-provided share to be used in the ECDSA or EDDSA MPC signing flow. Please use signatureShares instead.
vssProof string
The VSS proof of the signature share
privateShareProof string
The private share proof
publicShare string
The public share
from string required
The source of the signature share.
Allowed values: user backup bitgo
to string required
The recipient of the signature share.
Allowed values: user backup bitgo
share string required
The signature share
signatureShares array[object]
User-provided shares to be used in the ECDSA or EDDSA MPC signing flow.
privateShareProof string
The private share proof
publicShare string
The public share
vssProof string
The VSS proof of the signature share
from string required
The source of the signature share.
Allowed values: user backup bitgo
to string required
The recipient of the signature share.
Allowed values: user backup bitgo
share string required
The signature share
userPublicGpgKey string
User’s public key of the gpg key.
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.

200 Response

Array of
vssProof string
The VSS proof of the signature share
privateShareProof string
The private share proof
publicShare string
The public share
from string required
The source of the signature share.
Allowed values: user backup bitgo
to string required
The recipient of the signature share.
Allowed values: user backup bitgo
share string required
The signature share

400 Response

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

401 Response

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

403 Response

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

404 Response

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