{"id":24054648,"url":"https://github.com/cardinal-cryptography/aleph-testnet","last_synced_at":"2025-09-15T16:31:38.609Z","repository":{"id":42001150,"uuid":"380170466","full_name":"Cardinal-Cryptography/Aleph-Testnet","owner":"Cardinal-Cryptography","description":"Aleph Zero Blockchain Helm chart with all the necessary tooling to run it locally.","archived":false,"fork":false,"pushed_at":"2023-05-10T10:43:11.000Z","size":202,"stargazers_count":6,"open_issues_count":0,"forks_count":9,"subscribers_count":7,"default_branch":"main","last_synced_at":"2023-05-10T11:39:52.203Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Cardinal-Cryptography.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-06-25T08:13:54.000Z","updated_at":"2023-05-10T11:39:52.203Z","dependencies_parsed_at":"2023-01-21T21:49:42.709Z","dependency_job_id":null,"html_url":"https://github.com/Cardinal-Cryptography/Aleph-Testnet","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cardinal-Cryptography%2FAleph-Testnet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cardinal-Cryptography%2FAleph-Testnet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cardinal-Cryptography%2FAleph-Testnet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cardinal-Cryptography%2FAleph-Testnet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cardinal-Cryptography","download_url":"https://codeload.github.com/Cardinal-Cryptography/Aleph-Testnet/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":233132528,"owners_count":18629753,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2025-01-09T03:49:13.858Z","updated_at":"2025-09-15T16:31:33.337Z","avatar_url":"https://github.com/Cardinal-Cryptography.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Aleph-Testnet\n\nAleph Zero Blockchain python scripts for running TestNet and DevNet.\n\n# Usage instructions\n\n- Create an account on AWS, set up credentials, and a default region as described [here](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#configuration).\n- Put keys for ssh in key_pairs (both the private key e.g. `aleph.pem` and its fingerprint (`aleph.fingerprint`))\n- Put SSL certificates in the nginx/cert directory (`self-signed.crt` and `self-signed.key`)\n- Make sure you have the aleph node binary inside a bin directory (needed for committee key generation step, `cp \u003c...\u003e/aleph-node/target/release/aleph-node bin/`)\n- Install packages needed for orchestrating experiments: GNU parallel, fabric, zip, unzip and Python 3 packages (with `pip install -r requirements.txt`).\n- Then, run `ipython -i shell.py`. This opens a shell with procedures orchestrating experiments.\n  The main procedure is `setup_nodes(n_processes, chain_type, regions, instance_type, volume_size, tag)` that prepares the `n_processes` spread\n  uniformly across specified `regions` using EC2 machines of `instance_type`. E.g.\n  `setup_nodes(4, 'dev', ['eu-west-1'], 't2.micro', 8, 'my_devnet')`.\n  After it succeeds, the `dispatch` task has to be run.\n- `run_task('some-task', tag=tag)` procedure calls the task `some_task` defined in `fabfile.py` for all machines that was created with the tag, note the change `s/-/_`,\n- `run_cmd(shell_cmd, tag)` dispatches the `shell_cmd` on all machines.\n- To terminate instances run `ti(tag)`.\n\n# TODOs\n\n- dockerize nginx ([nginx-proxy](https://github.com/nginx-proxy/nginx-proxy))\n- add [letsencrypt(https://github.com/nginx-proxy/acmenhu-companion)] bot image to obtain real SSL certificates (requires moving DNS to AWS)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcardinal-cryptography%2Faleph-testnet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcardinal-cryptography%2Faleph-testnet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcardinal-cryptography%2Faleph-testnet/lists"}