Getting Started

This guide will help you set up your development environment and start building with TIX Protocol as an integrator.

SDK Installation

Install the SDK

npm install @tixprotocol/sdk
# or
yarn add @tixprotocol/sdk

Install Dependencies

npm install @solana/web3.js @solana/spl-token

Integrator Onboarding

Before you can create events and issue tickets, you need to be registered as an integrator with TIX Protocol. Contact the TIX Protocol team to get registered.

Once registered, you'll receive:

• Your Integrator Identity (public key)

• Your Integrator Authority keypair

• Your Treasury ATA address (for USDC)

Fund Your Treasury

Your integrator treasury must have USDC to pay protocol fees. Transfer USDC to your treasury ATA before issuing tickets.

import { getAssociatedTokenAddress, transfer } from "@solana/spl-token";

// Transfer USDC to your treasury
await transfer(
  connection,
  fundingKeypair,
  sourceUsdcAta,
  treasuryAta,
  fundingKeypair,
  1_000_000_000 // $1000 in minor units
);

Quick Start Example

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

// Connect to Solana
const connection = new Connection("https://api.devnet.solana.com");

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

// Create an event
const { tx: eventTx, event } = await registerEvent({
  connection,
  payer: integratorAuthority.publicKey,
  integratorIdentity: integratorAuthority.publicKey,
  integratorAuthority: integratorAuthority.publicKey,
  eventId: 1n,
  totalSupply: 1000n,
  royaltyBps: 500,
  minRoyaltyFloor: 100_000n,
  royaltyRecipients: [],
});

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

// Issue tickets to buyers
const issueTx = await issuePermits({
  connection,
  payer: integratorAuthority.publicKey,
  integratorIdentity: integratorAuthority.publicKey,
  integratorAuthority: integratorAuthority.publicKey,
  eventId: 1n,
  buyers: [buyerWallet1, buyerWallet2],
});

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

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

Next Steps

• Primary Ticket Sales — Learn how to create events and issue tickets

• Secondary Marketplace — Enable resales and transfers

• Integrator Guide — Complete integrator operations

• SDK Reference — Complete SDK documentation