Tizzle
Help Center

How can we help?

Guides for organizers, attendees, and gatekeepers on the Tizzle protocol.

🚀
Getting Started
4 guides
🏢
Organization
4 guides
📅
Managing Events
5 guides
🎟️
Attending Events
6 guides
🔐
Gatekeeper
5 guides
Staking & Refunds
5 guides
🚀
Section 01

Getting Started

What is Tizzle?

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.

How do I set up a Solana wallet?

Tizzle supports standard Solana wallets. We recommend the following:

Phantom

Browser extension & mobile app. Most popular Solana wallet. Download at phantom.app

Solflare

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.

How do I connect my wallet to Tizzle?
  1. 01 Open the Tizzle app and click Connect Wallet in the top right corner.
  2. 02 Select your wallet provider (Phantom, Solflare, or other compatible wallets).
  3. 03 Approve the connection request in your wallet app.
  4. 04 You'll be prompted to sign a message to verify ownership — this does not cost any SOL.
What tokens are supported for staking?

Tizzle supports multiple token standards on Solana:

SOL Native Solana token
SPL Token Standard Solana fungible tokens
Token-2022 Next-gen Solana token standard with extensions

The token type accepted for each event is set by the organizer at creation time.

🏢
Section 02

Organization

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.

How do I create an organization?

Creating an organization registers your wallet as an organizer on-chain. Here's how:

  1. 01 Connect your wallet and navigate to Dashboard → Organizations → Create New.
  2. 02 Fill in your organization name and optional metadata (logo, description).
  3. 03 Approve and sign the create_organization transaction in your wallet. A small SOL fee covers the on-chain account storage (rent).
  4. 04 Once confirmed, a Program Derived Address (PDA) is created on-chain as your Organization Account.

Your wallet address becomes the owner of the organization. Only this wallet can create events under this organization.

Can I have multiple organizations?

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.

Can I edit or delete my organization?

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.

What are the wallet requirements for an organizer?

As an organizer, your wallet needs:

Enough SOL for rent — a small amount (~0.002–0.01 SOL) to cover on-chain account storage for the organization and each event
Platform fee — paid in SOL when creating an event: capacity × fee_per_slot
Transaction fees — a few lamports per transaction for Solana network fees
📅
Section 03

Managing Events

Events are the core unit of the Tizzle protocol. All event parameters are set at creation time and stored immutably on-chain.

How do I create an event?

You must have an organization before creating events.

  1. 01 Go to your organization dashboard and click Create Event.
  2. 02 Fill in event details: name, description, location, date/time.
  3. 03 Set on-chain parameters: capacity, stake amount, token type, start time, and unlock time.
  4. 04 Configure attendance settings: whether attendance is required for refund, and optional host fee percentage.
  5. 05 Review the total platform fee (capacity × fee_per_slot) and approve the transaction in your wallet.

All on-chain parameters are permanent after the transaction is confirmed. Double-check everything before signing.

What is the platform fee and how is it calculated?

Tizzle uses a Pay-per-Slot model. The platform fee is calculated as:

Total Fee = Capacity × Fee Per Slot

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.

What is the unlock time and why does it matter?

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.

Can I edit event details after creation?

It depends on what you want to change:

Off-chain metadata (name, description, banner image) — editable anytime via the dashboard.
On-chain parameters (capacity, stake amount, unlock time, token type) — permanently locked after creation.
What happens if I cancel my event?

If you cancel an event, you as the organizer are responsible for communicating this to attendees. On the protocol level:

Attendees' staked tokens are still locked until the unlock time. You should set a short unlock time or use the admin refund mechanism to release stakes early.
The platform fee paid at creation is non-refundable.
🎟️
Section 04

Attending Events

As an attendee, you stake tokens to reserve your spot, check in at the event, and claim your refund afterwards.

How do I register for an event?
  1. 01 Browse events and open the one you want to attend.
  2. 02 Review the event details including the stake amount, token type, and refund conditions.
  3. 03 Click Register and approve the staking transaction in your wallet.
  4. 04 Your tokens are locked in an escrow PDA and a Registration Account is created on-chain with your wallet address.
  5. 05 You'll receive a QR code tied to your wallet — save this for check-in at the event.

Make sure you have the required token balance before registering. The exact stake amount is shown on the event page.

What happens to my tokens while they're staked?

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.

Can I cancel my registration?

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.

How do I check in at an event?

Attendance is verified via a QR code scan performed by the event's gatekeeper.

  1. 01 Open the Tizzle app on your phone and navigate to My Tickets → [Event Name].
  2. 02 Show your QR code to the event gatekeeper at the venue entrance.
  3. 03 The gatekeeper scans your QR — this records your attendance on the Solana blockchain in real-time.
  4. 04 Your registration status updates to checked_in: true on-chain.
