Guides for organizers, attendees, and gatekeepers on the Tizzle protocol.
Tizzle is a decentralized event ticketing protocol built on the Solana blockchain. Instead of buying tickets in the traditional sense, attendees stake tokens to reserve their spot at an event.
When you attend the event and your attendance is verified via QR code scan, your staked tokens are returned to you in full (or partial, depending on the organizer's config).
This creates a commitment system that reduces no-shows, with zero platform fees charged to attendees. Organizers pay a flat fee per attendee slot when creating an event.
Tizzle supports standard Solana wallets. We recommend the following:
Browser extension & mobile app. Most popular Solana wallet. Download at phantom.app
Browser extension & mobile app with advanced features. Download at solflare.com
Important: Always save your seed phrase in a secure offline location. Tizzle cannot recover lost wallets.
Tizzle supports multiple token standards on Solana:
The token type accepted for each event is set by the organizer at creation time.
An Organization is the top-level entity on Tizzle. Every event must belong to an organization. Think of it as your brand or company profile on the protocol.
Creating an organization registers your wallet as an organizer on-chain. Here's how:
Your wallet address becomes the owner of the organization. Only this wallet can create events under this organization.
Yes. One wallet can own multiple organizations. Each organization gets its own on-chain PDA and can host independent events. This is useful if you manage multiple brands or event series under different identities.
Off-chain metadata (name, logo) can be updated at any time via the dashboard. However, the on-chain Organization PDA and its owner wallet are permanent — ownership cannot be transferred.
Closing (deleting) an organization is only possible if it has no active events with locked stakes.
As an organizer, your wallet needs:
Events are the core unit of the Tizzle protocol. All event parameters are set at creation time and stored immutably on-chain.
You must have an organization before creating events.
All on-chain parameters are permanent after the transaction is confirmed. Double-check everything before signing.
Tizzle uses a Pay-per-Slot model. The platform fee is calculated as:
Example: An event with 200 capacity at 0.0005 SOL per slot = 0.10 SOL total platform fee.
This fee is paid once at event creation, sent directly to the Tizzle Platform Treasury PDA, and is non-refundable. Attendees are never charged a platform fee.
The unlock time is a Unix timestamp set by the organizer that determines when attendees can claim their staked tokens back.
Typically set to a few hours after the event ends — giving you time to complete QR check-ins before refunds become claimable.
Before the unlock time, no one (including the organizer) can release the staked tokens. This is enforced by the smart contract.
It depends on what you want to change:
If you cancel an event, you as the organizer are responsible for communicating this to attendees. On the protocol level:
As an attendee, you stake tokens to reserve your spot, check in at the event, and claim your refund afterwards.
Make sure you have the required token balance before registering. The exact stake amount is shown on the event page.
Your tokens are locked inside a Program Derived Address (PDA) — an escrow account controlled exclusively by the Tizzle smart contract. No one, including the organizer or Tizzle team, can access your tokens.
The tokens remain there until either the unlock time passes (allowing you to claim your refund), or they are forfeited according to the event's attendance rules.
Cancellation depends on the organizer's configuration. Some events may allow early cancellation with a partial or full stake return before the event starts. Others may lock the stake until the unlock time regardless.
Check the event's cancellation policy on the event detail page before registering.
Attendance is verified via a QR code scan performed by the event's gatekeeper.
Refunds are not automatic — you must claim them after the unlock time.
There is no expiry on unclaimed refunds — your tokens stay safely in escrow until you claim them.
It depends on the event's attendance_required setting configured by the organizer:
This setting is clearly shown on the event page before you register.
The Gatekeeper is the person (or device) responsible for scanning attendee QR codes at the event venue, recording attendance on-chain.
A Gatekeeper is a wallet authorized by the event organizer to submit check_in transactions on behalf of attendees. When the gatekeeper scans a QR code, it triggers an on-chain transaction that marks the attendee's registration as checked in.
This can be the organizer's own wallet, a staff member's wallet, or a dedicated scanning device.
When a gatekeeper scans an attendee's QR code, the following happens:
Yes. The gatekeeper wallet pays the Solana transaction fee (~0.000005 SOL) for each check_in transaction they submit. For a 500-person event, this is approximately 0.0025 SOL total — a negligible amount.
We recommend keeping at least 0.05 SOL in the gatekeeper wallet to handle large events comfortably.
Tizzle uses priority fees to ensure check-in transactions are processed quickly even during network congestion. Solana's 400ms block time ensures near-instant confirmation in normal conditions.
In rare cases of network outage, Tizzle supports an offline check-in mode that stores check-ins locally and syncs to the blockchain once connectivity is restored.
The flow works in 5 steps:
A Program Derived Address (PDA) is a special type of Solana account that is controlled by a smart contract program rather than by a private key. No individual — not even the Tizzle team — can sign transactions from a PDA.
This means your staked tokens are protected entirely by code. The smart contract enforces all the rules (lock period, attendance requirement, refund eligibility) automatically and transparently.
You can claim your refund when all of these conditions are met:
There is no deadline to claim your refund — your tokens remain in the escrow indefinitely until claimed.
Tizzle charges zero platform fee to attendees. However, some events may have an organizer-configured host fee:
The host fee percentage (if any) is always shown on the event page before you register. You also pay a small Solana network fee (~0.000005 SOL) when submitting the claim transaction.
When an attendee's stake is forfeited (they didn't attend and attendance was required), the forfeited tokens are distributed as configured by the organizer at event creation:
All forfeit rules are transparent and encoded in the smart contract — visible on-chain before you stake.
Common reasons for transaction failure:
Ensure your wallet has enough SOL for both the stake amount and network fees.
The event has reached its capacity. Registration is no longer possible.
You're trying to claim a refund before the unlock time. Wait until the event's unlock time has passed.
Retry the transaction — Tizzle automatically applies priority fees but high congestion can occasionally cause failures.
Check the error message in your wallet app for more details, or look up your wallet address on Solana Explorer to inspect the failed transaction.
Check the following in order:
If the gatekeeper scanned your QR but your on-chain status wasn't updated, this could be due to:
Contact the event organizer directly with proof of attendance. They have an admin override to manually verify check-in before the unlock time.
Reach out to the Tizzle community and team:
No guides match your search. Try a different keyword or contact support.