keeper.gno
3.50 Kb · 116 lines
1package keeper
2
3import (
4 "gno.land/p/gnoswap/order/access/manager/v0"
5)
6
7// AddRole registers a custom role with label and returns its id.
8// Admin or governance only.
9func AddRole(cur realm, label string) manager.RoleId {
10 assertIsAdminOrGovernance(cur)
11 assertIsAvailableLabel(label)
12
13 role := nextCustomRoleId()
14 registerRole(role, label)
15
16 return role
17}
18
19// SetRoleLabel renames a registered role. Admin or governance only.
20func SetRoleLabel(cur realm, role manager.RoleId, label string) {
21 assertIsAdminOrGovernance(cur)
22 assertIsRegisteredRole(role)
23 assertIsAvailableLabel(label)
24
25 roleLabels[role] = label
26 emitRoleLabel(role, label)
27}
28
29// GrantRole grants role to account and reports whether account is a new
30// member. Membership starts after the role's grant delay.
31// Admin or governance only.
32func GrantRole(cur realm, role manager.RoleId, account address) bool {
33 assertIsAdminOrGovernance(cur)
34 assertIsRegisteredRole(role)
35 assertIsValidAddress(account)
36
37 newMember := accessState.GrantRole(role, account)
38 emitRoleGranted(role, account, accessState.GetRoleMemberSince(role, account), newMember)
39
40 return newMember
41}
42
43// RevokeRole revokes role from account and reports whether it was a member.
44// Admin or governance only.
45func RevokeRole(cur realm, role manager.RoleId, account address) bool {
46 assertIsAdminOrGovernance(cur)
47 assertIsRegisteredRole(role)
48
49 revoked := accessState.RevokeRole(role, account)
50 if revoked {
51 emitRoleRevoked(role, account)
52 }
53
54 return revoked
55}
56
57// RenounceRole revokes role from the caller.
58// callerConfirmation must be the caller's address.
59func RenounceRole(cur realm, role manager.RoleId, callerConfirmation address) bool {
60 assertIsRegisteredRole(role)
61
62 account := cur.Previous().Address()
63
64 revoked := accessState.RenounceRole(role, account, callerConfirmation)
65 if revoked {
66 emitRoleRevoked(role, account)
67 }
68
69 return revoked
70}
71
72// SetRoleGrantDelay schedules the delay, in seconds, before new members of role
73// become active. The change itself waits manager.MinSetback.
74// Admin or governance only.
75func SetRoleGrantDelay(cur realm, role manager.RoleId, delay uint32) {
76 assertIsAdminOrGovernance(cur)
77 assertIsRegisteredRole(role)
78
79 accessState.SetGrantDelay(role, delay)
80 emitRoleGrantDelayChanged(role, delay, accessState.GetRoleGrantDelayEffect(role))
81}
82
83// SetTargetFunctionRole assigns role, or manager.PublicRole for anyone, to
84// selector on target (a realm package path). Admin or governance only.
85func SetTargetFunctionRole(cur realm, target string, selector manager.Selector, role manager.RoleId) {
86 assertIsAdminOrGovernance(cur)
87 assertIsValidTarget(target)
88 assertIsAssignableRole(role)
89
90 accessState.SetTargetFunctionRole(target, selector, role)
91 emitTargetFunctionRoleUpdated(target, selector, role)
92}
93
94// SetTargetFunctionRoles assigns role to several selectors on target.
95// Admin or governance only.
96func SetTargetFunctionRoles(cur realm, target string, selectors []manager.Selector, role manager.RoleId) {
97 assertIsAdminOrGovernance(cur)
98 assertIsValidTarget(target)
99 assertIsAssignableRole(role)
100
101 accessState.SetTargetFunctionRoles(target, selectors, role)
102
103 for _, selector := range selectors {
104 emitTargetFunctionRoleUpdated(target, selector, role)
105 }
106}
107
108// SetTargetClosed closes or reopens target. A closed target rejects every
109// call, whatever its selector roles. Admin or governance only.
110func SetTargetClosed(cur realm, target string, closed bool) {
111 assertIsAdminOrGovernance(cur)
112 assertIsValidTarget(target)
113
114 accessState.SetTargetClosed(target, closed)
115 emitTargetClosed(target, closed)
116}