hlbubble state

namespace

pkgPath

// must match gnomod.toml

mailboxPath

feesPath

bubblePath

// the live token realm, never redeployed

hlgnotPath

hlgovPath

one

// one BUBBLE in base units

launchFee

launchMinimum

launchFeeFloor

launchCapFloor

launchMaximum

launchRouter

// the BUBBLE token program ETqUXu1uJPj8qgmw8AJMqhgWuL5QW5ymgUMiCARbXYPA

maxI64

launchGovernor

launchGovernor is the governor (M1k): the mailbox's, compiled here too so a member reads it in this realm's served source; init refuses a deploy with another. bridge/local/e2e.sh swaps it for gnodev's test1.

st

realms

init.18

mustKey

now

u32

itoa

caller

mustHex

isRealm

isRealm is whether an address is a realm of the bridge: the six compiled here, every route realm the mailbox registers (R39: a successor's address is refused as a recipient at send and swept at a credit, to be credited to its owner by id, never paid into a realm's account outside every counter) and every one it dropped (AT6: a re-pointed-away successor, a route no more that nothing of the line can move BUBBLE out of). A handful of reads.

mustBeLive

mustNotBePaused

mustNotBeDropped

mustNotBeDropped refuses a realm the mailbox dropped from its line (R35): its predecessor re-pointed the migration to another successor while this realm had pulled nothing, so it is a route no more — Solana's token may still name it the router until the next kind 6, and a send or a credit here would be against a lock no realm of the line holds. The mailbox refuses its Dispatch and its Process too; the line's last realm takes every message addressed to it once its import has ended.

syncLaunch

Address

Locked

Locked is the lock: what backs synthetic BUBBLE on Solana, by the counters (sent − paid).

Balance

Balance is the BUBBLE this realm holds; it is the lock unless someone sent BUBBLE here outside a transfer.

Router

Router is the enrolled router on Solana, in hex.

Domain

Domain is the Solana domain this route sends to and takes from.

Fee

Minimum

FeeFloor

CapFloor

Maximum

Cap

Counters

Counters is the identity's five counters (§5.9): sentTotal, paidTotal, owed, voided, lost.

Migrated

Migrated is the successor's pkgpath once a migration applied, "" before.

TransferRemote

TransferRemote sends amount of the caller's BUBBLE to recipient on destination (a Solana address in base58, or 32 bytes in hex) and returns the message id in hex. First, on the bubble realm, the caller approves THIS realm (bubble.Approve, spender Address()) for at least amount + fee: the amount is locked here, the fee goes to r/hlfees. The amount is between the minimum and the per-message maximum.

Process

Process takes a token message from Solana and credits a claim to its recipient. Anyone may call it with the verifier's metadata and the message, both in hex. A refused message stays undelivered. A realm registered as a successor credits nothing — its own messages included (R32) — before the last page of its predecessor's migration is in (AQ1); a migrated realm refuses before the mailbox is asked (see hlgnot's).

Claim

Claim pays up to n claims (n ≤ 20) taking recipients in turns under the meters, the fee as each claim's first installment. Anyone may call it; the relayers do. It returns how many claims it paid something on.

pay

env

Request

Request is what a builder returns (M1k): the proposal GovDAO's proxy executes after the yield (Proposal), and the same decision the governor runs directly before it (Govern); see hlgnot's.

who

who names a previous realm in a refusal: its pkgpath, or a user's address.

mustBeGovernor

mustBeGovernor is a decision's identity check (M1k), read from the closure's own live cur: the governor's own call until it yields on r/hlmailbox, gno.land/r/gov/dao's proxy exactly after (or from the first block, when no governor was compiled); see hlgnot's.

propose

Govern

Govern is the governor's way in before the yield (M1k): the same closure GovDAO's proxy runs after it, called non-crossing in this frame so it reads the governor from cur.Previous(); refused for anyone else and for everyone once the governor yielded on r/hlmailbox (or when none was compiled); see hlgnot's.

NewSetCapFloorRequest

NewSetMaximumRequest

NewSetFeeRequest

NewSetFeeFloorRequest

NewSetRouterRequest

NewVoidRequest

NewVoidRequest voids credits by message id (a claim, or a sweep entry as forged) or by a range of credits ("heights:\<from>-\<to>" or "since:\<from>", closed at the height the proposal is made, at most 1,000 credits), as withheld or forged, with the unpause option (the seats' holders recorded; a seat whose occupant changed by execution is skipped): see hlgnot's.

NewRestoreRequest

NewCreditRequest

NewSweepRequest

NewSweepRequest pays sweep entries, named by message id, to an address after 7 days — their sum, at most the lock — and drops them (R19): see hlgnot's.

NewRefundRequest

NewRefundRequest queues a refund of imported sends by id, 7 days, once kind 6 has enrolled this realm on Solana for 14 days (AR1, R37); applied then by NewApplyRefundRequest, never by Execute (AT2); see hlgnot's.

NewApplyRefundRequest

NewApplyRefundRequest applies a queued refund decision whose 7 days have passed, at once (AT2): GovDAO's own act after hlwatch's check that the token's router on Solana is this realm; under a standing payouts flag it waits like a claim; see hlgnot's.

NewWriteOffRequest

NewWriteOffRequest books refunded sends delivered on Solana after their refund as lost, after 7 days (AR1); see hlgnot's.

NewMigrateRequest

NewMigrateRequest: a successor that announced itself to the mailbox for the BUBBLE route (R25, AQ5) and is no route already (R31), after 7 days; a realm that succeeds another migrates on only once its own import has ended (R31); see hlgnot's.

NewCancelRequest

Execute

Execute applies a queued decision whose 7 days have passed. Anyone may call it. A sweep payment moves BUBBLE out of the lock, so under a standing payouts flag it waits for the unpause like a claim (§5.9). A refund is never Execute's (AT2): the state refuses the kind, and GovDAO applies it by NewApplyRefundRequest.

Pull

Pull is the successor's: once a migrate decision names it, the realm at that pkgpath calls Pull from its own code, page by page from 0, and receives the lock (transferred to its address, with page 0) and the records to import, up to 500 a page (the snapshot's More says whether a page follows); a page pulled already hands over nothing. Page 0 moves the lock, so under a standing payouts flag it waits for the unpause like a sweep payment (R27, R16); the flag follows the claims to the successor (hlmailbox.AddRoute).

pausedText

Render

Render: "" the route's page; "decisions"; "json"; "decisions.json"; "claim/\<id>"; "send/\<id>"; "claims/\<from>", "sweeps/\<from>" and "refunds/\<from>", up to 100 entries a page (hlgnot's Render says more).

parseFrom

parseFrom reads a page's offset; -1 (an empty page) for anything but a number.