Create Network Transaction from Signatures

POST

https://ada.nownodes.io/construction/combine

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Combine creates a network-specific transaction from an unsigned transaction and an array of provided signatures. The signed transaction returned from this method will be sent to the /construction/submit endpoint by the caller.

Body

application/json

Request value.

network_identifierNetworkIdentifierrequired

Rosetta network identifier object.

Show child attributes

blockchainstringrequired

Blockchain value.

networkstringrequired

If a blockchain has a specific chain-id or network identifier, it should go in this field. It is up to the client to determine which network-specific identifier is mainnet, preprod, or preview.

sub_network_identifierSubNetworkIdentifier

Sub Network Identifier value.

Show child attributes

networkstringrequired

Network value.

metadataobject

Additional metadata object.

unsigned_transactionstringrequired

Unsigned Transaction value.

signaturesArray<Signature>required

Signatures value.

Show child attributes

signing_payloadSigningPayloadrequired

Signing Payload value.

Show child attributes

addressstring

[DEPRECATED by account_identifier in v1.4.4] The network-specific address of the account that should sign the payload.

account_identifierAccountIdentifier

Rosetta account identifier object.

Show child attributes

addressstringrequired

The address may be a cryptographic public key (or some encoding of it) or a provided username.

sub_accountSubAccountIdentifier

Sub Account value.

Show child attributes

addressstringrequired

The SubAccount address may be a cryptographic value or some other identifier (ex: bonded) that uniquely specifies a SubAccount.

metadataobject

If the SubAccount address is not sufficient to uniquely specify a SubAccount, any other identifying information can be stored here. It is important to note that two SubAccounts with identical addresses but differing metadata will not be considered equal by clients.

metadataobject

Blockchains that utilize a username model (where the address is not a derivative of a cryptographic public key) should specify the public key(s) owned by the address in metadata.

Show child attributes

chain_codestring

Hex string encoded extension of bip32 private and public keys with an extra 256 bits of entropy that consists of 32 bytes

hex_bytesstringrequired

Hex Bytes value.

signature_typeSignatureTypeecdsaecdsa_recoveryed25519schnorr_1schnorr_poseidon

Signature Type value.

public_keyPublicKeyrequired

Public Key value.

Show child attributes

hex_bytesstringrequired

Hex-encoded public key bytes in the format specified by the CurveType.

curve_typeCurveTypesecp256k1secp256r1edwards25519tweedlerequired

Curve Type value.

signature_typeSignatureTypeecdsaecdsa_recoveryed25519schnorr_1schnorr_poseidonrequired

Signature Type value.

hex_bytesstringrequired

Hex Bytes value.

Response

200OK

HTTP 200 response for constructionCombine.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or backend failed while processing the request.

Create Network Transaction from Signatures

curl -X POST 'https://ada.nownodes.io/construction/combine' \
  -H 'Content-Type: application/json' \
  -d '{
    "network_identifier": {
      "blockchain": "cardano",
      "network": "mainnet",
      "sub_network_identifier": {
        "network": "shard 1",
        "metadata": {
          "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
        }
      }
    },
    "unsigned_transaction": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
    "signatures": [
      {
        "signing_payload": {
          "address": "addr1qx2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3a3cw7eygp6r7g4w0n4q3f4zq0j6x8",
          "account_identifier": {
            "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
            "sub_account": {
              "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
              "metadata": {}
            },
            "metadata": {
              "chain_code": "chain_code_example"
            }
          },
          "hex_bytes": "hex_bytes_example",
          "signature_type": "ecdsa"
        },
        "public_key": {
          "hex_bytes": "hex_bytes_example",
          "curve_type": "secp256k1"
        },
        "signature_type": "ecdsa",
        "hex_bytes": "hex_bytes_example"
      }
    ]
  }'

