Program Reference (Mainnet)

Overview

Use this page for the public mainnet values needed by TxLINE integrations. Keep the Solana RPC, program ID, TxL mint, guest JWT host, activation endpoint, and API host on the same network.

Do not activate a mainnet transaction on the devnet API host. A mainnet subscription transaction must be activated with https://txline.txodds.com.

Mainnet Values

Type	Value
Solana RPC	`https://api.mainnet-beta.solana.com`
Program ID	`9ExbZjAapQww1vfcisDmrngPinHTEfpjYRWMunJgcKaA`
TxL Token Mint	`Zhw9TVKp68a1QrftncMSd6ELXKDtpVMNuMGr1jNwdeL`
Guest Auth	`https://txline.txodds.com/auth/guest/start`
Activation	`https://txline.txodds.com/api/token/activate`
API Base	`https://txline.txodds.com/api/`
Backend Admin Key	`54Wot8oX53yKTtfoJwMc8RHrsqL1p6WC71devAoB1GGT`

Activation

After subscribe(serviceLevelId, durationWeeks) confirms, activate the API token by signing this exact message with the same wallet that submitted the transaction:

${txSig}:${selectedLeagues.join(",")}:${jwt}

For the standard free bundle, selectedLeagues = [], so the message is:

${txSig}::${jwt}

Send the detached wallet signature as base64 in walletSignature, and send the guest JWT from the mainnet host as Authorization: Bearer <jwt>.

Validation Accounts

Account	Seed(s)	Used for
Daily scores roots	`daily_scores_roots`, epoch day as u16 little-endian	Score proof validation with `validateStatV4`
Daily batch roots	`daily_batch_roots`, epoch day as u16 little-endian	Odds proof validation
Ten daily fixtures roots	`ten_daily_fixtures_roots`, aligned epoch day as u16 little-endian	Fixture proof validation

The epoch day is the number of whole UTC days since 1 January 1970: Math.floor(timestampMs / 86_400_000). The aligned epoch day rounds it down to a multiple of 10. See Epoch Day for details.

Derive the epoch day from the timestamp in the proof response, never from Date.now(). For scores and odds V4 validation, use payload.ts; for fixtures, use snapshot.Ts. Recompute it for every proof.

import { PublicKey } from "@solana/web3.js";
import { BN } from "@coral-xyz/anchor";

const programId = new PublicKey("9ExbZjAapQww1vfcisDmrngPinHTEfpjYRWMunJgcKaA");

function epochDayFromProofTimestamp(proofTimestampMs: number): number {
  if (!Number.isSafeInteger(proofTimestampMs) || proofTimestampMs < 0) {
    throw new Error("Expected a non-negative proof timestamp in milliseconds");
  }

  const epochDay = Math.floor(proofTimestampMs / 86400000);
  if (epochDay > 0xffff) {
    throw new Error("Proof timestamp is outside the u16 epoch-day range");
  }
  return epochDay;
}

function deriveDailyValidationPda(
  seed: "daily_scores_roots" | "daily_batch_roots",
  proofTimestampMs: number
): PublicKey {
  const epochDay = epochDayFromProofTimestamp(proofTimestampMs);
  return PublicKey.findProgramAddressSync(
    [Buffer.from(seed), new BN(epochDay).toArrayLike(Buffer, "le", 2)],
    programId
  )[0];
}

function deriveTenDailyFixturesPda(fixtureProofTimestampMs: number): PublicKey {
  const epochDay = epochDayFromProofTimestamp(fixtureProofTimestampMs);
  const alignedEpochDay = Math.floor(epochDay / 10) * 10;
  return PublicKey.findProgramAddressSync(
    [
      Buffer.from("ten_daily_fixtures_roots"),
      new BN(alignedEpochDay).toArrayLike(Buffer, "le", 2),
    ],
    programId
  )[0];
}

Ticket Accounts

These accounts belong to the booking and V4 validation instructions. They apply on mainnet once mainnet runs the program version that includes book_fixture, validate_fixture_for_tree, and close_worker_ticket.

Account	Seed(s)	Used for
Fixture ticket	`fixture_ticket`, wallet public key (32 bytes), `fixtureId` as u32 little-endian	Created by `book_fixture` per `(wallet, fixtureId)`; required by `validateStatV4` and `validateOddsV4`
Worker ticket	`worker_ticket`, wallet public key (32 bytes), `domain` as u8, `workerId` as u16 little-endian	Staged by `validateFixtureForTree`, consumed by `validateStatV4` / `validateOddsV4`, closed by `closeWorkerTicket`
Token treasury v2	`token_treasury_v2`	Authority of the vault that receives TxL paid in `book_fixture`; the vault is its TOKEN-2022 associated token account for the TxL mint

The IDL does not embed PDA seeds for these accounts, so the seeds above are not read from it. fixtureId is encoded as 4 bytes.

function deriveFixtureTicketPda(wallet: PublicKey, fixtureId: number): PublicKey {
  return PublicKey.findProgramAddressSync(
    [Buffer.from("fixture_ticket"), wallet.toBuffer(), new BN(fixtureId).toArrayLike(Buffer, "le", 4)],
    programId
  )[0];
}

function deriveWorkerTicketPda(wallet: PublicKey, domain: number, workerId: number): PublicKey {
  return PublicKey.findProgramAddressSync(
    [
      Buffer.from("worker_ticket"),
      wallet.toBuffer(),
      Buffer.from([domain]),
      new BN(workerId).toArrayLike(Buffer, "le", 2),
    ],
    programId
  )[0];
}

const tokenTreasuryV2 = PublicKey.findProgramAddressSync([Buffer.from("token_treasury_v2")], programId)[0];

domain and workerId are client-chosen. See On-Chain Validation for the sequence that uses them.

Score Validation

The public score validation endpoints:

API request	On-chain method	Use case
`/scores/stat-validation-v4?fixtureId=...&seq=...&statKeys=1,2,...`	`validateFixtureForTree` → `validateStatV4` → `closeWorkerTicket`	Single-stat or multi-stat validation with a `strategy`; requires a `fixture_ticket`

Book the fixture with book_fixture before validating it; see Booking Fixtures. Use a real seq value from an observed score record. For V4 validation, keep the requested statKeys order stable because strategy indexes refer to those same positions.

Getting started

Odds

Scores

Solana Programs

Examples

Legal

Overview

Mainnet Values

Activation

Validation Accounts

Ticket Accounts

Score Validation

​Overview

​Mainnet Values

​Activation

​Validation Accounts

​Ticket Accounts

​Score Validation

​Related Guides

Overview

Mainnet Values

Activation

Validation Accounts

Ticket Accounts

Score Validation

Related Guides