{"id":13632391,"url":"https://github.com/oxheadalpha/teztnets","last_synced_at":"2025-07-22T11:03:37.030Z","repository":{"id":38845624,"uuid":"355600047","full_name":"oxheadalpha/teztnets","owner":"oxheadalpha","description":null,"archived":false,"fork":false,"pushed_at":"2024-02-01T00:06:24.000Z","size":3353,"stargazers_count":21,"open_issues_count":10,"forks_count":24,"subscribers_count":10,"default_branch":"main","last_synced_at":"2025-04-18T14:33:34.996Z","etag":null,"topics":["blockchain","dailynet","ghostnet","kubernetes","mondaynet","testnet","tezos"],"latest_commit_sha":null,"homepage":"https://teztnets.xyz","language":"TypeScript","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/oxheadalpha.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,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2021-04-07T15:45:07.000Z","updated_at":"2023-11-27T17:25:25.000Z","dependencies_parsed_at":"2023-02-19T10:45:21.379Z","dependency_job_id":"bfcce9aa-e4a1-4fc2-92d1-716553efc5dc","html_url":"https://github.com/oxheadalpha/teztnets","commit_stats":null,"previous_names":[],"tags_count":363,"template":false,"template_full_name":null,"purl":"pkg:github/oxheadalpha/teztnets","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oxheadalpha%2Fteztnets","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oxheadalpha%2Fteztnets/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oxheadalpha%2Fteztnets/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oxheadalpha%2Fteztnets/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oxheadalpha","download_url":"https://codeload.github.com/oxheadalpha/teztnets/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oxheadalpha%2Fteztnets/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266481732,"owners_count":23935938,"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","status":"online","status_checked_at":"2025-07-22T02:00:09.085Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"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","dailynet","ghostnet","kubernetes","mondaynet","testnet","tezos"],"created_at":"2024-08-01T22:03:02.140Z","updated_at":"2025-07-22T11:03:37.014Z","avatar_url":"https://github.com/oxheadalpha.png","language":"TypeScript","readme":"# Teztnets\n\nInfrastructure-as-code repo to activate and bootstrap Tezos testnets in a repeatable, automated way.\n\nSee [teztnets.com](https://teztnets.com) for the list of active Teztnets.\n\n## Features\n\n### Based on tezos-k8s\n\n[tezos-k8s](https://github.com/oxheadalpha/tezos-k8s) is a framework to deploy Tezos nodes or chains using Kubernetes and Helm.\n\nSee the [tezos-k8s documentation](https://github.com/oxheadalpha/tezos-k8s/blob/master/README.md)\n\n### Faucet support\n\nWe support the beacon-compatible Tezos Faucet.\n\n### Injection of contracts at genesis\n\nA [collection of raw Michelson contracts](https://github.com/oxheadalpha/teztnets/tree/main/bootstrap_contracts) can be optionally deployed in any Teztnet at genesis.\n\n### Injection of Smart Rollups at genesis\n\nRollups can be injected at genesis of your test chain. Teztnets supports extraction of the EVM Rollup from the Octez container, and its injection at a predetermined address.\n\n### Bootstrap baker and bootstrap p2p endpoint\n\nUpon deployment of a Teztnet, a genesis baker will run and its p2p and rpc endpoints will be exposed externally.\nExample:\n\n- p2p: `ghostnet.teztnets.com`\n- rpc `rpc.ghostnet.teztnets.com`\n\n### `--network` endpoint for Tezos node\n\nTezos nodes supports downloading of network specification from a json endpoint: `octez-node config init --network https://teztnets.com/\u003cTEZTNET NAME\u003e`\n\nThe Teztnet platform creates and exposes such endpoints.\n\n## Automate on Teztnets\n\nYou are encouraged to build automation to ensure your Tezos project keeps running with the future versions of Tezos shell and/or protocol.\n\nThis endpoint lists the current active testnets: [https://teztnets.com/teztnets.json](https://teztnets.com/teztnets.json)\n\n## Add new Teztnets or modify existing Teztnets\n\nEach Teztnet is defined within a subdirectory of the `/networks` directory in this repository. The Teztnet directory must contain the following files:\n\n- A Helm chart `values.yaml` file\n- Optionally, a Helm chart `faucet_values.yaml` file if deploying a faucet\n- Optionally, a submodule of tezos-k8s (in case you need an unreleased or custom version of the tezos-k8s software)\n\n### Helm chart values.yaml\n\nThe Helm chart values.yaml lets you customize your chain in many ways:\n\n- specify activation parameters, such as:\n  - list of genesis bakers\n  - list of accounts funded at genesis\n  - chains parameters (blocks per cycle, time between blocks...)\n- specify user-activated upgrades for hard-forks at a given length\n- specify the list of baker/endorser binaries to run.\n\nLook in any Teztnet directory's values.yaml file in [`/networks`](/networks) for reference as to how to configure your own Teztnet.\n\nThe [default Helm values.yaml](https://github.com/oxheadalpha/tezos-k8s/blob/master/charts/tezos/values.yaml) has details on every possible way to customize your teztnet.\n\n## Teztnets.com website\n\nThe website is created with Jekyll from Markdown files generated from Jinja templates based on Pulumi outputs.\n\nTo build the website locally, from the top-level dir of the repo:\n\n1. run `pulumi stack output networks \u003e networks.json`\n1. run `pulumi stack output teztnets \u003e teztnets.json`\n1. run `python teztnets_xyz_page/release.py`\n1. `cd target/release`\n1. run `bundle install`\n1. run `bundle exec jekyll serve`\n\nThe website will be rendered on `localhost:4000`.\n","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foxheadalpha%2Fteztnets","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foxheadalpha%2Fteztnets","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foxheadalpha%2Fteztnets/lists"}