refactor(docs): consolidate iApp usage guides by removing outdated ProtectedData references and updating sidebar links

Author: Le-Caignec

.vitepress/sidebar.ts

@@ -197,12 +197,8 @@ export function getSidebar() {
             link: '/guides/use-iapp/how-to-pay-executions',
           },
           {
-            text: 'Run iApp with ProtectedData',
-            link: '/guides/use-iapp/run-iapp-with-ProtectedData',
-          },
-          {
-            text: 'Run iApp without ProtectedData',
-            link: '/guides/use-iapp/run-iapp-without-ProtectedData',
+            text: 'Run iApp',
+            link: '/guides/use-iapp/run-iapp',
           },
           {
             text: 'Integrate Web3 Messaging',

src/guides/use-iapp/run-iapp-without-ProtectedData.md

@@ -1,11 +1,11 @@
 ---
-title: Run iApp with ProtectedData
+title: Run iApp
 description:
   Learn how to run iApp with encrypted protected data, arguments, and input
-  files using the DataProtector toolkit for secure data processing
+  files using the iApp Generator toolkit
 ---
 
-# 📥 Run iApp with a ProtectedData
+# 📥 Run iApp
 
 When running an iApp, you can use multiple types of inputs. While ProtectedData
 is not mandatory to run an iApp, it's a powerful input type that allows you to
@@ -14,39 +14,51 @@ inputs that come directly from you (the requester) and can change between each
 execution: Arguments, Input Files, and Secrets. These non-persistent inputs are
 perfect for customizing the iApp's behavior for each specific run.
 
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const iappGenerator = new IExecIApp(web3Provider);
+// ---cut---
+// Process protected data with specific path
+const result = await iappGenerator.runIApp({
+  iapp: '0x456def...',
+});
+```
+
 ## Adding Protected Data
 
 When working with protected data that contains multiple files, you can specify
 which file to process.
 
 ```ts twoslash
-import { IExecDataProtectorCore, getWeb3Provider } from '@iexec/dataprotector';
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecDataProtectorCore(web3Provider);
+const iappGenerator = new IExecIApp(web3Provider);
 // ---cut---
 // Process protected data with specific path
-const result = await dataProtectorCore.processProtectedData({
+const result = await iappGenerator.runIApp({
+  iapp: '0x456def...',
   protectedData: '0x123abc...',
-  app: '0x456def...',
   path: 'data/input.csv',
 });
 ```
 
-The `processProtectedData` function will automatically download and decrypt the
+The `runIApp` function will automatically download and decrypt the
 results for you. Nevertheless, if you want to retrieve results from a completed
 task, you can do so as follows:
 
 ```ts twoslash
-import { IExecDataProtectorCore, getWeb3Provider } from '@iexec/dataprotector';
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecDataProtectorCore(web3Provider);
+const iappGenerator = new IExecIApp(web3Provider);
 const taskId = '0x7ac398...';
 
 // ---cut---
 // Retrieve the result
-const taskResult = await dataProtectorCore.getResultFromCompletedTask({
+const taskResult = await iappGenerator.getResultFromCompletedTask({
   taskId: taskId,
 });
 ```
@@ -57,15 +69,15 @@ Command-line arguments are passed as a string to the iApp and are visible on the
 blockchain.
 
 ```ts twoslash
-import { IExecDataProtectorCore, getWeb3Provider } from '@iexec/dataprotector';
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecDataProtectorCore(web3Provider);
+const iappGenerator = new IExecIApp(web3Provider);
 // ---cut---
 // Process protected data with arguments
-const result = await dataProtectorCore.processProtectedData({
+const result = await iappGenerator.runIApp({
+  iapp: '0x456def...',
   protectedData: '0x123abc...',
-  app: '0x456def...',
   args: '--input-path data/input.csv --output-format json --verbose',
 });
 ```
@@ -76,15 +88,15 @@ Input files are URLs to public files that the iApp can download during
 execution.
 
 ```ts twoslash
-import { IExecDataProtectorCore, getWeb3Provider } from '@iexec/dataprotector';
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecDataProtectorCore(web3Provider);
+const iappGenerator = new IExecIApp(web3Provider);
 // ---cut---
 // Process protected data with input files
-const result = await dataProtectorCore.processProtectedData({
+const result = await iappGenerator.runIApp({
+  iapp: '0x456def...',
   protectedData: '0x123abc...',
-  app: '0x456def...',
   inputFiles: [
     'https://raw.githubusercontent.com/user/repo/main/config.json',
     'https://example.com/public-data.csv',
@@ -98,15 +110,15 @@ Secrets are sensitive data like API keys, passwords, or tokens that are stored
 securely and made available to the iApp as environment variables.
 
 ```ts twoslash
-import { IExecDataProtectorCore, getWeb3Provider } from '@iexec/dataprotector';
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecDataProtectorCore(web3Provider);
+const iappGenerator = new IExecIApp(web3Provider);
 // ---cut---
 // Process protected data with secrets
-const result = await dataProtectorCore.processProtectedData({
+const result = await iappGenerator.runIApp({
+  iapp: '0x456def...',
   protectedData: '0x123abc...',
-  app: '0x456def...',
   secrets: {
     1: 'openai-api-key',
     2: 'database-password',