@fleet-sdk/blockchain-providers 0.5.0 → 0.6.1

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @fleet-sdk/blockchain-providers
 
+## 0.6.1
+
+### Patch Changes
+
+- 208ac8e: Fix `Header#votes` encoding
+- a3d2a62: Export `BlockChainProviders` types
+- 506dfc4: [`ErgoGraphQLProvider`] Query Addresses/ErgoTrees by chunks of 20
+- 6245bc9: Export `request` and `createGqlOperation` utility functions
+- Updated dependencies [ece573c]
+  - @fleet-sdk/core@0.6.1
+
+## 0.6.0
+
+### Minor Changes
+
+- 6ef2c1b: Add custom `BigInt` mapping support
+- 9cdf4dd: Add transaction fetching
+
+### Patch Changes
+
+- 62b881b: Add exponential delay retrying strategy
+- 9ed3499: Add GraphQL operation URL override
+
 ## 0.5.0
 
 ### Patch Changes

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { BoxId, HexString, Base58String, TokenId, Box, BlockHeader, SignedTransaction, UnsignedTransaction, TransactionId } from '@fleet-sdk/common';
+import { BoxId, HexString, Base58String, TokenId, TransactionId, Box, DataInput, BlockHeader, SignedTransaction, UnsignedTransaction, ProverResult } from '@fleet-sdk/common';
 import { ErgoAddress } from '@fleet-sdk/core';
 
 declare global {
@@ -153,6 +153,18 @@ type RequireAtLeastOne<
 Except<ObjectType, KeysType>;
 
 type BoxSource = "blockchain" | "mempool" | "blockchain+mempool";
+type BoxWhere = {
+    /** Base16-encoded BoxId */
+    boxId?: BoxId;
+    /** Base16-encoded ErgoTree */
+    ergoTree?: HexString;
+    /** Base58-encoded address */
+    address?: ErgoAddress | Base58String;
+    /** Base16-encoded contract template hash */
+    templateHash?: HexString;
+    /**  Base16-encoded TokenId */
+    tokenId?: TokenId;
+};
 type BoxQuery<W extends BoxWhere> = {
     /** The query to filter boxes. */
     where: RequireAtLeastOne<W>;
@@ -162,24 +174,60 @@ type BoxQuery<W extends BoxWhere> = {
      */
     from?: BoxSource;
 };
-type HeaderQuery = {
-    take: number;
-};
-type BoxWhere = {
-    /** Base16-encoded BoxId */
-    boxId?: BoxId;
+type UnconfirmedTransactionWhere = {
+    /** Base16-encoded TransactionId */
+    transactionId?: TransactionId;
+    /** Base58-encoded address */
+    address?: ErgoAddress | Base58String;
     /** Base16-encoded ErgoTree */
     ergoTree?: HexString;
+};
+type ConfirmedTransactionWhere = {
+    /** Base16-encoded TransactionId */
+    transactionId?: TransactionId;
+    /** Base16-encoded HeaderID */
+    headerId?: HexString;
     /** Base58-encoded address */
     address?: ErgoAddress | Base58String;
-    /** Base16-encoded contract template hash */
-    templateHash?: HexString;
-    /**  Base16-encoded TokenId */
-    tokenId?: TokenId;
+    /** Base16-encoded ErgoTree */
+    ergoTree?: HexString;
+    /** Min blockchain height */
+    minHeight?: number;
+    /** Only returns relevant outputs for the selected filter params */
+    onlyRelevantOutputs?: boolean;
+};
+type TransactionQuery<W extends ConfirmedTransactionWhere> = {
+    /** The query to filter boxes. */
+    where: RequireAtLeastOne<W, keyof Omit<W, "minHeight" | "onlyRelevantOutputs">>;
+};
+type HeaderQuery = {
+    take: number;
 };
-type ChainProviderBox = Box<bigint> & {
+type ChainProviderBox<T> = Omit<Box, "value" | "assets"> & {
+    value: T;
+    assets: {
+        tokenId: TokenId;
+        amount: T;
+    }[];
     confirmed: boolean;
 };
+type TransactionOutput<T> = Omit<ChainProviderBox<T>, "confirmed">;
+type TransactionInput<T> = TransactionOutput<T> & {
+    spendingProof: ProverResult;
+};
+type ChainProviderUnconfirmedTransaction<T> = {
+    transactionId: TransactionId;
+    inputs: TransactionInput<T>[];
+    dataInputs: DataInput[];
+    outputs: TransactionOutput<T>[];
+    confirmed: boolean;
+    timestamp: number;
+};
+type ChainProviderConfirmedTransaction<T> = ChainProviderUnconfirmedTransaction<T> & {
+    height: number;
+    index: number;
+    headerId: HexString;
+};
 type TransactionEvaluationError = {
     success: false;
     message: string;
@@ -198,15 +246,31 @@ type TransactionReductionResult = TransactionEvaluationError | TransactionReduct
  * Represents a blockchain provider that can interact with the blockchain.
  * @template B The type of the box query used by the provider.
  */
-interface IBlockchainProvider<B extends BoxWhere> {
+interface IBlockchainProvider<I> {
     /**
      * Get boxes.
      */
-    getBoxes(query: BoxQuery<B>): Promise<ChainProviderBox[]>;
+    getBoxes(query: BoxQuery<BoxWhere>): Promise<ChainProviderBox<I>[]>;
     /**
      * Stream boxes.
      */
-    streamBoxes(query: BoxQuery<B>): AsyncIterable<ChainProviderBox[]>;
+    streamBoxes(query: BoxQuery<BoxWhere>): AsyncIterable<ChainProviderBox<I>[]>;
+    /**
+     * Stream unconfirmed transactions
+     */
+    streamUnconfirmedTransactions(query: TransactionQuery<UnconfirmedTransactionWhere>): AsyncIterable<ChainProviderUnconfirmedTransaction<I>[]>;
+    /**
+     * Get unconfirmed transactions
+     */
+    getUnconfirmedTransactions(query: TransactionQuery<UnconfirmedTransactionWhere>): Promise<ChainProviderUnconfirmedTransaction<I>[]>;
+    /**
+     * Stream confirmed transactions
+     */
+    streamConfirmedTransactions(query: TransactionQuery<ConfirmedTransactionWhere>): AsyncIterable<ChainProviderConfirmedTransaction<I>[]>;
+    /**
+     * Get confirmed transactions
+     */
+    getConfirmedTransactions(query: TransactionQuery<ConfirmedTransactionWhere>): Promise<ChainProviderConfirmedTransaction<I>[]>;
     /**
      * Get headers.
      */
@@ -225,9 +289,41 @@ interface IBlockchainProvider<B extends BoxWhere> {
     reduceTransaction(transaction: UnsignedTransaction): Promise<TransactionReductionResult>;
 }
 
-type Credentials = RequestCredentials;
-type Headers = HeadersInit;
-type Fetcher = typeof fetch;
+interface ParserLike {
+    parse<T>(text: string): T;
+    stringify<T>(value: T): string;
+}
+type Route = {
+    base: string;
+    path: string;
+    query?: Record<string, unknown>;
+};
+type URLLike = string | Route;
+type FallbackRetryOptions = {
+    fallbacks?: URLLike[];
+} & RetryOptions;
+type FetchOptions = {
+    parser?: ParserLike;
+    base?: string;
+    query?: Record<string, unknown>;
+    retry?: FallbackRetryOptions;
+    httpOptions?: RequestInit;
+};
+declare function request<T>(path: string, opt?: Partial<FetchOptions>): Promise<T>;
+type RetryOptions = {
+    attempts: number;
+    delay: number;
+};
+/**
+ * Retries an asynchronous operation a specified number of times with a delay
+ * growing exponentially between each attempt.
+ * @param operation - The asynchronous operation to retry.
+ * @param options - The retry options.
+ * @returns A promise that resolves to the result of the operation, or undefined
+ * if all attempts fail.
+ */
+declare function exponentialRetry<T>(operation: (remainingAttempts: number) => Promise<T>, { attempts, delay }: RetryOptions): Promise<T>;
+
 type GraphQLVariables = Record<string, unknown> | null;
 interface GraphQLError {
     message: string;
@@ -241,41 +337,64 @@ interface GraphQLErrorResponse {
     errors: GraphQLError[];
 }
 type GraphQLResponse<T = unknown> = GraphQLSuccessResponse<T> | GraphQLErrorResponse;
-type GraphQLOperation<R extends GraphQLResponse, V extends GraphQLVariables> = (variables?: V) => Promise<R>;
-interface ResponseParser {
-    parse<T>(text: string): T;
-    stringify<T>(value: T): string;
-}
+type GraphQLOperation<R extends GraphQLResponse, V extends GraphQLVariables> = (variables?: V, url?: string) => Promise<R>;
+type GraphQLRequiredUrlOperation<R extends GraphQLResponse, V extends GraphQLVariables> = (variables: V | undefined, url: string) => Promise<R>;
 interface GraphQLRequestOptions {
-    url: URL | string;
-    headers?: Headers;
-    parser?: ResponseParser;
-    fetcher?: Fetcher;
-    credentials?: Credentials;
+    url?: string;
+    parser?: ParserLike;
+    retry?: FallbackRetryOptions;
     throwOnNonNetworkErrors?: boolean;
+    httpOptions?: Omit<RequestInit, "body" | "method">;
 }
+declare function createGqlOperation<R, V extends GraphQLVariables = GraphQLVariables>(query: string, options: GraphQLRequestOptions & {
+    throwOnNonNetworkErrors: true;
+}): GraphQLOperation<GraphQLSuccessResponse<R>, V>;
+declare function createGqlOperation<R, V extends GraphQLVariables = GraphQLVariables>(query: string, options?: GraphQLRequestOptions & {
+    url: undefined;
+}): GraphQLRequiredUrlOperation<GraphQLResponse<R>, V>;
+declare function createGqlOperation<R, V extends GraphQLVariables = GraphQLVariables>(query: string, options: GraphQLRequestOptions & {
+    url: undefined;
+    throwOnNonNetworkErrors: true;
+}): GraphQLRequiredUrlOperation<GraphQLSuccessResponse<R>, V>;
+declare function createGqlOperation<R, V extends GraphQLVariables = GraphQLVariables>(query: string, options: GraphQLRequestOptions): GraphQLOperation<GraphQLResponse<R>, V>;
+declare function gql(query: TemplateStringsArray): string;
+declare function getOpName(query: string): string | undefined;
 
 type GraphQLBoxWhere = BoxWhere & {
-    /** Base16-encoded BoxIds */
-    boxIds?: HexString[];
     /** Base16-encoded ErgoTrees */
     ergoTrees?: HexString[];
     /** Base58-encoded addresses or `ErgoAddress` objects */
     addresses?: (Base58String | ErgoAddress)[];
 };
+type GraphQLConfirmedTransactionWhere = ConfirmedTransactionWhere & {
+    addresses?: (Base58String | ErgoAddress)[];
+    ergoTrees?: HexString[];
+};
+type GraphQLUnconfirmedTransactionWhere = UnconfirmedTransactionWhere & {
+    addresses?: (Base58String | ErgoAddress)[];
+    ergoTrees?: HexString[];
+};
 type GraphQLBoxQuery = BoxQuery<GraphQLBoxWhere>;
-type ErgoGraphQLRequestOptions = Omit<GraphQLRequestOptions, "throwOnNonNetworkError">;
-declare class ErgoGraphQLProvider implements IBlockchainProvider<BoxWhere> {
+type ErgoGraphQLRequestOptions = Omit<GraphQLRequestOptions, "throwOnNonNetworkErrors">;
+type BiMapper<T> = (value: string) => T;
+declare class ErgoGraphQLProvider<I = bigint> implements IBlockchainProvider<I> {
     #private;
-    constructor(url: string | URL);
-    constructor(url: ErgoGraphQLRequestOptions);
-    streamBoxes(query: GraphQLBoxQuery): AsyncGenerator<ChainProviderBox[]>;
-    getBoxes(query: GraphQLBoxQuery): Promise<ChainProviderBox[]>;
+    constructor(url: string);
+    constructor(options: ErgoGraphQLRequestOptions);
+    setUrl(url: string): ErgoGraphQLProvider<I>;
+    setBigIntMapper<M>(mapper: BiMapper<M>): ErgoGraphQLProvider<M>;
+    streamBoxes(query: GraphQLBoxQuery): AsyncGenerator<ChainProviderBox<I>[]>;
+    getBoxes(query: GraphQLBoxQuery): Promise<ChainProviderBox<I>[]>;
+    streamUnconfirmedTransactions(query: TransactionQuery<GraphQLUnconfirmedTransactionWhere>): AsyncIterable<ChainProviderUnconfirmedTransaction<I>[]>;
+    getUnconfirmedTransactions(query: TransactionQuery<GraphQLUnconfirmedTransactionWhere>): Promise<ChainProviderUnconfirmedTransaction<I>[]>;
+    streamConfirmedTransactions(query: TransactionQuery<GraphQLConfirmedTransactionWhere>): AsyncIterable<ChainProviderConfirmedTransaction<I>[]>;
+    getConfirmedTransactions(query: TransactionQuery<GraphQLConfirmedTransactionWhere>): Promise<ChainProviderConfirmedTransaction<I>[]>;
     getHeaders(query: HeaderQuery): Promise<BlockHeader[]>;
     createOperation<R, V extends GraphQLVariables = GraphQLVariables>(query: string, options?: Partial<ErgoGraphQLRequestOptions>): GraphQLOperation<GraphQLSuccessResponse<R>, V>;
     checkTransaction(signedTransaction: SignedTransaction): Promise<TransactionEvaluationResult>;
     submitTransaction(signedTransaction: SignedTransaction): Promise<TransactionEvaluationResult>;
     reduceTransaction(): Promise<TransactionReductionResult>;
 }
+declare function isRequestParam(obj: unknown): obj is ErgoGraphQLRequestOptions;
 
-export { ErgoGraphQLProvider, type ErgoGraphQLRequestOptions, type GraphQLBoxQuery, type GraphQLBoxWhere };
+export { type BoxQuery, type BoxSource, type BoxWhere, type ChainProviderBox, type ChainProviderConfirmedTransaction, type ChainProviderUnconfirmedTransaction, type ConfirmedTransactionWhere, ErgoGraphQLProvider, type ErgoGraphQLRequestOptions, type FallbackRetryOptions, type FetchOptions, type GraphQLBoxQuery, type GraphQLBoxWhere, type GraphQLConfirmedTransactionWhere, type GraphQLError, type GraphQLErrorResponse, type GraphQLOperation, type GraphQLRequestOptions, type GraphQLRequiredUrlOperation, type GraphQLResponse, type GraphQLSuccessResponse, type GraphQLUnconfirmedTransactionWhere, type GraphQLVariables, type HeaderQuery, type IBlockchainProvider, type ParserLike, type RetryOptions, type Route, type TransactionEvaluationError, type TransactionEvaluationResult, type TransactionEvaluationSuccess, type TransactionQuery, type TransactionReductionResult, type TransactionReductionSuccess, type URLLike, type UnconfirmedTransactionWhere, createGqlOperation, exponentialRetry, getOpName, gql, isRequestParam, request };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { BoxId, HexString, Base58String, TokenId, Box, BlockHeader, SignedTransaction, UnsignedTransaction, TransactionId } from '@fleet-sdk/common';
+import { BoxId, HexString, Base58String, TokenId, TransactionId, Box, DataInput, BlockHeader, SignedTransaction, UnsignedTransaction, ProverResult } from '@fleet-sdk/common';
 import { ErgoAddress } from '@fleet-sdk/core';
 
 declare global {
@@ -153,6 +153,18 @@ type RequireAtLeastOne<
 Except<ObjectType, KeysType>;
 
 type BoxSource = "blockchain" | "mempool" | "blockchain+mempool";
+type BoxWhere = {
+    /** Base16-encoded BoxId */
+    boxId?: BoxId;
+    /** Base16-encoded ErgoTree */
+    ergoTree?: HexString;
+    /** Base58-encoded address */
+    address?: ErgoAddress | Base58String;
+    /** Base16-encoded contract template hash */
+    templateHash?: HexString;
+    /**  Base16-encoded TokenId */
+    tokenId?: TokenId;
+};
 type BoxQuery<W extends BoxWhere> = {
     /** The query to filter boxes. */
     where: RequireAtLeastOne<W>;
@@ -162,24 +174,60 @@ type BoxQuery<W extends BoxWhere> = {
      */
     from?: BoxSource;
 };
-type HeaderQuery = {
-    take: number;
-};
-type BoxWhere = {
-    /** Base16-encoded BoxId */
-    boxId?: BoxId;
+type UnconfirmedTransactionWhere = {
+    /** Base16-encoded TransactionId */
+    transactionId?: TransactionId;
+    /** Base58-encoded address */
+    address?: ErgoAddress | Base58String;
     /** Base16-encoded ErgoTree */
     ergoTree?: HexString;
+};
+type ConfirmedTransactionWhere = {
+    /** Base16-encoded TransactionId */
+    transactionId?: TransactionId;
+    /** Base16-encoded HeaderID */
+    headerId?: HexString;
     /** Base58-encoded address */
     address?: ErgoAddress | Base58String;
-    /** Base16-encoded contract template hash */
-    templateHash?: HexString;
-    /**  Base16-encoded TokenId */
-    tokenId?: TokenId;
+    /** Base16-encoded ErgoTree */
+    ergoTree?: HexString;
+    /** Min blockchain height */
+    minHeight?: number;
+    /** Only returns relevant outputs for the selected filter params */
+    onlyRelevantOutputs?: boolean;
+};
+type TransactionQuery<W extends ConfirmedTransactionWhere> = {
+    /** The query to filter boxes. */
+    where: RequireAtLeastOne<W, keyof Omit<W, "minHeight" | "onlyRelevantOutputs">>;
+};
+type HeaderQuery = {
+    take: number;
 };
-type ChainProviderBox = Box<bigint> & {
+type ChainProviderBox<T> = Omit<Box, "value" | "assets"> & {
+    value: T;
+    assets: {
+        tokenId: TokenId;
+        amount: T;
+    }[];
     confirmed: boolean;
 };
+type TransactionOutput<T> = Omit<ChainProviderBox<T>, "confirmed">;
+type TransactionInput<T> = TransactionOutput<T> & {
+    spendingProof: ProverResult;
+};
+type ChainProviderUnconfirmedTransaction<T> = {
+    transactionId: TransactionId;
+    inputs: TransactionInput<T>[];
+    dataInputs: DataInput[];
+    outputs: TransactionOutput<T>[];
+    confirmed: boolean;
+    timestamp: number;
+};
+type ChainProviderConfirmedTransaction<T> = ChainProviderUnconfirmedTransaction<T> & {
+    height: number;
+    index: number;
+    headerId: HexString;
+};
 type TransactionEvaluationError = {
     success: false;
     message: string;
@@ -198,15 +246,31 @@ type TransactionReductionResult = TransactionEvaluationError | TransactionReduct
  * Represents a blockchain provider that can interact with the blockchain.
  * @template B The type of the box query used by the provider.
  */
-interface IBlockchainProvider<B extends BoxWhere> {
+interface IBlockchainProvider<I> {
     /**
      * Get boxes.
      */
-    getBoxes(query: BoxQuery<B>): Promise<ChainProviderBox[]>;
+    getBoxes(query: BoxQuery<BoxWhere>): Promise<ChainProviderBox<I>[]>;
     /**
      * Stream boxes.
      */
-    streamBoxes(query: BoxQuery<B>): AsyncIterable<ChainProviderBox[]>;
+    streamBoxes(query: BoxQuery<BoxWhere>): AsyncIterable<ChainProviderBox<I>[]>;
+    /**
+     * Stream unconfirmed transactions
+     */
+    streamUnconfirmedTransactions(query: TransactionQuery<UnconfirmedTransactionWhere>): AsyncIterable<ChainProviderUnconfirmedTransaction<I>[]>;
+    /**
+     * Get unconfirmed transactions
+     */
+    getUnconfirmedTransactions(query: TransactionQuery<UnconfirmedTransactionWhere>): Promise<ChainProviderUnconfirmedTransaction<I>[]>;
+    /**
+     * Stream confirmed transactions
+     */
+    streamConfirmedTransactions(query: TransactionQuery<ConfirmedTransactionWhere>): AsyncIterable<ChainProviderConfirmedTransaction<I>[]>;
+    /**
+     * Get confirmed transactions
+     */
+    getConfirmedTransactions(query: TransactionQuery<ConfirmedTransactionWhere>): Promise<ChainProviderConfirmedTransaction<I>[]>;
     /**
      * Get headers.
      */
@@ -225,9 +289,41 @@ interface IBlockchainProvider<B extends BoxWhere> {
     reduceTransaction(transaction: UnsignedTransaction): Promise<TransactionReductionResult>;
 }
 
-type Credentials = RequestCredentials;
-type Headers = HeadersInit;
-type Fetcher = typeof fetch;
+interface ParserLike {
+    parse<T>(text: string): T;
+    stringify<T>(value: T): string;
+}
+type Route = {
+    base: string;
+    path: string;
+    query?: Record<string, unknown>;
+};
+type URLLike = string | Route;
+type FallbackRetryOptions = {
+    fallbacks?: URLLike[];
+} & RetryOptions;
+type FetchOptions = {
+    parser?: ParserLike;
+    base?: string;
+    query?: Record<string, unknown>;
+    retry?: FallbackRetryOptions;
+    httpOptions?: RequestInit;
+};
+declare function request<T>(path: string, opt?: Partial<FetchOptions>): Promise<T>;
+type RetryOptions = {
+    attempts: number;
+    delay: number;
+};
+/**
+ * Retries an asynchronous operation a specified number of times with a delay
+ * growing exponentially between each attempt.
+ * @param operation - The asynchronous operation to retry.
+ * @param options - The retry options.
+ * @returns A promise that resolves to the result of the operation, or undefined
+ * if all attempts fail.
+ */
+declare function exponentialRetry<T>(operation: (remainingAttempts: number) => Promise<T>, { attempts, delay }: RetryOptions): Promise<T>;
+
 type GraphQLVariables = Record<string, unknown> | null;
 interface GraphQLError {
     message: string;
@@ -241,41 +337,64 @@ interface GraphQLErrorResponse {
     errors: GraphQLError[];
 }
 type GraphQLResponse<T = unknown> = GraphQLSuccessResponse<T> | GraphQLErrorResponse;
-type GraphQLOperation<R extends GraphQLResponse, V extends GraphQLVariables> = (variables?: V) => Promise<R>;
-interface ResponseParser {
-    parse<T>(text: string): T;
-    stringify<T>(value: T): string;
-}
+type GraphQLOperation<R extends GraphQLResponse, V extends GraphQLVariables> = (variables?: V, url?: string) => Promise<R>;
+type GraphQLRequiredUrlOperation<R extends GraphQLResponse, V extends GraphQLVariables> = (variables: V | undefined, url: string) => Promise<R>;
 interface GraphQLRequestOptions {
-    url: URL | string;
-    headers?: Headers;
-    parser?: ResponseParser;
-    fetcher?: Fetcher;
-    credentials?: Credentials;
+    url?: string;
+    parser?: ParserLike;
+    retry?: FallbackRetryOptions;
     throwOnNonNetworkErrors?: boolean;
+    httpOptions?: Omit<RequestInit, "body" | "method">;
 }
+declare function createGqlOperation<R, V extends GraphQLVariables = GraphQLVariables>(query: string, options: GraphQLRequestOptions & {
+    throwOnNonNetworkErrors: true;
+}): GraphQLOperation<GraphQLSuccessResponse<R>, V>;
+declare function createGqlOperation<R, V extends GraphQLVariables = GraphQLVariables>(query: string, options?: GraphQLRequestOptions & {
+    url: undefined;
+}): GraphQLRequiredUrlOperation<GraphQLResponse<R>, V>;
+declare function createGqlOperation<R, V extends GraphQLVariables = GraphQLVariables>(query: string, options: GraphQLRequestOptions & {
+    url: undefined;
+    throwOnNonNetworkErrors: true;
+}): GraphQLRequiredUrlOperation<GraphQLSuccessResponse<R>, V>;
+declare function createGqlOperation<R, V extends GraphQLVariables = GraphQLVariables>(query: string, options: GraphQLRequestOptions): GraphQLOperation<GraphQLResponse<R>, V>;
+declare function gql(query: TemplateStringsArray): string;
+declare function getOpName(query: string): string | undefined;
 
 type GraphQLBoxWhere = BoxWhere & {
-    /** Base16-encoded BoxIds */
-    boxIds?: HexString[];
     /** Base16-encoded ErgoTrees */
     ergoTrees?: HexString[];
     /** Base58-encoded addresses or `ErgoAddress` objects */
     addresses?: (Base58String | ErgoAddress)[];
 };
+type GraphQLConfirmedTransactionWhere = ConfirmedTransactionWhere & {
+    addresses?: (Base58String | ErgoAddress)[];
+    ergoTrees?: HexString[];
+};
+type GraphQLUnconfirmedTransactionWhere = UnconfirmedTransactionWhere & {
+    addresses?: (Base58String | ErgoAddress)[];
+    ergoTrees?: HexString[];
+};
 type GraphQLBoxQuery = BoxQuery<GraphQLBoxWhere>;
-type ErgoGraphQLRequestOptions = Omit<GraphQLRequestOptions, "throwOnNonNetworkError">;
-declare class ErgoGraphQLProvider implements IBlockchainProvider<BoxWhere> {
+type ErgoGraphQLRequestOptions = Omit<GraphQLRequestOptions, "throwOnNonNetworkErrors">;
+type BiMapper<T> = (value: string) => T;
+declare class ErgoGraphQLProvider<I = bigint> implements IBlockchainProvider<I> {
     #private;
-    constructor(url: string | URL);
-    constructor(url: ErgoGraphQLRequestOptions);
-    streamBoxes(query: GraphQLBoxQuery): AsyncGenerator<ChainProviderBox[]>;
-    getBoxes(query: GraphQLBoxQuery): Promise<ChainProviderBox[]>;
+    constructor(url: string);
+    constructor(options: ErgoGraphQLRequestOptions);
+    setUrl(url: string): ErgoGraphQLProvider<I>;
+    setBigIntMapper<M>(mapper: BiMapper<M>): ErgoGraphQLProvider<M>;
+    streamBoxes(query: GraphQLBoxQuery): AsyncGenerator<ChainProviderBox<I>[]>;
+    getBoxes(query: GraphQLBoxQuery): Promise<ChainProviderBox<I>[]>;
+    streamUnconfirmedTransactions(query: TransactionQuery<GraphQLUnconfirmedTransactionWhere>): AsyncIterable<ChainProviderUnconfirmedTransaction<I>[]>;
+    getUnconfirmedTransactions(query: TransactionQuery<GraphQLUnconfirmedTransactionWhere>): Promise<ChainProviderUnconfirmedTransaction<I>[]>;
+    streamConfirmedTransactions(query: TransactionQuery<GraphQLConfirmedTransactionWhere>): AsyncIterable<ChainProviderConfirmedTransaction<I>[]>;
+    getConfirmedTransactions(query: TransactionQuery<GraphQLConfirmedTransactionWhere>): Promise<ChainProviderConfirmedTransaction<I>[]>;
     getHeaders(query: HeaderQuery): Promise<BlockHeader[]>;
     createOperation<R, V extends GraphQLVariables = GraphQLVariables>(query: string, options?: Partial<ErgoGraphQLRequestOptions>): GraphQLOperation<GraphQLSuccessResponse<R>, V>;
     checkTransaction(signedTransaction: SignedTransaction): Promise<TransactionEvaluationResult>;
     submitTransaction(signedTransaction: SignedTransaction): Promise<TransactionEvaluationResult>;
     reduceTransaction(): Promise<TransactionReductionResult>;
 }
+declare function isRequestParam(obj: unknown): obj is ErgoGraphQLRequestOptions;
 
-export { ErgoGraphQLProvider, type ErgoGraphQLRequestOptions, type GraphQLBoxQuery, type GraphQLBoxWhere };
+export { type BoxQuery, type BoxSource, type BoxWhere, type ChainProviderBox, type ChainProviderConfirmedTransaction, type ChainProviderUnconfirmedTransaction, type ConfirmedTransactionWhere, ErgoGraphQLProvider, type ErgoGraphQLRequestOptions, type FallbackRetryOptions, type FetchOptions, type GraphQLBoxQuery, type GraphQLBoxWhere, type GraphQLConfirmedTransactionWhere, type GraphQLError, type GraphQLErrorResponse, type GraphQLOperation, type GraphQLRequestOptions, type GraphQLRequiredUrlOperation, type GraphQLResponse, type GraphQLSuccessResponse, type GraphQLUnconfirmedTransactionWhere, type GraphQLVariables, type HeaderQuery, type IBlockchainProvider, type ParserLike, type RetryOptions, type Route, type TransactionEvaluationError, type TransactionEvaluationResult, type TransactionEvaluationSuccess, type TransactionQuery, type TransactionReductionResult, type TransactionReductionSuccess, type URLLike, type UnconfirmedTransactionWhere, createGqlOperation, exponentialRetry, getOpName, gql, isRequestParam, request };