Git-Mirrors/monero
1
0
Fork 0
mirror of https://github.com/monero-project/monero.git synced 2025-12-27 20:54:36 -05:00
Code Issues Projects Releases Packages Wiki Activity
monero/tests/libwallet_api_tests/scripts/README.md
mj-xmr 412d7d643c
Merge 35e18c58ca into 48ad374b0d
2025-12-15 03:23:26 +00:00

2.5 KiB
Raw Blame History

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.