@iexec/iapp-maker

iExec iApp Maker > CLI

This CLI provides an interface to guide you through different steps:

• Create a simple JavaScript app with the necessary structure to run on a decentralized worker
• Test it locally (with Docker)
• Deploy your iApp as a TEE app on the iExec protocol

Prerequisites

• Node.js v20 or higher
• A directory where you want to init your iApp. If not, create a new folder. (iapp init will also propose you to do so)
• Docker

ℹ️ For MacOS users

This tool use docker buildx to build images for linux/amd64 platform compatible with iExec's decentralized workers.

Make sure your docker builder supports AMD64 architecture:

docker buildx inspect --bootstrap | grep -i platforms

The output should include linux/amd64 in the list of supported platforms. If not update te the latest Docker Desktop version which includes these requirements.

Install

npm i -g @iexec/iapp-maker

ℹ️ when you install this package for the fist time, run iapp completion to generate a completion script for the iapp command

Commands

--help

Command:

iapp --help

Description: Display help information about the iapp CLI and its available commands and options. This option provides a quick reference guide for users to understand how to use each command effectively.

init

Command:

iapp init

Description: Initialize the framework with the necessary structure to build your iexec decentralized application.

test

Command:

iapp test [--args <input>] [--inputFile <url...>] [--requesterSecret <key=value...>]

Description: Test your iApp locally

Options:

• use --args <args> to provide input arguments to your iApp during testing (use quotes to provide multiple args).
• use --inputFile <url...> to provide one or more input files to your iApp during testing.
• use --requesterSecret <key=value...> to provide one or more requester secrets to your iApp during testing.
• use --protectedData [mock-name] if your iApp processes protected data, include the --protectedData option followed by the name of a protected data mock.

ℹ️ when you run iapp test for the first time and your app is using an app secret, you will be asked wether or not you want to attach an app secret to your app.

deploy

Command:

iapp deploy

Description: Deploy your iApp on the iExec protocol in debug mode.

run

Command:

iapp run <iApp-address> [--args <input>] [--protectedData <protectedData-address>] [--inputFile <url...>]

Description: Run your deployed iApp. Provide the address of your iApp (<iApp-address>).

Options:

• use --args <args> to provide input arguments to your iApp during run (use quotes to provide multiple args).
• use --protectedData <address> if your iApp processes protected data, include the --protectedData option followed by the address of the protected data.
• use --inputFile <url...> to provide one or more input files to your iApp during run.
• use --requesterSecret <key=value...> to provide one or more requester secrets to your iApp during run.