docs: readme enhancement

Author: thewhitewizard

README.md

@@ -1,24 +1,20 @@
-# Hello World
+# 🤖 iApp Generator
 
-To get started with the `iapp` CLI and create your "Hello World" application,
-follow these steps:
-
-[iapp CLI README](./cli/README.md)
-
-## Architecture of the project
+## What is the iApp Generator?
 
-This is a monorepo repository
+iApp Generator (iExec Application Generator) is a CLI tool to create, test, and
+deploy iExec Applications (iApps) that run in a Trusted Execution Environment
+(TEE). It simplifies the process of building decentralized, confidential
+applications without requiring deep knowledge of confidential computing
+technologies. With the iApp Generator, you can:
 
-```
-.
-├── api
-├── cli
-```
+- Create a basic application structure ready to run on a decentralized worker in
+  a TEE.
+- Test your application locally in Debug Mode, enabling fast iteration and
+  troubleshooting.
+- Deploy your iApp as a confidential application on the iExec protocol.
 
-### Simple diagram
-
-![Simple architecture diagram](quick-archi-diagram.png)
-
-### More detailed diagram
+To get started with the `iapp` CLI and create your "Hello World" application,
+follow these steps:
 
-![Detailed architecture diagram](archi-diagram.png)
+[iapp CLI README](./cli/README.md)

cli/README.md

@@ -102,19 +102,26 @@ Options:
 Command:
 
 ```sh
-iapp deploy
+iapp deploy [--chain <input>]
 ```
 
 Description: Deploy your iApp on the iExec protocol in debug mode.
 
+Options:
+
+- use `--chain` Specify the blockchain on which the iApp will be deployed (overrides defaultChain configuration which is `bellecour`). Possible values are `bellecour|arbitrum-sepolia-testnet|arbitrum-mainnet`
+
+> [!IMPORTANT]
+> To use a chain other than `bellecour`, you must pass (or set in your system) `EXPERIMENTAL_NETWORKS=true` before the `iApp` command.
+
 ---
 
 ### `run`
 
 Command:
 
 ```sh
-iapp run <iApp-address> [--args <input>] [--protectedData <protectedData-address>] [--inputFile <url...>]
+iapp run <iApp-address> [--args <input>] [--protectedData <protectedData-address>] [--inputFile <url...>] [--chain <input>]
 ```
 
 Description: Run your deployed iApp. Provide the address of your iApp
@@ -135,3 +142,48 @@ Options:
   [protected data](https://protocol.docs.iex.ec/for-developers/technical-references/application-io#protected-data),
   include the `--protectedData` option followed by the address of the protected
   data.
+- use `--chain` Specify the blockchain on which the iApp will be deployed (overrides defaultChain configuration which is `bellecour`). Possible values are `bellecour|arbitrum-sepolia-testnet|arbitrum-mainnet`
+
+> [!IMPORTANT]
+> To use a chain other than `bellecour`, you must pass (or set in your system) `EXPERIMENTAL_NETWORKS=true` before the `iApp` command.
+
+---
+
+### `debug`
+
+Command:
+
+```sh
+iapp debug <taskId>
+```
+
+Description: Retrieve detailed execution logs from worker nodes for a specific task.
+
+---
+
+### `mock`
+
+Command:
+
+```sh
+iapp mock <inputType>
+```
+
+Description: Create a mocked input for test.
+
+---
+
+### `wallet`
+
+Command:
+
+```sh
+iapp wallet <action>
+```
+
+Description: Manage wallet.
+
+Options for  `<action>` :
+
+- `import` import a new wallet by providing a private key.
+- `select` select a wallet from your personnal keystore.