KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #cli #claude-code #codex #developer-tools #dsh-plugin #ai-agent #mcp #deepseek-harness #windows #open-source

burstcoin-jminer

★ 51 Open GitHub ↗

GPU assisted Proof of Capacity (PoC) Miner for Burstcoin (BURST)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# burstcoin-jminer
GPU assisted Proof of Capacity (PoC) Miner for Burstcoin (BURST)

1. edit 'jminer.properties' with text editor to configure miner
2. ensure java8 (64bit) and openCL driver/sdk is installed (java9 will not work)
3. execute 'java -jar -d64 -XX:+UseG1GC burstcoin-jminer-0.6.x-RELEASE.jar' or run the *.bat/*.sh file

> '-d64' to ensure 64bit java (remove for 32bit)
> '-XX:+UseG1GC' to free memory after round finished.

The miner is configured in a text-file named 'jminer.properties'.
This file has to be in the miner directory (same folder as '*.jar' file) 
> To get started, use one of the following examples. 
> The min. required settings for the different mining-modes.

# Pool-Setup

plotPaths=D:/,C:/,E:/plots,F:/plots
    numericAccountId=<YOUR NUMERIC ACCOUNT ID>
    poolServer=http://pool.com:port

# Solo-Setup

plotPaths=D:/,C:/,E:/plots,F:/plots
    poolMining=false
    passPhrase=<YOUR PASS PHRASE>

# POC1 and POC2 - NOTICE
jminer still supports POC1

only use one type, POC1 or POC2 on one drive ('plotPath'), mixed will be skipped for now.

ensure your POC2 plotfiles do not have staggersize in filename, or they will be treated like POC1.

POC1 filename: 'numericAccountId_startNonce_numberOfNonces_staggersize'
      POC2 filename: 'numericAccountId_startNonce_numberOfNonces'

# List of all properties
your 'jminer.properties' hasn't got to contain all properties listed here,
most of them are optional or there is a fallback/default value for it.

## Plot-Files

### plotPaths (required)
list of plot paths separated with , e.g. D:/,C:/,E:/plots,F:/plots (in one line)
the miner will treat every path as 'physical' drive and use one thread for it

plotPaths=D:/,C:/,E:/plots,F:/plots

### scanPathsEveryRound (default:true)  
optional 'true' will check 'plotPaths' for changed plot files on every round 'false' will check only on start/restart
if you are moving/creating plot-files while mining, it could be disabled

scanPathsEveryRound=false

### listPlotFiles (default:false)
optional ... list all plotFiles on start. If walletServer/soloServer is configured, 
it will show mined blocks and drive seeks/chunks of plotfile, too.

listPlotFiles=true

## Mining Mode and Target Deadline

### poolMining (default:true)
'true' for pool mining, 'false' for solo mining. ensure to configure the chosen mining-mode below.
For solo-mining you need to set

poolMining=false

### targetDeadline (optinal)
min. deadline to be committed. Will be used for pool mining if 'forceLocalTargetDeadline=true'

targetDeadline=750000

### forceLocalTargetDeadline (default:false)
'true' will force jminer to use the targetDeadline specified below, 
even if the pool says otherwise.  Only for pool mining! 'false' uses the default behavior for targetDeadline.
https://www.youtube.com/watch?v=9lwogE31SiI

forceLocalTargetDeadline=true

### dynamicTargetDeadline (default:false)
'true' will overrule 'targetDeadline' and 'forceLocalTargetDeadline' settings.
the miner will calculate the targetDeadline dynamic on poolMining.

dynamicTargetDeadline=true

## Pool-Mining
Ensure you already setup reward assignment http://localhost:8125/rewardassignment.html

### numericAccountId (required for pool)
first number in all plot-files

numericAccountId=xxxxxxxxxxxxxxx

### poolServer (required for pool)
format is inclusive protocol and port e.g. 'http://pool.com:8125'

poolServer=http://pool.com

### walletServer (optional)
define local or online wallet, to receive and show last winner!
if empty, winner feature will be just disabled.
format is inclusive protocol and port e.g. 'http://localhost:8125'
online use e.g. 'https://wallet.burst-team.us:8125'

walletServer=https://wallet.burst-team.us:8125

### winnerRetriesOnAsync (default:4)
number of retries to get winner from walletServer

winnerRetriesOnAsync=10

### winnerRetryIntervalInMs (default:4000)
time to wait until next retry to get winner from walletServer

winnerRetryIntervalInMs=250

## Solo-mining

### soloServer (default:http://localhost:8125)
**WARN!** soloServer should be http://localhost:8125 or http://127.0.0.1:8125
Solo means you send your PASS on commit results!

**DO NOT** try to use a online wallet or pool as Server!

soloServer=http://127.0.0.1:8125

### passPhrase (required for solo)
secretPhrase/password of solo mining burst-account

passPhrase=xxxxxxxxxxxxxx

## OpenCL
The miner uses openCL for most of the mining calculations, ensure it is setup correctly.
Instructions can be found e.g. here (thanks cryo):
https://github.com/bhamon/gpuPlotGenerator/blob/master/README.md
You could also use that instruction to find your platformId and deviceId if needed.
Since version 0.4.4 all available platforms and devices are listed on startup.

### useOpenCl (default:true)
Since version 0.6.0 openCL is optional. Thanks harry1453! 
Disable (useOpenCl=false) to only use CPU for mining.
Following settings are only relevant if openCL is used.

default=false

### platformId (default:0) 
id of openCL platform on your system. one platform may have multiple
devices, the miner currently uses just one (in general not the bottleneck)

platformId=0

### deviceId (default:0)
specifies the device used by OCLCecker, can be your first GPU,
in most cases it will not be 100% used. (depends on capacity)

deviceId=1

## Miner Internals

### refreshInterval (default:2000)
interval of asking wallet/pool for mining info (in ms), to check for new block

refreshInterval=2000

### updateMiningInfo (default=true)
restart round on new generationSignature for same round 
as long as equal miningInfo was not already finished
(it may happen that miningInfo changes, and changes back later)
false value will disable this feature

updateMiningInfo=false

### connectionTimeout (default:12000)
increase the 'connectionTimeout' on network problems. this timeout is used for all network requests.
if you use pool or online-wallet, the 12 sec. default may cause timeout on committing nonces 
or getting mining info etc.

connectionTimeout=12000

### debug (default:false)
setting 'debug' to true will log additional information of the mining process,
that are not related to mining, but to miner internals.

debug=true

### writeLogFile (default:false)
setting 'writeLogFile' to 'true' will write all logs from console to a file, too.
the name of that file can be specified by 'logFilePath'.

writeLogFile=true

### logFilePath (default:log/jminer.log.txt)
path (filename and optional directory, relative to miner location)

logFilePath=mylogs/jminier/log.txt

## Miner Appearance

### readProgressPerRound (default:9) 
defines how often the mining progress is shown per round
thats the 'xx% done ...' info.

readProgressPerRound=16

### byteUnitDecimal (default:true) 
switch between decimal units (true): TB/GB/MB (divided by 1000),
or binary units (false) TiB/GiB/MiB (divided by 1024) - https://en.wikipedia.org/wiki/Byte

byteUnitDecimal=false

### showDriveInfo (default:false)
set this to 'true' to show info about every drive on finish reading it,
this is useful to find the slow ones ... can help to optimize your setup.

showDriveInfo=true

e.g. you see in logs, that 'drive-c' and 'drive-d' slow down this mining setup:

read 'C:/data/drive-a' (3TB 958GB) in '28s 444ms'
    read 'C:/data/drive-b' (3TB 932GB) in '29s 114ms'
    read 'C:/data/drive-c' (3TB 996GB) in '35s 390ms'
    read 'C:/data/drive-d' (3TB 996GB) in '35s 685ms'

### logPatternConsole & logPatternFile
patterns for logfile and cosole output can be different
only needed if you want to configure your own log pattern e.g.
following would show colored time and message on console:

logPatternConsole=%blue(%d{HH:mm:ss.SSS}) %green(%msg%n)
    
only time and message for logfile:
    
    logPatternFile=%d{HH:mm:ss.SSS} %msg%n
    
For all options please read from docs: 
https://logback.qos.ch/manual/layouts.html#ClassicPatternLayout

### showSkippedDeadlines (default:true) 
set this to 'true' to show found deadlines below targetDeadline configure or 
provided by pool (overwriting the targetDeadline specified in jminer.properties)

showSkippedDeadlines=false

## Miner Memory Usage
 
### chunkPartNonces (default:960000)
staggerSize defines number of nonces per chunk.
the miner will split chunks in smaller pieces called chunkParts.
this makes sense, to save memory and optimize speed.
in the best case chunkPart#1 will be checked before chunkPart#2 is
completely read ... depending on the power of your GPU.
if staggersize is smaller than chunkPartNonces, staggersize will be used.
e.g. play with +/- 160000 steps

chunkPartNonces=960000

### readerThreads (default:0)
normally '0' means, the miner takes one thread per drive (plotPath) this is recommend.
choosing a other number of 'readerThreads' can be useful on memory issues.
For example, if you mine on 4 drives (plotPaths), you can reduce the memory usage
by setting 'readerThreads=2', this will reduce mining speed but save memory.

readerThreads=10

burstcoin-jminer

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README