Poolz Finance
Documentation
The complete reference for investors, project teams, and developers building on the Poolz Finance decentralized launchpad protocol.
Introduction
What is Poolz Finance?
Poolz Finance is a decentralized, cross-chain token launchpad protocol that enables blockchain projects to raise capital through community-driven Initial DEX Offerings (IDOs). Unlike centralized launchpads, Poolz operates entirely on-chain — every pool creation, contribution, and token release is governed by audited smart contracts with no single point of control.
Launched in 2021, Poolz has facilitated over $2.5M in funding across 9 successful IDOs, delivering an average ATH return of over 40x across all hosted projects. The protocol supports Ethereum, BNB Chain, Polygon, Arbitrum, and Avalanche, with Solana integration in active development.
Core Protocol
The Poolz protocol is built around three core primitives:
A factory contract that deploys isolated pool contracts for each IDO. Each pool defines the token being sold, the accepted currency, the hard cap, soft cap, and vesting schedule.
Raised funds and sold tokens are held in a non-custodial vault contract. Token releases follow a programmable vesting schedule defined at pool creation — no manual intervention required.
A staking-based whitelist system that maps wallet addresses to allocation tiers. Addresses must hold a minimum staked balance of $POOLZ to qualify for guaranteed allocations.
Supported Chains
Token: $POOLZ & $POOLX
$POOLZ is the native governance and utility token of the Poolz Finance protocol. Staking $POOLZ grants access to whitelist tiers and guaranteed IDO allocations. Token holders can participate in governance votes to influence protocol upgrades, fee structures, and new chain integrations.
$POOLX is the community token available on BNB Chain via PancakeSwap and on Solana via pump.fun. It serves as the expanded ecosystem token bridging the Poolz community across chains.
Getting Started
Connecting Your Wallet
Poolz Finance uses Privy for wallet authentication. Privy supports all major Web3 wallets including MetaMask, Coinbase Wallet, WalletConnect-compatible wallets, and hardware wallets via Ledger Live.
- 1
Click 'Connect Wallet' in the top navigation bar.
- 2
Select your preferred wallet from the Privy modal.
- 3
Approve the connection request in your wallet extension or app.
- 4
Your wallet address will appear, and your staking tier will be detected automatically.
- 5
If no account is associated with your wallet, you may be prompted to choose a different wallet or complete onboarding.
Staking Tiers
Access to IDO allocations is determined by how much $POOLZ you have staked in the Poolz Staking Vault. There are three tiers:
Entry-level participation. You are entered into a randomized lottery for each IDO pool. No guaranteed allocation, but equal chance for all Bronze holders.
A guaranteed allocation is reserved for every Silver-tier holder in every IDO. Allocation size is proportional to your staked amount relative to total Silver-tier stakers.
The highest allocation tier. Gold holders receive the maximum capped allocation per IDO, priority access to private rounds, and early access to new chain launches.
Participating in an IDO
Once whitelisted for a pool, participation follows this flow:
A 24–48 hour window before the sale opens where whitelisted addresses confirm their intent to participate.
The live sale window, typically 24–72 hours, during which participants send the accepted currency (USDT, USDC, or native coin) to the pool contract.
After the sale closes, funds are locked in the vault contract. The project team can only access funds upon meeting predefined milestones.
The date when the sold tokens are minted and begin releasing to investors per the vesting schedule defined in the pool contract.
Claiming Tokens
Token claiming is done directly on the Poolz dApp after TGE. Navigate to "My Pools" in your dashboard, select the IDO, and click "Claim" when your vesting tranche is unlocked. The claim function calls the smart contract directly — tokens are transferred to your wallet with no intermediary.
For Projects
How to Apply
Projects apply to launch on Poolz Finance through the "Submit Your Project" form on the main website. Applications are reviewed by the Poolz team within 3–5 business days. The review process evaluates team credibility, tokenomics, audit status, and market fit.
IDO Structure
Poolz Finance supports multiple pool types to accommodate different fundraising needs:
Fixed-price token sale with a defined hard cap. Participants contribute accepted currency and receive tokens at TGE. Best for most projects.
Investors commit funds without seeing others' bids. Final allocation price is determined by total demand. Ideal for high-demand launches.
No hard cap on contributions. Final allocation is proportional to each investor's share of the total raised. Excess funds are refunded.
Investors receive tokens only after a lockup period, in exchange for a discounted entry price. Suitable for long-term aligned investors.
Vesting & TGE
All vesting parameters are encoded into the pool contract at deployment and cannot be modified post-launch. This ensures investors can independently verify when and how tokens will be released. Common vesting structures include:
- Cliff + Linear: A lockup period followed by continuous linear release over N months.
- Milestone-based: Token releases triggered by on-chain verified milestone completion.
- Immediate TGE: 100% of tokens released at TGE with no lockup. Discouraged for most IDOs.
- Quarterly tranches: Tokens released in defined percentage chunks each quarter post-TGE.
Audit Requirements
All projects launching on Poolz Finance are strongly recommended to submit a smart contract audit report from a recognized Web3 security firm before the IDO goes live. Projects without an audit must explicitly disclose this in the pool description and acknowledge the associated risks.
Recognized auditors include CertiK, Hacken, PeckShield, Trail of Bits, and OpenZeppelin. The Poolz team reserves the right to delay or decline any IDO if security concerns are identified during due diligence.
Smart Contracts
Architecture Overview
The Poolz V2 protocol is composed of four core contracts deployed on each supported chain:
Security Model
Poolz employs a defense-in-depth security model. Contracts are non-upgradeable by default — once deployed, pool contracts cannot be altered. Administrative actions (fee updates, emergency pauses) are gated behind a 4-of-7 multisig controlled by the core team and independent security council members.
An emergency pause function exists at the factory level that can halt new pool creation without affecting already-deployed pools. Individual pool contracts do not have pause functionality to protect in-progress IDOs from unilateral interruption.
SDK & API
Installation
Initialization
Pool Queries
Participation Flow
Security
Audit Reports
All core Poolz V2 contracts have been audited by independent third-party security firms. Audit reports are publicly available on the Poolz GitHub repository.
Bug Bounty
Poolz Finance operates an active bug bounty program on Immunefi with rewards up to $50,000 for critical vulnerabilities in deployed smart contracts. All responsible disclosures are acknowledged within 48 hours. Report findings via the Immunefi platform or directly to security@poolz.finance.
Multisig Treasury
The Poolz protocol treasury is controlled by a 4-of-7 multisig Gnosis Safe. Signers include four core team members and three independent external advisors. All treasury transactions above $10,000 require multisig approval and are announced to the community 48 hours in advance via Twitter.
Governance
Voting Mechanics
Any wallet holding at least 1,000 staked $POOLZ can submit a governance proposal. Voting power is 1:1 with staked balance — there is no delegation or quadratic weighting. Votes are cast on-chain via the Poolz governance portal or directly via the GovernorBravo contract.
Proposal Lifecycle
Off-chain discussion on Twitter and the Poolz community forum. Community feedback shapes the final proposal.
Proposal is submitted on-chain. Requires a 1,000 $POOLZ proposer threshold.
Token holders cast votes on-chain. Early closure possible if quorum and supermajority reached.
Approved proposals are queued in the timelock contract, giving users time to react before execution.
After the timelock, any address can trigger execution. The Governor contract calls the target contract directly.
Quorum Requirements
A proposal requires a minimum of 4% of total staked $POOLZ supply to vote (quorum) and a simple majority (50% + 1 vote) to pass. Constitutional changes to core protocol parameters (fee structures, token supply, quorum thresholds) require a 2/3 supermajority.
FAQ
Investor FAQ
Is Poolz Finance non-custodial?
Yes. Poolz is entirely non-custodial. Your funds are sent directly to audited pool contracts and released to you automatically per the vesting schedule. The Poolz team cannot access investor funds at any point.
Which wallets are supported?
Poolz supports all EVM-compatible wallets via WalletConnect, including MetaMask, Coinbase Wallet, Ledger Live, Trust Wallet, and Rainbow. Authentication is handled by Privy.
Can I lose my staked $POOLZ?
Staked $POOLZ is not subject to slashing. You can unstake at any time (subject to the chosen lock period), and your principal is always returned in full.
What happens if an IDO doesn't hit its soft cap?
If a pool closes below its soft cap, all investor contributions are fully refunded directly from the pool contract. No fees are charged on failed IDOs.
How do I verify my allocation on-chain?
Each pool contract exposes a getContribution(address) view function. You can call this directly on the relevant block explorer or via the Poolz SDK to verify your position independently.
Project FAQ
How long does the review process take?
Initial review takes 3–5 business days. If your project passes the first review, a deeper due diligence process follows, typically taking 7–14 days including team KYC and contract review.
What fees does Poolz charge for launching an IDO?
Poolz charges a 2% protocol fee on the total amount raised, deducted from proceeds at pool close. There are no upfront listing fees for approved projects.
Can we choose our own vesting structure?
Yes, within reason. Poolz provides recommended vesting templates, but projects can propose custom schedules. All schedules must include at least a 30-day cliff post-TGE for investor protection.
Is KYC required for the project team?
Yes. At least two core team members must complete KYC verification via our third-party provider. This is non-negotiable and is disclosed publicly in the pool listing.
Technical FAQ
Are the contracts open source?
Yes. All Poolz protocol contracts are open source and available on GitHub at github.com/The-Poolz. Deployments are verified on Etherscan, BscScan, and equivalent block explorers on all supported chains.
Which Solidity version is used?
Poolz V2 contracts are written in Solidity ^0.8.20 and compiled with the Paris EVM target for maximum compatibility across L1 and L2 networks.
Does Poolz use any upgradeable proxy patterns?
Pool contracts themselves are non-upgradeable to maximize trust. The GovernorBravo and StakingVault use an owner-controlled UUPS proxy, with all upgrade events gated behind the 48-hour timelock.
Something missing or incorrect? Open an issue on GitHub