grants state

Denom

Denom is the only asset this realm accepts.

MaxFeeBps

MaxFeeBps is the hard protocol-fee cap: 1000 bps = 10%.

StatusOpen

Grant status values.

StatusAwarded

Grant status values.

StatusCancelled

Grant status values.

StatusExpired

Grant status values.

MaxTitleLen

Input bounds.

MaxDescLen

Input bounds.

MaxPitchLen

Input bounds.

MinDurationBlocks

Input bounds.

MaxDurationBlocks

Input bounds.

ExpiryGraceBlocks

Input bounds.

application

grant

admin

// may set fee, fee recipient, successor admin

feeRecipient

// may withdraw fees and sweep surplus

feeBps

// fee snapshotted into NEW grants

self

// this realm's address, captured at deploy

nextID

openTotal

// == Σ amount over grants with status Open

grants

// padID(id) -> \*grant

ledger

init.22

CreateGrant

CreateGrant escrows the attached GNOT as a new open grant and returns its id. Only direct EOA calls with -send are accepted. The current protocol fee is snapshotted into the grant — and must not exceed maxFeeBps, the ceiling the caller signed for (rejects a fee raise sequenced ahead of this transaction); pass MaxFeeBps to accept any legal fee. The application window is durationBlocks from now.

Apply

Apply submits (or re-submits) the caller's application to an open grant before its deadline. One application per address per grant — re-applying replaces the caller's own pitch only. The creator cannot apply to their own grant.

SelectWinner

SelectWinner awards an open grant to one of its applicants: the escrow leaves the open pool and is credited to the winner's claimable balance through the ledger, charging the fee snapshotted at creation. Only the grant's creator may select, and only an address that actually applied can win. Terminal.

CancelGrant

CancelGrant closes an open grant and refunds its escrow to the creator's claimable balance, fee-free. Only the creator may cancel. Terminal.

ExpireGrant

ExpireGrant closes an open grant whose deadline passed more than ExpiryGraceBlocks ago, refunding the creator fee-free. ANYONE may call it — this is the permissionless valve that guarantees escrow can never be trapped by an inactive creator. Terminal.

refundOpen

refundOpen moves an Open grant's escrow into the creator's claimable balance fee-free and finalizes the status. Callers have already verified authorization and status.

Claim

Claim sends amount ugnot of the caller's claimable balance (won grants and refunds) back to the caller.

ClaimAll

ClaimAll sends the caller's entire claimable balance back to the caller. Fails if there is nothing to claim.

WithdrawFees

WithdrawFees sends the accrued fee pot to the fee recipient. Only the fee recipient may call it.

SweepDenom

SweepDenom sends the surplus of a single denomination to the fee recipient. For ugnot only the excess over Liabilities() moves; other denoms move wholly. Only the fee recipient may call it.

SetFeeBps

SetFeeBps sets the protocol fee snapshotted into FUTURE grants at creation. Existing grants keep the fee they were created under. Admin only; bounded by \[0, MaxFeeBps].

SetFeeRecipient

SetFeeRecipient re-points the fee/surplus role, including the pot accrued so far. Admin only; zero address rejected.

TransferAdmin

TransferAdmin hands the admin role to next. Admin only; zero address rejected. One-step (documented trade-off).

GrantInfo

GrantInfo returns a grant's fields by value: creator, title, amount, snapshotted fee bps, application deadline (block height), status, winner (zero unless awarded), and number of applicants.

Description

Description returns a grant's raw description text.

ApplicationOf

ApplicationOf returns addr's pitch and submission height for a grant, with ok reporting whether an application exists.

Admin

FeeRecipient

FeeBps

FeeBps returns the fee that will be snapshotted into newly created grants (existing grants keep their own snapshot).

FeeOn

FeeOn previews the fee and net payout for a grant of amount at the CURRENT FeeBps.

NumGrants

NumGrants returns how many grants have ever been created.

OpenTotal

OpenTotal returns the escrow held by open grants (the G term).

BalanceOf

BalanceOf returns addr's claimable balance (won grants + refunds).

UsersTotal

UsersTotal returns the sum of all claimable balances (the U term).

FeesAccrued

FeesAccrued returns the fee pot (the F term).

Liabilities

Liabilities returns everything this realm owes: openTotal + UsersTotal + FeesAccrued.

Held

Held returns the ugnot actually held at the realm address (H).

Surplus

Surplus returns Held() - Liabilities() (the S term).

Address

Height

Height returns the current chain height (deadline arithmetic aid).

Render

Render shows the market at "" and a grant detail at "\<id>". Free text (titles are charset-restricted; descriptions are not) passes through the ecosystem sanitizer before hitting markdown.

renderGrant

assertAdmin

mustGetGrant

assertValidTitle

assertValidTitle bounds length and restricts the charset so titles are list-safe in Render without escaping.

padID

padID renders an id as a fixed-width key so avl iteration order is numeric order.

itoa

checkedAdd