@send-fun/sdk 1.0.0

package/src/dex/generated/events/poolCreateEvent.ts

@@ -0,0 +1,128 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+
+import {
+	containsBytes,
+	fixEncoderSize,
+	getAddressDecoder,
+	getBytesEncoder,
+	getI64Decoder,
+	getStructDecoder,
+	getU64Decoder,
+	getU8Decoder,
+	type Address,
+	type FixedSizeDecoder,
+	type ReadonlyUint8Array,
+} from '@solana/kit';
+import { SEND_DEX_PROGRAM_ADDRESS } from '../programs/index.js';
+import { ANCHOR_EVENT_CPI_DISCRIMINATOR } from './anchorEventCpiDiscriminator.framing.js';
+
+export const POOL_CREATE_EVENT_DISCRIMINATOR: ReadonlyUint8Array =
+	new Uint8Array([151, 215, 226, 9, 118, 161, 115, 174]);
+
+export function getPoolCreateEventDiscriminatorBytes(): ReadonlyUint8Array {
+	return fixEncoderSize(getBytesEncoder(), 8).encode(
+		POOL_CREATE_EVENT_DISCRIMINATOR,
+	);
+}
+
+export type PoolCreateEvent = {
+	pool: Address;
+	baseMint: Address;
+	baseDecimals: number;
+	quoteMint: Address;
+	quoteDecimals: number;
+	coinCreator: Address;
+	creatorFeeConfig: Address;
+	platformConfig: Address;
+	baseVault: Address;
+	quoteVault: Address;
+	lpMint: Address;
+	lpMinted: bigint;
+	baseReserves: bigint;
+	quoteReserves: bigint;
+	timestamp: bigint;
+};
+
+let getPoolCreateEventDecoderCache:
+	| FixedSizeDecoder<PoolCreateEvent>
+	| undefined;
+
+export function getPoolCreateEventDecoder(): FixedSizeDecoder<PoolCreateEvent> {
+	return (getPoolCreateEventDecoderCache ??= getStructDecoder([
+		['pool', getAddressDecoder()],
+		['baseMint', getAddressDecoder()],
+		['baseDecimals', getU8Decoder()],
+		['quoteMint', getAddressDecoder()],
+		['quoteDecimals', getU8Decoder()],
+		['coinCreator', getAddressDecoder()],
+		['creatorFeeConfig', getAddressDecoder()],
+		['platformConfig', getAddressDecoder()],
+		['baseVault', getAddressDecoder()],
+		['quoteVault', getAddressDecoder()],
+		['lpMint', getAddressDecoder()],
+		['lpMinted', getU64Decoder()],
+		['baseReserves', getU64Decoder()],
+		['quoteReserves', getU64Decoder()],
+		['timestamp', getI64Decoder()],
+	]));
+}
+
+/**
+ * Checks whether the event data matches the framing and discriminator bytes of a
+ * {@link PoolCreateEvent}, without decoding. Never throws.
+ *
+ * Returns `false` unless `event.programAddress` is SEND_DEX_PROGRAM_ADDRESS.
+ * Raw bytes carry no emitter and SKIP that check.
+ *
+ * @see parsePoolCreateEvent to decode the matching data
+ */
+export function isPoolCreateEvent(
+	event:
+		| { data: ReadonlyUint8Array; programAddress: Address }
+		| ReadonlyUint8Array,
+): boolean {
+	if ('data' in event && event.programAddress !== SEND_DEX_PROGRAM_ADDRESS)
+		return false;
+	const data = 'data' in event ? event.data : event;
+	return (
+		containsBytes(data, ANCHOR_EVENT_CPI_DISCRIMINATOR, 0) &&
+		containsBytes(data, POOL_CREATE_EVENT_DISCRIMINATOR, 8)
+	);
+}
+
+/**
+ * Parses raw event data as a {@link PoolCreateEvent}. Returns `null` on framing or discriminator
+ * mismatch; throws if the event matches but its body fails to decode.
+ *
+ * Returns `null` unless `event.programAddress` is SEND_DEX_PROGRAM_ADDRESS.
+ * Raw bytes carry no emitter and SKIP that check.
+ *
+ * @see isPoolCreateEvent to check without decoding
+ * @see identifySendDexEvent to identify any program event
+ * @see parseSendDexEvent
+ */
+export function parsePoolCreateEvent(
+	event:
+		| { data: ReadonlyUint8Array; programAddress: Address }
+		| ReadonlyUint8Array,
+): PoolCreateEvent | null {
+	const checkedEvent =
+		'data' in event
+			? { data: event.data, programAddress: event.programAddress }
+			: event;
+	if (!isPoolCreateEvent(checkedEvent)) {
+		return null;
+	}
+	const data = 'data' in checkedEvent ? checkedEvent.data : checkedEvent;
+	return getPoolCreateEventDecoder().decode(
+		data,
+		ANCHOR_EVENT_CPI_DISCRIMINATOR.length +
+			POOL_CREATE_EVENT_DISCRIMINATOR.length,
+	);
+}

