> For the complete documentation index, see [llms.txt](https://ai-agent-sdk-docs.crypto.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ai-agent-sdk-docs.crypto.com/crypto.com-developer-platform/on-chain-developer-platform-client-sdk/transaction-module.md).

# Transaction Module

Transaction module handles blockchain transaction operations and queries.

To learn more about how to use the AI Agent SDK to interact with the transaction module, please visit [AI Agent SDK Transaction Queries](/crypto.com-ai-agent-sdk/core-concepts-overview/blockchain-functions/transaction-queries.md).

#### 3.1 Get Transaction By Hash

Fetches a transaction by hash.

{% tabs %}
{% tab title="Python" %}
Function Name

```python
get_transaction_by_hash
```

{% tabs %}
{% tab title="Query" %}

* Arguments

  ```python
  hash (str): The hash of the transaction.
  ```
* Example Code

  ```python
  from crypto_com_developer_platform_client import Transaction

  tx = Transaction.get_transaction_by_hash('example-hash')
  print(tx)
  ```

{% endtab %}

{% tab title="Response" %}

* Returns

  ```python
  The transaction details.
  ```
* Errors

  ```python
  ValueError: If the Transaction class is not initialized with a Client instance.
  ```
* Example Return

  ```python
  {'status': 'Success', 'data': {'transaction': {'_type': 'TransactionResponse', 'accessList': example-list, 'blockNumber': example-block-number, 'blockHash': 'example-hash', 'blobVersionedHashes': example-hashes, 'chainId': 'example-chain0id', 'data': 'example-data', 'from': 'example-from', 'gasLimit': 'example-gas-limit', 'gasPrice': 'example-gas-price', 'hash': 'example-hash', 'maxFeePerGas': 'example-fee', 'maxPriorityFeePerGas': 'example-fee', 'maxFeePerBlobGas': example-fee, 'nonce': example-nonce, 'signature': {'_type': 'signature', 'networkV': 'example-V', 'r': 'example-r', 's': 'example-s', 'v': example-v}, 'to': 'example-to', 'index': example-index, 'type': example-type, 'value': 'example-value'}}}
  ```

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="TypeScript" %}
Function Name

```typescript
getTransactionByHash
```

{% tabs %}
{% tab title="Query" %}

* Arguments

  ```typescript
  {string} txHash: Transaction hash.
  ```
* Example Code

  ```typescript
  import { Transaction } from '@crypto.com/developer-platform-client';

  const tx = await Transaction.getTransactionByHash('example-hash');
  console.log(tx);
  ```

{% endtab %}

{% tab title="Response" %}

* Returns

  ```typescript
  {Promise<ApiResponse<TransactionByHash>>}: A promise that resolves to the transaction result
  ```
* Example Return

  ```typescript
  {
    status: 'Success',
    data: {
      transaction: {
        _type: 'TransactionResponse',
        accessList: example-list,
        blockNumber: example-block-number,
        blockHash: 'example-hash',
        blobVersionedHashes: example-hashes,
        chainId: 'example-chain-id',
        data: 'example-data',
        from: 'example-from',
        gasLimit: 'example-gas-limit',
        gasPrice: 'example-gas-price',
        hash: 'example-hash',
        maxFeePerGas: 'example-fee',
        maxPriorityFeePerGas: 'example-fee',
        maxFeePerBlobGas: example-fee,
        nonce: example-nonce,
        signature: [example-singature],
        to: 'example-to',
        index: example-index,
        type: example-type,
        value: 'example-value'
      }
    }
  }
  ```

{% endtab %}
{% endtabs %}
{% endtab %}
{% endtabs %}

#### 3.2 Get Transaction Status

Fetches transaction status by hash.

{% tabs %}
{% tab title="Python" %}
Function Name

```python
get_transaction_status
```

{% tabs %}
{% tab title="Query" %}

* Arguments

  ```python
  hash (str): The hash of the transaction.
  ```
