Skip to content
Mining Agent
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
cmake/Modules
docs add architecture pic Sep 15, 2016
install post-install script: add a usage May 11, 2018
src
test Add protocol negotiation to avoid hashrate lose when the server does … Oct 24, 2018
.gitignore support `make install` and deb package generate May 11, 2018
CMakeLists.txt support `make install` and deb package generate May 11, 2018
CMakeLists4EmbeddedSystem.txt
CMakeLists4Windows.txt
LICENSE Initial commit Jul 23, 2016
README-EmbeddedSystem.md rename cmake file and update docs Nov 23, 2016
README-Windows.md new optional feature: print logs to stdout with files. Feb 27, 2017
README-zh_CN.md Update README-zh_CN.md May 14, 2018
README.md
make.bat add make script for Windows. Mar 2, 2017

README.md

BtcAgent

Chinese Version/中文版本

BtcAgent is a kind of stratum proxy which use customize protocol to communicate with the pool. It's very efficient and designed for huge mining farm. And you still can find each miner at the pool.

  • With 10,000 miners:
    • Bandwith: less than 150kbps
    • Memory: less than 64MBytes
    • CPU: 1 Core

Support Platform:

Note:

  • This is still a testbed and work in progress, all things could be changed.
  • Now it's could only work with btcpool.

Architecture

Architecture

Install

  • OS: Ubuntu 14.04 LTS, 64 Bits
apt-get update
apt-get install -y build-essential cmake git

#
# install libevent
#
mkdir -p /root/source && cd /root/source
wget https://github.com/libevent/libevent/releases/download/release-2.0.22-stable/libevent-2.0.22-stable.tar.gz
tar zxvf libevent-2.0.22-stable.tar.gz
cd libevent-2.0.22-stable
./configure
make
make install

#
# install glog
#
mkdir -p /root/source && cd /root/source
wget https://github.com/google/glog/archive/v0.3.4.tar.gz
tar zxvf v0.3.4.tar.gz
cd glog-0.3.4
./configure && make && make install

#
# build agent
#
mkdir -p /work && cd /work
git clone https://github.com/btccom/btcagent.git
cd btcagent
mkdir -p build && cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make
cp ../src/agent/agent_conf.json .
mkdir -p log_btcagent

config json file example

{
    "agent_listen_ip": "0.0.0.0",
    "agent_listen_port": 3333,
    "pools": [
        ["us.ss.btc.com", 1800, "kevin"],
        ["us.ss.btc.com", 1800, "kevin"]
    ]
}
  • agent_listen_ip: Agent's listen IP address.
  • agent_listen_port: Agent's listen port, miners will connect to this port.
  • pools: pools settings which Agent will connect. You can put serval pool's settings here.
    • ["<stratum_server_host>", <stratum_server_port>, "<pool_username>"]

start / stop

cd /work/btcagent/build
#
# start
#
./agent -c agent_conf.json -l log_btcagent

#
# stop: `kill` the process pid or use `Control+C`
#
kill `pgrep 'agent'`

recommand to use supervisor to manage it

$ apt-get install -y supervisor
$ cp /work/btcagent/install/agent.conf /etc/supervisor/conf.d/
$ supervisorctl
supervisor> reread
agent: available
supervisor> update
agent: added process group
supervisor> status
agent                            RUNNING    pid 21296, uptime 0:00:09
supervisor> exit

listen on multi port

One agent only could listen to one port, if need to listen more than one port you need setup multi agent.

cd /work/btcagent/build

# mkdir log dir
mkdir log_btcagent_3334

# copy conf json for another port: 3334
cp agent_conf.json agent_conf_3334.json

agent_conf_3334.json looks like:

{
    "agent_listen_ip": "0.0.0.0",
    "agent_listen_port": 3334,
    "pools": [
        ["us.ss.btc.com", 1800, "kevin3334"]
    ]
}
# start
cd /work/btcagent/build
./agent -c agent_conf_3334.json -l log_btcagent_3334

if you use supervisor, you need another conf:

vim /etc/supervisor/conf.d/agent3334.conf

[program:agent3334]
directory=/work/btcagent/build
command=/work/btcagent/build/agent -c /work/btcagent/build/agent_conf_3334.json -l /work/btcagent/build/log_btcagent_3334
autostart=true
autorestart=true
startsecs=3
startretries=100

redirect_stderr=true
stdout_logfile_backups=5
stdout_logfile=/work/btcagent/build/log_btcagent_3334/agent_stdout.log

vim /etc/supervisor/supervisord.conf change or insert minfds in section [supervisord]:

[supervisord]
minfds=65535

restart supervisor: service supervisor restart.

than update supervisor:

$ supervisorctl
supervisor> reread
...
supervisor> update
...
supervisor> status
...
supervisor> exit

If you get Too many open files error, it means you need to increase the system file limits. Usually the default value is 1024 so you can't connect more than 1024 miners at one agent.

if you are using Ubuntu, vim /etc/security/limits.conf, add these lines:

root soft nofile 65535
root hard nofile 65535
* soft nofile 65535
* hard nofile 65535

You need to logout shell than login again. Check the value, should as below:

$ ulimit -Sn
65535
$ ulimit -Hn
65535
You can’t perform that action at this time.