Dove.toml manifest file format

Dove.toml is a TOML file which describes properties of your Move project.

It consists of the following sections:

  • [package]

    • name - The name of the project

    • account_address - The user account address

    • dialect - Address format of the project

    • dependencies - Specifies a set of project dependencies

  • [layout] - Directory layout of the project

    • modules_dir

    • scripts_dir

    • tests_dir

The [package] section

name = "my_project"
account_address = "<your account address>"
dialect = "polkadot"
dependencies = [
{ git = "", branch = "v1.2.0" },
{ path = "./local_modules" }

The account_address field

The address of the user account.

  1. You can use {{sender}} clause anywhere in your source code, which will be replaced with the value of account_address at compilation time.

  2. If you dove run the script without --signers flag, this address will be the default signer passed to the script function.

  3. If you don't wrap your module with the address {} block, this value is used as the address of the module.

The dialect field

This field controls which address format to use in your project.

Possible values are:

  • "pont"(default) - Polkadot addresses, i.e. 5FHneW46xGXgs5mUiveU4sbTyGBzmstUspZC92UhjJM694ty

  • "diem" - Diem addresses, i.e. 0x1232414212412

  • "dfinance" - Dfinance bech32 addresses, i.e. wallet1pxqfjvnu0utauj8fctw2s7j4mfyvrsjd59c2u8

The dependencies field

It's a TOML list, each entry specifies a set of modules to use as dependencies.

  1. Git dependencies

dependencies = [
{ git = "", branch = "my-branch" }

You can also add tag, rev and path modifiers. path will only include a subdirectory of the repo.

  1. Local dependencies

    dependencies = [
    { path = "./mymodules" }

The [layout] section

Allows customization of the layout of the project - directories where you store your Move source code.

modules_dir = "modules"
scripts_dir = "scripts"
tests_dir = "tests"