{"id":30085496,"url":"https://github.com/harmony-one/harmony-tests","last_synced_at":"2026-06-20T12:33:02.116Z","repository":{"id":55024777,"uuid":"255834240","full_name":"harmony-one/harmony-tests","owner":"harmony-one","description":"Regression tests for Harmony","archived":false,"fork":false,"pushed_at":"2021-02-04T00:20:03.000Z","size":1011,"stargazers_count":1,"open_issues_count":1,"forks_count":2,"subscribers_count":17,"default_branch":"master","last_synced_at":"2025-08-09T00:53:42.664Z","etag":null,"topics":["blockchain","harmony","regression","staking","testing","transactions","yaml"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/harmony-one.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-04-15T07:09:05.000Z","updated_at":"2021-02-04T00:20:05.000Z","dependencies_parsed_at":"2022-08-14T09:20:44.635Z","dependency_job_id":null,"html_url":"https://github.com/harmony-one/harmony-tests","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/harmony-one/harmony-tests","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harmony-one%2Fharmony-tests","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harmony-one%2Fharmony-tests/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harmony-one%2Fharmony-tests/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harmony-one%2Fharmony-tests/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/harmony-one","download_url":"https://codeload.github.com/harmony-one/harmony-tests/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harmony-one%2Fharmony-tests/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34570537,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-20T02:00:06.407Z","response_time":98,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blockchain","harmony","regression","staking","testing","transactions","yaml"],"created_at":"2025-08-09T00:53:39.344Z","updated_at":"2026-06-20T12:33:02.097Z","avatar_url":"https://github.com/harmony-one.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# harmony-tests\nharmony-tests executes a set of test cases for testing that regular and staking transactions work properly on Harmony's blockchain.\n\nIt uses the harmony-tf testing framework under the hood.\n\n## Installation\n\n```\nrm -rf harmony-tests \u0026\u0026 mkdir -p harmony-tests \u0026\u0026 cd harmony-tests\nbash \u003c(curl -s -S -L https://raw.githubusercontent.com/harmony-one/harmony-tests/master/scripts/install.sh)\n```\n\n## Build/deploy\n\nIf you need to build/compile the tool from scratch:\n\nRegular build:\n`make all`\n\nStatic build:\n`make static`\n\nStatic build, package all testcases and upload everything to Amazon S3:\n`make upload-linux`\n\n(Static builds have only been tested on Linux)\n\n## Usage\n\n### Funding\n\n#### Existing address\nIf you already have a funded account, simply pass the address of that account using `--address`:\n\n- `./tests --network NETWORK --address YOUR_FUNDED_ADDRESS`\n\n#### Private keys\nIf you want to import and use private keys:\n\n- `mkdir -p keys/NETWORK/`\n- `nano keys/NETWORK/private_keys.txt`\n- paste your private keys and save the file\n\n#### Keystore files\nIf you want to import and use keystore files:\n\n- `mkdir -p keys/NETWORK/`\n- `cp -r PATH/TO/YOUR/KEYSTORE/FOLDER keys/NETWORK`\n\nHarmony TF will automatically identify keyfiles no matter what you call the folders or what the files are called - as long as they reside under `keys/NETWORK` they'll be identified.\n\n### Running tests\nTo run all test cases:\n`./tests --network NETWORK`\n\nTo run all test cases using an already funded address:\n`./tests --network NETWORK --address YOUR_FUNDED_ADDRESS`\n\nTo connect to custom defined RPC nodes configured using config.yml:\n`./tests --network NETWORK --mode custom --address YOUR_FUNDED_ADDRESS`\n\nTo connect to custom nodes using command line args:\n`./tests --network NETWORK --mode custom --nodes http://SHARD0NODEIP:9500,http://SHARD1NODEIP:9500 --address YOUR_FUNDED_ADDRESS`\n\n### Specific test cases\n\n#### Staking\n\n- Only run staking tests: `./tests --network NETWORK --test staking`\n- Only run staking -\u003e create validators: `./tests --network NETWORK --test staking/validators/create`\n- Only run staking -\u003e edit validators: `./tests --network NETWORK --test staking/validators/edit`\n- Only run staking -\u003e delegation: `./tests --network NETWORK --test staking/delegation/delegate`\n- Only run staking -\u003e undelegation: `./tests --network NETWORK --test staking/delegation/undelegate`\n\n#### Transactions\n- Only run tx tests: `./tests --network NETWORK --test transactions`\n- Only run tx -\u003e cross app shard tests: `./tests --network NETWORK --test transactions/cross_app_shard`\n- Only run tx -\u003e cross beacon shard tests: `./tests --network NETWORK --test transactions/cross_beacon_shard`\n- Only run tx -\u003e same app shard tests: `./tests --network NETWORK --test transactions/same_app_shard`\n- Only run tx -\u003e same beacon shard tests: `./tests --network NETWORK --test transactions/same_beacon_shard`\n\n### Exporting test data\nHarmony-tests currently supports exporting the test suite results as a CSV report:\n\n`./tests --network NETWORK --address YOUR_FUNDED_ADDRESS --export csv`\n\nJSON export is also planned, but not yet implemented.\n\n## Writing test cases\nTest cases are defined as YAML files and are placed in testcases/ - see this folder for existing test cases and how to impelement test cases.\n\nThere are some requirements for these files - this README will be updated with a list of these eventually :)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fharmony-one%2Fharmony-tests","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fharmony-one%2Fharmony-tests","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fharmony-one%2Fharmony-tests/lists"}