{"id":20208623,"url":"https://github.com/melvin0008/survey-token","last_synced_at":"2025-08-02T07:11:40.205Z","repository":{"id":80639318,"uuid":"122916555","full_name":"melvin0008/survey-token","owner":"melvin0008","description":null,"archived":false,"fork":false,"pushed_at":"2018-03-23T16:17:42.000Z","size":156,"stargazers_count":5,"open_issues_count":1,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-02T13:10:48.062Z","etag":null,"topics":["neo","neo-project"],"latest_commit_sha":null,"homepage":"https://www.youtube.com/watch?v=UaWMneJLy9U","language":"Python","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/melvin0008.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-02-26T05:12:25.000Z","updated_at":"2023-09-08T17:37:13.000Z","dependencies_parsed_at":null,"dependency_job_id":"5f3490ab-8d98-458f-999a-2af72d4a3bff","html_url":"https://github.com/melvin0008/survey-token","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/melvin0008/survey-token","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/melvin0008%2Fsurvey-token","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/melvin0008%2Fsurvey-token/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/melvin0008%2Fsurvey-token/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/melvin0008%2Fsurvey-token/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/melvin0008","download_url":"https://codeload.github.com/melvin0008/survey-token/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/melvin0008%2Fsurvey-token/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268348206,"owners_count":24236295,"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-08-02T02:00:12.353Z","response_time":74,"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":["neo","neo-project"],"created_at":"2024-11-14T05:36:22.596Z","updated_at":"2025-08-02T07:11:40.197Z","avatar_url":"https://github.com/melvin0008.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Survey - Token\n\n### Demo Video: \nhttps://www.youtube.com/watch?v=UaWMneJLy9U\n\n### Use-Case:\nHave you ever taken a survey or review and not been rewarded for it? With Survey token we remove the middleman like SurveyMonkey and G2Crowd and redistribute the money to people taking the survey and adding reviews. In the arena for survey marketplace there are two major stakeholders. The person/company creating the survey and the person taking the survey. Usually the survey creator creates a paid survey on survey monkey or G2Crowd annd the person taking the survey is rarely rewarded. \n\nSurvey Monkey is a billion dollar company and G2 Crowd is funded with 45M dollars. Very few surveyers/ reviewers are  rewarded in coupons. \n\nWith Survey token running on NEO, we incentivize surveyers with SUR token. SUR tokens are bought by the survey lister. \n\n\n### Flow:\nPerson/Company listing a survey would create a list of questions using the survey-frontend using surveyjs.\nOnce he/she completes it, he/she is asked to enter amount of NEO/GAS to transfer and number of people he/she wants to fill the survey.\n\nFor the sake of an example, lets say he/she sends 10 GAS and wants 100 people to fill the survey.\n\nAfter the surveyer fills the review he will receive 10/100 = 0.1 GAS worth of tokens.\n\nCurrently 1 GAS = 40 SUR Tokens\n          1 NEO = 100 SUR Tokens\n\n### Stack\n\n - Smart Contract: https://github.com/melvin0008/survey-token\n - Frontend: https://github.com/melvin0008/survey-frontend\n - Backend: https://github.com/melvin0008/survey-token/blob/master/api.py\n\n\n## Dapp Usage:\n\nTestNet Hash: 0x46486fc3149a9c4074d67421528c58da9d7f0285 -\u003e Latest\n\nCozNet Hash: 0xd4903b35332d2a652f126ea6a978c179994321b3 (Old one)\n\n### Functions available:\nName, symbol, decimals, balanceOf, transfer, transferFrom, totalSupply, approve and allowance and other NEX template functions.\n\nSince this is a market place where in there are two sides.\n - Surveyer\n - Survey Lister\n\n*After importing token to wallet*\nimport token 0x46486fc3149a9c4074d67421528c58da9d7f0285\n\nThe person creating the survey will invoke the function\n\n`testinvoke 0x46486fc3149a9c4074d67421528c58da9d7f0285 create_survey  [\"\u003csurvey_id\u003e\", \"\u003cnumber_of_people to distribute to\u003e\"] --attach-gas=\u003cGAS that will be redistributed\u003e`\n\nor\n\n`testinvoke Ox46486fc3149a9c4074d67421528c58da9d7f0285 create_survey  [“\u003csurvey_id\u003e”, \"\u003cnumber_of_people to distribute to\u003e\"] --attach-neo=\u003cNEO that will be redistributed\u003e`\n\nMake sure NEO is a whole number.\n\nSurvey Id: The id of the survey with question.\nNumber of people to distribute the assets\n\n`testinvoke 0x46486fc3149a9c4074d67421528c58da9d7f0285 reward  [\"\u003csurvey_id\u003e\", \"\u003caddress of surveyer\u003e\"]`\n\naddress of surveyer : will be the address of the person who will be rewarded.\n\n## Backend\nTo query the same from the backend setup the backend with\n\n1. Setup neo-python https://github.com/CityOfZion/neo-python/blob/master/README.rst\n\n2. Clone backend\n`git clone https://github.com/melvin0008/survey-token/` and create a copy this to neo-python folder\n\n3. Create DB\n`python contracts/utils/db_create.py`\n\n3. Run app\n` python contracts/api.py`\n\n4. Setup neon-wallet-db and private-net if you want to test it on private net.\n` https://gist.github.com/slipo/f18f1a0b5e6adb7b0bf172b93379d891`\n\n\nUsing Postman have access to few endpoints\n\n1. Get Version\n   `{APP_URL}/api/`\n\n2. Get Balance\n   `{APP_URL}/api/wallet/\u003cAddress\u003e`\n\n3. POST Survey\n   `{APP_URL}/api/survey/\n   body { json: JSON received from survey editor }`\n\n4. GET Survey\n   `{APP_URL}/api/survey/\u003csurveyid\u003e\n\n5. POST Get rewarded after survey\n   `{APP_URL}/api/reward\n   body { survey_id: \u003csurveyId\u003e, reward_address: \u003cAddress of the surveyer\u003e}`\n \n 6. POST Result of Survey\n   `{APP_URL}/api/result\n    body { survey_id: \u003csurveyId\u003e, json: \u003cResult Jsonn file\u003e}`\n   \n He/She will only be rewarded if survey id will have remaining tokens to redistribute.\n He/She can only take survey once. (TODO)\n \n Only survey metadata and transactions are stored in the blockchain.\n Survey questions and answers are stored in DB\n\n\n### Roadmap and TODO list:\n - [] Change Backend from sqllite to MongoDB\n - [] Improve maths for carrying out the free tokensale.\n - [] Add Results page for admin to check results (GET)\n \n \n ### For DAPP Competition:\n \n Changes made after 25th Feb:\n 1. Update to latest neo-python with python 3.6. Update neo-template too with this.\n 2. Work on frontend and backend of the the product.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmelvin0008%2Fsurvey-token","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmelvin0008%2Fsurvey-token","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmelvin0008%2Fsurvey-token/lists"}