Skip to content

@ping-ke ping-ke released this Sep 2, 2021

Disclaimer

This release involves consensus changes (explained below). To avoid wasting mining power, please upgrade the cluster to this release before Tuesday, Sep 14, 2021 00:00:00 AM GMT.

Updates

  • * Added support for EIP155, support using metamask to directly interact with quarkchain.
  • Various small fixes and improvements

(Those items listed with asterisk * mean they are consensus changes and would lead to forks if clients are not updated accordingly.)

Notes

To change miner coinbase address:

./change_coinbase.sh 1000000000000000000000000000000000000000

For downloading snapshots:

curl https://s3-us-west-2.amazonaws.com/qkcmainnet/data/`curl https://s3-us-west-2.amazonaws.com/qkcmainnet/data/LATEST`.tar.gz --output data.tar.gz

Snapshots in China:

curl https://s3.cn-north-1.amazonaws.com.cn/qkcmainnet-cn/data/`curl https://s3.cn-north-1.amazonaws.com.cn/qkcmainnet-cn/data/LATEST`.tar.gz --output data.tar.gz

Running cluster after modifying config:

# inside the container
python3 quarkchain/cluster/cluster.py --cluster_config <config>
or
./run_cluster.py

Network ID

1

GPU mining shard ID

Instructions for Ethash GPU mining

ethminer -U http://$CLUSTER_IP:38391 --shard-id $SHARD_ID --cuda-devices $GPU_ID --farm-recheck $TIME --coinbase $COINBASE_ADDRESS
  • CLUSTER_IP defines the IP for the Quarkchain cluster. If you want to try the one button quick mining, you can use fullnode.quarkchain.io or fullnode2.quarkchain.io.
  • --shard-id defines one specify shard to mine. shard id 1, 10001, 20001, 30001, 40001, 50001 are Ethash.
  • --cuda-devices defines specify GPUs to mine.
  • --farm-recheck defines check interval in milliseconds for changed work. For example 1000.
  • --coinbase defines your mining coinbase address. Please use 20 bytes address generated the same way as an Ethereum address.
  • -U is for the CUDA GPU and -G is for the AMD GPU.
Chain Shard Hash Algo Parameter for Ethminer shard ID
0 0 Ethash 1
1 0 Ethash 10001
2 0 Ethash 20001
3 0 Ethash 30001
4 0 Ethash 40001
5 0 Ethash 50001

CPU mining shard ID

Instructions for Qkchash CPU mining

./ethminer --farm http://$CLUSTER_IP:38391 --coinbase $COINBASE_ADDRESS -t <n> --shard-id $SHARD_ID
  • CLUSTER_IP defines the IP for the Quarkchain cluster. If you want to try the one button quick mining, you can use fullnode.quarkchain.io or fullnode2.quarkchain.io.
  • --shard-id defines one specify shard to mine. shard id 60001 and 70001 are Qkchash.
  • --coinbase defines your mining coinbase address. Please use 20 bytes address generated the same way as an Ethereum address.
  • -t limits number of CPU miners to n
Chain Shard Hash Algo Parameter for Ethminer shard ID
6 0 Qkchash 60001
7 0 Qkchash 70001

Download Docker Image

docker pull quarkchaindocker/pyquarkchain:mainnet1.5.0
Assets 2

@ping-ke ping-ke released this Sep 2, 2021

Disclaimer

Same as mainnet1.5.0 release but with transaction history switched on.

Download Docker Image

docker pull quarkchaindocker/pyquarkchain:mainnet-index1.5.0
Assets 2

@ninjaahhh ninjaahhh released this Aug 7, 2020

Disclaimer

This release potentially involves consensus changes. To avoid wasting mining power, please upgrade the cluster to this release as soon as possible.

Updates

  • * Fixes transaction receipt bundling for failed contract creation transaction
  • * Fixes a VM opcode implementation
  • Implements total token balance accounting method in JSONRPC
  • Various small fixes and improvements

(Those items listed with asterisk * mean they could lead to consensus disagreements if clients are not updated accordingly.)

Notes

To change miner coinbase address:

./change_coinbase.sh 1000000000000000000000000000000000000000

For downloading snapshots:

curl https://s3-us-west-2.amazonaws.com/qkcmainnet/data/`curl https://s3-us-west-2.amazonaws.com/qkcmainnet/data/LATEST`.tar.gz --output data.tar.gz

