Instruction Builders

The SDK provides instruction builder functions that return fully-populated Transaction objects with all required account metas.

Event Instructions

registerEvent

Create a new event.

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

const { tx, event } = await registerEvent({
  connection,
  payer: integratorAuthority.publicKey,
  integratorIdentity: integratorKeypair.publicKey,
  integratorAuthority: integratorAuthority.publicKey,
  eventId: 1001n,
  totalSupply: 5000n,
  royaltyBps: 500,
  minRoyaltyFloor: 100_000n,
  royaltyRecipients: [
    { destination: artistAta, bps: 300 },
    { destination: venueAta, bps: 200 },
  ],
});

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

Parameters:

Parameter	Type	Description
eventId	bigint	Unique event identifier
totalSupply	bigint	Maximum ticket count
royaltyBps	number	Royalty percentage (0-10000)
minRoyaltyFloor	bigint	Minimum royalty (USDC minor units)
royaltyRecipients	Array<{destination, bps}>	Up to 3 recipients

Permit Instructions

issuePermits

Issue multiple permits in one transaction.

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

const tx = await issuePermits({
  connection,
  payer: integratorAuthority.publicKey,
  integratorIdentity: integratorKeypair.publicKey,
  integratorAuthority: integratorAuthority.publicKey,
  eventId: 1001n,
  buyers: [buyer1.publicKey, buyer2.publicKey, buyer3.publicKey],
});

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

transferPermit

Transfer permit ownership.

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

const tx = await transferPermit({
  connection,
  payer: currentOwner.publicKey,
  eventId: 1001n,
  ticketId: 42n,
  currentOwner: currentOwner.publicKey,
  newOwner: newOwner.publicKey,
  integratorIdentity: integratorKeypair.publicKey,
});

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

markUsed

Mark a permit as used (redeemed).

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

const tx = await markUsed({
  connection,
  payer: integratorAuthority.publicKey,
  eventId: 1001n,
  ticketId: 42n,
  integratorIdentity: integratorKeypair.publicKey,
  integratorAuthority: integratorAuthority.publicKey,
});

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

markVoid

Mark a permit as void (cancelled).

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

const tx = await markVoid({
  connection,
  payer: integratorAuthority.publicKey,
  eventId: 1001n,
  ticketId: 42n,
  integratorIdentity: integratorKeypair.publicKey,
  integratorAuthority: integratorAuthority.publicKey,
});

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

Listing Instructions

listTicket

List a ticket for sale.

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

const tx = await listTicket({
  connection,
  payer: seller.publicKey,
  eventId: 1001n,
  ticketId: 42n,
  seller: seller.publicKey,
  askPriceMinor: 100_000_000n, // $100
  payoutAta: sellerUsdcAta,
  expiresAt: Math.floor(Date.now() / 1000) + 86400,
  buyerAllow: null, // Open to all
});

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

Parameters:

Parameter	Type	Description
askPriceMinor	bigint	Price in USDC minor units
payoutAta	PublicKey	Seller's payout ATA
expiresAt	number	Unix timestamp
buyerAllow	PublicKey | null	Optional: restrict to buyer

acceptOffer

Purchase a listed ticket.

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

const tx = await acceptOffer({
  connection,
  payer: buyer.publicKey,
  eventId: 1001n,
  ticketId: 42n,
  buyer: buyer.publicKey,
  buyerUsdcAta: buyerUsdcAta,
  integratorIdentity: integratorKeypair.publicKey,
});

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

cancelListing

Cancel an active listing.

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

const tx = await cancelListing({
  connection,
  payer: seller.publicKey,
  eventId: 1001n,
  ticketId: 42n,
  authority: seller.publicKey, // seller or integrator
});

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

Integrator Instructions

updateIntegratorAuthority

Update your integrator's signing authority.

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

const tx = await updateIntegratorAuthority({
  connection,
  payer: currentAuthority.publicKey,
  integratorIdentity: integratorIdentity.publicKey,
  currentAuthority: currentAuthority.publicKey,
  newAuthority: newAuthority.publicKey,
});

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

Transaction Patterns

Multiple Instructions

const tx = new Transaction();

// Add multiple instructions
const { tx: tx1 } = await issuePermits({
  /* buyer 1 */
});
const { tx: tx2 } = await issuePermits({
  /* buyer 2 */
});

tx.add(...tx1.instructions);
tx.add(...tx2.instructions);

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