

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon Managed Blockchain(AMB) 쿼리 사용 사례
<a name="query-usecases"></a>

이 주제에서는 AMB 쿼리 사용 사례 목록을 제공합니다.

**Topics**
+ [현재 및 과거 토큰 밸런스 쿼리](#query-token-balances)
+ [기록 트랜잭션 데이터 검색](#query-transactions)
+ [지정된 주소에 대한 모든 토큰 밸런스 가져오기](#query-token-balances)
+ [트랜잭션에 대해 내보낸 이벤트 나열](#query-tokens-minted)
+ [계약에서 빼낸 모든 토큰 가져오기](#query-transaction-events)
+ [계약 나열 및 계약 정보 가져오기](#query-contract-info)

## 현재 및 과거 토큰 밸런스 쿼리
<a name="query-token-balances"></a>

[https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_GetTokenBalance.html](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_GetTokenBalance.html) API는 지원되는 토큰(ERC20, ERC721, ERC1155)과 네이티브 코인(ETH, BTC)의 밸런스를 가져와 외부 소유 계정(EOAs)의 범용 타임스탬프(Unix 타임스탬프, 초 단위)를 사용하여 현재 또는 과거 밸런스를 가져옵니다. 예를 들어 `GetTokenBalance` API 작업을 사용하여 Ethereum Mainnet에서 ERC20 토큰 USDC의 주소 밸런스를 가져올 수 있습니다. `BatchGetTokenBalance` API 작업을 사용하여 토큰과 네이티브 코인의 밸런스를 일괄 검색할 수도 있습니다.

자세한 내용은 [Amazon Managed Blockchain(AMB) 쿼리 참조 안내서](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/Welcome.html)를 참조하세요.

## 기록 트랜잭션 데이터 검색
<a name="query-transactions"></a>

Amazon Managed Blockchain(AMB) 쿼리를 사용하면 Ethereum 및 Bitcoin과 같은 퍼블릭 블록체인에서 기록 데이터를 검색할 수 있습니다. 이 기능을 사용하면 블록체인 지갑에서 트랜잭션 기록을 검색하거나 트랜잭션 해시를 기반으로 트랜잭션에 대한 컨텍스트 정보를 제공하는 등 여러 사용 사례를 사용할 수 있습니다. [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 작업을 사용하여 Ethereum Mainnet에서 지정된 외부 소유 주소(EOA)에 대한 트랜잭션 목록을 가져온 다음 [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) API 작업을 사용하여 목록에서 단일 트랜잭션에 대한 트랜잭션 세부 정보를 검색할 수 있습니다.

자세한 내용은 [Amazon Managed Blockchain(AMB) 쿼리 참조 안내서](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/Welcome.html)를 참조하세요.

## 지정된 주소에 대한 모든 토큰 밸런스 가져오기
<a name="query-token-balances"></a>

[https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_ListTokenBalances.html](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_ListTokenBalances.html) API 작업을 사용하여 Wallets, 사용자 인터페이스, web3 유틸리티 등에 대한 밸런스를 얻을 수 있습니다. 이 API 작업은 단일 API 작업을 사용하여 지정된 퍼블릭 블록체인의 토큰(ERC20, ERC721, ERC1155) 및 네이티브 코인(ETH, BTC) 전반의 주소에 대한 모든 잔액 목록을 반환합니다. 예를 들어 외부 소유 주소(EOA)와 네트워크(Ethereum Mainnet)를 제공할 수 있으며, 응답에서 토큰 및 네이티브 코인 밸런스 목록을 받을 수 있습니다.

자세한 내용은 [Amazon Managed Blockchain(AMB) 쿼리 참조 안내서](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/Welcome.html)를 참조하세요.

## 트랜잭션에 대해 내보낸 이벤트 나열
<a name="query-tokens-minted"></a>

[https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_ListTransactionEvents.html](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_ListTransactionEvents.html) API 작업을 사용하여 해시(트랜잭션 식별자)로 식별되는 지정된 트랜잭션의 결과로 생성되는 계약 이벤트 목록을 검색할 수 있습니다. 예를 들어 [https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_ListTransactionEvents.html](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_ListTransactionEvents.html)를 사용하여 *전송* 이벤트 또는 ERC20 계약에서 *철회* 이벤트와 같이 이더리움 블록체인에서 ERC20 토큰 계약의 함수를 호출하는 트랜잭션의 결과 이벤트를 검색할 수 있습니다.

자세한 내용은 [Amazon Managed Blockchain(AMB) 쿼리 참조 안내서](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/Welcome.html)를 참조하세요.

## 계약에서 빼낸 모든 토큰 가져오기
<a name="query-transaction-events"></a>

[https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_ListTokenBalances.html](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_ListTokenBalances.html) API 작업을 사용하여 계약 주소를 입력으로 전달할 때 계약에 의해 제거된 지원되는 모든 토큰(ERC20, ERC721, ERC1155) 목록을 반환할 수 있습니다. 예를 들어 API [https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_ListTokenBalances.html](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_ListTokenBalances.html) 작업을 사용하여 Ethereum 블록체인의 ERC721 계약 표준에 따라 민팅된 고식적 토큰(NFTs)과 관련된 정보를 검색할 수 있습니다.

자세한 내용은 [Amazon Managed Blockchain(AMB) 쿼리 참조 안내서](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/Welcome.html)를 참조하세요.

## 계약 나열 및 계약 정보 가져오기
<a name="query-contract-info"></a>

[https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/ListAssetContracts.html](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/ListAssetContracts.html) API 작업을 사용하여 지정된 주소로 배포된 ERC-721, ERC-1155 또는 ERC-20 계약을 나열할 수 있습니다. 또한 계약 주소가 있는 경우 [https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/ListAssetContracts.html](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/ListAssetContracts.html) API 작업을 사용하여 계약 유형 배포자 주소 및 관련 토큰 메타데이터와 같은 계약의 속성을 검색할 수 있습니다.

자세한 내용은 [Amazon Managed Blockchain(AMB) 쿼리 참조 안내서](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/Welcome.html)를 참조하세요.