From 6e6db2c3e491271f34c65e845f16be67e8dbf3eb Mon Sep 17 00:00:00 2001
From: Le-Caignec <robinlecaignec@yahoo.fr>
Date: Thu, 25 Sep 2025 10:13:52 +0200
Subject: [PATCH 01/11] feat(docs): restructure iApp Generator documentation
 and add new guides

---
 src/references/iapp-generator/cli.md                              | 0
 .../iapp-generator/{ => cli}/building-your-iexec-app.md           | 0
 src/references/iapp-generator/{ => cli}/deserializer.md           | 0
 src/references/iapp-generator/{ => cli}/deserializer/getValue.md  | 0
 src/references/iapp-generator/{ => cli}/getting-started.md        | 0
 src/references/iapp-generator/sdk.md                              | 0
 6 files changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 src/references/iapp-generator/cli.md
 rename src/references/iapp-generator/{ => cli}/building-your-iexec-app.md (100%)
 rename src/references/iapp-generator/{ => cli}/deserializer.md (100%)
 rename src/references/iapp-generator/{ => cli}/deserializer/getValue.md (100%)
 rename src/references/iapp-generator/{ => cli}/getting-started.md (100%)
 create mode 100644 src/references/iapp-generator/sdk.md

diff --git a/src/references/iapp-generator/cli.md b/src/references/iapp-generator/cli.md
new file mode 100644
index 00000000..e69de29b
diff --git a/src/references/iapp-generator/building-your-iexec-app.md b/src/references/iapp-generator/cli/building-your-iexec-app.md
similarity index 100%
rename from src/references/iapp-generator/building-your-iexec-app.md
rename to src/references/iapp-generator/cli/building-your-iexec-app.md
diff --git a/src/references/iapp-generator/deserializer.md b/src/references/iapp-generator/cli/deserializer.md
similarity index 100%
rename from src/references/iapp-generator/deserializer.md
rename to src/references/iapp-generator/cli/deserializer.md
diff --git a/src/references/iapp-generator/deserializer/getValue.md b/src/references/iapp-generator/cli/deserializer/getValue.md
similarity index 100%
rename from src/references/iapp-generator/deserializer/getValue.md
rename to src/references/iapp-generator/cli/deserializer/getValue.md
diff --git a/src/references/iapp-generator/getting-started.md b/src/references/iapp-generator/cli/getting-started.md
similarity index 100%
rename from src/references/iapp-generator/getting-started.md
rename to src/references/iapp-generator/cli/getting-started.md
diff --git a/src/references/iapp-generator/sdk.md b/src/references/iapp-generator/sdk.md
new file mode 100644
index 00000000..e69de29b

From ea0832d22263e7b27579cc086a450d726c8cad7f Mon Sep 17 00:00:00 2001
From: Le-Caignec <robinlecaignec@yahoo.fr>
Date: Thu, 25 Sep 2025 10:45:24 +0200
Subject: [PATCH 02/11] feat(docs): update iApp Generator links to reflect CLI
 structure and add new Getting Started guide

---
 .vitepress/sidebar.ts                         | 30 ++++++++++++++-----
 src/get-started/helloWorld/3-buildIApp.md     |  2 +-
 src/get-started/toolkit.md                    |  2 +-
 src/guides/build-iapp/build-&-test.md         |  2 +-
 src/guides/build-iapp/deploy-&-run.md         |  2 +-
 src/guides/build-iapp/inputs.md               |  2 +-
 .../dataProtectorCore/protectData.md          |  2 +-
 src/references/iapp-generator.md              |  8 ++---
 src/references/iapp-generator/cli.md          |  0
 .../cli/building-your-iexec-app.md            |  2 +-
 .../iapp-generator/getting-started.md         |  6 ++++
 src/references/iapp-generator/sdk.md          |  0
 12 files changed, 39 insertions(+), 19 deletions(-)
 delete mode 100644 src/references/iapp-generator/cli.md
 create mode 100644 src/references/iapp-generator/getting-started.md
 delete mode 100644 src/references/iapp-generator/sdk.md

diff --git a/.vitepress/sidebar.ts b/.vitepress/sidebar.ts
index 92129a28..1768debb 100644
--- a/.vitepress/sidebar.ts
+++ b/.vitepress/sidebar.ts
@@ -447,20 +447,34 @@ export function getSidebar() {
             link: '/references/iapp-generator/getting-started',
           },
           {
-            text: 'Building your iApp',
-            link: '/references/iapp-generator/building-your-iexec-app',
-          },
-          {
-            text: 'Deserialize ProtectedData',
-            link: '/references/iapp-generator/deserializer',
+            text: 'CLI',
             collapsed: true,
             items: [
               {
-                text: 'getValue',
-                link: '/references/iapp-generator/deserializer/getValue',
+                text: 'Getting Started',
+                link: '/references/iapp-generator/cli/getting-started',
+              },
+              {
+                text: 'Building your iApp',
+                link: '/references/iapp-generator/cli/building-your-iexec-app',
+              },
+              {
+                text: 'Deserialize ProtectedData',
+                link: '/references/iapp-generator/cli/deserializer',
+                collapsed: true,
+                items: [
+                  {
+                    text: 'getValue',
+                    link: '/references/iapp-generator/cli/deserializer/getValue',
+                  },
+                ],
               },
             ],
           },
+          {
+            text: 'SDK',
+            link: '/references/iapp-generator/sdk',
+          },
         ],
       },
       {
diff --git a/src/get-started/helloWorld/3-buildIApp.md b/src/get-started/helloWorld/3-buildIApp.md
index 24db293c..55b7b5eb 100644
--- a/src/get-started/helloWorld/3-buildIApp.md
+++ b/src/get-started/helloWorld/3-buildIApp.md
@@ -27,7 +27,7 @@ experience.
 ## 📋 Prerequisites
 
 Before getting started, make sure you have the required tools installed. See the
-[iApp Generator Getting Started guide](/references/iapp-generator/getting-started)
+[iApp Generator Getting Started guide](/references/iapp-generator/cli/getting-started)
 for detailed prerequisites and installation instructions.
 
 ::: info
diff --git a/src/get-started/toolkit.md b/src/get-started/toolkit.md
index e39ba702..327cbb9b 100644
--- a/src/get-started/toolkit.md
+++ b/src/get-started/toolkit.md
@@ -24,7 +24,7 @@ just a few commands, let free your imagination.
 ### Get Started
 
 Jump right into building with our comprehensive guide:
-[Building Your iApp →](/references/iapp-generator/building-your-iexec-app.md)
+[Building Your iApp →](/references/iapp-generator/cli/building-your-iexec-app.md)
 
 ## DataProtector-SDK
 
diff --git a/src/guides/build-iapp/build-&-test.md b/src/guides/build-iapp/build-&-test.md
index 757fa4da..af7928d6 100644
--- a/src/guides/build-iapp/build-&-test.md
+++ b/src/guides/build-iapp/build-&-test.md
@@ -30,7 +30,7 @@ iApp Generator handles all the low-level complexity for you.
 ## Prerequisites
 
 Before getting started, make sure you have the required tools installed. See the
-[iApp Generator Getting Started guide](/references/iapp-generator/getting-started)
+[iApp Generator Getting Started guide](/references/iapp-generator/cli/getting-started)
 for detailed prerequisites and installation instructions.
 
 ## Quick Start
diff --git a/src/guides/build-iapp/deploy-&-run.md b/src/guides/build-iapp/deploy-&-run.md
index 0dfb1510..4f85eced 100644
--- a/src/guides/build-iapp/deploy-&-run.md
+++ b/src/guides/build-iapp/deploy-&-run.md
@@ -74,7 +74,7 @@ The iApp Generator CLI provides a streamlined way to execute iApp, especially
 for developers who have built their own iApp.
 
 > **Note**: For installation instructions, see the
-> [iApp Generator Getting Started guide](/references/iapp-generator/getting-started).
+> [iApp Generator Getting Started guide](/references/iapp-generator/cli/getting-started).
 
 <template v-if="selectedChain === 42161">
   <CLIDemo
diff --git a/src/guides/build-iapp/inputs.md b/src/guides/build-iapp/inputs.md
index 10810d71..ac2eeb1b 100644
--- a/src/guides/build-iapp/inputs.md
+++ b/src/guides/build-iapp/inputs.md
@@ -384,7 +384,7 @@ App Secrets are different from Requester Secrets:
 
 App Secrets are configured in your `iapp.config.json` during development and
 automatically deployed with your iApp. For deployment details, see the
-[Build Your iApp guide](/references/iapp-generator/building-your-iexec-app).
+[Build Your iApp guide](/references/iapp-generator/cli/building-your-iexec-app).
 
 #### Configuration in iapp.config.json
 
diff --git a/src/references/dataProtector/dataProtectorCore/protectData.md b/src/references/dataProtector/dataProtectorCore/protectData.md
index 005131e4..2b0985be 100644
--- a/src/references/dataProtector/dataProtectorCore/protectData.md
+++ b/src/references/dataProtector/dataProtectorCore/protectData.md
@@ -362,7 +362,7 @@ details on the transaction using the [iExec explorer](https://explorer.iex.ec).
 Under the hood, your protected data will be **compressed as a zip file**. In
 this zip file, you'll find back all of your protected fields, each field being
 serialized with a tool called `Borsh`. You can find more details here:
-[deserializer](/references/iapp-generator/deserializer).
+[deserializer](/references/iapp-generator/cli/deserializer).
 
 This is mainly returned for debug purpose.
 
diff --git a/src/references/iapp-generator.md b/src/references/iapp-generator.md
index 1ec9e24f..23a48bb1 100644
--- a/src/references/iapp-generator.md
+++ b/src/references/iapp-generator.md
@@ -32,9 +32,9 @@ Start here to understand what iApp are and how they work:
 
 - **[iApp](/get-started/overview/privacy-iapp)** - Core concepts and TEE
   overview
-- **[Getting Started](/references/iapp-generator/getting-started)** - Your first
-  iApp in 15 minutes
-- **[Building Your iApp](/references/iapp-generator/building-your-iexec-app)** -
+- **[Getting Started](/references/iapp-generator/cli/getting-started)** - Your
+  first iApp in 15 minutes
+- **[Building Your iApp](/references/iapp-generator/cli/building-your-iexec-app)** -
   Complete development guide
 
 ### 2. **Master the Development Workflow**
@@ -87,7 +87,7 @@ applications:
 
 ::: tip Quick Path
 
-1. **[Getting Started](/references/iapp-generator/getting-started)** - Build
+1. **[Getting Started](/references/iapp-generator/cli/getting-started)** - Build
    your first iApp (15 minutes)
 2. **[Inputs](/guides/build-iapp/inputs)** - Handle data inputs
 3. **[Outputs](/guides/build-iapp/outputs)** - Handle data outputs properly
diff --git a/src/references/iapp-generator/cli.md b/src/references/iapp-generator/cli.md
deleted file mode 100644
index e69de29b..00000000
diff --git a/src/references/iapp-generator/cli/building-your-iexec-app.md b/src/references/iapp-generator/cli/building-your-iexec-app.md
index 4293c934..a0068292 100644
--- a/src/references/iapp-generator/cli/building-your-iexec-app.md
+++ b/src/references/iapp-generator/cli/building-your-iexec-app.md
@@ -10,7 +10,7 @@ description:
 ::: tip 📋 Prerequisites
 
 Before building your iApp, make sure you have the required tools installed. See
-the [Getting Started guide](/references/iapp-generator/getting-started) for
+the [Getting Started guide](/references/iapp-generator/cli/getting-started) for
 detailed prerequisites and installation instructions.
 
 :::
diff --git a/src/references/iapp-generator/getting-started.md b/src/references/iapp-generator/getting-started.md
new file mode 100644
index 00000000..7927acbe
--- /dev/null
+++ b/src/references/iapp-generator/getting-started.md
@@ -0,0 +1,6 @@
+---
+title: Getting Started
+description: knl
+---
+
+# oln
diff --git a/src/references/iapp-generator/sdk.md b/src/references/iapp-generator/sdk.md
deleted file mode 100644
index e69de29b..00000000

From c838c64f8ac15abaeb12e6ff6c28f3abc596a27f Mon Sep 17 00:00:00 2001
From: Le-Caignec <robinlecaignec@yahoo.fr>
Date: Thu, 25 Sep 2025 11:01:18 +0200
Subject: [PATCH 03/11] feat: add @mage-sombre/iapp dependency and update
 sidebar with new SDK methods

---
 .vitepress/sidebar.ts                         |  40 +-
 package-lock.json                             |  16 +
 package.json                                  |   1 +
 .../getResultFromCompletedTask.md             |   3 -
 .../iapp-generator/sdk/getGrantedAccess.md    | 223 ++++++++
 src/references/iapp-generator/sdk/getIApp.md  | 198 +++++++
 .../sdk/getResultFromCompletedTask.md         | 141 +++++
 .../iapp-generator/sdk/grantAccess.md         | 267 ++++++++++
 .../iapp-generator/sdk/revokeAllAccess.md     | 148 ++++++
 .../iapp-generator/sdk/revokeOneAccess.md     |  96 ++++
 src/references/iapp-generator/sdk/runIApp.md  | 497 ++++++++++++++++++
 .../iapp-generator/sdk/transferOwnership.md   | 109 ++++
 src/references/iapp-generator/sdk/types.md    | 116 ++++
 13 files changed, 1851 insertions(+), 4 deletions(-)
 create mode 100644 src/references/iapp-generator/sdk/getGrantedAccess.md
 create mode 100644 src/references/iapp-generator/sdk/getIApp.md
 create mode 100644 src/references/iapp-generator/sdk/getResultFromCompletedTask.md
 create mode 100644 src/references/iapp-generator/sdk/grantAccess.md
 create mode 100644 src/references/iapp-generator/sdk/revokeAllAccess.md
 create mode 100644 src/references/iapp-generator/sdk/revokeOneAccess.md
 create mode 100644 src/references/iapp-generator/sdk/runIApp.md
 create mode 100644 src/references/iapp-generator/sdk/transferOwnership.md
 create mode 100644 src/references/iapp-generator/sdk/types.md

diff --git a/.vitepress/sidebar.ts b/.vitepress/sidebar.ts
index 1768debb..90fcf1ea 100644
--- a/.vitepress/sidebar.ts
+++ b/.vitepress/sidebar.ts
@@ -473,7 +473,45 @@ export function getSidebar() {
           },
           {
             text: 'SDK',
-            link: '/references/iapp-generator/sdk',
+            collapsed: true,
+            items: [
+              {
+                text: 'getIApp',
+                link: '/references/iapp-generator/sdk/getIApp',
+              },
+              {
+                text: 'transferOwnership',
+                link: '/references/iapp-generator/sdk/transferOwnership',
+              },
+              {
+                text: 'grantAccess',
+                link: '/references/iapp-generator/sdk/grantAccess',
+              },
+              {
+                text: 'getGrantedAccess',
+                link: '/references/iapp-generator/sdk/getGrantedAccess',
+              },
+              {
+                text: 'revokeOneAccess',
+                link: '/references/iapp-generator/sdk/revokeOneAccess',
+              },
+              {
+                text: 'revokeAllAccess',
+                link: '/references/iapp-generator/sdk/revokeAllAccess',
+              },
+              {
+                text: 'runIApp',
+                link: '/references/iapp-generator/sdk/runIApp',
+              },
+              {
+                text: 'getResultFromCompletedTask',
+                link: '/references/iapp-generator/sdk/getResultFromCompletedTask',
+              },
+              {
+                text: 'Types',
+                link: '/references/iapp-generator/sdk/types',
+              },
+            ],
           },
         ],
       },
diff --git a/package-lock.json b/package-lock.json
index ab28cdd4..07c11fd4 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -12,6 +12,7 @@
         "@iexec/dataprotector-deserializer": "^0.1.1",
         "@iexec/web3mail": "^1.5.0",
         "@iexec/web3telegram": "^0.1.0-alpha.4",
+        "@mage-sombre/iapp": "^1.0.0-beta.2",
         "@reown/appkit": "^1.7.17",
         "@reown/appkit-adapter-wagmi": "^1.7.17",
         "@tailwindcss/vite": "^4.1.11",
@@ -1338,6 +1339,21 @@
         "@lit-labs/ssr-dom-shim": "^1.4.0"
       }
     },
