Skip to content

Getting started

For Users

First, choose the blockchain network that you wish to connect to. Then search for the project in the Search bar. Look for the proposal that you are interested in voting for.


Before voting, please ensure that:

  • Your MetaMask wallet is connected to the corresponding network you are voting in. You can get necessary info about the blockchains we support here and follow these instructions to add to your MetaMask wallet
  • Your account has the necessary number of ERC20/BEP20 tokens to qualify for the vote as specified by the block height in the snapshot.


If you wish to get tokens for the testnet, please refer to the Getting tokens section for more information

Once you have obtained tokens, you can participate in the vote by clicking on your option of choice. Currently, we are calculating the token balance for each voter based on the block height that each proposal mandates.

The results of vote can be seen after the vote has concluded and finazlied.

For Private Proposals: Only the final winning option will be shown

For Medium Proposals: The number of votes for each option will be shown.

For Public Proposals: The voter information will be transparent to the public.

For Project Owners

Project owners can create a workspace for hosting proposals. Project teams or community members can then proceed to create proposals. Currently the metadata is stored on the testnet of Automata Network. Connect to the testnet to create workspaces or propsals.

Adding the Automata Network testnet to your network

Add the Automata Network to your existing network using the following details:

Field Value
Network Name Automata Network
Chain ID 86
Currency Symbol ATA

The option to add network can be found by clicking on:

  • Profile Picture >> Settings >> Networks >> Add Network


  • Network name >> Custom RPC

Connecting Your Metamask Wallet

If you see Connect wallet or Not connected show up in your MetaMask, this means that you are not connected!

You can follow these steps to connect your wallet:

  • Click on Connect wallet at the top right corner
  • Click on MetaMask
  • Select the account you wish to connect with MetaMask
  • Connect your account

Creating a workspace

You can create a workspace from the landing page Witness.


Before creating a workspace for your token, please ensure the following:

  • Your MetaMask wallet is connected to Automata Network
  • Your account has the necessary ATA tokens

If you do not have the necessary tokens, please refer to Getting tokens.

Once ready, you can create a workspace by:

  • Clicking on Create
  • Choose the correct blockchain network for your workspace
  • Fill in your workspace name
  • Fill in your workspace specifications
  • Enter your token contract hash
  • Click on Create

Creating a new proposal

Head over to the workspace of a project you're interested in creating a proposal for. If the workspace has not been created yet, refer to Creating a Workspace.


Before creating a proposal, please ensure that:

  • Your MetaMask wallet is connected to Automata Network
  • Your account has the necessary ATA tokens

If you do not have the necessary tokens, you can refer to Getting tokens.

Once ready, you can create a proposal by:

  • Clicking on New Proposal
  • Fill in your proposal title
  • Fill in content for your proposal
  • Add / Edit / Remove your voting options
  • Select the start and end date
  • Click on Publish


This feature enables calling of the on-chain contract which was registered at proposal creation. Note this is still in beta so it's only enabled for selected platform currently. Each voting option can be followed with a chainhook or, you can create a chainhook by:

  • Clicking on Add Chainhook followed by the option field
  • Choose the smart contract language for your Chainhook
  • Fill in the contract address where your Chainhook will take effect
  • Fill in the function name
  • Add arguments for your callback function
  • Each argument is paired with the type and the value field
  • Currently only uint256, uint256[], address, address[] are supported as argument types
  • Follow the example for input value by hovering above the value field


Setting up MetaMask

MetaMask is a cryptocurrency wallet used to interact with the Ethereum blockchain. As it is required when using Automata Network, you can install the extension via the official download page here, or simply add the extension for your browser using the links below:

Getting tokens

Getting ERC20 tokens (Ethereum Kovan Network)

To get your tokens, head over to our faucet at

Copy the address of your account in MetaMask by clicking on 'Copy to Clipboard' and then paste the address into the input field for your desired token. Click Submit.

When receiving ERC-20 tokens, the relevant contract hash can be found right next to the words "Ethereum Kovan Network". You can copy this by clicking on the Copy button next to it.

Getting BEP20 tokens in the Binance Smart Chain test network

To get tokens in the BSC test network, you can search for the contract address using Use the faucet or to get tokens.

Supported Chain Info

Field Value
Network Name BSC mainnet
Chain ID 56
Field Value
Network Name BSC testnet
Chain ID 97
Field Value
Network Name Plasm Dusty testnet
Chain ID 80
Field Value
Network Name Clover testnet
Chain ID 1023
Field Value
Network Name Dawinia Pangolin testnet
Chain ID 43
Field Value
Network Name Moonbase Alpha testnet
Chain ID 1287
Field Value
Network Name Polygon
Chain ID 137
Field Value
Network Name Avalanche
Chain ID 43114
  • Ethereum Mainnet and Kovan Testnet are not listed here since they are natively supported by Metamask

Get supported by Witness

We are open to onboard any EVM networks as our first batch of supported networks by Witness. The following details are required for us to complete the onboarding. The integration only involves small changes in Witness on our side.

  • Chain ID
  • Blockchain Explorer URL (optional)
  • Faucet (for testnet)
Back to top