TypeScript icon, indicating that this package has built-in type declarations

0.2.2 • Public • Published


Development tool for Phala Phat contracts.


Add to your projects using package manager (yarn@^1 / npm)
Sadly yarn@^3 is not supported (check #4)

yarn add -D devphase
yarn add -D typescript ts-node # required peer dependencies


Global flags

--json                      # Prints result of command in json format
--verbosity=X               # Adjusts verbosity (0 - silent, 1 - default, 2 - verbose)

Project commands

  • Init project (creates required files and directories)
yarn devphase init
  • Check project configuration and dependencies
yarn devphase check

Stack related commands

  • Starting local stack (node + pruntime + pherry)
yarn devphase stack run [--save-log]
--save-log                  # Saves logs to file
  • Setup local stack (register gatekeeper, create cluster, deploy system contract etc.)
yarn devphase stack setup
-n, --network               # Switch network (local - by default)

Accounts management

  • Prints list of managed accounts (from ./accounts.json)
yarn devphase account list [--columns <value> | -x] [--sort <value>] [--filter <value>] [--output csv|json|yaml] [--csv | --no-truncate] [--no-header]
  • Creates new managed account
yarn devphase account create -a <value> [-p <value>] [-n]

-a, --alias=<value>         # (required) Account alias
-n, --no-passphrase         # Force no passphrase (prompted if not specified)
-p, --passphrase=<value>    # Passphrase used to protect keyring

Contracts management

  • Prints list of managed contracts (from ./contracts.json)
yarn devphase contract list [--columns <value> | -x] [--sort <value>] [--filter <value>] [--output csv|json|yaml] [--csv | --no-truncate] [--no-header]
  • Creates new contract project from template
yarn devphase contract create -n <value>
-n, --name=<value>          # (required) Contract name
  • Compiles contract using system cargo binary
yarn devphase contract compile [-c <value>] [-w] [-r]
-c, --contract=<value>      # Contract name
-r, --release               # Compile in release mode
-w, --watch                 # Watch changes
  • Deployes contract to network
yarn devphase contract deploy [ARGS] -c <value> -o <value> [-t InkCode|SidevmCode] [-n <value>] [-l <value>] [-a <value>]
ARGS                        # Constructor arguments
-a, --account=<value>       # [default: alice] Account used to deploy (managed account key)
-c, --contract=<value>      # (required) Contract name
-l, --cluster=<value>       # Target cluster Id
-n, --network=<value>       # [default: local] Target network to deploy (local default)
-o, --constructor=<value>   # (required) Contract constructor to call (name)
-t, --type=<option>         # [default: InkCode] <options: InkCode|SidevmCode>
  • Executes contract call
yarn devphase contract call [ARGS] -c <value> -i <value> -m <value> [-t InkCode|SidevmCode] [-a query|tx] [-n <value>] [-l <value>] [-a <value>]
ARGS                        # Call arguments
-a, --accessor=<option>     # [default: query] Method type: transaction or query <options: query|tx>
-a, --account=<value>       # [default: alice] Account used to call (managed account key)
-c, --contract=<value>      # (required) Contract name
-i, --id=<value>            # (required) Contract ID
-l, --cluster=<value>       # Target cluster Id
-m, --method=<value>        # (required) Contract method to call (name)
-n, --network=<value>       # [default: local] Target network to deploy (local default)
-t, --type=<option>         # [default: InkCode] <options: InkCode|SidevmCode>
  • Contracts TS bindings creation
yarn devphase contract typegen -c <value>
-c, --contract=<value>      # (required) Contract name
  • Testing with mocha
yarn devphase contract test [-s <value>] [-n <value>]
-n, --network=<value>       # [default: local] Network key
-s, --suite=<value>         # Test suite name (directory)


Create devphase.config.ts in root directory (init command in TODO)

Here is default configuration. All values are optional (merged recuresivly)

import { ProjectConfigOptions } from 'devphase';

const config : ProjectConfigOptions = {
     * Project directories
    directories: {
        artifacts: 'artifacts',
        contracts: 'contracts',
        logs: 'logs',
        stacks: 'stacks',
        tests: 'tests',
        typings: 'typings'
     * Stack configuration
     * {
     *     [componentName : string]: {
     *          binary: string, // path to binary
     *          workingDir: string, // working directory as above
     *          evns: {
     *              [name: string]: string,
     *          },
     *          args: {
     *              [name: string]: string,
     *          },
     *          timeout: number // start up timeout
     *     }
     * }
    stack: {
        blockTime: 6000, // default block time for direct stack running (may be overriden in testing mode)
        version: 'latest', // version which you want to pull from official repository (tag name) or "latest" one
        node: {
            port: 9944, // ws port
            binary: '{{directories.stacks}}/{{stack.version}}/phala-node',
            workingDir: '{{directories.stacks}}/.data/node',
            envs: {},
            args: {
                '--dev': true,
                '--rpc-methods': 'Unsafe',
                '--block-millisecs': '{{stack.blockTime}}',
                '--ws-port': '{{stack.node.port}}'
            timeout: 10000,
        pruntime: {
            port: 8000, // server port
            binary: '{{directories.stacks}}/{{stack.version}}/pruntime',
            workingDir: '{{directories.stacks}}/.data/pruntime',
            envs: {},
            args: {
                '--allow-cors': true,
                '--cores': 0,
                '--port': '{{stack.pruntime.port}}'
            timeout: 2000,
        pherry: {
            gkMnemonic: '//Alice', // gate keeper mnemonic
            binary: '{{directories.stacks}}/{{stack.version}}/pherry',
            workingDir: '{{directories.stacks}}/.data/pherry',
            envs: {},
            args: {
                '--no-wait': true,
                '--mnemonic': '{{stack.pherry.gkMnemonic}}',
                '--inject-key': '0000000000000000000000000000000000000000000000000000000000000001',
                '--substrate-ws-endpoint': 'ws://localhost:{{stack.node.port}}',
                '--pruntime-endpoint': 'http://localhost:{{stack.pruntime.port}}',
                '--dev-wait-block-ms': '{{stack.blockTime}}',
            timeout: 2000,
     * Testing configuration
    testing: {
        mocha: {}, // custom mocha configuration
        spawnStack: true, // spawn runtime stack? or assume there is running one
        stackLogOutput: false, // if specifed pipes output of all stack component to file (by default it is ignored)
        blockTime: 100, // overrides block time specified in node (and pherry) component
        envSetup: { // environment setup
            setup: {
                custom: undefined, // custom setup procedure callback; (devPhase) => Promise<void>
                timeout: 60 * 1000,
            teardown: {
                custom: undefined, // custom teardown procedure callback ; (devPhase) => Promise<void>
                timeout: 10 * 1000,
     * Networks configuration
     * Default network is local and it can be changed using CLI argument
    networks: {
        local: {
            nodeUrl: 'ws://localhost:{{stack.node.port}}',
            nodeApiOptions: {
                types: {
            workerUrl: 'http://localhost:{{stack.pruntime.port}}',
            blockTime: 6000, // network block time (may be overriden in testing mode)
     * Accounts fallback configuration
     * It is overriden by values saved in ./accounts.json
    accountsConfig: {
        keyrings: {
            alice: '//Alice', // string (in case of mnemonic) or account keyring JSON
            bob: '//Bob',
            charlie: '//Charlie',
            dave: '//Dave',
            eve: '//Eve',
            ferdie: '//Ferdie'
        suAccount: 'alice'

export default config;

Usage sample

Check usage sample repo


Check sandbox environment repo for easy testing with up-to-date code




npm i devphase

DownloadsWeekly Downloads






Unpacked Size

1.25 MB

Total Files


Last publish


  • l00k