com.amazonaws.services.managedblockchainquery

Class AmazonManagedBlockchainQueryClient

java.lang.Object

com.amazonaws.AmazonWebServiceClient

com.amazonaws.services.managedblockchainquery.AmazonManagedBlockchainQueryClient

All Implemented Interfaces:

AmazonManagedBlockchainQuery

Direct Known Subclasses:

AmazonManagedBlockchainQueryAsyncClient

@ThreadSafe
 @Generated(value="com.amazonaws:aws-java-sdk-code-generator")
public class AmazonManagedBlockchainQueryClient
extends AmazonWebServiceClient
implements AmazonManagedBlockchainQuery

Client for accessing Amazon Managed Blockchain Query. All service calls made using this client are blocking, and will not return until the service call completes.

Amazon Managed Blockchain (AMB) Query provides you with convenient access to multi-blockchain network data, which makes it easier for you to extract contextual data related to blockchain activity. You can use AMB Query to read data from public blockchain networks, such as Bitcoin Mainnet and Ethereum Mainnet. You can also get information such as the current and historical balances of addresses, or you can get a list of blockchain transactions for a given time period. Additionally, you can get details of a given transaction, such as transaction events, which you can further analyze or use in business logic for your applications.

Field Summary

Fields inherited from class com.amazonaws.AmazonWebServiceClient

LOGGING_AWS_REQUEST_METRIC

Fields inherited from interface com.amazonaws.services.managedblockchainquery.AmazonManagedBlockchainQuery

ENDPOINT_PREFIX

Method Summary

Modifier and Type	Method and Description
BatchGetTokenBalanceResult	batchGetTokenBalance(BatchGetTokenBalanceRequest request) Gets the token balance for a batch of tokens by using the BatchGetTokenBalance action for every token in the request.
static AmazonManagedBlockchainQueryClientBuilder	builder()
GetAssetContractResult	getAssetContract(GetAssetContractRequest request) Gets the information about a specific contract deployed on the blockchain.
ResponseMetadata	getCachedResponseMetadata(AmazonWebServiceRequest request) Returns additional metadata for a previously executed successful, request, typically used for debugging issues where a service isn't acting as expected.
GetTokenBalanceResult	getTokenBalance(GetTokenBalanceRequest request) Gets the balance of a specific token, including native tokens, for a given address (wallet or contract) on the blockchain.
GetTransactionResult	getTransaction(GetTransactionRequest request) Gets the details of a transaction.
ListAssetContractsResult	listAssetContracts(ListAssetContractsRequest request) Lists all the contracts for a given contract type deployed by an address (either a contract address or a wallet address).
ListFilteredTransactionEventsResult	listFilteredTransactionEvents(ListFilteredTransactionEventsRequest request) Lists all the transaction events for an address on the blockchain.
ListTokenBalancesResult	listTokenBalances(ListTokenBalancesRequest request) This action returns the following for a given blockchain network:
ListTransactionEventsResult	listTransactionEvents(ListTransactionEventsRequest request) Lists all the transaction events for a transaction
ListTransactionsResult	listTransactions(ListTransactionsRequest request) Lists all the transaction events for a transaction.
void	shutdown() Shuts down this client object, releasing any resources that might be held open.

Methods inherited from class com.amazonaws.AmazonWebServiceClient

addRequestHandler, addRequestHandler, configureRegion, getClientConfiguration, getEndpointPrefix, getMonitoringListeners, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, withEndpoint, withRegion, withRegion, withTimeOffset

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

builder

public static AmazonManagedBlockchainQueryClientBuilder builder()

batchGetTokenBalance

public BatchGetTokenBalanceResult batchGetTokenBalance(BatchGetTokenBalanceRequest request)

Gets the token balance for a batch of tokens by using the BatchGetTokenBalance action for every token in the request.

Only the native tokens BTC and ETH, and the ERC-20, ERC-721, and ERC 1155 token standards are supported.

Specified by:

batchGetTokenBalance in interface AmazonManagedBlockchainQuery

Parameters:

batchGetTokenBalanceRequest -

Returns:

Result of the BatchGetTokenBalance operation returned by the service.

Throws:

ThrottlingException - The request or operation couldn't be performed because a service is throttling requests. The most common source of throttling errors is when you create resources that exceed your service limit for this resource type. Request a limit increase or delete unused resources, if possible.

ValidationException - The resource passed is invalid.

ResourceNotFoundException - The resource was not found.

