Latest Source: https://gitlab.com/aquachain/aquachain
Mirrored: https://github.com/aquachain/aquachain
View or Improve the Documentation online: https://aquachain.github.io/docs/
** Found a bug in this software? Documentation lacking? See https://gitlab.com/aquachain/aquachain/wikis/bugs **
See bottom of this document for more useful links. Your contributions are welcome.
Aquachain: peer-to-peer programmable money, distributed code contract platform.
Target Block Time: 240 second blocks (4 minute)
Block Reward: 1 AQUA
Max Supply: 42 million
Algorithm: argon2id (CPU or GPU mined)
ChainID/NetworkID: 61717561
- https://frame.sh (Desktop)
- https://metamask.io/ (Browser Extension)
- https://download.mycrypto.com (Desktop, creates mnemonic phrases)
- https://walleth.org (Android, burner accounts etc)
The aquachain command (full node, RPC server, and wallet) is a portable
program that doesn't really need an 'installer', you can run it from anywhere.
When you first start aquachain you will connect to the peer-to-peer network
and start downloading the chain from whatever peers it can find.
To change the way aquachain runs, for example testnet, or with json-rpc endpoints, use command line flags or TOML config file. (see Usage section)
List all command line flags using the -h flag, or aquachain help [subcommand]
You should keep backups of your keystore files, if any, and regularly check unlocking them. It is generally better to keep private keys away from your node.
Wallets connect to RPC nodes and offer an easy-to-use interface. Hosting your own RPC server is easy and improves privacy and has zero downtime issues.
By default, using the -rpc flag listens only on 127.0.0.1:8543 and offers everything needed to connect wallets such as Frame, Metamask, Hardhat.
Requires only Go. Use the latest.
git clone https://gitlab.com/aquachain/aquachain
cd aquachain
make
Programs are built to the ./bin/ directory.
On windows, double-click make.bat to compile aquachain.exe onto your Desktop.
** Patches can be submitted at Github or Gitlab or Mailing List **
While compiled releases may exist, it is better to compile it yourself from latest source.
"Imported new chain segment" means you received new blocks from the network.
When a single block is imported, the address of the successful miner is printed.
When you start seeing a single block every 4 minutes or so, you know that you are fully synchronized with the network.
Enter AQUA javascript console: aquachain.exe
Start Daemon (geth default): aquachain.exe daemon
Run localhost rpc (port 8543): aquachain.exe -rpc
See more commands: Wiki
Type help at the AQUA> prompt for common AQUA console commands.
Run aquachain.exe help for command line flags and options.
See "RPC" section in ./Documentation folder and online at: https://aquachain.github.io/docs/
Start HTTP JSON/RPC server for local (127.0.0.1) connections only: aquachain -rpc
Start HTTP JSON/RPC server for remote connections, listening on 192.168.1.5:8543, able to be accessed only by 192.168.1.6:
aquachain -rpc -rpchost 192.168.1.5 -allowip 192.168.1.6/32
With no other RPC flags, the -rpc flag alone is safe for local usage (from the same machine).
Please be aware that hosting a public RPC server (0.0.0.0) will allow strangers access to your system.
Do not use the -rpcaddr flag unless you absolutely know what you are doing.
For hosting public RPC servers, please consider using -nokeys (new!) and implementing rate limiting on http (and, if using, websockets) , either via reverse proxy such as caddyserver or nginx, or firewall.
Can't connect to your remote RPC server? -allowip flag is closed by default
Recent builds of aquachain include support for the -allowip flag.
It is by default, set to 127.0.0.1, which doesn't allow any LAN or WAN addresses access to your RPC methods.
To add IPs, use aquachain -rpc -rpchost 192.168.1.4 -allowip 192.168.1.5/32,192.168.2.30/32
The CIDR networks are comma separated, no spaces. (the /32 after an IP means 'one IP')
The JSON/RPC server is able to be used with "Web3" libraries for languages such as Python or Javascript.
These include Ethers or Hardhat or web3js or web3py
For compatibility with existing tools, all calls to eth_ methods are translated to aqua_, behind-the-scenes.
This repository is also a Go library! See each package's documentation (godoc) for more information on usage.
Aquachain is similar to Ethereum, but differs in a few important ways.
Max supply of 42 million, estimated to occur Thu Aug 5 04:23:29 AM UTC 2337 (@11600079809)
The number of coins in existence is important.
On the aquachain network, no coins were created without being mined.
One coin for each block, with occasional uncle reward.
Each year the chain grows by approximately 120000 blocks.
Compare in contrast to the Ethereum network, which distributed around 80 million coins to their foundation and pre-sale on day one. In such a system with pre-mined coin, there will never be a time where miners have outmined the pre-mined team allocation.
By dedicating a rig or two to mining this chain you are promoting a healthy strong network!
Anyone, anywhere, can start mining today to receive a stream of coins to their wallet.
Each block has a 'version' which is only known by consensus rules.
Before calling block.Hash(), the version MUST be 'set' using block.SetVersion(n). Failure to do so will panic.
This should always be done exactly ONCE immediately after deserializing a block.
Mining software should use the HF map consensus rules to determine the header version based on block height, which determines which hash function to use.
Header version 1 uses ethash.
Header version 2 uses argon2id(1,1,1)
Many non-critical geth components were removed to create a node that is better on resources.
We have a "100% go" build with no C dependencies.
When you compile aquachain, you should have built a static binary.
The 240 seconds block time has successfully deterred typical "DEX" and "ERC20 token" projects from existing on the chain.
This frees up the blocks for you and your user's transactions to be mined at an inexpensive gas price.
Typical DEX/ERC20 projects depend on a relatively short block time to (seemingly) provide realtime trading.
The dangers of a slow block time include but are not limited to frontrunning.
Please do not create a DEX/ERC20 project here.
Solidity developers take note: the Aquachain EVM is not the same as other chains.
Certain opcodes simply do not exist here such as CREATE2 and CHAINID and others.
When compiling solidity, use 'Byzantium' EVM target and enable optimization.
If you think there should be a change to our EVM, submit a pull request or join chat.
Aquachain chainId is 61717561
By enforcing these HF limitations, we prevent manipulation of the aquachain economy. Rules should be easy to add, and should be difficult to remove one. (subject to change)
-
A HF will never be made to increase supply
-
A HF will never be made to censor or block a transaction
-
A HF will never be made to refund coin for any reason.
-
A HF will never be made to benefit one or only a small subset of miners.
-
A HF will never be made to benefit one or only a small subset of users.
-
A HF will never be made for no good reason.
-
A HF will never be made when a simple upgrade could replace it.
-
A HF should be made as soon as possible if an "ASIC threat is realized"
-
A HF should be made as soon as possible if an exploit is found that can be abused for profit or leads to denial of service or loss of funds.
-
A HF should be made as soon as possible if a "serious bug" is found in the core aquachain source code that can lead to loss of money for the average aquachain user.
-
If no HF are required, a scheduled hard fork can be made to tweak the algorithm every 4 to 6 months, to prevent ASIC production.
Website - https://aquachain.github.io
Explorer - https://aquachain.github.io/explorer/
About - https://telegra.ph/Aquachain-AQUA---Decentralized-Processing-07-20
Mining - https://telegra.ph/Mining-AQUA-05-27
Wiki - https://gitlab.com/aquachain/aquachain/wikis
ANN - https://bitcointalk.org/index.php?topic=3138231.0
Gitlab - http://gitlab.com/aquachain/aquachain
Github - http://github.com/aquachain
Telegram News: https://t.me/Aquachain
Godoc - https://godoc.org/gitlab.com/aquachain/aquachain#pkg-subdirectories
Report bugs - https://github.com/aquachain/aquachain/issues
Telegram Chat: https://t.me/AquaCrypto
Discord: https://discordapp.com/invite/J7jBhZf
IRC: #aquachain on freenode
Bugs: https://gitlab.com/aquachain/aquachain/wikis/bugs
Aquachain is free open source software and your contributions are welcome.
- Always
gofmt -w -l -sbefore commiting. If you forget, adding a simple 'gofmt -w -l -s' commit works. - Before making a merge request, try
make testto run all tests. If any tests pass, the PR can not be merged into the master branch. - Rebase: Don't
git pullto update your branch. instead, from your branch, typegit rebase -i masterand resolve any conflicts (do this often and there wont be any!) - Prefix commit message with package name, such as "core: fix blockchain"