Snapshots in China:

curl https://s3.cn-north-1.amazonaws.com.cn/qkcmainnet-cn/data/`curl https://s3.cn-north-1.amazonaws.com.cn/qkcmainnet-cn/data/LATEST`.tar.gz --output data.tar.gz

Running cluster after modifying config:

# inside the container
python3 quarkchain/cluster/cluster.py --cluster_config <config>
or
./run_cluster.py

Network ID

1

GPU mining shard ID

Instructions for Ethash GPU mining

ethminer -U http://$CLUSTER_IP:38391 --shard-id $SHARD_ID --cuda-devices $GPU_ID --farm-recheck $TIME --coinbase $COINBASE_ADDRESS
  • CLUSTER_IP defines the IP for the Quarkchain cluster. If you want to try the one button quick mining, you can use fullnode.quarkchain.io or fullnode2.quarkchain.io.
  • --shard-id defines one specify shard to mine. shard id 1, 10001, 20001, 30001, 40001, 50001 are Ethash.
  • --cuda-devices defines specify GPUs to mine.
  • --farm-recheck defines check interval in milliseconds for changed work. For example 1000.
  • --coinbase defines your mining coinbase address. Please use 20 bytes address generated the same way as an Ethereum address.
  • -U is for the CUDA GPU and -G is for the AMD GPU.
Chain Shard Hash Algo Parameter for Ethminer shard ID
0 0 Ethash 1
1 0 Ethash 10001
2 0 Ethash 20001
3 0 Ethash 30001
4 0 Ethash 40001
5 0 Ethash 50001

CPU mining shard ID

Instructions for Qkchash CPU mining

./ethminer --farm http://$CLUSTER_IP:38391 --coinbase $COINBASE_ADDRESS -t <n> --shard-id $SHARD_ID
  • CLUSTER_IP defines the IP for the Quarkchain cluster. If you want to try the one button quick mining, you can use fullnode.quarkchain.io or fullnode2.quarkchain.io.
  • --shard-id defines one specify shard to mine. shard id 60001 and 70001 are Qkchash.
  • --coinbase defines your mining coinbase address. Please use 20 bytes address generated the same way as an Ethereum address.
  • -t limits number of CPU miners to n
Chain Shard Hash Algo Parameter for Ethminer shard ID
6 0 Qkchash 60001
7 0 Qkchash 70001

Download Docker Image

docker pull quarkchaindocker/pyquarkchain:mainnet1.4.3
Assets 2

@ninjaahhh ninjaahhh released this Aug 7, 2020

Disclaimer

Same as mainnet1.4.3 release but with transaction history switched on.

Download Docker Image

docker pull quarkchaindocker/pyquarkchain:mainnet-index1.4.3
Assets 2

@ninjaahhh ninjaahhh released this Apr 22, 2020

Disclaimer

This release involves consensus changes (explained below). To avoid wasting mining power, please upgrade the cluster to this release before Thursday, April 30, 2020 17:00:00 AM GMT-07:00 DST.

Updates

  • * Enables native token auction system contract (QCEP-005) and adds minting pre-compiled contract for auctioning / issuing new native tokens
  • * Enables native token gas exchange system contract (QCEP-006) and updates EVM accordingly to support paying native tokens as transaction fees
  • * Adds pre-compiled contracts to support querying native token balance in smart contracts
  • * Reduces PoSW staking requirements on shard chains with the same rate as coinbase reward reduction (i.e. 0.88x) after each epoch ends
  • Migrates CHAIN_MASK_LIST to FULL_SHARD_ID_LIST configuration values while being backward-compatible for older configuration files
  • Various small fixes and improvements

(Those items listed with asterisk * mean they are consensus changes, and would lead to forks if clients are not updated accordingly.)

Minor Changes

Comparing with 1.4.1, this version can derive necessary consensus config changes if running for mainnet, thus users don't have to update their customized configs after upgrading the container or checking out this tagged version of code.

Native Token Auction

For details, please refer to QCEP-005.

Native Token Gas Exchange

For details, please refer to QCEP-006.

Notes

To change miner coinbase address:

./change_coinbase.sh 1000000000000000000000000000000000000000

For downloading snapshots:

