Giter Site home page Giter Site logo

proton-testnet.start's Introduction

Welcome to the PROTON Testnet [manual node installation]

Chain ID: 71ee83bcf52142d61019d95f9cc5427ba6a0d7ff8accd9e2088ae2abeaf3d3dd Based on tag: v3.1.2

Please join our PROTON Testnet Telegram channel
Network Monitor: https://monitor.testnet.protonchain.com/

P2P endpoints:

p2p-peer-address = testnet.protonchain.com:9876
p2p-peer-address = tn1.protonnz.com:9876
p2p-peer-address = proton-public-testnet.neftyblocks.com:19876
p2p-peer-address = protontestnet.greymass.com:59876
p2p-peer-address = p2p.proton-testnet.genereos.io:9876
p2p-peer-address = testnet.proton.eosdetroit.io:1337
p2p-peer-address = p2p-testnet-proton.eosarabia.net:9876
p2p-peer-address = test.proton.eosusa.news:19889
p2p-peer-address = protonp2ptestnet.ledgerwise.io:22877
p2p-peer-address = p2p-protontest.saltant.io:9879

! This repo is for manual installation.

Proton is a protocol built on top of the Antelope (formally known as EOSIO) consensus layer that allows verified user identity and applications to generate signature requests (transactions) that can be pushed to signers (wallets) for authentication and signature creation. These signature requests can be used today to authenticate and sign cryptographic payments. The same architecture will be used in future version to initiate and track pending fiat transactions

To start a Proton TestNet node you need install leap software. You can compile from sources or install from precompiled binaries:

1. Installing


1.1 Installing from sources

A. Create folder, download sources, compile and install:

mkdir /opt/EOSIO  
cd /opt/EOSIO  

git clone https://github.com/eosio/eos --recursive    
cd eos  

git checkout v2.1.0  
git submodule update --init --recursive   

./scripts/eosio_build.sh -P -y
./scripts/eosio_install.sh

B. Copy binaries to keep old versions and make sym link to latest:

mkdir /opt/bin
mkdir /opt/bin/v2.1.0
cp /opt/EOSIO/eos/build/programs/nodeos/nodeos /opt/bin/v2.1.0/
cp /opt/EOSIO/eos/build/programs/cleos/cleos /opt/bin/v2.1.0/
cp /opt/EOSIO/eos/build/programs/keosd/keosd /opt/bin/v2.1.0/
ln -sf /opt/bin/v2.1.0 /opt/bin/bin

So /opt/bin/bin will point to latest binaries

1.2 Installing from precompiled binaries

A. Download the latest version of EOSIO for your OS from:
https://github.com/EOSIO/eos/releases/tag/v2.1.0
For example, for ubuntu 18.04 you need to download deb eosio_2.1.0-1-ubuntu-18.04_amd64.deb
To install it you can use apt:

apt install ./eosio_2.1.0-1-ubuntu-18.04_amd64.deb   

It will download all dependencies and install EOSIO to /usr/opt/eosio/v2.1.0
B. Copy binaries to keep old versions and make sym link to latest:

 mkdir /opt/bin
 mkdir /opt/bin/v2.1.0
 cp /usr/opt/eosio/v2.1.0/bin/nodeos /opt/bin/v2.1.0/
 cp /usr/opt/eosio/v2.1.0/bin/cleos /opt/bin/v2.1.0/
 cp /usr/opt/eosio/v2.1.0/bin/keosd /opt/bin/v2.1.0/
 ln -sf /opt/bin/v2.1.0/ /opt/bin/bin

So /opt/bin/bin will be point to latest binaries


2. Update software to new version

2.1 Update sources

cd /opt/EOSIO/eos
git checkout -f
git branch -f
git pull
git checkout v2.1.0   
git submodule update --init --recursive   


./scripts/eosio_uninstall.sh    
./scripts/eosio_build.sh -P -y    


mkdir /opt/bin/v2.1.0
cp /opt/EOSIO/eos/build/programs/nodeos/nodeos /opt/bin/v2.1.0/
cp /opt/EOSIO/eos/build/programs/cleos/cleos /opt/bin/v2.1.0/
cp /opt/EOSIO/eos/build/programs/keosd/keosd /opt/bin/v2.1.0/
ln -sf /opt/bin/v2.1.0 /opt/bin/bin

2.2 Update binaries

To upgrade precompiled installation pleasse folow the same steps as in 1.2 (Installation from precompiled)


