pad 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).

listFund

listFund tracks assets pulled from the listing caller for refund / LP ugnot reimburse.

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). Does not pull from user - see prepareCallerListFunding.

prepareCallerListFunding

prepareCallerListFunding fills pad inventory shortfall from the EOA caller via TransferFrom. padv14+ WUGNOT raise: Buy already TransferFrom WUGNOT to pad, so wBal >= raised at graduate in the normal case — only GNS fee (or small fee WUGNOT budget) may be short. Legacy ugnot-raise pads: wugnot.Deposit is EOA-only; caller wraps temp LP then reimbursed.

listFeeWugnotPull

listFeeWugnotPull is the WUGNOT amount pulled from the listing caller for ExactOut → GNS when they do not hold CreatePool fee in GNS. Kept well below GnoswapMaxFeeWugnot so List does not demand 5k+ GNOT wrap.

pullWugnotFrom

pullWugnotFrom is intentionally a no-op pull. GRC20 TransferFrom from a realm often panics "insufficient allowance" even when Allowance(owner, pad) is set (spender frame resolves to EOA, not pad). Soft-fail instead so list can fall back to notes / surplus / pre-funded pad inventory. UI must pre-fund pad via wugnot.Transfer(pad, amount) and gns.Transfer(pad, fee) before RetryListGnoswap — never rely on Approve+TransferFrom in the same flow.

pullGnsFrom

safeWugnotTransfer

safeGnsTransfer

refundCallerListFunding

settleCallerListFunding

settleCallerListFunding returns unused fee-budget WUGNOT to the caller. LP shortfall pull is rare on WUGNOT-raise pads (raised already on pad); if it happened, reimburse in WUGNOT from any leftover pad balance after list.

listOnGnoswapWithFunding

listOnGnoswapWithFunding is the full auto path: pull inventory from caller if needed, CreatePool+Mint, reimburse LP ugnot / refund on failure.

listNeedOf

listNeedOf: poolU|wHave|wNeedLp|gnsHave|gnsNeed|feeGns|feeWugnotBudget|padAddr

ListNeed

ListNeed is the public query for the Token list wizard (default venue).

ListNeedFor

ListNeedFor is venue-aware; only gnoswap has a Need adapter today.

ListedOf

ListedOf reports whether the launch is listed on any venue.

ListPoolPathOf

ListPoolPathOf returns the pool path after listing.

ListNoteOf

ListNoteOf returns the listing status note.

swapWugnotForGNS

computeSqrtPriceX96

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.

VenueGnoswap

ListVenue IDs (compile-time switch in tryListVenue). Adding a new DEX means a new case + adapter file and a new pad version — Gno cannot dynamically import by path string.

VenueZdex

ListVenue IDs (compile-time switch in tryListVenue). Adding a new DEX means a new case + adapter file and a new pad version — Gno cannot dynamically import by path string.

listVenueMeta

listVenueMeta is registry metadata (not a callable adapter).

listVenues

// id -> \*listVenueMeta

defaultListVenue

ensureListVenuesSeeded

registerListVenue

normalizeVenueID

venueEnabled

DefaultListVenue

DefaultListVenue returns the venue id used when callers pass "".

SetDefaultListVenue

SetDefaultListVenue sets the default list venue (protocol only).

SetListVenue

SetListVenue registers or updates venue metadata (protocol only). Does not add compile-time dispatch — unknown ids stay non-listable until tryListVenue gains a case in a future pad version.

ListVenues

ListVenues returns newline-separated "id|label|enabled|feeHint" (enabled 0|1).

ListVenueOf

ListVenueOf returns the venue id used for a successful list (or "").

resetListVenuesForTest

resetListVenuesForTest clears venue registry (unit tests).

tryListVenue

tryListVenue dispatches to a compile-time adapter. Unknown / disabled venues soft-fail with a note (no panic) so UI can show ListNeed guidance.

launches

// id -> \*Launch

bySymbol

// symbol -> id string

nextID

nextTokenID

// GRC20 identity sequence (shared for all launches)

padAddr

protocolAddr

protocolFees

protocolFeesPaid

inited

testSkipBanker

testForceGnoswapList

testForceZdexList

pointsEnabled

graduationUgnot

