An open API service indexing awesome lists of open source software.

https://github.com/xastro6/wagus-reward-system

WAGUS Reward System Smart Contract Program: A Rust-based smart contract for the Solana blockchain designed to manage and reward user interactions in the WAGUS reward system. This repository contains the core logic for the reward mechanism, as well as the associated configuration and utility files.
https://github.com/xastro6/wagus-reward-system

blockchain cryptocurrency defi programming rewards rust smart-contract solana system

Last synced: about 1 month ago
JSON representation

WAGUS Reward System Smart Contract Program: A Rust-based smart contract for the Solana blockchain designed to manage and reward user interactions in the WAGUS reward system. This repository contains the core logic for the reward mechanism, as well as the associated configuration and utility files.

Awesome Lists containing this project

README

          

# ๐Ÿš€ WAGUS Reward System

A Solana smart contract (program) that powers the **WAGUS token** reward system. This program is designed to handle token-based rewards on the Solana blockchain, utilizing SPL tokens and built with Rust.

## ๐Ÿ“œ Description
This project implements a decentralized reward system for the **WAGUS** ecosystem. Users can earn and claim rewards in WAGUS tokens through on-chain interactions.

## ๐Ÿ› ๏ธ Built With
- [Rust](https://www.rust-lang.org/)
- [Solana Program Library (SPL)](https://spl.solana.com/)
- [Borsh](https://borsh.io/) (for serialization)
- Solana SDK

## ๐Ÿ“‚ Project Structure
```
โ”œโ”€โ”€ /src # Contains the main source code of the smart contract
โ”‚ โ””โ”€โ”€ lib.rs # Main contract code
โ”‚
โ”œโ”€โ”€ /tests # Contains test files for the smart contract
โ”‚ โ””โ”€โ”€ test-lib.rs # Unit and integration tests
โ”‚
โ”œโ”€โ”€ .gitattributes # Git configuration for handling file attributes
โ”œโ”€โ”€ .gitignore # Git ignore rules for excluding unnecessary files
โ”œโ”€โ”€ cargo.lock # Rust's lock file for dependencies
โ”œโ”€โ”€ cargo.toml # Rust's package configuration file
โ”œโ”€โ”€ readme.md # This file
โ”œโ”€โ”€ testclient.js # JavaScript file to interact with the smart contract
```

## ๐Ÿš€ Deployments
| Network | Program ID |
|----------|-----------------------------------------|
| Devnet | `2ga161fxHesc8YATYz2CconNkTSpCJVABrjbBKGtRYGF` |

## โšก Getting Started

### Prerequisites
- [Rust](https://www.rust-lang.org/tools/install)
- [Solana CLI](https://docs.solana.com/cli/install-solana-cli-tools)
- [Node.js](https://nodejs.org/) (if using JS tests)
- Git

### Install Dependencies
```bash
cargo build-bpf
```

### Deploy Program
```bash
solana program deploy target/deploy/wagus_reward_system.so
```

## ๐Ÿงช Testing
```bash
cargo test
```

Or, for Solana test validator:
```bash
solana-test-validator
```

## ๐ŸŒ Resources
- [Solana Docs](https://docs.solana.com/)
- [SPL Token Docs](https://spl.solana.com/token)
- [Anchor Framework (optional)](https://book.anchor-lang.com/)

## ๐Ÿ“œ License
This project is licensed under the [Apache 2.0 License](LICENSE).

## โœจ Author
**xastro**
[GitHub](https://github.com/xastro6)
```