package/src/dex/generated/events/protocolClaimEvent.ts

@@ -0,0 +1,111 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+
+import {
+	containsBytes,
+	fixEncoderSize,
+	getAddressDecoder,
+	getBytesEncoder,
+	getI64Decoder,
+	getStructDecoder,
+	getU64Decoder,
+	type Address,
+	type FixedSizeDecoder,
+	type ReadonlyUint8Array,
+} from '@solana/kit';
+import { SEND_DEX_PROGRAM_ADDRESS } from '../programs/index.js';
+import { ANCHOR_EVENT_CPI_DISCRIMINATOR } from './anchorEventCpiDiscriminator.framing.js';
+
+export const PROTOCOL_CLAIM_EVENT_DISCRIMINATOR: ReadonlyUint8Array =
+	new Uint8Array([149, 70, 119, 5, 21, 57, 123, 244]);
+
+export function getProtocolClaimEventDiscriminatorBytes(): ReadonlyUint8Array {
+	return fixEncoderSize(getBytesEncoder(), 8).encode(
+		PROTOCOL_CLAIM_EVENT_DISCRIMINATOR,
+	);
+}
+
+export type ProtocolClaimEvent = {
+	pool: Address;
+	baseMint: Address;
+	quoteMint: Address;
+	platformConfig: Address;
+	amount: bigint;
+	quoteTransferFee: bigint;
+	timestamp: bigint;
+};
+
+let getProtocolClaimEventDecoderCache:
+	| FixedSizeDecoder<ProtocolClaimEvent>
+	| undefined;
+
+export function getProtocolClaimEventDecoder(): FixedSizeDecoder<ProtocolClaimEvent> {
+	return (getProtocolClaimEventDecoderCache ??= getStructDecoder([
+		['pool', getAddressDecoder()],
+		['baseMint', getAddressDecoder()],
+		['quoteMint', getAddressDecoder()],
+		['platformConfig', getAddressDecoder()],
+		['amount', getU64Decoder()],
+		['quoteTransferFee', getU64Decoder()],
+		['timestamp', getI64Decoder()],
+	]));
+}
+
+/**
+ * Checks whether the event data matches the framing and discriminator bytes of a
+ * {@link ProtocolClaimEvent}, without decoding. Never throws.
+ *
+ * Returns `false` unless `event.programAddress` is SEND_DEX_PROGRAM_ADDRESS.
+ * Raw bytes carry no emitter and SKIP that check.
+ *
+ * @see parseProtocolClaimEvent to decode the matching data
+ */
+export function isProtocolClaimEvent(
+	event:
+		| { data: ReadonlyUint8Array; programAddress: Address }
+		| ReadonlyUint8Array,
+): boolean {
+	if ('data' in event && event.programAddress !== SEND_DEX_PROGRAM_ADDRESS)
+		return false;
+	const data = 'data' in event ? event.data : event;
+	return (
+		containsBytes(data, ANCHOR_EVENT_CPI_DISCRIMINATOR, 0) &&
+		containsBytes(data, PROTOCOL_CLAIM_EVENT_DISCRIMINATOR, 8)
+	);
+}
+
+/**
+ * Parses raw event data as a {@link ProtocolClaimEvent}. Returns `null` on framing or discriminator
+ * mismatch; throws if the event matches but its body fails to decode.
+ *
+ * Returns `null` unless `event.programAddress` is SEND_DEX_PROGRAM_ADDRESS.
+ * Raw bytes carry no emitter and SKIP that check.
+ *
+ * @see isProtocolClaimEvent to check without decoding
+ * @see identifySendDexEvent to identify any program event
+ * @see parseSendDexEvent
+ */
+export function parseProtocolClaimEvent(
+	event:
+		| { data: ReadonlyUint8Array; programAddress: Address }
+		| ReadonlyUint8Array,
+): ProtocolClaimEvent | null {
+	const checkedEvent =
+		'data' in event
+			? { data: event.data, programAddress: event.programAddress }
+			: event;
+	if (!isProtocolClaimEvent(checkedEvent)) {
+		return null;
+	}
+	const data = 'data' in checkedEvent ? checkedEvent.data : checkedEvent;
+	return getProtocolClaimEventDecoder().decode(
+		data,
+		ANCHOR_EVENT_CPI_DISCRIMINATOR.length +
+			PROTOCOL_CLAIM_EVENT_DISCRIMINATOR.length,
+	);
+}

package/src/dex/generated/events/sendDex.events.ts

@@ -0,0 +1,184 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+
+import {
+	containsBytes,
+	type Address,
+	type ReadonlyUint8Array,
+} from '@solana/kit';
+import { SEND_DEX_PROGRAM_ADDRESS } from '../programs/index.js';
+import { ANCHOR_EVENT_CPI_DISCRIMINATOR } from './anchorEventCpiDiscriminator.framing.js';
+import {
+	CREATOR_CLAIM_EVENT_DISCRIMINATOR,
+	getCreatorClaimEventDecoder,
+	type CreatorClaimEvent,
+} from './creatorClaimEvent.js';
+import {
+	DEPOSIT_QUOTE_EVENT_DISCRIMINATOR,
+	getDepositQuoteEventDecoder,
+	type DepositQuoteEvent,
+} from './depositQuoteEvent.js';
+import {
+	getPoolCreateEventDecoder,
+	POOL_CREATE_EVENT_DISCRIMINATOR,
+	type PoolCreateEvent,
+} from './poolCreateEvent.js';
+import {
+	getProtocolClaimEventDecoder,
+	PROTOCOL_CLAIM_EVENT_DISCRIMINATOR,
+	type ProtocolClaimEvent,
+} from './protocolClaimEvent.js';
+import {
+	getTokenCreateEventDecoder,
+	TOKEN_CREATE_EVENT_DISCRIMINATOR,
+	type TokenCreateEvent,
+} from './tokenCreateEvent.js';
+import {
+	getTradeEventDecoder,
+	TRADE_EVENT_DISCRIMINATOR,
+	type TradeEvent,
+} from './tradeEvent.js';
+
+/** Event kinds of the sendDex program. */
+export type SendDexEventType =
+	| 'creatorClaimEvent'
+	| 'depositQuoteEvent'
+	| 'poolCreateEvent'
+	| 'protocolClaimEvent'
+	| 'tokenCreateEvent'
+	| 'tradeEvent';
+
+/**
+ * Identifies sendDex event data by its discriminators, without decoding.
+ * Returns `null` when the event was emitted by another program or no known event matches.
+ * Never throws.
+ *
+ * Raw bytes carry no emitter and SKIP the program check.
+ */
+export function identifySendDexEvent(
+	event:
+		| { data: ReadonlyUint8Array; programAddress: Address }
+		| ReadonlyUint8Array,
+): SendDexEventType | null {
+	if ('data' in event && event.programAddress !== SEND_DEX_PROGRAM_ADDRESS)
+		return null;
+	const data = 'data' in event ? event.data : event;
+	if (containsBytes(data, ANCHOR_EVENT_CPI_DISCRIMINATOR, 0)) {
+		if (containsBytes(data, CREATOR_CLAIM_EVENT_DISCRIMINATOR, 8)) {
+			return 'creatorClaimEvent';
+		}
+		if (containsBytes(data, DEPOSIT_QUOTE_EVENT_DISCRIMINATOR, 8)) {
+			return 'depositQuoteEvent';
+		}
+		if (containsBytes(data, POOL_CREATE_EVENT_DISCRIMINATOR, 8)) {
+			return 'poolCreateEvent';
+		}
+		if (containsBytes(data, PROTOCOL_CLAIM_EVENT_DISCRIMINATOR, 8)) {
+			return 'protocolClaimEvent';
+		}
+		if (containsBytes(data, TOKEN_CREATE_EVENT_DISCRIMINATOR, 8)) {
+			return 'tokenCreateEvent';
+		}
+		if (containsBytes(data, TRADE_EVENT_DISCRIMINATOR, 8)) {
+			return 'tradeEvent';
+		}
+	}
+	return null;
+}
+
+/** Parsed sendDex event: the event kind tag plus its decoded payload. */
+export type ParsedSendDexEvent =
+	| { eventType: 'creatorClaimEvent'; data: CreatorClaimEvent }
+	| { eventType: 'depositQuoteEvent'; data: DepositQuoteEvent }
+	| { eventType: 'poolCreateEvent'; data: PoolCreateEvent }
+	| { eventType: 'protocolClaimEvent'; data: ProtocolClaimEvent }
+	| { eventType: 'tokenCreateEvent'; data: TokenCreateEvent }
+	| { eventType: 'tradeEvent'; data: TradeEvent };
+
+/**
+ * Parses sendDex event data into its event kind and decoded payload.
+ * Returns `null` when the event was emitted by another program or no known event matches;
+ * throws if a matched event fails to decode.
+ *
+ * Raw bytes carry no emitter and SKIP the program check.
+ */
+export function parseSendDexEvent(
+	event:
+		| { data: ReadonlyUint8Array; programAddress: Address }
+		| ReadonlyUint8Array,
+): ParsedSendDexEvent | null {
+	const checkedEvent =
+		'data' in event
+			? { data: event.data, programAddress: event.programAddress }
+			: event;
+	const eventType = identifySendDexEvent(checkedEvent);
+	if (eventType === null) return null;
+	const data = 'data' in checkedEvent ? checkedEvent.data : checkedEvent;
+	switch (eventType) {
+		case 'creatorClaimEvent': {
+			return {
+				eventType: 'creatorClaimEvent',
+				data: getCreatorClaimEventDecoder().decode(
+					data,
+					ANCHOR_EVENT_CPI_DISCRIMINATOR.length +
+						CREATOR_CLAIM_EVENT_DISCRIMINATOR.length,
+				),
+			};
+		}
+		case 'depositQuoteEvent': {
+			return {
+				eventType: 'depositQuoteEvent',
+				data: getDepositQuoteEventDecoder().decode(
+					data,
+					ANCHOR_EVENT_CPI_DISCRIMINATOR.length +
+						DEPOSIT_QUOTE_EVENT_DISCRIMINATOR.length,
+				),
+			};
+		}
+		case 'poolCreateEvent': {
+			return {
+				eventType: 'poolCreateEvent',
+				data: getPoolCreateEventDecoder().decode(
+					data,
+					ANCHOR_EVENT_CPI_DISCRIMINATOR.length +
+						POOL_CREATE_EVENT_DISCRIMINATOR.length,
+				),
+			};
+		}
+		case 'protocolClaimEvent': {
+			return {
+				eventType: 'protocolClaimEvent',
+				data: getProtocolClaimEventDecoder().decode(
+					data,
+					ANCHOR_EVENT_CPI_DISCRIMINATOR.length +
+						PROTOCOL_CLAIM_EVENT_DISCRIMINATOR.length,
+				),
+			};
+		}
+		case 'tokenCreateEvent': {
+			return {
+				eventType: 'tokenCreateEvent',
+				data: getTokenCreateEventDecoder().decode(
+					data,
+					ANCHOR_EVENT_CPI_DISCRIMINATOR.length +
+						TOKEN_CREATE_EVENT_DISCRIMINATOR.length,
+				),
+			};
+		}
+		case 'tradeEvent': {
+			return {
+				eventType: 'tradeEvent',
+				data: getTradeEventDecoder().decode(
+					data,
+					ANCHOR_EVENT_CPI_DISCRIMINATOR.length +
+						TRADE_EVENT_DISCRIMINATOR.length,
+				),
+			};
+		}
+	}
+}

