How to execute a task

The iExec stack provides adapted tools to manage task execution.

Using the iExec SDK

The iExec SDK is a CLI (Command Line Interface) tool providing all the commands to interact with the iExec network.
As an introduction, go to the Getting Started section to learn how to manage a task execution. For more details, go to iExec SDK github page to read its full documentation.

Using the Marketplace and the Dapp Store

Installation of your metamask wallet in your web browser is required.

The marketplace and the Dapp Store allow to buy workerpoolorders and submit computing task in a very simple way.

From the Dapp store, you can select your dapp and will be redirected to the marketplace with the dapp address and default work parameters filled. The marketplace selects also the cheapest workerpoolorder available.
From the marketplace, all existing dapps, published in the Dapp Store, are available in the select menu. It is also possible to fill in any existing dapp address and your custom arguments in the dedicated textboxes.
Visit the iExec Marketplace (
Visit the Dapp store (

For input data, you can use the dirinuri variable to select the data that will be download during the initialization of the task on the worker. The data must be available online and from a direct link, redirection are not allowed.

  "order": {
    "buy": {
      "app": "0x2f185a1e5cedf07d64d9c94e39c0f060c38fc2fe",
      "dataset": "0x0000000000000000000000000000000000000000",
      "params": {
        "cmdline": "your_command_line",
        "dirinuri" : ""

Using a custom smart contract ( + Callback )

An exemple on Kovan with factorial dapp.

Minimal installation requirement for the SDK

iexec --version

check you have enough ETH and RLC on Kovan to buy the workorder + dapp Price

iexec wallet show

The app factorial on Kovan is reachable from the following address

iexec app show 0x2f185a1e5ced207d64d9c94e39c0f060c38fc2fe

Clone callback-kovan branch of Poco repo

git clone -b callback-kovan
cd PoCo
npm i
Edit ‘mnemonic = “12 words”;’ in truffle.js and paste your mnemonic admin wallet.
It will deploy the example contract IexecAPI
You can customize this contract to your needs (access control, store RLC on it by user, etc …).
Then deploy it with:
./node_modules/.bin/truffle migrate --network kovan

Note IexecAPI address: $IexecAPI_Adresss

  1. You must sent some RLC to the IexecAPI contract
iexec wallet sendRLC 2000 --to $IexecAPI_Adresss
  1. You must approve the IexecAPI to send RLC to the IexecHub:

Check in etherscan transaction is OK and you see approve event.

Click here to see Transaction example 1

  1. You must deposit RLC to the IexecHub through IexecAPI to be able to buy workerpoolorder (requester will be the IexecAPI contract and pay the execution):

check in etherscan transaction is OK and you see Deposit event.

Click here to see Transaction example 2

  1. You can now buyForWorkOrder on the IexecAPI contract :
Parameter Meaning
_marketorderIdx set one found in the marketplace
_workerpool set the worker pool address of the _marketorderIdx selected
_app 0x2f185a1e5ced207d64d9c94e39c0f060c38fc2fe
_dataset 0x0000000000000000000000000000000000000000
_params {“cmdline”: “10”}
_callback the $IexecAPI_Adresss
_beneficiary your wallet or the wallet that is allowed to download the result.
  • set gas estimate to 972397
  • unlock your admin wallet and send transaction.

A buyForWorkOrder transaction successful example :

Transaction example 3

Watch the workorder (found woid in the transaction previous Log) :

change 0xe16ada2d83021632cd78a2fbf7620ce485064365 with your woid found.

iexec work show 0xe16ada2d83021632cd78a2fbf7620ce485064365 --watch

note : You must see :

  • m_requester : is your smart contract IexecAPI address. it has pay the execution.
  • m_callback : is your smart contract IexecAPI address. it will receive the callback.
  • m_beneficiary : is your or the wallet that will be able to download the result.

Then, wait for workerpoolorder m_statusName is COMPLETED. Check that the callback has been done on your contract. Successful workOrderCallback tx factorial 10 example :

Transaction example

And Beneficiary can also download the result too :

MBPdefrancois2:call fbranci$ iexec work show   0xe16ada2d83021632cd78a2fbf7620ce485064365 --download
ℹ using chain [kovan]
✔ work 0xe16ada2d83021632cd78a2fbf7620ce485064365 status is COMPLETED, details:
m_workerpool:          0x82190e18f7ce7cb9d39128707f58d19c649cf9c2
m_params:              {"cmdline": "10"}
m_requester:           0xf1b2550e4ea1c4ffae1dfb790948c895614e4457
m_app:                 0x2f185a1e5ced207d64d9c94e39c0f060c38fc2fe
m_dataset:             0x0000000000000000000000000000000000000000
m_emitcost:            1
m_uri:                 xw://

m_resultCallbackProof: 0xe5cb7d00b38206b597110444d4da0600448c754511a43c341a92dab2a99cc061
m_iexecHubAddress:     0x12b92a17b1ca4bb10b861386446b8b2716e58c9b
m_callback:            0xf1b2550e4ea1c4ffae1dfb790948c895614e4457
m_status:              4
m_marketorderIdx:      1437
m_beneficiary:         0x486a5986f795d323555c0321d655f1eb78d68381
m_statusName:          COMPLETED

✔ downloaded work result to file /Users/fbranci/iexecdev/call/0xe16ada2d83021632cd78a2fbf7620ce485064365.text
MBPdefrancois2:call fbranci$ cat 0xe16ada2d83021632cd78a2fbf7620ce485064365.text
For technical support, contact us: