Supported Bitcoin JSON-RPCs with Amazon Managed Blockchain (AMB) Access Bitcoin - AMB Access Bitcoin
Supported JSON-RPCs

Supported Bitcoin JSON-RPCs with Amazon Managed Blockchain (AMB) Access Bitcoin

This topic provides a list of and references to the Bitcoin JSON-RPCs that Managed Blockchain supports. Each supported JSON-RPC has a brief description of its use.

Note

  • You can authenticate Bitcoin JSON-RPCs on Managed Blockchain by using the Signature Version 4 (SigV4) signing process. This means that only authorized IAM principals in the AWS account can interact with it by using the Bitcoin JSON-RPCs. Provide AWS credentials (an access key ID and secret access key) with the call.

  • If your HTTP response is larger than 10 MB, you will get an error. To correct this, you must set the compression headers to Accept-Encoding:gzip. The compressed response your client then receives contains the following headers: Content-Type: application/json and Content-Encoding: gzip.

  • Amazon Managed Blockchain (AMB) Access Bitcoin generates a 400 error for malformed JSON-RPC requests.

  • Use the sendrawtransaction JSON-RPC to submit transactions that update the Bitcoin blockchain state.

  • AMB Access Bitcoin has a default request limit of 100 requests per second (RPS), per NETWORK_TYPE, per AWS Region.

    For increasing your quota, you must contact AWS support. To contact AWS support, sign into the AWS Support Center Console. Choose Create case. Choose Technical. Choose Managed Blockchain as your service. Choose Access:Bitcoin as your Category and General guidance as your Severity. Enter RPC Quota as the Subject and in the Description text box and list the quota limits applicable to your needs in RPS per Bitcoin network per Region. Submit your case.

Supported JSON-RPCs

AMB Access Bitcoin supports the following Bitcoin JSON-RPCs. Each supported call has a brief description of its use.

Category JSON-RPC Description
Blockchain RPCs getbestblockhash Returns the hash of the best (tip) block in the most-work, fully validated chain.
getblock If verbosity is 0, returns a string that is serialized, hex-encoded data for block ‘hash’. If verbosity is 1, returns an Object with information about the block ‘hash’. If verbosity is 2, returns an Object with information about the block ‘hash’ and information about each transaction. If verbosity is 3, returns an Object with information about the block ‘hash’ and information about each transaction, including the prevout information for inputs.
getblockchaininfo Returns an object containing various state info regarding blockchain processing.
getblockcount Returns the height of the most-work, fully validated chain. The genesis block has height 0.
getblockfilter Retrieves a BIP 157 content filter for a particular block using the block hash.
getblockhash Returns hash of block in best-block-chain at height provided.
getblockheader If verbose is false, returns a string that is serialized, hex-encoded data for blockheader ‘hash’. If verbose is true, returns an Object with information about blockheader ‘hash’.
getblockstats Computes per block statistics for a given window. All amounts are in satoshis. It won’t work for some heights with pruning.
getchaintips Returns information about all known tips in the block tree, including the main chain and orphaned branches.
getchaintxstats Computes statistics about the total number and rate of transactions in the chain.
getdifficulty Returns the proof-of-work difficulty as a multiple of the minimum difficulty.
getmempoolancestors If txid is in the mempool, returns all in-mempool ancestors.
getmempooldescendants If txid is in the mempool, returns all in-mempool descendants.
getmempoolentry Returns mempool data for given transaction.
getmempoolinfo Returns details on the active state of the TX memory pool.
getrawmempool Returns all transaction IDs in memory pool as a JSON array of string transaction IDs.
Note

verbose = true is not supported.
gettxout Returns details about an unspent transaction output.
gettxoutproof Returns a hex-encoded proof that “txid” was included in a block.
Rawtransactions RPCs createrawtransaction Creates a transaction spending the given inputs and creating new outputs.
decoderawtransaction Returns a JSON object representing the serialized, hex-encoded transaction.
decodescript Decodes a hex-encoded script.
getrawtransaction Returns the raw transaction data.
sendrawtransaction Submits a raw transaction (serialized, hex-encoded) to local node and network.
testmempoolaccept Returns result of mempool acceptance tests indicating if raw transaction (serialized, hex-encoded) would be accepted by mempool. This checks if the transaction violates the consensus or policy rules.
Util RPCs createmultisig Creates a multi-signature address with n signature of m keys required.
estimatesmartfee Estimates the approximate fee per kilobyte required for a transaction to begin confirmation within conf_target blocks, if possible, and returns the number of blocks for which the estimate is valid. Uses virtual transaction size, as defined in BIP 141 (witness data is discounted).
validateaddress Returns information about the given bitcoin address.
verifymessage Verifies a signed message.