You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+55-33Lines changed: 55 additions & 33 deletions
Original file line number
Diff line number
Diff line change
@@ -1,59 +1,81 @@
1
1
# PHP-Pool
2
2
3
-
This project is intended to create a Gridcoin mining pool. This codebase is represented by https://open.grcpool.com and is the backbone of https://www.grcpool.com sites.
3
+
This open source project is intended to provide Gridcoin with a mining pool. This codebase is represented by https://open.grcpool.com and is the backbone of https://www.grcpool.com sites which have more functoinality and are available on another repo.
4
4
5
5
## Getting Started
6
6
7
7
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
8
8
9
-
### Software Prerequisites
9
+
### Prerequisites
10
10
11
-
PHP 7
12
-
MySQL Database
13
-
Gridcoin Daemon
14
-
NPM
15
-
Composer
11
+
- PHP 7
12
+
- MySQL
13
+
- Gridcoin Daemon
14
+
- Composer
16
15
17
-
### Initialization Commands
16
+
### Composer Initialization
18
17
19
18
PHP-Pool/composer install
20
19
20
+
### Constants File
21
+
22
+
There are several values in the classes/core/Constants.php file which will need your attention. For example:
23
+
24
+
- DATABASE_NAME => what your db name is
25
+
- DATABASE_SERVER => ip of your db
26
+
- BOINC_XML_LOG_DIR => where you want to store BOINC RPC logs
27
+
- BOINC_POOL_NAME => what you are calling your pool
28
+
- POOL_DOMAIN => domain name of your pool
29
+
- CURRENCY_ABBREV => currency abbreviation in case you are making this for another coin
30
+
- CURRENCY_NAME => currency name in case you are making this for another coin
31
+
- ADMIN_EMAIL_ADDRESS => your contact email address
32
+
- URL_SIGNING_KEY => you should sign your project urls with your own key please - this is public knowledge which is why it is in Constants and not Properties
33
+
- PROPERTY_FILE - where you want to store your property file
34
+
35
+
36
+
21
37
### Property Configuration
22
38
23
-
props.json
39
+
You will need to customize this file to suit your needs. Here are some sample fields...
40
+
24
41
```
25
42
{
26
43
"databaseName" : "",
27
44
"databaseServer" : "",
28
45
"databaseUser" : "",
29
46
"databasePassword" : "",
30
-
"emailServer" : "",
31
-
"emailPort" : "",
32
-
"emailSslPort" : "",
33
-
"emailUsername" : "",
34
-
"emailPassword" : "",
35
-
"googleCaptchaPublic" : "",
36
-
"googleCaptchaPrivate" : "",
37
-
"cacheDir" : "",
38
-
"daemon" : {
39
-
"path" : "/usr/bin/gridcoinresearchd",
40
-
"datadir" : "/home/bgb/.GridcoinResearch",
41
-
"testnet" : false
42
-
}
47
+
"emailServer" : "",
48
+
"emailPort" : "",
49
+
"emailSslPort" : "",
50
+
"emailUsername" : "",
51
+
"emailPassword" : "",
52
+
"googleCaptchaPublic" : "",
53
+
"googleCaptchaPrivate" : "",
54
+
"cacheDir" : "",
55
+
"daemon" : {
56
+
"path" : "/usr/bin/gridcoinresearchd",
57
+
"datadir" : "/home/bgb/.GridcoinResearch",
58
+
"testnet" : false
59
+
}
43
60
}
44
61
```
45
62
46
-
### Constants.php Configuration
47
-
48
-
```
49
-
TODO
50
-
```
51
-
52
63
### Database Data Congifuguration
53
64
54
-
```
55
-
TODO
56
-
```
65
+
The database schema is available at the root of the project. There are some settings which need to be customized in the "settings" table:
66
+
67
+
- TOTAL_PAID_OUT = 0
68
+
- CPID = ?? => pool's CPID
69
+
- MIN_OWE_AMOUNT = 1
70
+
- PAYOUT_FEE = .005
71
+
- MIN_ORPHAN_PAYOUT_ZERO_MAG = 1
72
+
- MIN_ORPHAN_PAYOUT_WITH_MAG = 5
73
+
- SEED = ?? => you should se this to how much GRC you start with staking
74
+
- GRC_CLIENT_ONLINE = 1 => set to zero if doing maintenance
75
+
- GRC_CLIENT_MESSAGE = '' => change to put banner on pages
76
+
- MIN_STAKE_BALANCE = 5 => amount needed to process owed
77
+
- HOT_WALLET_ADDRESS = ??
78
+
- POOL_WHITELIST_COUNT = ?? => tasks update this automatically
57
79
58
80
## Running the tests
59
81
@@ -66,7 +88,7 @@ Run All: grunt watch
66
88
67
89
## Scheduled Tasks
68
90
69
-
Scheduled tasks are located in /tasks and subdirectories. They can be executed for example:
91
+
Scheduled tasks are located in /tasks and subdirectories in their suggested intervals. They can be executed from a cron job for example:
70
92
71
93
```
72
94
for entry in /var/www/www.grcpool.com/tasks/_daily/*
@@ -75,7 +97,7 @@ for entry in /var/www/www.grcpool.com/tasks/_daily/*
0 commit comments