solana-program-library/token-swap

Token Swap Program

A Uniswap-like exchange for the Token program on the Solana blockchain.

Full documentation is available at https://spl.solana.com/token-swap

JavaScript bindings are available in the ./js directory.

Audit

The repository README contains information about program audits.

Building master

To build a development version of the Token Swap program, you can use the normal build command for Solana programs:

cargo build-sbf

Testing

Unit tests

Run unit tests from ./program/ using:

cargo test

Fuzz tests

Using the Rust version of honggfuzz, we "fuzz" the Token Swap program every night. Install honggfuzz with:

cargo install honggfuzz

From there, run fuzzing from ./program/fuzz with:

cargo hfuzz run token-swap-instructions

If the program crashes or errors, honggfuzz dumps a .fuzz file in the workspace, so you can debug the failing input using:

cargo hfuzz run-debug token-swap-instructions hfuzz_workspace/token-swap-instructions/*fuzz

This command attaches a debugger to the test, allowing you to easily see the exact problem.

Integration tests

You can test the JavaScript bindings and on-chain interactions using solana-test-validator, included in the Solana Tool Suite. See the CLI installation instructions.

From ./js, install the required modules:

npm i

Then run all tests:

npm run start-with-test-validator