Events Reference - RektHub Docs

Overview

RektHub contracts emit detailed events for every significant action. This page is your complete reference for building indexers, dashboards, bots, and real-time UIs.

Pro Tip: Events are indexed by key parameters (token address, buyer/seller, creator) for efficient querying. Use filters to subscribe to specific tokens or users.

Factory Events

Events emitted by the RektHubFactory contract.

TokenCreated

Emitted when a new creator token is deployed.

event TokenCreated(
    address indexed tokenAddress,
    address indexed curveAddress,
    address indexed creator,
    string name,
    string symbol,
    string uri,
    uint256 realNativeReserves,
    uint256 realTokenReserves,
    uint256 virtualNativeReserves,
    uint256 virtualTokenReserves,
    uint256 creationFee
);

address

Address of the deployed token contract

address

Address of the bonding curve contract

address

Address of the token creator

string

Token name

string

Token symbol

string

Token metadata URI

uint256

Initial real native reserves (always 0 at creation)

uint256

Initial real token reserves (850,000,000 tokens)

uint256

Initial virtual native reserves (set by factory)

uint256

Initial virtual token reserves (1,073,000,000 tokens)

uint256

Fee paid for token creation

Use Cases:

Track new token launches in real-time
Build “New Tokens” feed
Analytics on creator activity
Notification systems for followers

Example:

factory.on(
	'TokenCreated',
	(tokenAddress, curveAddress, creator, name, symbol, uri) => {
		console.log(`${name} (${symbol}) launched by ${creator}`);

		fetchMetadata(uri).then((metadata) => {
			displayNewToken({
				address: tokenAddress,
				name,
				symbol,
				creator,
				image: metadata.image,
				socials: metadata.social_links,
			});
		});
	}
);

TokenPurchased

Emitted when tokens are bought through the factory router.

event TokenPurchased(
    address indexed token,
    address indexed curve,
    address indexed buyer,
    uint256 nativeIn,
    uint256 tokensOut,
    uint256 totalFee,
    uint256 creatorFee,
    uint256 platformFee,
    uint256 newRealNativeReserves,
    uint256 newRealTokenReserves,
    uint256 newVirtualNativeReserves,
    uint256 newVirtualTokenReserves
);

address

Token address that was purchased

address

Bonding curve address

address

Address of the buyer

uint256

Amount of native tokens spent (including fees)

uint256

Amount of tokens received

uint256

Total fee charged (1% of nativeIn)

uint256

Creator’s portion of fee (30% of totalFee)

uint256

Platform’s portion of fee (70% of totalFee)

uint256

Real native reserves after purchase

uint256

Real token reserves after purchase

uint256

Virtual native reserves after purchase

uint256

Virtual token reserves after purchase

Use Cases:

Real-time trade feeds
Price chart updates (calculate price from reserves)
Volume tracking
Creator earnings dashboards
Whale watching (large buys)

Example:

const filter = factory.filters.TokenPurchased(tokenAddress);

factory.on(
	filter,
	(
		token,
		curve,
		buyer,
		nativeIn,
		tokensOut,
		totalFee,
		creatorFee,
		platformFee,
		newRealNativeReserves,
		newRealTokenReserves
	) => {
		const price = nativeIn / tokensOut;
		const newPrice =
			newRealNativeReserves / (850_000_000n * 10n ** 18n - newRealTokenReserves);
		const priceImpact = ((newPrice - price) / price) * 100;

		console.log(`Buy: ${ethers.formatEther(tokensOut)} tokens`);
		console.log(`Spent: ${ethers.formatEther(nativeIn)}`);
		console.log(`Price impact: ${priceImpact.toFixed(2)}%`);
		console.log(`Creator earned: ${ethers.formatEther(creatorFee)}`);

		updatePriceChart(newPrice);
		updateVolume(nativeIn);
		updateCreatorEarnings(creatorFee);
	}
);

TokenSold

Emitted when tokens are sold through the factory router.

event TokenSold(
    address indexed token,
    address indexed curve,
    address indexed seller,
    uint256 tokensIn,
    uint256 nativeOut,
    uint256 totalFee,
    uint256 creatorFee,
    uint256 platformFee,
    uint256 newRealNativeReserves,
    uint256 newRealTokenReserves,
    uint256 newVirtualNativeReserves,
    uint256 newVirtualTokenReserves
);

address

Token address that was sold

address

Bonding curve address

address

Address of the seller

uint256

Amount of tokens sold

uint256

Amount of native tokens received (after fees)

uint256

Total fee charged (1% of gross native out)

uint256

Creator’s portion of fee (30% of totalFee)

uint256

Platform’s portion of fee (70% of totalFee)

uint256

Real native reserves after sale

uint256

Real token reserves after sale

uint256

Virtual native reserves after sale

uint256

Virtual token reserves after sale

Use Cases:

Track selling pressure
Identify panic sells or whale exits
Update price charts (sells move price down)
Creator earnings tracking

Example:

