POST

Create a signature share for a transaction on a transaction request

Allows users to supply their signature share for signing.

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

Path Params

walletId string required

The wallet ID.

matches ^[0-9a-f]{32}$
id string required

matches ^[0-9a-f]{32}$
transactionIdx string required

Body Params

object

signatureShare object

A user-provided share to be used in the ECDSA or EDDSA MPC signing flow. Please use signatureShares instead
signatureShare object
- from string enum required
  
  The source of the signature share.
  
  userbackupbitgo
- to string enum required
  
  The recipient of the signature share.
  
  userbackupbitgo
- share string required
  
  The signature share.
signatureShares array of objects

User-provided shares to be used in the ECDSA or EDDSA MPC signing flow.
signatureShares object
- from string enum required
  
  The source of the signature share.
  
  userbackupbitgo
- to string enum required
  
  The recipient of the signature share.
  
  userbackupbitgo
- 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.

Responses

201

Created

Response Body

object

from string enum required

The source of the signature share.

userbackupbitgo
to string enum required

The recipient of the signature share.

userbackupbitgo
share string required

The signature share.

400

Bad Request

Response Body

object

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

Unauthorized

Response Body

object

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

Forbidden

Response Body

object

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

Not Found

Response Body

object

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

curl --request POST \ --url 'https://app.bitgo-test.com/api/v2/wallet/walletId/txrequests/id/transactions/transactionIdx/signatureshares' \ --header 'accept: application/json' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --header 'content-type: application/json' \ --data '{,"signatureShare":{,"from":"user","to":"user","share":"string"},"signatureShares":[{,"from":"user","to":"user","share":"string"}],"signerShare":"string","userPublicGpgKey":"string"}'

require 'uri' require 'net/http' url = URI("https://app.bitgo-test.com/api/v2/wallet/walletId/txrequests/id/transactions/transactionIdx/signatureshares") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["accept"] = 'application/json' request["Authorization"] = 'Bearer YOUR_ACCESS_TOKEN' request["content-type"] = 'application/json' request.body = '{,"signatureShare":{,"from":"user","to":"user","share":"string"},"signatureShares":[{,"from":"user","to":"user","share":"string"}],"signerShare":"string","userPublicGpgKey":"string"}' response = http.request(request) puts response.read_body

<?php require_once('vendor/autoload.php'); $client = new \GuzzleHttp\Client(); $response = $client->request('POST', 'https://app.bitgo-test.com/api/v2/wallet/walletId/txrequests/id/transactions/transactionIdx/signatureshares', [ 'headers' => [ 'accept' => 'application/json', 'Authorization' => 'Bearer YOUR_ACCESS_TOKEN', 'content-type' => 'application/json', ], 'body' => '{,"signatureShare":{,"from":"user","to":"user","share":"string"},"signatureShares":[{,"from":"user","to":"user","share":"string"}],"signerShare":"string","userPublicGpgKey":"string"}', ]); echo $response->getBody();

import requests url = "https://app.bitgo-test.com/api/v2/wallet/walletId/txrequests/id/transactions/transactionIdx/signatureshares" payload = {,"signatureShare":{,"from":"user","to":"user","share":"string"},"signatureShares":[{,"from":"user","to":"user","share":"string"}],"signerShare":"string","userPublicGpgKey":"string"} headers = { "accept": "application/json", "Authorization": "Bearer YOUR_ACCESS_TOKEN", "content-type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.text)