Skip to content

About

Cross-chain crypto currency p2p trading decentralized exchange system installer by using dexsetup framework on top of Blocknet decentralized Interchain system.

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Latest commit

 

History

145 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

About

  • dexinstaller is simple interactive command line installer for dexsetup
  • One stop point installer/tutorial, which guides everything needed to know to setup/configure/run/manage backend of most decentralized exchange DEX by Blocknet

Summary

  1. Running DEX Installer
  2. Remote desktop management with VNC
  3. Directory structure
  4. Start, Attach, Navigate and Detach from installed dexsetup environment by terminal
  5. Using Blocknet(BLOCK) with Litecoin(LTC) dexbot trading strategy 1 generated by installer
  6. Used components
  7. Additional resources
  8. Contact me
  9. Donations
  10. Remember

1. Running DEX Installer

  • update system and install privacy packages (one time needed)
  • Update system and install tor, proxychains4 and wget privacy packages on Debian or Ubuntu based distributions by using apt and su or sudo:
pkgs="proxychains4 tor torsocks wget";
groups | grep debian-tor > /dev/null && cfg_user_tor="echo 'Tor for ${USER} is already configured'" || cfg_user_tor="usermod -a -G debian-tor ${USER}";
sudo -v; (test $? != 0) && su_cmd="echo 'Please enter ROOT password'; su - -c" || su_cmd="echo 'Please enter ${USER} sudo password'; sudo sh -c";
eval "${su_cmd} \"apt -y update; apt -y full-upgrade; apt -y install ${pkgs}; ${cfg_user_tor}; exit\""
  • download or update installer
  • installer is downloaded anonymously and verified if digital fingerprint match
branch="main" && mkdir -p ~/dexsetup && cd ~/dexsetup && rm -f installer.sh && rm -f installer.sha512 && proxychains4 wget "https://github.com/nnmfnwl/dexinstaller/raw/refs/heads/${branch}/installer.sh" && proxychains4 wget "https://github.com/nnmfnwl/dexinstaller/raw/refs/heads/${branch}/installer.sha512" && sha512sum installer.sh | grep `cat installer.sha512` && (echo "installer fingerprint verification success") || (sha512sum installer.sh; echo "installer fingerprint verification failed"; rm -f installer.sh)
  • run installer in full interactive mode:
cd ~/dexsetup && bash installer.sh
  • run installer in automatic deployment mode:
  • Alternative examples to run DEX installer in automatic(non-interactive) mode with custom arguments could be found here: Additional resources

2. Remote desktop management with VNC

  • Open secured SSH tunnel between client and server(replace 10.10.10.10X with real IP address)
ssh -L 5923:127.0.0.1:5903 10.10.10.10X -N
  • Use Remmina or any other VNC client to connect to server
remmina -c vnc://127.0.0.1:5923

3. Directory structure

  • it is recommended to understand used directory structure by browsing home directory ~/dexsetup and standard chain directories ~/.coinname... or use following commands:
  • All downloaded, generated files, and management scripts are stored at ~/dexsetup
tree -d -L 2 ~/dexsetup/ | less
  • Blockchains are using default chain data directories like ~/.litecoin, ~/.blocknet, ~/.bitcoin etc...
ls -lah ~/.bitcoin ~/.litecoin/ ~/.blocknet
  • Proxychains configuration file been updated at ~/.proxychains/proxychains.conf
less ~/.proxychains/proxychains.conf

4. Start, Attach, Navigate and Detach from installed dexsetup environment by terminal

  • To start main CLI start script which opens management by console interface only:
cd ~/dexsetup/dexsetup/ && ./start.screen.instance_default.cli.sh
  • To start main start GUI script which opens management by console interface and graphical user interface wallets as well:
cd ~/dexsetup/dexsetup/ && ./start.screen.instance_default.gui.sh
  • To Attach to dexsetup management by GNU Screen terminal multiplexer console interface
screen -x
  • To list and navigate screen tabs/windows use shortcut CTRL + a ^ " (hold CTRL and push a, release CTRL and then push ", which is probably activated as shift+")
  • To detach and keep running applications inside screen the console multiplexer use keyboard shortcut CTRL + a ^ d
  • All screen terminal multiplexer tabs are nicely named with predefined commands, and user just use enter to confirm commands depending on what is needed

