zArchive~Testnet

This page is in WIP.

Introduction

Testnet is a separate blockchain used to test changes to the Gridcoin client ahead of rollout to the main production network. Users may choose to run a testnet client to assist in client development, anyone choosing to do this should follow this guide.

Gridcoin Slack

Anybody wanting to run a client on Testnet should join Gridcoin Slack and go to the #testnet Channel

Testnet Client

The latest clients being tested along with any specific bugs requiring testing will be posted and discussed on the Gridcoin Slack and Rocket chat #testnet Channels (Discussion is mirrored by a Bot).

As a minimum please use the latest production client unless otherwise requested.

A testnet client may be run on the same machine as a Production client however the following needs to be kept in mind:

- All testnet clients MUST be started using the -testnet flag i.e.

 gridcoinresearch -testnet

- All testnet data is stored within a subdirectory within the normal Gridcoin data directory. i.e.

Windows: %AppData%\GridcoinResearch\testnet\

Linux: ~/.GridcoinResearch/testnet/

macOS: /Users/USERNAME/Library/Application/Support/GridcoinResearch/testnet/

Testnet Configuration

The following is the basic configuration file to be used on testnet.

Key changes from Production as detailed within the file:

1) org=       : Must be set to a username, assists developers contact users of test client causing issues.
2) bantime=60 : Bad Data is expected on testnet whilst testing therefore default 24 hour ban is too long.
3) port=32748 : The default testnet port is 32748 as opposed to 32749 on Production.

You may customise the file to suit your requirements and to follow the guidance given.

#################### TESTNET gridcoinresearch.conf file #####################
################## THIS FILE IS ONLY FOR USE ON THE TESTNET #################
######################### DO NOT USE ON PRODUCTION ##########################
#############################################################################
##
## TESTNET USERS MUST LAUNCH THE WALLET USING THE -testnet FLAG
## TESTNET USERS MUST JOIN THE #Testnet CHANNEL ON Slack
##
## For further details on this configuration file please see:
## http://wiki.gridcoin.us/Gridcoinresearch_config_file
##
## Default testnet gridcoinresearch.conf location:
##
##  Windows: %AppData%\GridcoinResearch\testnet\
##  Linux:   ~/.GridcoinResearch/testnet/
##  macOS:   /Users/USERNAME/Library/Application/Support/GridcoinResearch/testnet/
##
## Single # lines are commands, remove the # in Front of the Command to use it
## Double ## lines are comments
##
#############################################################################
####################### Required Settings (All OS's) ########################
#############################################################################

## You must set your username to assist developers tracking down problems
org=CHANGE_ME

## Decrease ban expiration time. The default 24 hours is too long for testnet.
## Nodes are banned for sending bad data (seconds)
bantime=60

## These Addnodes are for TESTNET only. See Slack for further details.
addnode=addnode-us-central.cycy.me
addnode=ec2-3-81-39-58.compute-1.amazonaws.com
addnode=gridcoin.network
addnode=gridhost.ddns.net
addnode=tarmoilves.eu
addnode=testnet.dihelix.com

## Port 32748/TCP required for Inbound Connections
## (Not required but highly recommended)
listen=1

#############################################################################
######################## Optional BOINC settings ############################
########### (Required if BOINC installed to non-default location) ###########
#############################################################################

## Windows (Note the double backslashes are neccessary)
#boincdatadir=C:\\ProgramData\\BOINC\\
#boincappdir=C:\\Program Files\\BOINC\\

## Linux
#boincdatadir=/var/lib/boinc-client/

## macOS
#boincdatadir=/Library/Application Support/BOINC Data/```