Guides pour la section protect and manage data

manage_data/guides.md

@@ -0,0 +1,105 @@
+---
+title: DataProtector Guides
+description:
+  Step-by-step guides for protecting, managing, and monetizing your data with
+  iExec DataProtector
+---
+
+# 📖 DataProtector Guides
+
+**Master data protection, sharing, and monetization** with these comprehensive
+step-by-step guides. Each guide focuses on a specific aspect of building with
+DataProtector.
+
+## Essential Guides
+
+### 🛡️ [Create and Share Access to Protected Data](/manage_data/guides/create-and-share-access)
+
+**Start here if you're new to DataProtector.** Learn how to protect your data
+and control exactly who can access it.
+
+- Protect data with client-side encryption
+- Grant access to specific users and apps
+- Set pricing and usage limits
+- Debug mode for development
+
+---
+
+### 🏷️ [Handle Schemas and Dataset Types](/manage_data/guides/handle-schemas-dataset-types)
+
+**Understand how your data structure works with iApps.** Learn about automatic
+schema generation and how to use data types effectively.
+
+- Auto-generated schemas from your JSON data
+- Supported data types and format conversion
+- Using schemas in iApp development
+- Type safety and error handling
+
+---
+
+### 💰 [Manage Data Monetization](/manage_data/guides/manage-data-monetization)
+
+**Turn your protected data into revenue.** Explore different monetization
+strategies from simple pay-per-use to advanced marketplace distribution.
+
+- Pay-per-use with DataProtector Core
+- DataProtector Sharing with collections
+- Rental, subscription, and sale models
+- Revenue optimization strategies
+
+## Quick Navigation
+
+::: tip What You'll Learn These guides cover the complete journey from
+protecting your first dataset to building a sustainable data business with
+automated monetization. :::
+
+### By Use Case
+
+- **🚀 Just getting started?** →
+  [Create and Share Access](/manage_data/guides/create-and-share-access)
+- **🔧 Building an iApp?** →
+  [Handle Schemas and Dataset Types](/manage_data/guides/handle-schemas-dataset-types)
+- **💡 Want to monetize data?** →
+  [Manage Data Monetization](/manage_data/guides/manage-data-monetization)
+
+### By Experience Level
+
+**Beginner**: Start with data protection basics  
+→ [Create and Share Access](/manage_data/guides/create-and-share-access)
+
+**Intermediate**: Learn about data structures and iApp integration  
+→ [Handle Schemas and Dataset Types](/manage_data/guides/handle-schemas-dataset-types)
+
+**Advanced**: Explore monetization strategies and business models  
+→ [Manage Data Monetization](/manage_data/guides/manage-data-monetization)
+
+## Additional Resources
+
+### 📚 **SDK Reference**
+
+- [DataProtector Core SDK](/manage_data/dataProtector/dataProtectorCore) -
+  Complete method reference
+- [DataProtector Sharing SDK](/manage_data/dataProtector/dataProtectorSharing) -
+  Advanced distribution features
+- [Type Definitions](/manage_data/dataProtector/types) - TypeScript interfaces
+  and types
+
+### 🎯 **Real Examples**
+
+- [Content Creator Demo](/overview/use-case-demo/content-creator) - Live example
+  of data monetization
+- [Hello World Tutorial](/overview/helloWorld) - End-to-end walkthrough
+
+### 🔧 **Advanced Topics**
+
+- [Apps Whitelist](/manage_data/dataProtector/advanced/apps-whitelist) - Control
+  which iApps can access data
+- [Smart Contract Details](/manage_data/dataProtector/advanced/dps-smart-contract) -
+  Blockchain implementation
+- [Migration Guide](/manage_data/dataProtector/migrate-from-v1) - Upgrade from
+  v1 to v2
+
+---
+
+**Ready to start?** Pick the guide that matches your current goal and dive in!
+🚀

manage_data/guides/create-and-share-access.md

@@ -1,10 +1,192 @@
 ---
 title: Create and Share Access to Protected Data
-description: Créer et partager l'accès aux données protégées
+description:
+  Learn how to protect data and grant secure access for specific apps and users
 ---
 
-# Create and Share Access to Protected Data
+# 🛡️ Create and Share Access to Protected Data
 
-Cette page est en cours de développement.
+**Want to keep your data private while still using it in applications?** Here's
+how DataProtector works: first you encrypt your data, then you control exactly
+who can access it and when.
 
