com.openelements.hiero.base.mirrornode.TransactionRepository Maven / Gradle / Ivy

Go to download
package com.openelements.hiero.base.mirrornode;

import com.hedera.hashgraph.sdk.AccountId;
import com.openelements.hiero.base.HieroException;
import com.openelements.hiero.base.data.Page;
import com.openelements.hiero.base.data.TransactionInfo;
import java.util.Objects;
import java.util.Optional;
import org.jspecify.annotations.NonNull;

/**
 * Interface for interacting with transactions on a Hiero network. This interface provides methods for querying
 * transactions.
 */
public interface TransactionRepository {
    /**
     * Find all transactions associated with a specific account.
     *
     * @param accountId id of the account
     * @return page of transactions
     * @throws HieroException if the search fails
     */
    @NonNull
    Page findByAccount(@NonNull AccountId accountId) throws HieroException;

    /**
     * Find all transactions associated with a specific account.
     *
     * @param accountId id of the account as a string
     * @return page of transactions
     * @throws HieroException if the search fails
     */
    @NonNull
    default Page findByAccount(@NonNull String accountId) throws HieroException {
        Objects.requireNonNull(accountId, "accountId must not be null");
        return findByAccount(AccountId.fromString(accountId));
    }

    /**
     * Find a specific transaction by its ID.
     *
     * @param transactionId the transaction ID
     * @return Optional containing the transaction if found
     * @throws HieroException if the search fails
     */
    @NonNull
    Optional findById(@NonNull String transactionId) throws HieroException;
}