AccessDeniedException - The Amazon Web Services account doesn’t have access to this resource.

InternalServerException - The request processing has failed because of an internal error in the service.

ServiceQuotaExceededException - The service quota has been exceeded for this resource.

See Also:

AWS API Documentation

getAssetContract

public GetAssetContractResult getAssetContract(GetAssetContractRequest request)

Gets the information about a specific contract deployed on the blockchain.

• The Bitcoin blockchain networks do not support this operation.

• Metadata is currently only available for some ERC-20 contracts. Metadata will be available for additional contracts in the future.

Specified by:

getAssetContract in interface AmazonManagedBlockchainQuery

Parameters:

getAssetContractRequest -

Returns:

Result of the GetAssetContract operation returned by the service.

Throws:

ThrottlingException - The request or operation couldn't be performed because a service is throttling requests. The most common source of throttling errors is when you create resources that exceed your service limit for this resource type. Request a limit increase or delete unused resources, if possible.

ValidationException - The resource passed is invalid.

ResourceNotFoundException - The resource was not found.

AccessDeniedException - The Amazon Web Services account doesn’t have access to this resource.

InternalServerException - The request processing has failed because of an internal error in the service.

ServiceQuotaExceededException - The service quota has been exceeded for this resource.

See Also:

AWS API Documentation

getTokenBalance

public GetTokenBalanceResult getTokenBalance(GetTokenBalanceRequest request)

Gets the balance of a specific token, including native tokens, for a given address (wallet or contract) on the blockchain.

Only the native tokens BTC and ETH, and the ERC-20, ERC-721, and ERC 1155 token standards are supported.

Specified by:

getTokenBalance in interface AmazonManagedBlockchainQuery

Parameters:

getTokenBalanceRequest -

Returns:

Result of the GetTokenBalance operation returned by the service.

Throws:

ThrottlingException - The request or operation couldn't be performed because a service is throttling requests. The most common source of throttling errors is when you create resources that exceed your service limit for this resource type. Request a limit increase or delete unused resources, if possible.

ValidationException - The resource passed is invalid.

ResourceNotFoundException - The resource was not found.

AccessDeniedException - The Amazon Web Services account doesn’t have access to this resource.

InternalServerException - The request processing has failed because of an internal error in the service.

ServiceQuotaExceededException - The service quota has been exceeded for this resource.

See Also:

AWS API Documentation

getTransaction

public GetTransactionResult getTransaction(GetTransactionRequest request)

Gets the details of a transaction.

This action will return transaction details for all transactions that are confirmed on the blockchain, even if they have not reached finality.

Specified by:

getTransaction in interface AmazonManagedBlockchainQuery

Parameters:

getTransactionRequest -

Returns:

Result of the GetTransaction operation returned by the service.

Throws:

ThrottlingException - The request or operation couldn't be performed because a service is throttling requests. The most common source of throttling errors is when you create resources that exceed your service limit for this resource type. Request a limit increase or delete unused resources, if possible.

ValidationException - The resource passed is invalid.

ResourceNotFoundException - The resource was not found.

AccessDeniedException - The Amazon Web Services account doesn’t have access to this resource.

InternalServerException - The request processing has failed because of an internal error in the service.

ServiceQuotaExceededException - The service quota has been exceeded for this resource.

See Also:

AWS API Documentation

listAssetContracts

public ListAssetContractsResult listAssetContracts(ListAssetContractsRequest request)

Lists all the contracts for a given contract type deployed by an address (either a contract address or a wallet address).

The Bitcoin blockchain networks do not support this operation.

Specified by:

listAssetContracts in interface AmazonManagedBlockchainQuery

Parameters:

listAssetContractsRequest -

Returns:

Result of the ListAssetContracts operation returned by the service.

Throws:

ThrottlingException - The request or operation couldn't be performed because a service is throttling requests. The most common source of throttling errors is when you create resources that exceed your service limit for this resource type. Request a limit increase or delete unused resources, if possible.

ValidationException - The resource passed is invalid.

AccessDeniedException - The Amazon Web Services account doesn’t have access to this resource.

InternalServerException - The request processing has failed because of an internal error in the service.

ServiceQuotaExceededException - The service quota has been exceeded for this resource.

See Also:

AWS API Documentation

listFilteredTransactionEvents

public ListFilteredTransactionEventsResult listFilteredTransactionEvents(ListFilteredTransactionEventsRequest request)

Lists all the transaction events for an address on the blockchain.

