Realm

1package kourtv3
2import (
3	"strconv"
4	"strings"
5)
6func adminAddr() address {
7	if globalDAO != nil {
8		return globalDAO.admin
9	}
10	return directoryAdmin
11}
12func purgeThreshold() int {
13	if globalDAO != nil {
14		return globalDAO.purgeM
15	}
16	return daoBootstrapM
17}
18func daoSeats() int {
19	if globalDAO != nil {
20		return globalDAO.n
21	}
22	return daoBootstrapN
23}
24func AdminParams() string {
25	l := ladderDefault
26	r := creditRatesDefault
27	hosts := MediaHosts()
28	exact, suffix := hosts, ""
29	if i := strings.Index(hosts, "|"); i >= 0 {
30		exact, suffix = hosts[:i], hosts[i+1:]
31	}
32	n := func(v int64) string { return strconv.FormatInt(v, 10) }
33	return "admin:" + adminAddr().String() +
34		";creationBurn:" + n(courtCreationBurn) +
35		";burnBps:" + n(burnBps) +
36		";assocBond:" + n(assocBondDefault) +
37		";purgeM:" + strconv.Itoa(purgeThreshold()) +
38		";t1:" + n(l.t1Bps) +
39		";t2:" + n(l.t2Bps) +
40		";t3:" + n(l.t3Bps) +
41		";entry:" + n(l.postsEntry) +
42		";l2:" + n(l.postsT2) +
43		";l3:" + n(l.postsT3()) +
44		";flag:" + n(r.flag) +
45		";dispute:" + n(r.dispute) +
46		";authorHigh:" + n(r.authorHigh) +
47		";conviction:" + n(r.conviction) +
48		";unadjudicated:" + n(r.unadjudicated) +
49		";domain:" + siteDomain +
50		";mediaExact:" + exact +
51		";mediaSuffix:" + suffix
52}
53const adminParamsPath = "admin-params"
54func renderAdminParams() string {
55	l := ladderDefault
56	r := creditRatesDefault
57	n := func(v int64) string { return strconv.FormatInt(v, 10) }
58	var b strings.Builder
59	b.WriteString("# Realm parameters\n\n")
60	b.WriteString("Everything the global DAO admin can set, and what it is set " +
61		"to now. A court's moderators set their own court's bond, ladder and " +
62		"standing rates; those are on the court's page, not here.\n\n")
63	b.WriteString("Admin: `" + adminAddr().String() + "`\n\n")
64	b.WriteString("| Setting | Now | What it does | Set with |\n")
65	b.WriteString("|---|---|---|---|\n")
66	b.WriteString("| Court creation burn | " + ugnotAmt(courtCreationBurn) +
67		" GNOT | The minimum a new court costs to open. The whole payment is " +
68		"burned. 0 turns it off, and off is the shipped default. | " +
69		"`SetCourtCreationBurn` |\n")
70	b.WriteString("| Burn share of each offering | " + pct(burnBps, bpsDenom) +
71		" | Of every payment for a court's coin, this much burns to the keyless " +
72		"sink for good; the rest is held by that court for all of its coin and " +
73		"paid back pro-rata to anyone who returns coin. One-way courts burn all " +
74		"of it. Applies to payments after the change; " +
75		strconv.FormatInt(minBurnBps, 10) + "–" + strconv.FormatInt(maxBurnBps, 10) +
76		" bps. | `SetBurnBps` |\n")
77	b.WriteString("| Association bond | " + ccAmt(assocBondDefault) +
78		" CC | What a stranger posts to attach an edge, in courts that set no " +
79		"override. | `SetAssociationBondDefault` |\n")
80	b.WriteString("| Purge threshold | " + strconv.Itoa(purgeThreshold()) + " of " +
81		strconv.Itoa(daoSeats()) + " | How many global moderators must agree to purge. | " +
82		"`SetPurgeThreshold` |\n")
83	b.WriteString("| Posting ladder | " + n(l.t1Bps) + "/" + n(l.t2Bps) + "/" +
84		n(l.t3Bps) + " bps at " + n(l.postsEntry) + "/" + n(l.postsT2) + "/" +
85		n(l.postsT3()) + " posts | The default rungs a court inherits: the share " +
86		"earned at each tier and the post counts that reach them. | " +
87		"`SetLadderDefault` |\n")
88	b.WriteString("| Standing rates | flag " + n(r.flag) + " (inert), dispute " +
89		n(r.dispute) + ", author " + n(r.authorHigh) + ", conviction " +
90		n(r.conviction) + ", unadjudicated " + n(r.unadjudicated) +
91		" bps | The default credit each act earns toward standing. Policing " +
92		"ranks above authorship, which ranks above staking. The flag rate is " +
93		"still settable and still bounds what authorship may be set to, but no " +
94		"path credits it since the quality lane was removed. | " +
95		"`SetCreditRatesDefault` |\n")
96	dom := siteDomain
97	if dom == "" {
98		dom = "_none_"
99	}
100	b.WriteString("| Site domain | " + dom + " | The website this realm belongs " +
101		"to. Also allow-lists that domain for images without listing it below. | " +
102		"`SetSiteDomain` |\n")
103	hosts := MediaHosts()
104	if hosts == "|" {
105		hosts = "_none_"
106	}
107	b.WriteString("| Media hosts | " + hosts + " | Where images may be loaded " +
108		"from: exact hosts before the bar, suffixes after it. | " +
109		"`SetMediaHosts` |\n")
110	b.WriteString("\nBurned to date — the sink's balance, which is every burn share, " +
111		"every creation burn, and anything else ever sent there: **" +
112		ugnotAmt(BurnedGNOT()) + " GNOT**, held at `" + BurnSink().String() +
113		"` — an address derived from a package path that the path grammar can " +
114		"never assign to a deployed realm, so no key to it exists and nothing " +
115		"can ever be spent from it. " +
116		"Held for coin, across every court: **" + ugnotAmt(TotalReserveGNOT()) +
117		" GNOT**, at this realm's own address — which no instruction but a " +
118		"holder returning coin for its pro-rata share can move.\n")
119	return b.String()
120}
121