Skip to content

Browser configuration

The browser is the main monitoring tool for the blockchain.

Browser Backend

The configuration of the backend is defined in the relative path /conf/server.json.

  • port server port
  • database hibernate configuration
    • persistenceUnitName persistence unit name for hibernate configuration
    • driver database driver class
    • url url to database file or server
    • user database login user
    • password database login password
  • shards list of shards on the blockchain, excluding null for governance
  • nodes list of URLs to nodes on the blockchain
  • addresses contract addresses used by the system
    • blockProducerOrchestration Block Producer Orchestration Contract
    • zkNodeRegistry irrelevant for deployment
    • largeOracle irrelevant for deployment
    • mpcToken irrelevant for deployment
    • deployPublic PubDeploy Contract (optional and not part of default installation)
    • deployReal irrelevant for deployment
    • byocOrchestration irrelevant for deployment
  • blocksBehindThreshold amount of blocks we allow to be behind reader node, before we consider the system malfunctioning
  • disableAccountPluginTraversal if true, we should avoid traversing account plugin
Click here to view: Browser backend - Example configuration 
{
  "port": 8000,
  "database": {
    "persistenceUnitName": "model",
    "driver": "org.postgresql.Driver",
    "url": "jdbc:postgresql://browser-backend-db:5432/browser",
    "user": "postgres",
    "password": "postgres"
  },
  "shards": [
    "ShardName1",
    "ShardName2"
  ],
  "nodes": [
    "https://node1.domain.com",
    "https://node2.domain.com",
    "https://node3.domain.com"
  ],
  "addresses": {
    "blockProducerOrchestration": "04203b77743ad0ca831df9430a6be515195733ad91",
    "zkNodeRegistry": "000000000000000000000000000000000000000000",
    "largeOracle": "000000000000000000000000000000000000000000",
    "mpcToken": "000000000000000000000000000000000000000000",
    "deployPublic": "0197a0e238e924025bad144aa0c4913e46308f9a4d",
    "deployReal": "000000000000000000000000000000000000000000",
    "byocOrchestration": "000000000000000000000000000000000000000000"
  },
  "blockProducersTimeoutMinutes": 60,
  "blocksBehindThreshold": 20,
  "disableAccountPluginTraversal": true,
}

Browser Frontend

The configuration of the frontend is defined in the relative path /conf/config.js. Along with this file, 3 image files are needed. /conf/fav.svg, /conf/fav_large.svg and /conf/logo.svg.

  • serverUrl url of the browser backend
  • blockchainUrl url of a reader node for the blockchain
  • features set of enabled features
  • addressNames pre-named addresses in the system
  • palette color palette for the browser
Click here to view: Browser Frontend - Example configuration 
// noinspection ES6ConvertVarToLetConst
// eslint-disable-next-line
var CONFIG = {
  serverUrl: "https://backend.domain.com",
  blockchainUrl: "https://reader.domain.com",
  features: [
    "loginPrivateKey",
    "transactionPage",
    "blockPage",
    "accountPage",
    "contractPage",
    "contractPageInteraction",
  ],
  addressNames: {
    "04203b77743ad0ca831df9430a6be515195733ad91": "Block Producer Orchestration",
    "0197a0e238e924025bad144aa0c4913e46308f9a4d": "WASM Deploy",
    "04c5f00d7c6d70c3d0919fd7f81c7b9bfe16063620": "System Update",
  },
  palette: {
    primary: {
      main: "#0C194A",
      contrastText: "#FFFFFF",
    },
    secondary: {
      main: "#315DF8",
      contrastText: "#FFFFFF",
    },
    tertiary: {
      main: "#9E8FE3",
      contrastText: "#121212",
    },
    info: {
      main: "#315DF8",
      contrastText: "#FFFFFF",
    },
    error: {
      main: "#F75D31",
      contrastText: "#121212",
    },
    warning: {
      main: "#F57C00",
      contrastText: "#121212",
    },
    success: {
      main: "#43A047",
      contrastText: "#121212",
    },
    text: {
      primary: "#121212",
    },
    background: {
      default: "#FFFFFF",
    },
    icons: {
      from: "#315DF8",
      to: "#9E8FE3",
    },
  },
};