Ceres 联合收割机

Ceres是一款多挖软件，适用于Chia以及Chia的分支币种，比如Flax, Spare等等.

Ceres只需要运行一个Harvester，就可以同时多挖多个币种.

基础: Ceres是什么

Ceres运行一个单一的Harvester，便可以和多个币种的Farmer通讯，进行plot文件的挖币

如下图:

特点

只需运行一个Ceres Harvester，不需要为每一个币种单独运行一个Harvester
Ceres独立运行，不会跟Chia以及其他币种客户端冲突
支持Chia的OG plot，以及pool plot (单机plot, 以及矿池plot)
基于Chia源码，进行了尽可能少的改动
和只挖Chia一个币种相比，几乎等同的cpu和内存使用量
遵循Chia的异步设计模式，几乎不会影响Chia的挖币
配置简单，可以轻松扩展支持更多的币种
多平台支持，比如树莓派

版本适配

当前版本的Ceres，仅适配基于Chia 1.2 及之后的Farmer

目前大多数的币种客户端，都已经升级到Chia 1.2

安装

注意:

如果您安装过旧版的Ceres，或者您想完全重新安装Ceres, 需要先删除根目录下的.ceres目录，重新初始化

rm -rf ~/.ceres

Ceres的安装方式和Chia的安装方式相同

强烈建议您在安装Ceres之前，先阅读一下Chia的文档，尤其是这篇文章

Farming on many machines · Chia-Network/chia-blockchain Wiki · GitHub

下面开始全新安装

下载源代码

git clone https://github.com/hulatang/ceres-combineharvester.git

安装

cd ceres-combineharvester
sudo chmod +x install.sh
./install.sh

激活虚拟环境
```
. ./activate
```

初始化 Ceres

这一步很重要，请仔细阅读

初始化Ceres总共需要三步:

1. ceres init
这一步是初始化ceres目录结构

2. ceres init --coins
在配置好farmer的信息后，这一步初始化每个币种的目录

3. ceres generate_ssl
拷贝好每个币的ca文件夹到指定目录后，这一步生成加密ssl文件

完成以上三步初始化之后，就可以运行ceres了

下面我们详细描述每一个步骤

初始化目录

以下的 (venv) ➜ 代表命令行的提示符，表明您已处于虚拟环境中

请输入(venv) ➜后面的命令

(venv) ➜ ceres init

目录初始化成功之后， ceres会在用户根目录创建一个 .ceres 目录，看起来是这样子的

~ 代表您的用户根目录, 比如 /home/your_name/

(venv) ➜ tree ~/.ceres -L 4
.ceres
└── mainnet
   └── config
       ├── coins_config.yaml
       ├── config.yaml
       └── ssl
           ├── ca
           ├── daemon
           ├── farmer
           ├── full_node
           ├── harvester
           ├── introducer
           ├── timelord
           └── wallet

其中 coins_config.yaml是跟farmer相关的配置文件，这个文件配置好之后，以后可以直接拷贝到其他希望运行ceres的机器上相同的目录下。

2.配置挖矿相关信息

~/.ceres/mainnet/config/coins_config.yaml 这个文件很重要，跟挖矿相关的信息都在这个文件里进行配置.

coins_config.yaml 默认内容的头部，是这样的:

#  Edit your Farmer machine IP address below
#  Add coins name to it's farmer peer's coins part
#  Only Use coin names under coins supported section below
farmer_machine:
    - farmer_peer: 
        address: localhost
        coins:
          #- chia
          #- flax

# Farmer Peer SAMPLE
# You can add as many farmer peers as you have
# Note the indent

# - farmer_peer: 
#     address: 192.168.1.100
#     coins:
#       - flora
#       - kale

# - farmer_peer: 
#     address: 192.168.1.101
#     coins:
#       - spare
#       - chaingreen

# path of your plot files
# NOTE the indent and "-" symbol before your path
plot_directories: []
# - /path/to/your/plots_directory/

下面我们假设，您有两台电脑, 一共挖四种币，chia, flax, spare, kale, 分别为:

192.168.1.100, 币种为 chia, flax
192.168.1.200 币种为 spare, kale

