@stacks/blockchain-api-client 4.1.0 → 5.0.0-beta.1

package/lib/generated/apis/RosettaApi.js

@@ -105,7 +105,7 @@ class RosettaApi extends runtime.BaseAPI {
         return await response.value();
     }
     /**
-     * Take unsigned transaction and signature, combine both and return signed transaction
+     * Take unsigned transaction and signature, combine both and return signed transaction. The examples below are illustrative only. You\'ll need to use your wallet to generate actual values to use them in the request payload.
      * Create Network Transaction from Signatures
      */
     async rosettaConstructionCombineRaw(requestParameters, initOverrides) {
@@ -125,7 +125,7 @@ class RosettaApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => models_1.RosettaConstructionCombineResponseFromJSON(jsonValue));
     }
     /**
-     * Take unsigned transaction and signature, combine both and return signed transaction
+     * Take unsigned transaction and signature, combine both and return signed transaction. The examples below are illustrative only. You\'ll need to use your wallet to generate actual values to use them in the request payload.
      * Create Network Transaction from Signatures
      */
     async rosettaConstructionCombine(requestParameters, initOverrides) {
@@ -245,7 +245,7 @@ class RosettaApi extends runtime.BaseAPI {
         return await response.value();
     }
     /**
-     * Generate and unsigned transaction from operations and metadata
+     * Generate an unsigned transaction from operations and metadata. The examples below are illustrative only. You\'ll need to use your wallet to generate actual values to use them in the request payload.
      * Generate an Unsigned Transaction and Signing Payloads
      */
     async rosettaConstructionPayloadsRaw(requestParameters, initOverrides) {
@@ -265,7 +265,7 @@ class RosettaApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => models_1.RosettaConstructionPayloadResponseFromJSON(jsonValue));
     }
     /**
-     * Generate and unsigned transaction from operations and metadata
+     * Generate an unsigned transaction from operations and metadata. The examples below are illustrative only. You\'ll need to use your wallet to generate actual values to use them in the request payload.
      * Generate an Unsigned Transaction and Signing Payloads
      */
     async rosettaConstructionPayloads(requestParameters, initOverrides) {
@@ -301,7 +301,7 @@ class RosettaApi extends runtime.BaseAPI {
         return await response.value();
     }
     /**
-     * Submit a pre-signed transaction to the node.
+     * Submit a pre-signed transaction to the node. The examples below are illustrative only. You\'ll need to use your wallet to generate actual values to use them in the request payload.
      * Submit a Signed Transaction
      */
     async rosettaConstructionSubmitRaw(requestParameters, initOverrides) {
@@ -321,7 +321,7 @@ class RosettaApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => models_1.RosettaConstructionSubmitResponseFromJSON(jsonValue));
     }
     /**
-     * Submit a pre-signed transaction to the node.
+     * Submit a pre-signed transaction to the node. The examples below are illustrative only. You\'ll need to use your wallet to generate actual values to use them in the request payload.
      * Submit a Signed Transaction
      */
     async rosettaConstructionSubmit(requestParameters, initOverrides) {

package/lib/generated/models/Block.d.ts

@@ -33,6 +33,12 @@ export interface Block {
      * @memberof Block
      */
     hash: string;
+    /**
+     * The only hash that can uniquely identify an anchored block or an unconfirmed state trie
+     * @type {string}
+     * @memberof Block
+     */
+    index_block_hash: string;
     /**
      * Hash of the parent block
      * @type {string}

package/lib/generated/models/Block.js

@@ -26,6 +26,7 @@ function BlockFromJSONTyped(json, ignoreDiscriminator) {
         'canonical': json['canonical'],
         'height': json['height'],
         'hash': json['hash'],
+        'index_block_hash': json['index_block_hash'],
         'parent_block_hash': json['parent_block_hash'],
         'burn_block_time': json['burn_block_time'],
         'burn_block_time_iso': json['burn_block_time_iso'],
@@ -56,6 +57,7 @@ function BlockToJSON(value) {
         'canonical': value.canonical,
         'height': value.height,
         'hash': value.hash,
+        'index_block_hash': value.index_block_hash,
         'parent_block_hash': value.parent_block_hash,
         'burn_block_time': value.burn_block_time,
         'burn_block_time_iso': value.burn_block_time_iso,

package/lib/generated/models/Block.js.map

@@ -1 +1 @@
-{"version":3,"file":"Block.js","sourceRoot":"","sources":["../../../src/generated/models/Block.ts"],"names":[],"mappings":";AAAA,oBAAoB;AACpB,oBAAoB;AACpB;;;;;;;;;;GAUG;;;AA6HH,SAAgB,aAAa,CAAC,IAAS;IACnC,OAAO,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC3C,CAAC;AAFD,sCAEC;AAED,SAAgB,kBAAkB,CAAC,IAAS,EAAE,mBAA4B;IACtE,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE;QACzC,OAAO,IAAI,CAAC;KACf;IACD,OAAO;QAEH,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC;QAC9B,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC;QACxB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;QACpB,mBAAmB,EAAE,IAAI,CAAC,mBAAmB,CAAC;QAC9C,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,CAAC;QAC1C,qBAAqB,EAAE,IAAI,CAAC,qBAAqB,CAAC;QAClD,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,CAAC;QAC1C,mBAAmB,EAAE,IAAI,CAAC,mBAAmB,CAAC;QAC9C,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC;QAChC,wBAAwB,EAAE,IAAI,CAAC,wBAAwB,CAAC;QACxD,4BAA4B,EAAE,IAAI,CAAC,4BAA4B,CAAC;QAChE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC;QAClB,sBAAsB,EAAE,IAAI,CAAC,sBAAsB,CAAC;QACpD,sBAAsB,EAAE,IAAI,CAAC,sBAAsB,CAAC;QACpD,2BAA2B,EAAE,IAAI,CAAC,2BAA2B,CAAC;QAC9D,4BAA4B,EAAE,IAAI,CAAC,4BAA4B,CAAC;QAChE,wBAAwB,EAAE,IAAI,CAAC,wBAAwB,CAAC;QACxD,4BAA4B,EAAE,IAAI,CAAC,4BAA4B,CAAC;QAChE,6BAA6B,EAAE,IAAI,CAAC,6BAA6B,CAAC;KACrE,CAAC;AACN,CAAC;AA1BD,gDA0BC;AAED,SAAgB,WAAW,CAAC,KAAoB;IAC5C,IAAI,KAAK,KAAK,SAAS,EAAE;QACrB,OAAO,SAAS,CAAC;KACpB;IACD,IAAI,KAAK,KAAK,IAAI,EAAE;QAChB,OAAO,IAAI,CAAC;KACf;IACD,OAAO;QAEH,WAAW,EAAE,KAAK,CAAC,SAAS;QAC5B,QAAQ,EAAE,KAAK,CAAC,MAAM;QACtB,MAAM,EAAE,KAAK,CAAC,IAAI;QAClB,mBAAmB,EAAE,KAAK,CAAC,iBAAiB;QAC5C,iBAAiB,EAAE,KAAK,CAAC,eAAe;QACxC,qBAAqB,EAAE,KAAK,CAAC,mBAAmB;QAChD,iBAAiB,EAAE,KAAK,CAAC,eAAe;QACxC,mBAAmB,EAAE,KAAK,CAAC,iBAAiB;QAC5C,YAAY,EAAE,KAAK,CAAC,UAAU;QAC9B,wBAAwB,EAAE,KAAK,CAAC,sBAAsB;QACtD,4BAA4B,EAAE,KAAK,CAAC,0BAA0B;QAC9D,KAAK,EAAE,KAAK,CAAC,GAAG;QAChB,sBAAsB,EAAE,KAAK,CAAC,oBAAoB;QAClD,sBAAsB,EAAE,KAAK,CAAC,oBAAoB;QAClD,2BAA2B,EAAE,KAAK,CAAC,yBAAyB;QAC5D,4BAA4B,EAAE,KAAK,CAAC,0BAA0B;QAC9D,wBAAwB,EAAE,KAAK,CAAC,sBAAsB;QACtD,4BAA4B,EAAE,KAAK,CAAC,0BAA0B;QAC9D,6BAA6B,EAAE,KAAK,CAAC,2BAA2B;KACnE,CAAC;AACN,CAAC;AA7BD,kCA6BC"}
+{"version":3,"file":"Block.js","sourceRoot":"","sources":["../../../src/generated/models/Block.ts"],"names":[],"mappings":";AAAA,oBAAoB;AACpB,oBAAoB;AACpB;;;;;;;;;;GAUG;;;AAmIH,SAAgB,aAAa,CAAC,IAAS;IACnC,OAAO,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC3C,CAAC;AAFD,sCAEC;AAED,SAAgB,kBAAkB,CAAC,IAAS,EAAE,mBAA4B;IACtE,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE;QACzC,OAAO,IAAI,CAAC;KACf;IACD,OAAO;QAEH,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC;QAC9B,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC;QACxB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;QACpB,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,CAAC;QAC5C,mBAAmB,EAAE,IAAI,CAAC,mBAAmB,CAAC;QAC9C,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,CAAC;QAC1C,qBAAqB,EAAE,IAAI,CAAC,qBAAqB,CAAC;QAClD,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,CAAC;QAC1C,mBAAmB,EAAE,IAAI,CAAC,mBAAmB,CAAC;QAC9C,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC;QAChC,wBAAwB,EAAE,IAAI,CAAC,wBAAwB,CAAC;QACxD,4BAA4B,EAAE,IAAI,CAAC,4BAA4B,CAAC;QAChE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC;QAClB,sBAAsB,EAAE,IAAI,CAAC,sBAAsB,CAAC;QACpD,sBAAsB,EAAE,IAAI,CAAC,sBAAsB,CAAC;QACpD,2BAA2B,EAAE,IAAI,CAAC,2BAA2B,CAAC;QAC9D,4BAA4B,EAAE,IAAI,CAAC,4BAA4B,CAAC;QAChE,wBAAwB,EAAE,IAAI,CAAC,wBAAwB,CAAC;QACxD,4BAA4B,EAAE,IAAI,CAAC,4BAA4B,CAAC;QAChE,6BAA6B,EAAE,IAAI,CAAC,6BAA6B,CAAC;KACrE,CAAC;AACN,CAAC;AA3BD,gDA2BC;AAED,SAAgB,WAAW,CAAC,KAAoB;IAC5C,IAAI,KAAK,KAAK,SAAS,EAAE;QACrB,OAAO,SAAS,CAAC;KACpB;IACD,IAAI,KAAK,KAAK,IAAI,EAAE;QAChB,OAAO,IAAI,CAAC;KACf;IACD,OAAO;QAEH,WAAW,EAAE,KAAK,CAAC,SAAS;QAC5B,QAAQ,EAAE,KAAK,CAAC,MAAM;QACtB,MAAM,EAAE,KAAK,CAAC,IAAI;QAClB,kBAAkB,EAAE,KAAK,CAAC,gBAAgB;QAC1C,mBAAmB,EAAE,KAAK,CAAC,iBAAiB;QAC5C,iBAAiB,EAAE,KAAK,CAAC,eAAe;QACxC,qBAAqB,EAAE,KAAK,CAAC,mBAAmB;QAChD,iBAAiB,EAAE,KAAK,CAAC,eAAe;QACxC,mBAAmB,EAAE,KAAK,CAAC,iBAAiB;QAC5C,YAAY,EAAE,KAAK,CAAC,UAAU;QAC9B,wBAAwB,EAAE,KAAK,CAAC,sBAAsB;QACtD,4BAA4B,EAAE,KAAK,CAAC,0BAA0B;QAC9D,KAAK,EAAE,KAAK,CAAC,GAAG;QAChB,sBAAsB,EAAE,KAAK,CAAC,oBAAoB;QAClD,sBAAsB,EAAE,KAAK,CAAC,oBAAoB;QAClD,2BAA2B,EAAE,KAAK,CAAC,yBAAyB;QAC5D,4BAA4B,EAAE,KAAK,CAAC,0BAA0B;QAC9D,wBAAwB,EAAE,KAAK,CAAC,sBAAsB;QACtD,4BAA4B,EAAE,KAAK,CAAC,0BAA0B;QAC9D,6BAA6B,EAAE,KAAK,CAAC,2BAA2B;KACnE,CAAC;AACN,CAAC;AA9BD,kCA8BC"}

package/lib/index.umd.js

@@ -1415,6 +1415,7 @@
       'canonical': json['canonical'],
       'height': json['height'],
       'hash': json['hash'],
+      'index_block_hash': json['index_block_hash'],
       'parent_block_hash': json['parent_block_hash'],
       'burn_block_time': json['burn_block_time'],
       'burn_block_time_iso': json['burn_block_time_iso'],
@@ -1446,6 +1447,7 @@
       'canonical': value.canonical,
       'height': value.height,
       'hash': value.hash,
+      'index_block_hash': value.index_block_hash,
       'parent_block_hash': value.parent_block_hash,
       'burn_block_time': value.burn_block_time,
       'burn_block_time_iso': value.burn_block_time_iso,
@@ -6859,7 +6861,7 @@
       }
     }
     /**
-     * Retrieves block details of a specific block for a given chain height
+     * Retrieves block details of a specific block for a given chain height. You can use the hash from your latest block (\'get_block_list\' API) to get your block details.
      * Get block by hash
      */
     ;
@@ -6889,7 +6891,7 @@
       }
     }
     /**
-     * Retrieves block details of a specific block for a given chain height
+     * Retrieves block details of a specific block for a given chain height. You can use the hash from your latest block (\'get_block_list\' API) to get your block details.
      * Get block by hash
      */
     ;
