-
Node v14+
-
You can run Jest directly from the CLI if it is globally available in your PATH:
yarn global add jest
yarn
yarn prepare-env-dev --mnemonic-faucet <mnemonic_phrase> --protocol <protocol_to_test>
- For more flags:
yarn prepare-env-dev --help
!!! On a local network, manual setup and startup of the feeder&&dispatcher is required before testing. Instructions for this can be found in our oracle-price-feeder repository and the name of the feeder key must be passed to the "--feeder-key" flag when running yarn prepare-env-local (here). For some of the test cases, it is necessary to choose a currency for which this feeder does not provide a price. By default, here in the tests, this is set to be the "STARS" currency. So when you configure the feeder, in the configuration file there, please remove this currency from the currencies section. An option is provided here to select and specify a currency other than "STARS" via the flag "--no-price-currency" when running yarn prepare-env-local.
yarn prepare-env-local --feeder-key "<feeder_key_name> "--protocol "<protocol_to_test>"
-
The 'reserve' account must have funds (in nolus native currency), so be sure to reflect this when starting a local network : /nolus-core/scripts/init-local-network.sh
-
For more flags:
yarn prepare-env-local --help
To run the tests, regardless of the exact currency, it is necessary to load the test wallet with all currencies supported by the system. On a local network for this purpose you can use the script below, or to do that manually.
!!! Before running the script, you have to fill in it the currencies with which you want the account to be funded. Look in the script for more.
!!! DEX network binary is required.
yarn run fund-main-account "<mnemonic_of_dex_account_you_have_preloaded>" "<address_of_dex_account_you_have_preloaded>" "<dex_network_name>" "<dex_node_url>" "<dex_binary_dir_path>" "<dex_home_dir>" "<dex_native_minimal_denom>" "<leaser_contract_address>" "<receiver_nolus_address>"
- There must also be a native currency balance on the DEX network for the account whose information is passed to the script
yarn test
- In manually/ can be found tests which require specific configuration to work as expected. They require to be run in isolation. The requirements can be found in the relevant files there.
Example of suitable values when testing:
{"data":{"config":{....,"lease_interest_rate_margin":40,"lease_position_spec":{"liability":{"initial":600,"healthy":830,"first_liq_warn":850,"second_liq_warn":865,"third_liq_warn":880,"max":900,"recalc_time":432000000000000},"min_asset":{"amount":"150","ticker":"<lpn>"},"min_transaction":{"amount":"1000","ticker":"<lpn>"}},"lease_interest_payment":{"due_period":1209600000000000,"grace_period":172800000000000},....}}}
{"data":{....,"price_config":{"min_feeders":500,"sample_period_secs":10,"samples_number":12,"discount_factor":750}}}
{"data":{....,"borrow_rate":{"base_interest_rate":100,"utilization_optimal":750,"addon_optimal_interest_rate":20},"min_utilization":0}}
{"data":{"cadence_hours":7200}}
tick_seconds = 60
between_tx_margin_seconds = 5
query_delivered_tx_tick_seconds = 15
....
poll_period_seconds = 60
between_tx_margin_seconds = 5
query_delivered_tx_tick_seconds = 15
....