3. Install PROTON Testnet node [manual]

    mkdir /opt/ProtonTestnet
    cd /opt/ProtonTestnet
    git clone https://github.com/ProtonProtocol/proton-testnet.start.git ./

  • In case you use a different data-dir folders -> edit all paths in files cleos.sh, start.sh, stop.sh, config.ini, Wallet/start_wallet.sh, Wallet/stop_wallet.sh

  • to create an account on Proton test network go to monitor
    Click “Create Keypair” button located at the top left of the page, copy and save both public and private key. also you can create key pair using cleos command
    ./cleos.sh create key
    next Click “Create Account” at the top left of the page, enter an account name, submit your previously saved public key in both Owner and Active Public Key field, complete the captcha, and hit create.

  • If non BP node: use the same config, just comment out rows with producer-name and signature-provider

  • Edit config.ini:

    • server address: p2p-server-address = ENRT_YOUR_NODE_EXTERNAL_IP_ADDRESS:9876

    • replace p2p-peer-address list with fresh generated on monitor site: https://monitor.testnet.protonchain.com/#p2p

    • Check chain-state-db-size-mb value in config, it should be not bigger than you have RAM:
      chain-state-db-size-mb = 16384

    • if BP: your producer name: producer-name = YOUR_BP_NAME

    • if BP: add producer keypair for signing blocks (this pub key should be used in regproducer action):
      signature-provider = YOUR_PUB_KEY_HERE=KEY:YOUR_PRIV_KEY_HERE

    • if BP: comment out eos-vm-oc-enable and eos-vm-oc-compile-threads (EOSVM OC is not to be used on a block signing node)

  • To register as Block Producer, run command :

    ./cleos.sh system regproducer YOU_ACCOUNT PUBKEY "URL" LOCATION -p YOU_ACCOUNT
    
  • Open TCP Ports (8888, 9876) on your firewall/router

  • Start wallet, run

cd /opt/ProtonTestnet
./Wallet/start_wallet.sh  

First run should be with --delete-all-blocks and --genesis-json

./start.sh --delete-all-blocks --genesis-json genesis.json

Check logs stderr.txt if node is running ok.

  • Create your wallet file
./cleos.sh wallet create --file pass.txt

Your password will be in pass.txt it will be used when unlock wallet

  • Unlock your wallet
./cleos.sh wallet unlock  

enter the wallet password.

  • Import your key
./cleos.sh wallet import

Enter your private key

Check if you can access you node using link http://you_server:8888/v1/chain/get_info (Example)

==============================================================================================

4.1 Restore/Start from Backup

Download latest block and state archive for your OS from http://backup.cryptolions.io/ProtonTestNet/

wget http://backup.cryptolions.io/ProtonTestNet/ubuntu18/latest-blocks.tar.gz
wget http://backup.cryptolions.io/ProtonTestNet/ubuntu18/latest-state.tar.gz

After downloaded extract their

tar xzvf blocks-latest.tar.gz -C .
tar xzvf state-latest.tar.gz -C .

You got two folders block and state.
Ater that go to NODE folder, and remove files from folder blocks and state

cd /opt/ProtonTestnet/protonNode
rm blocks/*
rm state/*

After that go where you extracted archive and move file from folder

mv ~/blocks/* /opt/ProtonTestnet/protonNode/blocks/
mv ~/state/* /opt/ProtonTestnet/protonNode/state/

After files moved start your NODE

./start.sh

4.2 Restore/Start from Snapshots

Download latest snapshot from http://backup.cryptolions.io/ProtonTestNet/snapshots/ to snapshots folder in your NODE directory

cd /opt/ProtonTestnet/protonNode/snapshots/
wget http://backup.cryptolions.io/ProtonTestNet/snapshots/latest-snapshot.bin

after it downloaded run start.sh script with option --snapshot and snapshot file path

cd /opt/ProtonTestnet/protonNode
./start.sh --snapshot /opt/ProtonTestnet/protonNode/snapshots/latest-snapshot.bin

5. Usefull Information

Proton Faucet - get free XPR tokens:

https://monitor.testnet.protonchain.com/#faucet

Other Tools/Examples

  • Cleos commands:

Send XPR

./cleos.sh transfer <your account> <receiver account> "1.0000 XPR" "test memo text"

Get Balance

./cleos.sh get currency balance eosio.token <account name>

List registered producers (-l <limit>)

./cleos.sh get table eosio eosio producers -l 100  

List staked/delegated

./cleos.sh system listbw <account>   

6. Usefull Links

Hyperion History
https://testnet.protonchain.com/v2/docs
https://proton-testnet-hyperion.eoscafeblock.com/v2/docs

Block Explorers
https://proton-test.bloks.io

LightAPI and State Track API here are all SimpleAssets and dGoods belonging to Jacob:

curl 'https://strack-dev.xeos.me/strack/tokens?network=protontest&account=jacob'

Here are all fungible tokens for the same user:

curl 'https://testnet-lightapi.eosams.xeos.me/api/account/protontest/jacob'

Backups

Full(blocks and states):

Snapshot:


proton-testnet.start's People

Contributors

ansigroup avatar bublik77 avatar cc32d9 avatar eosusa avatar ismyhc avatar paulgnz avatar rossco99 avatar swandoyo avatar xavier506 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.