@@ -7149,7 +7151,7 @@
     var _proto = FeesApi.prototype;
 
     /**
-     * **NOTE:** This endpoint is deprecated in favor of [Get approximate fees for the given transaction](#operation/post_fee_transaction).  Retrieves estimated fee rate.
+     * **NOTE:** This endpoint is deprecated in favor of [Get approximate fees for a given transaction](#operation/post_fee_transaction).  Retrieves estimated fee rate.
      * Fetch fee rate
      */
     _proto.fetchFeeRateRaw = function fetchFeeRateRaw(requestParameters, initOverrides) {
@@ -7179,7 +7181,7 @@
       }
     }
     /**
-     * **NOTE:** This endpoint is deprecated in favor of [Get approximate fees for the given transaction](#operation/post_fee_transaction).  Retrieves estimated fee rate.
+     * **NOTE:** This endpoint is deprecated in favor of [Get approximate fees for a given transaction](#operation/post_fee_transaction).  Retrieves estimated fee rate.
      * Fetch fee rate
      */
     ;
@@ -7238,7 +7240,7 @@
     }
     /**
      * Get an estimated fee for the supplied transaction.  This estimates the execution cost of the transaction, the current fee rate of the network, and returns estimates for fee amounts. * `transaction_payload` is a hex-encoded serialization of   the TransactionPayload for the transaction. * `estimated_len` is an optional argument that provides the   endpoint with an estimation of the final length (in bytes)   of the transaction, including any post-conditions and   signatures If the node cannot provide an estimate for the transaction (e.g., if the node has never seen a contract-call for the given contract and function) or if estimation is not configured on this node, a 400 response is returned. The 400 response will be a JSON error containing a `reason` field which can be one of the following: * `DatabaseError` - this Stacks node has had an internal   database error while trying to estimate the costs of the   supplied transaction. * `NoEstimateAvailable` - this Stacks node has not seen this   kind of contract-call before, and it cannot provide an   estimate yet. * `CostEstimationDisabled` - this Stacks node does not perform   fee or cost estimation, and it cannot respond on this   endpoint. The 200 response contains the following data: * `estimated_cost` - the estimated multi-dimensional cost of   executing the Clarity VM on the provided transaction. * `estimated_cost_scalar` - a unitless integer that the Stacks   node uses to compare how much of the block limit is consumed   by different transactions. This value incorporates the   estimated length of the transaction and the estimated   execution cost of the transaction. The range of this integer   may vary between different Stacks nodes. In order to compute   an estimate of total fee amount for the transaction, this   value is multiplied by the same Stacks node\'s estimated fee   rate. * `cost_scalar_change_by_byte` - a float value that indicates how   much the `estimated_cost_scalar` value would increase for every   additional byte in the final transaction. * `estimations` - an array of estimated fee rates and total fees to   pay in microSTX for the transaction. This array provides a range of   estimates (default: 3) that may be used. Each element of the array   contains the following fields:     * `fee_rate` - the estimated value for the current fee       rates in the network     * `fee` - the estimated value for the total fee in       microSTX that the given transaction should pay. These       values are the result of computing:       `fee_rate` x `estimated_cost_scalar`.       If the estimated fees are less than the minimum relay       fee `(1 ustx x estimated_len)`, then that minimum relay       fee will be returned here instead. Note: If the final transaction\'s byte size is larger than supplied to `estimated_len`, then applications should increase this fee amount by:   `fee_rate` x `cost_scalar_change_by_byte` x (`final_size` - `estimated_size`)
-     * Get approximate fees for the given transaction
+     * Get approximate fees for a given transaction
      */
     ;
 
