Exchange Pool integration guide - hadescoincom/hds-core GitHub Wiki
First of all, define the network you'd like to "play" with:
-
mainnet
- it's the latest released production version, working with real money and you can get binaries from the official website, see Github Releases or build yourself from the sources of (mainnet branch). -
testnet
- to check the features will be released soon to production, download from Github Releases or build from the testnet branch. -
master
- to see the latest changes in development build the master branch.
Here are detailed instructions on how to build a project for Windows, Linux, Mac platforms .
Add
-DHDS_NO_QT_UI_WALLET=On
command line parameter to the Cmake if you need only CLI version of the wallet without UI and QT5 library dependencies.
You will need to build 4 binaries: hds-node
, explorer-node
, hds-wallet
and wallet-api
.
To create a new wallet run the following command (wallet.db
will be created in the working folder):
./hds-wallet init
Output example for init
operation:
I 2020-02-19.15:28:55.500 Hds Wallet 1.2.4392 (master)
I 2020-02-19.15:28:55.501 Rules signature: 7c360d0c2ee92d9e
I 2020-02-19.15:28:55.501 starting a wallet...
Enter password: ***
Confirm password: ***
I 2020-02-19.15:29:01.716 Generating seed phrase...
======
Generated seed phrase:
army;wing;very;trim;crumble;meat;spawn;click;donate;loyal;trap;gauge;
IMPORTANT
Your seed phrase is the access key to all the cryptocurrencies in your wallet.
Print or write down the phrase to keep it in a safe or in a locked vault.
Without the phrase you will not be able to recover your money.
======
I 2020-02-19.15:29:01.950 wallet successfully created...
I 2020-02-19.15:29:01.971 New address generated:
1f27eea1057633e7df23aa51f835a05fa759ca199535fe99952bf9aecad17186d9d
I 2020-02-19.15:29:01.971 comment = default
You can also restore wallet with your seed_phrase
if you've already had it.
./hds-wallet restore --seed_phrase=<semicolon separated list of 12 seed phrase words>;
Once wallet is initialised, you have to export your Owner Key (it will be needed in the future to start own node).
More info about `owner key`
The purpose of the `owner key` is to allow all nodes mining for you to be aware of all mining rewards mined by other nodes so that you would only need to connect to one node to collect all the rewards into your wallet. While in most other cryptocurrencies this is done by simply mining to a single address you control, in Mimblewimble it is not as simple since there are no addresses and the mining rewards should be coded with unique blinding factors which are deterministically derived from the `master key`, and then tagged by the single `owner key`.Output example for export_owner_key
operation:
$ ./hds-wallet export_owner_key
I 2020-02-19.15:32:16.217 Hds Wallet 1.2.4392 (master)
I 2020-02-19.15:32:16.218 Rules signature: 7c360d0c2ee92d9e
I 2020-02-19.15:32:16.219 starting a wallet...
Enter password: ***
Owner Viewer key: +SevBZ++xL1wEM+yyGbMI+ZElHahudX8mh6Hu/atJrdtzAOD2zpeb2LPIqQcnvry3JUQFBa9gTAHT98RMQMdcggr+LX0oqdGsVIx3KRkTxyvRdKBnw8lz9uAmMx0P2TNlk30E+M5MCnX7Ngp
Owner Key should be kept secret. Owner Key does not allow to spend coins, however it will allow to see all coins mined for you by all miners that use this Owner Кey.
Here you can read about all the hds-wallet
commands: https://documentation.hadescoin.com/en/latest/rtd_pages/user_cli_wallet_guide.html
Run the node with your Owner Key and make sure it has completed the synchronization with the network:
./hds-node.exe --peer=silicon-valley-nodes.mainnet.hadescoin.com:16668 --key_owner=XPWoJ/ViEO1whRcYC1z/nylDH1C2lqLxpMYU0/AbqP67XI4sgYDkUIvJfUpMFjwdPYNz2A7PCHWo7c/kHHTZ2EDUNv2BJvQHb1KHZjLNZPFgV2wceHfzvCYIUF3cR9ADfVSBquTxEldipNgp
Please, make sure you pass proper peer address for the current network you have chosen before.
List of peers
MASTER peers:
eu-node01.masternet.hadescoin.com:16668
silicon-valley-nodes.mainnet.hadescoin.com:16668
eu-node03.masternet.hadescoin.com:16668
eu-node04.masternet.hadescoin.com:16668
TESTNET peers:
ap-node01.testnet.hadescoin.com:16668
ap-node02.testnet.hadescoin.com:16668
ap-node03.testnet.hadescoin.com:16668
eu-node01.testnet.hadescoin.com:16668
eu-node02.testnet.hadescoin.com:16668
eu-node03.testnet.hadescoin.com:16668
us-node01.testnet.hadescoin.com:16668
us-node02.testnet.hadescoin.com:16668
us-node03.testnet.hadescoin.com:16668
MAINNET peers:
silicon-valley-nodes.mainnet.hadescoin.com:16668
eu-node02.mainnet.hadescoin.com:16668
eu-node03.mainnet.hadescoin.com:16668
eu-node04.mainnet.hadescoin.com:16668
us-node01.mainnet.hadescoin.com:16668
us-node02.mainnet.hadescoin.com:16668
us-node03.mainnet.hadescoin.com:16668
us-node04.mainnet.hadescoin.com:16668
ap-node01.mainnet.hadescoin.com:16668
ap-node02.mainnet.hadescoin.com:16668
ap-node03.mainnet.hadescoin.com:16668
ap-node04.mainnet.hadescoin.com:16668
Hds Node also provides built-in support for Stratum API allowing to connect multiple external mining clients to a single node, read more....
With Wallet API you can
- check current wallet status and (balance)
- get all your UTXO/transactions list
- create/verify address
- send funds and cancel transactions
- make a split of UTXO - create a specific set of outputs with given set of values
There are two ways to send JSON RPC commands to the API,
- using TCP socket
- via HTTP calls.
With TCP you can hold only one connection, send JSON commands separated with \n
symbol and receive callbacks from the API, in the one hand it's more flexible but a bit difficult to implement in the other hand.
With HTTP you can do POST requests using curl
command.
So, to start API with HTTP support use the command:
./wallet-api --node_addr=x.x.x.x:port --api_use_http=1
where node_addr
is your node address and port.
See detailed wallet API documentation.
With this API you can get information about current blockchain state and blocks using simple GET requests.
To run explorer use the command:
./explorer-node.exe --peer silicon-valley-nodes.mainnet.hadescoin.com:16668 --api_port=8080
Please, make sure you pass proper peer address for the current network you have chosen before.
See detailed explorer API documentation