How do I claim my refund?

Refunds are not automatic — you must claim them after the unlock time.

  1. 01 After the event's unlock time has passed, open the event in your My Tickets page.
  2. 02 If you attended and were checked in, a Claim Refund button will appear.
  3. 03 Click it and approve the claim_refund transaction. Your staked tokens are returned to your wallet instantly.

There is no expiry on unclaimed refunds — your tokens stay safely in escrow until you claim them.

What if I don't attend — do I lose my stake?

It depends on the event's attendance_required setting configured by the organizer:

attendance_required = false — you can claim your full stake back regardless of whether you attended.
attendance_required = true — your stake is forfeited (in whole or part) if you were not checked in. Forfeited stakes may go to the organizer's host fee wallet.

This setting is clearly shown on the event page before you register.

🔐
Section 05

Gatekeeper

The Gatekeeper is the person (or device) responsible for scanning attendee QR codes at the event venue, recording attendance on-chain.

What is a Gatekeeper?

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.

How do I set up a gatekeeper for my event?
  1. 01 In your event dashboard, navigate to Settings → Gatekeeper.
  2. 02 Enter the wallet address you want to authorize as gatekeeper. This can be your own wallet or a staff member's.
  3. 03 Share the Gatekeeper Scanner URL with your staff — this is a mobile-optimized page that only requires the gatekeeper wallet to be connected.
  4. 04 On event day, the gatekeeper opens the scanner, connects their wallet, and can start scanning QR codes immediately.
How does the QR scanning process work?

When a gatekeeper scans an attendee's QR code, the following happens:

1 The QR code contains the attendee's wallet address and event ID.
2 The app verifies the attendee's registration PDA exists on-chain and is not yet checked in.
3 The gatekeeper wallet signs and submits a check_in transaction.
4 The registration PDA is updated on-chain: checked_in = true.
5 The scanner shows a green confirmation. The whole process takes under 1 second on Solana.
Does the gatekeeper need SOL in their wallet?

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.

What if the network is slow during check-in?

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.

Section 06

Staking & Refunds

How does the staking mechanism work?

The flow works in 5 steps:

Lock At registration, your tokens are transferred from your wallet into a PDA escrow account.
Hold Tokens are held securely until the event's unlock time. Nobody can access them.
Verify At the event, the gatekeeper scans your QR to record attendance on-chain.
Unlock After the unlock time, the smart contract allows eligible attendees to claim their refund.
Claim You submit a claim transaction and your staked tokens are returned to your wallet instantly.
What is a PDA (Program Derived Address)?

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.

When can I claim my refund?

You can claim your refund when all of these conditions are met:

The event's unlock time has passed
If attendance was required: your wallet was checked in by the gatekeeper
You have not already claimed this refund

There is no deadline to claim your refund — your tokens remain in the escrow indefinitely until claimed.

Are there any fees deducted from my refund?

Tizzle charges zero platform fee to attendees. However, some events may have an organizer-configured host fee:

Your Refund = Stake Amount − (Stake Amount × 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.

What happens to forfeited stakes?

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:

Sent to the organizer's host fee wallet
Or split between the organizer and the Tizzle protocol treasury, depending on configuration

All forfeit rules are transparent and encoded in the smart contract — visible on-chain before you stake.

🛠
Section 07

Troubleshooting

My transaction failed — what do I do?

Common reasons for transaction failure:

Insufficient SOL balance

Ensure your wallet has enough SOL for both the stake amount and network fees.

Event is full

The event has reached its capacity. Registration is no longer possible.

Unlock time not reached

You're trying to claim a refund before the unlock time. Wait until the event's unlock time has passed.

Network congestion

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.

My QR code isn't scanning — what should I check?
Increase your screen brightness to maximum
Ensure you're on the correct event's ticket page (not a different event)
Ask the gatekeeper to ensure camera permissions are enabled in their browser
If the QR still won't scan, the gatekeeper can manually look up your wallet address in the attendee list
My refund button isn't showing up

Check the following in order:

1 Unlock time: The event's unlock time may not have passed yet. Check the event detail page for the exact unlock timestamp.
2 Attendance not verified: If the event required attendance, confirm your check-in status is true on-chain via Solana Explorer.
3 Already claimed: Your refund may have already been claimed in a previous session.
I attended the event but I'm not marked as checked in

If the gatekeeper scanned your QR but your on-chain status wasn't updated, this could be due to:

The gatekeeper's transaction failed silently (network issue) — check if the event was using offline mode, in which case the sync may be pending.
The gatekeeper scanned the wrong QR code or an invalid code.

Contact the event organizer directly with proof of attendance. They have an admin override to manually verify check-in before the unlock time.

I have another issue not listed here

Reach out to the Tizzle community and team: