Skip to content

lukypool-protocol/lukypool-docs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 

Repository files navigation

LukyPool Documentation

LukyPool is a decentralized, non-custodial prize-linked savings protocol built on Arbitrum.

The protocol is designed as financial infrastructure — not a speculative product. Its primary objective is capital preservation while distributing yield as prizes in a transparent, fully on-chain, and verifiable manner.

This repository contains protocol documentation, architectural overviews, and grant-oriented materials for LukyPool.


Problem Statement

Retail users participating in DeFi are often exposed to:

  • Principal risk through volatile strategies
  • Complex yield mechanisms lacking transparency
  • Custodial reward systems
  • Opaque prize logic and off-chain randomness

Existing prize-linked savings implementations frequently depend on centralized operators or hybrid off-chain components, reducing verifiability and trust.

There is a need for a fully on-chain, non-custodial savings protocol that preserves user principal while enabling participation in yield-based incentive systems.


Solution Overview

LukyPool enables users to deposit supported stable assets (initially USDC) into on-chain pool vaults where:

  • Deposits remain fully withdrawable at all times
  • Principal is never used for prize distribution
  • Yield generated from pooled capital funds periodic prizes
  • All draw logic and distribution mechanisms are executed on-chain

The protocol separates capital preservation from reward generation.


Capital Preservation Model

Capital protection is foundational to LukyPool’s design.

  • Deposited principal is held within segregated vault logic.
  • Prize distribution is strictly limited to accrued yield.
  • No contract function permits principal drawdown for prize allocation.
  • Accounting mechanisms distinguish principal from yield at all times.
  • Prize execution includes safeguards to prevent accidental principal leakage.

Participation in prize cycles does not expose users to capital erosion through prize funding.


Prize Distribution Model

LukyPool distributes prizes on a recurring schedule (initially weekly).

The model includes:

  • Periodic yield aggregation from pool vaults
  • Snapshot of eligible ticket holders prior to draw execution
  • On-chain selection of winning combination (verifiable randomness or deterministic logic)
  • Automated prize distribution to the winning wallet

Prize size is determined by:

  • Accrued yield within the pool
  • Configurable distribution parameters
  • Optional sponsor contributions

No off-chain selection or manual intervention is required.


Ticket System

Each deposit generates participation entries (“tickets”) proportional to the deposited amount.

Core properties:

  • Tickets represent combinations of 4 numbers selected from 1–20
  • Total theoretical combinations: 4,845
  • Users may manually select combinations or use automated selection logic
  • Odds are dynamically calculated based on total active tickets
  • Ticket persistence logic ensures correct eligibility at draw time

The system is deterministic, transparent, and verifiable on-chain.


Protocol Architecture (High-Level)

LukyPool is modular by design.

Primary components:

  • PoolFactory – Deploys and manages individual pool instances.
  • Pool Vault – Holds user deposits and integrates yield strategies.
  • Ticket Manager – Allocates and tracks ticket ownership.
  • Draw Manager – Executes scheduled prize logic.
  • Prize Distributor – Transfers yield-based rewards to winners.
  • Strategy Interface – Integration layer for yield generation.

The PoolFactory enables scalable deployment of multiple independent pools while maintaining standardized security controls and configuration parameters.

Each module is designed to be auditable, upgrade-aware, and isolated in responsibility.


Why Arbitrum

LukyPool is consumer-facing infrastructure with recurring user interaction:

  • Deposits
  • Withdrawals
  • Ticket management
  • Scheduled prize execution

These characteristics require:

  • Low transaction costs
  • High throughput
  • Predictable UX
  • DeFi composability

Arbitrum provides:

  • Low and stable gas fees
  • High execution throughput
  • Mature ecosystem integration
  • Alignment with transparent, on-chain financial systems

Deployment contributes sustained, recurring on-chain activity rather than speculative one-time usage.


Risk Considerations

As with all DeFi infrastructure, risks exist:

  • Smart contract vulnerabilities (unaudited status)
  • Yield strategy risk
  • Randomness integrity risk
  • Liquidity constraints
  • Integration dependency risk

Mitigation strategy includes:

  • Modular contract architecture
  • Audit preparation prior to scale
  • Conservative yield integration
  • Transparent on-chain reporting

Roadmap

Phase 1

  • Core smart contract architecture
  • Local development and internal testing
  • Initial deployment on Arbitrum

Phase 2

  • MVP live deployment on Arbitrum
  • Early user validation
  • UX refinement and pool mechanics optimization
  • Metrics instrumentation

Phase 3

  • Security review preparation
  • Expanded user cohort
  • Monitoring, reporting, and iterative improvements

Success Metrics (KPIs)

Performance on Arbitrum will be evaluated using measurable on-chain indicators:

  • Unique wallets interacting with pools
  • Total Value Locked (TVL)
  • Number of transactions per draw cycle
  • Deposit and withdrawal frequency
  • Successful completion rate of scheduled draws
  • Yield-to-prize conversion ratio

Metrics will be transparently tracked and reported.


Grant Objectives

Support from the Arbitrum ecosystem would enable:

  • Acceleration of development milestones
  • Security review preparation
  • Structured testnet and mainnet deployment
  • Transparent metrics reporting

Grant funding will not be allocated toward speculative trading or unrelated marketing initiatives.


Status

The protocol is under active development.

Smart contracts are unaudited and not production-ready. Documentation will evolve alongside milestone-based releases.


Contact

info@lukypool.com

About

Documentation, architecture, and grant materials for the LukyPool protocol.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors