monero-scripts 0.1.4

Get Monero meta data from Monero source code files.

Monero scripts

Get Monero project meta information.

These tools extract information from parts of the Monero project source code files.

Imports:

• from monero_scripts import get_monero_hard_fork_info
• from monero_scripts import get_monero_seed_nodes
• from monero_scripts import connect_to_node
• from monero_scripts.connect_to_node import try_to_connect_keep_errors

get_monero_hard_fork_info.py

Gets past hard fork dates, versions and information.

Goal:

• Get monero hard fork dates from /src/hardforks/hardforks.cpp.

How to:

• For default values and how to use the tool
  • python -m monero_scripts.get_monero_hard_fork_info --help
• Current master branch:
  • python -m monero_scripts.get_monero_hard_fork_info
  • python -m monero_scripts.get_monero_hard_fork_info --branch master
• It is also possible to set the branch name as environment variable: PROJECT_BRANCH_NAME.
  • PROJECT_BRANCH_NAME=master python get_monero_hard_fork_info.py
• python -m monero_scripts.get_monero_hard_fork_info --branch release-v0.11.0.0

      version 1 ['Apr 18 2014 UTC', '1', '1341378000']
      version 2 ['Mar 20 2016 UTC', '1009827', '1442763710']
      version 3 ['Sep 24 2016 UTC', '1141317', '1458558528']
      version 4 ['Jan 05 2017 UTC', '1220516', '1483574400']
      version 5 ['Apr 15 2017 UTC', '1288616', '1489520158']
      version 6 ['Sep 16 2017 UTC', '1400000', '1503046577']
  

• python -m monero_scripts.get_monero_hard_fork_info --branch release-v0.12

      ...
      version 7 ['Apr 06 2018 UTC', '1546000', '1521303150']
  

• python -m monero_scripts.get_monero_hard_fork_info --branch release-v0.13

      ...
      version 8 ['Oct 18 2018 UTC', '1685555', '1535889547']
      version 9 ['Oct 19 2018 UTC', '1686275', '1535889548']
      version 10 ['Mar 09 2019 UTC', '1788000', '1549792439']
      version 11 ['Mar 10 2019 UTC', '1788720', '1550225678']
  

• It is possible to select the Monero network (mainnet, testnet, stagenet)
  • python -m monero_scripts.get_monero_hard_fork_info --network stagenet
• It is possible to select a different Monero daemon
  • python -m monero_scripts.get_monero_hard_fork_info --daemon localhost
• It is possible to select a different Monero daemon port
  • python -m monero_scripts.get_monero_hard_fork_info --port 18082
• Thee following two commands do the exact same thing:
  • python -m monero_scripts.get_monero_hard_fork_info --port 18082 --daemon mainnet.community.xmr.to
  • MONEROD_URL=mainnet.community.xmr.to MONEROD_RPC_PORT=18082 python -m monero_scripts.get_monero_hard_fork_info

The following environment variables can be used for the configuration:

env var	description	cli option
PROJECT_BRANCH_NAME	Branch (monero-project on github) to extract hard fork info from.	--branch
MONERO_NETWORK	Monero network (mainnet, stagnet, testnet) to get hard fork info for.	--network
MONEROD_URL	Monero daemon url.	--daemon
MONEROD_RPC_PORT	Monero daemon port.	--port

In case the daemon shuold not be reachable (e.g. timeout, connection error, etc.), the result will be missing the date information:

Version 1 ['---', '1', '1341378000']
Version 2 ['---', '1009827', '1442763710']
Version 3 ['---', '1141317', '1458558528']
Version 4 ['---', '1220516', '1483574400']
Version 5 ['---', '1288616', '1489520158']
Version 6 ['---', '1400000', '1503046577']
Version 7 ['---', '1546000', '1521303150']
Version 8 ['---', '1685555', '1535889547']
Version 9 ['---', '1686275', '1535889548']
Version 10 ['---', '1788000', '1549792439']
Version 11 ['---', '1788720', '1550225678']
Version 12 ['---', '1978433', '1571419280']

get_monero_seed_nodes.py

Gets Monero seed node IPs.

Goal:

• Get monero seed nodes from /src/p2p/net_node.inl.

How to:

• For default values and how to use the tool
  • python get_monero_seed_nodes.py --help
• Current master branch:
  • python get_monero_seed_nodes.py
  • python get_monero_seed_nodes.py --branch master
• It is also possible to set the branch name as environment variable: PROJECT_BRANCH_NAME.
  • PROJECT_BRANCH_NAME=master python get_monero_seed_nodes.py
• python get_monero_seed_nodes.py --branch release-v0.11.0.0

      testnet ['212.83.175.67:28080', '5.9.100.248:28080', '163.172.182.165:28080', '195.154.123.123:28080', '212.83.172.165:28080', '195.154.123.123:28080', '212.83.172.165:28080']
      mainnet ['107.152.130.98:18080', '212.83.175.67:18080', '5.9.100.248:18080', '163.172.182.165:18080', '161.67.132.39:18080', '198.74.231.92:18080']
  

• python get_monero_seed_nodes.py --branch release-v0.15

      testnet ['212.83.175.67:28080', '5.9.100.248:28080', '163.172.182.165:28080', '195.154.123.123:28080', '212.83.172.165:28080', '192.110.160.146:28080']
      stagenet ['162.210.173.150:38080', '162.210.173.151:38080', '192.110.160.146:38080']
      mainnet ['107.152.130.98:18080', '212.83.175.67:18080', '5.9.100.248:18080', '163.172.182.165:18080', '161.67.132.39:18080', '198.74.231.92:18080', '195.154.123.123:18080', '212.83.172.165:18080', '192.110.160.146:18080']
  

• It is possible to select the Monero network (mainnet, testnet, stagenet)
  • python get_monero_seed_nodes.py --network stagenet
  • By default seed nodes for all network modes are returned.

The following environment variables can be used for the configuration:

env var	description	cli option
PROJECT_BRANCH_NAME	Branch (monero-project on github) to extract seed nodes from.	--branch
MONERO_NETWORK	Monero network (mainnet, stagnet, testnet) to get seed nodes info for.	--network

connect_to_node.py

This is a very simple script to just ping the seed nodes (IPs in general) in order to get at least some information about their public accessibility.

After importing the module:

from monero_scripts.connect_to_node import try_to_connect

, it can be used like this:

• try_to_connect((node_ip, node_port))
• try_to_connect("node_ip:node_port")