{"id":20975258,"url":"https://github.com/functionland/simulation","last_synced_at":"2025-05-14T14:30:38.261Z","repository":{"id":42673791,"uuid":"466351034","full_name":"functionland/simulation","owner":"functionland","description":"Fula Tokenomics Simulation","archived":false,"fork":false,"pushed_at":"2022-11-19T17:25:55.000Z","size":12042,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":4,"default_branch":"main","last_synced_at":"2023-03-05T14:40:02.692Z","etag":null,"topics":["fula","machinations","python","simulation","tokenomics"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","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/functionland.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":"2022-03-05T04:42:19.000Z","updated_at":"2023-02-19T02:15:39.000Z","dependencies_parsed_at":"2023-01-22T15:01:01.380Z","dependency_job_id":null,"html_url":"https://github.com/functionland/simulation","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/functionland%2Fsimulation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/functionland%2Fsimulation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/functionland%2Fsimulation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/functionland%2Fsimulation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/functionland","download_url":"https://codeload.github.com/functionland/simulation/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225297540,"owners_count":17452010,"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":["fula","machinations","python","simulation","tokenomics"],"created_at":"2024-11-19T04:41:38.635Z","updated_at":"2024-11-19T04:41:39.244Z","avatar_url":"https://github.com/functionland.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"There is more comprehensive machinations simulations, which includes both mining and torage rewards: https://github.com/functionland/simulation/blob/2a33dc9a07f47a3ae2b337c42587f5fec19e6d9d/Simulation%20FULA%20-%20final%20version.mp4\n\n# Simulation\n\nThis is Python simulation for mining part. There is a oublished version for the Python version here: https://fx.land/simulation\n\n### Fula Blockchain Simulation\n\n## Motivation\n\nTo develop a simulation model for the Mining rewards portion of the\nFunctionland project.\n\n## Basic Concept:\n\nA user would assess their current position financially and then make a decision\non whether or not to purchase the Functionland box. If they choose to purchase\nthe box, then we analyze the trade potential cost difference (and earnings!)\nthat a user would experience.\n\nSome key parameters being utilized:\n\n- Time (defaults to 1 year)\n- Cloud savings (Is derived from the amount not spent on the cloud storage\n  solutions)\n- Hardware buy in cost (A one time cost associated with getting the mining\n  device)\n- Power consumption cost (An additional cost, though not much, per month)\n- Tokens earned per end user (The reward earned by mining per user)\n  - Amount depends on the number of miners in the system\n  - Example: 50,000 miners a month and the reward is 200 tokens a month\n\nThese will then influence the modeling the rewards (money earned) from mining\nthe token over the course of a year.\n\n### Key Insights\n\n- We noticed on the default settings (after we had set miners to default to 1100) that the token rewards at the end of the year vs miners starts to cross\n  after 1 year.\n  - This was different from the relatively low margin of tokens mined at 10,000\n    miners and could be a good indicator of when people would want to join the\n    network.\n\n## Development\n\n### Requirements:\n\n- Python \u003e= 3.10\n- A virtual environment\n  - Currently using\n    [VirtualFish](https://virtualfish.readthedocs.io/en/latest/install.html)\n- Jupyter Labs or Jupyter notebook\n  - Download or use an extension inside of VScode\n- `ipykernel`\n\n### Project Execution\n\nTo run the Jupyter Notebook (and eventually python script files):\n\n1. Enable your virtual environment\n\n```vf new functionland\n\npip install requirements.txt\n\n```\n\nThen you will need to add the kernel to the notebook if you want the virtual\nenvironment to work properly:\n\n`python -m ipykernel install --user --name=functionland`\n\nDo note that the environment name of `functionland` can be replaced with\nanything else, just remember to stay consistent otherwise errors may arise.\n\nOnce we have the script files, those can be executed with the python run time\nwithout the need to load in that extra kernel (woo!).\n\n#### Running the Python Simulation\n\nThis was developed with Python 3.8 as the version so the way to run it on the\nCLI should follow:\n\n`python3 src/simulations/__init__.py`\n\nIf you use VScode (or similar) it should be a very similar execution step once\nyou are able to locate `main.py` or the `__init__.py` module.\n\n### Progress:\n\n- [x] Setup the initial system parameters\n- [x] Show the token price at $0.04\n- [x] Show the rewards for those who mined over the course of year as the token\n      value increases.\n- [x] Show the break even point (explicitly)\n- [x] Build the models in Python scripts\n- [x] Integrate with dashboard service\n- [x] Build out the UI of the dashboard\n\n### Issues / Bugs:\n\nAt this time, no known bugs are present.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffunctionland%2Fsimulation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffunctionland%2Fsimulation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffunctionland%2Fsimulation/lists"}