Skip to content

Commit f805714

Browse files
committed
updated readme
1 parent 03cec43 commit f805714

File tree

1 file changed

+55
-33
lines changed

1 file changed

+55
-33
lines changed

README.md

Lines changed: 55 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -1,59 +1,81 @@
11
# PHP-Pool
22

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.
44

55
## Getting Started
66

77
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.
88

9-
### Software Prerequisites
9+
### Prerequisites
1010

11-
PHP 7
12-
MySQL Database
13-
Gridcoin Daemon
14-
NPM
15-
Composer
11+
- PHP 7
12+
- MySQL
13+
- Gridcoin Daemon
14+
- Composer
1615

17-
### Initialization Commands
16+
### Composer Initialization
1817

1918
PHP-Pool/composer install
2019

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+
2137
### Property Configuration
2238

23-
props.json
39+
You will need to customize this file to suit your needs. Here are some sample fields...
40+
2441
```
2542
{
2643
"databaseName" : "",
2744
"databaseServer" : "",
2845
"databaseUser" : "",
2946
"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+
}
4360
}
4461
```
4562

46-
### Constants.php Configuration
47-
48-
```
49-
TODO
50-
```
51-
5263
### Database Data Congifuguration
5364

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
5779

5880
## Running the tests
5981

@@ -66,7 +88,7 @@ Run All: grunt watch
6688

6789
## Scheduled Tasks
6890

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:
7092

7193
```
7294
for entry in /var/www/www.grcpool.com/tasks/_daily/*
@@ -75,7 +97,7 @@ for entry in /var/www/www.grcpool.com/tasks/_daily/*
7597
done
7698
```
7799

78-
## Sampple Apache Config
100+
## Sample Apache Config
79101

80102
```
81103
<VirtualHost *:8080>

0 commit comments

Comments
 (0)