Documentation Version 1.0


If you have any questions that are beyond the scope of this help file, please feel free to send us a ticket, you get exceptional support from the developer directly.

This documentation is to help you regarding each step of customization and the use of the script. Please go through the documentation carefully to understand what this script is made of and how to install properly.


Be careful while editing the script for your own use. If not edited properly,the design layout or backend may break. No support is provided for faulty customization.

Getting Started

Echain is a cryptocurrency buying and selling platform. It enables users to create their cryptocurrency offers at their market rate. It supports swapping, transfers of cryptocurrency from their wallets. Echain currently supports ten cryptocurrencies such as BTC, LTC, BCH, ETH, LINK, DOT, ADA, XLM, XRP, USDT. Users don't really need to buy offers to get cryptocurrencies, it can also be done by just funding your wallet. Payment services such as Paystack, Flutterwave, Paypal, and Stripe was integrated to make purchasing of offers very easy. It runs on the latest version of laravel so we guarantee security is no issue. We are doing continuous improvements to make it more stable in the long run.


  • Server: Apache Server
  • Php Version: v7.3+ | v8.0+
  • Phpmyadmin v5.0.2+
  • Recommended Hosting: Namecheap
  • Php Extensions: file_info, curl, mysqli, mbstring

Installation (cpanel)

  • Database

    • Navigate to Mysql Database
    • Database Name - Create a new database name
    • Database Username & Password - Create a new database user and password
    • Linking - Link database name and user
    • Privileges - Give database user all permissions needed to access database
  • File Manager

    • Navigate to File Manager
    • Hidden files - Click on file manager settings and ensure hidden files is checked
    • Navigate to public_html - Upload to this folder with a good internet
    • Unzip - Unzip file
    • Configure .env file - Navigate to core/.env file to add important information
  • Env file

    • Database Connection*
    • DB_CONNECTION - Don't edit
    • DB_HOST - Don't edit
    • DB_PORT - Don't edit
    • DB_DATABASE - Database Name
    • DB_USERNAME - Database Username
    • DB_PASSWORD - Database Passwod
  • Env file

    • Application*
    • APP_NAME - Website Name(No space)
    • APP_ENV - Don't edit
    • APP_KEY - Don't edit
    • APP_DEBUG - False, if you leave this to be true, script will display errors whenever there is a bug, if you leave it as false, 505 error will be displayed instead of bug report
    • APP_URL - Domain name
  • Launching Application

    Load up your domain name, if you followed our instructions to detail, site will work well

  • 404 Error

    If you are getting this error, it means you did not upload .htaccess file in public_html file. If you can't file to upload, you can create a new file called .htaccess in public_html folder and paste the following code.
    Laravel .htaccess file

Email Setup (cpanel)

  • Email

    • Navigate to Email Accounts(Webmail)*
    • Create a new email account
    • Click on connected devices to get SMTP details
    • Take Note of SSL settings
    • Navigate to .env file
    • Edit
    • MAIL_DRIVER - Don't edit
    • MAIL_HOST - Outgoing or Incoing server
    • MAIL_PORT - 465 for Webmail(ssl)
    • MAIL_USERNAME - Email address
    • MAIL_PASSWORD - Email Password
  • Email Settings

    Ensure email notify is enabled via admin settings

Crytocurrency Supported

  • Bitcoin - BTC
  • Litecoin - LTC
  • Bitcoin Cash - BCH
  • Ethereum - ETH
  • Cahinlink - LINK
  • Polkadot - DOT
  • Cardano - ADA
  • Ripple - XRP
  • Stellar - XLM
  • Tether - USDT

Echain uses coingecko API to provide real-time cryptocurrency prices. Cryptocurrency prices are updated every 10 minutes to reduce the call on API and increase website speed. The option is available for the admin to disable or enable any cryptocurrency. Admin is required to provide wallet address for every active coin, for funding of cryptocurrency wallet for users. Deposit charge, minimum deposit, swap charge, and minimum swap for each cryptocurrency can be edited.

Purchase Methods

  • Flutter Wave
  • Paystack
  • Stripe
  • Paypal
  • Account Balance

All Purchase Method requires a charge except account balance. Use Deposit Methods that accept the currency your platform uses. For example, gateways like paystack won't accept USD, so if you use USD as the default currency, Paystack won't work with that. Do know that these payment gateways are just for purchasing offers. For gateways that fail to send IPN(instant payment notification), we have added a manual confirmation and decline transaction option in the payment log via the admin panel

How features work

Deposit Cryptocurrency

Admin is required to provide wallet address for every active coin, for funding of cryptocurrency wallet for users. Deposit charge and minimum deposit for each cryptocurrency can be edited.

Transfer Cryptocurrency

Users can transfer cryptocurrencies to other users within the platform, with a registered email address. Transfers are processed with charges that are configured by the admin.

Swap Cryptocurrency

Users can swap cryptocurrencies for any other cryptocurrency. Transactions are processed with charges that are configured by the admin.

Cryptocurrency offers

Users can create offers to sell their cryptocurrency in their wallets at their price. Admin earns a cut from each sale. This charge can be edited from admin settings.


There are two types of payouts; sale and cryptocurrency payout. Sale payout is money created from selling offers. It's paid directly to a user's bank account with charges. Cryptocurrency payout deals with the withdrawal of coins from the wallet or termination of the wallet. It's paid to the user's external wallet with charges.


KYC (know your customer), echain comes with KYC built with three types of verifications, such as National ID, Driver License, International Passport, and Voters Card. If KYC restriction is enabled, it will be compulsory on registration.


Two-factor authentication is a method for protecting your web account. When it is activated, you need to enter not only your password but also a code. You can receive this code in the mobile app. Even if a third person finds your password, they can't access that code.

  • Install an authentication app on your device. Any app that supports the Time-based One-Time Password (TOTP) protocol should work.
  • Use the authenticator app to scan the barcode.
  • Enter the code generated by the authenticator app.