Light Protocol

The ZK Layer for Solana

Light is a zkLayer enabling stateless program execution, purpose-built for Solana.

Developers can use Light to...

• reduce the cost of state on the Solana L1.
• build zk applications that compose with Light state such as
  • offchain orderbooks
  • zk-coprocessors
  • zk-identity

Note: All these tools and the protocol are in active development and unaudited. To work with this Monorepo, read below:

The documentation is available here: https://github.com/Lightprotocol/developer-content/tree/main/docs.

Development environment

There are three ways of setting up the development environment:

• devenv.sh script - the most recommended one, both for Linux and macOS. Works with Bash and zsh.
• Development Containers - recommended on Linux, unfortunately has performance problems on macOS.
• Manual setup - not recommended, but may be useful if the methods above don't work for you.

devenv.sh

The easiest way to setup the development environment is to use our scripts and development environment.

First, install the dependencies (they will be installed in the .local directory inside your repository clone).

./scripts/install.sh

Then, activate the development environment:

./scripts/devenv.sh

Then follow the sections below, which describe the usage of build.sh and test.sh scripts.

When the development environment is active, you can manually run commands like pnpm, cargo, solana, solana-test-validator. They are going to use the dependencies installed in .local directory, so even if you have different global installations, they are not going to interfere.

Development Containers

Light Protocol fully embraces Development Containers, providing a ready-to-use Docker container image that comes pre-configured with all necessary dependencies for building and testing.

Support for Development Containers (either native or through a plugin) is provided by the following IDEs and editors:

• Visual Studio Code
• Neovim
• Emacs

Manual setup

If you still want to setup dependencies manually, these are the requirements:

• Rust installed with Rustup, stable and nightly toolchains
• NodeJS (16.16 LTS)
• Anchor (0.26.0)

Building

To build the project, use the following commands:

./scripts/build.sh

Solana keypair

Before doing any development or running any tests, you need to generate a new local keypair:

solana-keygen new -o ~/.config/solana/id.json

Tests

Global

./scripts/test.sh

Rust tests

cd light-verifier-sdk/
RUST_MIN_STACK=8388608 cargo test

SDK tests

cd js/stateless.js
pnpm test

Circuit tests

cd light-circuits
pnpm test

Anchor tests

Tests are located in tests/ directory.

The default test is a functional test, setting up a test environment with a Merkle tree and an spl token, conducting two compressions and decompressions.

Tests can be executed in bulk or one by one.

anchor test

Common errors

If you're seeing this error:

• error: package `solana-program v1.16.4` cannot be built because it requires rustc 1.68.0 or newer, while the currently active rustc version is 1.65.0-dev

update your solana-cli version to >=1.16.4.

For more support from the community and core developers, open a GitHub issue or join the Light Protocol Discord: https://discord.gg/J3KvDfZpyp