# near

## Description

The `txStatus` function is an asynchronous function that retrieves the status of any transaction on the NEAR Protocol blockchain.

## Parameters

| Parameter   | Data Type | Description                                          |
| ----------- | --------- | ---------------------------------------------------- |
| `txHash`    | string    | The hash of the transaction to query.                |
| `env`       | string    | The environment or network to connect to.            |
| `accountId` | string    | The NEAR account ID associated with the transaction. |

## Response

| Field    | Data Type | Description                                            |
| -------- | --------- | ------------------------------------------------------ |
| `code`   | number    | An indicator of the status of the function call.       |
| `result` | any       | The result of the transaction status query.            |
| `error`  | any       | An error object if the transaction status query fails. |

## Example Request and Response

### Prerequisites

Before making requests with NO.AI SDK, you must have it installed.

You can install NO.AI SDK using either **`npm`** or **`yarn`**. Use the following commands to install NO.AI SDK:

```sh
npm install @nest25/wallet-lib
OR
yarn add @nest25/wallet-lib
```

### Request

Here is an example of how to make a `txStatus` request using the NO.AI SDK:

{% code overflow="wrap" %}

```javascript
// import Nest SDK
import { Wallet } from 'nest25/wallet-lib';

// Create a new instance of the Wallet class
const wallet = new Wallet();

const main = async () => {
  // Get the status of a transaction
  const response = await wallet.txStatus(
    'sol',
    '4iDWwQDUoasbZZS9ARdSydrLdFqMcNC1RDfqarAQgbRXpFXty624PQ3Z3AMnoiioKLJyCwtfpG5owHLAcWFr9ywa',
  );
  // Print the response
  console.log(response);
};

main();
```

{% endcode %}

### Response

{% code overflow="wrap" %}

```sh
   { code: 1, result: 'confirmed' }
```

{% endcode %}

## Use Cases

* **Transaction Monitoring:** Developers can utilize the `txStatus` function to continuously monitor the progress of a transaction. By periodically querying the status, they can track its execution and take appropriate actions based on the returned result.
* **Error Handling:** The `txStatus` function can be utilized for error-handling scenarios. If the transaction fails or encounters an error, the function will return an error object in the response, allowing developers to handle and log the error appropriately.

<br>

###