修改coins_config.yaml中， farmer_machine的内容, 注意缩进和 - 符号

farmer_machine:

- farmer_peer: 
  address: 192.168.1.100
  coins:
    - chia
    - flax

- farmer_peer: 
  address: 192.168.1.200
  coins:
    - spare
    - kale

初始化挖矿配置

(venv) ➜ ceres init --coins

币种初始化成功后， .ceres目录看起来是这样的

(venv) ➜ tree ~/.ceres/mainnet -a -L 3
.ceres/mainnet
├── all_ca
│   ├── chia_ca
│   ├── flax_ca
│   ├── kale_ca
│   └── spare_ca
├── all_coins
│   ├── .chia
│   │   └── mainnet
│   ├── .flax
│   │   └── mainnet
│   ├── .kale
│   │   └── mainnet
│   └── .spare
│   └── mainnet
└── config
 ├── coins_config.yaml
 ├── config.yaml
 └── ssl
 ├── ca
 ├── daemon
 ├── farmer
 ├── full_node
 ├── harvester
 ├── introducer
 ├── timelord
 └── wallet

其中， all_ca文件夹是下一步用来存放每个币种的ca文件夹的，all_coins里面的内容不需要用户配置

拷贝每个币种的ca文件夹

以chia为例

将 chia所在farmer机器下， ~/.chia/mainnet/config/ssl/ca 文件夹，拷贝到 ~/.ceres/mainnet/all_ca/chia_ca目录下

scp -r username@192.168.1.100:~/.chia/mainnet/config/ssl/ca ~/.ceres/mainnet/all_ca/chia_ca

拷贝每一个币种的ca文件夹到all_ca目录下对应的文件夹

拷贝完成后， ~/.ceres/mainnet/all_ca目录看起来是这样子的

.ceres/mainnet
├── all_ca
│   ├── chia_ca
│   │   └── ca
│   ├── flax_ca
│   │   └── ca
│   ├── kale_ca
│   │   └── ca
│   └── spare_ca
│       └── ca

生成ssl加密文件
```
(venv) ➜ ceres generate_ssl
```

ceres配置完成！

配置Ceres日志级别

运行ceres之前，您可以选择ceres log的日志级别 , 默认设置遵循chia, 为warning.

日志级别的配置文件是 ~/.ceres/mainnet/config/config.yaml

注意:

日志级别的配置文件是 config.yaml

挖币相关配置文件为 coins_config.yaml

打开配置文件

vim ~/.ceres/mainnet/config/config.yaml

修改log_level

log_level: "DEBUG"
# Controls logging of all servers (harvester, farmer, etc..). Each one can be overriden.

添加plot文件所在目录

plot目录的配置位置，是在 ~/.ceres/mainnet/config/coins_config.yaml 中的 plot_directories

默认情况下

#path of your plot files
plot_directories: []

添加您自己的plot文件夹,

注意缩进和 - 符号

plot_directories:

- /home/your/plot/path/0001

- /home/your/plot/path/0002

- /home/your/plot/path/0003

运行Ceres

(venv) ➜ ceres start harvester -r

运行成功后，运行如下命令查看日志信息

tail -f ~/.ceres/mainnet/log/debug.log | grep ceres.harvester

如果运行成功，可以看到如下信息

harvester ceres.harvester.harvester: INFO     (flax)     : 0 plots were eligible for farming 5c63a7238a... Found 0 proofs. Time: 0.00012 s. Total 20 plots
harvester ceres.harvester.harvester: INFO     (chia)     : 0 plots were eligible for farming 1734aefc18... Found 0 proofs. Time: 0.00012 s. Total 20 plots
harvester ceres.harvester.harvester: INFO     (flax)     : 2 plots were eligible for farming 5c63a7238a... Found 0 proofs. Time: 0.00012 s. Total 20 plots
harvester ceres.harvester.harvester: INFO     (chia)     : 1 plots were eligible for farming 1734aefc18... Found 0 proofs. Time: 0.00012 s. Total 20 plots
harvester ceres.harvester.harvester: INFO     (spare)    : 0 plots were eligible for farming 5c63a7238a... Found 0 proofs. Time: 0.00011 s. Total 20 plots
harvester ceres.harvester.harvester: INFO     (kale)     : 1 plots were eligible for farming 1734aefc18... Found 0 proofs. Time: 0.00009 s. Total 20 plots