const response = await fetch('https://ada.nownodes.io/construction/combine', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "network_identifier": {
        "blockchain": "cardano",
        "network": "mainnet",
        "sub_network_identifier": {
          "network": "shard 1",
          "metadata": {
            "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
          }
        }
      },
      "unsigned_transaction": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
      "signatures": [
        {
          "signing_payload": {
            "address": "addr1qx2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3a3cw7eygp6r7g4w0n4q3f4zq0j6x8",
            "account_identifier": {
              "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
              "sub_account": {
                "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
                "metadata": {}
              },
              "metadata": {
                "chain_code": "chain_code_example"
              }
            },
            "hex_bytes": "hex_bytes_example",
            "signature_type": "ecdsa"
          },
          "public_key": {
            "hex_bytes": "hex_bytes_example",
            "curve_type": "secp256k1"
          },
          "signature_type": "ecdsa",
          "hex_bytes": "hex_bytes_example"
        }
      ]
    }),
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://ada.nownodes.io/construction/combine')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "network_identifier": {
      "blockchain": "cardano",
      "network": "mainnet",
      "sub_network_identifier": {
        "network": "shard 1",
        "metadata": {
          "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
        }
      }
    },
    "unsigned_transaction": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
    "signatures": [
      {
        "signing_payload": {
          "address": "addr1qx2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3a3cw7eygp6r7g4w0n4q3f4zq0j6x8",
          "account_identifier": {
            "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
            "sub_account": {
              "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
              "metadata": {}
            },
            "metadata": {
              "chain_code": "chain_code_example"
            }
          },
          "hex_bytes": "hex_bytes_example",
          "signature_type": "ecdsa"
        },
        "public_key": {
          "hex_bytes": "hex_bytes_example",
          "curve_type": "secp256k1"
        },
        "signature_type": "ecdsa",
        "hex_bytes": "hex_bytes_example"
      }
    ]
  }'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

payload = {
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "unsigned_transaction": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
  "signatures": [
    {
      "signing_payload": {
        "address": "addr1qx2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3a3cw7eygp6r7g4w0n4q3f4zq0j6x8",
        "account_identifier": {
          "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
          "sub_account": {
            "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
            "metadata": {}
          },
          "metadata": {
            "chain_code": "chain_code_example"
          }
        },
        "hex_bytes": "hex_bytes_example",
        "signature_type": "ecdsa"
      },
      "public_key": {
        "hex_bytes": "hex_bytes_example",
        "curve_type": "secp256k1"
      },
      "signature_type": "ecdsa",
      "hex_bytes": "hex_bytes_example"
    }
  ]
}

response = requests.post('https://ada.nownodes.io/construction/combine', json=payload)
data = response.json()

const response = await fetch('https://ada.nownodes.io/construction/combine', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "network_identifier": {
        "blockchain": "cardano",
        "network": "mainnet",
        "sub_network_identifier": {
          "network": "shard 1",
          "metadata": {
            "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
          }
        }
      },
      "unsigned_transaction": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
      "signatures": [
        {
          "signing_payload": {
            "address": "addr1qx2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3a3cw7eygp6r7g4w0n4q3f4zq0j6x8",
            "account_identifier": {
              "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
              "sub_account": {
                "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
                "metadata": {}
              },
              "metadata": {
                "chain_code": "chain_code_example"
              }
            },
            "hex_bytes": "hex_bytes_example",
            "signature_type": "ecdsa"
          },
          "public_key": {
            "hex_bytes": "hex_bytes_example",
            "curve_type": "secp256k1"
          },
          "signature_type": "ecdsa",
          "hex_bytes": "hex_bytes_example"
        }
      ]
    }),
});

const data = await response.json();

const endpoint = "https://ada.nownodes.io/construction/combine";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({
    "network_identifier": {
      "blockchain": "cardano",
      "network": "mainnet",
      "sub_network_identifier": {
        "network": "shard 1",
        "metadata": {
          "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
        }
      }
    },
    "unsigned_transaction": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
    "signatures": [
      {
        "signing_payload": {
          "address": "addr1qx2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3a3cw7eygp6r7g4w0n4q3f4zq0j6x8",
          "account_identifier": {
            "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
            "sub_account": {
              "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
              "metadata": {}
            },
            "metadata": {
              "chain_code": "chain_code_example"
            }
          },
          "hex_bytes": "hex_bytes_example",
          "signature_type": "ecdsa"
        },
        "public_key": {
          "hex_bytes": "hex_bytes_example",
          "curve_type": "secp256k1"
        },
        "signature_type": "ecdsa",
        "hex_bytes": "hex_bytes_example"
      }
    ]
  });
