2020-09-09 04:40:25 -07:00
|
|
|
## serum-dex
|
|
|
|
|
|
|
|
# Deploying the DEX
|
|
|
|
```
|
|
|
|
# run unit tests
|
|
|
|
./do.sh test dex
|
|
|
|
|
|
|
|
# compile the dex binary
|
|
|
|
./do.sh build dex
|
|
|
|
|
|
|
|
# deploy the dex to the configured solana cluster
|
2020-09-14 03:34:17 -07:00
|
|
|
DEX_PROGRAM_ID="$(solana deploy dex/target/bpfel-unknown-unknown/release/serum_dex.so --use-deprecated-loader | jq .programId -r)"
|
|
|
|
```
|
|
|
|
|
|
|
|
# Run the fuzz tests
|
|
|
|
```
|
|
|
|
cd dex
|
|
|
|
cargo install cargo-fuzz
|
|
|
|
cargo fuzz run multiple_orders
|
2020-09-09 04:40:25 -07:00
|
|
|
```
|
|
|
|
|
|
|
|
# Using the client utility
|
|
|
|
```
|
|
|
|
cd crank
|
2020-09-14 03:34:17 -07:00
|
|
|
|
|
|
|
# read the autogenerated help text
|
2020-09-09 04:40:25 -07:00
|
|
|
cargo run -- help
|
2020-09-14 03:34:17 -07:00
|
|
|
|
|
|
|
# supported options are localnet, mainnet, testnet, devnet
|
|
|
|
CLUSTER=localnet
|
|
|
|
|
|
|
|
# verify that you have SOL balances for gas
|
|
|
|
KEYPAIR=~/.config/solana/id.json
|
|
|
|
solana balance -k $KEYPAIR
|
|
|
|
|
|
|
|
# run the demo script (this is mostly a smoke test)
|
|
|
|
cargo run -- $CLUSTER whole-shebang $KEYPAIR $DEX_PROGRAM_ID
|
|
|
|
|
|
|
|
# list a market with the default tick size and minimum quantity.
|
|
|
|
# if both assets have 6 decimals, this will be a quantity of 1 and a tick size of 0.01
|
|
|
|
COIN_MINT="..."
|
|
|
|
PRICE_CURRENCY_MINT="..."
|
|
|
|
cargo run -- $CLUSTER list-market $KEYPAIR $DEX_PROGRAM_ID --coin-mint $COIN_MINT --pc-mint $PRICE_CURRENCY_MINT
|
2020-09-09 04:40:25 -07:00
|
|
|
```
|
2020-09-15 07:29:38 -07:00
|
|
|
|
|
|
|
# First-time setup
|
|
|
|
```
|
|
|
|
# Building the dex
|
|
|
|
sudo apt-get install -y pkg-config build-essential python3-pip jq
|
|
|
|
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
|
|
|
|
source $HOME/.cargo/env
|
|
|
|
curl -sSf https://raw.githubusercontent.com/solana-labs/solana/v1.3.9/install/solana-install-init.sh | sh -s - v1.3.9
|
|
|
|
export PATH="/home/ubuntu/.local/share/solana/install/active_release/bin:$PATH"
|
|
|
|
|
|
|
|
git clone https://github.com/project-serum/serum-dex
|
|
|
|
cd serum-dex
|
|
|
|
./do.sh update
|
|
|
|
./do.sh build dex
|
|
|
|
|
|
|
|
# run a solana cluster. in a new shell:
|
|
|
|
git clone https://github.com/solana-labs/solana --branch v1.3.10
|
|
|
|
cd solana
|
|
|
|
sudo apt-get install -y libssl-dev libudev-dev zlib1g-dev llvm clang
|
|
|
|
cargo build --release
|
|
|
|
export RUST_LOG=solana_runtime::system_instruction_processor=trace,solana_runtime::message_processor=info,solana_bpf_loader=debug,solana_rbpf=debug
|
|
|
|
NDEBUG=1 ./run.sh
|
|
|
|
|
|
|
|
# Deploy the dex to our cluster (in the old shell)
|
|
|
|
solana config set -u http://127.0.0.1:8899
|
2020-09-15 07:42:06 -07:00
|
|
|
solana-keygen new
|
|
|
|
solana airdrop 100
|
2020-09-15 07:29:38 -07:00
|
|
|
DEX_PROGRAM_ID="$(solana deploy dex/target/bpfel-unknown-unknown/release/serum_dex.so --use-deprecated-loader | jq .programId -r)"
|
|
|
|
CLUSTER=localnet
|
|
|
|
KEYPAIR=~/.config/solana/id.json
|
|
|
|
|
|
|
|
# run the demo script (this is mostly a smoke test)
|
|
|
|
cargo run -- $CLUSTER whole-shebang $KEYPAIR $DEX_PROGRAM_ID
|
|
|
|
```
|