{"id":18953169,"url":"https://github.com/0xpolygon/polygon2.0-economic-model","last_synced_at":"2025-09-05T14:33:31.411Z","repository":{"id":180739779,"uuid":"665519542","full_name":"0xPolygon/polygon2.0-economic-model","owner":"0xPolygon","description":"polygon2.0-economic-model","archived":false,"fork":false,"pushed_at":"2024-01-29T21:45:51.000Z","size":41273,"stargazers_count":14,"open_issues_count":1,"forks_count":6,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-08-17T04:33:10.745Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/0xPolygon.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-07-12T11:38:43.000Z","updated_at":"2025-07-09T16:07:27.000Z","dependencies_parsed_at":"2025-01-01T02:52:28.507Z","dependency_job_id":null,"html_url":"https://github.com/0xPolygon/polygon2.0-economic-model","commit_stats":null,"previous_names":["0xpolygon/polygon2.0-economic-model"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/0xPolygon/polygon2.0-economic-model","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xPolygon%2Fpolygon2.0-economic-model","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xPolygon%2Fpolygon2.0-economic-model/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xPolygon%2Fpolygon2.0-economic-model/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xPolygon%2Fpolygon2.0-economic-model/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/0xPolygon","download_url":"https://codeload.github.com/0xPolygon/polygon2.0-economic-model/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xPolygon%2Fpolygon2.0-economic-model/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273769922,"owners_count":25164890,"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-09-05T02:00:09.113Z","response_time":402,"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":[],"created_at":"2024-11-08T13:36:56.198Z","updated_at":"2025-09-05T14:33:26.344Z","avatar_url":"https://github.com/0xPolygon.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Polygon Economic Model\n\n[![Python package](https://github.com/CADLabs/ethereum-model/actions/workflows/python.yml/badge.svg)](https://github.com/CADLabs/ethereum-model/actions/workflows/python.yml)\n\nA simulation model of Polygon 2.0 to study validator incentives and ecosystem security. It forked from [ethereum-economic-model](https://github.com/CADLabs/ethereum-economic-model) and has been constructed using the open-source Python library [radCAD](https://github.com/CADLabs/radCAD), which is an enhancement of [cadCAD](https://cadcad.org).\n\n\n\n## Environment Setup\n\n1. Clone or download the Git repository: `git clone https://github.com/0xPolygon/polygon2.0-economic-model.git` or using GitHub Desktop\n2. Set up your development environment using one of the following three options:\n\n### Option 1: Anaconda Development Environment\n\nThis option guides you through setting up a cross-platform, beginner-friendly (yet more than capable enough for the advanced user) development environment using Anaconda to install Python 3 and Jupyter. There is also a video that accompanies this option and walks through all the steps: [Model Quick-Start Guide](https://www.cadcad.education/course/masterclass-ethereum)\n\n1. Download [Anaconda](https://www.anaconda.com/products/individual)\n2. Use Anaconda to install Python 3\n3. Set up a virtual environment from within Anaconda\n4. Install Jupyter Notebook within the virtual environment\n5. Launch Jupyter Notebook and open the [environment_setup.ipynb](environment_setup.ipynb) notebook in the root of the project repo\n6. Follow and execute all notebook cells to install and check your Python dependencies\n\n### Option 2: Custom Development Environment\n\nThis option guides you through how to set up a custom development environment using Python 3 and Jupyter.\n\nPlease note the following prerequisites before getting started:\n* Python: tested with versions 3.7, 3.8, 3.9\n* NodeJS might be needed if using Plotly with Jupyter Lab (Plotly works out the box when using the Anaconda/Conda package manager with Jupyter Lab or Jupyter Notebook)\n\nFirst, set up a Python 3 [virtualenv](https://docs.python.org/3/library/venv.html) development environment (or use the equivalent Anaconda step):\n```bash\n# Create a virtual environment using Python 3 venv module\npython3 -m venv venv\n# Activate virtual environment\nsource venv/bin/activate\n```\n\nMake sure to activate the virtual environment before each of the following steps.\n\nSecondly, install the Python 3 dependencies using [Pip](https://packaging.python.org/tutorials/installing-packages/), from the [requirements.txt](requirements.txt) file within your new virtual environment:\n```bash\n# Install Python 3 dependencies inside virtual environment\npip install -r requirements.txt\n```\n\nTo create a new Jupyter Kernel specifically for this environment, execute the following command:\n```bash\npython3 -m ipykernel install --user --name python-pol-model --display-name \"Python (Polygon Economic Model)\"\n```\n\nYou'll then be able to select the kernel with display name `Python (Polygon Economic Model)` to use for your notebook from within Jupyter.\n\nTo start Jupyter Notebook or Lab (see notes about issues with [using Plotly with Jupyter Lab](#Known-Issues)):\n```bash\njupyter notebook\n# Or:\njupyter lab\n```\n\nFor more advanced Unix/macOS users, a [Makefile](Makefile) is also included for convenience that simply executes all the setup steps. For example, to setup your environment and start Jupyter Lab:\n```bash\n# Setup environment\nmake setup\n# Start Jupyter Lab\nmake start-lab\n```\n\n### Option 3: Docker Development Environment\n\nAlternatively, you can set up your development environment using the pre-built Docker image with all the dependencies you need: [CADLabs Jupyter Lab Environment](https://github.com/CADLabs/jupyter-lab-environment)\n\n### Known Issues\n\n#### Plotly doesn't display in Jupyter Lab\n\nTo install and use Plotly with Jupyter Lab, you might need NodeJS installed to build Node dependencies, unless you're using the Anaconda/Conda package manager to manage your environment. Alternatively, use Jupyter Notebook which works out the box with Plotly.\n\nSee https://plotly.com/python/getting-started/\n\nYou might need to install the following \"lab extension\": \n```bash\njupyter labextension install jupyterlab-plotly@4.14.3\n```\n\n#### Windows Issues\n\nIf you receive the following error and you use Anaconda, try: `conda install -c anaconda pywin32`\n\u003e DLL load failed while importing win32api: The specified procedure could not be found.\n\n## Simulation Experiments\n\nThe [experiments/notebooks/Polygon_analysis](experiments/notebooks/Polygon_analysis) directory contains the most recent released cryptoeconomics simulation results. Specifically, [Polygon2.0 Economics v0.1](experiments/notebooks/Polygon_analysis/Polygon2.0_economics_v0.1.ipynb)presents a comprehensive analysis of the primary validator economics in the current model iteration. The simulation specs in this notebook is aligned with the POL whitepaper, ensuring that the simulation specifications are consistent with the official documentation.  The notebook shows\n* $POL token price trajectory\n* Three chains adoption rate scenarios\n* Validator yields over time per scenario\n* Validator profit break down analysis in both yields and dollars.\n\n\n\n\n\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xpolygon%2Fpolygon2.0-economic-model","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F0xpolygon%2Fpolygon2.0-economic-model","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xpolygon%2Fpolygon2.0-economic-model/lists"}