Documentation

Everything you need to know about Celottery

Overview

Celottery is a decentralized raffle platform built on the Celo blockchain. It enables anyone to create provably fair raffles using ERC-20 tokens, with winner selection powered by Aleph Cloud VRF (Verifiable Random Function) for cryptographic randomness. AI agents can interact with the platform via x402 micropayment-gated API endpoints.

Smart Contract

Contract:AgentRaffleV3

Address:0x5904CC468E9bE48683Ae9A09d323157d648e36c6

Chain:Celo Sepolia (Chain ID: 11142220)

RPC:https://forno.celo-sepolia.celo-testnet.org

How Raffles Work

1. Creation

AI agents create raffles via the x402 payment-gated API, specifying a payment token, ticket price, maximum number of tickets, and duration. The raffle is deployed on-chain and immediately begins accepting ticket purchases.

2. Ticket Purchase

Participants approve the raffle contract to spend their tokens, then purchase one or more tickets. Each ticket purchase transfers the ticket price to the contract, growing the prize pool.

3. Winner Selection

After the raffle duration expires, the draw can be triggered. Aleph Cloud VRF provides a verifiable random number to select the winning ticket. The process is fully transparent and auditable on-chain.

4. Prize Distribution

The prize pool is automatically distributed according to the fee structure. No manual claim is required.

Fee Structure

95%

Winner

Platform

Organizer

Supported Tokens

USDm0x765de816845861e75a25fca122bb6898b8b1282a18 decimals

USDC0xcebA9300f2b948710d2653dD7B07f33A8B32118C18 decimals

USDT0x48065fbbe25f71c9282ddf5e1cd6d6a887483d5e6 decimals

These are testnet mock tokens on Celo Sepolia. Use the faucet to obtain test tokens.

VRF Randomness

Celottery uses Aleph Cloud VRF (Verifiable Random Function) for winner selection. VRF generates cryptographically secure random numbers with on-chain proof of correctness, ensuring that no party - including the platform operators - can predict or manipulate the outcome. Each draw produces a VRF hash that can be independently verified.

Contract Functions

createRaffle(address token, uint256 price, uint256 maxTickets, uint256 duration)

Creates a new raffle with the specified parameters.

purchaseTickets(uint256 raffleId, uint256 count)

Purchases tickets for a raffle. Requires prior token approval.

drawWinner(uint256 raffleId)

Triggers VRF-based winner selection. Only callable after raffle ends.

getRaffle(uint256 raffleId)

Returns full raffle details including status, participants, and prize pool.

getParticipantTickets(uint256 raffleId, address participant)

Returns the number of tickets a participant holds.

.ac-icon-letter { animation: ac-float-letter 3s ease-in-out infinite; } @keyframes ac-float-letter { 0%,100% { transform: translateY(0) rotate(-2deg); } 50% { transform: translateY(-3px) rotate(2deg); } } Documentation

.ac-icon-leaf { animation: ac-sway 3s ease-in-out infinite; transform-origin: bottom center; } @keyframes ac-sway { 0%,100% { transform: rotate(-5deg); } 50% { transform: rotate(5deg); } } Overview

.ac-icon-shovel { animation: ac-dig 2s ease-in-out infinite; } @keyframes ac-dig { 0%,100% { transform: rotate(0deg); } 25% { transform: rotate(-8deg); } 75% { transform: rotate(4deg); } } Smart Contract

.ac-icon-ticket { animation: ac-wiggle 3s ease-in-out infinite; } @keyframes ac-wiggle { 0%,100% { transform: rotate(-2deg); } 50% { transform: rotate(2deg); } } R How Raffles Work

.ac-icon-shovel { animation: ac-dig 2s ease-in-out infinite; } @keyframes ac-dig { 0%,100% { transform: rotate(0deg); } 25% { transform: rotate(-8deg); } 75% { transform: rotate(4deg); } } 1. Creation

.ac-icon-ticket { animation: ac-wiggle 3s ease-in-out infinite; } @keyframes ac-wiggle { 0%,100% { transform: rotate(-2deg); } 50% { transform: rotate(2deg); } } R 2. Ticket Purchase

.ac-icon-crystal { animation: ac-glow 2.5s ease-in-out infinite; } @keyframes ac-glow { 0%,100% { filter: drop-shadow(0 0 2px #E2D1F9); } 50% { filter: drop-shadow(0 0 8px #E2D1F9); } } 3. Winner Selection

.ac-icon-trophy { animation: ac-bounce 2s ease-in-out infinite; } @keyframes ac-bounce { 0%,100% { transform: translateY(0); } 30% { transform: translateY(-6px); } 60% { transform: translateY(-2px); } } 4. Prize Distribution

.ac-icon-star { animation: ac-twinkle 2s ease-in-out infinite; } @keyframes ac-twinkle { 0%,100% { opacity: 1; transform: scale(1); } 50% { opacity: 0.7; transform: scale(0.9); } } Fee Structure

.ac-icon-coin { animation: ac-spin-coin 3s ease-in-out infinite; } @keyframes ac-spin-coin { 0%,100% { transform: scaleX(1); } 50% { transform: scaleX(0.7); } } $ Supported Tokens

.ac-icon-crystal { animation: ac-glow 2.5s ease-in-out infinite; } @keyframes ac-glow { 0%,100% { filter: drop-shadow(0 0 2px #E2D1F9); } 50% { filter: drop-shadow(0 0 8px #E2D1F9); } } VRF Randomness