币种的名字

请务必使用配置文件中默认的名字

打开coins_config.yaml配置文件

vim ~/.ceres/mainnet/config/coins_config.yaml

可以使用的名字，在文件的下部

coin_names:
  - chia
  - flax
  - spare
  - silicoin
  - flora 
  - socks 
  - apple 
  - kale 
  - greendoge 
  - tad 
  - dogechia
  - maize 
  - wheat
  - taco
  - covid
  - melati
  - cactus
  - hddcoin
  - avocado
  - sector
  - nchain
  - btcgreen
  - cannabis
  - scam
  - fork
  - olive
  - pipscoin
  - beer
  - cunt
  - littlelambocoin
  - stor
  - beet
  - lotus
  - mint
  - kiwi
  - mogua
  - tranzact
  - peas
  - salvia
  - staicoin
  - taco
  - melati
  - cryptodoge
  - venidium
  - goldcoin
  - skynet (需要修改farmer, changelog里面有详细说明)

添加币种

要添加远端机器和币种，把币种的名字添加到配置文件中对应的farmer_peer下面

配置顺序如下：

首先，停止ceres

(venv) ➜ ceres stop all -d

接下来

修改 coins_config.yaml文件，位置是 ~/.ceres/mainnet/config/coins_config.yaml

比如给 192.168.1.100添加 silicoin

 farmer_machine:
     - farmer_peer: 
         address: 192.168.1.100
         coins:
           - chia
           - flax
           - silicoin  <--- 把silicoin添加到这里

运行币种初始化
```
(venv) ➜ ceres init --coins
```

拷贝远端机器的silicoin的ca文件夹

scp -r username@192.168.1.100:~/.silicoin/mainnet/config/ssl/ca ~/.ceres/mainnet/all_ca/silicoin_ca

生成ssl文件
```
(venv) ➜ ceres generate_ssl
```

停止ceres, 重启ceres

(venv) ➜ ceres stop all -d
(venv) ➜ ceres start harvester -r

注意:

~/.ceres/mainnet 下的 all_ca目录，一旦您把所有的ca文件夹都拷贝完成了，这个all_ca文件夹，可以直接拷贝的其他需要运行ceres的机器上，目标目录为 .ceres/mainnet/
~/.ceres/mainnet/config文件夹下的 coins_config.yaml文件，也可以直接复制到另一台需要运行ceres的机器上

另外一台ceres机器，拷贝上上述文件夹后，顺序运行如下命令

(venv) ➜ ceres init
(venv) ➜ ceres init --coins
(venv) ➜ ceres generate_ssl
(venv) ➜ ceres start harvester -r

如何升级Ceres:

# update ceres
git pull origin main
(venv) ➜ ceres update

# 按照添加币种部分的说明 添加你的配置信息

# restart ceres
(venv) ➜ ceres stop all -d
(venv) ➜ ceres start harvester -r

注意: 拉取新的代码之后，一定要运行 ceres update，才能完成升级

Windows使用方法:

下载ceres.zip, 解压缩，在cmd/powershell/windows terminal中执行 ceres.exe,

使用流程和上面的linux相同

Ceres cli

ceres farmers:

Ceres通过这个命令来管理需要通信的farmer

可以通过 ceres farmers -h 查看

ceres farmers 支持的命令有:

Commands:
  add     Add farmer peers and coins
  remove  Remove farmer peers and coins
  show    Show farmers peers

ceres farmers show

显示当前您已经添加的farmer信息

No conflict under Farmer Machine
--------------------------------------------------
All Farmer Peers:
Famer Peer
    Address: 192.168.1.100
    coins: ['chia', 'flax']

Famer Peer
    Address: 192.168.1.101
    coins: ['spare', 'kale']

--------------------------------------------------

ceres farmers add

添加farmer和币中,

--host 指定farmer的ip

