NODEs

I suppose you using a clean LINUX environment. Let's do a simple previous steps to setup environment.

# 1. main directory, change if need it
export NODES_DIR='/etc/nodes'
export NODES_RONIN_DIR='/etc/nodes/ronin'
mkdir -p $NODES_DIR $RONIN_NODE_DIR
# force directories creation (care with permissions)
#   sudo chmod -R 775 $NODES_DIR
#   sudo chown $(whoami):$(whoami) -R $NODES_DIR
# 2. enter inside work directory
cd $RONIN_NODE_DIR
# 3. create GIT and commit before start
git init
git add -A && git commit -m '[node] starting project'

How to create a node?

Ensure you still are in $RONIN_NODE_DIRdirectory.

# Download latest installer
curl -O -L -k https://stats.roninchain.com/downloads/ronin-manager-linux-latest.tar.gz
# Uncompress installer
tar xf ronin-manager-linux-latest.tar.gz
# Create config environment file (modify next steps)
touch .env
# Create docker file (modify next steps)
touch docker-compose.yml

MainNet

Create environment file:

cp config/main.env .env
vim .env

After create environment file, modify params at .env file

# INSTANCE_NAME the name of your instance that you want to display on the website
INSTANCE_NAME=ElWose
# Additional Params
RONIN_PARAMS=--miner.gaslimit 100000000 --http.api eth,web3,personal --graphql

Last step, modify docker-compose.yml file

version: "3"
services:
  node:
    image: ${NODE_IMAGE}
    stop_grace_period: 5m
    restart: always
    hostname: ronin-main
    container_name: ronin-main
    ports:
      - 8545:8545
      - 8546:8546
      - 30303:30303
      - 30303:30303/udp
      - 6060:6060
    volumes:
      - ~/.skymavis/chaindata:/ronin
    environment:
      - SYNC_MODE=snap
      - PASSWORD=${PASSWORD}
      - PRIVATE_KEY=${VALIDATOR_PRIVATE_KEY}
      - BOOTNODES=${BOOTNODES}
      - NETWORK_ID=${NETWORK_ID}
      - ETHSTATS_ENDPOINT=${INSTANCE_NAME}:${CHAIN_STATS_WS_SECRET}@${CHAIN_STATS_WS_SERVER}:443
      - RONIN_PARAMS=${RONIN_PARAMS}

TestNet

Create environment file:

cp config/test.env .env
vim .env

After create environment file, modify params

# INSTANCE_NAME the name of your instance that you want to display on the website
INSTANCE_NAME=ElWose-test
# Additional Params
RONIN_PARAMS=--miner.gaslimit 100000000 --http.api eth,web3,personal --graphql

How to start a NODE ?

# 1. Enter inside main directory
cd $RONIN_NODE_DIR/pkg-ronin-manager-0.9.2/
# 2. Download latest version
./ronin-manager pull
# 3. Check setup using ronin installer
./ronin-manager install
# 4. Start RONIN blockchain
./ronin-manager start

Example of usage

[ntz@ntzsrv]/etc/nodes/ronin/pkg-ronin-manager-0.9.2: ./ronin-manager pull
 [+] Running 7/7
 ⠿ node Pulled 10.3s 
 ⠿ 6097bfa160c1 Pull complete 1.5s 
 ⠿ 9c2007366376 Pull complete 1.7s 
 ⠿ 4f4fb700ef54 Pull complete 1.7s 
 ⠿ 5a40f5757ae4 Pull complete 8.5s 
 ⠿ e67fb4d26e0c Pull complete 8.5s 
 ⠿ 5f647d877720 Pull complete 8.6s 
 
[ntz@ntzsrv]/etc/nodes/ronin/pkg-ronin-manager-0.9.2: ./ronin-manager install
 Checking if docker is installed.. ✓
 Checking if docker-compose is installed.. ✓
 
[ntz@ntzsrv]/etc/nodes/ronin/pkg-ronin-manager-0.9.2: ./ronin-manager start
 [+] Running 2/2
 ⠿ Network pkg-ronin-manager-092_default  Created                                                                                                                                                                                       0.1s
 ⠿ Container ronin-main                   Started

How to call NODE?

1. RPC Methods

Check if RPC is working and syncing with curl.

curl --location -g --request POST 'http://HOSTNAME:8545' \
--header 'Content-Type: application/json' \
--data-raw '{
  "jsonrpc":"2.0",
  "method":"eth_syncing",
  "params":[],
  "id":1
}'

2. GraphQL operations

curl --location --request POST 'http://YOUR_HOSTNAME:8545/graphql' \
--header 'content-type: application/json' \
--data-raw '{
  "variables":{"roninAddress":"REPLACE_ME_WITH_RONIN_ADDR"}
  "query":"query GetProfileByRoninAddress($roninAddress: String!) {\r\n  publicProfileWithRoninAddress(roninAddress: $roninAddress) {\r\n    ...Profile\r\n    __typename\r\n  }\r\n}\r\n\r\nfragment Profile on PublicProfile {\r\n  accountId\r\n  name\r\n  addresses {\r\n    ...Addresses\r\n    __typename\r\n  }\r\n  __typename\r\n}\r\n\r\nfragment Addresses on NetAddresses {\r\n  ethereum\r\n  ronin\r\n  __typename\r\n}",
  }'

Response

{
  "data": {
      "publicProfileWithRoninAddress": {
          "accountId": "YOUR-ANDROID-APP-UNIQUE-ID-",
          "name": "YOUR_ACCOUNT_NAME",
          "addresses": {
              "ethereum": "0xYOUR_ETH_ADDR",
              "ronin": "0xYOUR_RONIN_ADDR",
              "__typename": "NetAddresses"
          },
          "__typename": "PublicProfile"
      }
  }
}

• Setup node: https://docs.roninchain.com/docs/developer-guide/running-non-validating-node

• Node methods: ronin blockchain methods (updated at 2022-08-23)

• GraphQL operations: https://axie-graphql.web.app/getting-started