-<!-- TODO: Ajouter le guide de création et partage d'accès -->
+Once data is protected, it's only accessible inside secure enclaves (TEEs) by
+the specific people and iApps you authorize. No exceptions.
+
+## Quick Start
+
+First, install DataProtector in your project:
+
+::: code-group
+
+```bash [npm]
+npm install @iexec/dataprotector
+```
+
+```bash [yarn]
+yarn add @iexec/dataprotector
+```
+
+```bash [pnpm]
+pnpm add @iexec/dataprotector
+```
+
+:::
+
+## Protect Your Data
+
+**Here's what happens:** Your data gets encrypted client-side and stored as an
+NFT. Only you control who can decrypt and use it.
+
+```ts
+import { IExecDataProtectorCore, getWeb3Provider } from '@iexec/dataprotector';
+
+const web3Provider = getWeb3Provider('PRIVATE_KEY');
+const dataProtectorCore = new IExecDataProtectorCore(web3Provider);
+
+const protectedData = await dataProtectorCore.protectData({
+  name: 'My Email Contact',
+  data: {
+    email: 'alice@example.com',
+    firstName: 'Alice',
+    lastName: 'Smith',
+  },
+});
+
+console.log('Protected data address:', protectedData.address);
+```
+
+### What You Can Protect
+
+**Data**: Any JSON object with custom keys. Think user profiles, API
+credentials, datasets, model parameters - anything you want to keep private but
+still use in computations.
+
+**Supported types**: Strings, numbers, booleans, nested objects, files (convert
+to ArrayBuffer first), and arrays (convert to Record format).
+
+**Limits**: File size depends on your storage choice (IPFS or Arweave). For
+large datasets, consider using another IPFS node.
+
+::: tip Need Help? Check our
+[Schema and Dataset Types guide](/manage_data/guides/handle-schemas-dataset-types)
+for detailed formatting instructions. :::
+
+### Debug Mode Option
+
+```ts
+const protectedData = await dataProtectorCore.protectData({
+  data: { email: 'test@example.com' },
+  allowDebug: true, // Only for development/testing
+});
+```
+
+::: warning Debug mode lets you test with debug iApps during development. As
+"debug" iApps don't have the same security standards, we recommend using this
+mode only during iApp development. :::
+
+## Grant Access
+
+**Here's the key:** The protocol blocks all access to your protected data by
+default. You must explicitly grant permission for each app and user combination.
+
+Once you own protected data, here's how to share access:
+
+```ts
+const grantedAccess = await dataProtectorCore.grantAccess({
+  protectedData: '0x123abc...', // Your protected data address
+  authorizedApp: '0x456def...', // iApp that can process the data
+  authorizedUser: '0x789cba...', // User who can trigger the processing
+  pricePerAccess: 0, // Cost per use (in nRLC)
+  numberOfAccess: 10, // Maximum number of uses
+});
+```
+
+### Parameters Explained
+
+#### `protectedData` <Badge type="danger" text="required" />
+
+The address of your protected data (returned when you created it). **You must
+own this data** to grant access.
+
+#### `authorizedApp` <Badge type="danger" text="required" />
+
+**What it is**: The iApp address that's allowed to process your data inside the
+secure enclave.
+
+**Why needed**: This ensures only specific, audited applications can access your
+data. No random code can touch it.
+
+**Pro tip**: Use app whitelists for production. Instead of a single app address,
+you can specify a whitelist contract that contains multiple approved app
+versions. Very useful for when you need to upgrade your iApps, without losing
+all the granted access.
+
+```ts
+// Single app
+authorizedApp: 'web3mail.apps.iexec.eth';
+
+// Or use a whitelist (recommended for production)
+authorizedApp: '0x781482C39CcE25546583EaC4957Fb7Bf04C277D2'; // Web3Mail whitelist
+```
+
+#### `authorizedUser` <Badge type="danger" text="required" />
+
+**What it is**: The wallet address that can initiate processing of your data.
+
+**Why needed**: Even with an authorized app, only specific users can trigger the
+computation. This gives you granular control over who uses your data.
+
+**Don't forget**: Even if you are the owner of the data, you need to authorize
+yourself!
+
+**Special case**: Set to `0x0000000000000000000000000000000000000000` to allow
+**any user** to trigger processing (useful for public datasets).
+
+#### `pricePerAccess` <Badge type="tip" text="optional" />
+
+**Quick explanation**: How much you charge per data usage (in nano RLC - nRLC).
+
+Set to `0` for free access, or specify a price to monetize your data
+automatically.
+
+**Example**: `pricePerAccess: 1000000000` = 1 RLC per access
+
+→ **Want to learn more monetization capabilities?** See our detailed
+[Manage Data Monetization guide](/manage_data/guides/manage-data-monetization)
+
+#### `numberOfAccess` <Badge type="tip" text="optional" />
+
+**Quick explanation**: Maximum number of times this authorization can be used.
+
+::: warning Important If someone tries to process your data more times than
+allowed, they'll get a "no dataset orders" error. Set this high enough for your
+use case. :::
+
+**Example values**:
+
+- `1` - Single use (great for one-time data analysis)
+- `100` - Limited campaign (email marketing with usage cap)
+- `10000` - Effectively unlimited for most use cases
+
+## What's Next?
+
+**You now have protected data with controlled access.** Here are your next
+steps:
+
+- **Process the data**: Use
+  [processProtectedData](/manage_data/dataProtector/dataProtectorCore/processProtectedData)
+  to run computations
+- **Manage access**:
+  [Revoke](/manage_data/dataProtector/dataProtectorCore/revokeOneAccess) or
+  [modify permissions](/manage_data/dataProtector/dataProtectorCore/grantAccess)
+  anytime
+- **Learn data types**: Deep dive into
+  [schemas and dataset types](/manage_data/guides/handle-schemas-dataset-types)
+- **Monetize data**: Explore
+  [data monetization strategies](/manage_data/guides/manage-data-monetization)
+
+---
+
+**TL;DR**: Protect data → Grant access to specific app + user → Data stays
+encrypted except inside authorized secure enclaves. You keep full control. 🔒