bounties state

Denom

Denom is the only asset this realm accepts.

MaxFeeBps

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

StatusOpen

Bounty status values.

StatusAwarded

Bounty status values.

StatusCancelled

Bounty status values.

maxTitleLen

bounty

Bounty is one bounty record. Fields are unexported; read access goes through BountyInfo so no interior pointers escape the realm.

admin

// may set fee, fee recipient, successor admin

feeRecipient

// may withdraw fees and sweep surplus

feeBps

// protocol fee snapshotted into new bounties

self

// this realm's address, captured at deploy

nextID

// next bounty id (first bounty gets id 1)

openTotal

// == Σ amount over bounties with status Open

bounties

// padID(id) -> \*bounty

ledger

init.15

CreateBounty

CreateBounty escrows the attached GNOT as a new open bounty and returns its id. Only direct EOA calls with -send are accepted (the receipt-guaranteed shape). The envelope must be exactly one positive ugnot coin. The caller becomes the bounty's funder.

Award

Award closes an open bounty in favor of winner: the escrowed amount leaves the open pool and is credited to winner's claimable balance through the ledger, charging the fee snapshotted at creation. Only the bounty's funder may award it. Terminal: an awarded bounty can never change again.

Cancel

Cancel closes an open bounty and refunds its escrow to the funder's claimable balance, fee-free. Only the bounty's funder may cancel. Terminal: a cancelled bounty can never change again.

Claim

Claim sends amount ugnot of the caller's claimable balance (won bounties 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 (the bounded escape hatch validated on the vault realm). 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 bounties at creation. Existing bounties 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, as on the vault).

BountyInfo

BountyInfo returns a bounty's fields by value: funder, title, amount, snapshotted fee bps, status, winner (zero address unless awarded).

Admin

FeeRecipient

FeeBps

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

NumBounties

NumBounties returns how many bounties have ever been created.

OpenTotal

OpenTotal returns the escrow held by open bounties (the B term).

BalanceOf

BalanceOf returns addr's claimable balance (won bounties + 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 (the H term).

Surplus

Surplus returns Held() - Liabilities() (the S term; >= 0 unless a conservation bug exists).

Address

Render

Render shows configuration, totals, the composed conservation check, and the most recent bounties (bounded page, newest first).

assertAdmin

mustGetBounty

assertValidTitle

assertValidTitle bounds length and restricts the charset so titles cannot inject markdown into Render output.

padID

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

send

send moves amount ugnot from the realm to \`to\`. Callers must have debited the ledger first (checks-effects-interactions).

itoa

checkedAdd