curl https://s3-us-west-2.amazonaws.com/qkcmainnet/data/`curl https://s3-us-west-2.amazonaws.com/qkcmainnet/data/LATEST`.tar.gz --output data.tar.gz

Snapshots in China:

curl https://s3.cn-north-1.amazonaws.com.cn/qkcmainnet-cn/data/`curl https://s3.cn-north-1.amazonaws.com.cn/qkcmainnet-cn/data/LATEST`.tar.gz --output data.tar.gz

Running cluster after modifying config:

# inside the container
python3 quarkchain/cluster/cluster.py --cluster_config <config>
or
./run_cluster.py

Network ID

1

GPU mining shard ID

Instructions for Ethash GPU mining

ethminer -U http://$CLUSTER_IP:38391 --shard-id $SHARD_ID --cuda-devices $GPU_ID --farm-recheck $TIME --coinbase $COINBASE_ADDRESS
  • CLUSTER_IP defines the IP for the Quarkchain cluster. If you want to try the one button quick mining, you can use fullnode.quarkchain.io or fullnode2.quarkchain.io.
  • --shard-id defines one specify shard to mine. shard id 1, 10001, 20001, 30001, 40001, 50001 are Ethash.
  • --cuda-devices defines specify GPUs to mine.
  • --farm-recheck defines check interval in milliseconds for changed work. For example 1000.
  • --coinbase defines your mining coinbase address. Please use 20 bytes address generated the same way as an Ethereum address.
  • -U is for the CUDA GPU and -G is for the AMD GPU.
Chain Shard Hash Algo Parameter for Ethminer shard ID
0 0 Ethash 1
1 0 Ethash 10001
2 0 Ethash 20001
3 0 Ethash 30001
4 0 Ethash 40001
5 0 Ethash 50001

CPU mining shard ID

Instructions for Qkchash CPU mining

./ethminer --farm http://$CLUSTER_IP:38391 --coinbase $COINBASE_ADDRESS -t <n> --shard-id $SHARD_ID
  • CLUSTER_IP defines the IP for the Quarkchain cluster. If you want to try the one button quick mining, you can use fullnode.quarkchain.io or fullnode2.quarkchain.io.
  • --shard-id defines one specify shard to mine. shard id 60001 and 70001 are Qkchash.
  • --coinbase defines your mining coinbase address. Please use 20 bytes address generated the same way as an Ethereum address.
  • -t limits number of CPU miners to n
Chain Shard Hash Algo Parameter for Ethminer shard ID
6 0 Qkchash 60001
7 0 Qkchash 70001

Download Docker Image

docker pull quarkchaindocker/pyquarkchain:mainnet1.4.2
Assets 2

@ninjaahhh ninjaahhh released this Apr 22, 2020

Disclaimer

Same as mainnet1.4.2 release but with transaction history switched on.

Download Docker Image

docker pull quarkchaindocker/pyquarkchain:mainnet-index1.4.2
Assets 2
Pre-release
Pre-release

@ninjaahhh ninjaahhh released this Apr 21, 2020

Disclaimer

This release involves consensus changes (explained below). To avoid wasting mining power, please upgrade the cluster to this release before Thursday, April 30, 2020 17:00:00 AM GMT-07:00 DST.

Updates

  • * Enables native token auction system contract (QCEP-005) and adds minting pre-compiled contract for auctioning / issuing new native tokens
  • * Enables native token gas exchange system contract (QCEP-006) and updates EVM accordingly to support paying native tokens as transaction fees
  • * Adds pre-compiled contracts to support querying native token balance in smart contracts
  • * Reduces PoSW staking requirements on shard chains with the same rate as coinbase reward reduction (i.e. 0.88x) after each epoch ends
  • Migrates CHAIN_MASK_LIST to FULL_SHARD_ID_LIST configuration values while being backward-compatible for older configuration files
  • Various small fixes and improvements

(Those items listed with asterisk * mean they are consensus changes, and would lead to forks if clients are not updated accordingly.)

Native Token Auction

For details, please refer to QCEP-005.

Native Token Gas Exchange

For details, please refer to QCEP-006.

Notes

To change miner coinbase address:

./change_coinbase.sh 1000000000000000000000000000000000000000

For downloading snapshots:

curl https://s3-us-west-2.amazonaws.com/qkcmainnet/data/`curl https://s3-us-west-2.amazonaws.com/qkcmainnet/data/LATEST`.tar.gz --output data.tar.gz

