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 GetTokenBalance action for every token in the request.
static AmazonManagedBlockchainQueryClientBuilder	builder()
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) Get the details of a transaction.
ListTokenBalancesResult	listTokenBalances(ListTokenBalancesRequest request) This action returns the following for a given a blockchain network:
ListTransactionEventsResult	listTransactionEvents(ListTransactionEventsRequest request) An array of TransactionEvent objects.
ListTransactionsResult	listTransactions(ListTransactionsRequest request) Lists all of the transactions on a given wallet address or to a specific contract.
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 GetTokenBalance action for every token in the request.

Only the native tokens BTC,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

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,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)

Get the details of a transaction.

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

listTokenBalances

public ListTokenBalancesResult listTokenBalances(ListTokenBalancesRequest request)

This action returns the following for a given a blockchain network:

• Lists all token balances owned by an address (either a contact 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)

An array of TransactionEvent objects. Each object contains details about the transaction event.

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 of the transactions on a given wallet address or to a specific contract.

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