-c 指定币名

-c 可以多次使用，以便一次性添加多个币种

示例:

ceres farmers add --host 192.168.1.100 -c chia -c flax

ceres farmers remove

删除币名

--host 指定farmer的ip

-c 指定币名

-c 可以多次使用，以便一次性删除多个币种

示例:

ceres farmers remove --host 192.168.1.231 -c chia -c flax

ceres farmers会检测不支持的币名, 错误的币名,以及有可能出现的重复farmer ip以及币名，供您参考

ChangeLog

2021-11-17

添加新的币种:

kujenga
shibgreen

2021-11-15

添加新的币种:

ethgreen
melon
rolls

添加ceres cli: ceres famers

ceres添加farmer端不需要手动修改coins_config.yaml文件了

具体使用方法，请查看上面 ceres cli章节
添加ceres cli: ceres plots add ，以后可以通过命令行来添加plots文件夹
修改了一个rpc端口bug: 不会再出现rpc 8560错误
默认log_level改为debug, 不用再手动修改了

2021-10-30

修复了一个bug, 挖币很多的时候，对效率的影响
skynet 主网支持，需要修改skynet farmer的代码，具体看下面

2021-10-21

Windows客户端0.0.2
修改了coins_config.yaml的格式, 以便windows下可以正确识别
添加新币: skynet

注意:

由于Skynet的Farmer代码修改的有问题，如果要用ceres挖skynet，需要修改一下skynet Farmer的代码

我会向skynet作者发一个pull request.

这个问题是skynet修改chia代码的时候，给Farmer发送到harvester添加了冗余参数，注释掉不会有任何影响，已经测试过！

Skynet Farmer代码有两处需要注释掉:

skynet-blockchain/blob/main/skynet/farmer/farmer_api.py

第438行附近, 把new_signage_point.timelord_reward_puzzle_hash, 这行注释掉

message = harvester_protocol.NewSignagePointHarvester(
            new_signage_point.challenge_hash,
            new_signage_point.difficulty,
            new_signage_point.sub_slot_iters,
            new_signage_point.signage_point_index,
            new_signage_point.challenge_chain_sp,
         #   new_signage_point.timelord_reward_puzzle_hash,
            pool_difficulties,
        )

skynet-blockchain/blob/main/skynet/protocols/harvester_protocol.py

第40行附近, 把timelord_reward_puzzle_hash: bytes32注释掉

@dataclass(frozen=True)
@streamable
class NewSignagePointHarvester(Streamable):
    challenge_hash: bytes32
    difficulty: uint64
    sub_slot_iters: uint64
    signage_point_index: uint8
    sp_hash: bytes32
    # timelord_reward_puzzle_hash: bytes32
    pool_difficulties: List[PoolDifficulty]

2021-10-19

Windows 客户端 0.0.1

修改了venidium的参数

2021-10-18 添加新的币种:

venidium
goldcoin
aedgecoin

2021-10-13

添加支持的币种:

olive
pipscoin
beer
cunt
littlelambocoin
stor
beet
lotus
mint
kiwi
mogua
tranzact
peas
salvia
staicoin
taco
melati
cryptodoge

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

README_ceres_0.2_ch.md

README_ceres_0.2_ch.md

Ceres 联合收割机

基础: Ceres是什么

特点

版本适配

安装

初始化 Ceres

配置Ceres日志级别

添加plot文件所在目录

运行Ceres

币种的名字

添加币种

注意:

如何升级Ceres:

Windows使用方法:

Ceres cli

ceres farmers:

ceres farmers show

ceres farmers add

ceres farmers remove

ChangeLog

Files

README_ceres_0.2_ch.md

Latest commit

History

README_ceres_0.2_ch.md

File metadata and controls

Ceres 联合收割机

基础: Ceres是什么

特点

版本适配

安装

初始化 Ceres

配置Ceres日志级别

添加plot文件所在目录

运行Ceres

币种的名字

添加币种

注意:

如何升级Ceres:

Windows使用方法:

Ceres cli

ceres farmers:

ceres farmers show

ceres farmers add

ceres farmers remove

ChangeLog