Snapshots in China:

curl https://s3.cn-north-1.amazonaws.com.cn/qkcmainnet-cn/data/`curl https://s3.cn-north-1.amazonaws.com.cn/qkcmainnet-cn/data/LATEST`.tar.gz --output data.tar.gz

Running cluster after modifying config:

# inside the container
python3 quarkchain/cluster/cluster.py --cluster_config <config>
or
./run_cluster.py

Network ID

1

GPU mining shard ID

Instructions for Ethash GPU mining

ethminer -U http://$CLUSTER_IP:38391 --shard-id $SHARD_ID --cuda-devices $GPU_ID --farm-recheck $TIME --coinbase $COINBASE_ADDRESS
  • CLUSTER_IP defines the IP for the Quarkchain cluster. If you want to try the one button quick mining, you can use fullnode.quarkchain.io or fullnode2.quarkchain.io.
  • --shard-id defines one specify shard to mine. shard id 1, 10001, 20001, 30001, 40001, 50001 are Ethash.
  • --cuda-devices defines specify GPUs to mine.
  • --farm-recheck defines check interval in milliseconds for changed work. For example 1000.
  • --coinbase defines your mining coinbase address. Please use 20 bytes address generated the same way as an Ethereum address.
  • -U is for the CUDA GPU and -G is for the AMD GPU.
Chain Shard Hash Algo Parameter for Ethminer shard ID
0 0 Ethash 1
1 0 Ethash 10001
2 0 Ethash 20001
3 0 Ethash 30001
4 0 Ethash 40001
5 0 Ethash 50001

CPU mining shard ID

Instructions for Qkchash CPU mining

./ethminer --farm http://$CLUSTER_IP:38391 --coinbase $COINBASE_ADDRESS -t <n> --shard-id $SHARD_ID
  • CLUSTER_IP defines the IP for the Quarkchain cluster. If you want to try the one button quick mining, you can use fullnode.quarkchain.io or fullnode2.quarkchain.io.
  • --shard-id defines one specify shard to mine. shard id 60001 and 70001 are Qkchash.
  • --coinbase defines your mining coinbase address. Please use 20 bytes address generated the same way as an Ethereum address.
  • -t limits number of CPU miners to n
Chain Shard Hash Algo Parameter for Ethminer shard ID
6 0 Qkchash 60001
7 0 Qkchash 70001

Download Docker Image

docker pull quarkchaindocker/pyquarkchain:mainnet1.4.1
Assets 2
Pre-release
Pre-release

@ninjaahhh ninjaahhh released this Apr 21, 2020

Disclaimer

Same as mainnet1.4.1 release but with transaction history switched on.

Download Docker Image

docker pull quarkchaindocker/pyquarkchain:mainnet-index1.4.1
Assets 2

@ninjaahhh ninjaahhh released this Sep 25, 2019

Disclaimer

This release involves consensus changes (explained below). To avoid wasting mining power, please upgrade the cluster to this release before Friday, September 27, 2019 12:00:00 AM GMT-07:00 DST.

Updates

  • * Enables PoSW on root chain, allowing miners to mine root chain with lower difficulty if having enough stakes (QCEP-001)
  • * Updates cross-shard transaction execution model and gas accounting
  • * Adds pre-compiled contracts to support interactions with multi-native tokens inside smart contracts (QCEP-003, draft under review)
  • * Changes qkchash mining algorithm in shard 6 and 7 to further reduce the potential hardware acceleration (QCEP-002)
  • Supports websocket connections for event subscription
  • Updates getWork / submitWork flow to help miners manage root chain work and coinbase addresses
  • EVM will be enabled at aforementioned time which matches Constantinople version in Ethereum network

(Those items listed with asterisk * mean they are consensus changes, and would lead to forks if clients are not updated accordingly.)

Root Chain Staking