listFeeGnsLive

wugnotCredit

totalWugnotCredit

totalListFeeGns

init.62

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.

requireProtocol

graduationThreshold

graduationThreshold is the live raise target (ugnot). Falls back to const if unset.

SetGraduationThreshold

SetGraduationThreshold updates the live raise target (ugnot, 1 GNOT = 1e6). Protocol/deploy wallet only. Affects open curve launches (remaining raise / ready).

GraduationThresholdLive

GraduationThresholdLive returns the live raise target (ugnot) for UIs/qeval.

SetListFeeGns

SetListFeeGns updates Create-time GNS escrow required for new launches. Protocol/deploy wallet only. Does not change already-escrowed launches.

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

reservedWugnot

reservedWugnot is WUGNOT already committed (markets/fees/user prepaid credits). Excludes bank-only liabilities (create bond ugnot).

freeWugnotOnPad

freeWugnotOnPad is WUGNOT on pad above reserved commitments. After user wugnot.Transfer(pad, amt), free rises; Buy locks free into caller credit.

FreeWugnot

FreeWugnot is free|have|reserved|totalCredit for UI preflight.

prepaidOf

addPrepaid

subPrepaid

PrepaidBalance

PrepaidBalance returns caller's claimable WUGNOT credit on this pad.

PrepaidOf

PrepaidOf returns claimable credit for an address (read helper).

ClaimWugnot

ClaimWugnot withdraws all of the caller's prepaid WUGNOT credit to their wallet. Safe after Buy overpay or after graduate/list — excess stays claimable until claimed.

takeWugnotIn

takeWugnotIn collects amount WUGNOT as payment for Buy/SwapBuy. 1\) Auto-lock free float into caller's prepaid (user must Transfer to pad first). 2) Spend amount from prepaid (overpay stays as credit via creditRefund). No TransferFrom. Tests (testSkipBanker): OriginSend ugnot as synthetic collateral units.

creditRefund

creditRefund keeps unused Buy WUGNOT as claimable prepaid (not instant wallet refund). User calls ClaimWugnot after buy / after list when convenient.

payWugnotOut

payWugnotOut sends WUGNOT from pad to user (production). Tests: pay ugnot via banker when testSkipBanker.

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).

requiredListFeeGns

requiredListFeeGns returns GNS base units the creator must pre-fund (free on pad). Live value from SetListFeeGns; falls back to ListFeeGns const.

ListFeeRequired

ListFeeRequired is a public alias for UIs / qeval.

freeGnsOnPad

freeGnsOnPad is GNS on pad above per-launch list-fee escrow.

FreeGns

FreeGns returns free|have|reserved for UI preflight (GNS list fee).

lockListFeeEscrow

lockListFeeEscrow earmarks free GNS for this launch's CreatePool fee.

listFeeForVenue

listFeeForVenue: gnoswap → ListFeeRequired; zdex / other → 0.

ListFeeRequiredFor

ListFeeRequiredFor is venue-aware Create fee for UI preflight.

unlockListFeeEscrow

unlockListFeeEscrow clears launch GNS escrow; refund sends GNS back to creator.

syncListFeeForVenue

syncListFeeForVenue adjusts escrow after PreferredVenue change (pre-list only).

consumeListFeeEscrow

consumeListFeeEscrow clears launch escrow after successful Gnoswap list (CreatePool spent feeNeed GNS from pad balance).

ClaimListFee

ClaimListFee refunds Create-time GNS escrow to the token creator if still unlisted. Use when graduate/list will not complete or creator abandons listing.

Create

Create deploys a fair-launch meme. Bond amount from bond realm (or fallback const). Also locks ListFeeGns free GNS (creator must Transfer GNS to pad first). No pre-mint; all tradeable float starts on the bonding curve.

CreateWithVenue

CreateWithVenue is Create + PreferredVenue in one MsgCall (fee escrow follows venue). venueId: "zdex" → no GNS list escrow; "gnoswap" → ListFeeRequired GNS.