+    "node_modules/@mage-sombre/iapp": {
+      "version": "1.0.0-beta.2",
+      "resolved": "https://registry.npmjs.org/@mage-sombre/iapp/-/iapp-1.0.0-beta.2.tgz",
+      "integrity": "sha512-MYTxl4HNqFp6kezvdavzcF7s4EGuPrNZT55rG3Xp6JniYE78e0rNn5DpUppG/EZzWUI85UDvj9TYj0VOSRcWkQ==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@ethersproject/bytes": "^5.7.0",
+        "@ethersproject/random": "^5.7.0",
+        "@iexec/dataprotector": "^2.0.0-beta.19",
+        "ethers": "^6.13.2",
+        "graphql-request": "^6.0.0",
+        "iexec": "^8.18.0",
+        "yup": "^1.1.1"
+      }
+    },
     "node_modules/@mermaid-js/mermaid-mindmap": {
       "version": "9.3.0",
       "resolved": "https://registry.npmjs.org/@mermaid-js/mermaid-mindmap/-/mermaid-mindmap-9.3.0.tgz",
diff --git a/package.json b/package.json
index b2334164..968d6f03 100644
--- a/package.json
+++ b/package.json
@@ -15,6 +15,7 @@
     "@iexec/dataprotector-deserializer": "^0.1.1",
     "@iexec/web3mail": "^1.5.0",
     "@iexec/web3telegram": "^0.1.0-alpha.4",
+    "@mage-sombre/iapp": "^1.0.0-beta.2",
     "@reown/appkit": "^1.7.17",
     "@reown/appkit-adapter-wagmi": "^1.7.17",
     "@tailwindcss/vite": "^4.1.11",
diff --git a/src/references/dataProtector/dataProtectorCore/getResultFromCompletedTask.md b/src/references/dataProtector/dataProtectorCore/getResultFromCompletedTask.md
index 6d1d869b..ee783620 100644
--- a/src/references/dataProtector/dataProtectorCore/getResultFromCompletedTask.md
+++ b/src/references/dataProtector/dataProtectorCore/getResultFromCompletedTask.md
@@ -135,10 +135,7 @@ import { type GetResultFromCompletedTaskResponse } from '@iexec/dataprotector';
 
 The actual content of the protected file.
 
-```
-
 <script setup>
 import RequiredBadge from '@/components/RequiredBadge.vue'
 import OptionalBadge from '@/components/OptionalBadge.vue'
 </script>
-```
diff --git a/src/references/iapp-generator/sdk/getGrantedAccess.md b/src/references/iapp-generator/sdk/getGrantedAccess.md
new file mode 100644
index 00000000..38c68d80
--- /dev/null
+++ b/src/references/iapp-generator/sdk/getGrantedAccess.md
@@ -0,0 +1,223 @@
+---
+title: getGrantedAccess
+description:
+  Retrieve all granted access details for a protected data object with iExec's
+  getGrantedAccess method. Filter access by user, application, or both, and
+  manage access with pagination.
+---
+
+# getGrantedAccess
+
+This method provides a listing of all access grants given for the specified
+protected data object. Options for filtering include specifying an authorized
+user, an authorized app, or both.
+
+## Usage
+
+The request object is a JSON `GetGrantedAccessParams` object. Each address in
+the object is a string representation of an ethereum address or ENS name
+(Ethereum Name Service) reference.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const listGrantedAccess = await dataProtectorCore.getGrantedAccess({
+  protectedData: '0x123abc...',
+  authorizedApp: '0x456def...',
+  authorizedUser: '0x789cba...',
+  page: 1,
+  pageSize: 100,
+});
+```
+
+## Parameters
+
+```ts twoslash
+import { type GetGrantedAccessParams } from '@mage-sombre/iapp';
+```
+
+### protectedData <OptionalBadge />
+
+**Type:** `AddressOrENS`
+
+Address of the protected data object for which you are querying access
+authorization grants. It's a representation of ethereum address or ENS name
+(Ethereum Name Service). If no address is specified, it will return all granted
+access for any protected data.
+
+**Usage example:**
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const listGrantedAccess = await dataProtectorCore.getGrantedAccess({
+  protectedData: '0x123abc...', // [!code focus]
+});
+```
+
+### authorizedApp <OptionalBadge />
+
+**Type:** `AddressOrENS`
+
+Optional filter to restrict the results to include only authorizations for the
+specified application. It's a representation of ethereum address or ENS name
+(Ethereum Name Service). If no address is specified, it will return all granted
+access for any application.
+
+**Usage example:**
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const listGrantedAccess = await dataProtectorCore.getGrantedAccess({
+  authorizedApp: '0x456def...', // [!code focus]
+});
+```
+
+::: tip
+
+If you specified an application whitelist when using
+[`grantAccess`](/references/dataProtector/dataProtectorCore/grantAccess), you
+must specify that same whitelist address when using this filtering option. The
+`getGrantedAccess` method does not check against whitelist smart contracts when
+aggregating results. If you granted authorization to a whitelist but specify an
+application address for the `authorizedApp` parameter, you will not receive any
+results unless you _also_ explicitly granted access to that application address.
+
+:::
+
+### authorizedUser <OptionalBadge />
+
+**Type:** `AddressOrENS`
+
+Optional filter to restrict the results to include only authorizations for the
+specified user. It's a string representation of ethereum address or ENS name
+(Ethereum Name Service). If no address is specified, it will return all granted
+access for any user.
+
+**Usage example:**
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const listGrantedAccess = await dataProtectorCore.getGrantedAccess({
+  authorizedUser: '0x789cba...', // [!code focus]
+});
+```
+
+### isUserStrict <OptionalBadge />
+
+**Type:** `boolean`  
+**Default:** `false`
+
+Optional filter to restrict the results to include only authorizations for the
+specified user. Authorizations made for `any` user are not returned.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+
+const listGrantedAccess = await dataProtectorCore.getGrantedAccess({
+  protectedData: '0x123abc...',
+  authorizedApp: '0x456def...',
+  authorizedUser: '0x789cba...',
+  isUserStrict: true, // [!code focus]
+});
+```
+
+### page <OptionalBadge />
+
+**Type:** `number`  
+**Default:** `0`
+
+Specifies the page number of the result set to return. Pages are zero-based
+indexed, with the default value being `0`, indicating the first page. If used,
+you can also specify the `pageSize` parameter to control the number of records
+per page. By default, when no page number is specified, the system returns the
+first page (page 0) containing `20` elements.
+
+**Usage example:**
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const listGrantedAccess = await dataProtectorCore.getGrantedAccess({
+  protectedData: '0x123abc...',
+  page: 1, // [!code focus]
+  pageSize: 100,
+});
+```
+
+### pageSize <OptionalBadge />
+
+**Type:** `number`  
+**Default:** `20`  
+**Range:** `[10...1000]`
+
+Specifies the number of records to include in each page of the result set. This
+is used in conjunction with the optional `page` parameter to limit the size of
+each page.
+
+**Usage example:**
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const listGrantedAccess = await dataProtectorCore.getGrantedAccess({
+  protectedData: '0x123abc...',
+  page: 1,
+  pageSize: 100, // [!code focus]
+});
+```
+
+## Return Value
+
+```ts twoslash
+import { type GrantedAccessResponse } from '@mage-sombre/iapp';
+```
+
+The return value for this method has two fields: a `count` parameter indicating
+the number of results, and an array of `GrantedAccess` objects containing all
+access data. When using the optional paging parameters, the `count` will be
+limited by the selected `pageSize` parameter. You may use these result objects
+in conjunction with the [revokeOneAccess](revokeOneAccess.md) method to revoke a
+previously granted authorization for access.
+
+### count
+
+**Type:** `number`
+
+An integer value indicating the number of results returned by this method. This
+is of particular note when using paging as the number of records returned may be
+smaller than the page size.
+
+### grantedAccess
+
+**Type:** GrantedAccess
+
+See [`GrantedAccess`](/references/iapp-generator/sdk/types#grantedaccess)
+
+<script setup>
+import OptionalBadge from '@/components/OptionalBadge.vue'
+</script>
diff --git a/src/references/iapp-generator/sdk/getIApp.md b/src/references/iapp-generator/sdk/getIApp.md
new file mode 100644
index 00000000..7ddf6020
--- /dev/null
+++ b/src/references/iapp-generator/sdk/getIApp.md
@@ -0,0 +1,198 @@
+---
+title: getIApp
+description:
+  Retrieve all protected data for a specific owner or schema with the getIApp
+  method in iExec DataProtector. Easily access encrypted data and metadata,
+  sorted by creation date.
+---
+
+# getIApp
+
+This method allows the user to retrieve all protected data for a given owner,
+data schema, or both.
+
+Results are ordered by `creationTimestamp` desc.
+
+::: tip
+
+A data schema is the metadata describing the contents of the protected data
+object. The schema is returned as part of the [protectData](protectData.md)
+method invocation.
+
+:::
+
+## Usage
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const listProtectedData = await dataProtectorCore.getIApp({
+  owner: '0xa0c15e...',
+  requiredSchema: {
+    email: 'string',
+  },
+});
+```
+
+## Parameters
+
+```ts twoslash
+import { type GetProtectedDataParams } from '@mage-sombre/iapp';
+```
+
+### protectedDataAddress <OptionalBadge />
+
+**Type:** `AddressOrENS`
+
+Returns the protected data associated with this address.  
+Returns an empty array if the protected data is not found.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const oneProtectedData = await dataProtectorCore.getIApp({
+  protectedDataAddress: '0x123abc...', // [!code focus]
+});
+```
+
+### requiredSchema <OptionalBadge />
+
+**Type:** `SearchableDataSchema`
+
+Provides a list of protected data objects matching this schema.
+
+<!-- prettier-ignore-start -->
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const listProtectedData = await dataProtectorCore.getIApp({
+  requiredSchema: { // [!code focus]
+    email: 'string', // [!code focus]
+  }, // [!code focus]
+});
+```
+<!-- prettier-ignore-end -->
+
+It's also possible to provide a list of accepted types for one schema field:
+
+<!-- prettier-ignore-start -->
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const listProtectedData = await dataProtectorCore.getIApp({
+  requiredSchema: { // [!code focus]
+    picture: ['image/png', 'image/jpeg'], // [!code focus]
+  }, // [!code focus]
+});
+```
+<!-- prettier-ignore-end -->
+
+Available types are listed
+[here](/references/dataProtector/dataProtectorCore/protectData#schema).
+
+### owner <OptionalBadge />
+
+**Type:** `AddressOrENS`
+
+Provides a list of protected data objects owned by the user with this ETH
+address.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const listProtectedData = await dataProtectorCore.getIApp({
+  owner: '0xa0c15e...', // [!code focus]
+});
+```
+
+### createdAfterTimestamp <OptionalBadge />
+
+**Type:** `number`
+
+Provides a list of protected data objects created after this timestamp value.
+The provided value should be in seconds.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const listProtectedData = await dataProtectorCore.getIApp({
+  owner: '0xa0c15e...',
+  createdAfterTimestamp: 1710257612, // March 12, 2024 15:33:32 GMT // [!code focus]
+});
+```
+
+### page <OptionalBadge />
+
+**Type:** `number`  
+**Default:** `0`
+
+Specifies the results page to return. Pages are indexed starting at page 0. If
+using this field you may also specify a `pageSize` to control the size of the
+results.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const listProtectedData = await dataProtectorCore.getIApp({
+  owner: '0xa0c15e...',
+  createdAfterTimestamp: 1710257612, // March 12, 2024 15:33:32 GMT
+  page: 1, // [!code focus]
+});
+```
+
+### pageSize <OptionalBadge />
+
+**Type:** `number`  
+**Default:** `1000`  
+**Range:** `[10...1000]`
+
+Specifies the number of records in each page of the result set. This is used in
+conjunction with the optional `page` parameter to constrain the size of the
+result.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const listProtectedData = await dataProtectorCore.getIApp({
+  owner: '0xa0c15e...',
+  createdAfterTimestamp: 1710257612, // March 12, 2024 15:33:32 GMT
+  page: 1,
+  pageSize: 100, // [!code focus]
+});
+```
+
+## Return Value
+
+```ts twoslash
+import { type ProtectedData } from '@mage-sombre/iapp';
+```
+
+See [`ProtectedData`](/references/iapp-generator/sdk/types#protecteddata)
+
+<script setup>
+import OptionalBadge from '@/components/OptionalBadge.vue'
+</script>
diff --git a/src/references/iapp-generator/sdk/getResultFromCompletedTask.md b/src/references/iapp-generator/sdk/getResultFromCompletedTask.md
new file mode 100644
index 00000000..de0af340
--- /dev/null
+++ b/src/references/iapp-generator/sdk/getResultFromCompletedTask.md
@@ -0,0 +1,141 @@
+---
+title: getResultFromCompletedTask
+description:
+  Retrieve the result of a completed task with iExec's
+  getResultFromCompletedTask method. Easily access task outcomes by providing
+  the task ID.
+---
+
+# getResultFromCompletedTask
+
+Method to get the result of a completed task.
+
+## Usage
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const completedTaskResult = await dataProtectorCore.getResultFromCompletedTask({
+  taskId: '0x7ac398...',
+});
+```
+
+## Parameters
+
+```ts twoslash
+import { type GetResultFromCompletedTaskParams } from '@mage-sombre/iapp';
+```
+
+### taskId <RequiredBadge />
+
+**Type:** `Address`
+
+Address of the task ID data you'd like to get the result from.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const completedTaskResult = await dataProtectorCore.getResultFromCompletedTask({
+  taskId: '0x7ac398...', // [!code focus]
+});
+```
+
+### path <OptionalBadge />
+
+**Type:** `string`
+
+Under the hood, a protected data is a zip file. With this `path` parameter, you
+can specify the file you're interested in. The zip file will be uncompressed for
+you, and only the desired file will be given as the `result`.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const completedTaskResult = await dataProtectorCore.getResultFromCompletedTask({
+  taskId: '0x7ac398...',
+  path: 'content', // [!code focus]
+});
+```
+
+### pemPrivateKey <OptionalBadge />
+
+**Type:** `string`
+
+If you have previously saved or generated a RSA keypair, you can reuse it in
+further calls.
+
+It needs to be the private key corresponding to the public key initially used to
+encrypt the protected data.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const completedTaskResult = await dataProtectorCore.getResultFromCompletedTask({
+  taskId: '0x7ac398...',
+  pemPrivateKey: '-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----', // [!code focus]
+});
+```
+
+### onStatusUpdate <OptionalBadge />
+
+**Type:** `OnStatusUpdateFn<ConsumeProtectedDataStatuses>`
+
+Callback function to be notified at intermediate steps.
+
+<!-- prettier-ignore-start -->
+```ts twoslash
+import {
+  IExecIApp,
+  getWeb3Provider,
+} from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const completedTaskResult =
+  await dataProtectorCore.getResultFromCompletedTask({
+    taskId: '0x7ac398...',
+    onStatusUpdate: ({ title, isDone }) => { // [!code focus]
+      console.log(title, isDone); // [!code focus]
+    }, // [!code focus]
+  });
+```
+<!-- prettier-ignore-end -->
+
+You can expect this callback function to be called with the following titles:
+
+```ts
+'CONSUME_RESULT_DOWNLOAD';
+'CONSUME_RESULT_DECRYPT';
+```
+
+Once with `isDone: false`, and then with `isDone: true`
+
+## Return Value
+
+```ts twoslash
+import { type GetResultFromCompletedTaskResponse } from '@mage-sombre/iapp';
+```
+
+### result
+
+`ArrayBuffer`
+
+The actual content of the protected file.
+
+<script setup>
+import RequiredBadge from '@/components/RequiredBadge.vue'
+import OptionalBadge from '@/components/OptionalBadge.vue'
+</script>
diff --git a/src/references/iapp-generator/sdk/grantAccess.md b/src/references/iapp-generator/sdk/grantAccess.md
new file mode 100644
index 00000000..6cb851a6
--- /dev/null
+++ b/src/references/iapp-generator/sdk/grantAccess.md
@@ -0,0 +1,267 @@
+---
+title: grantAccess
+description:
+  Grant secure access to encrypted data with iExec's grantAccess method.
+  Authorize specific applications or users to process protected data, with
+  customizable access limits and pricing.
+---
+
+# grantAccess
+
+Data encrypted through the Data Protector tool requires explicit authorization
+for runtime access. A newly created `protectedData` object has no inherent
+authorizations. This method grants permission to securely access the specified
+`protectedData` for processing using the `processProtectedData` method.
+Authorization to use the `protectedData` is given to a user in the context of an
+application (or a designated list of applications).
+
+## Usage
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const grantedAccess = await dataProtectorCore.grantAccess({
+  protectedData: '0x123abc...',
+  authorizedApp: '0x456def...',
+  authorizedUser: '0x789cba...',
+  pricePerAccess: 3,
+  numberOfAccess: 10,
+  onStatusUpdate: ({ title, isDone }) => {
+    console.log(title, isDone);
+  },
+});
+```
+
+## Parameters
+
+```ts twoslash
+import { type GrantAccessParams } from '@mage-sombre/iapp';
+```
+
+### protectedData <RequiredBadge />
+
+**Type:** `AddressOrENS`
+
+The ethereum address of the protected data supplied by the user (returned when
+you created it). **You must own this data** to grant access.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const grantedAccess = await dataProtectorCore.grantAccess({
+  protectedData: '0x123abc...', // [!code focus]
+  authorizedApp: '0x456def...',
+  authorizedUser: '0x789cba...',
+});
+```
+
+### authorizedApp <RequiredBadge />
+
+**Type:** `AddressOrENS`
+
+The address of the application you wish to authorize to process the
+`protectedData` within a secure execution environment. You may specify either a
+single application or an application whitelist. To specify a whitelist, you
+provide the ETH address of an
+[iExec Whitelist Smart Contract](https://github.com/iExecBlockchainComputing/whitelist-smart-contract/tree/main).
+This smart contract should aggregates multiple application versions. This allows
+you to introduce new versions of your application without needing to grant
+access for the `protectedData` each time you do so.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const grantedAccess = await dataProtectorCore.grantAccess({
+  protectedData: '0x123abc...',
+  authorizedApp: '0x456def...', // [!code focus]
+  authorizedUser: '0x789cba...',
+});
+```
+
+::: tip
+
+You may authorize a specific app or a whitelist of apps to use the protected
+data.
+
+The latest version of the iExec Web3Mail decentralized application is
+`{{web3MailAddress}}`.
+
+iExec also maintains a whitelist for current and past versions of Web3Mail iApp.
+Granting access to this whitelist allows use of an email `protectedData` with
+all versions of the Web3Mail application, ensuring you only have to grant this
+access once. The ETH address for this whitelist is **{{web3MailAppWhitelist}}**.
+
+:::
+
+### authorizedUser <RequiredBadge />
+
+**Type:** `AddressOrENS`
+
+The address of the user you wish to authorize to use the `protectedData`. Note
+that these users may not view or manipulate the data. This only grants
+permission for the user to submit the data to an iExec application.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const grantedAccess = await dataProtectorCore.grantAccess({
+  protectedData: '0x123abc...',
+  authorizedApp: '0x456def...',
+  authorizedUser: '0x789cba...', // [!code focus]
+});
+```
+
+::: tip
+
+You may authorize all users to use the protected data by setting this to
+**0x0000000000000000000000000000000000000000**.
+
+:::
+
+### pricePerAccess <OptionalBadge />
+
+**Type:** `number`  
+**Default:** `0`
+
+Specifies the usage fee in nano RLC (nRLC) associated with each access of the
+data. It represents the cost incurred for each individual interaction with
+application.
+
+By invoking the grantAccess method with a specific `pricePerAccess` you define
+the fee that the specified user (`authorizedUser` parameter) must pay for each
+access to the data when used with the specified application (`authorizedApp`
+parameter).
+
+The fee is paid to the owner of the protected data.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const grantedAccess = await dataProtectorCore.grantAccess({
+  protectedData: '0x123abc...',
+  authorizedApp: '0x456def...',
+  authorizedUser: '0x789cba...',
+  pricePerAccess: 3, // [!code focus]
+  numberOfAccess: 10,
+});
+```
+
+::: tip
+
+`pricePerAccess` is expressed in nano RLC (nRLC). nRLC is the smallest
+subdivision of the RLC token, 1 RLC equals to 10^9 nRLC.
+
+When provided, `pricePerAccess` must be a non-negative integer value.
+
+:::
+
+### numberOfAccess <OptionalBadge />
+
+**Type:** `number`  
+**Default:** `1`
+
+Allows restricting the number of times the protected data may be processed and
+used.
+
+It is not technically possible to set an unlimited number of accesses, but you
+can set `numberOfAccess` to `10000` for example.
+
+::: info
+
+If you attempt to process the protected data more times than specified in
+`numberOfAccess`, you will encounter a **"no dataset orders"** error.
+
+To prevent this error, ensure the `numberOfAccess` is properly set when calling
+the `grantAccess` method.
+
+:::
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const grantedAccess = await dataProtectorCore.grantAccess({
+  protectedData: '0x123abc...',
+  authorizedApp: '0x456def...',
+  authorizedUser: '0x789cba...',
+  pricePerAccess: 3,
+  numberOfAccess: 10, // [!code focus]
+});
+```
+
+### onStatusUpdate <OptionalBadge />
+
+**Type:** `OnStatusUpdateFn<GrantAccessStatuses>`
+
+Callback function to be notified at intermediate steps.
+
+<!-- prettier-ignore-start -->
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const grantedAccess = await dataProtectorCore.grantAccess({
+  protectedData: '0x123abc...',
+  authorizedApp: '0x456def...',
+  authorizedUser: '0x789cba...',
+  onStatusUpdate: ({ title, isDone }) => { // [!code focus]
+    console.log(title, isDone); // [!code focus]
+  }, // [!code focus]
+});
+```
+<!-- prettier-ignore-end -->
+
+You can expect this callback function to be called with the following titles:
+
+```ts
+'CREATE_DATASET_ORDER';
+'PUBLISH_DATASET_ORDER';
+```
+
+Once with `isDone: false`, and then with `isDone: true`
+
+## Return Value
+
+```ts twoslash
+import { type GrantedAccess } from '@mage-sombre/iapp';
+```
+
+The result of this method confirms the new access grant. It consists of a JSON
+`grantedAccess` object.
+
+[`GrantedAccess`](/references/iapp-generator/sdk/types#grantedaccess)
+
+<script setup>
+import { computed } from 'vue';
+import useUserStore  from '@/stores/useUser.store';
+import {getChainById} from '@/utils/chain.utils';
+import RequiredBadge from '@/components/RequiredBadge.vue'
+import OptionalBadge from '@/components/OptionalBadge.vue'
+
+// Get current chain info
+const userStore = useUserStore();
+const selectedChain = computed(() => userStore.getCurrentChainId());
+
+const chainData = computed(() => getChainById(selectedChain.value));
+const web3MailAddress = computed(() => chainData.value.web3MailAddress);
+const web3MailAppWhitelist = computed(() => chainData.value.web3MailAppWhitelist);
+</script>
diff --git a/src/references/iapp-generator/sdk/revokeAllAccess.md b/src/references/iapp-generator/sdk/revokeAllAccess.md
new file mode 100644
index 00000000..7aedae13
--- /dev/null
+++ b/src/references/iapp-generator/sdk/revokeAllAccess.md
@@ -0,0 +1,148 @@
+---
+title: revokeAllAccess
+description:
+  Revoke all or specific access permissions to protected data with iExec's
+  revokeAllAccess method. Efficiently manage data security by removing access
+  from users or smart contract.
+---
+
+# revokeAllAccess
+
+This method allows revoking authorizations granted to a `protectedData` entity.
+You may optionally specify application or user addresses for revocation. If you
+do not specify either of these optional values, this method will revoke all
+access for all users and applications.
+
+You must be the owner of the protected data.
+
+Under the hood, all granted access will be retrieved and be revoked one by one.
+If by any chance there were **more than 20 granted access** to be revoked, you
+would need to call this `revokeAllAccess()` method more than once for all
+granted access to be actually revoked. Use `getGrantedAccess()` to ensure it is
+all done.
+
+## Usage
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const revokeAllAccessResult = await dataProtectorCore.revokeAllAccess({
+  protectedData: '0x123abc...',
+  authorizedApp: '0x456def...',
+  authorizedUser: '0x789cba...',
+});
+```
+
+## Parameters
+
+```ts twoslash
+import { type RevokeAllAccessParams } from '@mage-sombre/iapp';
+```
+
+### protectedData <RequiredBadge />
+
+**Type:** `AddressOrENS`
+
+The address of the `protectedData` subject to access revocation.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const revokeAllAccessResult = await dataProtectorCore.revokeAllAccess({
+  protectedData: '0x123abc...', // [!code focus]
+});
+```
+
+### authorizedApp <OptionalBadge />
+
+**Type:** `AddressOrENS`
+
+The application address to be removed from the authorization list for the
+specified `protectedData`. If no address is specified, it will revoke all access
+from the protected data, regardless of the app.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const revokeAllAccessResult = await dataProtectorCore.revokeAllAccess({
+  protectedData: '0x123abc...',
+  authorizedApp: '0x456def...', // [!code focus]
+  authorizedUser: '0x789cba...',
+});
+```
+
+### authorizedUser <OptionalBadge />
+
+**Type:** `AddressOrENS`
+
+The user address to be removed from the authorization list for the specified
+`protectedData`. If no address is specified, it will revoke all access from the
+protected data, regardless of the authorized user.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const revokeAllAccessResult = await dataProtectorCore.revokeAllAccess({
+  protectedData: '0x123abc...',
+  authorizedApp: '0x456def...',
+  authorizedUser: '0x789cba...', // [!code focus]
+});
+```
+
+### onStatusUpdate <OptionalBadge />
+
+**Type:** `OnStatusUpdateFn<RevokeAllAccessStatuses>`
+
+Callback function to be notified at intermediate steps.
+
+<!-- prettier-ignore-start -->
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const revokeAllAccessResult = await dataProtectorCore.revokeAllAccess({
+  protectedData: '0x123abc...',
+  authorizedApp: '0x456def...',
+  authorizedUser: '0x789cba...',
+  onStatusUpdate: ({ title, isDone }) => { // [!code focus]
+    console.log(title, isDone); // [!code focus]
+  }, // [!code focus]
+});
+```
+<!-- prettier-ignore-end -->
+
+You can expect this callback function to be called with the following titles:
+
+```ts
+'RETRIEVE_ALL_GRANTED_ACCESS';
+'REVOKE_ONE_ACCESS';
+```
+
+Once with `isDone: false`, and then with `isDone: true`
+
+## Return Value
+
+```ts twoslash
+import { type RevokedAccess } from '@mage-sombre/iapp';
+```
+
+[`RevokedAccess[]`](/references/iapp-generator/sdk/types#revokedaccess)
+
+<script setup>
+import RequiredBadge from '@/components/RequiredBadge.vue'
+import OptionalBadge from '@/components/OptionalBadge.vue'
+</script>
diff --git a/src/references/iapp-generator/sdk/revokeOneAccess.md b/src/references/iapp-generator/sdk/revokeOneAccess.md
new file mode 100644
index 00000000..e05fe973
--- /dev/null
+++ b/src/references/iapp-generator/sdk/revokeOneAccess.md
@@ -0,0 +1,96 @@
+---
+title: revokeOneAccess
+description:
+  Revoke specific access permissions to protected data with iExec's
+  revokeOneAccess method. Manage and remove access granted to users or
+  applications through blockchain transactions.
+---
+
+# revokeOneAccess
+
+This method allows revoking a specific access authorization from a
+`protectedData` entity. The input parameter for this method is sourced from the
+[getGrantedAccess](getGrantedAccess.md) method, which provides a list of all
+authorizations on single `protectedData` entity.
+
+As this will generate a blockchain transaction, expect it to take a least 5sec
+(a block time).
+
+## Usage
+
+The `revokeOneAccess` method requires a `grantedAccess` object as an input
+parameter. This object is retrieved from the
+[`getGrantedAccess`](/references/dataProtector/dataProtectorCore/getGrantedAccess)
+method.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const revokeAccess = await dataProtectorCore.revokeOneAccess({
+  apprestrict: '0xea...',
+  dataset: '0xA0C...',
+  datasetprice: '0',
+  requesterrestrict: '0xecb..',
+  salt: '0x0147...',
+  sign: '0xc22c1...',
+  tag: '0x0000000000000000000000000000000000000000000000000000000000000003',
+  volume: '1',
+  workerpoolrestrict: '0x000...',
+});
+```
+
+## Parameters
+
+```ts twoslash
+import { type GrantedAccess } from '@mage-sombre/iapp';
+```
+
+### grantedAccess <RequiredBadge />
+
+**Type:** `GrantedAccess`
+
+This is the complete `granted access` object retrieved from an invocation of
+`getGrantedAccess`.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const revokeAccess = await dataProtectorCore.revokeOneAccess({
+  apprestrict: '0xea...', // [!code focus]
+  dataset: '0xA0C...', // [!code focus]
+  datasetprice: '0', // [!code focus]
+  requesterrestrict: '0xecb..', // [!code focus]
+  salt: '0x0147...', // [!code focus]
+  sign: '0xc22c1...', // [!code focus]
+  tag: '0x0000000000000000000000000000000000000000000000000000000000000003', // [!code focus]
+  volume: '1', // [!code focus]
+  workerpoolrestrict: '0x000...', // [!code focus]
+});
+```
+
+::: warning
+
+The tag must always be set to
+`0x0000000000000000000000000000000000000000000000000000000000000003`. This
+specific value indicates that the order is for a confidential asset (a protected
+data).
+
+:::
+
+## Result Value
+
+```ts twoslash
+import { type RevokedAccess } from '@mage-sombre/iapp';
+```
+
+[`RevokedAccess`](/references/iapp-generator/sdk/types#revokedaccess)
+
+<script setup>
+import RequiredBadge from '@/components/RequiredBadge.vue'
+</script>
diff --git a/src/references/iapp-generator/sdk/runIApp.md b/src/references/iapp-generator/sdk/runIApp.md
new file mode 100644
index 00000000..d4c5f3bf
--- /dev/null
+++ b/src/references/iapp-generator/sdk/runIApp.md
@@ -0,0 +1,497 @@
+---
+title: runIApp
+description:
+  Process encrypted data securely with iExec's runIApp method. Use authorized
+  applications to process protected datasets while maintaining data privacy and
+  security.
+---
+
+# runIApp
+
+Allows processing a protected dataset through use of a specified iExec
+application.
+
+> [!IMPORTANT]
+>
+> You must ensure this application has authorization to use the `protectedData`.
+> You may grant this permission using the
+> [`grantAccess`](/references/dataProtector/dataProtectorCore/grantAccess)
+> method.
+
+## Usage
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const processProtectedDataResponse = await dataProtectorCore.runIApp({
+  protectedData: '0x123abc...',
+  app: '0x456def...',
+  args: 'arg1 arg2',
+  inputFiles: ['https://example.com/file1', 'https://example.com/file2'],
+  secrets: {
+    1: 'secret1',
+    2: 'secret2',
+  },
+});
+```
+
+## Parameters
+
+```ts twoslash
+import { type ProcessProtectedDataParams } from '@mage-sombre/iapp';
+```
+
+### protectedData <RequiredBadge />
+
+**Type:** `AddressOrENS`
+
+The ETH address or Ethereum Name Service (ENS) reference for the protected data
+you wish the `app` to process.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const processProtectedDataResponse = await dataProtectorCore.runIApp({
+  protectedData: '0x123abc...', // [!code focus]
+  app: '0x456def...',
+});
+```
+
+### app <RequiredBadge />
+
+**Type:** `AddressOrENS`
+
+The ETH address or Ethereum Name Service (ENS) address for the iExec application
+to process the protected data.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const processProtectedDataResponse = await dataProtectorCore.runIApp({
+  protectedData: '0x123abc...',
+  app: '0x456def...', // [!code focus]
+});
+```
+
+### path <OptionalBadge />
+
+**Type:** `string`
+
+Under the hood, a protected data is a zip file. With this `path` parameter, you
+can specify the file you're interested in. The zip file will be uncompressed for
+you, and only the desired file will be given as the `result`.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const processProtectedDataResponse = await dataProtectorCore.runIApp({
+  protectedData: '0x123abc...',
+  app: '0x456def...',
+  path: 'my-content', // [!code focus]
+});
+```
+
+### userWhitelist <OptionalBadge />
+
+**Type:** `Address`
+
+If access to the protected data is granted to a group of users via a whitelist
+contract, you must use this `userWhitelist` parameter. The value should be the
+whitelist contract address that has access to the protected data.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const processProtectedDataResponse = await dataProtectorCore.runIApp({
+  protectedData: '0x123abc...',
+  app: '0x456def...',
+  userWhitelist: '0x656def...', // [!code focus]
+});
+```
+
+### useVoucher <ChainNotSupportedBadge /> <OptionalBadge />
+
+**Type:** `boolean`  
+**Default:** `false`
+
+This optional parameter allows you to pay for the task using a voucher. By
+default, it uses the voucher associated with your connected wallet, but you can
+override this by specifying a voucherAddress.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const processProtectedDataResponse = await dataProtectorCore.runIApp({
+  protectedData: '0x123abc...',
+  app: '0x456def...',
+  useVoucher: true, // [!code focus]
+});
+```
+
+::: tip
+
+If your voucher doesn't have enough RLC to cover the deal, the SDK will
+automatically get the required amount to your iExec account. Ensure that your
+voucher is authorized to access your iExec account and that your account has
+sufficient funds for this transfer to proceed.
+
+:::
+
+### voucherOwner <ChainNotSupportedBadge /> <OptionalBadge />
+
+**Type:** `Address`
+
+This optional parameter allows you to pay for the task using someone else’s
+voucher. Make sure the voucher's owner has authorized you to use it. This
+parameter must be used in combination with `useVoucher: true`.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const processProtectedDataResponse = await dataProtectorCore.runIApp({
+  protectedData: '0x123abc...',
+  app: '0x456def...',
+  useVoucher: true, // [!code focus]
+  voucherOwner: '0x5714eB...', // [!code focus]
+});
+```
+
+### args <OptionalBadge />
+
+**Type:** `string`
+
+Set of execution arguments for the application.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const processProtectedDataResponse = await dataProtectorCore.runIApp({
+  protectedData: '0x123abc...',
+  app: '0x456def...',
+  args: 'arg1 arg2', // [!code focus]
+});
+```
+
+::: danger
+
+Do not use this to provide any sensitive information to the application. All
+arguments passed this way are visible in plain text using the
+<a :href="explorerUrl" target="_blank" rel="noopener">iExec explorer</a> .
+
+:::
+
+### inputFiles <OptionalBadge />
+
+**Type:** `string[]`
+
+A set of URLs representing the input files required for application execution.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const processProtectedDataResponse = await dataProtectorCore.runIApp({
+  protectedData: '0x123abc...',
+  app: '0x456def...',
+  inputFiles: ['https://example.com/file1', 'https://example.com/file2'], // [!code focus]
+});
+```
+
+### secrets <OptionalBadge />
+
+**Type:** `Record<number, string>`
+
+A set of requester secrets necessary for the application's execution. This is
+represented as a mapping of numerical identifiers to corresponding secrets
+stored in the secrets manager needed for the application's execution.
+
+Secrets are accessible during the application's execution as environment
+variables. For more details, see
+[Access requester secrets](/guides/build-iapp/advanced/access-confidential-assets).
+
+<!-- prettier-ignore-start -->
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const processProtectedDataResponse = await dataProtectorCore.runIApp({
+  protectedData: '0x123abc...',
+  app: '0x456def...',
+  secrets: { // [!code focus]
+    1: 'secret1', // [!code focus]
+    2: 'secret2', // [!code focus]
+  }, // [!code focus]
+});
+```
+<!-- prettier-ignore-end -->
+
+### workerpool <OptionalBadge />
+
+**Type:** `AddressOrENS | 'any'`  
+**Default:** `{{ workerpoolAddress }}`
+
+It's the confidential computer on which the iExec application will run.
+
+::: tip
+
+iExec currently offers a workerpool located at the address
+`{{ workerpoolAddress }}`. This is the default workerpool for running
+confidential computations on the iExec platform.
+
+:::
+
+::: info TDX <ChainNotSupportedBadge/>
+
+🧪 While protected data are processed in **TEE** by **intel SGX** technology by
+default, `@mage-sombre/iapp` can be configured to create and process protected
+data in the experimental **intel TDX** environment.
+
+TDX mode is enabled by setting connecting the **TDX SMS** and using the **TDX
+workerpool**.
+
+```ts twoslash [Browser]
+declare global {
+  interface Window {
+    ethereum: any;
+  }
+}
+// ---cut---
+import { IExecIApp } from '@mage-sombre/iapp';
+
+const web3Provider = window.ethereum;
+// Instantiate dataProtector connected to the TDX SMS
+const dataProtectorCore = new IExecIApp(web3Provider, {
+  iexecOptions: {
+    smsURL: 'https://sms.labs.iex.ec', // [!code focus]
+  },
+});
+
+const processProtectedDataResponse = await dataProtectorCore.runIApp({
+  protectedData: '0x123abc...',
+  app: '0x456def...',
+  workerpool: 'tdx-labs.pools.iexec.eth', // [!code focus]
+});
+```
+
+⚠️ Keep in mind: TDX mode is experimental and can be subject to instabilities or
+discontinuity.
+
+:::
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const processProtectedDataResponse = await dataProtectorCore.runIApp({
+  protectedData: '0x123abc...',
+  app: '0x456def...',
+  workerpool: '0xa5de76...', // [!code focus]
+});
+```
+
+### dataMaxPrice <OptionalBadge />
+
+**Type:** `number`  
+**Default:** `0`
+
+Allows specifying the maximum amount (in nRLC) you are willing to pay the
+protected data owner for using their data. The owner of the protected data
+receives this as a payment for sharing their data.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const processProtectedDataResponse = await dataProtectorCore.runIApp({
+  protectedData: '0x123abc...',
+  app: '0x456def...',
+  dataMaxPrice: 42, // [!code focus]
+});
+```
+
+### appMaxPrice <OptionalBadge />
+
+**Type:** `number`  
+**Default:** `0`
+
+Allows specifying the maximum amount (in nRLC) you are willing to pay the iApp
+provider for using the deployed application.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const processProtectedDataResponse = await dataProtectorCore.runIApp({
+  protectedData: '0x123abc...',
+  app: '0x456def...',
+  appMaxPrice: 42, // [!code focus]
+});
+```
+
+### workerpoolMaxPrice <OptionalBadge />
+
+**Type:** `number`  
+**Default:** `0`
+
+Allows specifying the maximum amount you want to pay the workerpool provider for
+using their infrastructure to run the iApp in nRLC.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const processProtectedDataResponse = await dataProtectorCore.runIApp({
+  protectedData: '0x123abc...',
+  app: '0x456def...',
+  workerpoolMaxPrice: 42, // [!code focus]
+});
+```
+
+### onStatusUpdate <OptionalBadge />
+
+**Type:** `OnStatusUpdateFn<ProcessProtectedDataStatuses>`
+
+Callback function to be notified at intermediate steps.
+
+<!-- prettier-ignore-start -->
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const processProtectedDataResponse = await dataProtectorCore.runIApp({
+  protectedData: '0x123abc...',
+  app: '0x456def...',
+  onStatusUpdate: ({ title, isDone }) => { // [!code focus]
+    console.log(title, isDone); // [!code focus]
+  }, // [!code focus]
+});
+```
+<!-- prettier-ignore-end -->
+
+You can expect this callback function to be called with the following titles:
+
+```ts
+'FETCH_PROTECTED_DATA_ORDERBOOK';
+'FETCH_APP_ORDERBOOK';
+'FETCH_WORKERPOOL_ORDERBOOK';
+'PUSH_REQUESTER_SECRET';
+'REQUEST_TO_PROCESS_PROTECTED_DATA';
+'CONSUME_TASK';
+'CONSUME_RESULT_DOWNLOAD';
+'CONSUME_RESULT_DECRYPT';
+```
+
+Once with `isDone: false`, and then with `isDone: true`
+
+## Return Value
+
+```ts twoslash
+import { type ProcessProtectedDataResponse } from '@mage-sombre/iapp';
+```
+
+### txHash
+
+`string`
+
+The ID of the transaction that happened on iExec's side chain. You may view
+details on the transaction using the
+<a :href="explorerUrl" target="_blank" rel="noopener">iExec explorer</a> .
+
+### dealId
+
+`string`
+
+Identifies the specific deal associated with this transaction.
+
+### taskId
+
+`string`
+
+A unique identifier associated with a task currently running on the iExec
+protocol. You can monitor task execution using the
+<a :href="explorerUrl" target="_blank" rel="noopener">iExec explorer</a> .
+
+::: tip
+
+The
+[getResultFromCompletedTask()](/references/dataProtector/dataProtectorCore/getResultFromCompletedTask)
+function allows you to retrieve the result of a completed task using its
+`taskId`.
+
+Additionally, you can specify a **file path** within the ZIP archive to extract
+a specific file when required.
+
+:::
+
+### result
+
+`ArrayBuffer`
+
+The result is a ZIP file containing at least one mandatory file:
+
+- **computed.json**: This file contains metadata about the computation performed
+  by the application.
+- additional files may be included depending on the dapp used.
+
+::: info
+
+In the case of the **Content Creator Delivery DApp**, the ZIP file will also
+include a file named **content**, which corresponds to the protected data
+processed during the task.
+
+:::
+
+<script setup>
+import { computed } from 'vue';
+import RequiredBadge from '@/components/RequiredBadge.vue'
+import OptionalBadge from '@/components/OptionalBadge.vue'
+import ChainNotSupportedBadge from '@/components/ChainNotSupportedBadge.vue'
+import useUserStore  from '@/stores/useUser.store';
+import {getChainById} from '@/utils/chain.utils';
+
+// Get current chain info
+const userStore = useUserStore();
+const selectedChain = computed(() => userStore.getCurrentChainId());
+
+const chainData = computed(() => getChainById(selectedChain.value));
+const explorerUrl = computed(() => chainData.value.iexecExplorerUrl);
+const workerpoolAddress = computed(() => chainData.value.workerpoolAddress);
+</script>
diff --git a/src/references/iapp-generator/sdk/transferOwnership.md b/src/references/iapp-generator/sdk/transferOwnership.md
new file mode 100644
index 00000000..f33e73a8
--- /dev/null
+++ b/src/references/iapp-generator/sdk/transferOwnership.md
@@ -0,0 +1,109 @@
+---
+title: transferOwnership
+description:
+  Transfer ownership of protected data to a new owner with iExec's
+  transferOwnership method. Securely update data ownership and automatically
+  revoke previous access permissions.
+---
+
+# transferOwnership
+
+Allows transferring ownership of a `protectedData` entity to a new owner,
+identified by their ETH address. The return value provides a transaction hash
+and confirmation of the new owner of the `protectedData`. Only the current owner
+of the `protectedData` may invoke this method.
+
+When transferring the `protectedData`, the grantedAccess created by the previous
+owner are revoked automatically.
+
+Ownership of the `protectedData` can be renounced by transferring it to the burn
+address `0x000000000000000000000000000000000000dEaD`.
+
+## Usage
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const transferResponse = await dataProtectorCore.transferOwnership({
+  protectedData: '0x123abc...',
+  newOwner: '0xc5e9f4...',
+});
+```
+
+## Parameters
+
+```ts twoslash
+import { type TransferParams } from '@mage-sombre/iapp';
+```
+
+### protectedData <RequiredBadge />
+
+**Type:** `AddressOrENS`
+
+ETH address of the `protectedData` owned by you which is to be transferred to a
+new owner.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const transferResponse = await dataProtectorCore.transferOwnership({
+  protectedData: '0x123abc...', // [!code focus]
+  newOwner: '0xc5e9f4...',
+});
+```
+
+### newOwner <RequiredBadge />
+
+**Type:** `AddressOrENS`
+
+ETH address for the new owner for the `protectedData`.
+
+```ts twoslash
+import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecIApp(web3Provider);
+// ---cut---
+const transferResponse = await dataProtectorCore.transferOwnership({
+  protectedData: '0x123abc...',
+  newOwner: '0xc5e9f4...', // [!code focus]
+});
+```
+
+## Return Value
+
+```ts twoslash
+import { type TransferResponse } from '@mage-sombre/iapp';
+```
+
+The result of this method is an array of objects identifying the new owner. The
+objects contain the three fields:
+
+### address
+
+`Address`
+
+The ETH address of the `protectedData` you transferred.
+
+### to
+
+`AddressOrENS`
+
+The ETH address of the new owner of the `protectedData`.
+
+### txHash
+
+`string`
+
+The ID of the transaction that happened on iExec's side chain. You may view
+details on the transaction using the [iExec explorer](https://explorer.iex.ec).
+
+<script setup>
+import RequiredBadge from '@/components/RequiredBadge.vue'
+</script>
diff --git a/src/references/iapp-generator/sdk/types.md b/src/references/iapp-generator/sdk/types.md
new file mode 100644
index 00000000..1010d1be
--- /dev/null
+++ b/src/references/iapp-generator/sdk/types.md
@@ -0,0 +1,116 @@
+---
+title: Types
+description:
+  Complete reference for DataProtector types including GrantedAccess,
+  ProtectedData, Collection, and other essential data structures.
+---
+
+# Types
+
+Types in DataProtector.
+
+## 🔑 GrantedAccess
+
+### dataset: <span class="text-yellow">`string`</span>
+
+- Address of the `protectedData` containing user data
+
+### datasetprice: <span class="text-yellow">`string`</span>
+
+- Price (in nRLC) to charge the user specified in `requesterrestrict` for each
+  use of this `protectedData`
+
+### volume: <span class="text-yellow">`string`</span>
+
+- Number of authorized uses of this `protectedData`; each use decrements this
+  counter
+
+### tag: <span class="text-yellow">`string`</span>
+
+- Defines whether a `protectedData` is usable in a TEE environment; `0x00` is
+  TEE while `0x03` is non-TEE
+
+### apprestrict: <span class="text-yellow">`string`</span>
+
+- Address of the authorized application; a value of 0x0 indicates any
+  application may access this data
+
+### requesterrestrict: <span class="text-yellow">`string`</span>
+
+- Address of the requester authorized to use this `protectedData` in workloads;
+  a value of 0x0 indicates any requester may use this data
+
+### workerpoolrestrict: <span class="text-yellow">`string`</span>
+
+- Address of the decentralized infrastructure (worker pool) authorized to
+  execute the application; a value of 0x0 indicates any worker pool may access
+  this data
+
+### salt: <span class="text-yellow">`string`</span>
+
+- Random value to make an order unique and reusable as nonce in a blockchain
+  transaction
+
+### sign: <span class="text-yellow">`string`</span>
+
+- Order signature of all the `grantedAccess` fields
+
+## 🔐 ProtectedData
+
+### name: <span class="text-yellow">`string`</span>
+
+- Name specified when the protected data was created. This piece of information
+  is public and visible on-chain.
+
+### address: <span class="text-yellow">`Address`</span>
+
+- Ethereum address of the protected data.
+
+### owner: <span class="text-yellow">`Address`</span>
+
+- Ethereum address of the protected data owner.
+
+### creationTimestamp: <span class="text-yellow">`number`</span>
+
+- Timestamp specifying when the protected data was created, expressed in
+  milliseconds since the epoch. This timestamp provides precise information
+  about the moment of creation and can be used for chronological ordering or
+  time-based operations.
+
+### multiaddr: <span class="text-yellow">`string` | `undefined`</span>
+
+- The multiaddr field is the IPFS path of your encrypted data.
+
+## ❌ RevokedAccess
+
+### access: <span class="text-yellow">[`GrantedAccess`](#-grantedaccess)</span>
+
+- The granted access that was revoked.
+
+### txHash: <span class="text-yellow">`string`</span>
+
+- The ID of the transaction that happened on iExec's side chain. You may view
+  details on the transaction using the
+  [iExec explorer](https://explorer.iex.ec).
+
+<!-- prettier-ignore-start -->
+_Hash example:_ `0xc9c2d58fc01fe54149b7daf49a0026d4ab1fdd3d10fb7c76350790fff03fe24d`
+<!-- prettier-ignore-end -->
+
+You can read more about the
+[iExec Explorer](/get-started/tooling-and-explorers/iexec-explorer).
+
+## ✅ SuccessWithTransactionHash
+
+### txHash: <span class="text-yellow">`string`</span>
+
+- The hash of the transaction that happened on iExec's side chain. You may view
+  details on the transaction using the
+  [iExec explorer](https://explorer.iex.ec).
+
+<!-- prettier-ignore-start -->
+_Hash example:_ `0xc9c2d58fc01fe54149b7daf49a0026d4ab1fdd3d10fb7c76350790fff03fe24d`
+<!-- prettier-ignore-end -->
+
+You can read more about the [iExec Explorer]
+(/get-started/tooling-and-explorers/iexec-explorer).

From d34e91f88d2cca084db9f877181ca7a2fba37f99 Mon Sep 17 00:00:00 2001
From: Le-Caignec <robinlecaignec@yahoo.fr>
Date: Thu, 25 Sep 2025 12:15:41 +0200
Subject: [PATCH 04/11] refactor(docs): update DataProtector and iApp types
 documentation for clarity and consistency

---
 src/references/dataProtector/types.md      | 10 +++---
 src/references/iapp-generator/sdk/types.md | 40 +++++++++++-----------
 2 files changed, 25 insertions(+), 25 deletions(-)

diff --git a/src/references/dataProtector/types.md b/src/references/dataProtector/types.md
index c679ce0f..419cddf0 100644
--- a/src/references/dataProtector/types.md
+++ b/src/references/dataProtector/types.md
@@ -22,8 +22,11 @@ Types in DataProtector.
 
 ### volume: <span class="text-yellow">`string`</span>
 
-- Number of authorized uses of this `protectedData`; each use decrements this
-  counter
+- Total number of authorized accesses for processing a Protected Data when the access was signed and published
+
+### remainingAccess: <span class="text-yellow">`number`</span>
+
+- Number of remaining authorized accesses for processing a protected data; each use decrements this counter
 
 ### tag: <span class="text-yellow">`string`</span>
 
@@ -120,6 +123,3 @@ You can read more about the
 <!-- prettier-ignore-start -->
 _Hash example:_ `0xc9c2d58fc01fe54149b7daf49a0026d4ab1fdd3d10fb7c76350790fff03fe24d`
 <!-- prettier-ignore-end -->
-
-You can read more about the [iExec Explorer]
-(/get-started/tooling-and-explorers/iexec-explorer).
diff --git a/src/references/iapp-generator/sdk/types.md b/src/references/iapp-generator/sdk/types.md
index 1010d1be..e3ffb374 100644
--- a/src/references/iapp-generator/sdk/types.md
+++ b/src/references/iapp-generator/sdk/types.md
@@ -1,7 +1,7 @@
 ---
 title: Types
 description:
-  Complete reference for DataProtector types including GrantedAccess,
+  Complete reference for iApp types including GrantedAccess,
   ProtectedData, Collection, and other essential data structures.
 ---
 
@@ -11,33 +11,36 @@ Types in DataProtector.
 
 ## 🔑 GrantedAccess
 
-### dataset: <span class="text-yellow">`string`</span>
+### app: <span class="text-yellow">`string`</span>
 
-- Address of the `protectedData` containing user data
+- Address of the iExec Tee application (IApp)
 
-### datasetprice: <span class="text-yellow">`string`</span>
+### appprice: <span class="text-yellow">`string`</span>
 
 - Price (in nRLC) to charge the user specified in `requesterrestrict` for each
-  use of this `protectedData`
+  use of this `iapp`
 
 ### volume: <span class="text-yellow">`string`</span>
 
-- Number of authorized uses of this `protectedData`; each use decrements this
-  counter
+- Total number of authorized accesses for running an iApp when the access was signed and published
+
+### remainingAccess: <span class="text-yellow">`number`</span>
+
+- Number of remaining authorized accesses for running an iApp; each use decrements this counter
 
 ### tag: <span class="text-yellow">`string`</span>
 
 - Defines whether a `protectedData` is usable in a TEE environment; `0x00` is
   TEE while `0x03` is non-TEE
 
-### apprestrict: <span class="text-yellow">`string`</span>
+### datasetrestrict: <span class="text-yellow">`string`</span>
 
-- Address of the authorized application; a value of 0x0 indicates any
-  application may access this data
+- Address of the authorized protected data; a value of 0x0 indicates any
+  protected data may run with this iapp
 
 ### requesterrestrict: <span class="text-yellow">`string`</span>
 
-- Address of the requester authorized to use this `protectedData` in workloads;
+- Address of the requester authorized to run this `iapp` in workloads;
   a value of 0x0 indicates any requester may use this data
 
 ### workerpoolrestrict: <span class="text-yellow">`string`</span>
@@ -55,31 +58,31 @@ Types in DataProtector.
 
 - Order signature of all the `grantedAccess` fields
 
-## 🔐 ProtectedData
+## 🔐 IApp
 
 ### name: <span class="text-yellow">`string`</span>
 
-- Name specified when the protected data was created. This piece of information
+- Name specified when the iApp was created. This piece of information
   is public and visible on-chain.
 
 ### address: <span class="text-yellow">`Address`</span>
 
-- Ethereum address of the protected data.
+- Ethereum address of the iapp.
 
 ### owner: <span class="text-yellow">`Address`</span>
 
-- Ethereum address of the protected data owner.
+- Ethereum address of the iapp owner.
 
 ### creationTimestamp: <span class="text-yellow">`number`</span>
 
-- Timestamp specifying when the protected data was created, expressed in
+- Timestamp specifying when the iapp was created, expressed in
   milliseconds since the epoch. This timestamp provides precise information
   about the moment of creation and can be used for chronological ordering or
   time-based operations.
 
 ### multiaddr: <span class="text-yellow">`string` | `undefined`</span>
 
-- The multiaddr field is the IPFS path of your encrypted data.
+- The multiaddr field is the IPFS path of iapp published on Dockerhub.
 
 ## ❌ RevokedAccess
 
@@ -111,6 +114,3 @@ You can read more about the
 <!-- prettier-ignore-start -->
 _Hash example:_ `0xc9c2d58fc01fe54149b7daf49a0026d4ab1fdd3d10fb7c76350790fff03fe24d`
 <!-- prettier-ignore-end -->
-
-You can read more about the [iExec Explorer]
-(/get-started/tooling-and-explorers/iexec-explorer).

From 841ed303f5680651cef8974a5c08180b58f13f20 Mon Sep 17 00:00:00 2001
From: Le-Caignec <robinlecaignec@yahoo.fr>
Date: Thu, 25 Sep 2025 15:25:03 +0200
Subject: [PATCH 05/11] fix(docs): update transferOwnership and types
 documentation to reflect iApp terminology

---
 .../iapp-generator/sdk/transferOwnership.md   | 30 +++++++++----------
 src/references/iapp-generator/sdk/types.md    | 14 ++++-----
 2 files changed, 22 insertions(+), 22 deletions(-)

diff --git a/src/references/iapp-generator/sdk/transferOwnership.md b/src/references/iapp-generator/sdk/transferOwnership.md
index f33e73a8..c1353df6 100644
--- a/src/references/iapp-generator/sdk/transferOwnership.md
+++ b/src/references/iapp-generator/sdk/transferOwnership.md
@@ -1,22 +1,22 @@
 ---
 title: transferOwnership
 description:
-  Transfer ownership of protected data to a new owner with iExec's
-  transferOwnership method. Securely update data ownership and automatically
+  Transfer ownership of an iApp to a new owner with iExec's
+  transferOwnership method. Securely update iApp ownership and automatically
   revoke previous access permissions.
 ---
 
 # transferOwnership
 
-Allows transferring ownership of a `protectedData` entity to a new owner,
+Allows transferring ownership of an `iApp` entity to a new owner,
 identified by their ETH address. The return value provides a transaction hash
-and confirmation of the new owner of the `protectedData`. Only the current owner
-of the `protectedData` may invoke this method.
+and confirmation of the new owner of the `iApp`. Only the current owner
+of the `iApp` may invoke this method.
 
-When transferring the `protectedData`, the grantedAccess created by the previous
+When transferring the `iApp`, the grantedAccess created by the previous
 owner are revoked automatically.
 
-Ownership of the `protectedData` can be renounced by transferring it to the burn
+Ownership of the `iApp` can be renounced by transferring it to the burn
 address `0x000000000000000000000000000000000000dEaD`.
 
 ## Usage
@@ -28,7 +28,7 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
 const transferResponse = await dataProtectorCore.transferOwnership({
-  protectedData: '0x123abc...',
+  iapp: '0x123abc...',
   newOwner: '0xc5e9f4...',
 });
 ```
@@ -39,11 +39,11 @@ const transferResponse = await dataProtectorCore.transferOwnership({
 import { type TransferParams } from '@mage-sombre/iapp';
 ```
 
-### protectedData <RequiredBadge />
+### iapp <RequiredBadge />
 
 **Type:** `AddressOrENS`
 
-ETH address of the `protectedData` owned by you which is to be transferred to a
+ETH address of the `iApp` owned by you which is to be transferred to a
 new owner.
 
 ```ts twoslash
@@ -53,7 +53,7 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
 const transferResponse = await dataProtectorCore.transferOwnership({
-  protectedData: '0x123abc...', // [!code focus]
+  iapp: '0x123abc...', // [!code focus]
   newOwner: '0xc5e9f4...',
 });
 ```
@@ -62,7 +62,7 @@ const transferResponse = await dataProtectorCore.transferOwnership({
 
 **Type:** `AddressOrENS`
 
-ETH address for the new owner for the `protectedData`.
+ETH address for the new owner for the `iApp`.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -71,7 +71,7 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
 const transferResponse = await dataProtectorCore.transferOwnership({
-  protectedData: '0x123abc...',
+  iapp: '0x123abc...',
   newOwner: '0xc5e9f4...', // [!code focus]
 });
 ```
@@ -89,13 +89,13 @@ objects contain the three fields:
 
 `Address`
 
-The ETH address of the `protectedData` you transferred.
+The ETH address of the `iApp` you transferred.
 
 ### to
 
 `AddressOrENS`
 
-The ETH address of the new owner of the `protectedData`.
+The ETH address of the new owner of the `iApp`.
 
 ### txHash
 
diff --git a/src/references/iapp-generator/sdk/types.md b/src/references/iapp-generator/sdk/types.md
index e3ffb374..4ebb500d 100644
--- a/src/references/iapp-generator/sdk/types.md
+++ b/src/references/iapp-generator/sdk/types.md
@@ -1,13 +1,13 @@
 ---
 title: Types
 description:
-  Complete reference for iApp types including GrantedAccess,
-  ProtectedData, Collection, and other essential data structures.
+  Complete reference for iApp Generator SDK types including GrantedAccess,
+  IApp and other essential data structures.
 ---
 
 # Types
 
-Types in DataProtector.
+Types in iApp Generator SDK.
 
 ## 🔑 GrantedAccess
 
@@ -30,18 +30,18 @@ Types in DataProtector.
 
 ### tag: <span class="text-yellow">`string`</span>
 
-- Defines whether a `protectedData` is usable in a TEE environment; `0x00` is
+- Defines whether an `iApp` is usable in a TEE environment; `0x00` is
   TEE while `0x03` is non-TEE
 
 ### datasetrestrict: <span class="text-yellow">`string`</span>
 
 - Address of the authorized protected data; a value of 0x0 indicates any
-  protected data may run with this iapp
+  protected data may run with this iApp
 
 ### requesterrestrict: <span class="text-yellow">`string`</span>
 
-- Address of the requester authorized to run this `iapp` in workloads;
-  a value of 0x0 indicates any requester may use this data
+- Address of the requester authorized to run this `iApp` in workloads;
+  a value of 0x0 indicates any requester may use this iApp
 
 ### workerpoolrestrict: <span class="text-yellow">`string`</span>
 

From a69ccb46a0feb0aa53c69013d259a36cf9e367a3 Mon Sep 17 00:00:00 2001
From: Le-Caignec <robinlecaignec@yahoo.fr>
Date: Thu, 25 Sep 2025 15:43:36 +0200
Subject: [PATCH 06/11] refactor(docs): update iApp documentation to enhance
 clarity and consistency in terminology

---
 .../iapp-generator/sdk/getGrantedAccess.md    |  46 +--
 src/references/iapp-generator/sdk/getIApp.md  | 144 ++++----
 .../iapp-generator/sdk/grantAccess.md         |  72 ++--
 .../iapp-generator/sdk/revokeAllAccess.md     |  48 +--
 .../iapp-generator/sdk/revokeOneAccess.md     |  45 +--
 src/references/iapp-generator/sdk/runIApp.md  | 317 ++++++------------
 6 files changed, 259 insertions(+), 413 deletions(-)

diff --git a/src/references/iapp-generator/sdk/getGrantedAccess.md b/src/references/iapp-generator/sdk/getGrantedAccess.md
index 38c68d80..f118e2d0 100644
--- a/src/references/iapp-generator/sdk/getGrantedAccess.md
+++ b/src/references/iapp-generator/sdk/getGrantedAccess.md
@@ -1,7 +1,7 @@
 ---
 title: getGrantedAccess
 description:
-  Retrieve all granted access details for a protected data object with iExec's
+  Retrieve all granted access details for an iApp with iExec's
   getGrantedAccess method. Filter access by user, application, or both, and
   manage access with pagination.
 ---
@@ -9,8 +9,8 @@ description:
 # getGrantedAccess
 
 This method provides a listing of all access grants given for the specified
-protected data object. Options for filtering include specifying an authorized
-user, an authorized app, or both.
+iApp. Options for filtering include specifying an authorized
+user, an authorized protected data, or both.
 
 ## Usage
 
@@ -25,8 +25,8 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
 const listGrantedAccess = await dataProtectorCore.getGrantedAccess({
-  protectedData: '0x123abc...',
-  authorizedApp: '0x456def...',
+  iapp: '0x123abc...',
+  authorizedProtectedData: '0x456def...',
   authorizedUser: '0x789cba...',
   page: 1,
   pageSize: 100,
@@ -39,14 +39,14 @@ const listGrantedAccess = await dataProtectorCore.getGrantedAccess({
 import { type GetGrantedAccessParams } from '@mage-sombre/iapp';
 ```
 
-### protectedData <OptionalBadge />
+### iapp <OptionalBadge />
 
 **Type:** `AddressOrENS`
 
-Address of the protected data object for which you are querying access
+Address of the iApp for which you are querying access
 authorization grants. It's a representation of ethereum address or ENS name
 (Ethereum Name Service). If no address is specified, it will return all granted
-access for any protected data.
+access for any iApp.
 
 **Usage example:**
 
@@ -57,18 +57,18 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
 const listGrantedAccess = await dataProtectorCore.getGrantedAccess({
-  protectedData: '0x123abc...', // [!code focus]
+  iapp: '0x123abc...', // [!code focus]
 });
 ```
 
-### authorizedApp <OptionalBadge />
+### authorizedProtectedData <OptionalBadge />
 
 **Type:** `AddressOrENS`
 
 Optional filter to restrict the results to include only authorizations for the
-specified application. It's a representation of ethereum address or ENS name
+specified protected data. It's a representation of ethereum address or ENS name
 (Ethereum Name Service). If no address is specified, it will return all granted
-access for any application.
+access for any protected data.
 
 **Usage example:**
 
@@ -79,19 +79,19 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
 const listGrantedAccess = await dataProtectorCore.getGrantedAccess({
-  authorizedApp: '0x456def...', // [!code focus]
+  authorizedProtectedData: '0x456def...', // [!code focus]
 });
 ```
 
 ::: tip
 
-If you specified an application whitelist when using
-[`grantAccess`](/references/dataProtector/dataProtectorCore/grantAccess), you
+If you specified a protected data whitelist when using
+[`grantAccess`](/references/iapp-generator/sdk/grantAccess), you
 must specify that same whitelist address when using this filtering option. The
 `getGrantedAccess` method does not check against whitelist smart contracts when
-aggregating results. If you granted authorization to a whitelist but specify an
-application address for the `authorizedApp` parameter, you will not receive any
-results unless you _also_ explicitly granted access to that application address.
+aggregating results. If you granted authorization to a whitelist but specify a
+protected data address for the `authorizedProtectedData` parameter, you will not receive any
+results unless you _also_ explicitly granted access to that protected data address.
 
 :::
 
@@ -133,8 +133,8 @@ const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
 
 const listGrantedAccess = await dataProtectorCore.getGrantedAccess({
-  protectedData: '0x123abc...',
-  authorizedApp: '0x456def...',
+  iapp: '0x123abc...',
+  authorizedProtectedData: '0x456def...',
   authorizedUser: '0x789cba...',
   isUserStrict: true, // [!code focus]
 });
@@ -160,7 +160,7 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
 const listGrantedAccess = await dataProtectorCore.getGrantedAccess({
-  protectedData: '0x123abc...',
+  iapp: '0x123abc...',
   page: 1, // [!code focus]
   pageSize: 100,
 });
@@ -185,7 +185,7 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
 const listGrantedAccess = await dataProtectorCore.getGrantedAccess({
-  protectedData: '0x123abc...',
+  iapp: '0x123abc...',
   page: 1,
   pageSize: 100, // [!code focus]
 });
@@ -201,7 +201,7 @@ The return value for this method has two fields: a `count` parameter indicating
 the number of results, and an array of `GrantedAccess` objects containing all
 access data. When using the optional paging parameters, the `count` will be
 limited by the selected `pageSize` parameter. You may use these result objects
-in conjunction with the [revokeOneAccess](revokeOneAccess.md) method to revoke a
+in conjunction with the [revokeOneAccess](/references/iapp-generator/sdk/revokeOneAccess) method to revoke a
 previously granted authorization for access.
 
 ### count
diff --git a/src/references/iapp-generator/sdk/getIApp.md b/src/references/iapp-generator/sdk/getIApp.md
index 7ddf6020..6087b2d1 100644
--- a/src/references/iapp-generator/sdk/getIApp.md
+++ b/src/references/iapp-generator/sdk/getIApp.md
@@ -1,23 +1,21 @@
 ---
 title: getIApp
 description:
-  Retrieve all protected data for a specific owner or schema with the getIApp
-  method in iExec DataProtector. Easily access encrypted data and metadata,
+  Retrieve all iApps for a specific owner or filter by creation date with the getIApp
+  method in iExec iApp Generator SDK. Easily access iApp metadata and information,
   sorted by creation date.
 ---
 
 # getIApp
 
-This method allows the user to retrieve all protected data for a given owner,
-data schema, or both.
+This method allows the user to retrieve all iApps for a given owner or filter by creation timestamp.
 
 Results are ordered by `creationTimestamp` desc.
 
 ::: tip
 
-A data schema is the metadata describing the contents of the protected data
-object. The schema is returned as part of the [protectData](protectData.md)
-method invocation.
+An iApp is a confidential computing application that runs in secure TEE environments.
+The method returns iApp metadata including name, address, owner, and creation timestamp.
 
 :::
 
@@ -29,85 +27,43 @@ import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
-const listProtectedData = await dataProtectorCore.getIApp({
+const listIApps = await dataProtectorCore.getIApp({
   owner: '0xa0c15e...',
-  requiredSchema: {
-    email: 'string',
-  },
+  createdAfterTimestamp: 1640995200,
+  page: 1,
+  pageSize: 20,
 });
 ```
 
 ## Parameters
 
 ```ts twoslash
-import { type GetProtectedDataParams } from '@mage-sombre/iapp';
+import { type GetIAppParams } from '@mage-sombre/iapp';
 ```
 
-### protectedDataAddress <OptionalBadge />
+### iapp <OptionalBadge />
 
 **Type:** `AddressOrENS`
 
-Returns the protected data associated with this address.  
-Returns an empty array if the protected data is not found.
-
-```ts twoslash
-import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
-
-const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
-// ---cut---
-const oneProtectedData = await dataProtectorCore.getIApp({
-  protectedDataAddress: '0x123abc...', // [!code focus]
-});
-```
-
-### requiredSchema <OptionalBadge />
-
-**Type:** `SearchableDataSchema`
-
-Provides a list of protected data objects matching this schema.
-
-<!-- prettier-ignore-start -->
-```ts twoslash
-import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
-
-const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
-// ---cut---
-const listProtectedData = await dataProtectorCore.getIApp({
-  requiredSchema: { // [!code focus]
-    email: 'string', // [!code focus]
-  }, // [!code focus]
-});
-```
-<!-- prettier-ignore-end -->
-
-It's also possible to provide a list of accepted types for one schema field:
+Returns the iApp associated with this address.  
+Returns an empty array if the iApp is not found.
 
-<!-- prettier-ignore-start -->
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
-const listProtectedData = await dataProtectorCore.getIApp({
-  requiredSchema: { // [!code focus]
-    picture: ['image/png', 'image/jpeg'], // [!code focus]
-  }, // [!code focus]
+const oneIApp = await dataProtectorCore.getIApp({
+  iapp: '0x123abc...', // [!code focus]
 });
 ```
-<!-- prettier-ignore-end -->
-
-Available types are listed
-[here](/references/dataProtector/dataProtectorCore/protectData#schema).
 
 ### owner <OptionalBadge />
 
 **Type:** `AddressOrENS`
 
-Provides a list of protected data objects owned by the user with this ETH
-address.
+Returns all iApps owned by this address.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -115,17 +71,14 @@ import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
-const listProtectedData = await dataProtectorCore.getIApp({
+const iAppsByOwner = await dataProtectorCore.getIApp({
   owner: '0xa0c15e...', // [!code focus]
 });
-```
-
 ### createdAfterTimestamp <OptionalBadge />
 
 **Type:** `number`
 
-Provides a list of protected data objects created after this timestamp value.
-The provided value should be in seconds.
+Returns all iApps created after this timestamp (Unix timestamp in seconds).
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -133,9 +86,8 @@ import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
-const listProtectedData = await dataProtectorCore.getIApp({
-  owner: '0xa0c15e...',
-  createdAfterTimestamp: 1710257612, // March 12, 2024 15:33:32 GMT // [!code focus]
+const recentIApps = await dataProtectorCore.getIApp({
+  createdAfterTimestamp: 1640995200, // [!code focus]
 });
 ```
 
@@ -144,9 +96,7 @@ const listProtectedData = await dataProtectorCore.getIApp({
 **Type:** `number`  
 **Default:** `0`
 
-Specifies the results page to return. Pages are indexed starting at page 0. If
-using this field you may also specify a `pageSize` to control the size of the
-results.
+Specifies the page number of the result set to return. Pages are zero-based indexed.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -154,22 +104,18 @@ import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
-const listProtectedData = await dataProtectorCore.getIApp({
-  owner: '0xa0c15e...',
-  createdAfterTimestamp: 1710257612, // March 12, 2024 15:33:32 GMT
+const iAppsPage = await dataProtectorCore.getIApp({
   page: 1, // [!code focus]
+  pageSize: 20,
 });
 ```
 
 ### pageSize <OptionalBadge />
 
 **Type:** `number`  
-**Default:** `1000`  
-**Range:** `[10...1000]`
+**Default:** `20`
 
-Specifies the number of records in each page of the result set. This is used in
-conjunction with the optional `page` parameter to constrain the size of the
-result.
+Specifies the number of records to include in each page of the result set.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -177,21 +123,49 @@ import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
-const listProtectedData = await dataProtectorCore.getIApp({
-  owner: '0xa0c15e...',
-  createdAfterTimestamp: 1710257612, // March 12, 2024 15:33:32 GMT
+const iAppsPage = await dataProtectorCore.getIApp({
   page: 1,
-  pageSize: 100, // [!code focus]
+  pageSize: 50, // [!code focus]
 });
 ```
 
 ## Return Value
 
 ```ts twoslash
-import { type ProtectedData } from '@mage-sombre/iapp';
+import { type IApp } from '@mage-sombre/iapp';
 ```
 
-See [`ProtectedData`](/references/iapp-generator/sdk/types#protecteddata)
+The method returns an array of `IApp` objects containing the following fields:
+
+### name
+
+`string`
+
+The name of the iApp.
+
+### address
+
+`Address`
+
+The Ethereum address of the iApp.
+
+### owner
+
+`Address`
+
+The Ethereum address of the iApp owner.
+
+### creationTimestamp
+
+`number`
+
+The Unix timestamp (in seconds) when the iApp was created.
+
+### multiaddr
+
+`string` (optional)
+
+The multiaddress for P2P communication with the iApp.
 
 <script setup>
 import OptionalBadge from '@/components/OptionalBadge.vue'
diff --git a/src/references/iapp-generator/sdk/grantAccess.md b/src/references/iapp-generator/sdk/grantAccess.md
index 6cb851a6..966525e6 100644
--- a/src/references/iapp-generator/sdk/grantAccess.md
+++ b/src/references/iapp-generator/sdk/grantAccess.md
@@ -1,19 +1,17 @@
 ---
 title: grantAccess
 description:
-  Grant secure access to encrypted data with iExec's grantAccess method.
-  Authorize specific applications or users to process protected data, with
+  Grant secure access to an iApp with iExec's grantAccess method.
+  Authorize specific protected data or users to use the iApp, with
   customizable access limits and pricing.
 ---
 
 # grantAccess
 
-Data encrypted through the Data Protector tool requires explicit authorization
-for runtime access. A newly created `protectedData` object has no inherent
+iApps require explicit authorization for runtime access. A newly created `iApp` has no inherent
 authorizations. This method grants permission to securely access the specified
-`protectedData` for processing using the `processProtectedData` method.
-Authorization to use the `protectedData` is given to a user in the context of an
-application (or a designated list of applications).
+`iApp` for processing. Authorization to use the `iApp` is given to a user in the context of
+protected data (or a designated list of protected data).
 
 ## Usage
 
@@ -24,8 +22,8 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
 const grantedAccess = await dataProtectorCore.grantAccess({
-  protectedData: '0x123abc...',
-  authorizedApp: '0x456def...',
+  iapp: '0x123abc...',
+  authorizedProtectedData: '0x456def...',
   authorizedUser: '0x789cba...',
   pricePerAccess: 3,
   numberOfAccess: 10,
@@ -41,12 +39,11 @@ const grantedAccess = await dataProtectorCore.grantAccess({
 import { type GrantAccessParams } from '@mage-sombre/iapp';
 ```
 
-### protectedData <RequiredBadge />
+### iapp <RequiredBadge />
 
 **Type:** `AddressOrENS`
 
-The ethereum address of the protected data supplied by the user (returned when
-you created it). **You must own this data** to grant access.
+The ethereum address of the iApp you wish to grant access to. **You must own this iApp** to grant access.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -55,19 +52,19 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
 const grantedAccess = await dataProtectorCore.grantAccess({
-  protectedData: '0x123abc...', // [!code focus]
-  authorizedApp: '0x456def...',
+  iapp: '0x123abc...', // [!code focus]
+  authorizedProtectedData: '0x456def...',
   authorizedUser: '0x789cba...',
 });
 ```
 
-### authorizedApp <RequiredBadge />
+### authorizedProtectedData <OptionalBadge />
 
 **Type:** `AddressOrENS`
 
-The address of the application you wish to authorize to process the
-`protectedData` within a secure execution environment. You may specify either a
-single application or an application whitelist. To specify a whitelist, you
+The address of the protected data you wish to authorize to use the
+`iApp` within a secure execution environment. You may specify either a
+single protected data or a protected data whitelist. To specify a whitelist, you
 provide the ETH address of an
 [iExec Whitelist Smart Contract](https://github.com/iExecBlockchainComputing/whitelist-smart-contract/tree/main).
 This smart contract should aggregates multiple application versions. This allows
@@ -81,16 +78,15 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
 const grantedAccess = await dataProtectorCore.grantAccess({
-  protectedData: '0x123abc...',
-  authorizedApp: '0x456def...', // [!code focus]
+  iapp: '0x123abc...',
+  authorizedProtectedData: '0x456def...', // [!code focus]
   authorizedUser: '0x789cba...',
 });
 ```
 
 ::: tip
 
-You may authorize a specific app or a whitelist of apps to use the protected
-data.
+You may authorize a specific protected data or a whitelist of protected data to use the iApp.
 
 The latest version of the iExec Web3Mail decentralized application is
 `{{web3MailAddress}}`.
@@ -102,13 +98,13 @@ access once. The ETH address for this whitelist is **{{web3MailAppWhitelist}}**.
 
 :::
 
-### authorizedUser <RequiredBadge />
+### authorizedUser <OptionalBadge />
 
 **Type:** `AddressOrENS`
 
-The address of the user you wish to authorize to use the `protectedData`. Note
+The address of the user you wish to authorize to use the `iApp`. Note
 that these users may not view or manipulate the data. This only grants
-permission for the user to submit the data to an iExec application.
+permission for the user to submit the protected data to the iApp.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -117,15 +113,15 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
 const grantedAccess = await dataProtectorCore.grantAccess({
-  protectedData: '0x123abc...',
-  authorizedApp: '0x456def...',
+  iapp: '0x123abc...',
+  authorizedProtectedData: '0x456def...',
   authorizedUser: '0x789cba...', // [!code focus]
 });
 ```
 
 ::: tip
 
-You may authorize all users to use the protected data by setting this to
+You may authorize all users to use the iApp by setting this to
 **0x0000000000000000000000000000000000000000**.
 
 :::
@@ -136,15 +132,15 @@ You may authorize all users to use the protected data by setting this to
 **Default:** `0`
 
 Specifies the usage fee in nano RLC (nRLC) associated with each access of the
-data. It represents the cost incurred for each individual interaction with
-application.
+iApp. It represents the cost incurred for each individual interaction with
+the iApp.
 
 By invoking the grantAccess method with a specific `pricePerAccess` you define
 the fee that the specified user (`authorizedUser` parameter) must pay for each
-access to the data when used with the specified application (`authorizedApp`
+access to the iApp when used with the specified protected data (`authorizedProtectedData`
 parameter).
 
-The fee is paid to the owner of the protected data.
+The fee is paid to the owner of the iApp.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -153,8 +149,8 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
 const grantedAccess = await dataProtectorCore.grantAccess({
-  protectedData: '0x123abc...',
-  authorizedApp: '0x456def...',
+  iapp: '0x123abc...',
+  authorizedProtectedData: '0x456def...',
   authorizedUser: '0x789cba...',
   pricePerAccess: 3, // [!code focus]
   numberOfAccess: 10,
@@ -175,7 +171,7 @@ When provided, `pricePerAccess` must be a non-negative integer value.
 **Type:** `number`  
 **Default:** `1`
 
-Allows restricting the number of times the protected data may be processed and
+Allows restricting the number of times the iApp may be accessed and
 used.
 
 It is not technically possible to set an unlimited number of accesses, but you
@@ -183,7 +179,7 @@ can set `numberOfAccess` to `10000` for example.
 
 ::: info
 
-If you attempt to process the protected data more times than specified in
+If you attempt to access the iApp more times than specified in
 `numberOfAccess`, you will encounter a **"no dataset orders"** error.
 
 To prevent this error, ensure the `numberOfAccess` is properly set when calling
@@ -198,8 +194,8 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
 const grantedAccess = await dataProtectorCore.grantAccess({
-  protectedData: '0x123abc...',
-  authorizedApp: '0x456def...',
+  iapp: '0x123abc...',
+  authorizedProtectedData: '0x456def...',
   authorizedUser: '0x789cba...',
   pricePerAccess: 3,
   numberOfAccess: 10, // [!code focus]
diff --git a/src/references/iapp-generator/sdk/revokeAllAccess.md b/src/references/iapp-generator/sdk/revokeAllAccess.md
index 7aedae13..28ab9d6d 100644
--- a/src/references/iapp-generator/sdk/revokeAllAccess.md
+++ b/src/references/iapp-generator/sdk/revokeAllAccess.md
@@ -1,19 +1,19 @@
 ---
 title: revokeAllAccess
 description:
-  Revoke all or specific access permissions to protected data with iExec's
-  revokeAllAccess method. Efficiently manage data security by removing access
-  from users or smart contract.
+  Revoke all or specific access permissions to an iApp with iExec's
+  revokeAllAccess method. Efficiently manage iApp security by removing access
+  from users or protected data.
 ---
 
 # revokeAllAccess
 
-This method allows revoking authorizations granted to a `protectedData` entity.
-You may optionally specify application or user addresses for revocation. If you
+This method allows revoking authorizations granted to an `iApp` entity.
+You may optionally specify protected data or user addresses for revocation. If you
 do not specify either of these optional values, this method will revoke all
-access for all users and applications.
+access for all users and protected data.
 
-You must be the owner of the protected data.
+You must be the owner of the iApp.
 
 Under the hood, all granted access will be retrieved and be revoked one by one.
 If by any chance there were **more than 20 granted access** to be revoked, you
@@ -30,8 +30,8 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
 const revokeAllAccessResult = await dataProtectorCore.revokeAllAccess({
-  protectedData: '0x123abc...',
-  authorizedApp: '0x456def...',
+  iapp: '0x123abc...',
+  authorizedProtectedData: '0x456def...',
   authorizedUser: '0x789cba...',
 });
 ```
@@ -42,11 +42,11 @@ const revokeAllAccessResult = await dataProtectorCore.revokeAllAccess({
 import { type RevokeAllAccessParams } from '@mage-sombre/iapp';
 ```
 
-### protectedData <RequiredBadge />
+### iapp <RequiredBadge />
 
 **Type:** `AddressOrENS`
 
-The address of the `protectedData` subject to access revocation.
+The address of the `iApp` subject to access revocation.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -55,17 +55,17 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
 const revokeAllAccessResult = await dataProtectorCore.revokeAllAccess({
-  protectedData: '0x123abc...', // [!code focus]
+  iapp: '0x123abc...', // [!code focus]
 });
 ```
 
-### authorizedApp <OptionalBadge />
+### authorizedProtectedData <OptionalBadge />
 
 **Type:** `AddressOrENS`
 
-The application address to be removed from the authorization list for the
-specified `protectedData`. If no address is specified, it will revoke all access
-from the protected data, regardless of the app.
+The protected data address to be removed from the authorization list for the
+specified `iApp`. If no address is specified, it will revoke all access
+from the iApp, regardless of the protected data.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -74,8 +74,8 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
 const revokeAllAccessResult = await dataProtectorCore.revokeAllAccess({
-  protectedData: '0x123abc...',
-  authorizedApp: '0x456def...', // [!code focus]
+  iapp: '0x123abc...',
+  authorizedProtectedData: '0x456def...', // [!code focus]
   authorizedUser: '0x789cba...',
 });
 ```
@@ -85,8 +85,8 @@ const revokeAllAccessResult = await dataProtectorCore.revokeAllAccess({
 **Type:** `AddressOrENS`
 
 The user address to be removed from the authorization list for the specified
-`protectedData`. If no address is specified, it will revoke all access from the
-protected data, regardless of the authorized user.
+`iApp`. If no address is specified, it will revoke all access from the
+iApp, regardless of the authorized user.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -95,8 +95,8 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
 const revokeAllAccessResult = await dataProtectorCore.revokeAllAccess({
-  protectedData: '0x123abc...',
-  authorizedApp: '0x456def...',
+  iapp: '0x123abc...',
+  authorizedProtectedData: '0x456def...',
   authorizedUser: '0x789cba...', // [!code focus]
 });
 ```
@@ -115,8 +115,8 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
 const revokeAllAccessResult = await dataProtectorCore.revokeAllAccess({
-  protectedData: '0x123abc...',
-  authorizedApp: '0x456def...',
+  iapp: '0x123abc...',
+  authorizedProtectedData: '0x456def...',
   authorizedUser: '0x789cba...',
   onStatusUpdate: ({ title, isDone }) => { // [!code focus]
     console.log(title, isDone); // [!code focus]
diff --git a/src/references/iapp-generator/sdk/revokeOneAccess.md b/src/references/iapp-generator/sdk/revokeOneAccess.md
index e05fe973..6afb4b5e 100644
--- a/src/references/iapp-generator/sdk/revokeOneAccess.md
+++ b/src/references/iapp-generator/sdk/revokeOneAccess.md
@@ -1,17 +1,17 @@
 ---
 title: revokeOneAccess
 description:
-  Revoke specific access permissions to protected data with iExec's
+  Revoke specific access permissions to an iApp with iExec's
   revokeOneAccess method. Manage and remove access granted to users or
-  applications through blockchain transactions.
+  protected data through blockchain transactions.
 ---
 
 # revokeOneAccess
 
-This method allows revoking a specific access authorization from a
-`protectedData` entity. The input parameter for this method is sourced from the
-[getGrantedAccess](getGrantedAccess.md) method, which provides a list of all
-authorizations on single `protectedData` entity.
+This method allows revoking a specific access authorization from an
+`iApp` entity. The input parameter for this method is sourced from the
+[getGrantedAccess](/references/iapp-generator/sdk/getGrantedAccess) method, which provides a list of all
+authorizations on single `iApp` entity.
 
 As this will generate a blockchain transaction, expect it to take a least 5sec
 (a block time).
@@ -20,7 +20,7 @@ As this will generate a blockchain transaction, expect it to take a least 5sec
 
 The `revokeOneAccess` method requires a `grantedAccess` object as an input
 parameter. This object is retrieved from the
-[`getGrantedAccess`](/references/dataProtector/dataProtectorCore/getGrantedAccess)
+[`getGrantedAccess`](/references/iapp-generator/sdk/getGrantedAccess)
 method.
 
 ```ts twoslash
@@ -30,15 +30,16 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
 const revokeAccess = await dataProtectorCore.revokeOneAccess({
-  apprestrict: '0xea...',
-  dataset: '0xA0C...',
-  datasetprice: '0',
+  app: '0xea...',
+  appprice: '0',
+  volume: '1',
+  tag: '0x0000000000000000000000000000000000000000000000000000000000000003',
+  datasetrestrict: '0xA0C...',
+  workerpoolrestrict: '0x000...',
   requesterrestrict: '0xecb..',
   salt: '0x0147...',
   sign: '0xc22c1...',
-  tag: '0x0000000000000000000000000000000000000000000000000000000000000003',
-  volume: '1',
-  workerpoolrestrict: '0x000...',
+  remainingAccess: 1,
 });
 ```
 
@@ -53,7 +54,7 @@ import { type GrantedAccess } from '@mage-sombre/iapp';
 **Type:** `GrantedAccess`
 
 This is the complete `granted access` object retrieved from an invocation of
-`getGrantedAccess`.
+`getGrantedAccess` for an iApp.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -62,15 +63,16 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
 const revokeAccess = await dataProtectorCore.revokeOneAccess({
-  apprestrict: '0xea...', // [!code focus]
-  dataset: '0xA0C...', // [!code focus]
-  datasetprice: '0', // [!code focus]
+  app: '0xea...', // [!code focus]
+  appprice: '0', // [!code focus]
+  volume: '1', // [!code focus]
+  tag: '0x0000000000000000000000000000000000000000000000000000000000000003', // [!code focus]
+  datasetrestrict: '0xA0C...', // [!code focus]
+  workerpoolrestrict: '0x000...', // [!code focus]
   requesterrestrict: '0xecb..', // [!code focus]
   salt: '0x0147...', // [!code focus]
   sign: '0xc22c1...', // [!code focus]
-  tag: '0x0000000000000000000000000000000000000000000000000000000000000003', // [!code focus]
-  volume: '1', // [!code focus]
-  workerpoolrestrict: '0x000...', // [!code focus]
+  remainingAccess: 1, // [!code focus]
 });
 ```
 
@@ -78,8 +80,7 @@ const revokeAccess = await dataProtectorCore.revokeOneAccess({
 
 The tag must always be set to
 `0x0000000000000000000000000000000000000000000000000000000000000003`. This
-specific value indicates that the order is for a confidential asset (a protected
-data).
+specific value indicates that the order is for a confidential asset (an iApp).
 
 :::
 
diff --git a/src/references/iapp-generator/sdk/runIApp.md b/src/references/iapp-generator/sdk/runIApp.md
index d4c5f3bf..41248e85 100644
--- a/src/references/iapp-generator/sdk/runIApp.md
+++ b/src/references/iapp-generator/sdk/runIApp.md
@@ -1,21 +1,19 @@
 ---
 title: runIApp
 description:
-  Process encrypted data securely with iExec's runIApp method. Use authorized
-  applications to process protected datasets while maintaining data privacy and
-  security.
+  Execute iApps securely with iExec's runIApp method. Run confidential computing
+  applications with optional protected data while maintaining privacy and security.
 ---
 
 # runIApp
 
-Allows processing a protected dataset through use of a specified iExec
-application.
+Allows executing an iApp with optional protected data processing.
 
 > [!IMPORTANT]
 >
-> You must ensure this application has authorization to use the `protectedData`.
+> You must ensure the iApp has authorization to use the `protectedData` if provided.
 > You may grant this permission using the
-> [`grantAccess`](/references/dataProtector/dataProtectorCore/grantAccess)
+> [`grantAccess`](/references/iapp-generator/sdk/grantAccess)
 > method.
 
 ## Usage
@@ -26,30 +24,32 @@ import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
-const processProtectedDataResponse = await dataProtectorCore.runIApp({
+const runIAppResponse = await dataProtectorCore.runIApp({
+  iapp: '0x456def...',
   protectedData: '0x123abc...',
-  app: '0x456def...',
   args: 'arg1 arg2',
   inputFiles: ['https://example.com/file1', 'https://example.com/file2'],
   secrets: {
     1: 'secret1',
     2: 'secret2',
   },
+  dataMaxPrice: 10,
+  appMaxPrice: 5,
+  workerpoolMaxPrice: 2,
 });
 ```
 
 ## Parameters
 
 ```ts twoslash
-import { type ProcessProtectedDataParams } from '@mage-sombre/iapp';
+import { type RunIAppParams } from '@mage-sombre/iapp';
 ```
 
-### protectedData <RequiredBadge />
+### iapp <RequiredBadge />
 
 **Type:** `AddressOrENS`
 
-The ETH address or Ethereum Name Service (ENS) reference for the protected data
-you wish the `app` to process.
+The address or ENS of the iApp to execute.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -57,18 +57,17 @@ import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
-const processProtectedDataResponse = await dataProtectorCore.runIApp({
-  protectedData: '0x123abc...', // [!code focus]
-  app: '0x456def...',
+const runIAppResponse = await dataProtectorCore.runIApp({
+  iapp: '0x456def...', // [!code focus]
+  protectedData: '0x123abc...',
 });
 ```
 
-### app <RequiredBadge />
+### protectedData <OptionalBadge />
 
 **Type:** `AddressOrENS`
 
-The ETH address or Ethereum Name Service (ENS) address for the iExec application
-to process the protected data.
+The address or ENS of the authorized protected data that the iApp will process.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -76,19 +75,18 @@ import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
-const processProtectedDataResponse = await dataProtectorCore.runIApp({
-  protectedData: '0x123abc...',
-  app: '0x456def...', // [!code focus]
+const runIAppResponse = await dataProtectorCore.runIApp({
+  iapp: '0x456def...',
+  protectedData: '0x123abc...', // [!code focus]
 });
 ```
 
-### path <OptionalBadge />
+### dataMaxPrice <OptionalBadge />
 
-**Type:** `string`
+**Type:** `number`  
+**Default:** `0`
 
-Under the hood, a protected data is a zip file. With this `path` parameter, you
-can specify the file you're interested in. The zip file will be uncompressed for
-you, and only the desired file will be given as the `result`.
+The maximum price of dataset per task for processing the protected data.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -96,20 +94,19 @@ import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
-const processProtectedDataResponse = await dataProtectorCore.runIApp({
+const runIAppResponse = await dataProtectorCore.runIApp({
+  iapp: '0x456def...',
   protectedData: '0x123abc...',
-  app: '0x456def...',
-  path: 'my-content', // [!code focus]
+  dataMaxPrice: 10, // [!code focus]
 });
 ```
 
-### userWhitelist <OptionalBadge />
+### appMaxPrice <OptionalBadge />
 
-**Type:** `Address`
+**Type:** `number`  
+**Default:** `0`
 
-If access to the protected data is granted to a group of users via a whitelist
-contract, you must use this `userWhitelist` parameter. The value should be the
-whitelist contract address that has access to the protected data.
+The maximum price of application per task for processing the protected data.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -117,21 +114,19 @@ import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
-const processProtectedDataResponse = await dataProtectorCore.runIApp({
+const runIAppResponse = await dataProtectorCore.runIApp({
+  iapp: '0x456def...',
   protectedData: '0x123abc...',
-  app: '0x456def...',
-  userWhitelist: '0x656def...', // [!code focus]
+  appMaxPrice: 5, // [!code focus]
 });
 ```
 
-### useVoucher <ChainNotSupportedBadge /> <OptionalBadge />
+### workerpoolMaxPrice <OptionalBadge />
 
-**Type:** `boolean`  
-**Default:** `false`
+**Type:** `number`  
+**Default:** `0`
 
-This optional parameter allows you to pay for the task using a voucher. By
-default, it uses the voucher associated with your connected wallet, but you can
-override this by specifying a voucherAddress.
+The maximum price of workerpool per task for processing the protected data.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -139,29 +134,18 @@ import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
-const processProtectedDataResponse = await dataProtectorCore.runIApp({
+const runIAppResponse = await dataProtectorCore.runIApp({
+  iapp: '0x456def...',
   protectedData: '0x123abc...',
-  app: '0x456def...',
-  useVoucher: true, // [!code focus]
+  workerpoolMaxPrice: 2, // [!code focus]
 });
 ```
 
-::: tip
-
-If your voucher doesn't have enough RLC to cover the deal, the SDK will
-automatically get the required amount to your iExec account. Ensure that your
-voucher is authorized to access your iExec account and that your account has
-sufficient funds for this transfer to proceed.
-
-:::
-
-### voucherOwner <ChainNotSupportedBadge /> <OptionalBadge />
+### path <OptionalBadge />
 
-**Type:** `Address`
+**Type:** `string`
 
-This optional parameter allows you to pay for the task using someone else’s
-voucher. Make sure the voucher's owner has authorized you to use it. This
-parameter must be used in combination with `useVoucher: true`.
+The file name of the desired file in the returned ZIP file.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -169,11 +153,10 @@ import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
-const processProtectedDataResponse = await dataProtectorCore.runIApp({
+const runIAppResponse = await dataProtectorCore.runIApp({
+  iapp: '0x456def...',
   protectedData: '0x123abc...',
-  app: '0x456def...',
-  useVoucher: true, // [!code focus]
-  voucherOwner: '0x5714eB...', // [!code focus]
+  path: 'my-content', // [!code focus]
 });
 ```
 
@@ -181,7 +164,7 @@ const processProtectedDataResponse = await dataProtectorCore.runIApp({
 
 **Type:** `string`
 
-Set of execution arguments for the application.
+Arguments to pass to the application during execution.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -189,26 +172,18 @@ import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
-const processProtectedDataResponse = await dataProtectorCore.runIApp({
+const runIAppResponse = await dataProtectorCore.runIApp({
+  iapp: '0x456def...',
   protectedData: '0x123abc...',
-  app: '0x456def...',
   args: 'arg1 arg2', // [!code focus]
 });
 ```
 
-::: danger
-
-Do not use this to provide any sensitive information to the application. All
-arguments passed this way are visible in plain text using the
-<a :href="explorerUrl" target="_blank" rel="noopener">iExec explorer</a> .
-
-:::
-
 ### inputFiles <OptionalBadge />
 
 **Type:** `string[]`
 
-A set of URLs representing the input files required for application execution.
+The input file required for the application's execution (direct download URL).
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -216,9 +191,9 @@ import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
-const processProtectedDataResponse = await dataProtectorCore.runIApp({
+const runIAppResponse = await dataProtectorCore.runIApp({
+  iapp: '0x456def...',
   protectedData: '0x123abc...',
-  app: '0x456def...',
   inputFiles: ['https://example.com/file1', 'https://example.com/file2'], // [!code focus]
 });
 ```
@@ -227,84 +202,30 @@ const processProtectedDataResponse = await dataProtectorCore.runIApp({
 
 **Type:** `Record<number, string>`
 
-A set of requester secrets necessary for the application's execution. This is
-represented as a mapping of numerical identifiers to corresponding secrets
-stored in the secrets manager needed for the application's execution.
+Requester secrets necessary for the application's execution.
+It is represented as a mapping of numerical identifiers to corresponding secrets.
 
-Secrets are accessible during the application's execution as environment
-variables. For more details, see
-[Access requester secrets](/guides/build-iapp/advanced/access-confidential-assets).
-
-<!-- prettier-ignore-start -->
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
-const processProtectedDataResponse = await dataProtectorCore.runIApp({
+const runIAppResponse = await dataProtectorCore.runIApp({
+  iapp: '0x456def...',
   protectedData: '0x123abc...',
-  app: '0x456def...',
   secrets: { // [!code focus]
     1: 'secret1', // [!code focus]
     2: 'secret2', // [!code focus]
   }, // [!code focus]
 });
 ```
-<!-- prettier-ignore-end -->
-
-### workerpool <OptionalBadge />
-
-**Type:** `AddressOrENS | 'any'`  
-**Default:** `{{ workerpoolAddress }}`
-
-It's the confidential computer on which the iExec application will run.
-
-::: tip
-
-iExec currently offers a workerpool located at the address
-`{{ workerpoolAddress }}`. This is the default workerpool for running
-confidential computations on the iExec platform.
-
-:::
-
-::: info TDX <ChainNotSupportedBadge/>
 
-🧪 While protected data are processed in **TEE** by **intel SGX** technology by
-default, `@mage-sombre/iapp` can be configured to create and process protected
-data in the experimental **intel TDX** environment.
+### callbackContract <OptionalBadge />
 
-TDX mode is enabled by setting connecting the **TDX SMS** and using the **TDX
-workerpool**.
-
-```ts twoslash [Browser]
-declare global {
-  interface Window {
-    ethereum: any;
-  }
-}
-// ---cut---
-import { IExecIApp } from '@mage-sombre/iapp';
-
-const web3Provider = window.ethereum;
-// Instantiate dataProtector connected to the TDX SMS
-const dataProtectorCore = new IExecIApp(web3Provider, {
-  iexecOptions: {
-    smsURL: 'https://sms.labs.iex.ec', // [!code focus]
-  },
-});
-
-const processProtectedDataResponse = await dataProtectorCore.runIApp({
-  protectedData: '0x123abc...',
-  app: '0x456def...',
-  workerpool: 'tdx-labs.pools.iexec.eth', // [!code focus]
-});
-```
-
-⚠️ Keep in mind: TDX mode is experimental and can be subject to instabilities or
-discontinuity.
+**Type:** `AddressOrENS`
 
-:::
+Address or ENS of the smart contract to be called back once the task is completed.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -312,21 +233,18 @@ import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
-const processProtectedDataResponse = await dataProtectorCore.runIApp({
+const runIAppResponse = await dataProtectorCore.runIApp({
+  iapp: '0x456def...',
   protectedData: '0x123abc...',
-  app: '0x456def...',
-  workerpool: '0xa5de76...', // [!code focus]
+  callbackContract: '0x789ghi...', // [!code focus]
 });
 ```
 
-### dataMaxPrice <OptionalBadge />
+### workerpool <OptionalBadge />
 
-**Type:** `number`  
-**Default:** `0`
+**Type:** `AddressOrENS`
 
-Allows specifying the maximum amount (in nRLC) you are willing to pay the
-protected data owner for using their data. The owner of the protected data
-receives this as a payment for sharing their data.
+The workerpool to use for the application's execution. (default iExec production workerpool)
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -334,20 +252,18 @@ import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
-const processProtectedDataResponse = await dataProtectorCore.runIApp({
+const runIAppResponse = await dataProtectorCore.runIApp({
+  iapp: '0x456def...',
   protectedData: '0x123abc...',
-  app: '0x456def...',
-  dataMaxPrice: 42, // [!code focus]
+  workerpool: '0xabc123...', // [!code focus]
 });
 ```
 
-### appMaxPrice <OptionalBadge />
+### useVoucher <OptionalBadge />
 
-**Type:** `number`  
-**Default:** `0`
+**Type:** `boolean`
 
-Allows specifying the maximum amount (in nRLC) you are willing to pay the iApp
-provider for using the deployed application.
+A boolean that indicates whether to use a voucher or no.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -355,20 +271,18 @@ import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
-const processProtectedDataResponse = await dataProtectorCore.runIApp({
+const runIAppResponse = await dataProtectorCore.runIApp({
+  iapp: '0x456def...',
   protectedData: '0x123abc...',
-  app: '0x456def...',
-  appMaxPrice: 42, // [!code focus]
+  useVoucher: true, // [!code focus]
 });
 ```
 
-### workerpoolMaxPrice <OptionalBadge />
+### voucherOwner <OptionalBadge />
 
-**Type:** `number`  
-**Default:** `0`
+**Type:** `AddressOrENS`
 
-Allows specifying the maximum amount you want to pay the workerpool provider for
-using their infrastructure to run the iApp in nRLC.
+Override the voucher contract to use, must be combined with useVoucher: true the user must be authorized by the voucher's owner to use it.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -376,44 +290,44 @@ import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
-const processProtectedDataResponse = await dataProtectorCore.runIApp({
+const runIAppResponse = await dataProtectorCore.runIApp({
+  iapp: '0x456def...',
   protectedData: '0x123abc...',
-  app: '0x456def...',
-  workerpoolMaxPrice: 42, // [!code focus]
+  useVoucher: true,
+  voucherOwner: '0xdef456...', // [!code focus]
 });
 ```
 
 ### onStatusUpdate <OptionalBadge />
 
-**Type:** `OnStatusUpdateFn<ProcessProtectedDataStatuses>`
+**Type:** `OnStatusUpdateFn<RunIAppStatuses>`
 
 Callback function to be notified at intermediate steps.
 
-<!-- prettier-ignore-start -->
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const dataProtectorCore = new IExecIApp(web3Provider);
 // ---cut---
-const processProtectedDataResponse = await dataProtectorCore.runIApp({
+const runIAppResponse = await dataProtectorCore.runIApp({
+  iapp: '0x456def...',
   protectedData: '0x123abc...',
-  app: '0x456def...',
   onStatusUpdate: ({ title, isDone }) => { // [!code focus]
     console.log(title, isDone); // [!code focus]
   }, // [!code focus]
 });
 ```
-<!-- prettier-ignore-end -->
 
 You can expect this callback function to be called with the following titles:
 
 ```ts
+'FETCH_ORDERS';
 'FETCH_PROTECTED_DATA_ORDERBOOK';
 'FETCH_APP_ORDERBOOK';
 'FETCH_WORKERPOOL_ORDERBOOK';
 'PUSH_REQUESTER_SECRET';
-'REQUEST_TO_PROCESS_PROTECTED_DATA';
+'REQUEST_TO_RUN_IAPP';
 'CONSUME_TASK';
 'CONSUME_RESULT_DOWNLOAD';
 'CONSUME_RESULT_DECRYPT';
@@ -424,74 +338,35 @@ Once with `isDone: false`, and then with `isDone: true`
 ## Return Value
 
 ```ts twoslash
-import { type ProcessProtectedDataResponse } from '@mage-sombre/iapp';
+import { type RunIAppResponse } from '@mage-sombre/iapp';
 ```
 
+The method returns a `RunIAppResponse` object containing the following fields:
+
 ### txHash
 
 `string`
 
-The ID of the transaction that happened on iExec's side chain. You may view
-details on the transaction using the
-<a :href="explorerUrl" target="_blank" rel="noopener">iExec explorer</a> .
+The transaction hash of the task creation transaction.
 
 ### dealId
 
 `string`
 
-Identifies the specific deal associated with this transaction.
+The deal ID associated with the task execution.
 
 ### taskId
 
 `string`
 
-A unique identifier associated with a task currently running on the iExec
-protocol. You can monitor task execution using the
-<a :href="explorerUrl" target="_blank" rel="noopener">iExec explorer</a> .
-
-::: tip
-
-The
-[getResultFromCompletedTask()](/references/dataProtector/dataProtectorCore/getResultFromCompletedTask)
-function allows you to retrieve the result of a completed task using its
-`taskId`.
-
-Additionally, you can specify a **file path** within the ZIP archive to extract
-a specific file when required.
-
-:::
+The task ID for tracking the execution.
 
 ### result
 
-`ArrayBuffer`
-
-The result is a ZIP file containing at least one mandatory file:
-
-- **computed.json**: This file contains metadata about the computation performed
-  by the application.
-- additional files may be included depending on the dapp used.
+`ArrayBuffer` (optional)
 
-::: info
-
-In the case of the **Content Creator Delivery DApp**, the ZIP file will also
-include a file named **content**, which corresponds to the protected data
-processed during the task.
-
-:::
+The result of the iApp execution, if available.
 
 <script setup>
-import { computed } from 'vue';
-import RequiredBadge from '@/components/RequiredBadge.vue'
 import OptionalBadge from '@/components/OptionalBadge.vue'
-import ChainNotSupportedBadge from '@/components/ChainNotSupportedBadge.vue'
-import useUserStore  from '@/stores/useUser.store';
-import {getChainById} from '@/utils/chain.utils';
-
-// Get current chain info
-const userStore = useUserStore();
-const selectedChain = computed(() => userStore.getCurrentChainId());
-
-const chainData = computed(() => getChainById(selectedChain.value));
-const explorerUrl = computed(() => chainData.value.iexecExplorerUrl);
-const workerpoolAddress = computed(() => chainData.value.workerpoolAddress);
 </script>

From b3f7b12cad98ab91e32d02deee0ac9687310ce42 Mon Sep 17 00:00:00 2001
From: Le-Caignec <robinlecaignec@yahoo.fr>
Date: Thu, 25 Sep 2025 15:46:42 +0200
Subject: [PATCH 07/11] refactor(docs): update iApp references in SDK
 documentation for consistency

---
 .../iapp-generator/sdk/getGrantedAccess.md    | 28 ++++-----
 src/references/iapp-generator/sdk/getIApp.md  | 24 ++++----
 .../sdk/getResultFromCompletedTask.md         | 20 +++----
 .../iapp-generator/sdk/grantAccess.md         | 28 ++++-----
 .../iapp-generator/sdk/revokeAllAccess.md     | 20 +++----
 .../iapp-generator/sdk/revokeOneAccess.md     |  8 +--
 src/references/iapp-generator/sdk/runIApp.md  | 60 +++++++++----------
 .../iapp-generator/sdk/transferOwnership.md   | 12 ++--
 8 files changed, 100 insertions(+), 100 deletions(-)

diff --git a/src/references/iapp-generator/sdk/getGrantedAccess.md b/src/references/iapp-generator/sdk/getGrantedAccess.md
index f118e2d0..3cf7e8b1 100644
--- a/src/references/iapp-generator/sdk/getGrantedAccess.md
+++ b/src/references/iapp-generator/sdk/getGrantedAccess.md
@@ -22,9 +22,9 @@ the object is a string representation of an ethereum address or ENS name
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const listGrantedAccess = await dataProtectorCore.getGrantedAccess({
+const listGrantedAccess = await iapp.getGrantedAccess({
   iapp: '0x123abc...',
   authorizedProtectedData: '0x456def...',
   authorizedUser: '0x789cba...',
@@ -54,9 +54,9 @@ access for any iApp.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const listGrantedAccess = await dataProtectorCore.getGrantedAccess({
+const listGrantedAccess = await iapp.getGrantedAccess({
   iapp: '0x123abc...', // [!code focus]
 });
 ```
@@ -76,9 +76,9 @@ access for any protected data.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const listGrantedAccess = await dataProtectorCore.getGrantedAccess({
+const listGrantedAccess = await iapp.getGrantedAccess({
   authorizedProtectedData: '0x456def...', // [!code focus]
 });
 ```
@@ -110,9 +110,9 @@ access for any user.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const listGrantedAccess = await dataProtectorCore.getGrantedAccess({
+const listGrantedAccess = await iapp.getGrantedAccess({
   authorizedUser: '0x789cba...', // [!code focus]
 });
 ```
@@ -129,10 +129,10 @@ specified user. Authorizations made for `any` user are not returned.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
 
-const listGrantedAccess = await dataProtectorCore.getGrantedAccess({
+const listGrantedAccess = await iapp.getGrantedAccess({
   iapp: '0x123abc...',
   authorizedProtectedData: '0x456def...',
   authorizedUser: '0x789cba...',
@@ -157,9 +157,9 @@ first page (page 0) containing `20` elements.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const listGrantedAccess = await dataProtectorCore.getGrantedAccess({
+const listGrantedAccess = await iapp.getGrantedAccess({
   iapp: '0x123abc...',
   page: 1, // [!code focus]
   pageSize: 100,
@@ -182,9 +182,9 @@ each page.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const listGrantedAccess = await dataProtectorCore.getGrantedAccess({
+const listGrantedAccess = await iapp.getGrantedAccess({
   iapp: '0x123abc...',
   page: 1,
   pageSize: 100, // [!code focus]
diff --git a/src/references/iapp-generator/sdk/getIApp.md b/src/references/iapp-generator/sdk/getIApp.md
index 6087b2d1..a42bebe5 100644
--- a/src/references/iapp-generator/sdk/getIApp.md
+++ b/src/references/iapp-generator/sdk/getIApp.md
@@ -25,9 +25,9 @@ The method returns iApp metadata including name, address, owner, and creation ti
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const listIApps = await dataProtectorCore.getIApp({
+const listIApps = await iapp.getIApp({
   owner: '0xa0c15e...',
   createdAfterTimestamp: 1640995200,
   page: 1,
@@ -52,9 +52,9 @@ Returns an empty array if the iApp is not found.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const oneIApp = await dataProtectorCore.getIApp({
+const oneIApp = await iapp.getIApp({
   iapp: '0x123abc...', // [!code focus]
 });
 ```
@@ -69,9 +69,9 @@ Returns all iApps owned by this address.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const iAppsByOwner = await dataProtectorCore.getIApp({
+const iAppsByOwner = await iapp.getIApp({
   owner: '0xa0c15e...', // [!code focus]
 });
 ### createdAfterTimestamp <OptionalBadge />
@@ -84,9 +84,9 @@ Returns all iApps created after this timestamp (Unix timestamp in seconds).
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const recentIApps = await dataProtectorCore.getIApp({
+const recentIApps = await iapp.getIApp({
   createdAfterTimestamp: 1640995200, // [!code focus]
 });
 ```
@@ -102,9 +102,9 @@ Specifies the page number of the result set to return. Pages are zero-based inde
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const iAppsPage = await dataProtectorCore.getIApp({
+const iAppsPage = await iapp.getIApp({
   page: 1, // [!code focus]
   pageSize: 20,
 });
@@ -121,9 +121,9 @@ Specifies the number of records to include in each page of the result set.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const iAppsPage = await dataProtectorCore.getIApp({
+const iAppsPage = await iapp.getIApp({
   page: 1,
   pageSize: 50, // [!code focus]
 });
diff --git a/src/references/iapp-generator/sdk/getResultFromCompletedTask.md b/src/references/iapp-generator/sdk/getResultFromCompletedTask.md
index de0af340..2b2b2d9e 100644
--- a/src/references/iapp-generator/sdk/getResultFromCompletedTask.md
+++ b/src/references/iapp-generator/sdk/getResultFromCompletedTask.md
@@ -16,9 +16,9 @@ Method to get the result of a completed task.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const completedTaskResult = await dataProtectorCore.getResultFromCompletedTask({
+const completedTaskResult = await iapp.getResultFromCompletedTask({
   taskId: '0x7ac398...',
 });
 ```
@@ -39,9 +39,9 @@ Address of the task ID data you'd like to get the result from.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const completedTaskResult = await dataProtectorCore.getResultFromCompletedTask({
+const completedTaskResult = await iapp.getResultFromCompletedTask({
   taskId: '0x7ac398...', // [!code focus]
 });
 ```
@@ -58,9 +58,9 @@ you, and only the desired file will be given as the `result`.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const completedTaskResult = await dataProtectorCore.getResultFromCompletedTask({
+const completedTaskResult = await iapp.getResultFromCompletedTask({
   taskId: '0x7ac398...',
   path: 'content', // [!code focus]
 });
@@ -80,9 +80,9 @@ encrypt the protected data.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const completedTaskResult = await dataProtectorCore.getResultFromCompletedTask({
+const completedTaskResult = await iapp.getResultFromCompletedTask({
   taskId: '0x7ac398...',
   pemPrivateKey: '-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----', // [!code focus]
 });
@@ -102,10 +102,10 @@ import {
 } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const completedTaskResult =
-  await dataProtectorCore.getResultFromCompletedTask({
+  await iapp.getResultFromCompletedTask({
     taskId: '0x7ac398...',
     onStatusUpdate: ({ title, isDone }) => { // [!code focus]
       console.log(title, isDone); // [!code focus]
diff --git a/src/references/iapp-generator/sdk/grantAccess.md b/src/references/iapp-generator/sdk/grantAccess.md
index 966525e6..212f458a 100644
--- a/src/references/iapp-generator/sdk/grantAccess.md
+++ b/src/references/iapp-generator/sdk/grantAccess.md
@@ -19,9 +19,9 @@ protected data (or a designated list of protected data).
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const grantedAccess = await dataProtectorCore.grantAccess({
+const grantedAccess = await iapp.grantAccess({
   iapp: '0x123abc...',
   authorizedProtectedData: '0x456def...',
   authorizedUser: '0x789cba...',
@@ -49,9 +49,9 @@ The ethereum address of the iApp you wish to grant access to. **You must own thi
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const grantedAccess = await dataProtectorCore.grantAccess({
+const grantedAccess = await iapp.grantAccess({
   iapp: '0x123abc...', // [!code focus]
   authorizedProtectedData: '0x456def...',
   authorizedUser: '0x789cba...',
@@ -75,9 +75,9 @@ access for the `protectedData` each time you do so.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const grantedAccess = await dataProtectorCore.grantAccess({
+const grantedAccess = await iapp.grantAccess({
   iapp: '0x123abc...',
   authorizedProtectedData: '0x456def...', // [!code focus]
   authorizedUser: '0x789cba...',
@@ -110,9 +110,9 @@ permission for the user to submit the protected data to the iApp.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const grantedAccess = await dataProtectorCore.grantAccess({
+const grantedAccess = await iapp.grantAccess({
   iapp: '0x123abc...',
   authorizedProtectedData: '0x456def...',
   authorizedUser: '0x789cba...', // [!code focus]
@@ -146,9 +146,9 @@ The fee is paid to the owner of the iApp.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const grantedAccess = await dataProtectorCore.grantAccess({
+const grantedAccess = await iapp.grantAccess({
   iapp: '0x123abc...',
   authorizedProtectedData: '0x456def...',
   authorizedUser: '0x789cba...',
@@ -191,9 +191,9 @@ the `grantAccess` method.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const grantedAccess = await dataProtectorCore.grantAccess({
+const grantedAccess = await iapp.grantAccess({
   iapp: '0x123abc...',
   authorizedProtectedData: '0x456def...',
   authorizedUser: '0x789cba...',
@@ -213,9 +213,9 @@ Callback function to be notified at intermediate steps.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const grantedAccess = await dataProtectorCore.grantAccess({
+const grantedAccess = await iapp.grantAccess({
   protectedData: '0x123abc...',
   authorizedApp: '0x456def...',
   authorizedUser: '0x789cba...',
diff --git a/src/references/iapp-generator/sdk/revokeAllAccess.md b/src/references/iapp-generator/sdk/revokeAllAccess.md
index 28ab9d6d..f4eba14e 100644
--- a/src/references/iapp-generator/sdk/revokeAllAccess.md
+++ b/src/references/iapp-generator/sdk/revokeAllAccess.md
@@ -27,9 +27,9 @@ all done.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const revokeAllAccessResult = await dataProtectorCore.revokeAllAccess({
+const revokeAllAccessResult = await iapp.revokeAllAccess({
   iapp: '0x123abc...',
   authorizedProtectedData: '0x456def...',
   authorizedUser: '0x789cba...',
@@ -52,9 +52,9 @@ The address of the `iApp` subject to access revocation.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const revokeAllAccessResult = await dataProtectorCore.revokeAllAccess({
+const revokeAllAccessResult = await iapp.revokeAllAccess({
   iapp: '0x123abc...', // [!code focus]
 });
 ```
@@ -71,9 +71,9 @@ from the iApp, regardless of the protected data.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const revokeAllAccessResult = await dataProtectorCore.revokeAllAccess({
+const revokeAllAccessResult = await iapp.revokeAllAccess({
   iapp: '0x123abc...',
   authorizedProtectedData: '0x456def...', // [!code focus]
   authorizedUser: '0x789cba...',
@@ -92,9 +92,9 @@ iApp, regardless of the authorized user.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const revokeAllAccessResult = await dataProtectorCore.revokeAllAccess({
+const revokeAllAccessResult = await iapp.revokeAllAccess({
   iapp: '0x123abc...',
   authorizedProtectedData: '0x456def...',
   authorizedUser: '0x789cba...', // [!code focus]
@@ -112,9 +112,9 @@ Callback function to be notified at intermediate steps.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const revokeAllAccessResult = await dataProtectorCore.revokeAllAccess({
+const revokeAllAccessResult = await iapp.revokeAllAccess({
   iapp: '0x123abc...',
   authorizedProtectedData: '0x456def...',
   authorizedUser: '0x789cba...',
diff --git a/src/references/iapp-generator/sdk/revokeOneAccess.md b/src/references/iapp-generator/sdk/revokeOneAccess.md
index 6afb4b5e..6e3068f3 100644
--- a/src/references/iapp-generator/sdk/revokeOneAccess.md
+++ b/src/references/iapp-generator/sdk/revokeOneAccess.md
@@ -27,9 +27,9 @@ method.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const revokeAccess = await dataProtectorCore.revokeOneAccess({
+const revokeAccess = await iapp.revokeOneAccess({
   app: '0xea...',
   appprice: '0',
   volume: '1',
@@ -60,9 +60,9 @@ This is the complete `granted access` object retrieved from an invocation of
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const revokeAccess = await dataProtectorCore.revokeOneAccess({
+const revokeAccess = await iapp.revokeOneAccess({
   app: '0xea...', // [!code focus]
   appprice: '0', // [!code focus]
   volume: '1', // [!code focus]
diff --git a/src/references/iapp-generator/sdk/runIApp.md b/src/references/iapp-generator/sdk/runIApp.md
index 41248e85..fb0ddf69 100644
--- a/src/references/iapp-generator/sdk/runIApp.md
+++ b/src/references/iapp-generator/sdk/runIApp.md
@@ -22,9 +22,9 @@ Allows executing an iApp with optional protected data processing.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const runIAppResponse = await dataProtectorCore.runIApp({
+const runIAppResponse = await iapp.runIApp({
   iapp: '0x456def...',
   protectedData: '0x123abc...',
   args: 'arg1 arg2',
@@ -55,9 +55,9 @@ The address or ENS of the iApp to execute.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const runIAppResponse = await dataProtectorCore.runIApp({
+const runIAppResponse = await iapp.runIApp({
   iapp: '0x456def...', // [!code focus]
   protectedData: '0x123abc...',
 });
@@ -73,9 +73,9 @@ The address or ENS of the authorized protected data that the iApp will process.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const runIAppResponse = await dataProtectorCore.runIApp({
+const runIAppResponse = await iapp.runIApp({
   iapp: '0x456def...',
   protectedData: '0x123abc...', // [!code focus]
 });
@@ -92,9 +92,9 @@ The maximum price of dataset per task for processing the protected data.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const runIAppResponse = await dataProtectorCore.runIApp({
+const runIAppResponse = await iapp.runIApp({
   iapp: '0x456def...',
   protectedData: '0x123abc...',
   dataMaxPrice: 10, // [!code focus]
@@ -112,9 +112,9 @@ The maximum price of application per task for processing the protected data.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const runIAppResponse = await dataProtectorCore.runIApp({
+const runIAppResponse = await iapp.runIApp({
   iapp: '0x456def...',
   protectedData: '0x123abc...',
   appMaxPrice: 5, // [!code focus]
@@ -132,9 +132,9 @@ The maximum price of workerpool per task for processing the protected data.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const runIAppResponse = await dataProtectorCore.runIApp({
+const runIAppResponse = await iapp.runIApp({
   iapp: '0x456def...',
   protectedData: '0x123abc...',
   workerpoolMaxPrice: 2, // [!code focus]
@@ -151,9 +151,9 @@ The file name of the desired file in the returned ZIP file.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const runIAppResponse = await dataProtectorCore.runIApp({
+const runIAppResponse = await iapp.runIApp({
   iapp: '0x456def...',
   protectedData: '0x123abc...',
   path: 'my-content', // [!code focus]
@@ -170,9 +170,9 @@ Arguments to pass to the application during execution.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const runIAppResponse = await dataProtectorCore.runIApp({
+const runIAppResponse = await iapp.runIApp({
   iapp: '0x456def...',
   protectedData: '0x123abc...',
   args: 'arg1 arg2', // [!code focus]
@@ -189,9 +189,9 @@ The input file required for the application's execution (direct download URL).
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const runIAppResponse = await dataProtectorCore.runIApp({
+const runIAppResponse = await iapp.runIApp({
   iapp: '0x456def...',
   protectedData: '0x123abc...',
   inputFiles: ['https://example.com/file1', 'https://example.com/file2'], // [!code focus]
@@ -209,9 +209,9 @@ It is represented as a mapping of numerical identifiers to corresponding secrets
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const runIAppResponse = await dataProtectorCore.runIApp({
+const runIAppResponse = await iapp.runIApp({
   iapp: '0x456def...',
   protectedData: '0x123abc...',
   secrets: { // [!code focus]
@@ -231,9 +231,9 @@ Address or ENS of the smart contract to be called back once the task is complete
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const runIAppResponse = await dataProtectorCore.runIApp({
+const runIAppResponse = await iapp.runIApp({
   iapp: '0x456def...',
   protectedData: '0x123abc...',
   callbackContract: '0x789ghi...', // [!code focus]
@@ -250,9 +250,9 @@ The workerpool to use for the application's execution. (default iExec production
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const runIAppResponse = await dataProtectorCore.runIApp({
+const runIAppResponse = await iapp.runIApp({
   iapp: '0x456def...',
   protectedData: '0x123abc...',
   workerpool: '0xabc123...', // [!code focus]
@@ -269,9 +269,9 @@ A boolean that indicates whether to use a voucher or no.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const runIAppResponse = await dataProtectorCore.runIApp({
+const runIAppResponse = await iapp.runIApp({
   iapp: '0x456def...',
   protectedData: '0x123abc...',
   useVoucher: true, // [!code focus]
@@ -288,9 +288,9 @@ Override the voucher contract to use, must be combined with useVoucher: true the
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const runIAppResponse = await dataProtectorCore.runIApp({
+const runIAppResponse = await iapp.runIApp({
   iapp: '0x456def...',
   protectedData: '0x123abc...',
   useVoucher: true,
@@ -308,9 +308,9 @@ Callback function to be notified at intermediate steps.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const runIAppResponse = await dataProtectorCore.runIApp({
+const runIAppResponse = await iapp.runIApp({
   iapp: '0x456def...',
   protectedData: '0x123abc...',
   onStatusUpdate: ({ title, isDone }) => { // [!code focus]
diff --git a/src/references/iapp-generator/sdk/transferOwnership.md b/src/references/iapp-generator/sdk/transferOwnership.md
index c1353df6..fa40f47f 100644
--- a/src/references/iapp-generator/sdk/transferOwnership.md
+++ b/src/references/iapp-generator/sdk/transferOwnership.md
@@ -25,9 +25,9 @@ address `0x000000000000000000000000000000000000dEaD`.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const transferResponse = await dataProtectorCore.transferOwnership({
+const transferResponse = await iapp.transferOwnership({
   iapp: '0x123abc...',
   newOwner: '0xc5e9f4...',
 });
@@ -50,9 +50,9 @@ new owner.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const transferResponse = await dataProtectorCore.transferOwnership({
+const transferResponse = await iapp.transferOwnership({
   iapp: '0x123abc...', // [!code focus]
   newOwner: '0xc5e9f4...',
 });
@@ -68,9 +68,9 @@ ETH address for the new owner for the `iApp`.
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
 
 const web3Provider = getWeb3Provider('PRIVATE_KEY');
-const dataProtectorCore = new IExecIApp(web3Provider);
+const iapp = new IExecIApp(web3Provider);
 // ---cut---
-const transferResponse = await dataProtectorCore.transferOwnership({
+const transferResponse = await iapp.transferOwnership({
   iapp: '0x123abc...',
   newOwner: '0xc5e9f4...', // [!code focus]
 });

From dfd592cffff216b2158e5686ab290c2764242861 Mon Sep 17 00:00:00 2001
From: Le-Caignec <robinlecaignec@yahoo.fr>
Date: Thu, 25 Sep 2025 16:05:49 +0200
Subject: [PATCH 08/11] refactor(docs): improve clarity and consistency in iApp
 and DataProtector documentation

---
 src/references/dataProtector/types.md         |  6 +-
 .../iapp-generator/sdk/getGrantedAccess.md    | 47 +++++------
 src/references/iapp-generator/sdk/getIApp.md  | 21 +++--
 .../iapp-generator/sdk/grantAccess.md         | 78 ++++++++++---------
 .../iapp-generator/sdk/revokeAllAccess.md     | 34 ++++----
 .../iapp-generator/sdk/revokeOneAccess.md     | 17 ++--
 src/references/iapp-generator/sdk/runIApp.md  | 59 +++++++-------
 .../iapp-generator/sdk/transferOwnership.md   | 32 ++++----
 src/references/iapp-generator/sdk/types.md    | 30 +++----
 9 files changed, 170 insertions(+), 154 deletions(-)

diff --git a/src/references/dataProtector/types.md b/src/references/dataProtector/types.md
index 419cddf0..88f51c36 100644
--- a/src/references/dataProtector/types.md
+++ b/src/references/dataProtector/types.md
@@ -22,11 +22,13 @@ Types in DataProtector.
 
 ### volume: <span class="text-yellow">`string`</span>
 
-- Total number of authorized accesses for processing a Protected Data when the access was signed and published
+- Total number of authorized accesses for processing a Protected Data when the
+  access was signed and published
 
 ### remainingAccess: <span class="text-yellow">`number`</span>
 
-- Number of remaining authorized accesses for processing a protected data; each use decrements this counter
+- Number of remaining authorized accesses for processing a protected data; each
+  use decrements this counter
 
 ### tag: <span class="text-yellow">`string`</span>
 
diff --git a/src/references/iapp-generator/sdk/getGrantedAccess.md b/src/references/iapp-generator/sdk/getGrantedAccess.md
index 3cf7e8b1..7ccc9666 100644
--- a/src/references/iapp-generator/sdk/getGrantedAccess.md
+++ b/src/references/iapp-generator/sdk/getGrantedAccess.md
@@ -1,16 +1,16 @@
 ---
 title: getGrantedAccess
 description:
-  Retrieve all granted access details for an iApp with iExec's
-  getGrantedAccess method. Filter access by user, application, or both, and
-  manage access with pagination.
+  Retrieve all granted access details for an iApp with iExec's getGrantedAccess
+  method. Filter access by user, application, or both, and manage access with
+  pagination.
 ---
 
 # getGrantedAccess
 
 This method provides a listing of all access grants given for the specified
-iApp. Options for filtering include specifying an authorized
-user, an authorized protected data, or both.
+iApp. Options for filtering include specifying an authorized user, an authorized
+protected data, or both.
 
 ## Usage
 
@@ -25,8 +25,8 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const listGrantedAccess = await iapp.getGrantedAccess({
-  iapp: '0x123abc...',
-  authorizedProtectedData: '0x456def...',
+  iapp: '0x456def....',
+  authorizedProtectedData: '0x123abc...',
   authorizedUser: '0x789cba...',
   page: 1,
   pageSize: 100,
@@ -43,10 +43,9 @@ import { type GetGrantedAccessParams } from '@mage-sombre/iapp';
 
 **Type:** `AddressOrENS`
 
-Address of the iApp for which you are querying access
-authorization grants. It's a representation of ethereum address or ENS name
-(Ethereum Name Service). If no address is specified, it will return all granted
-access for any iApp.
+Address of the iApp for which you are querying access authorization grants. It's
+a representation of ethereum address or ENS name (Ethereum Name Service). If no
+address is specified, it will return all granted access for any iApp.
 
 **Usage example:**
 
@@ -57,7 +56,7 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const listGrantedAccess = await iapp.getGrantedAccess({
-  iapp: '0x123abc...', // [!code focus]
+  iapp: '0x456def....', // [!code focus]
 });
 ```
 
@@ -79,19 +78,20 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const listGrantedAccess = await iapp.getGrantedAccess({
-  authorizedProtectedData: '0x456def...', // [!code focus]
+  authorizedProtectedData: '0x123abc...', // [!code focus]
 });
 ```
 
 ::: tip
 
 If you specified a protected data whitelist when using
-[`grantAccess`](/references/iapp-generator/sdk/grantAccess), you
-must specify that same whitelist address when using this filtering option. The
+[`grantAccess`](/references/iapp-generator/sdk/grantAccess), you must specify
+that same whitelist address when using this filtering option. The
 `getGrantedAccess` method does not check against whitelist smart contracts when
 aggregating results. If you granted authorization to a whitelist but specify a
-protected data address for the `authorizedProtectedData` parameter, you will not receive any
-results unless you _also_ explicitly granted access to that protected data address.
+protected data address for the `authorizedProtectedData` parameter, you will not
+receive any results unless you _also_ explicitly granted access to that
+protected data address.
 
 :::
 
@@ -133,8 +133,8 @@ const iapp = new IExecIApp(web3Provider);
 // ---cut---
 
 const listGrantedAccess = await iapp.getGrantedAccess({
-  iapp: '0x123abc...',
-  authorizedProtectedData: '0x456def...',
+  iapp: '0x456def....',
+  authorizedProtectedData: '0x123abc...',
   authorizedUser: '0x789cba...',
   isUserStrict: true, // [!code focus]
 });
@@ -160,7 +160,7 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const listGrantedAccess = await iapp.getGrantedAccess({
-  iapp: '0x123abc...',
+  iapp: '0x456def....',
   page: 1, // [!code focus]
   pageSize: 100,
 });
@@ -185,7 +185,7 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const listGrantedAccess = await iapp.getGrantedAccess({
-  iapp: '0x123abc...',
+  iapp: '0x456def....',
   page: 1,
   pageSize: 100, // [!code focus]
 });
@@ -201,8 +201,9 @@ The return value for this method has two fields: a `count` parameter indicating
 the number of results, and an array of `GrantedAccess` objects containing all
 access data. When using the optional paging parameters, the `count` will be
 limited by the selected `pageSize` parameter. You may use these result objects
-in conjunction with the [revokeOneAccess](/references/iapp-generator/sdk/revokeOneAccess) method to revoke a
-previously granted authorization for access.
+in conjunction with the
+[revokeOneAccess](/references/iapp-generator/sdk/revokeOneAccess) method to
+revoke a previously granted authorization for access.
 
 ### count
 
diff --git a/src/references/iapp-generator/sdk/getIApp.md b/src/references/iapp-generator/sdk/getIApp.md
index a42bebe5..adb1d836 100644
--- a/src/references/iapp-generator/sdk/getIApp.md
+++ b/src/references/iapp-generator/sdk/getIApp.md
@@ -1,21 +1,23 @@
 ---
 title: getIApp
 description:
-  Retrieve all iApps for a specific owner or filter by creation date with the getIApp
-  method in iExec iApp Generator SDK. Easily access iApp metadata and information,
-  sorted by creation date.
+  Retrieve all iApps for a specific owner or filter by creation date with the
+  getIApp method in iExec iApp Generator SDK. Easily access iApp metadata and
+  information, sorted by creation date.
 ---
 
 # getIApp
 
-This method allows the user to retrieve all iApps for a given owner or filter by creation timestamp.
+This method allows the user to retrieve all iApps for a given owner or filter by
+creation timestamp.
 
 Results are ordered by `creationTimestamp` desc.
 
 ::: tip
 
-An iApp is a confidential computing application that runs in secure TEE environments.
-The method returns iApp metadata including name, address, owner, and creation timestamp.
+An iApp is a confidential computing application that runs in secure TEE
+environments. The method returns iApp metadata including name, address, owner,
+and creation timestamp.
 
 :::
 
@@ -55,7 +57,7 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const oneIApp = await iapp.getIApp({
-  iapp: '0x123abc...', // [!code focus]
+  iapp: '0x456def....', // [!code focus]
 });
 ```
 
@@ -74,6 +76,8 @@ const iapp = new IExecIApp(web3Provider);
 const iAppsByOwner = await iapp.getIApp({
   owner: '0xa0c15e...', // [!code focus]
 });
+```
+
 ### createdAfterTimestamp <OptionalBadge />
 
 **Type:** `number`
@@ -96,7 +100,8 @@ const recentIApps = await iapp.getIApp({
 **Type:** `number`  
 **Default:** `0`
 
-Specifies the page number of the result set to return. Pages are zero-based indexed.
+Specifies the page number of the result set to return. Pages are zero-based
+indexed.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
diff --git a/src/references/iapp-generator/sdk/grantAccess.md b/src/references/iapp-generator/sdk/grantAccess.md
index 212f458a..3ca890f0 100644
--- a/src/references/iapp-generator/sdk/grantAccess.md
+++ b/src/references/iapp-generator/sdk/grantAccess.md
@@ -1,17 +1,18 @@
 ---
 title: grantAccess
 description:
-  Grant secure access to an iApp with iExec's grantAccess method.
-  Authorize specific protected data or users to use the iApp, with
-  customizable access limits and pricing.
+  Grant secure access to an iApp with iExec's grantAccess method. Authorize
+  specific protected data or users to use the iApp, with customizable access
+  limits and pricing.
 ---
 
 # grantAccess
 
-iApps require explicit authorization for runtime access. A newly created `iApp` has no inherent
-authorizations. This method grants permission to securely access the specified
-`iApp` for processing. Authorization to use the `iApp` is given to a user in the context of
-protected data (or a designated list of protected data).
+iApps require explicit authorization for runtime access. A newly created `iApp`
+has no inherent authorizations. This method grants permission to securely access
+the specified `iApp` for processing. Authorization to use the `iApp` is given to
+a user in the context of protected data (or a designated list of protected
+data).
 
 ## Usage
 
@@ -22,8 +23,8 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const grantedAccess = await iapp.grantAccess({
-  iapp: '0x123abc...',
-  authorizedProtectedData: '0x456def...',
+  iapp: '0x456def....',
+  authorizedProtectedData: '0x123abc...',
   authorizedUser: '0x789cba...',
   pricePerAccess: 3,
   numberOfAccess: 10,
@@ -43,7 +44,8 @@ import { type GrantAccessParams } from '@mage-sombre/iapp';
 
 **Type:** `AddressOrENS`
 
-The ethereum address of the iApp you wish to grant access to. **You must own this iApp** to grant access.
+The ethereum address of the iApp you wish to grant access to. **You must own
+this iApp** to grant access.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -52,8 +54,8 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const grantedAccess = await iapp.grantAccess({
-  iapp: '0x123abc...', // [!code focus]
-  authorizedProtectedData: '0x456def...',
+  iapp: '0x456def....', // [!code focus]
+  authorizedProtectedData: '0x123abc...',
   authorizedUser: '0x789cba...',
 });
 ```
@@ -62,10 +64,10 @@ const grantedAccess = await iapp.grantAccess({
 
 **Type:** `AddressOrENS`
 
-The address of the protected data you wish to authorize to use the
-`iApp` within a secure execution environment. You may specify either a
-single protected data or a protected data whitelist. To specify a whitelist, you
-provide the ETH address of an
+The address of the protected data you wish to authorize to use the `iApp` within
+a secure execution environment. You may specify either a single protected data
+or a protected data whitelist. To specify a whitelist, you provide the ETH
+address of an
 [iExec Whitelist Smart Contract](https://github.com/iExecBlockchainComputing/whitelist-smart-contract/tree/main).
 This smart contract should aggregates multiple application versions. This allows
 you to introduce new versions of your application without needing to grant
@@ -78,15 +80,16 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const grantedAccess = await iapp.grantAccess({
-  iapp: '0x123abc...',
-  authorizedProtectedData: '0x456def...', // [!code focus]
+  iapp: '0x456def....',
+  authorizedProtectedData: '0x123abc...', // [!code focus]
   authorizedUser: '0x789cba...',
 });
 ```
 
 ::: tip
 
-You may authorize a specific protected data or a whitelist of protected data to use the iApp.
+You may authorize a specific protected data or a whitelist of protected data to
+use the iApp.
 
 The latest version of the iExec Web3Mail decentralized application is
 `{{web3MailAddress}}`.
@@ -102,9 +105,9 @@ access once. The ETH address for this whitelist is **{{web3MailAppWhitelist}}**.
 
 **Type:** `AddressOrENS`
 
-The address of the user you wish to authorize to use the `iApp`. Note
-that these users may not view or manipulate the data. This only grants
-permission for the user to submit the protected data to the iApp.
+The address of the user you wish to authorize to use the `iApp`. Note that these
+users may not view or manipulate the data. This only grants permission for the
+user to submit the protected data to the iApp.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -113,8 +116,8 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const grantedAccess = await iapp.grantAccess({
-  iapp: '0x123abc...',
-  authorizedProtectedData: '0x456def...',
+  iapp: '0x456def....',
+  authorizedProtectedData: '0x123abc...',
   authorizedUser: '0x789cba...', // [!code focus]
 });
 ```
@@ -132,13 +135,13 @@ You may authorize all users to use the iApp by setting this to
 **Default:** `0`
 
 Specifies the usage fee in nano RLC (nRLC) associated with each access of the
-iApp. It represents the cost incurred for each individual interaction with
-the iApp.
+iApp. It represents the cost incurred for each individual interaction with the
+iApp.
 
 By invoking the grantAccess method with a specific `pricePerAccess` you define
 the fee that the specified user (`authorizedUser` parameter) must pay for each
-access to the iApp when used with the specified protected data (`authorizedProtectedData`
-parameter).
+access to the iApp when used with the specified protected data
+(`authorizedProtectedData` parameter).
 
 The fee is paid to the owner of the iApp.
 
@@ -149,8 +152,8 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const grantedAccess = await iapp.grantAccess({
-  iapp: '0x123abc...',
-  authorizedProtectedData: '0x456def...',
+  iapp: '0x456def....',
+  authorizedProtectedData: '0x123abc...',
   authorizedUser: '0x789cba...',
   pricePerAccess: 3, // [!code focus]
   numberOfAccess: 10,
@@ -171,16 +174,15 @@ When provided, `pricePerAccess` must be a non-negative integer value.
 **Type:** `number`  
 **Default:** `1`
 
-Allows restricting the number of times the iApp may be accessed and
-used.
+Allows restricting the number of times the iApp may be accessed and used.
 
 It is not technically possible to set an unlimited number of accesses, but you
 can set `numberOfAccess` to `10000` for example.
 
 ::: info
 
-If you attempt to access the iApp more times than specified in
-`numberOfAccess`, you will encounter a **"no dataset orders"** error.
+If you attempt to access the iApp more times than specified in `numberOfAccess`,
+you will encounter a **"no dataset orders"** error.
 
 To prevent this error, ensure the `numberOfAccess` is properly set when calling
 the `grantAccess` method.
@@ -194,8 +196,8 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const grantedAccess = await iapp.grantAccess({
-  iapp: '0x123abc...',
-  authorizedProtectedData: '0x456def...',
+  iapp: '0x456def....',
+  authorizedProtectedData: '0x123abc...',
   authorizedUser: '0x789cba...',
   pricePerAccess: 3,
   numberOfAccess: 10, // [!code focus]
@@ -216,8 +218,8 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const grantedAccess = await iapp.grantAccess({
-  protectedData: '0x123abc...',
-  authorizedApp: '0x456def...',
+  iapp: '0x456def....',
+  authorizedProtectedData: '0x123abc...',
   authorizedUser: '0x789cba...',
   onStatusUpdate: ({ title, isDone }) => { // [!code focus]
     console.log(title, isDone); // [!code focus]
diff --git a/src/references/iapp-generator/sdk/revokeAllAccess.md b/src/references/iapp-generator/sdk/revokeAllAccess.md
index f4eba14e..e7de3729 100644
--- a/src/references/iapp-generator/sdk/revokeAllAccess.md
+++ b/src/references/iapp-generator/sdk/revokeAllAccess.md
@@ -8,10 +8,10 @@ description:
 
 # revokeAllAccess
 
-This method allows revoking authorizations granted to an `iApp` entity.
-You may optionally specify protected data or user addresses for revocation. If you
-do not specify either of these optional values, this method will revoke all
-access for all users and protected data.
+This method allows revoking authorizations granted to an `iApp` entity. You may
+optionally specify protected data or user addresses for revocation. If you do
+not specify either of these optional values, this method will revoke all access
+for all users and protected data.
 
 You must be the owner of the iApp.
 
@@ -30,8 +30,8 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const revokeAllAccessResult = await iapp.revokeAllAccess({
-  iapp: '0x123abc...',
-  authorizedProtectedData: '0x456def...',
+  iapp: '0x456def....',
+  authorizedProtectedData: '0x123abc...',
   authorizedUser: '0x789cba...',
 });
 ```
@@ -55,7 +55,7 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const revokeAllAccessResult = await iapp.revokeAllAccess({
-  iapp: '0x123abc...', // [!code focus]
+  iapp: '0x456def....', // [!code focus]
 });
 ```
 
@@ -64,8 +64,8 @@ const revokeAllAccessResult = await iapp.revokeAllAccess({
 **Type:** `AddressOrENS`
 
 The protected data address to be removed from the authorization list for the
-specified `iApp`. If no address is specified, it will revoke all access
-from the iApp, regardless of the protected data.
+specified `iApp`. If no address is specified, it will revoke all access from the
+iApp, regardless of the protected data.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -74,8 +74,8 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const revokeAllAccessResult = await iapp.revokeAllAccess({
-  iapp: '0x123abc...',
-  authorizedProtectedData: '0x456def...', // [!code focus]
+  iapp: '0x456def....',
+  authorizedProtectedData: '0x123abc...', // [!code focus]
   authorizedUser: '0x789cba...',
 });
 ```
@@ -85,8 +85,8 @@ const revokeAllAccessResult = await iapp.revokeAllAccess({
 **Type:** `AddressOrENS`
 
 The user address to be removed from the authorization list for the specified
-`iApp`. If no address is specified, it will revoke all access from the
-iApp, regardless of the authorized user.
+`iApp`. If no address is specified, it will revoke all access from the iApp,
+regardless of the authorized user.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -95,8 +95,8 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const revokeAllAccessResult = await iapp.revokeAllAccess({
-  iapp: '0x123abc...',
-  authorizedProtectedData: '0x456def...',
+  iapp: '0x456def....',
+  authorizedProtectedData: '0x123abc...',
   authorizedUser: '0x789cba...', // [!code focus]
 });
 ```
@@ -115,8 +115,8 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const revokeAllAccessResult = await iapp.revokeAllAccess({
-  iapp: '0x123abc...',
-  authorizedProtectedData: '0x456def...',
+  iapp: '0x456def....',
+  authorizedProtectedData: '0x123abc...',
   authorizedUser: '0x789cba...',
   onStatusUpdate: ({ title, isDone }) => { // [!code focus]
     console.log(title, isDone); // [!code focus]
diff --git a/src/references/iapp-generator/sdk/revokeOneAccess.md b/src/references/iapp-generator/sdk/revokeOneAccess.md
index 6e3068f3..ccb667ab 100644
--- a/src/references/iapp-generator/sdk/revokeOneAccess.md
+++ b/src/references/iapp-generator/sdk/revokeOneAccess.md
@@ -1,17 +1,17 @@
 ---
 title: revokeOneAccess
 description:
-  Revoke specific access permissions to an iApp with iExec's
-  revokeOneAccess method. Manage and remove access granted to users or
-  protected data through blockchain transactions.
+  Revoke specific access permissions to an iApp with iExec's revokeOneAccess
+  method. Manage and remove access granted to users or protected data through
+  blockchain transactions.
 ---
 
 # revokeOneAccess
 
-This method allows revoking a specific access authorization from an
-`iApp` entity. The input parameter for this method is sourced from the
-[getGrantedAccess](/references/iapp-generator/sdk/getGrantedAccess) method, which provides a list of all
-authorizations on single `iApp` entity.
+This method allows revoking a specific access authorization from an `iApp`
+entity. The input parameter for this method is sourced from the
+[getGrantedAccess](/references/iapp-generator/sdk/getGrantedAccess) method,
+which provides a list of all authorizations on single `iApp` entity.
 
 As this will generate a blockchain transaction, expect it to take a least 5sec
 (a block time).
@@ -20,8 +20,7 @@ As this will generate a blockchain transaction, expect it to take a least 5sec
 
 The `revokeOneAccess` method requires a `grantedAccess` object as an input
 parameter. This object is retrieved from the
-[`getGrantedAccess`](/references/iapp-generator/sdk/getGrantedAccess)
-method.
+[`getGrantedAccess`](/references/iapp-generator/sdk/getGrantedAccess) method.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
diff --git a/src/references/iapp-generator/sdk/runIApp.md b/src/references/iapp-generator/sdk/runIApp.md
index fb0ddf69..eb1440d3 100644
--- a/src/references/iapp-generator/sdk/runIApp.md
+++ b/src/references/iapp-generator/sdk/runIApp.md
@@ -2,7 +2,8 @@
 title: runIApp
 description:
   Execute iApps securely with iExec's runIApp method. Run confidential computing
-  applications with optional protected data while maintaining privacy and security.
+  applications with optional protected data while maintaining privacy and
+  security.
 ---
 
 # runIApp
@@ -11,10 +12,9 @@ Allows executing an iApp with optional protected data processing.
 
 > [!IMPORTANT]
 >
-> You must ensure the iApp has authorization to use the `protectedData` if provided.
-> You may grant this permission using the
-> [`grantAccess`](/references/iapp-generator/sdk/grantAccess)
-> method.
+> You must ensure the iApp has authorization to use the `protectedData` if
+> provided. You may grant this permission using the
+> [`grantAccess`](/references/iapp-generator/sdk/grantAccess) method.
 
 ## Usage
 
@@ -26,7 +26,7 @@ const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const runIAppResponse = await iapp.runIApp({
   iapp: '0x456def...',
-  protectedData: '0x123abc...',
+  protectedData: '0x456def....',
   args: 'arg1 arg2',
   inputFiles: ['https://example.com/file1', 'https://example.com/file2'],
   secrets: {
@@ -59,7 +59,7 @@ const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const runIAppResponse = await iapp.runIApp({
   iapp: '0x456def...', // [!code focus]
-  protectedData: '0x123abc...',
+  protectedData: '0x456def....',
 });
 ```
 
@@ -77,7 +77,7 @@ const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const runIAppResponse = await iapp.runIApp({
   iapp: '0x456def...',
-  protectedData: '0x123abc...', // [!code focus]
+  protectedData: '0x456def....', // [!code focus]
 });
 ```
 
@@ -96,7 +96,7 @@ const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const runIAppResponse = await iapp.runIApp({
   iapp: '0x456def...',
-  protectedData: '0x123abc...',
+  protectedData: '0x456def....',
   dataMaxPrice: 10, // [!code focus]
 });
 ```
@@ -116,7 +116,7 @@ const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const runIAppResponse = await iapp.runIApp({
   iapp: '0x456def...',
-  protectedData: '0x123abc...',
+  protectedData: '0x456def....',
   appMaxPrice: 5, // [!code focus]
 });
 ```
@@ -136,7 +136,7 @@ const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const runIAppResponse = await iapp.runIApp({
   iapp: '0x456def...',
-  protectedData: '0x123abc...',
+  protectedData: '0x456def....',
   workerpoolMaxPrice: 2, // [!code focus]
 });
 ```
@@ -155,7 +155,7 @@ const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const runIAppResponse = await iapp.runIApp({
   iapp: '0x456def...',
-  protectedData: '0x123abc...',
+  protectedData: '0x456def....',
   path: 'my-content', // [!code focus]
 });
 ```
@@ -174,7 +174,7 @@ const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const runIAppResponse = await iapp.runIApp({
   iapp: '0x456def...',
-  protectedData: '0x123abc...',
+  protectedData: '0x456def....',
   args: 'arg1 arg2', // [!code focus]
 });
 ```
@@ -193,7 +193,7 @@ const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const runIAppResponse = await iapp.runIApp({
   iapp: '0x456def...',
-  protectedData: '0x123abc...',
+  protectedData: '0x456def....',
   inputFiles: ['https://example.com/file1', 'https://example.com/file2'], // [!code focus]
 });
 ```
@@ -202,8 +202,8 @@ const runIAppResponse = await iapp.runIApp({
 
 **Type:** `Record<number, string>`
 
-Requester secrets necessary for the application's execution.
-It is represented as a mapping of numerical identifiers to corresponding secrets.
+Requester secrets necessary for the application's execution. It is represented
+as a mapping of numerical identifiers to corresponding secrets.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -213,8 +213,9 @@ const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const runIAppResponse = await iapp.runIApp({
   iapp: '0x456def...',
-  protectedData: '0x123abc...',
-  secrets: { // [!code focus]
+  protectedData: '0x456def....',
+  secrets: {
+    // [!code focus]
     1: 'secret1', // [!code focus]
     2: 'secret2', // [!code focus]
   }, // [!code focus]
@@ -225,7 +226,8 @@ const runIAppResponse = await iapp.runIApp({
 
 **Type:** `AddressOrENS`
 
-Address or ENS of the smart contract to be called back once the task is completed.
+Address or ENS of the smart contract to be called back once the task is
+completed.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -235,7 +237,7 @@ const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const runIAppResponse = await iapp.runIApp({
   iapp: '0x456def...',
-  protectedData: '0x123abc...',
+  protectedData: '0x456def....',
   callbackContract: '0x789ghi...', // [!code focus]
 });
 ```
@@ -244,7 +246,8 @@ const runIAppResponse = await iapp.runIApp({
 
 **Type:** `AddressOrENS`
 
-The workerpool to use for the application's execution. (default iExec production workerpool)
+The workerpool to use for the application's execution. (default iExec production
+workerpool)
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -254,7 +257,7 @@ const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const runIAppResponse = await iapp.runIApp({
   iapp: '0x456def...',
-  protectedData: '0x123abc...',
+  protectedData: '0x456def....',
   workerpool: '0xabc123...', // [!code focus]
 });
 ```
@@ -273,7 +276,7 @@ const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const runIAppResponse = await iapp.runIApp({
   iapp: '0x456def...',
-  protectedData: '0x123abc...',
+  protectedData: '0x456def....',
   useVoucher: true, // [!code focus]
 });
 ```
@@ -282,7 +285,8 @@ const runIAppResponse = await iapp.runIApp({
 
 **Type:** `AddressOrENS`
 
-Override the voucher contract to use, must be combined with useVoucher: true the user must be authorized by the voucher's owner to use it.
+Override the voucher contract to use, must be combined with useVoucher: true the
+user must be authorized by the voucher's owner to use it.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -292,7 +296,7 @@ const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const runIAppResponse = await iapp.runIApp({
   iapp: '0x456def...',
-  protectedData: '0x123abc...',
+  protectedData: '0x456def....',
   useVoucher: true,
   voucherOwner: '0xdef456...', // [!code focus]
 });
@@ -312,8 +316,9 @@ const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const runIAppResponse = await iapp.runIApp({
   iapp: '0x456def...',
-  protectedData: '0x123abc...',
-  onStatusUpdate: ({ title, isDone }) => { // [!code focus]
+  protectedData: '0x456def....',
+  onStatusUpdate: ({ title, isDone }) => {
+    // [!code focus]
     console.log(title, isDone); // [!code focus]
   }, // [!code focus]
 });
diff --git a/src/references/iapp-generator/sdk/transferOwnership.md b/src/references/iapp-generator/sdk/transferOwnership.md
index fa40f47f..ae511a03 100644
--- a/src/references/iapp-generator/sdk/transferOwnership.md
+++ b/src/references/iapp-generator/sdk/transferOwnership.md
@@ -1,23 +1,23 @@
 ---
 title: transferOwnership
 description:
-  Transfer ownership of an iApp to a new owner with iExec's
-  transferOwnership method. Securely update iApp ownership and automatically
-  revoke previous access permissions.
+  Transfer ownership of an iApp to a new owner with iExec's transferOwnership
+  method. Securely update iApp ownership and automatically revoke previous
+  access permissions.
 ---
 
 # transferOwnership
 
-Allows transferring ownership of an `iApp` entity to a new owner,
-identified by their ETH address. The return value provides a transaction hash
-and confirmation of the new owner of the `iApp`. Only the current owner
-of the `iApp` may invoke this method.
+Allows transferring ownership of an `iApp` entity to a new owner, identified by
+their ETH address. The return value provides a transaction hash and confirmation
+of the new owner of the `iApp`. Only the current owner of the `iApp` may invoke
+this method.
 
-When transferring the `iApp`, the grantedAccess created by the previous
-owner are revoked automatically.
+When transferring the `iApp`, the grantedAccess created by the previous owner
+are revoked automatically.
 
-Ownership of the `iApp` can be renounced by transferring it to the burn
-address `0x000000000000000000000000000000000000dEaD`.
+Ownership of the `iApp` can be renounced by transferring it to the burn address
+`0x000000000000000000000000000000000000dEaD`.
 
 ## Usage
 
@@ -28,7 +28,7 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const transferResponse = await iapp.transferOwnership({
-  iapp: '0x123abc...',
+  iapp: '0x456def....',
   newOwner: '0xc5e9f4...',
 });
 ```
@@ -43,8 +43,8 @@ import { type TransferParams } from '@mage-sombre/iapp';
 
 **Type:** `AddressOrENS`
 
-ETH address of the `iApp` owned by you which is to be transferred to a
-new owner.
+ETH address of the `iApp` owned by you which is to be transferred to a new
+owner.
 
 ```ts twoslash
 import { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';
@@ -53,7 +53,7 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const transferResponse = await iapp.transferOwnership({
-  iapp: '0x123abc...', // [!code focus]
+  iapp: '0x456def....', // [!code focus]
   newOwner: '0xc5e9f4...',
 });
 ```
@@ -71,7 +71,7 @@ const web3Provider = getWeb3Provider('PRIVATE_KEY');
 const iapp = new IExecIApp(web3Provider);
 // ---cut---
 const transferResponse = await iapp.transferOwnership({
-  iapp: '0x123abc...',
+  iapp: '0x456def....',
   newOwner: '0xc5e9f4...', // [!code focus]
 });
 ```
diff --git a/src/references/iapp-generator/sdk/types.md b/src/references/iapp-generator/sdk/types.md
index 4ebb500d..6a8dd6a1 100644
--- a/src/references/iapp-generator/sdk/types.md
+++ b/src/references/iapp-generator/sdk/types.md
@@ -1,8 +1,8 @@
 ---
 title: Types
 description:
-  Complete reference for iApp Generator SDK types including GrantedAccess,
-  IApp and other essential data structures.
+  Complete reference for iApp Generator SDK types including GrantedAccess, IApp
+  and other essential data structures.
 ---
 
 # Types
@@ -22,16 +22,18 @@ Types in iApp Generator SDK.
 
 ### volume: <span class="text-yellow">`string`</span>
 
-- Total number of authorized accesses for running an iApp when the access was signed and published
+- Total number of authorized accesses for running an iApp when the access was
+  signed and published
 
 ### remainingAccess: <span class="text-yellow">`number`</span>
 
-- Number of remaining authorized accesses for running an iApp; each use decrements this counter
+- Number of remaining authorized accesses for running an iApp; each use
+  decrements this counter
 
 ### tag: <span class="text-yellow">`string`</span>
 
-- Defines whether an `iApp` is usable in a TEE environment; `0x00` is
-  TEE while `0x03` is non-TEE
+- Defines whether an `iApp` is usable in a TEE environment; `0x00` is TEE while
+  `0x03` is non-TEE
 
 ### datasetrestrict: <span class="text-yellow">`string`</span>
 
@@ -40,8 +42,8 @@ Types in iApp Generator SDK.
 
 ### requesterrestrict: <span class="text-yellow">`string`</span>
 
-- Address of the requester authorized to run this `iApp` in workloads;
-  a value of 0x0 indicates any requester may use this iApp
+- Address of the requester authorized to run this `iApp` in workloads; a value
+  of 0x0 indicates any requester may use this iApp
 
 ### workerpoolrestrict: <span class="text-yellow">`string`</span>
 
@@ -62,8 +64,8 @@ Types in iApp Generator SDK.
 
 ### name: <span class="text-yellow">`string`</span>
 
-- Name specified when the iApp was created. This piece of information
-  is public and visible on-chain.
+- Name specified when the iApp was created. This piece of information is public
+  and visible on-chain.
 
 ### address: <span class="text-yellow">`Address`</span>
 
@@ -75,10 +77,10 @@ Types in iApp Generator SDK.
 
 ### creationTimestamp: <span class="text-yellow">`number`</span>
 
-- Timestamp specifying when the iapp was created, expressed in
-  milliseconds since the epoch. This timestamp provides precise information
-  about the moment of creation and can be used for chronological ordering or
-  time-based operations.
+- Timestamp specifying when the iapp was created, expressed in milliseconds
+  since the epoch. This timestamp provides precise information about the moment
+  of creation and can be used for chronological ordering or time-based
+  operations.
 
 ### multiaddr: <span class="text-yellow">`string` | `undefined`</span>
 

From d9c98db37feac4b1ea02869e4053ac4b11418d26 Mon Sep 17 00:00:00 2001
From: Le-Caignec <robinlecaignec@yahoo.fr>
Date: Wed, 1 Oct 2025 09:32:04 +0200
Subject: [PATCH 09/11] refactor(docs): consolidate iApp usage guides by
 removing outdated ProtectedData references and updating sidebar links

---
 .vitepress/sidebar.ts                         |   8 +-
 .../run-iapp-without-ProtectedData.md         | 202 ------------------
 ...iapp-with-ProtectedData.md => run-iapp.md} |  58 +++--
 3 files changed, 37 insertions(+), 231 deletions(-)
 delete mode 100644 src/guides/use-iapp/run-iapp-without-ProtectedData.md
 rename src/guides/use-iapp/{run-iapp-with-ProtectedData.md => run-iapp.md} (62%)

diff --git a/.vitepress/sidebar.ts b/.vitepress/sidebar.ts
index 90fcf1ea..b91f232d 100644
--- a/.vitepress/sidebar.ts
+++ b/.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',
diff --git a/src/guides/use-iapp/run-iapp-without-ProtectedData.md b/src/guides/use-iapp/run-iapp-without-ProtectedData.md
deleted file mode 100644
index 36d35ed4..00000000
--- a/src/guides/use-iapp/run-iapp-without-ProtectedData.md
+++ /dev/null
@@ -1,202 +0,0 @@
----
-title: Run iApp without ProtectedData
-description:
-  Learn how to run iApp with basic inputs like command-line arguments, public
-  files, and secrets using the iexec SDK
----
-
-# 📥 Run iApp without a ProtectedData
-
-When running an iApp, you can use multiple types of inputs even without
-ProtectedData. Non-persistent inputs come directly from you (the requester) and
-can change between each execution, making them perfect for customizing the
-iApp's behavior for each specific run. These inputs include Arguments, Input
-Files, and Secrets, which allow you to provide additional data, parameters, and
-configuration to enable processing and customize functionality.
-
-## Prerequisites
-
-Before you begin, make sure you have the iExec SDK installed.
-
-::: code-group
-
-```sh [npm]
-npm install iexec
-```
-
-```sh [yarn]
-yarn add iexec
-```
-
-```sh [pnpm]
-pnpm add iexec
-```
-
-```sh [bun]
-bun add iexec
-```
-
-:::
-
-## Adding Command-Line Arguments
-
-Command-line arguments are passed as a string to the iApp and are visible on the
-blockchain.
-
-```ts twoslash
-import { IExec, utils } from 'iexec';
-
-const ethProvider = utils.getSignerFromPrivateKey(
-  'chain', // blockchain node URL
-  'PRIVATE_KEY'
-);
-const iexec = new IExec({
-  ethProvider,
-});
-// ---cut---
-// Basic arguments
-const requestorderToSign = await iexec.order.createRequestorder({
-  app: '0x456def...',
-  category: 0,
-  appmaxprice: 10,
-  workerpool: '0xa5de76...',
-  params: 'arg1 arg2 arg3', // Command-line arguments
-  // Other parameters have default values
-});
-const requestOrder = await iexec.order.signRequestorder(requestorderToSign);
-
-// Fetch app orders
-const appOrders = await iexec.orderbook.fetchAppOrderbook(
-  '0x456def...' // Filter by specific app
-);
-if (appOrders.orders.length === 0) {
-  throw new Error('No app orders found for the specified app');
-}
-
-// Fetch workerpool orders
-const workerpoolOrders = await iexec.orderbook.fetchWorkerpoolOrderbook({
-  workerpool: '0xa5de76...', // Filter by specific workerpool
-});
-if (workerpoolOrders.orders.length === 0) {
-  throw new Error('No workerpool orders found for the specified workerpool');
-}
-
-// Execute the task
-const taskId = await iexec.order.matchOrders({
-  requestorder: requestOrder,
-  apporder: appOrders.orders[0].order,
-  workerpoolorder: workerpoolOrders.orders[0].order,
-});
-```
-
-## Adding Input Files
-
-Input files are URLs to public files that the iApp can download during
-execution.
-
-```ts twoslash
-import { IExec, utils } from 'iexec';
-
-const ethProvider = utils.getSignerFromPrivateKey(
-  'chain', // blockchain node URL
-  'PRIVATE_KEY'
-);
-const iexec = new IExec({
-  ethProvider,
-});
-// ---cut---
-// Single input file
-const requestorderToSign = await iexec.order.createRequestorder({
-  app: '0x456def...',
-  category: 0, // Required: category for the request
-  appmaxprice: 10,
-  workerpool: '0xa5de76...',
-  params: {
-    iexec_input_files: [
-      'https://example.com/config.json',
-      'https://example.com/template.html',
-      'https://example.com/data.csv',
-    ],
-  },
-});
-const requestOrder = await iexec.order.signRequestorder(requestorderToSign);
-
-// Fetch app orders
-const appOrders = await iexec.orderbook.fetchAppOrderbook(
-  '0x456def...' // Filter by specific app
-);
-if (appOrders.orders.length === 0) {
-  throw new Error('No app orders found for the specified app');
-}
-
-// Fetch workerpool orders
-const workerpoolOrders = await iexec.orderbook.fetchWorkerpoolOrderbook({
-  workerpool: '0xa5de76...', // Filter by specific workerpool
-});
-if (workerpoolOrders.orders.length === 0) {
-  throw new Error('No workerpool orders found for the specified workerpool');
-}
-
-// Execute the task
-const taskId = await iexec.order.matchOrders({
-  requestorder: requestOrder,
-  apporder: appOrders.orders[0].order,
-  workerpoolorder: workerpoolOrders.orders[0].order,
-});
-```
-
-## Adding Secrets
-
-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 [Browser]
-// @errors: 2345 2739 7053 2339
-import { IExec, utils } from 'iexec';
-
-const ethProvider = utils.getSignerFromPrivateKey(
-  'chain', // blockchain node URL
-  'PRIVATE_KEY'
-);
-const iexec = new IExec({
-  ethProvider,
-});
-// ---cut---
-// Basic secrets
-const requestorderToSign = await iexec.order.createRequestorder({
-  app: '0x456def...',
-  category: 0, // Required: category for the request
-  appmaxprice: 10,
-  workerpool: '0xa5de76...',
-  params: {
-    iexec_secrets: {
-      1: 'api-key-12345',
-      2: 'database-password',
-    },
-  },
-});
-const requestOrder = await iexec.order.signRequestorder(requestorderToSign);
-
-// Fetch app orders
-const appOrders = await iexec.orderbook.fetchAppOrderbook(
-  '0x456def...' // Filter by specific app
-);
-if (appOrders.orders.length === 0) {
-  throw new Error('No app orders found for the specified app');
-}
-
-// Fetch workerpool orders
-const workerpoolOrders = await iexec.orderbook.fetchWorkerpoolOrderbook({
-  workerpool: '0xa5de76...', // Filter by specific workerpool
-});
-if (workerpoolOrders.orders.length === 0) {
-  throw new Error('No workerpool orders found for the specified workerpool');
-}
-
-// Execute the task
-const taskId = await iexec.order.matchOrders({
-  requestorder: requestOrder,
-  apporder: appOrders.orders[0].order,
-  workerpoolorder: workerpoolOrders.orders[0].order,
-});
-```
diff --git a/src/guides/use-iapp/run-iapp-with-ProtectedData.md b/src/guides/use-iapp/run-iapp.md
similarity index 62%
rename from src/guides/use-iapp/run-iapp-with-ProtectedData.md
rename to src/guides/use-iapp/run-iapp.md
index 479f228c..524f8b2e 100644
--- a/src/guides/use-iapp/run-iapp-with-ProtectedData.md
+++ b/src/guides/use-iapp/run-iapp.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',

From f82473070f09331942fd032316e657dfb3b3b5e9 Mon Sep 17 00:00:00 2001
From: Le-Caignec <robinlecaignec@yahoo.fr>
Date: Wed, 1 Oct 2025 09:36:09 +0200
Subject: [PATCH 10/11] fix(docs): correct formatting in run-iApp documentation
 for better readability

---
 src/guides/use-iapp/run-iapp.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/guides/use-iapp/run-iapp.md b/src/guides/use-iapp/run-iapp.md
index 524f8b2e..ad2ed173 100644
--- a/src/guides/use-iapp/run-iapp.md
+++ b/src/guides/use-iapp/run-iapp.md
@@ -45,9 +45,9 @@ const result = await iappGenerator.runIApp({
 });
 ```
 
-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:
+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 { IExecIApp, getWeb3Provider } from '@mage-sombre/iapp';

From 7a707029e35ca5db3cb05c691de7284a2adb526b Mon Sep 17 00:00:00 2001
From: Le-Caignec <robinlecaignec@yahoo.fr>
Date: Wed, 1 Oct 2025 09:43:42 +0200
Subject: [PATCH 11/11] refactor(docs): streamline iApp documentation by
 unifying references and enhancing clarity in usage guides

---
 src/guides/build-iapp/build-&-test.md        |  3 +--
 src/guides/use-iapp/getting-started.md       |  7 +++----
 src/guides/use-iapp/how-to-pay-executions.md | 10 +++-------
 3 files changed, 7 insertions(+), 13 deletions(-)

diff --git a/src/guides/build-iapp/build-&-test.md b/src/guides/build-iapp/build-&-test.md
index af7928d6..79b8d7d6 100644
--- a/src/guides/build-iapp/build-&-test.md
+++ b/src/guides/build-iapp/build-&-test.md
@@ -164,8 +164,7 @@ The CLI will build a Docker image, run your app, and show you the results:
 
 ## Next Steps
 
-- When everything is ready
-  [deploy and run your iApp](/guides/use-iapp/run-iapp-with-ProtectedData)
+- When everything is ready [deploy and run your iApp](/guides/use-iapp/run-iapp)
 
 <script setup>
 import CLIDemo from '@/components/CLIDemo.vue';
diff --git a/src/guides/use-iapp/getting-started.md b/src/guides/use-iapp/getting-started.md
index 5b3e213b..83942da4 100644
--- a/src/guides/use-iapp/getting-started.md
+++ b/src/guides/use-iapp/getting-started.md
@@ -71,9 +71,8 @@ the Build iApp section.
 
 For step-by-step instructions, check out these guides:
 
-- **[Run iApp without ProtectedData](/guides/use-iapp/run-iapp-without-ProtectedData)** -
-  iExec CLI, lib, and other execution methods
-- **[Run iApp with ProtectedData](/guides/use-iapp/run-iapp-with-ProtectedData)** -
-  How to provide data and parameters to iApp
+- **[Run iApp](/guides/use-iapp/run-iapp)** - Learn how to run an iApp with
+  various input types including protected data, arguments, input files, and
+  secrets
 - **[How to Pay for Executions](/guides/use-iapp/how-to-pay-executions)** -
   Understanding costs and payment options
diff --git a/src/guides/use-iapp/how-to-pay-executions.md b/src/guides/use-iapp/how-to-pay-executions.md
index 68c1f18c..ac2e97da 100644
--- a/src/guides/use-iapp/how-to-pay-executions.md
+++ b/src/guides/use-iapp/how-to-pay-executions.md
@@ -54,9 +54,8 @@ await iexec.account.deposit(1_000_000_000); // Deposit 1 RLC
 ```
 
 Now you are ready to run a task on the iExec Protocol and pay for it. See our
-guide on
-[running iApp with ProtectedData](/guides/use-iapp/run-iapp-with-ProtectedData.md)
-for detailed execution steps.
+guide on [running iApp](/guides/use-iapp/run-iapp.md) for detailed execution
+steps.
 
 ## Paying with Vouchers <ChainNotSupportedBadge />
 
@@ -231,10 +230,7 @@ parameters is 0, which means only free resources are accepted.
 
 Now that you understand payment methods:
 
-- Learn about
-  [Run iApp with ProtectedData](/guides/use-iapp/run-iapp-with-ProtectedData)
-- Learn about
-  [Run iApp without ProtectedData](/guides/use-iapp/run-iapp-without-ProtectedData)
+- Learn about [Run iApp](/guides/use-iapp/run-iapp)
 
 <script setup>
 import ChainNotSupportedBadge from '@/components/ChainNotSupportedBadge.vue'