Primary Ticket Sales

This guide covers the complete workflow for creating events and issuing tickets through TIX Protocol.

Overview

Primary sales involve two main steps:

1. Event Registration — Create an event with supply and royalty settings

2. Permit Issuance — Issue tickets to buyers

Prerequisites

Before creating events, ensure you have:

• Been registered as an integrator with TIX Protocol

• Funded your integrator treasury with USDC

• Your integrator authority keypair

Event Registration

Create an Event

import { registerEvent } from "@tixprotocol/sdk";

const { tx, event } = await registerEvent({
  connection,
  payer: integratorAuthority.publicKey,
  integratorIdentity: integratorKeypair.publicKey,
  integratorAuthority: integratorAuthority.publicKey,
  eventId: 1n, // Unique event identifier
  totalSupply: 5000n, // Maximum tickets
  royaltyBps: 500, // 5% royalty on resales
  minRoyaltyFloor: 100_000n, // Minimum $1.00 royalty
  royaltyRecipients: [
    { destination: artistRoyaltyAta, bps: 300 }, // 3% to artist
    { destination: venueRoyaltyAta, bps: 200 }, // 2% to venue
  ],
});

tx.sign([integratorAuthority]);
await connection.sendTransaction(tx);

Event Configuration Options

Parameter	Type	Description
eventId	bigint	Unique identifier for the event
totalSupply	bigint	Maximum number of tickets
royaltyBps	number	Royalty percentage (basis points, 0-10000)
minRoyaltyFloor	bigint	Minimum royalty per sale (USDC minor units)
royaltyRecipients	Array	Up to 3 recipients with BPS splits

Royalty Recipient Setup

Recipients must have USDC ATAs to receive royalties:

import { getOrCreateAssociatedTokenAccount } from "@solana/spl-token";

// Create ATAs for royalty recipients
const artistRoyaltyAta = await getOrCreateAssociatedTokenAccount(
  connection,
  payer,
  USDC_MINT,
  artistWallet.publicKey
);

const venueRoyaltyAta = await getOrCreateAssociatedTokenAccount(
  connection,
  payer,
  USDC_MINT,
  venueWallet.publicKey
);

Important: The sum of recipient BPS must equal royaltyBps:

royaltyBps = 500 (5%)
recipients[0].bps = 300 (3%)
recipients[1].bps = 200 (2%)
Sum: 300 + 200 = 500 ✓

Permit Issuance

Issue Multiple Tickets

import { issuePermits } from "@tixprotocol/sdk";

const buyers = [buyer1.publicKey, buyer2.publicKey, buyer3.publicKey];

const tx = await issuePermits({
  connection,
  payer: integratorAuthority.publicKey,
  integratorIdentity: integratorKeypair.publicKey,
  integratorAuthority: integratorAuthority.publicKey,
  eventId: 1n,
  buyers,
});

tx.sign([integratorAuthority]);
await connection.sendTransaction(tx);

Ticket ID Assignment

Ticket IDs are sequential and must be within total supply:

// Valid ticket IDs for an event with totalSupply: 5000
// 0, 1, 2, 3, ... 4999

// This will fail
const invalidTicketId = 5000n; // >= totalSupply

// Tickets are stored in pages of 128
// ticketId 0-127   → page 0
// ticketId 128-255 → page 1
// etc.

Complete Example

End-to-End Primary Sale

import { Connection, Keypair } from "@solana/web3.js";
import { registerEvent, issuePermits, getEvent } from "@tixprotocol/sdk";

async function primarySaleFlow() {
  const connection = new Connection("https://api.devnet.solana.com");

  // Load your integrator keypair
  const integrator = Keypair.fromSecretKey(/* your secret key */);

  // 1. Create event
  const { tx: eventTx, event } = await registerEvent({
    connection,
    payer: integrator.publicKey,
    integratorIdentity: integrator.publicKey,
    integratorAuthority: integrator.publicKey,
    eventId: 1001n,
    totalSupply: 2000n,
    royaltyBps: 750, // 7.5%
    minRoyaltyFloor: 200_000n, // $2.00 minimum
    royaltyRecipients: [
      { destination: artistAta, bps: 500 }, // 5%
      { destination: venueAta, bps: 250 }, // 2.5%
    ],
  });
  eventTx.sign([integrator]);
  await connection.sendTransaction(eventTx);

  // 2. Issue tickets as customers purchase
  const purchasers = [
    customer1.publicKey,
    customer2.publicKey,
    customer3.publicKey,
  ];

  const issueTx = await issuePermits({
    connection,
    payer: integrator.publicKey,
    integratorIdentity: integrator.publicKey,
    integratorAuthority: integrator.publicKey,
    eventId: 1001n,
    buyers: purchasers,
  });
  issueTx.sign([integrator]);
  await connection.sendTransaction(issueTx);

  // 3. Verify event state
  const eventState = await getEvent(connection, event);
  console.log(`Minted: ${eventState.minted}/${eventState.totalSupply}`);
}

User Journey: Fan Buys Ticket

┌─────────────────────────────────────────────────────────────┐
│                  FAN PURCHASE JOURNEY                       │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  1. Alice visits marketplace website                        │
│                                                             │
│  2. Alice selects event and ticket tier                     │
│                                                             │
│  3. Alice pays via marketplace checkout                     │
│     (credit card, crypto, etc.)                             │
│                                                             │
│  4. Marketplace calls issuePermit with Alice's wallet       │
│                                                             │
│  5. On-chain:                                               │
│     ├── Permit created with Alice as owner                  │
│     ├── Permit fee deducted from integrator treasury        │
│     └── Event.minted counter incremented                    │
│                                                             │
│  6. Alice sees ticket in her wallet/app                     │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Error Handling

Common errors during primary sales:

Error	Cause	Solution
SupplyExceeded	Ticket ID >= total supply	Use valid ticket ID
TicketAlreadyMinted	Ticket ID already issued	Use different ticket ID
IntegratorSuspended	Integrator not active	Contact TIX Protocol support
InsufficientFunds	Treasury lacks USDC	Fund integrator treasury
TooManyRoyaltyRecipients	More than 3 recipients	Reduce to max 3
RoyaltyBpsMismatch	Recipient BPS don't sum to royaltyBps	Fix BPS allocation

Next Steps

• Secondary Marketplace — Enable ticket resales

• Integrator Guide — Complete integrator operations

• SDK Reference — Detailed SDK documentation