factory.on(
	'TokenSold',
	(token, curve, seller, tokensIn, nativeOut, totalFee, creatorFee) => {
		console.log(`Sell: ${ethers.formatEther(tokensIn)} tokens`);
		console.log(`Received: ${ethers.formatEther(nativeOut)}`);
		console.log(`Creator still earned: ${ethers.formatEther(creatorFee)}`);

		const sellSize = tokensIn / (850_000_000n * 10n ** 18n);
		if (sellSize > 0.01) {
			notifyWhaleActivity('sell', seller, tokensIn);
		}
	}
);

TokenMigrated

Emitted when a token graduates to DEX.

event TokenMigrated(
    address indexed tokenAddress,
    address indexed curveAddress,
    address indexed poolAddress,
    string platformName,
    uint256 nativeLiquidity,
    uint256 tokenLiquidity,
    uint256 migrationFee,
    uint256 creatorFee,
    uint256 platformFee
);

address

Token that graduated

address

Bonding curve that was closed

address

Address of created liquidity pool

string

Name of the DEX platform (e.g., “Uniswap V2”)

uint256

Amount of native tokens added to pool (after 12% migration fee)

uint256

Amount of tokens added to pool (150M tokens)

uint256

Total migration fee (12% of native liquidity)

uint256

Creator’s portion (60% of migrationFee = 7.2% of liquidity)

uint256

Platform’s portion (40% of migrationFee = 4.8% of liquidity)

Use Cases:

Graduation announcements
Redirect users to DEX for trading
Track graduation success rates
Creator milestone notifications

Example:

factory.on(
	'TokenMigrated',
	(
		tokenAddress,
		curveAddress,
		poolAddress,
		platformName,
		nativeLiquidity,
		tokenLiquidity,
		migrationFee,
		creatorFee
	) => {
		console.log(`Token graduated to ${platformName}!`);
		console.log(`Pool: ${poolAddress}`);
		console.log(`Liquidity: ${ethers.formatEther(nativeLiquidity)} native`);
		console.log(
			`Creator earned: ${ethers.formatEther(creatorFee)} from migration`
		);

		showGraduationModal({
			token: tokenAddress,
			dex: platformName,
			poolUrl: `https://app.uniswap.org/pools/${poolAddress}`,
		});
	}
);

FeesWithdrawn

Emitted when platform owner withdraws accumulated fees.

event FeesWithdrawn(
    address indexed recipient,
    uint256 amount
);

address

Address receiving the fees (contract owner)

uint256

Amount of fees withdrawn

Use Cases:

Protocol revenue tracking
Transparency dashboards

Bonding Curve Events

Events emitted by individual BondingCurve contracts.

TokenPurchased (Curve)

Identical to Factory’s TokenPurchased, but emitted by the curve itself.

event TokenPurchased(
    address indexed buyer,
    uint256 nativeIn,
    uint256 tokensOut,
    uint256 totalFee,
    uint256 creatorFee,
    uint256 platformFee,
    uint256 newRealNativeReserves,
    uint256 newRealTokenReserves,
    uint256 newVirtualNativeReserves,
    uint256 newVirtualTokenReserves
);

Difference from Factory: No token or curve parameters since those are implicit (the event is emitted by the curve itself).

Example:

const curve = new ethers.Contract(curveAddress, CURVE_ABI, provider);

curve.on('TokenPurchased', (buyer, nativeIn, tokensOut) => {
	console.log(`Direct buy on curve: ${ethers.formatEther(tokensOut)} tokens`);
});

TokenSold (Curve)

Identical to Factory’s TokenSold, but emitted by the curve.

event TokenSold(
    address indexed seller,
    uint256 tokensIn,
    uint256 nativeOut,
    uint256 totalFee,
    uint256 creatorFee,
    uint256 platformFee,
    uint256 newRealNativeReserves,
    uint256 newRealTokenReserves,
    uint256 newVirtualNativeReserves,
    uint256 newVirtualTokenReserves
);

TokenBonded

Emitted when all tradeable tokens are sold and curve enters “bonded” state.

event TokenBonded(
    address indexed tokenAddress
);

address

Token that reached full bonding

Use Cases:

Notify users that token is ready for graduation
Trigger graduation countdown/voting UI
Creator milestone notification

Example:

curve.on('TokenBonded', (tokenAddress) => {
	console.log(`Token ${tokenAddress} fully bonded!`);

	showBondedCelebration();
	notifyCreator('Your token is fully bonded and ready for graduation!');
	startGraduationCountdown();
});

Critical Event: TokenBonded marks a major milestone. All tokens sold, maximum liquidity reached, ready for DEX migration.

TokenMigrated (Curve)

Identical to Factory’s TokenMigrated, but emitted by the curve.

event TokenMigrated(
    address indexed tokenAddress,
    address indexed poolAddress,
    string platformName,
    uint256 nativeLiquidity,
    uint256 tokenLiquidity,
    uint256 migrationFee,
    uint256 creatorFee,
    uint256 platformFee
);

CreatorFeesClaimed

Emitted when creator claims accumulated fees.

event CreatorFeesClaimed(
    address indexed creator,
    address indexed tokenAddress,
    uint256 amount
);

address

Creator claiming fees

address

Token the fees are from

uint256

Amount of fees claimed

Use Cases:

