monero/tests/libwallet_api_tests/scripts

Running libwallet_api tests

Environment for the tests

• Running monero node, linked to private/public testnet. By default, tests expect daemon running at localhost:38081, can be overridden with environment variable TESTNET_DAEMON_ADDRESS=<your_daemon_address> Manual explaining how to run private testnet. It is benefitial to run the node with the --disable-rpc-ban option, because the test will be abusing the node.

• Running monero node, linked to mainnet. By default, tests expect daemon running at localhost:18081, can be overridden with environment variable MAINNET_DAEMON_ADDRESS=<your_daemon_address>

• Directory with pre-generated wallets (wallet_01.bin, wallet_02.bin,...,wallet_06.bin, some of these wallets might not be used in the tests currently). By default, tests expect these wallets to be in /var/monero/testnet_pvt. Directory can be overridden with environment variable WALLETS_ROOT_DIR=<your_directory_with_wallets>. Directory and files should be writable for the user running tests.

• The above environment variables can be conviniently modified and exported via the conf.sh script.

Preparation of WALLETS_ROOT_DIR

Ideally copy all the scripts and symlink the test executable into the directory pointed by WALLETS_ROOT_DIR variable and adjust your choices via the conf.sh script. In such scenario, uncomment the export WALLETS_ROOT_DIR=. line. From there, run the below scripts:

Generating test wallets

• create_wallets.sh - this script will create wallets (wallet_01.bin, wallet_02.bin,...,wallet_06.bin) in current directory. when running first time, the script will create a special wallet_m.bin miner wallet as well. This wallet should be used for mining and all test wallets supposed to be seed from this miner wallet.

• mining_start.sh and mining_stop.sh - helper scripts to start and stop mining on miner wallet.

• send_funds.sh - script for seeding test wallets. Please run this script when you have enough money on miner wallet.

Running the tests

• Before running the tests, you have to source the conf.sh script with: source conf.sh or just: . conf.sh within the same terminal.

• The particular tests can be executed using a Regex filter, for example: ./libwallet_api_tests --gtest_filter=WalletTest1.WalletShowsBalance.

• Execute ./libwallet_api_tests --gtest_list_tests to obtain the full list of available tests.