Lists all the transaction events for an address on the blockchain.
+ *This operation is only supported on the Bitcoin networks.
+ *The Amazon Web Services account doesn’t have access to this resource.
+ * + * @throws {@link InternalServerException} (server fault) + *The request processing has failed because of an internal error in the service.
+ * + * @throws {@link ServiceQuotaExceededException} (client fault) + *The service quota has been exceeded for this resource.
+ * + * @throws {@link ThrottlingException} (client fault) + *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.
+ * + * @throws {@link ValidationException} (client fault) + *The resource passed is invalid.
+ * + * @throws {@link ManagedBlockchainQueryServiceException} + *Base exception class for all service exceptions from ManagedBlockchainQuery service.
+ * + * @public + */ +export class ListFilteredTransactionEventsCommand extends $Command + .classBuilder< + ListFilteredTransactionEventsCommandInput, + ListFilteredTransactionEventsCommandOutput, + ManagedBlockchainQueryClientResolvedConfig, + ServiceInputTypes, + ServiceOutputTypes + >() + .ep({ + ...commonParams, + }) + .m(function (this: any, Command: any, cs: any, config: ManagedBlockchainQueryClientResolvedConfig, o: any) { + return [ + getSerdePlugin(config, this.serialize, this.deserialize), + getEndpointPlugin(config, Command.getEndpointParameterInstructions()), + ]; + }) + .s("TietonChainQueryService", "ListFilteredTransactionEvents", {}) + .n("ManagedBlockchainQueryClient", "ListFilteredTransactionEventsCommand") + .f(void 0, void 0) + .ser(se_ListFilteredTransactionEventsCommand) + .de(de_ListFilteredTransactionEventsCommand) + .build() {} diff --git a/clients/client-managedblockchain-query/src/commands/ListTransactionEventsCommand.ts b/clients/client-managedblockchain-query/src/commands/ListTransactionEventsCommand.ts index e008a840013a..29002a245676 100644 --- a/clients/client-managedblockchain-query/src/commands/ListTransactionEventsCommand.ts +++ b/clients/client-managedblockchain-query/src/commands/ListTransactionEventsCommand.ts @@ -31,8 +31,7 @@ export interface ListTransactionEventsCommandInput extends ListTransactionEvents export interface ListTransactionEventsCommandOutput extends ListTransactionEventsOutput, __MetadataBearer {} /** - *An array of TransactionEvent objects. Each object contains details
- * about the transaction event.
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 @@ -46,7 +45,8 @@ export interface ListTransactionEventsCommandOutput extends ListTransactionEvent * // const { ManagedBlockchainQueryClient, ListTransactionEventsCommand } = require("@aws-sdk/client-managedblockchain-query"); // CommonJS import * const client = new ManagedBlockchainQueryClient(config); * const input = { // ListTransactionEventsInput - * transactionHash: "STRING_VALUE", // required + * transactionHash: "STRING_VALUE", + * transactionId: "STRING_VALUE", * network: "STRING_VALUE", // required * nextToken: "STRING_VALUE", * maxResults: Number("int"), @@ -66,6 +66,14 @@ export interface ListTransactionEventsCommandOutput extends ListTransactionEvent * // tokenId: "STRING_VALUE", * // transactionId: "STRING_VALUE", * // voutIndex: Number("int"), + * // voutSpent: true || false, + * // spentVoutTransactionId: "STRING_VALUE", + * // spentVoutTransactionHash: "STRING_VALUE", + * // spentVoutIndex: Number("int"), + * // blockchainInstant: { // BlockchainInstant + * // time: new Date("TIMESTAMP"), + * // }, + * // confirmationStatus: "STRING_VALUE", * // }, * // ], * // nextToken: "STRING_VALUE", diff --git a/clients/client-managedblockchain-query/src/commands/ListTransactionsCommand.ts b/clients/client-managedblockchain-query/src/commands/ListTransactionsCommand.ts index 0c1b91aa79d7..6f4fc6c90004 100644 --- a/clients/client-managedblockchain-query/src/commands/ListTransactionsCommand.ts +++ b/clients/client-managedblockchain-query/src/commands/ListTransactionsCommand.ts @@ -31,7 +31,7 @@ export interface ListTransactionsCommandInput extends ListTransactionsInput {} export interface ListTransactionsCommandOutput extends ListTransactionsOutput, __MetadataBearer {} /** - *
Lists all of the transactions on a given wallet address or to a specific contract.
+ *Lists all the transaction events for a transaction.
* @example * Use a bare-bones client and the command you need to make an API call. * ```javascript diff --git a/clients/client-managedblockchain-query/src/commands/index.ts b/clients/client-managedblockchain-query/src/commands/index.ts index f3b525369243..bec5e29f7093 100644 --- a/clients/client-managedblockchain-query/src/commands/index.ts +++ b/clients/client-managedblockchain-query/src/commands/index.ts @@ -4,6 +4,7 @@ export * from "./GetAssetContractCommand"; export * from "./GetTokenBalanceCommand"; export * from "./GetTransactionCommand"; export * from "./ListAssetContractsCommand"; +export * from "./ListFilteredTransactionEventsCommand"; export * from "./ListTokenBalancesCommand"; export * from "./ListTransactionEventsCommand"; export * from "./ListTransactionsCommand"; diff --git a/clients/client-managedblockchain-query/src/models/models_0.ts b/clients/client-managedblockchain-query/src/models/models_0.ts index ac09916a6eb0..20de775906db 100644 --- a/clients/client-managedblockchain-query/src/models/models_0.ts +++ b/clients/client-managedblockchain-query/src/models/models_0.ts @@ -23,6 +23,18 @@ export class AccessDeniedException extends __BaseException { } } +/** + *This is the container for the unique public address on the blockchain.
+ * @public + */ +export interface AddressIdentifierFilter { + /** + *The container for the recipient address of the transaction.
+ * @public + */ + transactionEventToAddress: string[] | undefined; +} + /** * @public * @enum @@ -126,7 +138,7 @@ export interface BlockchainInstant { } /** - *The container for the identifier of the owner.
+ *The container for the owner identifier.
* @public */ export interface OwnerIdentifier { @@ -186,7 +198,7 @@ export interface BatchGetTokenBalanceInputItem { tokenIdentifier: TokenIdentifier | undefined; /** - *The container for the identifier of the owner.
+ *The container for the owner identifier.
* @public */ ownerIdentifier: OwnerIdentifier | undefined; @@ -245,7 +257,7 @@ export interface BatchGetTokenBalanceErrorItem { tokenIdentifier?: TokenIdentifier; /** - *The container for the identifier of the owner.
+ *The container for the owner identifier.
* @public */ ownerIdentifier?: OwnerIdentifier; @@ -281,7 +293,7 @@ export interface BatchGetTokenBalanceErrorItem { */ export interface BatchGetTokenBalanceOutputItem { /** - *The container for the identifier of the owner.
+ *The container for the owner identifier.
* @public */ ownerIdentifier?: OwnerIdentifier; @@ -341,7 +353,7 @@ export class InternalServerException extends __BaseException { readonly $fault: "server" = "server"; $retryable = {}; /** - *The container of the retryAfterSeconds value.
Specifies the retryAfterSeconds value.
The container for the identifier of the owner.
+ *The container for the owner identifier.
* @public */ ownerIdentifier?: OwnerIdentifier; @@ -775,7 +787,7 @@ export interface GetTokenBalanceOutput { */ export interface GetTransactionInput { /** - *The hash of the transaction. It is generated whenever a transaction is verified and added to the blockchain.
+ *The hash of a transaction. It is generated when a transaction is created.
* @public */ transactionHash: string | undefined; @@ -819,7 +831,7 @@ export interface Transaction { blockHash?: string; /** - *The hash of the transaction. It is generated whenever a transaction is verified and added to the blockchain.
+ *The hash of a transaction. It is generated when a transaction is created.
* @public */ transactionHash: string | undefined; @@ -910,7 +922,7 @@ export interface Transaction { transactionFee?: string; /** - *The unique identifier of the transaction. It is generated whenever a transaction is verified and added to the blockchain.
+ *The identifier of a Bitcoin transaction. It is generated when a transaction is created.
* @public */ transactionId?: string; @@ -957,7 +969,7 @@ export interface ListAssetContractsInput { /** *The maximum number of contracts to list.
- *Default:100
+ *
Default: 100
*
Even if additional results can be retrieved, the request can return less @@ -989,166 +1001,139 @@ export interface ListAssetContractsOutput { } /** - *
The container for the owner information to filter by.
* @public + * @enum */ -export interface OwnerFilter { +export const ListFilteredTransactionEventsSortBy = { /** - *The contract or wallet address.
- * @public + * Timestamp of a transaction */ - address: string | undefined; -} + blockchainInstant: "blockchainInstant", +} as const; /** - *The container of the token filter like the contract address - * on a given blockchain network or a unique token identifier on a given - * blockchain network.
- *You must always specify the network property of this - * container when using this operation.
- *The blockchain network of the token.
- * @public - */ - network: QueryNetwork | undefined; +export type ListFilteredTransactionEventsSortBy = + (typeof ListFilteredTransactionEventsSortBy)[keyof typeof ListFilteredTransactionEventsSortBy]; +/** + * @public + * @enum + */ +export const SortOrder = { /** - *This is the address of the contract.
- * @public + * Result sorted in ascending order */ - contractAddress?: string; - + ASCENDING: "ASCENDING", /** - *The unique identifier of the token.
- * @public + * Result sorted in descending order */ - tokenId?: string; -} + DESCENDING: "DESCENDING", +} as const; /** * @public */ -export interface ListTokenBalancesInput { - /** - *The contract or wallet address on the blockchain network by which to filter the
- * request. You must specify the address property of the ownerFilter
- * when listing balances of tokens owned by the address.
The contract address or a token identifier on the
- * blockchain network by which to filter the request. You must specify the contractAddress
- * property of this container when listing tokens minted by a contract.
You must always specify the network property of this - * container when using this operation.
- *Lists all the transaction events for an address on the blockchain.
+ *This operation is only supported on the Bitcoin blockchain networks.
+ *The pagination token that indicates the next set of results to retrieve.
+ *Container on how the results will be sorted by?
* @public */ - nextToken?: string; + sortBy?: ListFilteredTransactionEventsSortBy; /** - *The maximum number of token balances to return.
- *Default:100
- *
Even if additional results can be retrieved, the request can return less
- * results than maxResults or an empty array of results.
To retrieve the next set of results, make another request with the
- * returned nextToken value. The value of nextToken is
- * null when there are no more results to return
The container for the sort order for ListFilteredTransactionEvents.
+ * The SortOrder field only accepts the values ASCENDING
+ * and DESCENDING. Not providing SortOrder will default
+ * to ASCENDING.
The balance of the token.
+ *This container is used to specify a time frame.
* @public */ -export interface TokenBalance { +export interface TimeFilter { /** - *The container for the identifier of the owner.
+ *The container for time.
* @public */ - ownerIdentifier?: OwnerIdentifier; + from?: BlockchainInstant; /** - *The identifier for the token, including the unique token ID and its blockchain network.
+ *The container for time.
* @public */ - tokenIdentifier?: TokenIdentifier; + to?: BlockchainInstant; +} +/** + *This container specifies filtering attributes related to BITCOIN_VOUT event types
The container of the token balance.
+ *Specifies if the transaction output is spent or unspent.
* @public */ - balance: string | undefined; + voutSpent: boolean | undefined; +} +/** + * @public + */ +export interface ListFilteredTransactionEventsInput { /** - *The time for when the TokenBalance is requested or - * the current time if a time is not provided in the request.
- *This time will only be recorded up to the second.
- *The blockchain network where the transaction occurred.
+ *Valid Values: BITCOIN_MAINNET | BITCOIN_TESTNET
+ *
The Timestamp of the last transaction at which the balance for the token in the wallet was updated.
This is the unique public address on the blockchain for which the transaction events are being requested.
* @public */ - lastUpdatedTime?: BlockchainInstant; -} + addressIdentifierFilter: AddressIdentifierFilter | undefined; -/** - * @public - */ -export interface ListTokenBalancesOutput { /** - *An array of TokenBalance objects. Each object contains details about
- * the token balance.
This container specifies the time frame for the transaction events returned in the response.
* @public */ - tokenBalances: TokenBalance[] | undefined; + timeFilter?: TimeFilter; /** - *The pagination token that indicates the next set of results to retrieve.
+ *This container specifies filtering attributes related to BITCOIN_VOUT event types
* @public */ - nextToken?: string; -} + voutFilter?: VoutFilter; -/** - * @public - */ -export interface ListTransactionEventsInput { /** - *The hash of the transaction. It is generated whenever a transaction is verified and added to the blockchain.
+ *The container for the ConfirmationStatusFilter that filters for the
+ * finality
+ * of the results.
The blockchain network where the transaction events occurred.
+ *The order by which the results will be sorted.
* @public */ - network: QueryNetwork | undefined; + sort?: ListFilteredTransactionEventsSort; /** *The pagination token that indicates the next set of results to retrieve.
@@ -1158,7 +1143,7 @@ export interface ListTransactionEventsInput { /** *The maximum number of transaction events to list.
- *Default:100
+ *
Default: 100
*
Even if additional results can be retrieved, the request can return less @@ -1240,7 +1225,7 @@ export interface TransactionEvent { network: QueryNetwork | undefined; /** - *
The hash of the transaction. It is generated whenever a transaction is verified and added to the blockchain.
+ *The hash of a transaction. It is generated when a transaction is created.
* @public */ transactionHash: string | undefined; @@ -1270,7 +1255,7 @@ export interface TransactionEvent { value?: string; /** - *The blockchain address. for the contract
+ *The blockchain address for the contract
* @public */ contractAddress?: string; @@ -1282,25 +1267,72 @@ export interface TransactionEvent { tokenId?: string; /** - *The unique identifier of the transaction. It is generated whenever a transaction is verified and added to the blockchain.
+ *The identifier of a Bitcoin transaction. It is generated when a transaction is created.
* @public */ transactionId?: string; /** - *The position of the vout in the transaction output list.
+ *The position of the transaction output in the transaction output list.
* @public */ voutIndex?: number; + + /** + *Specifies if the transaction output is spent or unspent. This is only returned for BITCOIN_VOUT event types.
+ *This is only returned for BITCOIN_VOUT event types.
The transactionId that created the spent transaction output.
+ *This is only returned for BITCOIN_VIN event types.
The transactionHash that created the spent transaction output.
+ *This is only returned for BITCOIN_VIN event types.
The position of the spent transaction output in the output list of the creating transaction.
+ *This is only returned for BITCOIN_VIN event types.
The container for time.
+ * @public + */ + blockchainInstant?: BlockchainInstant; + + /** + *This container specifies whether the transaction has reached Finality.
+ * @public + */ + confirmationStatus?: ConfirmationStatus; } /** * @public */ -export interface ListTransactionEventsOutput { +export interface ListFilteredTransactionEventsOutput { /** - *An array of TransactionEvent objects. Each object contains details
- * about the transaction events.
The transaction events returned by the request.
* @public */ events: TransactionEvent[] | undefined; @@ -1313,40 +1345,232 @@ export interface ListTransactionEventsOutput { } /** + *The container for the owner information to filter by.
* @public - * @enum */ -export const ListTransactionsSortBy = { +export interface OwnerFilter { /** - * Timestamp of a transaction + *The contract or wallet address.
+ * @public */ - TRANSACTION_TIMESTAMP: "TRANSACTION_TIMESTAMP", -} as const; + address: string | undefined; +} + +/** + *The container of the token filter like the contract address + * on a given blockchain network or a unique token identifier on a given + * blockchain network.
+ *You must always specify the network property of this + * container when using this operation.
+ *The blockchain network of the token.
+ * @public + */ + network: QueryNetwork | undefined; + + /** + *This is the address of the contract.
+ * @public + */ + contractAddress?: string; + + /** + *The unique identifier of the token.
+ * @public + */ + tokenId?: string; +} /** * @public */ -export type ListTransactionsSortBy = (typeof ListTransactionsSortBy)[keyof typeof ListTransactionsSortBy]; +export interface ListTokenBalancesInput { + /** + *The contract or wallet address on the blockchain network by which to filter the
+ * request. You must specify the address property of the ownerFilter
+ * when listing balances of tokens owned by the address.
The contract address or a token identifier on the
+ * blockchain network by which to filter the request. You must specify the contractAddress
+ * property of this container when listing tokens minted by a contract.
You must always specify the network property of this + * container when using this operation.
+ *The pagination token that indicates the next set of results to retrieve.
+ * @public + */ + nextToken?: string; + + /** + *The maximum number of token balances to return.
+ *Default: 100
+ *
Even if additional results can be retrieved, the request can return less
+ * results than maxResults or an empty array of results.
To retrieve the next set of results, make another request with the
+ * returned nextToken value. The value of nextToken is
+ * null when there are no more results to return
The balance of the token.
* @public - * @enum */ -export const SortOrder = { +export interface TokenBalance { /** - * Result sorted in ascending order + *The container for the identifier of the owner.
+ * @public */ - ASCENDING: "ASCENDING", + ownerIdentifier?: OwnerIdentifier; + /** - * Result sorted in descending order + *The identifier for the token, including the unique token ID and its blockchain network.
+ * @public */ - DESCENDING: "DESCENDING", + tokenIdentifier?: TokenIdentifier; + + /** + *The container of the token balance.
+ * @public + */ + balance: string | undefined; + + /** + *The time for when the TokenBalance is requested or + * the current time if a time is not provided in the request.
+ *This time will only be recorded up to the second.
+ *The Timestamp of the last transaction at which the balance for the token in the wallet was updated.
An array of TokenBalance objects. Each object contains details about
+ * the token balance.
The pagination token that indicates the next set of results to retrieve.
+ * @public + */ + nextToken?: string; +} + +/** + * @public + */ +export interface ListTransactionEventsInput { + /** + *The hash of a transaction. It is generated when a transaction is created.
+ * @public + */ + transactionHash?: string; + + /** + *The identifier of a Bitcoin transaction. It is generated when a transaction is created.
+ *
+ * transactionId is only supported on the Bitcoin networks.
The blockchain network where the transaction events occurred.
+ * @public + */ + network: QueryNetwork | undefined; + + /** + *The pagination token that indicates the next set of results to retrieve.
+ * @public + */ + nextToken?: string; + + /** + *The maximum number of transaction events to list.
+ *Default: 100
+ *
Even if additional results can be retrieved, the request can return less
+ * results than maxResults or an empty array of results.
To retrieve the next set of results, make another request with the
+ * returned nextToken value. The value of nextToken is
+ * null when there are no more results to return
An array of TransactionEvent objects. Each object contains details
+ * about the transaction events.
The pagination token that indicates the next set of results to retrieve.
+ * @public + */ + nextToken?: string; +} + +/** + * @public + * @enum + */ +export const ListTransactionsSortBy = { + /** + * Timestamp of a transaction + */ + TRANSACTION_TIMESTAMP: "TRANSACTION_TIMESTAMP", } as const; /** * @public */ -export type SortOrder = (typeof SortOrder)[keyof typeof SortOrder]; +export type ListTransactionsSortBy = (typeof ListTransactionsSortBy)[keyof typeof ListTransactionsSortBy]; /** *The container for determining how the list transaction result will @@ -1399,8 +1623,7 @@ export interface ListTransactionsInput { toBlockchainInstant?: BlockchainInstant; /** - *
The order by which the results will be sorted. If ASCENNDING is selected, the results
- * will be ordered by fromTime.
The order by which the results will be sorted.
* @public */ sort?: ListTransactionsSort; @@ -1413,7 +1636,7 @@ export interface ListTransactionsInput { /** *The maximum number of transactions to list.
- *Default:100
+ *
Default: 100
*
Even if additional results can be retrieved, the request can return less @@ -1429,7 +1652,7 @@ export interface ListTransactionsInput { /** *
This filter is used to include transactions in the response that haven't reached * finality - * . Transactions that have reached finiality are always + * . Transactions that have reached finality are always * part of the response.
* @public */ @@ -1442,7 +1665,7 @@ export interface ListTransactionsInput { */ export interface TransactionOutputItem { /** - *The hash of the transaction. It is generated whenever a transaction is verified and added to the blockchain.
+ *The hash of a transaction. It is generated when a transaction is created.
* @public */ transactionHash: string | undefined; diff --git a/clients/client-managedblockchain-query/src/pagination/ListFilteredTransactionEventsPaginator.ts b/clients/client-managedblockchain-query/src/pagination/ListFilteredTransactionEventsPaginator.ts new file mode 100644 index 000000000000..4bf6646f83a8 --- /dev/null +++ b/clients/client-managedblockchain-query/src/pagination/ListFilteredTransactionEventsPaginator.ts @@ -0,0 +1,24 @@ +// smithy-typescript generated code +import { createPaginator } from "@smithy/core"; +import { Paginator } from "@smithy/types"; + +import { + ListFilteredTransactionEventsCommand, + ListFilteredTransactionEventsCommandInput, + ListFilteredTransactionEventsCommandOutput, +} from "../commands/ListFilteredTransactionEventsCommand"; +import { ManagedBlockchainQueryClient } from "../ManagedBlockchainQueryClient"; +import { ManagedBlockchainQueryPaginationConfiguration } from "./Interfaces"; + +/** + * @public + */ +export const paginateListFilteredTransactionEvents: ( + config: ManagedBlockchainQueryPaginationConfiguration, + input: ListFilteredTransactionEventsCommandInput, + ...rest: any[] +) => PaginatorThe container for the recipient address of the transaction.
", + "smithy.api#length": { + "min": 1, + "max": 1 + }, + "smithy.api#required": {} + } + } + }, + "traits": { + "smithy.api#documentation": "This is the container for the unique public address on the blockchain.
" + } + }, "com.amazonaws.managedblockchainquery#AssetContract": { "type": "structure", "members": { @@ -274,6 +293,12 @@ "smithy.api#pattern": "^[-A-Za-z0-9]{13,74}$" } }, + "com.amazonaws.managedblockchainquery#ChainAddresses": { + "type": "list", + "member": { + "target": "com.amazonaws.managedblockchainquery#ChainAddress" + } + }, "com.amazonaws.managedblockchainquery#ConfirmationStatus": { "type": "string", "traits": { @@ -669,7 +694,7 @@ "transactionHash": { "target": "com.amazonaws.managedblockchainquery#QueryTransactionHash", "traits": { - "smithy.api#documentation": "The hash of the transaction. It is generated whenever a transaction is verified and added to the blockchain.
", + "smithy.api#documentation": "The hash of a transaction. It is generated when a transaction is created.
", "smithy.api#required": {} } }, @@ -713,7 +738,7 @@ "retryAfterSeconds": { "target": "smithy.api#Integer", "traits": { - "smithy.api#documentation": "The container of the retryAfterSeconds value.
Specifies the retryAfterSeconds value.
The maximum number of contracts to list.
\nDefault:100\n
Even if additional results can be retrieved, the request can return less \n results than maxResults or an empty array of results.
To retrieve the next set of results, make another request with the \n returned nextToken value. The value of nextToken is \n null when there are no more results to return
The maximum number of contracts to list.
\nDefault: 100\n
Even if additional results can be retrieved, the request can return less \n results than maxResults or an empty array of results.
To retrieve the next set of results, make another request with the \n returned nextToken value. The value of nextToken is \n null when there are no more results to return
Lists all the transaction events for an address on the blockchain.
\nThis operation is only supported on the Bitcoin networks.
\nThe blockchain network where the transaction occurred.
\nValid Values: BITCOIN_MAINNET | BITCOIN_TESTNET\n
This is the unique public address on the blockchain for which the transaction events are being requested.
", + "smithy.api#required": {} + } + }, + "timeFilter": { + "target": "com.amazonaws.managedblockchainquery#TimeFilter", + "traits": { + "smithy.api#documentation": "This container specifies the time frame for the transaction events returned in the response.
" + } + }, + "voutFilter": { + "target": "com.amazonaws.managedblockchainquery#VoutFilter", + "traits": { + "smithy.api#documentation": "This container specifies filtering attributes related to BITCOIN_VOUT event types
" + } + }, + "confirmationStatusFilter": { + "target": "com.amazonaws.managedblockchainquery#ConfirmationStatusFilter" + }, + "sort": { + "target": "com.amazonaws.managedblockchainquery#ListFilteredTransactionEventsSort", + "traits": { + "smithy.api#documentation": "The order by which the results will be sorted.
" + } + }, + "nextToken": { + "target": "com.amazonaws.managedblockchainquery#NextToken", + "traits": { + "smithy.api#documentation": "The pagination token that indicates the next set of results to retrieve.
" + } + }, + "maxResults": { + "target": "smithy.api#Integer", + "traits": { + "smithy.api#documentation": "The maximum number of transaction events to list.
\nDefault: 100\n
Even if additional results can be retrieved, the request can return less \n results than maxResults or an empty array of results.
To retrieve the next set of results, make another request with the \n returned nextToken value. The value of nextToken is \n null when there are no more results to return
The transaction events returned by the request.
", + "smithy.api#required": {} + } + }, + "nextToken": { + "target": "com.amazonaws.managedblockchainquery#NextToken", + "traits": { + "smithy.api#documentation": "The pagination token that indicates the next set of results to retrieve.
" + } + } + }, + "traits": { + "smithy.api#output": {} + } + }, + "com.amazonaws.managedblockchainquery#ListFilteredTransactionEventsSort": { + "type": "structure", + "members": { + "sortBy": { + "target": "com.amazonaws.managedblockchainquery#ListFilteredTransactionEventsSortBy", + "traits": { + "smithy.api#documentation": "Container on how the results will be sorted by?
" + } + }, + "sortOrder": { + "target": "com.amazonaws.managedblockchainquery#SortOrder", + "traits": { + "smithy.api#documentation": "The container for the sort order for ListFilteredTransactionEvents. \n The SortOrder field only accepts the values ASCENDING \n and DESCENDING. Not providing SortOrder will default \n to ASCENDING.
Lists all the transaction events for an address on the blockchain.
\nThis operation is only supported on the Bitcoin blockchain networks.
\nThe maximum number of token balances to return.
\nDefault:100\n
Even if additional results can be retrieved, the request can return less \n results than maxResults or an empty array of results.
To retrieve the next set of results, make another request with the \n returned nextToken value. The value of nextToken is \n null when there are no more results to return
The maximum number of token balances to return.
\nDefault: 100\n
Even if additional results can be retrieved, the request can return less \n results than maxResults or an empty array of results.
To retrieve the next set of results, make another request with the \n returned nextToken value. The value of nextToken is \n null when there are no more results to return
An array of TransactionEvent objects. Each object contains details \n about the transaction event.
This action will return transaction details for all transactions \n that are confirmed on the blockchain, even if they have not reached \n finality.\n
\nLists all the transaction events for a transaction
\nThis action will return transaction details for all transactions \n that are confirmed on the blockchain, even if they have not reached \n finality.\n
\nThe hash of the transaction. It is generated whenever a transaction is verified and added to the blockchain.
", - "smithy.api#required": {} + "smithy.api#documentation": "The hash of a transaction. It is generated when a transaction is created.
" + } + }, + "transactionId": { + "target": "com.amazonaws.managedblockchainquery#QueryTransactionId", + "traits": { + "smithy.api#documentation": "The identifier of a Bitcoin transaction. It is generated when a transaction is created.
\n\n transactionId is only supported on the Bitcoin networks.
The maximum number of transaction events to list.
\nDefault:100\n
Even if additional results can be retrieved, the request can return less \n results than maxResults or an empty array of results.
To retrieve the next set of results, make another request with the \n returned nextToken value. The value of nextToken is \n null when there are no more results to return
The maximum number of transaction events to list.
\nDefault: 100\n
Even if additional results can be retrieved, the request can return less \n results than maxResults or an empty array of results.
To retrieve the next set of results, make another request with the \n returned nextToken value. The value of nextToken is \n null when there are no more results to return
Lists all of the transactions on a given wallet address or to a specific contract.
", + "smithy.api#documentation": "Lists all the transaction events for a transaction.
", "smithy.api#http": { "uri": "/list-transactions", "method": "POST" @@ -1084,7 +1267,7 @@ "sort": { "target": "com.amazonaws.managedblockchainquery#ListTransactionsSort", "traits": { - "smithy.api#documentation": "The order by which the results will be sorted. If ASCENNDING is selected, the results \n will be ordered by fromTime.
The order by which the results will be sorted.
" } }, "nextToken": { @@ -1096,7 +1279,7 @@ "maxResults": { "target": "smithy.api#Integer", "traits": { - "smithy.api#documentation": "The maximum number of transactions to list.
\nDefault:100\n
Even if additional results can be retrieved, the request can return less \n results than maxResults or an empty array of results.
To retrieve the next set of results, make another request with the \n returned nextToken value. The value of nextToken is \n null when there are no more results to return
The maximum number of transactions to list.
\nDefault: 100\n
Even if additional results can be retrieved, the request can return less \n results than maxResults or an empty array of results.
To retrieve the next set of results, make another request with the \n returned nextToken value. The value of nextToken is \n null when there are no more results to return
This filter is used to include transactions in the response that haven't reached \n finality\n . Transactions that have reached finiality are always \n part of the response.
" + "smithy.api#documentation": "This filter is used to include transactions in the response that haven't reached \n finality\n . Transactions that have reached finality are always \n part of the response.
" } } }, @@ -1203,7 +1386,7 @@ } }, "traits": { - "smithy.api#documentation": "The container for the identifier of the owner.
" + "smithy.api#documentation": "The container for the owner identifier.
" } }, "com.amazonaws.managedblockchainquery#QueryNetwork": { @@ -1326,6 +1509,12 @@ "smithy.api#pattern": "^(0x[A-Fa-f0-9]{64}|[A-Fa-f0-9]{64})$" } }, + "com.amazonaws.managedblockchainquery#QueryTransactionId": { + "type": "string", + "traits": { + "smithy.api#pattern": "^(0x[A-Fa-f0-9]{64}|[A-Fa-f0-9]{64})$" + } + }, "com.amazonaws.managedblockchainquery#QuotaCode": { "type": "string" }, @@ -1499,6 +1688,9 @@ { "target": "com.amazonaws.managedblockchainquery#ListAssetContracts" }, + { + "target": "com.amazonaws.managedblockchainquery#ListFilteredTransactionEvents" + }, { "target": "com.amazonaws.managedblockchainquery#ListTokenBalances" }, @@ -2210,6 +2402,20 @@ } } }, + "com.amazonaws.managedblockchainquery#TimeFilter": { + "type": "structure", + "members": { + "from": { + "target": "com.amazonaws.managedblockchainquery#BlockchainInstant" + }, + "to": { + "target": "com.amazonaws.managedblockchainquery#BlockchainInstant" + } + }, + "traits": { + "smithy.api#documentation": "This container is used to specify a time frame.
" + } + }, "com.amazonaws.managedblockchainquery#TokenBalance": { "type": "structure", "members": { @@ -2335,7 +2541,7 @@ "transactionHash": { "target": "com.amazonaws.managedblockchainquery#QueryTransactionHash", "traits": { - "smithy.api#documentation": "The hash of the transaction. It is generated whenever a transaction is verified and added to the blockchain.
", + "smithy.api#documentation": "The hash of a transaction. It is generated when a transaction is created.
", "smithy.api#required": {} } }, @@ -2430,7 +2636,7 @@ "transactionId": { "target": "smithy.api#String", "traits": { - "smithy.api#documentation": "The unique identifier of the transaction. It is generated whenever a transaction is verified and added to the blockchain.
" + "smithy.api#documentation": "The identifier of a Bitcoin transaction. It is generated when a transaction is created.
" } }, "confirmationStatus": { @@ -2463,7 +2669,7 @@ "transactionHash": { "target": "com.amazonaws.managedblockchainquery#QueryTransactionHash", "traits": { - "smithy.api#documentation": "The hash of the transaction. It is generated whenever a transaction is verified and added to the blockchain.
", + "smithy.api#documentation": "The hash of a transaction. It is generated when a transaction is created.
", "smithy.api#required": {} } }, @@ -2495,7 +2701,7 @@ "contractAddress": { "target": "com.amazonaws.managedblockchainquery#ChainAddress", "traits": { - "smithy.api#documentation": "The blockchain address. for the contract
" + "smithy.api#documentation": "The blockchain address for the contract
" } }, "tokenId": { @@ -2507,13 +2713,46 @@ "transactionId": { "target": "smithy.api#String", "traits": { - "smithy.api#documentation": "The unique identifier of the transaction. It is generated whenever a transaction is verified and added to the blockchain.
" + "smithy.api#documentation": "The identifier of a Bitcoin transaction. It is generated when a transaction is created.
" } }, "voutIndex": { "target": "smithy.api#Integer", "traits": { - "smithy.api#documentation": "The position of the vout in the transaction output list.
" + "smithy.api#documentation": "The position of the transaction output in the transaction output list.
" + } + }, + "voutSpent": { + "target": "smithy.api#Boolean", + "traits": { + "smithy.api#documentation": "Specifies if the transaction output is spent or unspent. This is only returned for BITCOIN_VOUT event types.
\nThis is only returned for BITCOIN_VOUT event types.
The transactionId that created the spent transaction output.
\nThis is only returned for BITCOIN_VIN event types.
The transactionHash that created the spent transaction output.
\nThis is only returned for BITCOIN_VIN event types.
The position of the spent transaction output in the output list of the creating transaction.
\nThis is only returned for BITCOIN_VIN event types.
This container specifies whether the transaction has reached Finality.
" } } }, @@ -2539,7 +2778,7 @@ "transactionHash": { "target": "com.amazonaws.managedblockchainquery#QueryTransactionHash", "traits": { - "smithy.api#documentation": "The hash of the transaction. It is generated whenever a transaction is verified and added to the blockchain.
", + "smithy.api#documentation": "The hash of a transaction. It is generated when a transaction is created.
", "smithy.api#required": {} } }, @@ -2660,6 +2899,21 @@ } ] } + }, + "com.amazonaws.managedblockchainquery#VoutFilter": { + "type": "structure", + "members": { + "voutSpent": { + "target": "smithy.api#Boolean", + "traits": { + "smithy.api#documentation": "Specifies if the transaction output is spent or unspent.
", + "smithy.api#required": {} + } + } + }, + "traits": { + "smithy.api#documentation": "This container specifies filtering attributes related to BITCOIN_VOUT event types