padv11 state

wugnotTokenKey

Sapphire Gnoswap registry keys / role addresses (sapphire-1).

gnsTokenKey

Sapphire Gnoswap registry keys / role addresses (sapphire-1).

gnoswapPoolAddrStr

Sapphire Gnoswap registry keys / role addresses (sapphire-1).

gnoswapRouterAddrStr

Sapphire Gnoswap registry keys / role addresses (sapphire-1).

tryListOnGnoswap

tryListOnGnoswap seeds a Gnoswap CL pool with remaining meme tokens + raised-sized WUGNOT as LP. CreatePool fee (fixed GNS amount) is paid from: 1. pre-funded GNS on pad (preferred — immune to GNOT/GNS price moves), else 2. ExactOut WUGNOT→GNS using SURPLUS inventory only (above raised), so LP depth stays equal to raised even when GNS is expensive. Returns true on success. Soft failure sets l.GnoswapNote and returns false (caller keeps internal CPMM). Note: wugnot.Deposit is EOA-only — protocol must pre-fund pad with WUGNOT (and ideally GNS). Raised ugnot stays on pad as wrap-back backlog.

swapWugnotForGNS

swapWugnotForGNS ExactOut-swaps WUGNOT→GNS. maxInWugnot is a hard ceiling (slippage / price protection): if market needs more GNOT for amountOutGNS, swap reverts.

computeSqrtPriceX96

computeSqrtPriceX96 returns sqrt(amount1/amount0) \* 2^96 as decimal string.

u256Sqrt

alignedFullRangeTicks

GnoswapListedOf

GnoswapListedOf reports whether a launch was auto-listed on Gnoswap.

GnoswapPoolPathOf

GnoswapPoolPathOf returns the Gnoswap pool path after listing (or empty).

GnoswapNoteOf

GnoswapNoteOf returns the listing status note.

launches

// id -> \*Launch

bySymbol

// symbol -> id string

nextID

nextTokenID

// GRC20 identity sequence (shared for all launches)

padAddr

protocolAddr

protocolFees

protocolFeesPaid

inited

testSkipBanker

pointsEnabled

init.23

Trade

Trade is one price sample for charts (capped history per launch).

Launch

Launch is one meme market: curve phase then locked pool phase. token/ledger are unexported so external packages cannot Mint/Burn via field access.

Init

Init sets the protocol treasury. First EOA caller becomes fee recipient (protocolAddr). Protocol trade fees accrue on-pad until ClaimProtocolFees (treasury only) or PushProtocolFees (anyone may push to treasury). Creator fees always need ClaimCreatorFees by the token creator. Deploy note: call Init with the wallet that should receive protocol fees (or TransferProtocol later). Gnoswap CreatePool GNS fee is paid to Gnoswap, not to this treasury.

creditProtocol

creditProtocol accrues protocol ugnot liability on the pad realm. Cash stays in pad until ClaimProtocolFees / PushProtocolFees.

requireInit

SetPointsEnabled

SetPointsEnabled toggles pointsv2 notifications (protocol admin only). pointsv2 must AllowPad(this package path) or OnTrade/OnCreate will panic and revert the trade.

PointsEnabled

PointsEnabled reports whether pad notifies pointsv2 after trades/creates.

notifyTrade

notifyCreate

mustLaunch

balOf

addBal

addBal mints (delta>0) or burns (delta\<0) GRC20 via pad-owned PrivateLedger.

requireMinOut

snipeBoughtOf

checkAndAddSnipe

sendUgnot

requireUserPayment

noteBuyer

tradeKey

spotPriceScaled

spotPriceScaled returns ugnot/token \* 1e6 from current curve or pool reserves.

recordTrade

maybeRefundBond

requiredCreateBond

requiredCreateBond returns ugnot the creator must send. Production: createbond.CurrentBondUgnot() (promo or normal). Unit tests (testSkipBanker): local CreateBondUgnot constant.

CreateBondRequired

CreateBondRequired is a public alias for UIs / qeval (same as requiredCreateBond).

Create

Create deploys a fair-launch meme. Bond amount from bond realm (or fallback const). No pre-mint; all tradeable float starts on the bonding curve.

AdenaPathOf

AdenaPathOf returns the grc20reg / Adena token key: packagePath.SYMBOL (Token.ID is packagePath.SYMBOL.seq — Adena rejects that form).

adenaKeyFromTokenID

adenaKeyFromTokenID strips the trailing .seq from Token.ID when present.

maxGrossForNetIn

maxGrossForNetIn finds largest gross ugnot ≤ sentMax whose fee-split netIn ≤ maxNet.

readyToGraduate

readyToGraduate is true when raise met the threshold, or the entire curve float is sold (sold-out escape: threshold may be unreachable with bad virtuals).

Buy

Buy spends -send ugnot on the bonding curve; credits tokens to the caller. minTokensOut: slippage floor (0 = disabled). Auto-graduates at threshold or sold-out. Last-fill (no overshoot): 1. Cap net ugnot so RaisedUgnot never exceeds GraduationThreshold (refund excess). 2. Cap by remaining curve tokens (CurveSupply - RealSold), same as before. Concurrent large buys serialize per-tx; each fill only the remaining raise/tokens. If the curve is already sold out (or raise already filled), Buy refunds the full send and graduates when ready — no panic so users are not stuck mid-tx.

RemainingRaiseUgnot

RemainingRaiseUgnot is net ugnot still needed to hit GraduationThreshold (0 if met/over).

Sell

Sell burns curve tokens and pays ugnot (fee on output). minUgnotOut: slippage floor (0 = disabled).

Graduate