package/src/dex/generated/events/tokenCreateEvent.ts

@@ -0,0 +1,143 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+
+import {
+	addDecoderSizePrefix,
+	containsBytes,
+	fixEncoderSize,
+	getAddressDecoder,
+	getBooleanDecoder,
+	getBytesEncoder,
+	getI64Decoder,
+	getStructDecoder,
+	getU32Decoder,
+	getU64Decoder,
+	getU8Decoder,
+	getUtf8Decoder,
+	type Address,
+	type Decoder,
+	type ReadonlyUint8Array,
+} from '@solana/kit';
+import { SEND_DEX_PROGRAM_ADDRESS } from '../programs/index.js';
+import { ANCHOR_EVENT_CPI_DISCRIMINATOR } from './anchorEventCpiDiscriminator.framing.js';
+
+export const TOKEN_CREATE_EVENT_DISCRIMINATOR: ReadonlyUint8Array =
+	new Uint8Array([152, 16, 194, 59, 171, 105, 172, 45]);
+
+export function getTokenCreateEventDiscriminatorBytes(): ReadonlyUint8Array {
+	return fixEncoderSize(getBytesEncoder(), 8).encode(
+		TOKEN_CREATE_EVENT_DISCRIMINATOR,
+	);
+}
+
+export type TokenCreateEvent = {
+	pool: Address;
+	baseMint: Address;
+	baseDecimals: number;
+	baseSupply: bigint;
+	quoteMint: Address;
+	quoteDecimals: number;
+	coinCreator: Address;
+	creatorPlatform: string;
+	creatorId: string;
+	creatorFeeConfig: Address;
+	platformConfig: Address;
+	name: string;
+	symbol: string;
+	uri: string;
+	partner: Address;
+	isPartner: boolean;
+	creationFee: bigint;
+	baseReserves: bigint;
+	quoteReserves: bigint;
+	timestamp: bigint;
+};
+
+let getTokenCreateEventDecoderCache: Decoder<TokenCreateEvent> | undefined;
+
+export function getTokenCreateEventDecoder(): Decoder<TokenCreateEvent> {
+	return (getTokenCreateEventDecoderCache ??= getStructDecoder([
+		['pool', getAddressDecoder()],
+		['baseMint', getAddressDecoder()],
+		['baseDecimals', getU8Decoder()],
+		['baseSupply', getU64Decoder()],
+		['quoteMint', getAddressDecoder()],
+		['quoteDecimals', getU8Decoder()],
+		['coinCreator', getAddressDecoder()],
+		[
+			'creatorPlatform',
+			addDecoderSizePrefix(getUtf8Decoder(), getU32Decoder()),
+		],
+		['creatorId', addDecoderSizePrefix(getUtf8Decoder(), getU32Decoder())],
+		['creatorFeeConfig', getAddressDecoder()],
+		['platformConfig', getAddressDecoder()],
+		['name', addDecoderSizePrefix(getUtf8Decoder(), getU32Decoder())],
+		['symbol', addDecoderSizePrefix(getUtf8Decoder(), getU32Decoder())],
+		['uri', addDecoderSizePrefix(getUtf8Decoder(), getU32Decoder())],
+		['partner', getAddressDecoder()],
+		['isPartner', getBooleanDecoder()],
+		['creationFee', getU64Decoder()],
+		['baseReserves', getU64Decoder()],
+		['quoteReserves', getU64Decoder()],
+		['timestamp', getI64Decoder()],
+	]));
+}
+
+/**
+ * Checks whether the event data matches the framing and discriminator bytes of a
+ * {@link TokenCreateEvent}, without decoding. Never throws.
+ *
+ * Returns `false` unless `event.programAddress` is SEND_DEX_PROGRAM_ADDRESS.
+ * Raw bytes carry no emitter and SKIP that check.
+ *
+ * @see parseTokenCreateEvent to decode the matching data
+ */
+export function isTokenCreateEvent(
+	event:
+		| { data: ReadonlyUint8Array; programAddress: Address }
+		| ReadonlyUint8Array,
+): boolean {
+	if ('data' in event && event.programAddress !== SEND_DEX_PROGRAM_ADDRESS)
+		return false;
+	const data = 'data' in event ? event.data : event;
+	return (
+		containsBytes(data, ANCHOR_EVENT_CPI_DISCRIMINATOR, 0) &&
+		containsBytes(data, TOKEN_CREATE_EVENT_DISCRIMINATOR, 8)
+	);
+}
+
+/**
+ * Parses raw event data as a {@link TokenCreateEvent}. Returns `null` on framing or discriminator
+ * mismatch; throws if the event matches but its body fails to decode.
+ *
+ * Returns `null` unless `event.programAddress` is SEND_DEX_PROGRAM_ADDRESS.
+ * Raw bytes carry no emitter and SKIP that check.
+ *
+ * @see isTokenCreateEvent to check without decoding
+ * @see identifySendDexEvent to identify any program event
+ * @see parseSendDexEvent
+ */
+export function parseTokenCreateEvent(
+	event:
+		| { data: ReadonlyUint8Array; programAddress: Address }
+		| ReadonlyUint8Array,
+): TokenCreateEvent | null {
+	const checkedEvent =
+		'data' in event
+			? { data: event.data, programAddress: event.programAddress }
+			: event;
+	if (!isTokenCreateEvent(checkedEvent)) {
+		return null;
+	}
+	const data = 'data' in checkedEvent ? checkedEvent.data : checkedEvent;
+	return getTokenCreateEventDecoder().decode(
+		data,
+		ANCHOR_EVENT_CPI_DISCRIMINATOR.length +
+			TOKEN_CREATE_EVENT_DISCRIMINATOR.length,
+	);
+}

