Sherwood | PONS Explorer

pons events

Every event uses the same normalized envelope. Type-specific values live in amounts, fees, and metadata. On-chain integer values are decimal strings, missing values are null. Addresses are 0x-prefixed; normalize their casing before comparing them.

The API defines 19 event types. The current indexer produces 12; the remaining 7, related to V3 and V4 pool swaps are not indexed yet. Indexer use multistack coverage for the both V1 and V2 Pons factories. See API coverage .

Envelope

19 schema types

typescript · schema v1

{
  id: string,
  schemaVersion: 1,
  type: EventType,
  chainId: number,
  protocol: "pons-v1" | "pons-v2",
  protocolStackId: string,
  token: address | null,
  sourceContract: address,
  actor: address | null,
  recipient: address | null,
  quoteAsset: address | null,
  amounts: Record<string, decimalString>,
  fees: Record<string, decimalString>,
  metadata?: Record<string, unknown>,
  blockNumber: decimalString,
  blockHash: hash,
  transactionHash: hash,
  logIndex: number,
  blockTimestamp: ISODate,
  status: "provisional" | "confirmed" | "orphaned"
}

Types

19 schema types

token.launched

indexed

Creates a token and records the market it starts with. V2 launches use a bonding curve; V1 launches point to a Uniswap V3 pool.

Type-specific fields

Path	Type	Meaning
token	address	New token address.
actor	address	Deployer address.
quoteAsset	address	Paired asset.
metadata.marketKind	"bonding-curve" \| "uniswap-v3-pool"	Market implementation used by the launch.
metadata.curve / metadata.pool	address	V2 curve or V1 pool address, depending on the protocol version.
amounts.graduationThreshold	decimalString · V2	V2 threshold; absent for V1.
metadata.launchConfigId	decimalString	Launch configuration identifier.
metadata.positionId / dexId	decimalString · V1	V1 pool position and DEX identifiers when available.

curve.buy

indexed

A token purchase executed against a bonding curve.

Type-specific fields

Path	Type	Meaning
actor	address	Buyer address.
recipient	address	Token recipient.
amounts.quoteIn	decimalString	Quote asset paid.
amounts.tokensOut	decimalString	Tokens received.
fees.baseAndSnipe	decimalString	Base and snipe fee.
fees.creatorTax	decimalString	Creator tax.

curve.sell

indexed

A token sale executed against a bonding curve.

Type-specific fields

Path	Type	Meaning
actor	address	Seller address.
recipient	address	Quote asset recipient.
amounts.tokensIn	decimalString	Tokens sold.
amounts.quoteOut	decimalString	Quote asset received.
fees.base	decimalString	Base fee.
fees.creatorTax	decimalString	Creator tax.

curve.buy_refunded

indexed

Refunds the unused quote amount from a curve purchase.

Type-specific fields

Path	Type	Meaning
actor	address	Buyer receiving the refund.
amounts.quoteRefunded	decimalString	Quote asset returned.

curve.completed

indexed

Marks the bonding curve as complete and settles its final balances.

Type-specific fields

Path	Type	Meaning
recipient	address	Address receiving the settlement.
amounts.quoteAmount	decimalString	Quote asset settled.
amounts.tokenAmount	decimalString	Token amount settled.

graduation.swept

indexed

Moves the remaining curve balances during the transition to a pool.

Type-specific fields

Path	Type	Meaning
token	address	Token being graduated.
amounts.quoteAmount	decimalString	Quote asset swept.
amounts.tokenAmount	decimalString	Tokens swept.

graduation.failed

indexed

Records an automatic graduation attempt that did not complete.

Type-specific fields

Path	Type	Meaning
token	address \| null	Token associated with the attempt, when available.

graduation.completed

indexed

Confirms that the token has graduated from the curve into its pool phase.

Type-specific fields

Path	Type	Meaning
token	address	Token that graduated.
metadata.poolId	bytes32 · optional	Pool identifier when supplied by the source.

pool.registered

not indexed yet

Registers a liquidity pool so later pool activity can be attributed to the token.

Type-specific fields

Path	Type	Meaning
token	address	Token in the pool.
quoteAsset	address	Paired quote asset.
metadata.poolId	bytes32	Source pool identifier.

pool.swap

not indexed yet

A swap executed in a registered pool, including the pool price state at that point.

Type-specific fields

Path	Type	Meaning
actor	address	Swap sender.
recipient	address \| null	Swap recipient when emitted by the source.
amounts.amount0 / amount1	decimalString	Signed asset deltas, normalized as decimal strings.
metadata.sqrtPriceX96	decimalString	Pool square-root price after the swap.
metadata.liquidity / tick / fee	decimalString	Pool state and fee captured with the swap.

fees.swept

indexed

Moves accumulated fees out of the market and splits them by destination.

Type-specific fields

Path	Type	Meaning
fees.protocol	decimalString	Protocol share.
fees.creator	decimalString	Creator share.
fees.buyback	decimalString	Buyback share.

fees.credited

not indexed yet

Credits fees to an account or fee ledger for later claiming.

Type-specific fields

Path	Type	Meaning
recipient	address	Account receiving the credit.
amounts.amount	decimalString	Amount credited.
metadata.asset	address \| optional	Asset credited by token-based fee contracts.

fees.claimed

not indexed yet

Claims previously credited fees from the fee ledger.

Type-specific fields

Path	Type	Meaning
actor	address \| null	Account initiating the claim, when available.
recipient	address	Account receiving the claim.
amounts.amount	decimalString	Amount claimed.
metadata.asset	address \| optional	Asset claimed by token-based fee contracts.

buyback.locked

indexed

Spends quote asset to acquire tokens and locks those tokens for vesting.

Type-specific fields

Path	Type	Meaning
amounts.quoteSpent	decimalString	Quote asset spent.
amounts.tokensLocked	decimalString	Tokens placed into the lock.

buyback.skipped

not indexed yet

Records that a planned buyback was skipped because its execution conditions were not met.

Type-specific fields

Path	Type	Meaning
amounts.amount	decimalString	Amount left unspent or skipped.
metadata.poolId	bytes32 · optional	Pool identifier when supplied by the source.

conversion.skipped

not indexed yet

Records that a planned asset conversion was skipped.

Type-specific fields

Path	Type	Meaning
amounts.amount	decimalString	Amount that was not converted.
metadata.poolId	bytes32 · optional	Pool identifier when supplied by the source.

vesting.released

not indexed yet

Releases vested balances to the creator and protocol destinations.

Type-specific fields

Path	Type	Meaning
recipient	address	Vesting beneficiary.
amounts.creatorAmount	decimalString	Creator amount released.
amounts.protocolAmount	decimalString	Protocol amount released.

creator.change_proposed

indexed

Proposes a new creator fee recipient for a token.

Type-specific fields

Path	Type	Meaning
token	address	Token whose recipient is changing.
recipient	address	Proposed recipient.
metadata.effectiveAt / expiresAt	decimalString · optional	Proposal timing when exposed by the source.

creator.changed

indexed

Confirms that the creator fee recipient has been updated.

Type-specific fields

Path	Type	Meaning
token	address	Token whose recipient changed.
recipient	address	New creator fee recipient.