For miners interested in mining root chain with PoSW, here's a quick start:

  1. Since root chain PoSW relies on smart contracts, please wait until they are enabled (which will happen after unix timestamp 1569567600)
  2. A system contract at address 0x514b43000000000000000000000000000000000100000001 needs to be deployed before staking takes effects. DON'T SEND QKC TO THIS ADDRESS BEFORE THE STAKING CONTRACT IS DEPLOYED, otherwise those QKC will be considered as burned, and there is no way to recover them
  3. After confirming the staking contract is deployed, go to QuarkChain's contract page, select Interact, paste the aforementioned system contract address, paste the ABI interface JSON from this gist, click Access, select the function getLockedStakes, paste your coinbase address without full shard key (20 bytes, which is 42 characters including "0x", and same as your normal QKC address excluding last 8 characters), click Read, you should see your stakes and signer. For the meaning of those fields, please refer to QCEP-001
  4. To add stakes, simply send desired amount of QKC to the system contract (recommended gas: >50000). For other behaviors (changing the signer, unlocking, withdrawing, etc.), please refer to the QCEP-001 and use the interface defined there
  5. Lastly, the submitted root block needs to have a correct signature matching the staker's signer to pass the PoSW condition, which can by done by either
    • setting ROOT_SIGNER_PRIVATE_KEY field in the cluster config (as shown in this commit);
    • setting up your own signing server which controls your signer's private key and signs the incoming mining work hash and submits back to the network

PoSW parameters for root chain:

  • Minimum stakes for 1 block allocation: 1,000,000 QKC
  • Maximum allocation: 512
  • Difficulty divider if PoSW effective: 10000
  • Stake locking period (in the contract): 3 days (detailed spec)

Notes

To change miner coinbase address:

./change_coinbase.sh 1000000000000000000000000000000000000000

For downloading snapshots:

curl https://s3-us-west-2.amazonaws.com/qkcmainnet/data/`curl https://s3-us-west-2.amazonaws.com/qkcmainnet/data/LATEST`.tar.gz --output data.tar.gz

Snapshots in China:

curl https://s3.cn-north-1.amazonaws.com.cn/qkcmainnet-cn/data/`curl https://s3.cn-north-1.amazonaws.com.cn/qkcmainnet-cn/data/LATEST`.tar.gz --output data.tar.gz

Running cluster after modifying config:

# inside the container
python3 quarkchain/cluster/cluster.py --cluster_config <config>
or
./run_cluster.py

Network ID

1

GPU mining shard ID

Instructions for Ethash GPU mining

ethminer -U http://$CLUSTER_IP:38391 --shard-id $SHARD_ID --cuda-devices $GPU_ID --farm-recheck $TIME --coinbase $COINBASE_ADDRESS
  • CLUSTER_IP defines the IP for the Quarkchain cluster. If you want to try the one button quick mining, you can use fullnode.quarkchain.io or fullnode2.quarkchain.io.
  • --shard-id defines one specify shard to mine. shard id 1, 10001, 20001, 30001, 40001, 50001 are Ethash.
  • --cuda-devices defines specify GPUs to mine.
  • --farm-recheck defines check interval in milliseconds for changed work. For example 1000.
  • --coinbase defines your mining coinbase address. Please use 20 bytes address generated the same way as an Ethereum address.
  • -U is for the CUDA GPU and -G is for the AMD GPU.
Chain Shard Hash Algo Parameter for Ethminer shard ID
0 0 Ethash 1
1 0 Ethash 10001
2 0 Ethash 20001
3 0 Ethash 30001
4 0 Ethash 40001
5 0 Ethash 50001

CPU mining shard ID

Instructions for Qkchash CPU mining

./ethminer --farm http://$CLUSTER_IP:38391 --coinbase $COINBASE_ADDRESS -t <n> --shard-id $SHARD_ID
  • CLUSTER_IP defines the IP for the Quarkchain cluster. If you want to try the one button quick mining, you can use fullnode.quarkchain.io or fullnode2.quarkchain.io.
  • --shard-id defines one specify shard to mine. shard id 60001 and 70001 are Qkchash.
  • --coinbase defines your mining coinbase address. Please use 20 bytes address generated the same way as an Ethereum address.
  • -t limits number of CPU miners to n
Chain Shard Hash Algo Parameter for Ethminer shard ID
6 0 Qkchash 60001
7 0 Qkchash 70001

Download Docker Image

docker pull quarkchaindocker/pyquarkchain:mainnet1.3.0
Assets 2

@ninjaahhh ninjaahhh released this Sep 25, 2019

Disclaimer

Same as mainnet1.3.0 release but with transaction history switched on.

Download Docker Image

docker pull quarkchaindocker/pyquarkchain:mainnet-index1.3.0
Assets 2