package/src/dex/generated/events/tradeEvent.ts

@@ -0,0 +1,143 @@
+/**
+ * This code was AUTOGENERATED using the Codama library.
+ * Please DO NOT EDIT THIS FILE, instead use visitors
+ * to add features, then rerun Codama to update it.
+ *
+ * @see https://github.com/codama-idl/codama
+ */
+
+import {
+	containsBytes,
+	fixEncoderSize,
+	getAddressDecoder,
+	getBooleanDecoder,
+	getBytesEncoder,
+	getI64Decoder,
+	getStructDecoder,
+	getU64Decoder,
+	type Address,
+	type FixedSizeDecoder,
+	type ReadonlyUint8Array,
+} from '@solana/kit';
+import { SEND_DEX_PROGRAM_ADDRESS } from '../programs/index.js';
+import {
+	getTradeDirectionDecoder,
+	type TradeDirection,
+} from '../types/index.js';
+import { ANCHOR_EVENT_CPI_DISCRIMINATOR } from './anchorEventCpiDiscriminator.framing.js';
+
+export const TRADE_EVENT_DISCRIMINATOR: ReadonlyUint8Array = new Uint8Array([
+	189, 219, 127, 211, 78, 230, 97, 238,
+]);
+
+export function getTradeEventDiscriminatorBytes(): ReadonlyUint8Array {
+	return fixEncoderSize(getBytesEncoder(), 8).encode(
+		TRADE_EVENT_DISCRIMINATOR,
+	);
+}
+
+export type TradeEvent = {
+	pool: Address;
+	baseMint: Address;
+	quoteMint: Address;
+	user: Address;
+	coinCreator: Address;
+	creatorFeeConfig: Address;
+	platformConfig: Address;
+	baseAmount: bigint;
+	quoteAmountGross: bigint;
+	quoteAmountNet: bigint;
+	tradeDirection: TradeDirection;
+	partner: Address;
+	isPartner: boolean;
+	protocolFee: bigint;
+	lpFee: bigint;
+	creatorFee: bigint;
+	baseTransferFee: bigint;
+	quoteTransferFee: bigint;
+	baseReserves: bigint;
+	quoteReserves: bigint;
+	timestamp: bigint;
+};
+
+let getTradeEventDecoderCache: FixedSizeDecoder<TradeEvent> | undefined;
+
+export function getTradeEventDecoder(): FixedSizeDecoder<TradeEvent> {
+	return (getTradeEventDecoderCache ??= getStructDecoder([
+		['pool', getAddressDecoder()],
+		['baseMint', getAddressDecoder()],
+		['quoteMint', getAddressDecoder()],
+		['user', getAddressDecoder()],
+		['coinCreator', getAddressDecoder()],
+		['creatorFeeConfig', getAddressDecoder()],
+		['platformConfig', getAddressDecoder()],
+		['baseAmount', getU64Decoder()],
+		['quoteAmountGross', getU64Decoder()],
+		['quoteAmountNet', getU64Decoder()],
+		['tradeDirection', getTradeDirectionDecoder()],
+		['partner', getAddressDecoder()],
+		['isPartner', getBooleanDecoder()],
+		['protocolFee', getU64Decoder()],
+		['lpFee', getU64Decoder()],
+		['creatorFee', getU64Decoder()],
+		['baseTransferFee', getU64Decoder()],
+		['quoteTransferFee', getU64Decoder()],
+		['baseReserves', getU64Decoder()],
+		['quoteReserves', getU64Decoder()],
+		['timestamp', getI64Decoder()],
+	]));
+}
+
+/**
+ * Checks whether the event data matches the framing and discriminator bytes of a
+ * {@link TradeEvent}, without decoding. Never throws.
+ *
+ * Returns `false` unless `event.programAddress` is SEND_DEX_PROGRAM_ADDRESS.
+ * Raw bytes carry no emitter and SKIP that check.
+ *
+ * @see parseTradeEvent to decode the matching data
+ */
+export function isTradeEvent(
+	event:
+		| { data: ReadonlyUint8Array; programAddress: Address }
+		| ReadonlyUint8Array,
+): boolean {
+	if ('data' in event && event.programAddress !== SEND_DEX_PROGRAM_ADDRESS)
+		return false;
+	const data = 'data' in event ? event.data : event;
+	return (
+		containsBytes(data, ANCHOR_EVENT_CPI_DISCRIMINATOR, 0) &&
+		containsBytes(data, TRADE_EVENT_DISCRIMINATOR, 8)
+	);
+}
+
+/**
+ * Parses raw event data as a {@link TradeEvent}. Returns `null` on framing or discriminator
+ * mismatch; throws if the event matches but its body fails to decode.
+ *
+ * Returns `null` unless `event.programAddress` is SEND_DEX_PROGRAM_ADDRESS.
+ * Raw bytes carry no emitter and SKIP that check.
+ *
+ * @see isTradeEvent to check without decoding
+ * @see identifySendDexEvent to identify any program event
+ * @see parseSendDexEvent
+ */
+export function parseTradeEvent(
+	event:
+		| { data: ReadonlyUint8Array; programAddress: Address }
+		| ReadonlyUint8Array,
+): TradeEvent | null {
+	const checkedEvent =
+		'data' in event
+			? { data: event.data, programAddress: event.programAddress }
+			: event;
+	if (!isTradeEvent(checkedEvent)) {
+		return null;
+	}
+	const data = 'data' in checkedEvent ? checkedEvent.data : checkedEvent;
+	return getTradeEventDecoder().decode(
+		data,
+		ANCHOR_EVENT_CPI_DISCRIMINATOR.length +
+			TRADE_EVENT_DISCRIMINATOR.length,
+	);
+}