Multi miner setup

Forwarding is a feature of the creepMiner that allows you to setup one creepMiner as a forwarder "master miner" that accepts requests from other miners "worker nodes", and pass them on to the destination and responsds the result back.

The main purpose of this feature is to divide the mining rig into a network of miners, where every miner has his own responsibility.

The bellow diagram is an example of the creepTeams test bed.

note every deadline submission and getmininginfo is a connection, so dependent on the amount of nodes in your setup you might need to set the activeConnections accordingly.

Howto

To use the forwarding feature of the creepMiner, you have to activate the local HTTP server in the configuration file:

"webserver" : {
   "activeConnections" : 256,
   "forwardMinerNames" : false,
   "start" : true,
   "url" : "http://0.0.0.0:8124"
}

Now you can connect other miners to the forwarding creepMiner:

"mining" : {
   "urls" : {
      "submission" : "http://<IP_OF_MASTER>:8124",
      "wallet" : "https://your.wallet.com:8125"
   }
}

Example

Let us say you have a mining network of 4 miners A, B, C, D, a Wallet W and a pool P.

A -> 5 TB
B -> 1 TB
C -> 2 TB
D -> 1 TB

These are the connections:

A -> P
A -> W
B -> A
C -> A
D -> B

    P
    ^
W < A < B < D
    ^
    C

Mining information

A forwarding miner will always send his own local mining information back. He can do this only if he got them from a pool or wallet before.

Submit nonces

When a miner finds a good nonce, it sends it to the pool that it is connected to. If the pool is a creepMiner master, the nonce gets forwarded until it reaches the actual pool or wallet.

Because of the split into chunks of mining plots it can happen, that not the whole mining capacity of the rig is transmitted.

If B in our example finds a nonce and sends it to A, the pool would get only the capacity of B (1 TB), while in real the capacity is bigger (9 TB).

Combined capacity

To solve the problem with the separate capacities they are remembered while a nonce is forwarded. Every creepMiner get an unique id based on the plot files he is reading. On every nonce submission he adds his id and his capacity to the nonce informations so the forwarding creepMiner can take this additional data and create a map of connected miners and their capacities.

Only connected miners that did a submission in the last 10 rounds are counted into the total sum of capacity.