This operation is only supported on the Bitcoin networks.

Specified by:

listFilteredTransactionEvents in interface AmazonManagedBlockchainQuery

Parameters:

listFilteredTransactionEventsRequest -

Returns:

Result of the ListFilteredTransactionEvents operation returned by the service.

Throws:

ThrottlingException - The request or operation couldn't be performed because a service is throttling requests. The most common source of throttling errors is when you create resources that exceed your service limit for this resource type. Request a limit increase or delete unused resources, if possible.

ValidationException - The resource passed is invalid.

AccessDeniedException - The Amazon Web Services account doesn’t have access to this resource.

InternalServerException - The request processing has failed because of an internal error in the service.

ServiceQuotaExceededException - The service quota has been exceeded for this resource.

See Also:

AWS API Documentation

listTokenBalances

public ListTokenBalancesResult listTokenBalances(ListTokenBalancesRequest request)

This action returns the following for a given blockchain network:

• Lists all token balances owned by an address (either a contract address or a wallet address).

• Lists all token balances for all tokens created by a contract.

• Lists all token balances for a given token.

You must always specify the network property of the tokenFilter when using this operation.

Specified by:

listTokenBalances in interface AmazonManagedBlockchainQuery

Parameters:

listTokenBalancesRequest -

Returns:

Result of the ListTokenBalances operation returned by the service.

Throws:

ThrottlingException - The request or operation couldn't be performed because a service is throttling requests. The most common source of throttling errors is when you create resources that exceed your service limit for this resource type. Request a limit increase or delete unused resources, if possible.

ValidationException - The resource passed is invalid.

AccessDeniedException - The Amazon Web Services account doesn’t have access to this resource.

InternalServerException - The request processing has failed because of an internal error in the service.

ServiceQuotaExceededException - The service quota has been exceeded for this resource.

See Also:

AWS API Documentation

listTransactionEvents

public ListTransactionEventsResult listTransactionEvents(ListTransactionEventsRequest request)

Lists all the transaction events for a transaction

This action will return transaction details for all transactions that are confirmed on the blockchain, even if they have not reached finality.

Specified by:

listTransactionEvents in interface AmazonManagedBlockchainQuery

Parameters:

listTransactionEventsRequest -

Returns:

Result of the ListTransactionEvents operation returned by the service.

Throws:

ThrottlingException - The request or operation couldn't be performed because a service is throttling requests. The most common source of throttling errors is when you create resources that exceed your service limit for this resource type. Request a limit increase or delete unused resources, if possible.

ValidationException - The resource passed is invalid.

AccessDeniedException - The Amazon Web Services account doesn’t have access to this resource.

InternalServerException - The request processing has failed because of an internal error in the service.

ServiceQuotaExceededException - The service quota has been exceeded for this resource.

See Also:

AWS API Documentation

listTransactions

public ListTransactionsResult listTransactions(ListTransactionsRequest request)

Lists all the transaction events for a transaction.

Specified by:

listTransactions in interface AmazonManagedBlockchainQuery

Parameters:

listTransactionsRequest -

Returns:

Result of the ListTransactions operation returned by the service.

Throws:

ThrottlingException - The request or operation couldn't be performed because a service is throttling requests. The most common source of throttling errors is when you create resources that exceed your service limit for this resource type. Request a limit increase or delete unused resources, if possible.

ValidationException - The resource passed is invalid.

AccessDeniedException - The Amazon Web Services account doesn’t have access to this resource.

InternalServerException - The request processing has failed because of an internal error in the service.

ServiceQuotaExceededException - The service quota has been exceeded for this resource.

See Also:

AWS API Documentation

getCachedResponseMetadata

public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)

Returns additional metadata for a previously executed successful, request, typically used for debugging issues where a service isn't acting as expected. This data isn't considered part of the result data returned by an operation, so it's available through this separate, diagnostic interface.

Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing the request.

Specified by:

getCachedResponseMetadata in interface AmazonManagedBlockchainQuery

Parameters:

request - The originally executed request

Returns:

The response metadata for the specified request, or null if none is available.

shutdown

public void shutdown()

Description copied from class: AmazonWebServiceClient

Shuts down this client object, releasing any resources that might be held open. If this method is not invoked, resources may be leaked. Once a client has been shutdown, it should not be used to make any more requests.

Specified by:

shutdown in interface AmazonManagedBlockchainQuery

Overrides:

shutdown in class AmazonWebServiceClient