Abraham Milano amilano

How to Set Up a Chainweb Node for Testnet

The official documentation is comprehensive for setting up a Chainweb node on the mainnet (refer to Chainweb Get Started). However, deploying on the testnet requires additional configuration, as detailed below.

Prerequisites

A Linux machine meeting the minimum requirements (see Chainweb Node README) with the following software installed:

Docker

Gas Stations

A gas station is a coin account that pays for gas fees on behalf of a user. Let's explore how we can create an account that is scoped to only pay for gas for specific transactions.

Unscoped Gas Station

To start off, let's create a gas station that is unscoped. From there we can then see how we can scope it to only pay for gas for specific transactions.

Chainweb Transfers

Query Chainweb transfer events within a block range for a given chain.

Usage example:

CHAIN=1 MINHEIGHT=1420000 MAXHEIGHT=14201000 bash ./tranfers.sh

Deploy Module to Testnet Using Command Line

This document will walk you through how to deploy your first module to Testnet using the Command Line. To achieve this, we will use the pact command line tool's API Request formatter (pact -a) and the curl command line tool.

Step 0: Install the Prerequisites

Install Pact

Step 1: Create the Pact Module

We will be deploying the following pact module. For simplicity's sake, this walkthrough expects that the pact code we are deploying is not using a transaction's data field (read-keyset is one such pact function that makes use of this field). Otherwise, the accompanying YAML file will have to change. We also assume that this pact code is saved as test.pact.

Profile	download (kb/s)	upload (kb/s)	latency (ms)
Native	0	0	0
GPRS	50	20	500
56K Dial-up	50	30	120
Mobile EDGE	240	200	840
2G Regular	250	50	300
2G Good	450	150	150
3G Slow	780	330	200

Configuring application.rb

To turn off without having to add options:

# application.rb
config.generators.assets = false
config.generators.helper = false

	docker run -it ubuntu:16.04

	apt-get -y update
	apt-get -y upgrade

	apt-get install -y python3-pip
	pip3 install awscli

	aws --version
	aws-cli/1.14.48 Python/3.5.2 Linux/4.13.0-36-generic botocore/1.9.1

	//
	// In Solidity, a mapping is like a hashmap and works with `string` like this:
	// mapping (string => uint) a;
	//
	// However it doesn't support accessors where string is a key:
	// mapping (string => uint) public a;
	//
	// "Internal compiler error: Accessors for mapping with dynamically-sized keys not yet implemented."
	//
	// An accessor returns uint when called as `a(string)`.

	#
	# Auth filter /etc/fail2ban/filter.d/nginx-auth.conf:
	#
	# Blocks IPs that makes too much accesses to the server
	#
	[Definition]

	failregex = ^<HOST> -."(GET\|POST).HTTP.*"

	ignoreregex =

	# activerecord-3.0.0/lib/active_record/connection_adapters/mysql_adapter.rb
	# Maps logical Rails types to MySQL-specific data types.
	def type_to_sql(type, limit = nil, precision = nil, scale = nil)
	return super unless type.to_s == 'integer'

	case limit
	when 1; 'tinyint'
	when 2; 'smallint'
	when 3; 'mediumint'
	when nil, 4, 11; 'int(11)' # compatibility with MySQL default