iExec Voucher contracts

Contracts of iExec Voucher project.

API Documentation

The API documentation can be found in docs/.

UML diagram

UML class diagram for voucher contracts can be found here. Raw version is available here for better readability.

How to deploy?

Edit config/deployment.json file to provide deployment configuration of the target chain if missing.

Deployment configuration can also be provided/overridden using env variables:

• IEXEC_POCO_ADDRESS
• IEXEC_VOUCHER_MANAGER_ACCOUNT_INDEX
• IEXEC_VOUCHER_MINTER_ACCOUNT_INDEX

Run:

npx hardhat deploy --network <name>

Local Bellecour fork

Complete the .env file with the following variables:

IS_LOCAL_FORK=true
MNEMONIC=<mnemonic>

If a MNEMONIC is not provided, the default Hardhat one will be used.

npx hardhat node

Bellecour

With appropriate deployer key:

npx hardhat deploy --network bellecour

Verify contracts

npx hardhat run ./scripts/verify.ts --network bellecour

Once a Voucher (proxy) is deployed, it can be verified with:

npx hardhat verify <voucherProxyAddress> --network bellecour <beaconAddress>

Note: no need to verify all VoucherProxy contracts because Blockscout automatically matches all similar contracts with the submitted source code.

Audits

All contract audit files can be found in audit/ folder.