View a markdown version of this page

關鍵概念：Amazon Managed Blockchain (AMB) 查詢 - Amazon Managed Blockchain Query
使用 Amazon Managed Blockchain (AMB) 查詢的考量和限制

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

關鍵概念：Amazon Managed Blockchain (AMB) 查詢

注意

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

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

使用 Amazon Managed Blockchain (AMB) 查詢的考量和限制

當您使用 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。

      • ERC-721 不可分割權杖標準 — ERC-721 是不可分割權杖 (NFTs) 的標準。這種類型的字符是唯一的，可以具有與相同合約中另一個字符不同的值，可能是因為其存留期、罕見性或其他屬性。如需詳細資訊，請參閱 https：//Ethereum.org 上的 ERC-721 Token Standard。

        ERC-1155 Multi-token Standard — ERC-1155 是建立合約界面的標準，可代表和控制任意數量的易記和非易記字符類型。透過這種方式，ERC-1155 權杖可以與 ERC-20 和 ERC-721 權杖運作相同，甚至可以同時與兩者運作。ERC-1155 權杖可改善 ERC-20 和 ERC-721 標準的功能，使其更有效率，同時更正明顯的實作錯誤。如需詳細資訊，請參閱 https：//Ethereum.org 上的 ERC-1155 Token Standard。

  • 最終性

    在區塊鏈中，最終性表示不太可能反轉有效交易。針對 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 連線來執行此操作。這表示只有帳戶中的授權 IAM AWS 主體才能進行 AMB Query API 呼叫。若要這樣做，必須使用 呼叫提供 AWS 憑證 （存取金鑰 ID 和私密存取金鑰）。

    重要

    請勿在面向使用者的應用程式中嵌入用戶端登入資料。

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

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

    叫用 Bitcoin 網路的 GetTransaction或 ListTransactionEvents API 操作時，您可以指定 transactionId或 transactionHash。此外，在 Bitcoin 網路上傳回 transactionId或 的所有 AMB 查詢操作transactionHash，都會包含這兩個值做為回應的一部分。