finishCreate

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 WUGNOT on the bonding curve; credits tokens. amountWugnot: max to spend (may overpay). UI: Deposit + Transfer(pad, amt) + Buy. Overpay stays as claimable prepaid — ClaimWugnot anytime (incl. after list). minTokensOut: slippage floor (0 = disabled). Auto-graduates at threshold or sold-out. Production: collateral is real WUGNOT on pad -> Graduate can auto-list Gnoswap. Tests (testSkipBanker): amountWugnot ignored; OriginSend ugnot is used as units. Last-fill (no overshoot): 1. Cap net so RaisedUgnot never exceeds graduationThreshold() (refund excess WUGNOT). 2. Cap by remaining curve tokens (CurveSupply - RealSold). If the curve is already sold out (or raise already filled), Buy refunds the full take 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 WUGNOT (fee on output). minWugnotOut: slippage floor (0 = disabled). User may wugnot.Withdraw to ugnot.

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

SetPreferredVenue

SetPreferredVenue sets the DEX target used when RetryList(id, "") is called. Creator or protocol only; locked once listed. Syncs Create-time GNS escrow (gnoswap locks ListFeeRequired; zdex unlocks/refunds escrow).

PreferredVenueOf

PreferredVenueOf returns the Create-time / SetPreferredVenue target.

ListSeedReleasedOf

ListSeedReleasedOf reports whether ReleaseListSeed already ran.

ReleaseListSeed

ReleaseListSeed sends graduated internal-CPMM seed to the creator for EOA zdex CreatePool: - PoolUgnot as WUGNOT Transfer to creator (EOA may wugnot.Withdraw → ugnot OriginSend) - PoolToken minted as GRC20 to creator (was pad-accounting only) PoolUgnot/PoolToken kept as listing-size record; reservedWugnot skips via ListSeedReleased. Disables internal SwapBuy/Sell. Creator or protocol may call; assets always go to creator.

ConfirmZdexList

ConfirmZdexList marks a launch listed on zdex after EOA CreatePool succeeded. poolId e.g. "ugnot|SYMBOL" (must be non-empty; no on-chain pool verify). Creator or protocol. Prefer ReleaseListSeed first when pad still holds LP seed.

RetryList

RetryList lists a graduated launch on the chosen venue. Permissionless EOA MsgCall. Uses PoolUgnot / PoolToken (curve-spot sized). venueId: empty → PreferredVenue → DefaultListVenue(); unknown/disabled → soft-fail note.

RetryListGnoswap

RetryListGnoswap is the Gnoswap-specific wrapper (compat for existing UI).

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 internal pool with WUGNOT. amountWugnot: max to spend (Approve pad). minTokensOut: slippage (0 = off). Disabled when listed on Gnoswap (trade via router).

SwapSell

SwapSell sells tokens into the graduated pool for WUGNOT. minWugnotOut: 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|gnoswapNote|listVenue status: 0=curve 1=graduated; gnoswapReady/listed: 0|1 gnoswapNote: optional (padv12+); pipes stripped for delimiter safety. listVenue: optional (padv23+); empty if unlisted.

ParamsInfo

ParamsInfo returns parameters for UI display. total|curve|poolSeed|gradThreshold|feeBps|createBond|listFeeGns createBond is live from bond realm when not in unit-test mode. listFeeGns: Create-time GNS escrow required (padv20+).

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

// mainnet: max raise ≥ 300k GNOT

VirtualToken0

// virtual token side

GraduationThreshold

// 300\_000 GNOT (SetGraduationThreshold later)

FeeBPS

CreatorFeeShareBPS

ProtocolFeeShareBPS

CreateBondUgnot

// 150 GNOT fallback; live = bond realm

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

// 1500 GNOT

ListFeeGns

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

tryListOnZdex

tryListOnZdex — stub until Zdex hub allows farm/realm CreatePool. Live Pearl/mainnet: CreatePool is EOA-only + requireListed. Pad path today: 1. ReleaseListSeed(id) — WUGNOT + minted PoolToken → creator 2. EOA: optional wugnot.Withdraw → Approve(zdex RealmAddr) → CreatePool 3. ConfirmZdexList(id, poolId) — mark ListVenue=zdex Pearl hub: gno.land/r/g1n4pl5uc4yt5r96m9w6fmdznx3x0jyg8l6arhmt/zdex/v3 CreatePool(cur, tokenKey, symbol, amountU, amountT, feeBps) string