{"id":20392368,"url":"https://github.com/wiseplat/open-wiseplat-pool-pps","last_synced_at":"2026-05-07T21:41:38.208Z","repository":{"id":122792634,"uuid":"130354836","full_name":"WISEPLAT/open-wiseplat-pool-pps","owner":"WISEPLAT","description":"Pay-Per-Share version Open Wiseplat Mining Pool","archived":false,"fork":false,"pushed_at":"2018-04-20T11:46:43.000Z","size":92,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-15T10:26:24.118Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","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/WISEPLAT.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-04-20T11:46:06.000Z","updated_at":"2023-05-22T19:06:53.000Z","dependencies_parsed_at":null,"dependency_job_id":"8bf0968f-9777-45f2-bbc9-501ce81beeb0","html_url":"https://github.com/WISEPLAT/open-wiseplat-pool-pps","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/WISEPLAT%2Fopen-wiseplat-pool-pps","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WISEPLAT%2Fopen-wiseplat-pool-pps/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WISEPLAT%2Fopen-wiseplat-pool-pps/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WISEPLAT%2Fopen-wiseplat-pool-pps/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/WISEPLAT","download_url":"https://codeload.github.com/WISEPLAT/open-wiseplat-pool-pps/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241941711,"owners_count":20046172,"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":[],"created_at":"2024-11-15T03:43:32.622Z","updated_at":"2026-05-07T21:41:33.184Z","avatar_url":"https://github.com/WISEPLAT.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Open Source Wiseplat Mining Pool\n\n**PPS version**\n\nPlease consider reading docs/GettingStarted.md first.\n\n### Features\n\n**This pool is being further developed to provide an easy to use pool for Wiseplat miners. This software is functional however an optimised release of the pool is expected soon. Testing and bug submissions are welcome!**\n\n* Support for HTTP and Stratum mining\n* Detailed block stats with luck percentage and full reward\n* Failover gwsh instances: gwsh high availability built in\n* Modern beautiful Ember.js frontend\n* Separate stats for workers: can highlight timed-out workers so miners can perform maintenance of rigs\n* JSON-API for stats\n\n#### Proxies\n\n* [Wise-Proxy](https://github.com/wiseplat/wise-proxy) HTTP proxy with web interface\n* [Stratum Proxy](https://github.com/wiseplat/wsh-proxy) for Wiseplat\n\n### Building on Linux\n\nDependencies:\n\n  * go \u003e= 1.6\n  * gwsh or parity\n  * redis-server \u003e= 2.8.0\n  * nodejs \u003e= 4 LTS\n  * nginx\n\n**I highly recommend to use Ubuntu 16.04 LTS.**\n\nFirst install  [go-wiseplat](https://github.com/wiseplat/go-wiseplat/wiki/Installation-Instructions-for-Ubuntu).\n\nClone \u0026 compile:\n\n    git config --global http.https://gopkg.in.followRedirects true\n    git clone -b PPS https://github.com/wiseplat/open-wiseplat-pool-pps.git\n    cd open-wiseplat-pool-pps\n    make\n\nInstall redis-server.\n\n### Running Pool\n\n    ./build/bin/open-wiseplat-pool-pps config.json\n\nYou can use Ubuntu upstart - check for sample config in \u003ccode\u003eupstart.conf\u003c/code\u003e.\n\n### Building Frontend\n\nInstall nodejs. I suggest using LTS version \u003e= 4.x from https://github.com/nodesource/distributions or from your Linux distribution or simply install nodejs on Ubuntu Xenial 16.04.\n\nThe frontend is a single-page Ember.js application that polls the pool API to render miner stats.\n\n    cd www\n\nChange \u003ccode\u003eApiUrl: '//example.net/'\u003c/code\u003e in \u003ccode\u003ewww/config/environment.js\u003c/code\u003e to match your domain name. Also don't forget to adjust other options.\n\n    npm install -g ember-cli@2.9.1\n    npm install -g bower\n    npm install\n    bower install\n    ./build.sh\n\nConfigure nginx to serve API on \u003ccode\u003e/api\u003c/code\u003e subdirectory.\nConfigure nginx to serve \u003ccode\u003ewww/dist\u003c/code\u003e as static website.\n\n#### Serving API using nginx\n\nCreate an upstream for API:\n\n    upstream api {\n        server 127.0.0.1:8080;\n    }\n\nand add this setting after \u003ccode\u003elocation /\u003c/code\u003e:\n\n    location /api {\n        proxy_pass http://api;\n    }\n\n#### Customization\n\nYou can customize the layout using built-in web server with live reload:\n\n    ember server --port 8082 --environment development\n\n**Don't use built-in web server in production**.\n\nCheck out \u003ccode\u003ewww/app/templates\u003c/code\u003e directory and edit these templates\nin order to customise the frontend.\n\n### Configuration\n\nConfiguration is actually simple, just read it twice and think twice before changing defaults.\n\n**Don't copy config directly from this manual. Use the example config from the package,\notherwise you will get errors on start because of JSON comments.**\n\n```javascript\n{\n  // Set to the number of CPU cores of your server\n  \"threads\": 2,\n  // Prefix for keys in redis store\n  \"coin\": \"wsh\",\n  // Give unique name to each instance\n  \"name\": \"main\",\n\n  \"proxy\": {\n    \"enabled\": true,\n\n    // Bind HTTP mining endpoint to this IP:PORT\n    \"listen\": \"0.0.0.0:8888\",\n\n    // Allow only this header and body size of HTTP request from miners\n    \"limitHeadersSize\": 1024,\n    \"limitBodySize\": 256,\n\n    /* Set to true if you are behind CloudFlare (not recommended) or behind http-reverse\n      proxy to enable IP detection from X-Forwarded-For header.\n      Advanced users only. It's tricky to make it right and secure.\n    */\n    \"behindReverseProxy\": false,\n\n    // Stratum mining endpoint\n    \"stratum\": {\n      \"enabled\": true,\n      // Bind stratum mining socket to this IP:PORT\n      \"listen\": \"0.0.0.0:8008\",\n      \"timeout\": \"120s\",\n      \"maxConn\": 8192\n    },\n\n    // Try to get new job from gwsh in this interval\n    \"blockRefreshInterval\": \"120ms\",\n    \"stateUpdateInterval\": \"3s\",\n    // Require this share difficulty from miners\n    \"difficulty\": 2000000000,\n    // PPS fee applied to each share submitted\n    \"miningFee\": 1.5,\n\n    /* Reply error to miner instead of job if redis is unavailable.\n      Should save electricity to miners if pool is sick and they didn't set up failovers.\n    */\n    \"healthCheck\": true,\n    // Mark pool sick after this number of redis failures.\n    \"maxFails\": 100,\n    // TTL for workers stats, usually should be equal to large hashrate window from API section\n    \"hashrateExpiration\": \"3h\",\n\n    \"policy\": {\n      \"workers\": 8,\n      \"resetInterval\": \"60m\",\n      \"refreshInterval\": \"1m\",\n\n      \"banning\": {\n        \"enabled\": false,\n        /* Name of ipset for banning.\n        Check http://ipset.netfilter.org/ documentation.\n        */\n        \"ipset\": \"blacklist\",\n        // Remove ban after this amount of time\n        \"timeout\": 1800,\n        // Percent of invalid shares from all shares to ban miner\n        \"invalidPercent\": 30,\n        // Check after after miner submitted this number of shares\n        \"checkThreshold\": 30,\n        // Bad miner after this number of malformed requests\n        \"malformedLimit\": 5\n      },\n      // Connection rate limit\n      \"limits\": {\n        \"enabled\": false,\n        // Number of initial connections\n        \"limit\": 30,\n        \"grace\": \"5m\",\n        // Increase allowed number of connections on each valid share\n        \"limitJump\": 10\n      }\n    }\n  },\n\n  // Provides JSON data for frontend which is static website\n  \"api\": {\n    \"enabled\": true,\n    \"listen\": \"0.0.0.0:8080\",\n    // Collect miners stats (hashrate, ...) in this interval\n    \"statsCollectInterval\": \"5s\",\n    // Purge stale stats interval\n    \"purgeInterval\": \"10m\",\n    // Fast hashrate estimation window for each miner from it's shares\n    \"hashrateWindow\": \"30m\",\n    // Long and precise hashrate from shares, 3h is cool, keep it\n    \"hashrateLargeWindow\": \"3h\",\n    // Collect stats for shares/diff ratio for this number of blocks\n    \"luckWindow\": [64, 128, 256],\n    // Max number of payments to display in frontend\n    \"payments\": 50,\n    // Max numbers of shifts to display in frontend\n    \"longShifts\": 30,\n    \"shortShifts\": 24,\n\n    /* If you are running API node on a different server where this module\n      is reading data from redis writeable slave, you must run an api instance with this option enabled in order to purge hashrate stats from main redis node.\n      Only redis writeable slave will work properly if you are distributing using redis slaves.\n      Very advanced. Usually all modules should share same redis instance.\n    */\n    \"purgeOnly\": false\n  },\n\n  // Check health of each gwsh node in this interval\n  \"upstreamCheckInterval\": \"5s\",\n\n  /* List of gwsh nodes to poll for new jobs. Pool will try to get work from\n    first alive one and check in background for failed to back up.\n    Current block template of the pool is always cached in RAM indeed.\n  */\n  \"upstream\": [\n    {\n      \"name\": \"main\",\n      \"url\": \"http://127.0.0.1:8747\",\n      \"timeout\": \"10s\"\n    },\n    {\n      \"name\": \"backup\",\n      \"url\": \"http://127.0.0.2:8747\",\n      \"timeout\": \"10s\"\n    }\n  ],\n\n  // This is standard redis connection options\n  \"redis\": {\n    // Where your redis instance is listening for commands\n    \"endpoint\": \"127.0.0.1:6379\",\n    \"poolSize\": 10,\n    \"database\": 0,\n    \"password\": \"\"\n  },\n\n  // Pay out miners using this module\n  \"payouts\": {\n    \"enabled\": false,\n    // Require minimum number of peers on node\n    \"requirePeers\": 25,\n    // Run payouts in this interval\n    \"interval\": \"12h\",\n    // Gwsh instance node rpc endpoint for payouts processing\n    \"daemon\": \"http://127.0.0.1:8747\",\n    // Rise error if can't reach gwsh in this amount of time\n    \"timeout\": \"10s\",\n    // Address with pool balance\n    \"address\": \"0x0\",\n    // Let gwsh to determine gas and gasPrice\n    \"autoGas\": true,\n    // Gas amount and price for payout tx (advanced users only)\n    \"gas\": \"21000\",\n    \"gasPrice\": \"50000000000\",\n    // Send payment only if miner's balance is \u003e= 0.5 Wise\n    \"threshold\": 500000000,\n    // Perform BGSAVE on Redis after successful payouts session\n    \"bgsave\": false\n  },\n  \n  // Maintain daily shifts of per-user statistics\n  \"shifts\": {\n    \"enabled\": false,\n\n    // Create long shifts in these intervals\n    \"longInterval\": \"24h\",\n    \"shortInterval\" : \"1h\",\n\n    // Keep shifts data during these intervals\n    \"keepLong\" : \"30d\",\n    \"keepShort\": \"24h\"\n  }\n}\n```\n\nIf you are distributing your pool deployment to several servers or processes,\ncreate several configs and disable unneeded modules on each server. (Advanced users)\n\nI recommend this deployment strategy:\n\n* Mining instance - 1x (it depends, you can run one node for EU, one for US, one for Asia)\n* Payouts instance - 1x (strict!)\n* Shifting instance - 1x (strict!)\n* API instance - 1x\n\n### Notes\n\n* Payouts are sequential, 1st tx go, 2nd waiting for 1st to confirm and so on. You can disable that in code. Carefully read `docs/PAYOUTS.md`.\n* Also, keep in mind that **payouts will halt in case of backend or node RPC errors**. In that case check everything and restart.\n* You must restart module if you see errors with the word *suspended*.\n* Don't run either payouts or shifting  module as part of mining node. Create separate configs for them, launch independently and make sure you have a single instance of each module running.\n\n### Alternative Wiseplat Implementations\n\nThis pool is tested to work with [Wshcore's Parity](https://github.com/wshcore/parity).\n\n### Credits\n\nOriginal code made by sammy007. Licensed under GPLv3.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwiseplat%2Fopen-wiseplat-pool-pps","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwiseplat%2Fopen-wiseplat-pool-pps","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwiseplat%2Fopen-wiseplat-pool-pps/lists"}