@aws-sdk/client-managedblockchain-query 3.503.1 → 3.505.0

package/dist-cjs/index.js

@@ -41,7 +41,6 @@ __export(src_exports, {
   QueryNetwork: () => QueryNetwork,
   QueryTokenStandard: () => QueryTokenStandard,
   QueryTransactionEventType: () => QueryTransactionEventType,
-  QueryTransactionStatus: () => QueryTransactionStatus,
   ResourceNotFoundException: () => ResourceNotFoundException,
   ResourceType: () => ResourceType,
   ServiceQuotaExceededException: () => ServiceQuotaExceededException,
@@ -331,22 +330,13 @@ var _ValidationException = class _ValidationException extends ManagedBlockchainQ
 __name(_ValidationException, "ValidationException");
 var ValidationException = _ValidationException;
 var ConfirmationStatus = {
-  FINAL: "FINAL"
+  FINAL: "FINAL",
+  NONFINAL: "NONFINAL"
 };
 var ExecutionStatus = {
   FAILED: "FAILED",
   SUCCEEDED: "SUCCEEDED"
 };
-var QueryTransactionStatus = {
-  /**
-   * The transaction completed on the blockchain, but failed
-   */
-  FAILED: "FAILED",
-  /**
-   * The transaction has been confirmed and is final in the blockchain
-   */
-  FINAL: "FINAL"
-};
 var QueryTransactionEventType = {
   /**
    * A Bitcoin Vin transfer type
@@ -537,6 +527,7 @@ var se_ListTransactionsCommand = /* @__PURE__ */ __name(async (input, context) =
   body = JSON.stringify(
     (0, import_smithy_client.take)(input, {
       address: [],
+      confirmationStatusFilter: (_) => (0, import_smithy_client._json)(_),
       fromBlockchainInstant: (_) => se_BlockchainInstant(_, context),
       maxResults: [],
       network: [],
@@ -1109,7 +1100,6 @@ var de_Transaction = /* @__PURE__ */ __name((output, context) => {
     signatureR: import_smithy_client.expectString,
     signatureS: import_smithy_client.expectString,
     signatureV: import_smithy_client.expectInt32,
-    status: import_smithy_client.expectString,
     to: import_smithy_client.expectString,
     transactionFee: import_smithy_client.expectString,
     transactionHash: import_smithy_client.expectString,
@@ -1120,6 +1110,7 @@ var de_Transaction = /* @__PURE__ */ __name((output, context) => {
 }, "de_Transaction");
 var de_TransactionOutputItem = /* @__PURE__ */ __name((output, context) => {
   return (0, import_smithy_client.take)(output, {
+    confirmationStatus: import_smithy_client.expectString,
     network: import_smithy_client.expectString,
     transactionHash: import_smithy_client.expectString,
     transactionTimestamp: (_) => (0, import_smithy_client.expectNonNull)((0, import_smithy_client.parseEpochTimestamp)((0, import_smithy_client.expectNumber)(_)))
@@ -1381,7 +1372,6 @@ var import_util_endpoints = require("@aws-sdk/util-endpoints");
   ValidationException,
   ConfirmationStatus,
   ExecutionStatus,
-  QueryTransactionStatus,
   QueryTransactionEventType,
   ListTransactionsSortBy,
   SortOrder

package/dist-es/models/models_0.js

@@ -113,15 +113,12 @@ export class ValidationException extends __BaseException {
 }
 export const ConfirmationStatus = {
     FINAL: "FINAL",
+    NONFINAL: "NONFINAL",
 };
 export const ExecutionStatus = {
     FAILED: "FAILED",
     SUCCEEDED: "SUCCEEDED",
 };
-export const QueryTransactionStatus = {
-    FAILED: "FAILED",
-    FINAL: "FINAL",
-};
 export const QueryTransactionEventType = {
     BITCOIN_VIN: "BITCOIN_VIN",
     BITCOIN_VOUT: "BITCOIN_VOUT",

package/dist-es/protocols/Aws_restJson1.js

@@ -113,6 +113,7 @@ export const se_ListTransactionsCommand = async (input, context) => {
     let body;
     body = JSON.stringify(take(input, {
         address: [],
+        confirmationStatusFilter: (_) => _json(_),
         fromBlockchainInstant: (_) => se_BlockchainInstant(_, context),
         maxResults: [],
         network: [],
@@ -692,7 +693,6 @@ const de_Transaction = (output, context) => {
         signatureR: __expectString,
         signatureS: __expectString,
         signatureV: __expectInt32,
-        status: __expectString,
         to: __expectString,
         transactionFee: __expectString,
         transactionHash: __expectString,
@@ -703,6 +703,7 @@ const de_Transaction = (output, context) => {
 };
 const de_TransactionOutputItem = (output, context) => {
     return take(output, {
+        confirmationStatus: __expectString,
         network: __expectString,
         transactionHash: __expectString,
         transactionTimestamp: (_) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),

package/dist-types/commands/BatchGetTokenBalanceCommand.d.ts

@@ -29,7 +29,7 @@ declare const BatchGetTokenBalanceCommand_base: {
  * <p>Gets the token balance for a batch of tokens by using the <code>BatchGetTokenBalance</code>
  *          action for every token in the request.</p>
  *          <note>
- *             <p>Only the native tokens BTC,ETH, and the ERC-20,
+ *             <p>Only the native tokens BTC and ETH, and the ERC-20,
  *          ERC-721, and ERC 1155 token standards are supported.</p>
  *          </note>
  * @example

package/dist-types/commands/GetTokenBalanceCommand.d.ts

@@ -28,7 +28,7 @@ declare const GetTokenBalanceCommand_base: {
  * @public
  * <p>Gets the balance of a specific token, including native tokens, for a given address (wallet or contract) on the blockchain.</p>
  *          <note>
- *             <p>Only the native tokens BTC,ETH, and the ERC-20,
+ *             <p>Only the native tokens BTC and ETH, and the ERC-20,
  *          ERC-721, and ERC 1155 token standards are supported.</p>
  *          </note>
  * @example

package/dist-types/commands/GetTransactionCommand.d.ts

@@ -26,7 +26,13 @@ declare const GetTransactionCommand_base: {
 };
 /**
  * @public
- * <p>Get the details of a transaction.</p>
+ * <p>Gets the details of a transaction.</p>
+ *          <note>
+ *             <p>This action will return transaction details for all transactions
+ *          that are <i>confirmed</i> on the blockchain, even if they have not reached
+ *          <a href="https://docs.aws.amazon.com/managed-blockchain/latest/ambq-dg/key-concepts.html#finality">finality</a>.
+ *       </p>
+ *          </note>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -48,7 +54,6 @@ declare const GetTransactionCommand_base: {
  * //     transactionTimestamp: new Date("TIMESTAMP"), // required
  * //     transactionIndex: Number("long"), // required
  * //     numberOfTransactions: Number("long"), // required
- * //     status: "STRING_VALUE",
  * //     to: "STRING_VALUE", // required
  * //     from: "STRING_VALUE",
  * //     contractAddress: "STRING_VALUE",

package/dist-types/commands/ListTransactionEventsCommand.d.ts

@@ -28,6 +28,12 @@ declare const ListTransactionEventsCommand_base: {
  * @public
  * <p>An array of <code>TransactionEvent</code> objects. Each object contains details
  *          about the transaction event.</p>
+ *          <note>
+ *             <p>This action will return transaction details for all transactions
+ *          that are <i>confirmed</i> on the blockchain, even if they have not reached
+ *          <a href="https://docs.aws.amazon.com/managed-blockchain/latest/ambq-dg/key-concepts.html#finality">finality</a>.
+ *       </p>
+ *          </note>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/ListTransactionsCommand.d.ts

@@ -48,6 +48,11 @@ declare const ListTransactionsCommand_base: {
  *   },
  *   nextToken: "STRING_VALUE",
  *   maxResults: Number("int"),
+ *   confirmationStatusFilter: { // ConfirmationStatusFilter
+ *     include: [ // ConfirmationStatusIncludeList // required
+ *       "STRING_VALUE",
+ *     ],
+ *   },
  * };
  * const command = new ListTransactionsCommand(input);
  * const response = await client.send(command);
@@ -57,6 +62,7 @@ declare const ListTransactionsCommand_base: {
  * //       transactionHash: "STRING_VALUE", // required
  * //       network: "STRING_VALUE", // required
  * //       transactionTimestamp: new Date("TIMESTAMP"), // required
+ * //       confirmationStatus: "STRING_VALUE",
  * //     },
  * //   ],
  * //   nextToken: "STRING_VALUE",

package/dist-types/models/models_0.d.ts

@@ -119,7 +119,7 @@ export interface OwnerIdentifier {
  * @public
  * <p>The container for the identifier for the token including the unique token ID and its blockchain network.</p>
  *          <note>
- *             <p>Only the native tokens BTC,ETH, and the ERC-20,
+ *             <p>Only the native tokens BTC and ETH, and the ERC-20,
  *          ERC-721, and ERC 1155 token standards are supported.</p>
  *          </note>
  */
@@ -138,8 +138,8 @@ export interface TokenIdentifier {
      * @public
      * <p>The unique identifier of the token.</p>
      *          <note>
-     *             <p>You must specify this container with <code>btc</code> for the native BTC token, and
-     *          <code>eth</code> for the native ETH token. For all other token types you must
+     *             <p>For native tokens, use the 3 character abbreviation that best matches your token.
+     *          For example, btc for Bitcoin, eth for Ether, etc. For all other token types you must
      *          specify the <code>tokenId</code> in the 64 character hexadecimal <code>tokenid</code> format.</p>
      *          </note>
      */
@@ -154,7 +154,7 @@ export interface BatchGetTokenBalanceInputItem {
      * @public
      * <p>The container for the identifier for the token including the unique token ID and its blockchain network.</p>
      *          <note>
-     *             <p>Only the native tokens BTC,ETH, and the ERC-20,
+     *             <p>Only the native tokens BTC and ETH, and the ERC-20,
      *          ERC-721, and ERC 1155 token standards are supported.</p>
      *          </note>
      */
@@ -207,7 +207,7 @@ export interface BatchGetTokenBalanceErrorItem {
      * @public
      * <p>The container for the identifier for the token including the unique token ID and its blockchain network.</p>
      *          <note>
-     *             <p>Only the native tokens BTC,ETH, and the ERC-20,
+     *             <p>Only the native tokens BTC and ETH, and the ERC-20,
      *          ERC-721, and ERC 1155 token standards are supported.</p>
      *          </note>
      */
@@ -252,7 +252,7 @@ export interface BatchGetTokenBalanceOutputItem {
      * @public
      * <p>The container for the identifier for the token including the unique token ID and its blockchain network.</p>
      *          <note>
-     *             <p>Only the native tokens BTC,ETH, and the ERC-20,
+     *             <p>Only the native tokens BTC and ETH, and the ERC-20,
      *          ERC-721, and ERC 1155 token standards are supported.</p>
      *          </note>
      */
@@ -462,11 +462,28 @@ export declare class ValidationException extends __BaseException {
  */
 export declare const ConfirmationStatus: {
     readonly FINAL: "FINAL";
+    readonly NONFINAL: "NONFINAL";
 };
 /**
  * @public
  */
 export type ConfirmationStatus = (typeof ConfirmationStatus)[keyof typeof ConfirmationStatus];
+/**
+ * @public
+ * <p>The container for the <code>ConfirmationStatusFilter</code> that filters for the <a href="https://docs.aws.amazon.com/managed-blockchain/latest/ambq-dg/key-concepts.html#finality">
+ *                <i>finality</i>
+ *             </a> of the results.</p>
+ */
+export interface ConfirmationStatusFilter {
+    /**
+     * @public
+     * <p>The container to determine whether to list results that have only reached <a href="https://docs.aws.amazon.com/managed-blockchain/latest/ambq-dg/key-concepts.html#finality">
+     *                <i>finality</i>
+     *             </a>. Transactions
+     *          that have reached finality are always part of the response.</p>
+     */
+    include: ConfirmationStatus[] | undefined;
+}
 /**
  * @public
  * <p>The contract or wallet address by which to filter the request.</p>
@@ -594,7 +611,7 @@ export interface GetTokenBalanceOutput {
      * @public
      * <p>The container for the identifier for the token including the unique token ID and its blockchain network.</p>
      *          <note>
-     *             <p>Only the native tokens BTC,ETH, and the ERC-20,
+     *             <p>Only the native tokens BTC and ETH, and the ERC-20,
      *          ERC-721, and ERC 1155 token standards are supported.</p>
      *          </note>
      */
@@ -630,24 +647,6 @@ export interface GetTransactionInput {
      */
     network: QueryNetwork | undefined;
 }
-/**
- * @public
- * @enum
- */
-export declare const QueryTransactionStatus: {
-    /**
-     * The transaction completed on the blockchain, but failed
-     */
-    readonly FAILED: "FAILED";
-    /**
-     * The transaction has been confirmed and is final in the blockchain
-     */
-    readonly FINAL: "FINAL";
-};
-/**
- * @public
- */
-export type QueryTransactionStatus = (typeof QueryTransactionStatus)[keyof typeof QueryTransactionStatus];
 /**
  * @public
  * <p>There are two possible types of transactions used for this data type:</p>
@@ -702,28 +701,6 @@ export interface Transaction {
      * <p>The number of transactions in the block.</p>
      */
     numberOfTransactions: number | undefined;
-    /**
-     * @public
-     * @deprecated
-     *
-     * <p>The status of the transaction.</p>
-     *          <important>
-     *             <p>This property is deprecated. You must use the <code>confirmationStatus</code>
-     *             and the <code>executionStatus</code> properties to determine if the <code>status</code>
-     *             of the transaction is <code>FINAL</code> or <code>FAILED</code>.</p>
-     *             <ul>
-     *                <li>
-     *                   <p>Transactions with a <code>status</code> of <code>FINAL</code> will now have the <code>confirmationStatus</code> set
-     *                to <code>FINAL</code> and the <code>executionStatus</code> set to <code>SUCCEEDED</code>.</p>
-     *                </li>
-     *                <li>
-     *                   <p>Transactions with a <code>status</code> of <code>FAILED</code> will now have the <code>confirmationStatus</code> set
-     *                to <code>FINAL</code> and the <code>executionStatus</code> set to <code>FAILED</code>.</p>
-     *                </li>
-     *             </ul>
-     *          </important>
-     */
-    status?: QueryTransactionStatus;
     /**
      * @public
      * <p>The identifier of the transaction. It is generated whenever a transaction is verified and added to the blockchain.</p>
@@ -818,6 +795,15 @@ export interface ListAssetContractsInput {
     /**
      * @public
      * <p>The maximum number of contracts to list.</p>
+     *          <p>Default:<code>100</code>
+     *          </p>
+     *          <note>
+     *             <p>Even if additional results can be retrieved, the request can return less
+     *        results than <code>maxResults</code> or an empty array of results.</p>
+     *             <p>To retrieve the next set of results, make another request with the
+     *          returned <code>nextToken</code> value. The value of <code>nextToken</code> is
+     *          <code>null</code> when there are no more results to return</p>
+     *          </note>
      */
     maxResults?: number;
 }
@@ -904,6 +890,15 @@ export interface ListTokenBalancesInput {
     /**
      * @public
      * <p>The maximum number of token balances to return.</p>
+     *          <p>Default:<code>100</code>
+     *          </p>
+     *          <note>
+     *             <p>Even if additional results can be retrieved, the request can return less
+     *        results than <code>maxResults</code> or an empty array of results.</p>
+     *             <p>To retrieve the next set of results, make another request with the
+     *          returned <code>nextToken</code> value. The value of <code>nextToken</code> is
+     *          <code>null</code> when there are no more results to return</p>
+     *          </note>
      */
     maxResults?: number;
 }
@@ -980,6 +975,8 @@ export interface ListTransactionEventsInput {
     /**
      * @public
      * <p>The maximum number of transaction events to list.</p>
+     *          <p>Default:<code>100</code>
+     *          </p>
      *          <note>
      *             <p>Even if additional results can be retrieved, the request can return less
      *        results than <code>maxResults</code> or an empty array of results.</p>
@@ -1194,8 +1191,8 @@ export interface ListTransactionsInput {
     toBlockchainInstant?: BlockchainInstant;
     /**
      * @public
-     * <p>Sorts items in an ascending order if the first page starts at <code>fromTime</code>.
-     *         Sorts items in a descending order if the first page starts at <code>toTime</code>.</p>
+     * <p>The order by which the results will be sorted. If <code>ASCENNDING</code> is selected, the results
+     *          will be ordered by <code>fromTime</code>. </p>
      */
     sort?: ListTransactionsSort;
     /**
@@ -1206,6 +1203,8 @@ export interface ListTransactionsInput {
     /**
      * @public
      * <p>The maximum number of transactions to list.</p>
+     *          <p>Default:<code>100</code>
+     *          </p>
      *          <note>
      *             <p>Even if additional results can be retrieved, the request can return less
      *        results than <code>maxResults</code> or an empty array of results.</p>
@@ -1215,6 +1214,14 @@ export interface ListTransactionsInput {
      *          </note>
      */
     maxResults?: number;
+    /**
+     * @public
+     * <p>This filter is used to include transactions in the response that haven't reached <a href="https://docs.aws.amazon.com/managed-blockchain/latest/ambq-dg/key-concepts.html#finality">
+     *                <i>finality</i>
+     *             </a>. Transactions that have reached finiality are always
+     *          part of the response.</p>
+     */
+    confirmationStatusFilter?: ConfirmationStatusFilter;
 }
 /**
  * @public
@@ -1236,6 +1243,11 @@ export interface TransactionOutputItem {
      * <p>The time when the transaction occurred.</p>
      */
     transactionTimestamp: Date | undefined;
+    /**
+     * @public
+     * <p>Specifies whether to list transactions that have not reached Finality.</p>
+     */
+    confirmationStatus?: ConfirmationStatus;
 }
 /**
  * @public

package/dist-types/ts3.4/models/models_0.d.ts

@@ -142,9 +142,13 @@ export declare class ValidationException extends __BaseException {
 }
 export declare const ConfirmationStatus: {
   readonly FINAL: "FINAL";
+  readonly NONFINAL: "NONFINAL";
 };
 export type ConfirmationStatus =
   (typeof ConfirmationStatus)[keyof typeof ConfirmationStatus];
+export interface ConfirmationStatusFilter {
+  include: ConfirmationStatus[] | undefined;
+}
 export interface ContractFilter {
   network: QueryNetwork | undefined;
   tokenStandard: QueryTokenStandard | undefined;
@@ -186,12 +190,6 @@ export interface GetTransactionInput {
   transactionHash: string | undefined;
   network: QueryNetwork | undefined;
 }
-export declare const QueryTransactionStatus: {
-  readonly FAILED: "FAILED";
-  readonly FINAL: "FINAL";
-};
-export type QueryTransactionStatus =
-  (typeof QueryTransactionStatus)[keyof typeof QueryTransactionStatus];
 export interface Transaction {
   network: QueryNetwork | undefined;
   blockHash?: string;
@@ -200,7 +198,6 @@ export interface Transaction {
   transactionTimestamp: Date | undefined;
   transactionIndex: number | undefined;
   numberOfTransactions: number | undefined;
-  status?: QueryTransactionStatus;
   to: string | undefined;
   from?: string;
   contractAddress?: string;
@@ -311,11 +308,13 @@ export interface ListTransactionsInput {
   sort?: ListTransactionsSort;
   nextToken?: string;
   maxResults?: number;
+  confirmationStatusFilter?: ConfirmationStatusFilter;
 }
 export interface TransactionOutputItem {
   transactionHash: string | undefined;
   network: QueryNetwork | undefined;
   transactionTimestamp: Date | undefined;
+  confirmationStatus?: ConfirmationStatus;
 }
 export interface ListTransactionsOutput {
   transactions: TransactionOutputItem[] | undefined;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-managedblockchain-query",
   "description": "AWS SDK for JavaScript Managedblockchain Query Client for Node.js, Browser and React Native",
-  "version": "3.503.1",
+  "version": "3.505.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "node ../../scripts/compilation/inline client-managedblockchain-query",
@@ -20,9 +20,9 @@
   "dependencies": {
     "@aws-crypto/sha256-browser": "3.0.0",
     "@aws-crypto/sha256-js": "3.0.0",
-    "@aws-sdk/client-sts": "3.502.0",
+    "@aws-sdk/client-sts": "3.504.0",
     "@aws-sdk/core": "3.496.0",
-    "@aws-sdk/credential-provider-node": "3.503.1",
+    "@aws-sdk/credential-provider-node": "3.504.0",
     "@aws-sdk/middleware-host-header": "3.502.0",
     "@aws-sdk/middleware-logger": "3.502.0",
     "@aws-sdk/middleware-recursion-detection": "3.502.0",