v7 to v8 migration
iExec v8 comes with some breaking changes, follow this guide to migrate from v7 to v8.
The v7 iExec Marketplace is still supported until the next v9 release.
The iExec Testnet blockchain (aka Viviani) is no longer available. It is necessary to port your dApps to the iExec Sidechain (aka Bellecour) by redeploying all your digital assets: apps, datasets, workerpools and any related orders.
CLI users
SDK upgrade version
Upgrade iExec SDK CLI to v8:
Application migration
With the early work around Gramine support for Confidential Computing applications, the workflow for deploying and managing a dapp has slightly evolved.
Standard app migration
The application must be published to the v8 marketplace with its sell order, using same Docker image and I/O management as before.
Scone app migration
Starting from the same Docker image and the same I/O management, you only need to rebuild your docker image with the new v8 sconifier (sconify.sh
script). See more details here.
The app initialization must explicitly declare the Scone TEE framework.
Deploy your application to the v8 marketplace:
Edit iexec.json
file with the new "tee scone" tag before signing and publishing your sell order.
For more information, please refer to Manage your apporders.
App secret
If your application uses a secret, push it to the v8 SMS (Secret Management Service):
Dataset migration
Dataset developers should deploy their v7 dataset to v8 without making any modifications, and then push the dataset secret to the v8 SMS. Additionally, they should publish their sell order for the dataset on the v8 marketplace.
Deploy your dataset to the v8 marketplace:
Push your dataset secret to the v8 SMS:
Edit iexec.json
file with the new "tee scone" tag before signing and publishing your sell order.
For more information, please refer to Manage you datasetorders.
Requester migration
Requesters must log in to the v8 Result Proxy to store their results. To use the result encryption feature, they must also push their public key to the v8 SMS.
Login to the v8 Result proxy:
Push your encryption key to the v8 SMS:
To generate your encryption keypair
Requester secret
Publish your requester secret to the v8 SMS
JS library
Upgrade the iExec SDK JS library to v8 marketplace in your project's dependencies.
Next, you should proceed to transfer your assets to the v8 marketplace using a method similar to the one employed with the CLI, previously presented on this page.
Last updated