{"id":27859773,"url":"https://github.com/melonattacker/utility-token-price-simulator","last_synced_at":"2025-07-18T17:32:59.874Z","repository":{"id":38304297,"uuid":"285979154","full_name":"melonattacker/utility-token-price-simulator","owner":"melonattacker","description":"Utility Token Price Simulator is a simulator that simulates general token price when setting parameters. It is implemented based on the theory of \"Tokenomics: Dynamic Adoption and Valuation\".","archived":false,"fork":false,"pushed_at":"2021-04-18T01:23:56.000Z","size":243,"stargazers_count":54,"open_issues_count":0,"forks_count":8,"subscribers_count":2,"default_branch":"develop","last_synced_at":"2025-05-04T17:07:11.475Z","etag":null,"topics":["cryptoeconomics","utility-token"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/melonattacker.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":"2020-08-08T05:23:18.000Z","updated_at":"2025-05-04T10:41:35.000Z","dependencies_parsed_at":"2022-09-13T04:11:22.626Z","dependency_job_id":null,"html_url":"https://github.com/melonattacker/utility-token-price-simulator","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/melonattacker%2Futility-token-price-simulator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/melonattacker%2Futility-token-price-simulator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/melonattacker%2Futility-token-price-simulator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/melonattacker%2Futility-token-price-simulator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/melonattacker","download_url":"https://codeload.github.com/melonattacker/utility-token-price-simulator/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252369001,"owners_count":21736876,"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":["cryptoeconomics","utility-token"],"created_at":"2025-05-04T17:07:19.058Z","updated_at":"2025-05-04T17:07:19.694Z","avatar_url":"https://github.com/melonattacker.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Utility Token Price Simulator\nUtility Token Price Simulator is a simulator that simulates general token price when setting parameters. \u003cbr/\u003e It is implemented based on the theory of \"[Tokenomics: Dynamic Adoption and Valuation](https://bfi.uchicago.edu/wp-content/uploads/WP_2018-49.pdf)\". \u003cbr/\u003e CUI mode or GUI mode can be used.  \n\n\u003e You can't use this tool for speculative purposes.\n\n## GUI mode\n### Prerequisites\n- docker\n- docker-compose\n\n### Setup  \n\n```\n$ git clone https://github.com/melonattacker/utility-token-price-simulator.git\n$ cd utility-token-price-simulator\n$ docker-compose build\n$ docker-compose up  # may take some time...\n```\n\n### Simulation\n- Access `http://localhost:3000` through a browser.\n- Set the parameters and simulate.\n\n### Clean Up\nAfter the simulation, you should remove containers with the command below.\n\n```\n$ docker-compose down\n```\n\n## CUI mode \n### Prerequisites\n- python3 (It has been confirmed to work with version 3.7.3)\n\n### Setup\n\n```\n$ git clone https://github.com/melonattacker/utility-token-price-simulator.git\n$ cd utility-token-price-simulator\n$ pip install -r requirements.txt\n```\n\n### Simulation\n- Edit `config.json` to set the parameters.\n- After that, execute the following command.\n\n```\n$ python3 main.py\n```\n\n- Finally, `glaph.png` is output.\n\n## Parameters\nBelow is a description of the parameters.\n| Parameters | Type(python) | Default value | Description |\n|:---|:---:|:---:|:---:|\n|period | int | 365 | Period(days) you simulate the price.|\n|agents | int | 1000 | Number of people who may hold tokens. |\n|times | int | 1 | Number of simulations. |\n|beta | float | 0.3 | Related to number of users and price. |\n|chi | float | 1.0 | Scaling effect on Productivity. |\n|interest_rate | float | 0.05 | Risk-free rate. |\n|token_supply | int | 1000000000 | Token supply amount (fixed). |\n|mu (price) | float | 0.03 | Expected rate of return. |\n|initial_value (productivity) | float | 100.0 | Initial value of productivity. |\n|mu (productivity) | float | 0.02 | Average of productivity. |\n|sigma (productivity) | float | 2.0 | Standard deviation of productivity. |\n|mu (utility) | float | 1.0 | Average utility of agents. |\n|sigma (utility) | float | 10.0 | Standard deviation of the utility of the agents. |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmelonattacker%2Futility-token-price-simulator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmelonattacker%2Futility-token-price-simulator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmelonattacker%2Futility-token-price-simulator/lists"}