How to Run aMACI Operator Service on Dora Vota Mainnet (vota-ash)

Configure environment variables

Step 1: Create your own environment variables file

cp .env.template .env

Step 2: Generate your coordinator public and private key

npm run new-key

For example, the format of the public key:

X: 16429304017412205675820866000313944904446810339972042319485432996531286181952
Y: 5572999208344294573488778747734990567557173306854827005273539480127951622273

Step 3: Configure your MNEMONIC and coordinator private key of aMACI operator

• Enter the Coordinator private key generated in the previous step into the COORDINATOR_PRI_KEY field in your .env file.
• Enter the mnemonic of the previously generated aMACI operator account into the MNEMONIC field in your .env file.
• Enter the rpc url (It ensures that you can use a stable and continuous RPC services, it is recommended that you use your validator RPC or stable full node RPC) into the RPC_ENDPOINT field in your .env file.
• Enter the indexer url with https://vota-api.dorafactory.org into the IND_ENDPOINT field in your .env file.
• Enter the contract address with dora1smg5qp5trjdkcekdjssqpjehdjf6n4cjss0clyvqcud3t3u3948s8rmgg4 into the DEACTIVATE_RECORDER field in your .env file.
• Enter the code id with ["93","95","103","118","121","123"] into the CODE_IDS field in your .env file.

Set your aMACI operator information

Step 1: Set your operator identity by your operator address

dorad tx wasm execute  dora1smg5qp5trjdkcekdjssqpjehdjf6n4cjss0clyvqcud3t3u3948s8rmgg4 '{"set_maci_operator_identity": { "identity": "<your_identity_id>" } }' \
--from $AMACI_OPERATOR \
--chain-id "vota-ash" \
--gas-prices 100000000000peaka \
--gas auto \
--gas-adjustment 1.5 \
--node https://vota-rpc.dorafactory.org:443 \
-y

Step 2: Set your operator public key by your operator address

dorad tx wasm execute dora1smg5qp5trjdkcekdjssqpjehdjf6n4cjss0clyvqcud3t3u3948s8rmgg4 '{"set_maci_operator_pubkey": { "pubkey": { "x": "<your_pubkey_x>", "y": "<your_pubkey_y>"  }} }' \
--from $AMACI_OPERATOR \
--chain-id "vota-ash" \
--gas-prices 100000000000peaka \
--gas auto \
--gas-adjustment 1.5 \
--node https://vota-rpc.dorafactory.org:443 \
-y

Initiate aMACI operator service

npm run init

Create the definition file

Create the definition file in /etc/systemd/system/amaci.service.

[Unit]
Description=aMACI-operator-service
After=network-online.target
 
[Service]
User=<USER>
WorkingDirectory=<PATH_TO_amaci-operator>
EnvironmentFile=<PATH_TO_amaci-operator>/.env
ExecStart=/usr/bin/node dist/index.js
RestartSec=10
Restart=on-failure
LimitNOFILE=655350
 
[Install]
WantedBy=multi-user.target

• <USER>: Enter the user (likely your username or root, unless you created a user specifically for aMACI operator service).
• <PATH_TO_amaci-operator>: Enter the path to the amaci-operator directory, which is likely /home/ubuntu/amaci-operator.

Run the program upon startup

After registering amaci as a system service, you can set the program to run upon startup.

systemctl daemon-reload
systemctl enable amaci

Start the service and check the log

sudo systemctl start amaci
sudo journalctl -u amaci -f --no-hostname -o cat

If the service started successfully, the log will output your aMACI operator’s information and download some necessary zkey files. Like this:

[2025-05-16 17:17:54.940] [INFO] [INIT]  Init your coordinator info
.......
.......
.......
[2025-05-16 17:17:55.000] [INFO] [INIT]  code id list: ["93","95","103","118","121","123"]
[2025-05-16 17:17:55.000] [INFO] [INIT]  Check your required zkey files🧐🧐🧐🧐
[2025-05-16 17:17:55.004] [INFO] [METRICS]  Metrics server started on port 3001
.......
.......
.......