transaction_utils

Utility class for transaction-related operations.

Code Example

from human_protocol_sdk.constants import ChainId
from human_protocol_sdk.transaction import TransactionUtils, TransactionFilter

print(
    TransactionUtils.get_transactions(
        TransactionFilter(
            chain_id=ChainId.POLYGON_AMOY,
            from_address="0x1234567890123456789012345678901234567890",
            to_address="0x0987654321098765432109876543210987654321",
            start_date=datetime.datetime(2023, 5, 8),
            end_date=datetime.datetime(2023, 6, 8),
        )
    )
)

Module

class human_protocol_sdk.transaction.transaction_utils.InternalTransaction(from_address, to_address, value, method, receiver, escrow, token)

Bases: object

__init__(from_address, to_address, value, method, receiver, escrow, token)

class human_protocol_sdk.transaction.transaction_utils.TransactionData(chain_id, block, tx_hash, from_address, to_address, timestamp, value, method, receiver, escrow, token, internal_transactions)

Bases: object

__init__(chain_id, block, tx_hash, from_address, to_address, timestamp, value, method, receiver, escrow, token, internal_transactions)

class human_protocol_sdk.transaction.transaction_utils.TransactionUtils

Bases: object

A utility class that provides additional transaction-related functionalities.

static get_transaction(chain_id, hash, options=None)

Returns the transaction for a given hash.

• Parameters:

  • chain_id (ChainId) – Network in which the transaction was executed

  • hash (str) – Hash of the transaction

  • options (Optional[SubgraphOptions]) – Optional config for subgraph requests

• Return type: Optional[TransactionData]

• Returns: Transaction data

• Example:

  from human_protocol_sdk.constants import ChainId
  from human_protocol_sdk.transaction import TransactionUtils
  
  print(
      TransactionUtils.get_transaction(
          ChainId.POLYGON_AMOY,
          "0x1234567890123456789012345678901234567891"
      )
  )

static get_transactions(filter, options=None)

Get an array of transactions based on the specified filter parameters.

• Parameters:

  • filter (TransactionFilter) – Object containing all the necessary parameters to filter (chain_id, from_address, to_address, start_date, end_date, start_block, end_block, method, escrow, token, first, skip, order_direction)

  • options (Optional[SubgraphOptions]) – Optional config for subgraph requests

• Return type: List[TransactionData]

• Returns: List of transactions

• Example:

  from human_protocol_sdk.constants import ChainId
  from human_protocol_sdk.transaction import TransactionUtils, TransactionFilter
  
  print(
      TransactionUtils.get_transactions(
          TransactionFilter(
              chain_id=ChainId.POLYGON_AMOY,
              from_address="0x1234567890123456789012345678901234567890",
              to_address="0x0987654321098765432109876543210987654321",
              method="transfer",
              escrow="0x0987654321098765432109876543210987654321",
              start_date=datetime.datetime(2023, 5, 8),
              end_date=datetime.datetime(2023, 6, 8),
          )
      )
  )

exception human_protocol_sdk.transaction.transaction_utils.TransactionUtilsError

Bases: Exception

Raises when some error happens when getting data from subgraph.