@@ -7266,7 +7268,7 @@
     }
     /**
      * Get an estimated fee for the supplied transaction.  This estimates the execution cost of the transaction, the current fee rate of the network, and returns estimates for fee amounts. * `transaction_payload` is a hex-encoded serialization of   the TransactionPayload for the transaction. * `estimated_len` is an optional argument that provides the   endpoint with an estimation of the final length (in bytes)   of the transaction, including any post-conditions and   signatures If the node cannot provide an estimate for the transaction (e.g., if the node has never seen a contract-call for the given contract and function) or if estimation is not configured on this node, a 400 response is returned. The 400 response will be a JSON error containing a `reason` field which can be one of the following: * `DatabaseError` - this Stacks node has had an internal   database error while trying to estimate the costs of the   supplied transaction. * `NoEstimateAvailable` - this Stacks node has not seen this   kind of contract-call before, and it cannot provide an   estimate yet. * `CostEstimationDisabled` - this Stacks node does not perform   fee or cost estimation, and it cannot respond on this   endpoint. The 200 response contains the following data: * `estimated_cost` - the estimated multi-dimensional cost of   executing the Clarity VM on the provided transaction. * `estimated_cost_scalar` - a unitless integer that the Stacks   node uses to compare how much of the block limit is consumed   by different transactions. This value incorporates the   estimated length of the transaction and the estimated   execution cost of the transaction. The range of this integer   may vary between different Stacks nodes. In order to compute   an estimate of total fee amount for the transaction, this   value is multiplied by the same Stacks node\'s estimated fee   rate. * `cost_scalar_change_by_byte` - a float value that indicates how   much the `estimated_cost_scalar` value would increase for every   additional byte in the final transaction. * `estimations` - an array of estimated fee rates and total fees to   pay in microSTX for the transaction. This array provides a range of   estimates (default: 3) that may be used. Each element of the array   contains the following fields:     * `fee_rate` - the estimated value for the current fee       rates in the network     * `fee` - the estimated value for the total fee in       microSTX that the given transaction should pay. These       values are the result of computing:       `fee_rate` x `estimated_cost_scalar`.       If the estimated fees are less than the minimum relay       fee `(1 ustx x estimated_len)`, then that minimum relay       fee will be returned here instead. Note: If the final transaction\'s byte size is larger than supplied to `estimated_len`, then applications should increase this fee amount by:   `fee_rate` x `cost_scalar_change_by_byte` x (`final_size` - `estimated_size`)
-     * Get approximate fees for the given transaction
+     * Get approximate fees for a given transaction
      */
     ;
 
