翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 主な概念: Amazon Managed Blockchain (AMB) クエリ
<a name="key-concepts"></a>

**注記**  
このガイドでは、ブロックチェーンの基本的な概念に精通していることを前提としています。これらの概念には、分散、トークン、契約、トランザクション、proof-of-work、ウォレット、パブリックキーとプライベートキー、ステーク、マイニング、半分などが含まれます。

Amazon Managed Blockchain (AMB) クエリでは、マルチブロックチェーンネットワークデータに簡単にアクセスできるため、ブロックチェーンアクティビティに関連するコンテキストデータを抽出しやすくなります。AMB クエリを使用して、Bitcoin Mainnet や Ethereum Mainnet などのパブリックブロックチェーンネットワークからデータを読み取ることができます。アドレスの現在および過去の残高などの情報を取得したり、特定の期間のブロックチェーントランザクションのリストを取得したりすることもできます。さらに、トランザクションイベントなど、特定のトランザクションの詳細を取得できます。トランザクションイベントは、アプリケーションのビジネスロジックでさらに分析または使用できます。

## Amazon Managed Blockchain (AMB) クエリを使用する際の考慮事項と制限事項
<a name="ambq-considerations"></a>

AMB クエリを使用する場合は、次の点を考慮してください。
+ **使用可能なリージョン**

  AMB クエリは、*米国東部 (バージニア北部) * `us-east-1`リージョンでサポートされています。

  
+ **サービスエンドポイント**

  AMB クエリには、次のエンドポイントを使用してアクセスできます。

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

  
+ **サポートされているブロックチェーンネットワーク**

  AMB クエリは、次のパブリックブロックチェーンネットワークをサポートしています。
  + **Bitcoin Mainnet** — proof-of-workコンセンサスによって保護され、Bitcoin (BTC) 暗号通貨が発行されて取引されるパブリック Bitcoin ブロックチェーンネットワーク。Mainnet のトランザクションには実際の値があり (つまり、実際のコストが発生します）、パブリックブロックチェーンに記録されます。
  + **Bitcoin Testnet** — Bitcoin Mainnet のテストネット。このネットワーク上のビットコイン (BTC) は Mainnet BTC とは別個に区別され、通常は値がありません。
  + **Ethereum Mainnet** — パブリック Ethereum ブロックチェーンのproof-of-stakeメインネットワーク。Mainnet のトランザクションは実際の値 (つまり、実際のコストが発生します) を持ち、分散台帳に記録されます。
  + **Sepolia Testnet** — Ethereum Mainnet のテストネット。このネットワークの Ether (ETH) は Mainnet ETH とは独立しており、通常は値がありません。

    
+ **サポートされているブロックチェーントークンと契約**

  AMB クエリは、次のネイティブおよび標準の Ethereum 契約トークンをサポートしています。
  + **パブリックブロックチェーンネイティブトークン**
    + **Bitcoin (BTC)** — これは Bitcoin 関連のブロックチェーンのネイティブトークンです。
    + **Ether (ETH)** — これは Ethereum 関連のブロックチェーンのネイティブトークンです。

      
  + **Ethereum 契約標準**
    + **ERC-20 トークン標準** — ERC-20 は、ファンジブルトークンの標準です。各 ERC-20 トークンを別の ERC-20 トークンと完全に同じ (タイプと値) にするプロパティがあります。つまり、1 つのトークンは であり、常に他のすべてのトークンと等しくなります。詳細については、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)を参照してください。
+ **確定性**

  ブロックチェーンでは、*確定性*は有効なトランザクションが取り消される可能性が低いことを意味します。Bitcoin Mainnet の場合、AMB クエリは 6 ブロック後にトランザクションを確定と見なします。Bitcoin Testnet の場合、トランザクションは 6 ブロック後または 60 分後のいずれか早い方を最終と見なします。サポートされている Ethereum ネットワークの場合、AMB クエリは 64 ブロック後にトランザクションを確定と見なします。

  AMB クエリのトークン残高と契約 API オペレーションは、確定に達したデータのみを返します。ただし、AMB Query のトランザクションおよびトランザクションイベント API オペレーションは、ブロックチェーンネットワークで確認されたトランザクションのデータを、まだ確定していない場合でも返すことができます。

  
+ **NULL アドレスはサポートされていません**

  AMB クエリは `NULL` (`0x0000000000000000000000000000000000000000`) アドレスをサポートしていません。

  
+ **API コールの署名バージョン 4 の署名**

  AMB クエリ APIs を呼び出すときは、[署名バージョン 4 の署名プロセス](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html)を使用して認証された HTTPS 接続を介して呼び出すことができます。つまり、アカウント内の AWS 承認された IAM プリンシパルのみが AMB クエリ API コールを実行できます。これを行うには、 AWS 呼び出しで認証情報 (アクセスキー ID とシークレットアクセスキー) を指定する必要があります。
**重要**  
ユーザー向けアプリケーションにクライアント認証情報を埋め込まないでください。

  
+ **AMB クエリが Bitcoin トランザクション識別子とトランザクションハッシュをサポート**

  Bitcoin ネットワークの場合、AMB クエリ API オペレーションはトランザクション識別子 (`transactionId`) とトランザクションハッシュ () の両方をサポートします`transactionHash`。`transactionId` は、監視データを含まないトランザクションのダブル SHA ハッシュです。`transactionHash` は、監視データ (監視トランザクション ID とも呼ばれます) を含むトランザクションのダブル SHA ハッシュです。

  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`。また、 `transactionId`または を返す Bitcoin ネットワーク上のすべての AMB クエリオペレーション`transactionHash`には、レスポンスの一部として両方の値が含まれます。