Installation and usage of the platform

General platform configuration: execution of smart contracts

If you are goinf to to develop and execute smart contracts in your blockchain, set their execution parameters in the docker-engine section of the node configuration file:

docker-engine {
  enable = yes
  integration-tests-mode-enable = no
  # docker-host = "unix:///var/run/docker.sock"
  execution-limits {
    startup-timeout = 10s
    timeout = 10s
    memory = 512
    memory-swap = 0
    }
  reuse-containers = yes
  remove-container-after = 10m
  allow-net-access = yes
  remote-registries = [
    {
     domain = "myregistry.com:5000"
     username = "user"
     password = "password"
   }
  ]
  check-registry-auth-on-startup = no
  # default-registry-domain = "registry.wavesenterprise.com"
  contract-execution-messages-cache {
    expire-after = 60m
    max-buffer-size = 10
    max-buffer-time = 100ms
  }
  contract-auth-expires-in = 1m
  grpc-server {
    # host = "192.168.97.3"
    port = 6865
    }
  }
  remove-container-on-fail = yes
}
  • enable - enable transaction processing for Docker contracts.

  • integration-tests-mode-enable - Docker contracts testing mode. When this option is enabled, smart contracts are executed locally in the container.

  • docker-host - Docker daemon address (optional). If this field is commented out, the address of the daemon will be taken from the system environment.

  • startup-timeout - time taken to create the contract container and register it in the node (in seconds).

  • timeout - the time taken to execute the contract (in seconds).

  • memory - memory limit for the contract container (in megabytes).

  • memory-swap - allocated amount of virtual memory for the contract container (in megabytes).

  • reuse-containers - using one container for several contracts when using the same Docker image. To enable this option, specify yes, to disable - no.

  • remove-container-after - the time interval of container inactivity, after which it will be removed.

  • allow-net-access - permission to access the network.

  • remote-registries - Docker registry addresses and authorization settings.

  • check-registry-auth-on-startup - check authorization for Docker registries at node startup. To enable this option, specify yes, to disable - no.

  • default-registry-domain - default Docker registry address (optional). This parameter is used if no repository is specified in the contract image name.

  • contract-execution-messages-cache - settings of the cache with the execution status of transactions on Docker contracts;

  • expire-after - time to store the status of the smart contract.

  • max-buffer-size and max-buffer-time - settings for size and time of the status cache.

  • contract-auth-expires-in - lifetime of the authorization token used by smart contracts for calls to the node.

  • grpc-server - gRPC server settings section for Docker contracts with the gRPC API.

  • host - network address of the node (optional).

  • port - port of the gRPC server. Specify the listening port for gRPC requests used by the platform.

  • remove-container-on-fail - removes the container if an error occurred during its startup. To enable this option, specify yes, to disable - no.

See also