Track creator earnings withdrawals
Creator analytics dashboards
Tax reporting tools

Example:

curve.on('CreatorFeesClaimed', (creator, tokenAddress, amount) => {
	console.log(`Creator ${creator} claimed ${ethers.formatEther(amount)}`);

	updateCreatorBalance(creator, amount);
});

CreatorTransferred

Emitted when creator role is transferred to a new address.

event CreatorTransferred(
    address indexed oldCreator,
    address indexed newCreator
);

address

Previous creator address

address

New creator address

Use Cases:

Track ownership changes
Security monitoring
Creator account recovery tracking

Token Events

Events emitted by RektHubToken contracts.

TokenURIUpdated

Emitted when creator updates token metadata.

event TokenURIUpdated(
    string newURI,
    uint256 timestamp
);

string

New metadata URI

uint256

Block timestamp of update

Use Cases:

Refresh token metadata in UIs
Track metadata update history
Cache invalidation

Example:

token.on('TokenURIUpdated', async (newURI, timestamp) => {
	console.log('Metadata updated:', newURI);

	const metadata = await fetchMetadata(newURI);

	updateTokenCard({
		image: metadata.image,
		description: metadata.description,
		socials: metadata.social_links,
	});

	cache.delete(`metadata:${tokenAddress}`);
});

MintingDisabled

Emitted once during token initialization when minting is permanently locked.

event MintingDisabled(
    uint256 timestamp
);

uint256

Block timestamp when minting was disabled

Use Cases:

Verify supply is locked
Security auditing
Transparency dashboards

Standard ERC20 Events

All RektHub tokens also emit standard ERC20 events:

Transfer

event Transfer(
    address indexed from,
    address indexed to,
    uint256 value
);

Approval

event Approval(
    address indexed owner,
    address indexed spender,
    uint256 value
);

Event Filtering Examples

Listen to All Activity for a Token

const tokenAddress = '0x...';

const buyFilter = factory.filters.TokenPurchased(tokenAddress);
const sellFilter = factory.filters.TokenSold(tokenAddress);
const migrateFilter = factory.filters.TokenMigrated(tokenAddress);

factory.on(buyFilter, handleBuy);
factory.on(sellFilter, handleSell);
factory.on(migrateFilter, handleMigration);

Listen to a Specific User’s Activity

const userAddress = '0x...';

factory.on(
	factory.filters.TokenPurchased(null, null, userAddress),
	handleUserBuy
);

factory.on(factory.filters.TokenSold(null, null, userAddress), handleUserSell);

Query Historical Events

const currentBlock = await provider.getBlockNumber();
const fromBlock = currentBlock - 1000;

const events = await factory.queryFilter(
	factory.filters.TokenCreated(),
	fromBlock,
	'latest'
);

events.forEach((event) => {
	console.log('Token:', event.args.name);
	console.log('Creator:', event.args.creator);
	console.log('Block:', event.blockNumber);
});

Build a Trade Feed

async function buildTradeFeed() {
	const feed = [];

	factory.on('TokenPurchased', (token, curve, buyer, nativeIn, tokensOut) => {
		feed.push({
			type: 'buy',
			token,
			user: buyer,
			amount: ethers.formatEther(tokensOut),
			value: ethers.formatEther(nativeIn),
			timestamp: Date.now(),
		});

		renderFeed(feed);
	});

	factory.on('TokenSold', (token, curve, seller, tokensIn, nativeOut) => {
		feed.push({
			type: 'sell',
			token,
			user: seller,
			amount: ethers.formatEther(tokensIn),
			value: ethers.formatEther(nativeOut),
			timestamp: Date.now(),
		});

		renderFeed(feed);
	});
}

Next Steps

Quick Start

Start integrating with code examples

Factory Contract

Learn about the orchestrator

Interfaces

Contract interfaces and ABIs

Libraries

Bonding curve math utilities

​Overview

​Factory Events

​TokenCreated

​TokenPurchased

​TokenSold

​TokenMigrated

​FeesWithdrawn

​Bonding Curve Events

​TokenPurchased (Curve)

​TokenSold (Curve)

​TokenBonded

​TokenMigrated (Curve)

​CreatorFeesClaimed

​CreatorTransferred

​Token Events

​TokenURIUpdated

​MintingDisabled

​Standard ERC20 Events

​Transfer

​Approval

​Event Filtering Examples

​Listen to All Activity for a Token

​Listen to a Specific User’s Activity

​Query Historical Events

​Build a Trade Feed

​Next Steps

Quick Start

Factory Contract

Interfaces

Libraries

Overview

Factory Events

TokenCreated

TokenPurchased

TokenSold

TokenMigrated

FeesWithdrawn

Bonding Curve Events

TokenPurchased (Curve)

TokenSold (Curve)

TokenBonded

TokenMigrated (Curve)

CreatorFeesClaimed

CreatorTransferred

Token Events

TokenURIUpdated

MintingDisabled

Standard ERC20 Events

Transfer

Approval

Event Filtering Examples

Listen to All Activity for a Token

Listen to a Specific User’s Activity

Query Historical Events

Build a Trade Feed

Next Steps