# Direct Deposits

Direct deposits allow other dApps and partners to make direct zkBob deposits by knowing the receiver's zk-address, without dealing with zk-cryptography. This greatly simplifies integration with other dApps and smart contracts

## <mark style="background-color:green;">Sending Direct Deposit</mark>

You can deposit to your account via the direct deposit scheme.

{% hint style="warning" %}
Direct deposit processing can take up to 20 minutes.
{% endhint %}

<pre class="language-typescript"><code class="lang-typescript"><strong>async directDeposit(
</strong>    type: DirectDepositType,
    fromAddress: string,
    amount: bigint,
    sendTxCallback: (tx: PreparedTransaction) => Promise&#x3C;string>,
    blockNumber?: number,
): Promise&#x3C;void>
</code></pre>

### Parameters

`type` - [direct deposit type](/implementation/client-library-sdk/common-types.md#direct-deposit-type) (token or native)

{% hint style="warning" %}
For DD with `DirectDepositType.Token` type you must ensure the [direct deposit contract address](#getting-direct-deposit-contract) has the allowance to spend your tokens. Before sending the direct deposit  you must approve the required amount of tokens (do not forget the fee).
{% endhint %}

{% hint style="info" %}
`DirectDepositType.Native` is only available for pools which serve native wrapped tokens like WETH. Such pools must have `isNative = true` in the [Client Configuration](/implementation/client-library-sdk/configuration/initializing-the-client/client-configuration.md)
{% endhint %}

`fromAddress` - the `0x`-address which will be used to deposit funds

`amount` - token amount to deposit into an account (in pool dimension)

{% hint style="warning" %}
The direct deposit fee will be fetched and added to the `amount` under the hood. Do not include it yourself.
{% endhint %}

`sendTxCallback` - a callback with transaction data (of type [`PreparedTransaction`](/implementation/client-library-sdk/common-types.md#transaction-to-be-send)) which should be sent by the user. After sending the user should return a transaction hash.

`blockNumber` - the client will wait until the internal provider becomes synced with that block before input account balance validation. The waiting interval is hardcoded to 60 seconds. If the provider doesn't become synced within that interval the transaction will be sent anyway.

### Example

```typescript
const myAddress = '0x49C92c016d2c7A245aAF5351BD932D9D61536eC0';
await zkClient.directDeposit(
    DirectDepositType.Token,
    myAddress,
    50000000000n,  // 50 BOB
    async (tx: PreparedTransaction) => {
      const txObject: TransactionConfig = {
        from: myAddress,
        to: tx.to,
        value: tx.amount.toString(),
        data: tx.data,
      };

      const gas = await this.web3.eth.estimateGas(txObject);
      const gasPrice = Number(await this.web3.eth.getGasPrice());
      txObject.gas = gas;
      txObject.gasPrice = `0x${BigInt(gasPrice).toString(16)}`;
      txObject.nonce = await this.web3.eth.getTransactionCount(address);
  
      const signedTx = await this.web3.eth.signTransaction(txObject);
      const receipt = await this.web3.eth.sendSignedTransaction(signedTx.raw);
  
      return receipt.transactionHash;
    }
);
```

## <mark style="background-color:green;">Getting Pending Direct Deposits</mark>

Until sent direct deposits are processed and included in the privacy pool you can fetch the queued DD transactions belonging to your account.

{% hint style="warning" %}
Direct deposit processing can take up to 20 minutes.
{% endhint %}

```typescript
public async getPendingDDs(): Promise<DirectDeposit[]>
```

### Returns

`Promise` returns array of pending [DirectDeposit](/implementation/client-library-sdk/common-types.md#direct-deposit)s.

### Example

```typescript
const pendingDDs = await zkClient.getPendingDDs();
console.log(`You have ${pendingDDs.length} pending direct deposit(s) in queue`);
// output: You have 3 pending direct deposit(s) in queue
```

## <mark style="background-color:green;">Getting Direct Deposit Fee</mark>

Use the associated accountless mode routine [`directDepositFee`](/implementation/client-library-sdk/account-less-mode-operations/transaction-fees.md#getting-direct-deposit-fee)

## <mark style="background-color:green;">Getting Direct Deposit Contract</mark>

The DD contract is a part of the privacy pool solution - so each pool has own direct deposit queue contract.

```typescript
async directDepositContract(): Promise<string>
```

### Returns

`Promise` returns the direct deposit queue contract address.

### Example

```typescript
console.log(`${await zkClient.directDepositContract()}`);
// output: 0xE3Dd183ffa70BcFC442A0B9991E682cA8A442Ade
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zkbob.com/implementation/client-library-sdk/full-mode-operations/direct-deposits.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.