@@ -8090,10 +8092,6 @@
       try {
         var _this10 = this;
 
-        if (requestParameters.page === null || requestParameters.page === undefined) {
-          throw new RequiredError('page', 'Required parameter requestParameters.page was null or undefined when calling getAllNames.');
-        }
-
         var queryParameters = {};
 
         if (requestParameters.page !== undefined) {
@@ -8381,10 +8379,6 @@
           throw new RequiredError('tld', 'Required parameter requestParameters.tld was null or undefined when calling getNamespaceNames.');
         }
 
-        if (requestParameters.page === null || requestParameters.page === undefined) {
-          throw new RequiredError('page', 'Required parameter requestParameters.page was null or undefined when calling getNamespaceNames.');
-        }
-
         var queryParameters = {};
 
         if (requestParameters.page !== undefined) {
@@ -8487,7 +8481,7 @@
 
     /**
      * Retrieves metadata for non fungible tokens for a given contract id. More information on Non-Fungible Tokens on the Stacks blockchain can be found [here](https://docs.stacks.co/write-smart-contracts/tokens#non-fungible-tokens-nfts).
-     * Non fungible tokens metadata for contract id
+     * Non fungible tokens metadata for contract ID
      */
     _proto.getContractNftMetadataRaw = function getContractNftMetadataRaw(requestParameters, initOverrides) {
       try {
@@ -8515,7 +8509,7 @@
     }
     /**
      * Retrieves metadata for non fungible tokens for a given contract id. More information on Non-Fungible Tokens on the Stacks blockchain can be found [here](https://docs.stacks.co/write-smart-contracts/tokens#non-fungible-tokens-nfts).
-     * Non fungible tokens metadata for contract id
+     * Non fungible tokens metadata for contract ID
      */
     ;
 
@@ -8961,7 +8955,7 @@
       }
     }
     /**
-     * Take unsigned transaction and signature, combine both and return signed transaction
+     * Take unsigned transaction and signature, combine both and return signed transaction. The examples below are illustrative only. You\'ll need to use your wallet to generate actual values to use them in the request payload.
      * Create Network Transaction from Signatures
      */
     ;
@@ -8993,7 +8987,7 @@
       }
     }
     /**
-     * Take unsigned transaction and signature, combine both and return signed transaction
+     * Take unsigned transaction and signature, combine both and return signed transaction. The examples below are illustrative only. You\'ll need to use your wallet to generate actual values to use them in the request payload.
      * Create Network Transaction from Signatures
      */
     ;
