Move FWD 2025

Challenge 1: Simple Token Faucet (Easy)

Problem Statement

Build a token faucet that distributes test tokens to users. Users can request tokens once, and the faucet tracks who has already claimed.

Requirements

• Create a faucet that holds a balance of tokens
• Users can request a fixed amount of tokens (e.g., 100 tokens)
• Each address can only claim once
• Track which addresses have already claimed
• Emit events when tokens are claimed

Key Concepts to Implement

• Shared objects for the faucet
• Balance management
• Address tracking using Table
• Basic access control

Function Signatures to Implement

Expected Output

• Users can call claim() and receive 100 SUI
• Attempting to claim twice should fail
• Events are emitted for tracking

Test Cases to Implement

1. User claims successfully
2. User tries to claim twice (should fail)
3. Multiple users claim
4. Admin adds more tokens

Hint

You'll need Balance<SUI>, Coin<SUI>, and Table types

What to Submit

1. Complete Move module implementation for your chosen challenge(s)
2. Move.toml file with dependencies:
   
   
   
   

3. Basic tests showing your module works

4. README.md explaining how to build and test

How to test locally

Where to submit

You can submit here: 

https://gitlab.alkimi.org/suicoders/token-faucet

How to submit

To make a submission, you must do the following:

1. Clone this repo

2. Push to this by creating your own branch

Evaluation Criteria

• Completeness (50%): All required functions implemented
• Correctness (30%): Code compiles and works as expected
• Code Quality (20%): Clean, readable code with comments

Tips

• You need to define your own structs based on the requirements
• Figure out which imports you need from the Sui framework
• Start with the struct definitions, then implement functions
• Use assert! statements for validation
• Add error constants for better debugging
• Check the Sui examples repo for reference patterns

Resources

• Sui Move Book: https://docs.sui.io/guides/developer/move
• Sui Examples: https://github.com/MystenLabs/sui/tree/main/examples
• Move Language Reference: https://move-language.github.io/move/
• Sui Framework Docs: https://docs.sui.io/references/framework