Casper Trade

A decentralized exchange (DEX) implementation based on Uniswap V2, built for the Casper Network using the Odra framework. Casper Trade provides automated market maker (AMM) functionality with liquidity pools, token swaps, and yield farming capabilities.

Architecture

The implementation tries to follow the Uniswap V2 implementation 1 to 1. It is based on the two following repositories:

• https://github.com/Uniswap/v2-periphery
• https://github.com/Uniswap/v2-core

Due to differences between Casper and EVM, there are some minor differences in the architecture:

Factory

Uniswap's version of the factory deploys Pair contracts directly using create2 and Pair's bytecode stored in the Factory contract.

Casper's mechanism is different and Odra's implementation of it is as follows:

• Odra automatically generates PairFactory contract for the Pair (factory=on directive)
• PairFactory's sole purpose is to manage deployments and upgrades of new Pair contracts
• Factory's create_pair calls factory() method of PairFactory contract. PairFactory deploys a new Pair contract and returns the address of the new contract to the Factory.

Tests

Tests are based on the original Uniswap tests to ensure parity. Router tests are based on UniswapV2Router01.spec.ts and UniswapV2Router02.spec.ts from v2-periphery repository.

Factory tests are based on UniswapV2Factory.spec.ts from v2-core repository.

Pair tests are based on UniswapV2Pair.spec.ts from v2-core repository.

Contracts

Below is the list of contracts created and used by the project.

• Pair - Main pair contract. It will not be deployed directly, instead PairFactory will deploy it in runtime. It corresponds to UniswapV2Pair contract from Uniswap.
• PairFactory - Pair contract factory. Its code is generated automatically by Odra. It is responsible for deploying Pair contracts.
• Router - Router contract. It corresponds to UniswapV2Router.
• Factory - Factory contract for pair management. Its corresponding Uniswap contract is UniswapV2Factory.
• SampleToken - Sample CEP-18 token contract used for testing.
• WrappedNativeToken - Token from Odra modules used for testing.

Prerequisites

• Rust (latest stable version)
• cargo-odra - Odra framework CLI tool
• Docker (optional - for local Casper node testing)

Installation

1. Clone the repository:

git clone git@github.com:odradev/casper-trade.git
cd casper-trade

2. Install cargo-odra:

cargo install cargo-odra

3. Run the tests:

just test

Quick Start

Using Just Commands

This project uses just for task automation.

Available Commands

Testing

# Run all tests (Casper backend)
just test

Code Quality

# Run clippy linter
just clippy

# Format code
just lint

# Check formatting without changing files
just check-lint

CLI Usage

# Run CLI with arguments
just cli <arguments>

# Example: Deploy contracts
just cli deploy

# Example: Get help
just cli --help

Local Casper Node Testing

# Start local Casper node with nctl
just run-nctl

# Run CLI commands against local node
just cli-on-nctl <arguments>

# Example: Deploy to local node
just cli-on-nctl deploy

Building

Casper Backend Build

To build WASM files for Casper Network deployment:

cargo odra build -b casper

The compiled WASM files will be placed in the wasm/ directory.

CLI Tool

The Casper Trade CLI provides easy deployment and interaction with contracts. See CLI documentation for detailed usage.

Basic Usage

# Deploy all contracts
just cli deploy

# Create a trading pair
just cli scenario CreatePair --token0 <address> --token1 <address>

# Mint tokens
just cli scenario MintTokens --recipient <address> --amount 1000

Local casper node

Setting up Local Casper Node

1. Start the local Casper node:

just run-nctl

2. Deploy contracts to local node:

just cli-on-nctl deploy

3. Interact with deployed contracts:

just cli-on-nctl contract Factory fee_to

Resources

• Odra Framework
• Casper Network
• Uniswap V2
• CEP-18 Standard