* Example Code

  ```python
  from crypto_com_developer_platform_client import Transaction

  status = Transaction.get_transaction_status('example-hash')
  print(status)
  ```

{% endtab %}

{% tab title="Response" %}

* Returns

  ```python
  The transaction status.
  ```
* Errors

  ```python
  ValueError: If the Transaction class is not initialized with a Client instance.
  ```
* Example Return

  ```python
  {'status': 'Success', 'data': {'status': 1}}
  ```

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="TypeScript" %}
Function Name

```typescript
getTransactionStatus
```

{% tabs %}
{% tab title="Query" %}

* Arguments

  ```typescript
  {string} txHash: Transaction hash.
  ```
* Example Code

  ```typescript
  import { Transaction } from '@crypto.com/developer-platform-client';

  const status = await Transaction.getTransactionStatus('example-hash');
  console.log(status);
  ```

{% endtab %}

{% tab title="Response" %}

* Returns

  ```typescript
  Promise<ApiResponse<TransactionStatus>>}: A promise that resolves to the transaction status.
  ```
* Example Return

  ```typescript
  { status: 'Success', data: { status: 1 } }
  ```

{% endtab %}
{% endtabs %}
{% endtab %}
{% endtabs %}

#### 3.3 Get Transaction Count

Fetches transaction count for a wallet.

{% tabs %}
{% tab title="Python" %}
Function Name

```python
get_transaction_count
```

{% tabs %}
{% tab title="Query" %}

* Arguments

  ```python
  wallet_address (str): The address to get the transaction count for.
  ```
* Example Code

  ```python
  from crypto_com_developer_platform_client import Transaction

  count = Transaction.get_transaction_count('example-wallet')
  print(count)
  ```

{% endtab %}

{% tab title="Response" %}

* Returns

  ```python
  The transaction count for the wallet address.
  ```
* Errors

  ```python
  ValueError: If the Transaction class is not initialized with a Client instance.
  ```
* Example Return

  ```python
  {'status': 'Success', 'data': {'count': example-count}}
  ```

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="TypeScript" %}
Function Name

```typescript
getTransactionCount
```

{% tabs %}
{% tab title="Query" %}

* Arguments

  ```typescript
  {string} walletAddress: Wallet address.
  ```
* Example Code

  ```typescript
  import { Transaction } from '@crypto.com/developer-platform-client';

  const count = await Transaction.getTransactionCount('example-address');
  console.log(count);
  ```

{% endtab %}

{% tab title="Response" %}

* Returns

  ```typescript
  {Promise<ApiResponse<TransactionCount>>}: A promise that resolves to the transaction count.
  ```
* Example Return

  ```typescript
  { status: 'Success', data: { count: example-number } }
  ```

{% endtab %}
{% endtabs %}
{% endtab %}
{% endtabs %}

#### 3.4 Get Gas Price

Fetches current gas price.

{% tabs %}
{% tab title="Python" %}
Function Name

```python
get_gas_price
```

{% tabs %}
{% tab title="Query" %}

* Example Code

  ```python
  from crypto_com_developer_platform_client import Transaction

  price = Transaction.get_gas_price()
  print(price)
  ```

{% endtab %}

{% tab title="Response" %}

* Returns

  ```python
  The current gas price.
  ```
* Errors

  ```python
  ValueError: If the Transaction class is not initialized with a Client instance.
  ```
* Example Return

  ```python
  {'status': 'Success', 'data': {'gasPrice': 'example-gas-price'}}
  ```

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="TypeScript" %}
Function Name

```typescript
getGasPrice
```

{% tabs %}
{% tab title="Query" %}

* Example Code

  ```typescript
  import { Transaction } from '@crypto.com/developer-platform-client';

  const gasPrice = await Transaction.getGasPrice();
  console.log(gasPrice);
  ```

{% endtab %}

{% tab title="Response" %}

* Returns

  ```typescript
  {Promise<ApiResponse<GasPrice>>}: A promise that resolves to the gas price.
  ```
