Glossary
Definitions of key terms used throughout TIX Protocol documentation.
Core Concepts
Permit
The on-chain record representing a ticket. Each permit tracks:
Current owner (wallet public key)
Status (Active, Used, or Void)
Version number (increments on changes)
Ticket ID (unique within an event)
Integrator
A third-party platform (marketplace, venue, or event organizer) that uses TIX Protocol for ticketing operations. Integrators can create events, issue tickets, and facilitate transfers.
Event
An on-chain account that defines a ticketed occasion. Events specify total supply, royalty configuration, and are owned by an integrator.
Listing
A secondary market sale record. When a ticket holder lists their ticket for resale, a Listing account stores the ask price, payout destination, expiration, and buyer restrictions.
Technical Terms
PDA (Program Derived Address)
A deterministic address generated from seeds. TIX Protocol uses PDAs for all account storage, allowing addresses to be computed client-side without storing them.
ATA (Associated Token Account)
A standardized SPL token account address derived from a wallet and token mint. Used for USDC holdings (treasuries, payouts, royalties).
Treasury
An integrator's USDC account that pays protocol fees (permit fees, transfer fees, resale fees). Must be funded before issuing tickets.
Minor Units
The smallest denomination of USDC. With 6 decimals, 1 USDC = 1,000,000 minor units. All on-chain amounts use minor units.
Basis Points (BPS)
A unit for expressing percentages where 100 BPS = 1%. Used for royalty and fee rates. Range: 0-10,000 (0-100%).
Account Types
ProtocolConfig
Account storing global settings: USDC mint, fee parameters, and protocol authority. Managed by TIX Protocol.
Integrator Account
PDA storing integrator configuration: authority key, status (Active/Suspended), and treasury ATA reference.
Event Account
PDA storing event configuration: total supply, minted count, royalty settings, and up to 3 royalty recipients.
PermitPage
Storage account holding up to 128 permits. Events span multiple pages as tickets are issued.
Listing Account
PDA storing secondary market listing details: seller, ask price, expiration, and permit version for validation.
Status Values
Permit Status
Active
0
Ticket is valid, can be transferred or sold
Used
1
Ticket has been redeemed at the venue
Void
2
Ticket has been cancelled or refunded
Integrator Status
Active
Can create events, issue tickets, facilitate operations
Suspended
Blocked from all operations until reinstated
Fee Types
Permit Fee
Fee charged per ticket issued. Deducted from integrator treasury and sent to the protocol vault.
Transfer Fee
Fee charged per direct (non-sale) ticket transfer. Deducted from integrator treasury.
Resale Fee
Percentage of the sale price charged on secondary market transactions. Deducted from integrator treasury.
Royalty
Percentage of resale price distributed to configured recipients (artists, venues, etc.). Paid by the buyer as part of the purchase price.
Royalty Floor
Minimum royalty amount per transaction, regardless of percentage calculation. Protects creators on low-price resales.
Operations
Issue / Mint
Creating a new permit (ticket) and assigning it to a buyer's wallet.
Transfer
Moving permit ownership from one wallet to another. Can be initiated by the owner or integrator authority.
List
Creating a secondary market listing for a ticket with an ask price and expiration.
Accept Offer
Purchasing a listed ticket. Triggers royalty distribution, seller payout, and ownership transfer.
Cancel Listing
Removing an active listing and unlocking the permit for direct transfers.
Mark Used
Setting a permit status to Used after venue check-in. Prevents further transfers.
Mark Void
Setting a permit status to Void (cancelled/refunded). Prevents further transfers.
SDK Terms
Instruction Builder
SDK function that constructs a Solana transaction with all required accounts and data for a specific operation.
Account Fetcher
SDK function that reads and parses on-chain account data into typed TypeScript objects.
Address Derivation
Computing PDA addresses client-side using known seeds. Allows finding accounts without on-chain lookups.
Solana Concepts
Transaction
A signed message containing one or more instructions to execute on-chain. Must be signed by required authorities.
Instruction
A single operation within a transaction. TIX Protocol instructions include register_event, issue_permit, etc.
Signer
A keypair that authorizes a transaction. Different operations require different signers (integrator, owner, etc.).
Blockhash
A recent block identifier included in transactions for replay protection. Transactions expire after ~60 seconds.
Compute Units
Solana's measure of computational work. Complex operations consume more compute units. Priority fees can be added for faster processing.
Common Abbreviations
BPS
Basis Points
PDA
Program Derived Address
ATA
Associated Token Account
SPL
Solana Program Library
USDC
USD Coin (stablecoin)
SDK
Software Development Kit
TX
Transaction
Last updated