Skip to content

awebisam/awebucks

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AweBucks Smart Contracts

NOTE: Frontend Under Development 💬

This repository contains the smart contracts for AweBucks Token, AweBucks Lottery, and Faucet deployed on the Sepolia network.

Contract Addresses

AweBucks Token

AweBucks Token is an ERC20-compliant token on the Sepolia network. It has the following features:

  • Name: AweBucks
  • Symbol: AWB
  • Decimals: 2
  • Total Supply: 100,000,000 AWB [10 Billion * 0.01 AWB]

Holding AweBucks tokens entitles you to a dividend of 1% for every 24 hours. 🤫

AweBucks Lottery

AweBucks Lottery is a decentralized lottery platform built on the Sepolia network. It offers a chance to win the accumulated AweBucks tokens. The lottery operates as follows:

  • Entry Fee: 10 AWB
    • You need to approve the lottery contract to spend 10 AWB from your address. You can do this by calling the approve() function with the lottery contract address on the AweBucks token contract. This is needed by ERC20 standard.
    • Users can participate in the lottery by calling the enter() function.
    • The lottery contract will automatically transfer 10 AWB from the caller's address to the lottery contract.
  • 0.5 AWB from each entry fee is sent to the contract owner as a fee.
  • At the end of the lottery, a random winner is selected using Chainlink VRF.
  • The entire balance of the lottery contract, minus the owner's fee, is automatically transferred to the winner's address.

Faucet

The Faucet contract allows users to request AweBucks tokens. It has the following characteristics:

  • Drip Rate: 10 AWB per minute
  • Users can request AweBucks tokens from the faucet by calling the claimTokens() function.
  • The faucet will distribute 10 AWB tokens per minute to the caller's address.

Usage

To interact with the AweBucks Token, AweBucks Lottery, or Faucet contracts on the Sepolia network, follow these steps:

  1. Connect to the Sepolia network using your preferred Ethereum client or wallet.

  2. Use the respective contract addresses mentioned above to interact with the contracts:

Contributing

Contributions are welcome! If you find any issues or have suggestions for improvement, please feel free to submit a pull request or open an issue in this repository.

License

This project is licensed under the MIT License.