本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 關鍵概念：Amazon Managed Blockchain (AMB) 查詢
<a name="key-concepts"></a>

**注意**  
本指南假設您熟悉基本的區塊鏈概念。這些概念包括分散、權杖、合約、交易、proof-of-work、錢包、公有和私有金鑰、任務、採礦、分片等。

Amazon Managed Blockchain (AMB) Query 可讓您方便存取多區塊鏈網路資料，讓您更輕鬆地擷取與區塊鏈活動相關的內容資料。您可以使用 AMB Query 從公有區塊鏈網路讀取資料，例如 Bitcoin Mainnet 和 Ethereum Mainnet。您也可以取得資訊，例如地址的目前和歷史餘額，也可以取得指定期間內的區塊鏈交易清單。此外，您可以取得指定交易的詳細資訊，例如交易事件，您可以進一步分析或用於應用程式的商業邏輯。

## 使用 Amazon Managed Blockchain (AMB) 查詢的考量和限制
<a name="ambq-considerations"></a>

當您使用 AMB 查詢時，請考慮下列事項：
+ **可用區域**

  *美國東部 （維吉尼亞北部） *`us-east-1`區域支援 AMB 查詢。

  
+ **服務端點**

  您可以使用下列端點存取 AMB 查詢：

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

  
+ **支援的區塊鏈網路**

  AMB Query 支援下列公有區塊鏈網路：
  + **Bitcoin Mainnet** — 公有 Bitcoin 區塊鏈網路，受到proof-of-work共識保護，並在其中發行和交易 Bitcoin (BTC) 加密貨幣。Mainnet 上的交易具有實際值 （即會產生實際成本），並記錄在公有區塊鏈上。
  + **Bitcoin Testnet** — Bitcoin Mainnet 的 testnet。此網路上的比特幣 (BTC) 與 Mainnet BTC 不同，通常沒有任何值。
  + **Ethereum Mainnet** — 公有 Ethereum 區塊鏈的proof-of-stake主網路。Mainnet 上的交易具有實際值 （即會產生實際成本），並記錄在分散式總帳上。
  + **Sepolia Testnet** — Ethereum Mainnet 的測試網路。此網路上的 Ether (ETH) 與 Mainnet ETH 不同，且通常沒有任何值。

    
+ **支援的區塊鏈字符和合約**

  AMB Query 支援下列原生和標準 Ethereum 合約字符。
  + **公有區塊鏈原生字符**
    + **比特幣 (BTC)** — 這是比特幣相關區塊鏈的原生字符。
    + **Ether (ETH)** — 這是 Ethereum 相關區塊鏈的原生字符。

      
  + **Ethereum 合約標準**
    + **ERC-20 權杖標準** — ERC-20 是易讀權杖的標準。它有一個 屬性，可讓每個 ERC-20 字符與另一個 ERC-20 字符完全相同 （類型和值），這表示一個字符是且永遠等於所有其他字符。如需詳細資訊，請參閱 https：//Ethereum.org 上的 [ERC-20 Token Standard](https://eips.ethereum.org/EIPS/eip-20)。
    + **ERC-721 不可分割權杖標準** — ERC-721 是不可分割權杖 (NFTs) 的標準。這種類型的字符是唯一的，可以具有與相同合約中另一個字符不同的值，可能是因為其存留期、罕見性或其他屬性。如需詳細資訊，請參閱 https：//Ethereum.org 上的 [ERC-721 Token Standard](https://eips.ethereum.org/EIPS/eip-721)。

      **ERC-1155 Multi-token Standard** — 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 標準的功能，使其更有效率，同時更正明顯的實作錯誤。如需詳細資訊，請參閱 https：//Ethereum.org 上的 [ERC-1155 Token Standard](https://eips.ethereum.org/EIPS/eip-1155)。
+ **最終性**

  在區塊鏈中，*最終性*表示不太可能反轉有效交易。針對 Bitcoin Mainnet，AMB Query 會將交易視為 6 個區塊之後的最終交易。對於比特幣 Testnet，它會在 6 個區塊或 60 分鐘後將交易視為最終交易，以先到者為準。對於支援的 Ethereum 網路，AMB Query 會將交易視為 64 個區塊之後的最終交易。

  AMB Query 的權杖平衡和合約 API 操作只會傳回已達到最終結果的資料。不過，AMB Query 的交易和交易事件 API 操作可以傳回在區塊鏈網路上確認的交易資料，即使它們尚未達到最終。

  
+ **不支援 NULL 地址**

  AMB 查詢不支援 `NULL`(`0x0000000000000000000000000000000000000000`) 地址。

  
+ **簽章第 4 版簽署 API 呼叫**

  呼叫 AMB 查詢 APIs 時，您可以透過使用 [Signature 第 4 版簽署程序](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html)驗證的 HTTPS 連線來執行此操作。這表示只有帳戶中的授權 IAM AWS 主體才能進行 AMB Query API 呼叫。若要這樣做，必須使用 呼叫提供 AWS 憑證 （存取金鑰 ID 和私密存取金鑰）。
**重要**  
請勿在面向使用者的應用程式中嵌入用戶端登入資料。

  
+ **AMB 查詢支援比特幣交易識別符和交易雜湊**

  對於比特幣網路，AMB Query API 操作支援交易識別符 (`transactionId`) 和交易雜湊 ()`transactionHash`。`transactionId` 是交易的雙 SHA 雜湊，不包含見證資料。`transactionHash` 是交易的雙 SHA 雜湊，包括見證資料 （也稱為見證交易 ID)。

  叫用 Bitcoin 網路的 [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`。此外，在 Bitcoin 網路上傳回 `transactionId`或 的所有 AMB 查詢操作`transactionHash`，都會包含這兩個值做為回應的一部分。