Feature/dd tools

[EvgenKor]

The changes introduced by that PR are intended to support direct deposits

• Implemented a universal method directDeposit to deposit funds to the current account via direct deposit scheme (both token and native scheme are supported through the type parameter: DirectDepositType.Token\DirectDepositType.Native).

public async directDeposit(
    type: DirectDepositType, // DirectDepositType.Token or DirectDepositType.Native
    fromAddress: string,  // sender address to check approval and using as fallback address
    amount: bigint, // in pool resolution
    sendTxCallback: (tx: PreparedTransaction) => Promise<string>, // should returns txHash
  ): Promise<void>;

sendTxCallback will invoked to send transaction and PreparedTransaction is defined as following:

export interface PreparedTransaction {
    to: string; // dd queue contract address
    amount: bigint; // nonzero for native direct deposits
    data: string; // 0x-based hex string of encoded transaction
}

• introduced new optional parameters in Pool configuration: isNative (boolean, should be set as true for WETH-pools to accept native direct deposits) and ddSubgraph (string, the subgraph name to fetching pending direct deposits, currently supported zkbob-bob-goerli, zkbob-eth-goerli and zkbob-bob-goerli-opt)
• added method getPendingDDs to fetch pending direct deposits in the queue (available just for pools with configured subgraphs). It returns an array of DirectDeposit objects:

interface DirectDeposit {
    id: bigint;           // DD queue unique identifier
    state: DirectDepositState; // getPendingDDs will always return records
                               // with `DirectDepositState.Queued` state
    amount: bigint;       // in pool resolution
    destination: string;  // zk-addresss
    fallback: string;     // 0x-address to refund DD
    timestamp: number;    // when it was created
    queueTxHash: string;  // transaction hash to the queue
}

• added method directDepositFee which returns fee for the direct deposit in pool resolution (as returned by queue contract)
• added method directDepositContract to retrieve DD queue contract address from the pool
• added method tokenSellerContract to retrieve token seller contract address from the pool (also available in account-lessmode)

This PR can be tested with associated console branch. Pending direct deposits are currently fetched in BOB-goerli, WETH-goerli and BOB-op-goerli pool

Please note BOB-goerli pool is currently migrated on USDC and require associated changes in denominator processing, implemented in #147, so testing that branch on BOB-goerli pool is undesirable

[EvgenKor]

The latest changes:

• added support for the direct deposit limits (the data fetched from the contract directly until relayer doesn't support it)
• added ability to use subgraph with arbitrary name. Currently deployed and tested: zkbob-bob-goerli, zkbob-eth-goerli and zkbob-bob-goerli-opt

[AllFi]

Looks good to me