Skip to content

Latest commit

 

History

History
110 lines (80 loc) · 2.44 KB

README.md

File metadata and controls

110 lines (80 loc) · 2.44 KB
Raw

Whitelist Token Sale

This project implements a whitelist-gated token sale using Anchor, a framework for Solana programs. The program allows whitelisted users to purchase tokens at a static price with a limit per wallet address.

Scope

Develop a program using Native Rust or Anchor to allow users to participate in a whitelist-gated sale for a new token. Ensure the token price remains static and set a purchase limit per wallet.

Features

  1. Whitelist-Gated Sale: Allows only whitelisted users to purchase tokens.
  2. Static Token Price: The token price remains static throughout the sale.
  3. Purchase Limit: Sets a purchase limit per wallet address.

Prerequisites

  • Rust
  • Solana CLI
  • Node.js
  • Yarn
  • Anchor

Installation

  1. Install Solana CLI:

    sh -c "$(curl -sSfL https://release.solana.com/stable/install)"

  2. Install Rust:

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

  3. Install Node.js and Yarn:

    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.38.0/install.sh | bash
nvm install --lts
npm install --global yarn

  4. Install Anchor:

    cargo install --git https://github.com/project-serum/anchor --tag v0.19.0 anchor-cli --locked

Setup

  1. Clone the repository:

    [email protected]:0xCipherCoder/whitelist-token-sale.git
cd whitelist-token-sale

  2. Install dependencies:

    npm install
anchor build

  3. Deploy the programs to Solana Local Tesnet:

    anchor deploy

Usage

Building the Program

  1. Build the Solana program:

    anchor build

  2. Deploy the program to your local Solana cluster:

    anchor deploy

Running Tests

  1. Ensure your local Solana test validator is running:

    solana-test-validator

  2. Run the tests:

    anchor test

Test Report

anchor test
  Finished release [optimized] target(s) in 0.14s

Found a 'test' script in the Anchor.toml. Running it as a test suite!

Running test suite: "/home/pradip/Cipher/OpenSource/whitelist-token-sale/Anchor.toml"
whitelist-token-sale
  ✔ Initializes the sale correctly
  ✔ Allows a whitelisted buyer to purchase tokens (413ms)
  ✔ Prevents non-whitelisted buyers from purchasing tokens (1258ms)
  ✔ Prevents buyers from exceeding the max tokens per wallet


4 passing (5s)