* Example Return

  ```typescript
  { status: 'Success', data: { gasPrice: 'example-gas-price' } }
  ```

{% endtab %}
{% endtabs %}
{% endtab %}
{% endtabs %}

#### 3.5 Get Fee Data

Fetches current fee data.

{% tabs %}
{% tab title="Python" %}
Function Name

```python
get_fee_data
```

{% tabs %}
{% tab title="Query" %}

* Example Code

  ```python
  from crypto_com_developer_platform_client import Transaction

  data = Transaction.get_fee_data()
  print(data)
  ```

{% endtab %}

{% tab title="Response" %}

* Returns

  ```python
  The current fee data.
  ```
* Errors

  ```python
  ValueError: If the Transaction class is not initialized with a Client instance.
  ```
* Example Return

  ```python
  {'status': 'Success', 'data': {'feeData': {'_type': 'FeeData', 'gasPrice': 'example-gas-price', 'maxFeePerGas': 'example-fee', 'maxPriorityFeePerGas': 'example-fee'}}}
  ```

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="TypeScript" %}
Function Name

```typescript
getFeeData
```

{% tabs %}
{% tab title="Query" %}

* Example Code

  ```typescript
  import { Transaction } from '@crypto.com/developer-platform-client';

  const feeData = await Transaction.getFeeData();
  console.log(feeData);
  ```

{% endtab %}

{% tab title="Response" %}

* Returns

  ```typescript
  {Promise<ApiResponse<FeeData>>}: A promise that resolves to the fee data.
  ```
* Example Return

  ```typescript
  {
    status: 'Success',
    data: {
      feeData: {
        _type: 'FeeData',
        gasPrice: 'example-gas-price',
        maxFeePerGas: 'example-fee',
        maxPriorityFeePerGas: 'example-fee'
      }
    }
  }
  ```

{% endtab %}
{% endtabs %}
{% endtab %}
{% endtabs %}

#### 3.6 Estimate Gas

Estimates gas for a transaction.

{% tabs %}
{% tab title="Python" %}
Function Name

```python
estimate_gas
```

{% tabs %}
{% tab title="Query" %}

* Arguments

  ```python
  payload (dict): The payload for gas estimation, including fields like `from`, `to`, `value`, `gasLimit`, `gasPrice`, `data`.
  ```
* Example Code

  ```python
  from crypto_com_developer_platform_client import Transaction

  gas = Transaction.estimate_gas({'from': 'example-from', 'to': 'example-to', 'value': 'example-value', 'gasLimit': 'example-gas-limit', 'gasPrice': 'example-gas-price', 'data': 'example-data'})
  print(gas)
  ```

{% endtab %}

{% tab title="Response" %}

* Returns

  ```python
  The estimated gas information.
  ```
* Errors

  ```python
  ValueError: If the Transaction class is not initialized with a Client instance.
  ```
* Example Return

  ```python
  {'status': 'Success', 'data': {'gasLimit': 'example-gas-limit'}}
  ```

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="TypeScript" %}
Function Name

```typescript
estimateGas
```

{% tabs %}
{% tab title="Query" %}

* Arguments

  ```typescript
  {object} payload: Transaction payload (from, to, value, gasLimit, gasPrice, data).
  ```
* Example Code

  ```typescript
  import { Transaction } from '@crypto.com/developer-platform-client';

  const estimation = await Transaction.estimateGas({from: 'example-from', to: 'example-to', value: 'example-value', gasLimit: 'example-gas-limit', gasPrice: 'example-gas-price', data: 'example-data'});
  console.log(estimation);
  ```

{% endtab %}

{% tab title="Response" %}

* Returns

  ```typescript
  {Promise<ApiResponse<EstimateGasData>>}: A promise that resolves to the estimate gas data.
  ```
* Example Return

  ```typescript
  { status: 'Success', data: { gasLimit: 'example-gas-limit' } }
  ```

{% endtab %}
{% endtabs %}
{% endtab %}
{% endtabs %}