5. Using Blocknet(BLOCK) with Litecoin(LTC) dexbot trading strategy 1 generated by installer

5.1.1. Start and sync Blocknet and Litecoin DEX wallet profiles

  • Start Blocknet DEX wallet profile, component block_dex with already predefined command:
./firejail.blocknet.wallet_block_dex.qt.bin.sh
  • Start Litecoin DEX wallet profile, component ltc_dex with already predefined command:
./firejail.litecoin.wallet_ltc_dex.qt.bin.sh

5.1.2. Start and sync Blocknet and Litecoin DEX wallet profiles - additional resources

  • Wallet sync status check by GUI or component _cli using command:
./getblockchaininfo.basics
  • Wallet unlock status check by GUI or component _cli using command:
./getwalletinfo.basic
  • Security recommendation is to to encrypt wallet first by GUI or component _cli using command:
./encrypt
  • Backup wallet on external drive or another machine by GUI menu or component _cli using command:
./backup
  • To unlock encrypted wallet by GUI menu or component _cli using command:
./unlock.full
  • If wallet is not created yet, then could be used standard command, please remember, that dexinstaller predefined wallet names by profiles for example wallet_block_dex, so using another name would not load it automatically
./cli createwallet "wallet name"

5.2.1. Mandatory finalization and tuning BLOCK/LTC strategy 1

  • Every strategy must be finalized manually by text editor to be able to be used, because to specify trading addresses per bot strategy and also final tuning.
  • To finalize for example BLOCK/LTC default trading strategy1:
    1. Make copy of existing trading template by adding add filename suffix
cp ~/dexsetup/dexsetup/src/cfg.strategy.block.ltc.sh ~/dexsetup/dexsetup/src/cfg.strategy.block.ltc.add.sh
    1. open strategy in editor and keep just values that you need to change and edit them
editor=geany; ${editor} ~/dexsetup/dexsetup/src/cfg.strategy.block.ltc.add.sh
    1. To finalize and make strategy usable, at least {cc_address_maker} and {cc_address_taker} string must be replaced with valid wallet addresses.
cc_address_maker_default="{cc_address_maker}"
cc_address_taker_default="{cc_address_taker}"
    1. Run strategy automatic regeneration for specific trading pair again including related dexbot update
COIN1=BLOCK
COIN2=LTC
cd ~/dexsetup/ && bash installer.sh DEFAULT-N c-y dexsetup-update-y dexbot-strategies-y ${COIN1}-${COIN2}-setup-y ${COIN1}-${COIN2}-update-y
    1. Run strategy automatic regeneration for specific trading pair again not including dexbot update
  • This is more complicated for advanced users only.
cd ~/dexsetup/dexsetup && ./setup.cc.dexbot.profile.sh ./src/cfg.cc.blocknet.sh ./src/cfg.cc.blocknet.sh ./src/cfg.cc.litecoin.sh  ./src/cfg.dexbot.alfa.sh  ./src/cfg.strategy.block.ltc.sh strategy1

5.2.2. Mandatory finalization and tuning BLOCK/LTC strategy 1 - Additional resources

  • To generate new wallet address by using GUI menu or component _cli using command:
./getnewaddress.default
  • By default all generated strategy could be found at ~/dexsetup/dexbot/git.src/ with prefix strategy
cd ~/dexsetup/dexbot/git.src/ && ls -la | grep strategy | grep .py
  • Every generated strategy is easy readable well documented configuration based on DEXBOT template generated as mix with specific strategy trading pair configuration BLOCK/LTC , BTC/LTC ...
  • Final strategy tuning is easy but most effective way would be to write own strategy trading pair configuration for dexsetup which could be easy shared used again and again.

5.3.1. Strategy Start, Strategy Stop and Orders Cleaning

  • Start DEXBOT pricing proxy component first
./run.firejail.proxy.sh
  • Start DEXBOT BLOCK LTC trading strategy1 component:
./run.firejail.BLOCK.LTC.strategy1.sh 
  • Start DEXBOT LTC BLOCK trading strategy1 component:
./run.firejail.LTC.BLOCK.strategy1.sh
  • Stop and Clean DEXBOT BLOCK LTC trading strategy1 component by Control + Z and:
./run.firejail.BLOCK.LTC.strategy1.sh  --canceladdress
  • Stop and Clean DEXBOT LTC BLOCK trading strategy1 component by Control + Z and:
./run.firejail.LTC.BLOCK.strategy1.sh  --canceladdress
  • Start DEXBOT BLOCK LTC trading strategy1 component after manually adding or removing funds from specified address by:
./run.firejail.BLOCK.LTC.strategy1.sh  --action reset
  • Start DEXBOT LTC BLOCK trading strategy1 component after manually adding or removing funds from specified address by:
./run.firejail.LTC.BLOCK.strategy1.sh  --action reset

5.3.2. Strategy Start, Strategy Stop and Orders Cleaning - Additional resources

  • Start BlockDX - Decentralized Exchange Graphical User Interface by blockdx component:
./firejail.blockdx.default.sh

6. Used components

7. Additional resources

Automatization scripts examples
  • Full automatic installation - >>>
  • Session Privacy Messenger setup/add/update - >>>
  • Blocknet(BLOCK) faucet takerbot setup/add/update - >>>
  • Specific wallet setup/update/reinstall - >>>
Video tutorials
  • 12 minutes full installation tutorial on Bastyon - Bastyon.com
  • 10 minutes full installation tutorial on X - X.com (video is cut because 10 minutes limit on X)

8. Contact me

  • Bastyon - nnmfnwl7 - fully decentralized proof-of-stake blockchain based social network,chat,video,stream,blog,tip,monetization,pay-to-view platform
  • Bastyon public chat - Blocknet DEX
  • Twitter/X - nnmfnwl on X (X chat is not reliable and actually not working)
  • Session privacy messenger - 051dcabc45ab21bcb5b8c3b29416f2cdac1e8b9836f545fd4e470e0f31a9ed825a - getsession.org
  • Simplex privacy messenger - https://smp17.simplex.im/a#zpuOvtOEGHLoCnkTRwuefisdHvLD9dqlcU5-rjj1KFI - simplex.chat
  • Simplex public group chat - https://smp17.simplex.im/g#NbHADPZBLIMlFru_hyqEhwbw4zBbYVq84jtXpLCqA68 - simplex.chat
  • Coinmarketcap - nnmfnwl7
  • Email fingerprint - f287ec46e5f0875832abb68ff54db2a4d0fe93b35ccc0cbe692f2ee6f545603d41db4e4d230fa8d2c8ffa2f39531d1da5421bfeab542c1098a6c7e26a6fec64c - verify as echo "<email>" | sha512sum

9. Donations

  • Donations for DEXBOT, DEXSETUP, DEXINSTALLER and DEXSETUP.VIDEOS continuous development, testing and liquidity providing:
  • For ability of this project to continue it helps even a penny support. Please use below addresses or contact section to request other address.
  • BTC LN: ****
  • BTC: ****
  • DASH: XpoeUHMoQaKJ6CZ6kYk7QoKK3QsYN1NTQC
  • LTC: LYRaGuZFGSkZHrEYHTgFyPiFtipcMPDeTM
  • DOGE: DRmtYF5vqV5iSeG2eeSh2MLCcojVASViH6
  • XVG: DFhrGF3xYb2NWfGnRPRyjK2GwcrVYfDEfk
  • PIVX: D6aXrsX4cscvW2zu8qJzW2TFSXoZZPYVv5
  • BLOCK: Bb4gLEvmgsWWqy159GkdvfJMbkQH1mRmnD
  • PKOIN: ****
  • LBC: ****
  • XMR: ****
  • ETH: 0x08337DDB696d43fbC91e3961bE900A5cb20EfAda

10. Remember

  • Your keys your content.
  • Your keys your coins.
  • Decentralization is freedom.
  • Centralization is tool used to control by force not by love.

About

Cross-chain crypto currency p2p trading decentralized exchange system installer by using dexsetup framework on top of Blocknet decentralized Interchain system.

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages