本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 关键概念：亚马逊托管区块链 (AMB) 查询
<a name="key-concepts"></a>

**注意**  
本指南假设您熟悉基本的区块链概念。这些概念包括去中心化、代币、合约、交易 proof-of-work、、钱包、公钥和私钥、质押、采矿、减半等。

Amazon Managed Blockchain (AMB) 查询使您可以方便地访问多区块链网络数据，这使您可以更轻松地提取与区块链活动相关的上下文数据。您可以使用 AMB Query 从公共区块链网络（例如比特币主网和以太坊主网）读取数据。您还可以获取信息，例如地址的当前和历史余额，或者您可以获取给定时间段内的区块链交易列表。此外，您还可以获取给定事务的详细信息，例如交易事件，您可以进一步分析这些细节，或者将其用于应用程序的业务逻辑中。

## 使用亚马逊托管区块链 (AMB) 查询的注意事项和限制
<a name="ambq-considerations"></a>

使用 AMB 查询时，请考虑以下几点：
+ **可用区域**

  *美国东部（弗吉尼亚北部）*`us-east-1`区域支持 AMB 查询。

  
+ **服务终端节点**

  可以使用以下端点访问 AMB 查询：

  `https://managedblockchain-query.us-east-1.amazonaws.com`.

  
+ **支持的区块链网络**

  AMB Query 支持以下公共区块链网络：
  + **比特币主网** — 通过 proof-of-work共识保护的公共比特币区块链网络，比特币（BTC）加密货币是在该网络上发行和交易的。主网上的交易具有实际价值（也就是说，它们会产生实际成本），并记录在公共区块链上。
  + **比特币测试网** — 比特币主网的测试网。该网络上的比特币（BTC）与主网比特币是分开的，并且通常没有任何价值。
  + **以太坊主网** — 公共以太坊区块链 proof-of-stake的主网络。主网上的交易具有实际价值（也就是说，它们会产生实际成本），并记录在分布式账本上。
  + **Sepolia 测试网** — 以太坊主网的测试网。该网络上的以太币（ETH）与主网 ETH 是分开的，并且通常没有任何价值。

    
+ **支持的区块链代币和合约**

  AMB Query 支持以下原生和标准以太坊合约代币。
  + **公共区块链原生代币**
    + **比特币（BTC）**— 这是比特币相关区块链的原生代币。
    + **以太币（ETH）**— 这是以太坊相关区块链的原生代币。

      
  + **以太坊合约标准**
    + **ERC-20 代币标准** — ERC-20 是可替代代币的标准。它有一个属性，可以使每个 ERC-20 代币与铸造的另一个 ERC-20 代币完全相同（在类型和值上），这意味着一个代币现在和将来都等于所有其他代币。欲了解更多信息，请参阅 Ethereum.org 上[的 ERC-20 代币标准](https://eips.ethereum.org/EIPS/eip-20)。
    + **ERC-721 不可替代代币标准** — ERC-721 是不可替代代币的标准 ()。NFTs这种类型的代币是独一无二的，其价值可能与同一合约中的另一种代币不同，这可能是由于其年龄、稀有度或其他属性所致。欲了解更多信息，请参阅 Ethereum.org 上[的 ERC-721 代币标准](https://eips.ethereum.org/EIPS/eip-721)。

      **ERC-1155 多代币标准** — ERC-1155 是一个创建合约接口的标准，该接口可以表示和控制任意数量的可替代和不可替代的代币类型。通过这种方式，ERC-1155 代币的功能可以与 [ERC-20 和](https://eips.ethereum.org/EIPS/eip-20) [ERC-721](https://eips.ethereum.org/EIPS/eip-721) 代币相同，甚至可以同时发挥两者的作用。ERC-1155 代币改进了 ERC-20 和 ERC-721 标准的功能，使其更加高效，同时纠正了明显的实现错误。欲了解更多信息，请参阅 Ethereum.org 上[的 ERC-1155 代币标准](https://eips.ethereum.org/EIPS/eip-1155)。
+ **终局性**

  在区块链中，*最终性*意味着有效的交易不太可能被撤销。对于比特币主网，AMB Query认为交易在6个区块后最终完成。对于比特币测试网，它认为交易在6个区块或60分钟后完成，以先到者为准。对于支持的以太坊网络，AMB Query 认为交易在 64 个区块后最终完成。

  AMB Query 的代币余额和合约 API 操作仅返回已完成的数据。但是，AMB Query 的交易和交易事件 API 操作可以返回区块链网络上已确认的交易的数据，即使这些交易尚未最终确定。

  
+ **不支持空地址**

  AMB 查询不支持 `NULL` (`0x0000000000000000000000000000000000000000`) 地址。

  
+ **签名版本 4 对 API 调用进行签名**

  调用 AMB 查询时 APIs，您可以通过使用[签名版本 4 签名流程](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html)进行身份验证的 HTTPS 连接进行调用。这意味着只有 AWS 账户中获得授权的 IAM 委托人才能调用 AMB 查询 API。为此，必须在呼叫中提供 AWS 证书（访问密钥 ID 和私有访问密钥）。
**重要**  
不要在面向用户的应用程序中嵌入客户端凭据。

  
+ **AMB Query 支持比特币交易标识符和交易哈希**

  对于比特币网络，AMB Query API 操作同时支持交易标识符 (`transactionId`) 和交易哈希 (`transactionHash`)。`transactionId`是交易的双 SHA 哈希值，不包括见证人数据。`transactionHash`是交易的双 SHA 哈希值，包括见证人数据（也称为见证人交易 ID）。

  在为比特币网络调用[https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_GetTransaction.html](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_GetTransaction.html)或 [https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_ListTransactions.html](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_ListTransactions.html)API 操作时，您可以指定`transactionId`或。`transactionHash`此外，比特币网络上所有返回 a `transactionId` 或 a 的 AMB Query 操作都`transactionHash`将同时包含这两个值作为响应的一部分。