# depositEther

## Description

The `depositEther` function is used to transfer Ether from one wallet to another by sending it to the designated receptor contract with a unique ID.

## Parameters

| Parameter    | Type   | Description                                    |
| ------------ | ------ | ---------------------------------------------- |
| `id`         | string | Unique identifier for the transfer transaction |
| `amount`     | string | Amount of Ether to be transferred              |
| `privateKey` | string | Private key of the sender's wallet             |

## Response

| Property  | Type   | Description                                                                                     |
| --------- | ------ | ----------------------------------------------------------------------------------------------- |
| `code`    | number | Status code indicating whether the transfer was successful or not. (1 for success, 0 for error) |
| `receipt` | object | Transaction receipt object returned by the Ethereum network                                     |
| `error`   | object | Error object containing details of any errors that occurred during the transfer                 |

## Example Request and Response

### Prerequisites

Before making requests with NO.AI SDK, you must have it installed.

You can install NO.AI SDK using either **`npm`** or **`yarn`**. Use the following commands to install NO.AI SDK:

```jsx
npm install @nest25/evm-chains-lib
OR
yarn add @nest25/evm-chains-lib
```

### Request

Here is an example of how to make a `depositEther` request using the NO.AI SDK:

```jsx
const {Wallet} = require('@nest25/evm-chains-lib')
// create a new wallet instance
const wallet = new Wallet();
const privateKey = "your private key here"

const main = async () => {
    // deposit 0.001 ETH to the wallet
    let receipt = await wallet.depositEther(
        '123',
        '0.001',
        privateKey
    )
    // print the receipt
    console.log(receipt);
}
main()
```

### Response

```jsx
```

## Use Cases

* **Crypto Wallets:** The function can be used by crypto wallets to send Ether from one wallet to another.
* **Online Marketplaces:** The function can be used by online marketplaces to facilitate payments in Ether for goods and services.
* **Cryptocurrency Exchanges:** The function can be used by cryptocurrency exchanges to facilitate the buying and selling of Ether.