hydraex/exchange

Exchange core modules

dev-master 2019-07-23 10:06 UTC

Requires

• php: >=7.2.0

Requires (Dev)

• phpunit/phpunit: ~6.0

MIT

• Ilya Pistol

• php
• core
• Hydra
• exchange

README

Matcher allows to exchange any assets with the changing of trader's balances and volumes of each order in order book.

Install

Via Composer:

php composer require hydraex/exchange

Basic case of usage

To call the matcher you have to get 2 top orders from left and right orderbooks (sorted by price) and convert them to Order entity of this repository.

//...
use Hydra\Exchange\Entities\{Pair, BuyOrder, SellOrder, SellerBalance, BuyerBalance, Asset};
use Hydra\Exchange\Libs\{Matcher, Logger};
//...

//creation of pair
$pair = new Pair(
    new Asset("BTC", "Bitcoin"), //primary asset
    new Asset("ETH", "Ether") //secondary asset
);

//setting of user balances
$buyersBalance = new BuyerBalance(1001, 89);
$sellerBalance = new SellerBalance(99, 11);

//two counter orders:
//one wants to buy 100 units of the ETH for the price of 10
$buyOrder = new BuyOrder($pair, 100, 10, $buyersBalance, 1);
//another wants to sell 10 units of the ETH for the price of 9
$sellOrder = new SellOrder($pair, 10, 9, $sellerBalance, 2);
//(the last parameter (1 and 2) is order number among all orders)

//deal with it:
$matcher = new Matcher($buyOrder, $sellOrder);
$deal = $matcher->matching();

echo "Deal price is " . $deal->getPrice() . "\n";
echo "Deal quantity is " . $deal->getQuantity() . "\n";
echo "Buyer BTC balance is " . $buyersBalance->getPrimary() . "\n";
echo "Buyer ETH balance is " . $buyersBalance->getSecondary() . "\n";
echo "Seller BTC balance is " . $sellerBalance->getPrimary() . "\n";
echo "Seller ETH balance is " . $sellerBalance->getSecondary() . "\n";
echo "Buy order now contains only " . $buyOrder->getQuantityRemain() . " ETH \n";
echo "Sell order now contains " . $buyOrder->getQuantityRemain() . " ETH and his status is " . $sellOrder->getStatus() . "\n";
echo "Log: ";
var_dump(Logger::list());