Viction
  • Getting Started
  • General
    • Overview
    • Viction Blockchain
      • PoSV Consensus
      • Comparison
    • Staking
      • Staking Requirements
      • Staking Rewards
      • How to stake on Viction Wallet
    • Network Information
      • Viction Mainnet
      • Viction Testnet
    • Viction RPC API
  • Smart Contract Development
    • Solidity
      • A Simple Smart Contract
      • Solidity by Example
    • Standards & Specification
      • VRC25 Specification
      • VRC725 Specification
    • IDEs and Tools
      • Remix
      • Ethers.js
      • web3.js
      • thirdweb CLI
    • Deployment & Verification
      • Hardhat
      • Foundry
  • DApp Development
    • Integration
      • Exchange/Wallet integration
      • VRC25 Exchange/Wallet integration
      • Viction Staking Governance
      • VIC ZeroGas
      • VRRF
    • Data and analytics
    • Embedded Wallet (MPC)
    • Walkthrough: Build a Dapp on Viction
      • Setup Environment
      • Write the Smart Contract
      • Interacting with the Dapp in a browser
  • Masternode
    • Requirements
    • Run a Full Node
      • Binary
      • Create a Viction Masternode
      • Tmn
      • Docker
    • Apply Your Node
    • Slashing Mechanism
    • Chain Data Snapshots
    • Troubleshooting
  • Viction Wallet
    • User Guide
      • Authentication
      • How to create a new wallet
      • How to restore a wallet?
      • Wallet settings
      • Send & Receive Tokens
      • Add custom token
      • Manage Tokens
      • Send NFT
      • General settings
    • Developer Guide
    • Privacy Policy
    • Term and Services
  • Viction Bridge
    • Spacegate
    • Arken Bridge
    • Hyperlane
  • Viction Data Availability
    • Viction DA RPC API
    • DA Integration Use cases
      • Simple Guide for Integrating OP Stack Rollup with Viction DA Layer
  • How to
    • How to Connect to Viction Blockchain
      • Coin98 Super Wallet
      • Metamask
      • Ledger
    • How to troubleshoot when the node is up but couldn't begin to sync block
    • How to Vote for Viction Saigon Network Upgrade Proposal
    • How to issue a token via VICIssuer
    • How to verify if a contract has been issued via VICIssuer
    • How to deploy the VRC725 contract
    • How to apply ZeroGas for VRC725 contract
    • How to Migrate Dapps from Ethereum
    • How to register Token or NFT logo on Vicscan
    • How to verify a contract on Vicscan
    • How to confirm a project on Vicscan
    • How to check if a token is gas sponsored on Viction
    • How to verify gas sponsored transactions
    • How to create Telegram Mini Apps
    • How to use VictionSafe (Multisig)
  • FAQ
    • APIs
    • General
      • Viction
      • Ecosystem
      • VIC - Economics
      • Contact & Support
    • Masternodes and Voting
      • Masternodes
      • Voter
    • Products
      • VicScan (Explorer)
      • VicMaster
      • VicStats
      • VicIssuer
        • How to Verify & Publish Contract Source Code on VicScan
      • Viction Wallet
      • Viction Data Availability Network
  • Legal
    • Terms of Use
    • Privacy Policy
  • Whitepaper and Research
  • Archive
    • TOMOE
    • How to Deploy a VRC25 Token on Viction
    • How to deploy an ICO smart contract on Viction
    • How to deploy an NFT token
    • An Example of Building a Dapp on Viction
    • Migrate Ethereum Dapp to Viction
    • TomoMasterDAO
      • Introduction
      • Governance model
        • On-Chain vs Off-Chain Voting
        • Board
        • Proposals
        • Voting and Outcome
      • Tokenomics
      • How to utilize and trade tDAO
      • Proposal guidelines for TomoMasterDAO
    • Old Viction Testnet
    • Deploy on Viction
      • CLI Commands
      • Viction Private Testnet Setup
Powered by GitBook
On this page
  • General hardware notice
  • tmn
  1. Masternode

Run a Full Node

This tutorial shows how to run a full node and meet the requirements to apply to become a Masternode Candidate on VicMaster. You have to run the Viction client - our Viction implement on Go

General hardware notice

The Viction team has extensively tested performances and come up with those minimal requirements for any Viction masternode host.

Testnet

  • Must be facing internet directly (no NAT, public IP)

  • Must have at least 2 cores

  • Must have at least 8GB of RAM

  • Must use an IaaS ("cloud") provider of your choice (AWS, Digital Ocean, Google Cloud, etc.).

  • Storage must be SSD

Mainnet

  • Must be facing internet directly (no NAT, public IP)

  • Must have at least 16 cores

  • Must have at least 32GB of RAM

  • Must use an IaaS ("cloud") provider of your choice (AWS, Digital Ocean, Google Cloud, etc.)

  • Storage must be SSD

Storage requirements for building a node

It depends on how you operate the Full node. The data is now roughly 700GB (updated on Oct 1st, 2023). So there are two options for you to consider:

  • If you're starting a fresh new full node, 1TB should be enough.

  • If you want to restore the chain data from a Snapshot, 2TB is recommended because downloading and decompressing can take up to 1.5TB of your storage.

We recommend prioritizing CPU. For example with Digital Ocean, pick a CPU optimized droplet. On AWS EC2, a C5 type instance would be a perfect match.

The full node will serve on port 30303 udp and tcp for p2p communication with other nodes, 8545 tcp for RPC api and 8546 tcp for websocket api. You may need to edit your firewall configuration accordingly.

tmn

Prerequisites

To use tmn, you should meet these requirements in addition to the hardware ones:

Installation

Simply install it from pip.

pip3 install --user tmn

Update

Update it from pip.

pip3 install -U tmn

First start

When you first start your full node with tmn, you need to give some information.

--name: The name of your full node. It should be formatted as a slug string. Slug format authorize all letters and numbers, dashes ("-") and underscores ("_"). You can name it to reflect your identity, company name, etc.

--net: The network your full node will connect to. You can choose here to connect it to the Viction Testnet or Mainnet (once launched).

--pkey: The private key of the account that your full node will use. A Viction full node uses an account to be uniquely identified and to receive transaction fee.

Important note: we advise for security measures to use a fresh new account for your masternode. This is not the account who will receive the rewards. The rewards are sent to the account who will make the 50k VIC initial deposit.

It could look like this:

tmn start --name [YOUR_NODE_NAME] \
    --net testnet \
    --pkey [YOUR_COINBASE_PRIVATE_KEY]

Note: it can take up to one hour or more (depending on the blockchain data size) to properly sync the entire blockchain.

Usage

You can now interact with it via the other commands:

stop: Stop your full node.

start: Start your full node if it is stopped.

status: The current status of your full node.

inspect: Display the details related to your full node. Useful for applying your full node as a masternode.

remove: Completely remove your masternode, unique identity and data.

Troubleshooting

tmn: command not found

It might happen that your PATH is not set by default to include the default user binary directory. You can add it by adding it to your shell $PATH:

On GNU/Linux:

echo 'export PATH=$PATH:~/.local/bin' >> ~/.bashrc

On MacOS: Replace [VERSION] by your version of python (3.5, 3.6, 3.7)

echo 'export PATH=$PATH:~/Library/Python/[VERSION]/bin' >> ~/.bashrc

error: could not access the docker daemon

If you have installed Docker, you probably forgot to add your user to the docker group. Please run this, close your session and open it again.

usermod -aG docker $your_user_name
PreviousRequirementsNextBinary

Last updated 3 months ago

If you have other production grade environment than cloud provider at your displosal, please tell us more about on our .

We made a simple command line interface called to easily and quickly start a Viction full node. It takes care of starting the necessary docker containers with the proper settings for you. It will really suit you if you don't already have a big infrastructure running. Spin up a machine in your favorite cloud and get your full node running in a few minutes!

>= 3.5

Once started, you should see your node on the or the , depending on which net you are connecting to!

Gitter
tmn
Docker CE
Python
testnet stats page
mainnet stats page