pokt-network/pocket-core BETA-0.6.3.10

on GitHub

NOTE:
This is a BETA release. Please ensure you deploy it to your fleet in a slow pace. We recommend you update a small batch of nodes first, and increase your deployment over time as certainty of stability in your environment cements itself. If you run into issues, please communicate with us via discord so that we can work together to gather information and face any edge cases that escaped our quality assurance efforts.

This is a continuation of the effort started in BETA-0.6.3.8 and BETA-0.6.3.9, and fixes an issue that happened on a particular scenario: when the relay had an issue that merited a dispatch, such as receiving a request with the wrong height, the response was built with data that might have been fetched from the cache; in this scenario, the cache was not being shared with the version of the store used in building the context, resulting in an attempt to dereference a nil pointer - an issue also known as a "Null Pointer Exception" in other languages.

Thank you for your collaboration.

Upgrade: (Same as previous releases)

1. Shutdown Pocket Core

2. !!! Ensure golang version 1.16 !!! or > golang upgrade NOTE: This version is new so please ensure you are on 1.16 or later

   ### Startup script linux users might find this useful (BenVan's Validator Script Only)
   sudo apt-get update
   g install 1.16
   

3. Build from source, Homebrew or Docker:

   To build the latest binary from source, follow these steps:

   Navigate into your pocket-core directory:
   Example: cd ~/go/src/github.com/pokt-network/pocket-core

   Enter: pocket version
   You should see: BETA-0.6.3.10

   To grab the latest packages and tags we are going to clean the cache, swap branches to the latest tag using:
   go clean --cache
git pull
git checkout tags/BETA-0.6.3.10
   Once you checked out the latest tag and branch, we are going to rebuild the binary by entering in:
   go build -o $GOPATH/bin/pocket ./app/cmd/pocket_core/main.go

   After it builds, make sure you are on the latest release version by entering in:
   pocket version

   Output will be BETA-0.6.3.10

   If you built your binary using Homebrew, follow these steps to upgrade your binary:

   In a terminal window, we are going to pull the latest tap by entering:
   $ brew upgrade pokt-network/pocket-core/pocket

   After it builds, make sure you are on the latest version by entering in:
   pocket version

   Output will be BETA-0.6.3.10

   For individuals using Docker, all you will need to do to get the new container image is run:

   docker pull poktnetwork/pocket-core:BETA-0.6.3.10

   or

   docker pull poktnetwork/pocket:BETA-0.6.3.10

   Depending on which of the 2 Docker images you want to use.

4. Enable the Cache:
   The cache is the centerpiece for this release, and is opt-in only. It can be enabled by using the flag --useCache in the start command. It increases the use of RAM to reduce the use of CPU. Make sure to have around 512MB of RAM above the normal usage. When running in a container, ensure a strict RAM limit, otherwise consumption will rise until the orchestrator resets the container. Startup times can increase significantly depending on your hardware. Please allow time for the cache to warm.

Example usage with cache:
pocket start --mainnet --useCache