Skip to content Search Apps Documentation Source Content File Folder Download Copy Actions State String Boolean Number Struct Map Slice Pointer Function Closure Reference Nil Package Type Interface Unknown

Community realm. Read the code first. Community realm, deployed by its author. Read the code before you interact or send coins.

hlgov package

Overview

Package hlgov carries GovDAO's decisions to Solana (bridge/PLAN.md §5.3, §6.5, §13): a proposal made with one of the builders below, when it executes, dispatches a message through r/hlmailbox to the admin program — the decision's kind, its parameters and its sequence number (this realm's own counter, taken at execution) — and the admin program records it by that number and executes it after its clock. Anyone may re-dispatch an executed decision (the same number and parameters) until the admin program has recorded it. The builders check the parameters with the admin program's own rules, so a proposal that would fail on Solana is refused when it is made. Kind 4 is reserved and its builder refuses every call (§13); a cancel's body starts with an 8-byte salt drawn in the executing transaction, so two cancels of one list differ; kind 12 names a token's mint limits on the pausable ISM (the per-message maximum and the day cap, in base units), one of the 7-day group.

Two decisions change this realm alone: `set decision recipient` (the program id decisions go to, a 7-day change, how a successor admin program ever receives one) and `sync sequence` (at once: the counter is raised — never lowered — to the number the admin program expects next, when a foreign decision has taken one, §6.5). The counter starts at a compiled number (launchSequence: 0 for a chain's first r/hlgov, the predecessor's last number for a successor), so no number the admin program recorded is ever reused. Before the Launch decision every builder but the cancel of a queued change here is refused. Who decides is the governor's (M1k): the compiled launchGovernor through Govern until it yields on r/hlmailbox, GovDAO's proposals after. Every launch value is compiled in below.

Function

NewEnrollRouterRequest

func NewEnrollRouterRequest(cur realm, token uint8, domain uint32, router string) Request
Ask AI Claude ChatGPT

NewEnrollRouterRequest is kind 6: enroll a token's remote router for a domain. For gno.land's own domain the router must be a route realm registered with hlmailbox — the launch routes, and the successors their migrations named — as 32 bytes: the synthetic program takes every Dispatch from the router it enrolls as a mint order, and hlmailbox's Dispatch is open to any realm, so any other address would mint synthetic that no lock backs; the token's own route (R36), unmigrated, and — a successor — one that pulled page 0 (R35). The rules are checked when the proposal is made and again when it executes. The closure then notes with the mailbox the route it enrolled and the height (hlmailbox.NoteEnrolled, AR1): that route's refund builder waits 14 days after the note (R37: a week for the delivery, a week for Solana's clock), since a refunded send stays deliverable on Solana until the predecessor's router is replaced; a cancel of the kind 6 clears the note (NewCancelRequest).

Params

Command

# WARNING: This command is running in an INSECURE mode.
# It is strongly recommended to use a hardware device for signing
# and avoid trusting any computer connected to the internet,
# as your private keys could be exposed.

gnokey maketx call -pkgpath "gno.land/r/g1zdaz6sypk5tdsjc2fzsqrrn4ttn8qzmnl4waqp/hlgov" -func "NewEnrollRouterRequest" -args $'' -args $'' -args $'' -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -chainid "gnoland-1" -remote "https://rpc.gno.land" ADDRESSgnokey query -remote "https://rpc.gno.land" auth/accounts/ADDRESS
gnokey maketx call -pkgpath "gno.land/r/g1zdaz6sypk5tdsjc2fzsqrrn4ttn8qzmnl4waqp/hlgov" -func "NewEnrollRouterRequest" -args $'' -args $'' -args $'' -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -broadcast=false ADDRESS > call.tx
gnokey sign -tx-path call.tx -chainid "gnoland-1" -account-number ACCOUNTNUMBER -account-sequence SEQUENCENUMBER ADDRESS
gnokey broadcast -remote "https://rpc.gno.land" call.tx