Graduate permissionlessly moves a ready curve into a permanently locked CPMM. Ready when RaisedUgnot >= GraduationThreshold, or when RealSold >= CurveSupply with RaisedUgnot > 0 (sold-out before threshold — escape hatch for unreachable raise).

graduate

TokenIDOf

TokenIDOf returns the GRC20 Token.ID() for a launch.

GRC20Bank

GRC20Bank returns the underlying \*grc20.Token for interop (metadata / external DEX). Does not expose PrivateLedger — mint/burn stay pad-only.

SwapBuy

SwapBuy buys tokens from the graduated pool with -send ugnot. minTokensOut: slippage floor (0 = disabled). Disabled when the launch was auto-listed on Gnoswap (trade there instead).

SwapSell

SwapSell sells tokens into the graduated pool for ugnot. minUgnotOut: slippage floor (0 = disabled).

Transfer

Transfer moves GRC20 tokens between addresses (user-initiated).

Approve

Approve sets GRC20 allowance so DEX/contracts can TransferFrom.

TransferFrom

TransferFrom spends allowance: spender = MsgCall EOA caller. Enables DEX / routers that hold allowance from Approve.

ClaimCreatorFees

ClaimCreatorFees withdraws accrued creator fees for a launch. Only the token creator may claim. Fees stay on pad until claimed.

payoutProtocolFees

payoutProtocolFees sends all pending protocolFees to protocolAddr. Shared by ClaimProtocolFees and PushProtocolFees.

ClaimProtocolFees

ClaimProtocolFees withdraws pending protocol fees to protocolAddr. Only the current protocol treasury key may call (same wallet that Init'd, unless TransferProtocol was used).

PushProtocolFees

PushProtocolFees sends pending protocol fees to protocolAddr. Permissionless: anyone may call so treasury can be paid without the protocol key signing (still only pays the configured protocolAddr).

TransferProtocol

TransferProtocol rotates the protocol fee recipient (current protocol only). Pending protocolFees stay on pad until claimed/pushed to the \*new\* address.

ProtocolAddress

ProtocolAddress returns the current protocol treasury address (bech32).

ProtocolFeesPaid

ProtocolFeesPaid returns lifetime ugnot already paid out to the treasury.

FeeInfo

FeeInfo returns protocolAddr|pendingUgnot|paidUgnot for UIs.

PadAddress

PadAddress returns this pad realm's bech32 package address (fund WUGNOT here).

AdminInfo

AdminInfo is a single-line dashboard snapshot for the ops UI: protocolAddr|pendingFees|paidFees|reservedUgnot|launchCount|pointsOn|inited|padAddr pointsOn/inited are 0|1.

IsProtocol

IsProtocol reports whether addr is the current treasury (for UI gating).

reservedUgnot

reservedUgnot is ugnot the pad must keep to honor user/creator liabilities and active markets (curve raised, internal CPMM, bonds, pending fees).

ReservedUgnot

ReservedUgnot is ugnot the pad must keep for markets + pending claims.

freeUgnot

freeUgnot reports bank ugnot above reserved liabilities (0 if short/test).

WithdrawProtocolUgnot

WithdrawProtocolUgnot lets the treasury pull free ugnot from the pad bank (e.g. raised backlog after Gnoswap list, to re-wrap as WUGNOT inventory). Capped by free balance; panics if amount > free.

BalanceOf

ListBuyers

ListBuyers returns unique buyer addresses (one per line), capped for query size. Only addresses that bought at least once on this pad (UniqueBuyers). Not full GRC20 holders who received tokens via transfer.

GetStatus

GetRaised

GetPool

GetCreatorFees

ProtocolFees

LaunchCount

ResolveSymbol

ListIDs

ListIDs returns newline-separated launch IDs (sorted by AVL key / creation order).

LaunchInfo

LaunchInfo returns a single-line pipe-delimited summary for UIs/indexers: id|name|symbol|status|raised|sold|buyers|creatorFees|poolUgnot|poolToken|uri|creator|virtualUgnot|virtualToken|created|tokenID|gnoswapReady|gnoswapListed|gnoswapPoolPath status: 0=curve 1=graduated; gnoswapReady/listed: 0|1

ParamsInfo

ParamsInfo returns parameters for UI display. total|curve|poolSeed|gradThreshold|feeBps|createBond createBond is live from bond realm when not in unit-test mode.

TradeHistory

TradeHistory returns newline-separated chart points: height|side|ugnot|tokens|priceScaled side: 0=buy 1=sell 2=open/graduate. Ordered oldest → newest.

TradeCount

TradeCount returns number of stored chart samples for a launch.

resetForTest

resetForTest clears package state between unit tests.

TotalSupply

CurveSupply

// sold on bonding curve

PoolSeed

VirtualUgnot0

// 30 GNOT virtual

VirtualToken0

// virtual token side

GraduationThreshold

FeeBPS

CreatorFeeShareBPS

ProtocolFeeShareBPS

CreateBondUgnot

BondRefundBuyers

BondRefundMinRaised

// ≥5 GNOT raised

BondRefundMaxHeights

AntiSnipeHeights

AntiSnipeMaxBuyBPS

// 5% per address in window

StatusCurve

StatusGraduated

MaxTradeHistory

TradeSideBuy

TradeSideSell

TradeSideOpen

// initial listing mark

DenomUgnot

GnoswapFeeTier

// 0.3% meme tier

GnoswapTickSpacing

GnoswapMinTick

GnoswapMaxTick

GnoswapMaxFeeWugnot

// 5000 GNOT

Render

Render provides on-chain discovery (gnoweb). Read-only by convention. Paths: "" — home / list token/{id} — launch detail help — API help

sanitize

renderHome

renderToken

progressBar

renderHelp