https://github.com/project-serum/serum-dex

Project Serum Rust Monorepo
https://github.com/project-serum/serum-dex

Last synced: about 2 months ago
JSON representation

Project Serum Rust Monorepo

• Host: GitHub
• URL: https://github.com/project-serum/serum-dex
• Owner: project-serum
• License: apache-2.0
• Created: 2020-08-06T05:41:59.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2024-06-07T10:08:14.000Z (6 months ago)
• Last Synced: 2024-10-19T14:02:49.277Z (about 2 months ago)
• Language: Rust
• Homepage: https://projectserum.com
• Size: 1.24 MB
• Stars: 627
• Watchers: 34
• Forks: 328
• Open Issues: 65
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-blockchain-rust - Serum-dex
• awesome-solana - Serum Monorepo - serum/serum-dex.svg?style=social) Project Serum Rust Monorepo. Serum was the first Central Limit Order Book (CLOB) on Solana, and has been a cornerstone of Solana Defi. (Code / Defi)

README

        


  


  
serum-dex


  


    Project Serum Rust Monorepo

  


  


    

    

    

  


  


    Website

     | 

    Discord

     | 

    Awesome

     | 

    DEX

     | 

    TypeScript

  



## Program Deployments

| Program | Devnet | Mainnet Beta |

| --------|--------|------------- |

| [DEX](/dex)     | `DESVgJVGajEgKGXhb6XmqDHGz3VjdgP7rEVESBgxmroY` | `9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin` |

## Note

* **Serum is in active development so all APIs and protocols are subject to change.**

* **The code is unaudited. Use at your own risk.**

## Contributing

### Install Rust

```bash

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

source $HOME/.cargo/env

rustup component add rustfmt

```

On Linux systems you may need to install additional dependencies. On Ubuntu,

```bash

sudo apt-get install -y pkg-config build-essential python3-pip jq

```

### Install Solana

Directions can be found [here](https://docs.solana.com/cli/install-solana-cli-tools#use-solanas-install-tool).

### Download the source

```bash

git clone https://github.com/project-serum/serum-dex.git

```

### Build, deploy, and test programs

See individual crates for documentation. For example, to build the dex see its [README](https://github.com/project-serum/serum-dex/tree/master/dex).

## Running a local Solana cluster

The easiest way to run a local cluster is to use [solana-test-validator](https://docs.solana.com/developing/test-validator).

## Directories

* `assert-owner`: Solana utility program for checking account ownership.

* `common`: Common rust utilities.

* `dex`: Serum DEX program and client utility.

* `pool`: Serum pool protocol.

* `scripts`: Bash scripts for development.