@@ -9206,7 +9200,7 @@
       }
     }
     /**
-     * Generate and unsigned transaction from operations and metadata
+     * Generate an unsigned transaction from operations and metadata. The examples below are illustrative only. You\'ll need to use your wallet to generate actual values to use them in the request payload.
      * Generate an Unsigned Transaction and Signing Payloads
      */
     ;
@@ -9238,7 +9232,7 @@
       }
     }
     /**
-     * Generate and unsigned transaction from operations and metadata
+     * Generate an unsigned transaction from operations and metadata. The examples below are illustrative only. You\'ll need to use your wallet to generate actual values to use them in the request payload.
      * Generate an Unsigned Transaction and Signing Payloads
      */
     ;
@@ -9304,7 +9298,7 @@
       }
     }
     /**
-     * Submit a pre-signed transaction to the node.
+     * Submit a pre-signed transaction to the node. The examples below are illustrative only. You\'ll need to use your wallet to generate actual values to use them in the request payload.
      * Submit a Signed Transaction
      */
     ;
@@ -9336,7 +9330,7 @@
       }
     }
     /**
-     * Submit a pre-signed transaction to the node.
+     * Submit a pre-signed transaction to the node. The examples below are illustrative only. You\'ll need to use your wallet to generate actual values to use them in the request payload.
      * Submit a Signed Transaction
      */
     ;