fix: Refactor documentation and code examples for iApp result handling

- Updated links in debugging and inputs/outputs guides to reflect new result decryption guide.
- Added new guide on downloading and decrypting iApp results, detailing the process and providing code examples.
- Removed outdated debug mode option from access management guide.
- Streamlined input handling sections in execution guides, consolidating command-line argument examples.
- Enhanced getting started guide with clearer prerequisites and installation instructions.
- Removed unnecessary debug-related code snippets from the DataProtector documentation.
- Updated iApp generator documentation to clarify project modes and removed debug mode references.
- Improved formatting and clarity in the getting started guide for the iApp generator.

Author: Le-Caignec

.vitepress/sidebar.ts

@@ -182,8 +182,8 @@ export function getSidebar() {
             link: '/guides/build-iapp/using-tdx',
           },
           {
-            text: 'How to Get and Decrypt Results',
-            link: '/guides/build-iapp/how-to-get-and-decrypt-results',
+            text: 'Download and Decrypt Results',
+            link: '/guides/build-iapp/download-and-decrypt-results',
           },
           {
             text: 'Debugging',

src/get-started/helloWorld/3-buildIApp.md

@@ -489,7 +489,7 @@ const arbitrumSteps = [
   },
   {
     showAt: 13,
-    question: 'Pushed TEE image bob/hello-world:0.0.1-tee-scone-5.9.1-v16-debug-ce3a01d9c5d7 on dockerhub',
+    question: 'Pushed TEE image bob/hello-world:0.0.1-tee-scone-5.9.1-v16-ce3a01d9c5d7 on dockerhub',
     answer: '',
     showTyping: false,
     isComplete: true
@@ -558,7 +558,7 @@ const bellecourSteps = [
   },
   {
     showAt: 12,
-    question: 'Pushed TEE image bob/hello-world:0.0.1-tee-scone-5.9.1-v16-debug-ce3a01d9c5d7 on dockerhub',
+    question: 'Pushed TEE image bob/hello-world:0.0.1-tee-scone-5.9.1-v16-ce3a01d9c5d7 on dockerhub',
     answer: '',
     showTyping: false,
     isComplete: true
@@ -573,12 +573,12 @@ const bellecourSteps = [
 ];
 
 const arbitrumCompletionItems = [
-  '└ Docker image: bob/hello-world:0.0.1-tee-scone-5.9.1-v16-debug-ce3a01d9c5d7',
+  '└ Docker image: bob/hello-world:0.0.1-tee-scone-5.9.1-v16-ce3a01d9c5d7',
   '└ iApp address: 0x1f80DCebc2EAAff0Db7156413C43B7e88D189923'
 ];
 
 const bellecourCompletionItems = [
-  '└ Docker image: bob/hello-world:0.0.1-tee-scone-5.9.1-v16-debug-ce3a01d9c5d7',
+  '└ Docker image: bob/hello-world:0.0.1-tee-scone-5.9.1-v16-ce3a01d9c5d7',
   '└ iApp address: 0x1f80DCebc2EAAff0Db7156413C43B7e88D189923'
 ];
 </script>

src/guides/build-iapp/build-&-deploy.md

@@ -30,10 +30,27 @@ iApp Generator handles all the low-level complexity for you.
 
 Before getting started, make sure you have the following installed:
 
-- **Node.js** (version 18 or higher) - [Download here](https://nodejs.org/)
-- **Docker** - [Download here](https://www.docker.com/get-started)
-- **Docker Hub account** - [Sign up here](https://hub.docker.com/) (required for
-  deployment)
+<div class="flex flex-col gap-2 my-4 pl-0">
+  <div class="flex items-center gap-4 text-left">
+    <div class="flex items-center gap-1 flex-1 text-sm font-medium">
+      📦 Node.js v20+
+    </div>
+    <a target="_blank" href="https://nodejs.org/en/" class="no-underline! text-sm ml-auto hover:underline!">Download →</a>
+  </div>
+   <div class="flex items-center gap-4 text-left">
+    <div class="flex items-center gap-1 flex-1 text-sm font-medium">
+      🐳 Docker installed
+    </div>
+    <a target="_blank" href="https://docker.com/" class="no-underline! text-sm ml-auto hover:underline!">Download →</a>
+  </div>
+  
+  <div class="flex items-center gap-4 text-left">
+    <div class="flex items-center gap-1 flex-1 text-sm font-medium">
+      🐳 DockerHub Account
+    </div>
+    <a target="_blank" href="https://hub.docker.com/" class="no-underline! text-sm ml-auto hover:underline!">Sign Up →</a>
+  </div>
+</div>
 
 ## Installation
 
@@ -220,88 +237,6 @@ specify your app version, and push both standard and TEE-compatible images:
   />
 </template>
 
-## Real Examples
-
-Here are some real-world examples of iApp to help you understand how they work
-in practice.
-
-### Email Notification iApp
-
-This iApp lets you send updates to your contacts without ever seeing their email
-addresses, privacy is preserved by design.
-
-::: code-group
-
-```js [Node.js]
-/* User runs: "Send updates to my contacts about my project" */
-const contacts = loadProtectedData(); // User's protected contact list
-contacts.forEach((contact) => {
-  sendEmail(contact, projectUpdateMessage);
-});
-// → Emails sent directly, you never see the addresses
-```
-
-```python [Python]
-# User runs: "Send updates to my contacts about my project"
-contacts = load_protecteddata()  # User's protected contact list
-for contact in contacts:
-   send_email(contact, project_update_message)
-# → Emails sent directly, you never see the addresses
-```
-
-:::
-
-### Oracle Update iApp
-
-This iApp securely updates a price oracle using private trading data, ensuring
-sensitive information stays confidential.
-
-::: code-group
-
-```js [Node.js]
-// User runs: "Update price oracle with my private trading data"
-const tradingData = loadProtectedData(); // User's protected trading history
-const averagePrice = calculateWeightedAverage(tradingData);
-updateOracleContract(averagePrice);
-// → Oracle updated with real data, trading history stays private
-```
-
-```python [Python]
-# User runs: "Update price oracle with my private trading data"
-trading_data = load_protecteddata()  # User's protected trading history
-average_price = calculate_weighted_average(trading_data)
-update_oracle_contract(average_price)
-# → Oracle updated with real data, trading history stays private
-```
-
-:::
-
-### Automated Transactions iApp
-
-This iApp automates monthly payments using protected payment details, so
-financial information remains private.
-
-::: code-group
-
-```js [Node.js]
-// User runs: "Automate payments every month"
-const paymentInfo = loadProtectedData(); // User's payment details
-for (let month = 0; month < 12; month++) {
-  processPayment(paymentInfo);
-}
-// → Payments processed, payment details stay private
-```
-
-```python [Python]
-# User runs: "Automate payments every month"
-payment_info = load_protecteddata()  # User's payment details
-for month in range(12):
-   process_payment(payment_info)
-# → Payments processed, payment details stay private
-```
-
-:::
-
 <script setup>
 import CLIDemo from '@/components/CLIDemo.vue';
 import { computed } from 'vue';
@@ -377,7 +312,7 @@ const arbitrumSteps = [
   },
   {
     showAt: 13,
-    question: 'Pushed TEE image bob/hello-world:0.0.1-tee-scone-5.9.1-v16-debug-ce3a01d9c5d7 on dockerhub',
+    question: 'Pushed TEE image bob/hello-world:0.0.1-tee-scone-5.9.1-v16-ce3a01d9c5d7 on dockerhub',
     answer: '',
     showTyping: false,
     isComplete: true
@@ -446,7 +381,7 @@ const bellecourSteps = [
   },
   {
     showAt: 12,
-    question: 'Pushed TEE image bob/hello-world:0.0.1-tee-scone-5.9.1-v16-debug-ce3a01d9c5d7 on dockerhub',
+    question: 'Pushed TEE image bob/hello-world:0.0.1-tee-scone-5.9.1-v16-ce3a01d9c5d7 on dockerhub',
     answer: '',
     showTyping: false,
     isComplete: true
@@ -461,12 +396,12 @@ const bellecourSteps = [
 ];
 
 const arbitrumCompletionItems = [
-  '└ Docker image: bob/hello-world:0.0.1-tee-scone-5.9.1-v16-debug-ce3a01d9c5d7',
+  '└ Docker image: bob/hello-world:0.0.1-tee-scone-5.9.1-v16-ce3a01d9c5d7',
   '└ iApp address: 0x1f80DCebc2EAAff0Db7156413C43B7e88D189923'
 ];
 
 const bellecourCompletionItems = [
-  '└ Docker image: bob/hello-world:0.0.1-tee-scone-5.9.1-v16-debug-ce3a01d9c5d7',
+  '└ Docker image: bob/hello-world:0.0.1-tee-scone-5.9.1-v16-ce3a01d9c5d7',
   '└ iApp address: 0x1f80DCebc2EAAff0Db7156413C43B7e88D189923'
 ];
 </script>

src/guides/build-iapp/debugging.md

@@ -171,5 +171,5 @@ Continue improving your iApp:
 
 - **[Inputs and Outputs](/guides/build-iapp/inputs-and-outputs)** - Handle data
   in TEE
-- **[How to Get and Decrypt Results](/guides/build-iapp/how-to-get-and-decrypt-results)** -
+- **[How to Get and Decrypt Results](/guides/build-iapp/download-and-decrypt-results)** -
   Retrieve results

…d-iapp/how-to-get-and-decrypt-results.md …ild-iapp/download-and-decrypt-results.mdsrc/guides/build-iapp/how-to-get-and-decrypt-results.md renamed to src/guides/build-iapp/download-and-decrypt-results.md src/guides/build-iapp/how-to-get-and-decrypt-results.md renamed to src/guides/build-iapp/download-and-decrypt-results.md

@@ -3,7 +3,7 @@ title: How to Get and Decrypt Results
 description: Download and decrypt iApp execution results from completed tasks
 ---
 
-# 📦 How to Get and Decrypt Results
+# 📦 Download and Decrypt Results
 
 **When an iApp execution completes, you need to retrieve and decrypt the
 results.** This guide shows you how to download task results and decrypt them to
@@ -40,96 +40,32 @@ Deal (agreement between parties)
 - 📁 **Results contain** all files from `IEXEC_OUT` directory
 - ⚡ **Available immediately** after task completion
 
-## Downloading Results
+## Download & Decrypt Results
 
-### Using iExec SDK CLI
-
-**Get task information and download**:
-
-```bash
-# Check task status and get result info
-iexec task show <taskId>
-
-# Download encrypted result
-iexec task show <taskId> --download my-result
-
-# Extract downloaded files
-unzip my-result.zip -d my-result/
-ls my-result/
-```
-
-**Get task ID from deal**:
-
-```bash
-# If you only have the deal ID
-iexec deal show <dealId>
-
-# Lists all tasks in the deal with their IDs
-```
-
-### Using DataProtector SDK
-
-**Integrated download and decryption**:
+DataProtector provides methods to download and decrypt results from completed
+tasks. You can view the `taskId` in your
+[iExec Explorer](https://explorer.iex.ec/).
 
 ```ts twoslash
 import { IExecDataProtectorCore, getWeb3Provider } from '@iexec/dataprotector';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecDataProtectorCore(web3Provider);
 // ---cut---
-// Get result from completed task
+// Get result from a completed task
 const result = await dataProtectorCore.getResultFromCompletedTask({
   taskId: '0x123abc...', // Your task ID
 });
 
 console.log('Result downloaded and decrypted:', result);
 ```
 
-## Decrypting Results
+::: tip Info
 
-### Automatic Decryption with DataProtector
-
-**The easiest way** - decryption happens automatically:
-
-```ts twoslash
-import { IExecDataProtectorCore, getWeb3Provider } from '@iexec/dataprotector';
+The `processProtectedData` method will create a task and automatically download
+and decrypt the result.
 
-const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecDataProtectorCore(web3Provider);
-// ---cut---
-// Execute and get results in one flow
-const processResponse = await dataProtectorCore.processProtectedData({
-  protectedData: '0x123abc...',
-  app: '0x456def...',
-});
-
-console.log('Task ID:', processResponse.taskId);
-
-// Get decrypted result
-const result = await dataProtectorCore.getResultFromCompletedTask({
-  taskId: processResponse.taskId,
-});
-
-// Result is automatically decrypted ArrayBuffer
-const resultText = new TextDecoder().decode(result.result);
-console.log('Decrypted result:', resultText);
-```
-
-### Manual Decryption with CLI
-
-**If you downloaded manually**:
-
-```bash
-# Download the encrypted result
-iexec task show <taskId> --download my-result
-
-# Decrypt using your wallet (must be the beneficiary)
-iexec result decrypt my-result.zip --force
-
-# Extract decrypted files
-unzip decrypted-result.zip -d final-result/
-cat final-result/result.txt
-```
+:::
 
 ## Result File Structure
 

src/guides/build-iapp/inputs-and-outputs.md

@@ -618,7 +618,7 @@ save_report(report)
 Once your iApp completes execution, users can retrieve and decrypt the results:
 
 → **Learn how users get results**: Check our
-[How to Get and Decrypt Results](/guides/build-iapp/how-to-get-and-decrypt-results)
+[How to Get and Decrypt Results](/guides/build-iapp/download-and-decrypt-results)
 guide for the complete user workflow.
 
 ## What's Next?
@@ -631,7 +631,7 @@ Continue building with these guides:
   Control who can use your iApp
 - **[Debugging Your iApp](/guides/build-iapp/debugging)** - Troubleshoot
   execution issues
-- **[How to Get and Decrypt Results](/guides/build-iapp/how-to-get-and-decrypt-results)** -
+- **[How to Get and Decrypt Results](/guides/build-iapp/download-and-decrypt-results)** -
   User-side result handling
 
 ### Technical Deep Dive

src/guides/manage-data/manage-access.md

@@ -79,27 +79,6 @@ for detailed formatting instructions.
 
 :::
 
-### Debug Mode Option
-
-Debug mode lets you test with debug iApp during development. As "debug" iApp
-don't have the same security standards, we recommend using this mode only during
-iApp development.
-
-```ts twoslash
-import { IExecDataProtectorCore, getWeb3Provider } from '@iexec/dataprotector';
-
-const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecDataProtectorCore(web3Provider);
-// ---cut---
-
-const protectedData = await dataProtectorCore.protectData({
-  data: {
-    email: '[email protected]',
-  },
-  allowDebug: true, // [!code focus]
-});
-```
-
 ## Grant Access
 
 By default, your protected data is private. To let others use it, you need to