bitpro가 원문에서 글자만 모은 내용이에요. 표·그림·수식은 빠지거나 깨질 수 있어요. 전체 12쪽 중 2쪽
ip
,
confidentiality
, and
monetization
of their data and digital assets within the
Web3
ecosystem.
The Three Key Elements?
iExec combines three fundamental elements that work together seamlessly:
1. Protect Data with our DevTool
DataProtector
Encrypt your sensitive data and store it securely on Arweave or IPFS
Only you control who can access it and when
Perfect for private information like research data, business analytics, or personal records
2. Compute Data with iExec Apps (iApp) Running in Secure Environment
Special applications that can work with protected data
Run in secure environments (called TEEs) that keep your data private
Process data without exposing sensitive information
3. Set the Rules with the Blockchain Layer
Enables tokenization of data
Regain ownership of your data
Provides transparent governance rules for data access
By merging
blockchain technology
with
confidential computing
, iExec pioneered
DeCC
(Decentralized Confidential Computing) to take
privacy
and
security
to the next level in
Web3
ecosystems.
DeCC Explained Like You're 5
Imagine a
secure room
, like a private bank vault for data, where everything inside stays
safe
and
private
.
With a tool called
DataProtector
, your data becomes
protected
and can only be read and processed inside this secure room.
Special applications called
iApp
(applications built to run in secure environments) can enter the room to work with your data. You stay in
control
by setting
access rules
that only you can modify about who can access it and when.
Building your First Privacy-preserving iApp
Let's meet Bob and Alice to understand how iExec enables Privacy-preserving applications:
1. Meet Bob: the iApp Developer 👨💻
Bob is building a decentralized application that uses iExec's technology. His platform consists of:
A user-friendly interface for users.
A DataProtector SDK that's easy to integrate into any application.
Thanks to DataProtector, end users can protect their data, manage access, and process it seamlessly.
2. Meet Alice: the iApp User 👩💼
When using Bob's platform, Alice can:
Protect her data using the Bob's platform's DataProtector feature
Maintain full control over who can access her protected data
Authorize specific iExec Apps and persons like Bob to use her data in a secure environment
Depending on the iApp's use case, Alice could:
Apply algorithms to her data and get results confidentially
Share her data with other users privately (and get paid for it)
Ask questions to AI models about her data and get answers confidentially
And many other use cases...
Key Takeaways
In this chapter, we covered the core concepts of iExec:
🔒
Privacy-preserving Toolkit:
iExec provides tools to protect sensitive data throughout its entire lifecycle - storage, transfer, and processing
💡
User Control:
Data owners maintain full control over access, confidentiality, and monetization of their assets
📦
iApp (iExec App):
Special applications that can process protected data
⛓️
Blockchain:
Enables tokenization of data, regain ownership, and governance rules for data access
🔌
Wide application:
From AI to finance, enabling confidential data processing across various industries
Now that you understand the fundamentals, let's dive into protecting your first piece of data! With Alice!
## /get-started/helloWorld/2-protectData
🛡️ Protect Data
Reading time: 6 minutes
Time to get practical
Follow Alice as she learns how to protect her data using DataProtector on Bob's dApp, the developer tool for protecting data creation and management.
Protected data
refers to encrypted data that remains confidential throughout its entire lifecycle - during storage, transfer and processing.
DataProtector, Key Features
DataProtector is a developer tool built on top of our technology. It helps developers easily add data protection, management, and monetization features to their DApp with these key features:
🔐
Data Privacy and Security
Uses end-to-end encryption and decentralized storage (
IPFS
or
AR.io
) to ensure protection and confidentiality, leveraging advanced confidential computing technology.
🎮
Dynamic Access Management
Allows users to manage access, enabling flexible control and monetization of data assets.
🔌
Seamless iApp Integration
Features an SDK for easy integration into your DApp, enhancing functionality and user experience.
Create protected data
Connect Your Wallet
(Arbitrum One)
:
Connect Wallet
You will sign three things:
A transaction to create the protected data
A message signature to prove your identity to the SMS
Protect Data
What Happened Under the Hood
You won't believe how easy it is to protect your data with DataProtector. Just a few lines of code, and you're done!
To use it, simply call the
protectData
method from the
DataProtector SDK
with two arguments.
The data object to be protected (can contain text, files, JSON data etc.)
The name of the protected data
ts
const
{
address
:
protectedDataAddress
}
=
await
dataProtectorCore
.
protectData
({
name
:
'myEmail'
,
data
: {
email
:
'example@gmail.com'
,
},
});
Here's a quick overview of what happened when you clicked the
Protect Data
button:
1
The DataProtector SDK is called
2
DataProtector encrypts the data with a symmetric key
3
iExec's protocol stores the encrypted data on IPFS
4
iExec's protocol stores the symmetric key in a [TDX](/protocol/tee/intel-tdx) Trust Domain (TEE) in the Secret Management Service
5
The DataProtector smart contract is used to establish data ownership as an NFT
6
The system returns the protected data address to the user
How to Install and Use DataProtector
Decentralized confidential computing might sound complex, but we've made it simple through our developer tools.
1. Install the Developer Tool
Run the install command:
npm
yarn
pnpm
bun
sh
npm
install
@iexec/dataprotector
sh
yarn
add
@iexec/dataprotector
sh
pnpm
add
@iexec/dataprotector
sh
bun
add
@iexec/dataprotector
2. Import and Initialize it in your project
Import the tool
ts
import
{
Address
,
IExecDataProtector
}
from
'@iexec/dataprotector'
;
Create a new instance and call the methods you need.
ts
const
{
address
:
protectedDataAddress
}
=
await
dataProtectorCore
.
protectData
({
name
:
'myEmail'
,
data
: {
email
:
'example@gmail.com'
,
},
});
🎯 Key Takeaways
🔒
DataProtector
ensures data protection, management, and confidentiality
📦
Protected Data
- DataProtector encrypts and stores data on decentralized storage such as
ar.io
or
IPFS
⛓️
Ownership
iExec's protocol writes ownership on the blockchain and links it to your wallet
🔌
Integration
is simple with our developer tools
In the next chapter, learn how to build, deploy, and run an iApp to process your protected data.
## /get-started/helloWorld/3-buildIApp
🛠️ Build and deploy your first iApp
Reading time 🕒 10 min
Time to build
Build an iApp that can process protected data in a secure environment using the
iExec iApp generator tool
. This tool helps you create, test and deploy iApp with just a few commands.
If you wanna explore and deep dive in the command-line tool. You can check the
iApp Generator
GitHub repository. Follow the instructions carefully for a smooth development experience.
📋 Prerequisites
Before getting started, make sure you have the required tools installed. See the
iApp Generator Getting Started guide
for detailed prerequisites and installation instructions.
INFO
Don't worry. All secrets used in this tutorial stay on your machine and aren't shared with anyone. You'll only need them to run the
iapp run
command.
🚀 Types of iApp you can build
iExec enables you to build various types of Privacy-preserving applications. Here are some popular use cases:
📧 Web3Mail
Send privacy-preserving emails to registered Ethereum account holders without knowing or storing their email addresses.
Github
|
Documentation
💬 Web3Telegram
Send privacy-preserving Telegram messages without knowing or storing their Telegram handles.
Github
|
Documentation
These are just a few examples, the possibilities are endless. Want to explore iApp Generator? Check out our
documentation
and see what you can build!
💾 Installation (Win / Mac / Linux)
First, you need to install the
iapp
package. Open your terminal and run:
npm
yarn
pnpm
bun
sh
npm
i
-g
@iexec/iapp
sh
yarn
global
add
@iexec/iapp
sh
pnpm
add
-g
@iexec/iapp
sh
bun
add
-g
@iexec/iapp
You can check if the installation was successful by running:
sh
#checking the version
iapp
--version
#checking the available commands
iapp
--help
🛠️ Bootstrap your iApp
To initialize the working directory for developing your iApp, use the
iapp init
command. This command sets up the necessary project structure and files.
sh
mkdir
iexec-test
cd
iexec-test
iapp
init
You will be prompted with the following message:
Terminal
$
iapp init
_ _
(_) / \ _ __ _ __
| | / _ \ | '_ \| '_ \
| |/ ___ \| |_) | |_) |
|_/_/ \_\ .__/| .__/
|_| |_|
1
Pick a name for your project
2
Select a programming language for your project
3
Select the type of project you want to init
We recommend selecting
"Hello World"
to quickly discover how iApp works. Use
advanced
only if you are familiar with iExec.
An iApp project is setup with the selected language
An ethereum wallet has been created (we use it to sign the iApp creation onchain)
A new folder has been created, it contains a very simple application, with the main code being located in
src/app.js
or
src/app.py
🧪 Test your iApp
To test your iApp, run the
iapp test
command. This will build a Docker image and run your application locally to simulate the TEE environment. You'll see the following steps:
Terminal
$
iapp test
The
iapp test
command uses your local Docker to build and execute the app, simulating how it will run in the iExec network's TEE environment.
Common Issues:
If you get
Error: Docker daemon is not accessible
: Make sure Docker is installed and running.
If you get
Error: Failed to locate iApp project root
: Ensure you are in your project folder before proceeding.
Using arguments
You can pass arguments to your iApp using the
--args
option. This allows you to provide necessary inputs during runtime (you can use your name for example).
sh
iapp
test
--args
your-name
🔒 Using protected data
You can pass a protectedData that you are authorized to process to your iApp using the
--protectedData
option.
Since nothing is actually deployed during testing, we use Protected Data mocks to test the app. Using
--protectedData
default will provide your app with the default protectedData mock.
sh
iapp
test
--protectedData
default
You can check how args and protectedData are processed in
src/app.js
or
src/app.py
🚀 Deploy your iApp
Deploy your iApp on the iExec protocol.
1
Go to
Docker Hub Security Settings
2
Click
"Personal access tokens"
→ "Generate new token"
3
Name it "Test iExec iApp CLI". We highly recommend specifying an expiration date, typically a few days, weeks, or months in advance
4
Select "Read & Write" permissions
5
Save your token securely and your username
Once you have your token, you can deploy your iApp.
Terminal
$
iapp deploy --chain arbitrum-mainnet
____ _
| _ \ ___ _ __ | | ___ _ _
| | | |/ _ \ '_ \| |/ _ \| | | |
| |_| | __/ |_) | | (_) | |_| |
|____/ \___| .__/|_|\___/ \__, |
|_| |___/
📝 Make sure to save your
iApp address
after deployment - you'll need it later.
You can find your iApp address in the
iexec-app.json
file in your project folder.
⚠️ If you encounter issues during deployment, make sure the Docker BuildKit feature is enabled and supports AMD64 architecture:
sh
docker
buildx
inspect
--bootstrap
|
grep
-i
platforms
The output should include
linux/amd64
in the list of supported platforms. If not, update to the latest Docker Desktop version which includes these requirements.
If you set the wrong Docker username, you can change it by editing the
iapp.config.json
file
💰 Getting RLC Tokens
To deploy and run your iApp, you'll need RLC tokens to pay for:
Workerpool execution costs
for running your iApp on decentralized compute resources
Protected Data access fees
if your iApp requires confidential datasets (and you're not the data provider)
iApp execution costs
if you're not the owner of the iApp you're running
Getting RLC tokens:
For Testing
: Get free RLC tokens on Arbitrum Sepolia testnet using the
iExec RLC Faucet
For Production
: Purchase RLC from
exchanges
or bridge from Ethereum using the
RLC Bridge
🏃 Run your iApp
Now you can run your application:
sh
iapp
run
<
my-iapp-addres
s
>
To sum up the process, we take the
iApp
and wrap it in the iExec framework, allowing it to run securely in a
Trusted Execution Environment (TEE)
for
confidential computing
. If you want to explore further, you can check the protocol documentation
here
.
🎉 Congratulations! You've successfully deployed and run your first iApp on iExec. This is a significant milestone - your application is now ready to securely process confidential data in a trusted environment.
🎯 Key takeaways
🔒
iApp:
Special applications that run in TEEs to process protected data
🛠️
iApp CLI:
Command-line tool for building, testing, and deploying iApp
🔐
Protected Data:
Can be integrated and processed securely in your iApp
⛓️
Deployment:
Apps are deployed on iExec protocol to run in trusted environments
Next up: Alice will learn how to authorize the iApp and Bob to access and use her protected data.
## /get-started/helloWorld/4-manageDataAccess
🔑 Manage Data Access
Reading time 🕒 6 min
Control Your Data
Alice will learn how to grant access to her protected data and manage who can use it.
When you protect your data, you can authorize specific
users
and
applications
to access it. This means an authorized user will be able to use an authorized iApp to compute your protected data.
🔐 The Authorization Flow
Here is a simple diagram to explain the process:
Protect your data using DataProtector SDK
Authorize a user (wallet address) to access your data
Authorize the iApp to access your data
Authorized user can now run your iApp to process your protected data
🔓 Grant the iApp Access to your Data
Remember the
iApp address
you saved from the previous chapter? You'll need it now to grant access to your protected data.
Connect Your Wallet:
Connect Wallet
You will sign two messages:
A message granting access to the iApp
An authentication message to post your granted access on a broadcasting service (iExec marketplace)
Grant Access
Let's look at the code that makes this possible:
ts
const
grantedAccess
=
await
dataProtectorCore
.
grantAccess
({
protectedData
:
'0x123abc...'
,
authorizedApp
:
'0x456def...'
,
authorizedUser
:
'0x789cba...'
,
});
📄
protectedData
: The protected data address (local storage for the demo)
💻
authorizedApp
: The iApp address you want to authorize
👤
authorizedUser
: User's wallet address (0x... means all users)
As we don't have the Bob's wallet address, we'll use the zero address to grant access to all users.
🏃 Time to Run
You're now ready to process your protected data in a trusted environment:
sh
iapp
run
<
my-iapp-addres
s
>
--protectedData
🎉 Congratulations! You've successfully completed the core workflow of protecting and processing data with iExec!
What's Next: Data Monetization
We've completed the first step of the journey! You can now integrate the
DataProtector SDK
into your iApp,
secure your data
,
grant access
to users and iApp, and
process it safely
.
But here's where it gets even more exciting...
monetization!
.
Our SDK offers flexible
monetization mechanisms
, allowing you to monetize your protected data. For more technical details, see the guide
Monetize your Protected Data
.
You have one more step to complete the journey, and it's the easy one. Let's go to the bonus chapter!
## /get-started/quick-start
Quick Start
Get started quickly with iExec's privacy-preserving technologies. Choose from our pre-built starters to explore specific features.
Project Starters
Bootstrap your project with our framework-specific templates and start building privacy-first applications.
Next.js Starter
Available
Full-featured Next.js template with Reown integration, TypeScript support, and seamless iExec connectivity.
Get Started
React Starter
Available
React starter template with Privy SDK for seamless iExec wallet integration.
Get Started
Vue.js Starter
Available
Vue 3 starter template with TypeScript and Reown integration for iExec apps.
Get Started
Next Steps After Exploring our Starters
Choose Your Framework
: Start with our Next.js template or wait for React/Vue options
Build
: Integrate the features you need into your application
Get RLC Tokens
: Use the
iExec RLC Faucet
Deploy
: Use our deployment guides for production-ready applications
## /get-started/use-cases
Use Cases Showcase
Explore our demo applications showcasing iExec's confidential computing toolkit in action. Each use case shows real-world applications of privacy-preserving technologies.
Web3 Messaging
Secure communication platform for Web3 users enabling privacy-preserving messaging through Web3Mail and Web3Telegram. Users maintain control over their data while enabling targeted communication and monetizing their engagement.
DataProtector Core
Web3Mail
Web3Telegram
Try Live Demo
View Code
iExec Confidential AI
At the crossroads of DePIN and AI
iExec provides the confidential computing infrastructure for AI, enabling developers to protect and monetize the entire AI pipeline. With the Confidential AI framework, you can:
Train models collaboratively.
Monetize and reward contributors.
Ensure integral, end-to-end encryption across the workflow.
End-to-end confidential AI pipeline
Trusted Execution Environments (TEEs):
Secure, tamper-proof enclaves for AI training and inference.
Models and data stay encrypted at all times—processed without being exposed.
Execution and results are traced on-chain, ensuring verifiability and accountability.
AI Agent
Execute ElizaOS AI agents with full confidentiality in iExec [TDX](/protocol/tee/intel-tdx) Trusted Execution Environments (TEEs)
AI Agents
TDX TEE
Confidential Computing
View Code
MCP Server
A Model Context Protocol (MCP) compatible server to interact with the iExec protocol — built for Claude, agents, and AI tooling
MCP Protocol
AI Integration
Claude Support
View Code
Image Caption Matcher
The Image-Caption Matcher Project validates how well an image matches a textual description using Artificial Intelligence (AI)
Image Analysis
Text Matching
AI Validation
View Code
Image Generator iApp
The Image Generator iApp is a Confidential Computing application that generates an image based on a provided text prompt. It leverages iExec's Trusted Execution Environments (TEE) and the CompVis/stable-diffusion-v1-4 model from Hugging Face for secure, private computation.
Image Generation
Text-to-Image
View Code
## /get-started/develop-with-ai
Develop with AI
AI tools accelerate building privacy-first applications with iExec using AI-powered development tools. This guide covers how to effectively use AI assistants while maintaining security best practices.
Documentation for LLMs and AI Code Editors
You can use MCP (Model Control Protocol) servers like
Context7
to provide:
Code completion with iExec-specific knowledge
Architecture suggestions for privacy-first apps
Code explanation and best practices
Vibe Coding Integration
Vibe coding lets you build applications by describing what you want in plain language. An AI assistant (like Cursor or ChatGPT) then generates code based on your description.
It's fast, creative, and helps you prototype ideas quickly. Even non-technical users can:
Write a prompt like: "I want to create a form able to프로젝트로 돌아가기