console.log(result);

const response = await fetch('https://ada.nownodes.io/construction/combine', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "network_identifier": {
        "blockchain": "cardano",
        "network": "mainnet",
        "sub_network_identifier": {
          "network": "shard 1",
          "metadata": {
            "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
          }
        }
      },
      "unsigned_transaction": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
      "signatures": [
        {
          "signing_payload": {
            "address": "addr1qx2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3a3cw7eygp6r7g4w0n4q3f4zq0j6x8",
            "account_identifier": {
              "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
              "sub_account": {
                "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
                "metadata": {}
              },
              "metadata": {
                "chain_code": "chain_code_example"
              }
            },
            "hex_bytes": "hex_bytes_example",
            "signature_type": "ecdsa"
          },
          "public_key": {
            "hex_bytes": "hex_bytes_example",
            "curve_type": "secp256k1"
          },
          "signature_type": "ecdsa",
          "hex_bytes": "hex_bytes_example"
        }
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "unsigned_transaction": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
  "signatures": [
    {
      "signing_payload": {
        "address": "addr1qx2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3a3cw7eygp6r7g4w0n4q3f4zq0j6x8",
        "account_identifier": {
          "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
          "sub_account": {
            "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
            "metadata": {}
          },
          "metadata": {
            "chain_code": "chain_code_example"
          }
        },
        "hex_bytes": "hex_bytes_example",
        "signature_type": "ecdsa"
      },
      "public_key": {
        "hex_bytes": "hex_bytes_example",
        "curve_type": "secp256k1"
      },
      "signature_type": "ecdsa",
      "hex_bytes": "hex_bytes_example"
    }
  ]
}

response = requests.post('https://ada.nownodes.io/construction/combine', json=payload)
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://ada.nownodes.io/construction/combine')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "network_identifier": {
      "blockchain": "cardano",
      "network": "mainnet",
      "sub_network_identifier": {
        "network": "shard 1",
        "metadata": {
          "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
        }
      }
    },
    "unsigned_transaction": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
    "signatures": [
      {
        "signing_payload": {
          "address": "addr1qx2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3a3cw7eygp6r7g4w0n4q3f4zq0j6x8",
          "account_identifier": {
            "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
            "sub_account": {
              "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
              "metadata": {}
            },
            "metadata": {
              "chain_code": "chain_code_example"
            }
          },
          "hex_bytes": "hex_bytes_example",
          "signature_type": "ecdsa"
        },
        "public_key": {
          "hex_bytes": "hex_bytes_example",
          "curve_type": "secp256k1"
        },
        "signature_type": "ecdsa",
        "hex_bytes": "hex_bytes_example"
      }
    ]
  }'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

Request Body

{
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "unsigned_transaction": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
  "signatures": [
    {
      "signing_payload": {
        "address": "addr1qx2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3a3cw7eygp6r7g4w0n4q3f4zq0j6x8",
        "account_identifier": {
          "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
          "sub_account": {
            "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
            "metadata": {}
          },
          "metadata": {
            "chain_code": "chain_code_example"
          }
        },
        "hex_bytes": "hex_bytes_example",
        "signature_type": "ecdsa"
      },
      "public_key": {
        "hex_bytes": "hex_bytes_example",
        "curve_type": "secp256k1"
      },
      "signature_type": "ecdsa",
      "hex_bytes": "hex_bytes_example"
    }
  ]
}

{
  "metadata": {
    "network": "mainnet"
  },
  "unsigned_transaction": "84a4008182582004cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
  "payloads": []
}

{
  "code": 4000,
  "message": "Invalid request",
  "retriable": false
}

{
  "status_code": 400,
  "message": "Bad Request",
  "error": "bad_request"
}

Unknown API_key

Missing API_key

{
  "status_code": 500,
  "message": "Internal Server Error",
  "error": "internal_server_error"
}