本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
通过亚马逊托管区块链 (AMB) 支持比特币 JSON-RPC 访问比特币
本主题提供了托管区块链支持的比特币 JSON-RPC 列表和参考资料。每个支持的 JSON-RPC 都有其用法的简要描述。
注意
您可以使用签名版本 4 (Sigv4) 签名流程对托管区块链上的比特币 JSON-RPC 进行身份验证。这意味着只有账户中获得授权的 IAM 委托人才能使用比特币 JSON-RPC 与 AWS 账户进行交互。在呼叫中提供 AWS 凭证(访问密钥 ID 和私有访问密钥)。
如果您的 HTTP 响应大于 10 MB,则会出现错误。要更正此问题,必须将压缩标头设置为
Accept-Encoding:gzip
。您的客户端随后收到的压缩响应包含以下标头:Content-Type: application/json
和Content-Encoding: gzip
。Amazon Managed Blockchain (AMB) Access Bitcoin 会为格式错误的 JSON-RPC 请求生成一个 400 错误。
-
使用
sendrawtransaction
JSON-RPC 提交更新比特币区块链状态的交易。 -
AMB Access Bitcoin 的默认请求限制为每个地区每秒 100 个请求 (RPS)。
NETWORK_TYPE
AWS要增加配额,您必须联系AWS 支持人员。要联系 AWS 支持人员,请登录 Support AWS Center 控制台
。选择创建案例。选择 “技术”。选择托管区块链作为您的服务。选择 Access: Bitcoin 作为您的类别,选择一般指导作为您的严重性。在主题和描述文本框中输入 RPC 配额,并按每个区域每个比特币网络的 RPS 列出适用于您需求的配额限制。提交您的案例。
支持的 JSON-RPC
AMB Access 比特币支持以下比特币 JSON-RPC。每个支持的呼叫都有其用法的简要说明。
类别 | JSON-RPC | 描述 |
---|---|---|
区块链 RPC |
获取最佳区块哈希 |
返回工作量最大、经过全面验证的链中最佳(提示)区块的哈希值。 |
获取区块 |
如果 verbosity 为 0,则返回一个字符串,该字符串是块 “哈希” 的序列化十六进制编码数据。如果 verbosity 为 1,则返回一个包含有关方块 “哈希” 信息的对象。如果 verbosity 为 2,则返回一个 Object,其中包含有关区块 “哈希” 的信息以及有关每笔交易的信息。如果 verbosity 为 3,则返回一个 Object,其中包含有关区块 “哈希” 的信息以及有关每笔交易的信息,包括prevout 输入信息。 |
|
获取区块链信息 |
返回一个包含有关区块链处理的各种状态信息的对象。 | |
获取区块数 |
返回工作量最大、经过全面验证的链的高度。创世区块的高度为 0。 | |
获取区块过滤器 |
使用区块哈希检索特定区块的 BIP 157 内容过滤器。 | |
获取区块哈希 |
返回在提供的高度 best-block-chain 处的区块哈希值。 | |
获取区块标头 |
如果 verbose 为 false,则返回一个字符串,该字符串是区块标头 “哈希” 的序列化十六进制编码数据。如果 verbose 为真,则返回一个包含有关区块标头 “哈希” 信息的对象。 | |
获取区块统计信息 |
计算给定窗口的每个区块的统计信息。所有金额均以中本聪为单位。在某些高度修剪时它不起作用。 | |
获取链条小贴士 |
返回有关区块树中所有已知提示的信息,包括主链和孤立分支。 | |
getchaintxstats |
计算有关链中交易总数和交易率的统计数据。 | |
获得难度 |
以最低 proof-of-work 难度的倍数返回难度。 | |
getmempool 祖先 |
如果 txid 在内存池中,则返回内存池中的所有祖先。 | |
获取 mempool 后代 |
如果 txid 在内存池中,则返回内存池中的所有后代。 | |
获取内存池条目 |
返回给定交易的内存池数据。 | |
获取内存池信息 |
返回有关 TX 内存池活动状态的详细信息。 | |
getrawmempool |
以字符串交易 ID 的 JSON 数组形式返回内存池中的所有事务 ID。注意不支持 |
|
gettxout |
返回有关未使用的交易输出的详细信息。 | |
gettxoutproof |
返回一个十六进制编码的证据,证明区块中包含 “txid”。 | |
原始交易 RPC |
创建原始交易 |
创建使用给定输入并创建新输出的交易。 |
解码原始交易 |
返回一个表示序列化的十六进制编码交易的 JSON 对象。 | |
decodescri |
解码十六进制编码的脚本。 | |
getraw 交易 |
返回原始交易数据。 | |
发送交易 |
向本地节点和网络提交原始交易(序列化、十六进制编码)。 | |
测试内存池接受 |
返回内存池验收测试的结果,该结果表明 mempool 是否接受原始交易(序列化、十六进制编码)。这将检查交易是否违反共识规则或政策规则。 | |
Util RPC |
创建多重签名 |
创建一个多重签名地址,其中包含 n 个必需的 m 个密钥的签名。 |
估算智能费用 |
如果可能,估算在 conf_target 区块内开始确认交易所需的每千字节的大致费用,并返回该估算值有效的区块数。使用 BIP 141 中定义的虚拟交易规模(见证数据已打折)。 | |
验证地址 |
返回有关给定比特币地址的信息。 | |
验证消息 |
验证已签名的消息。 |