const DCAKeeperRole, LimitKeeperRole, PoolManagerRole
Roles registered at deployment.
Package keeper is the role-based access realm of the GnoSwap order realms.
Package keeper is the role-based access realm of the GnoSwap order realms.
It owns a manager.State (gno.land/p/gnoswap/order/access/manager/v0). Roles are granted to keeper accounts, and each order realm function (target package path and selector) is assigned the role allowed to call it, or PublicRole for anyone.
Administration is not a manager role: every management call is checked against the GnoSwap admin or governance (gno.land/r/gnoswap/access). manager.AdminRole is never granted here.
Roles registered at deployment:
DCA ExecuteGroup and ForceCancelOrder are assigned to DCAKeeperRole at deployment, so only granted keepers run DCA rounds and force-cancel orders that block them. The whitelist realm's AddWhitelistedPool and RemoveWhitelistedPool, and DCA's SetTokenMinAmountPerExecution and SetPairPriceLimit are assigned to PoolManagerRole, so only granted managers pick the pools and the price limits rounds trade with (admin and governance may call them too). This role intentionally manages both targets' whitelists and DCA's token minimums and pair price limits; target-specific manager roles are not required. It does not grant ExecuteGroup, ForceCancelOrder, or ExecuteOrder. Keeping the two roles on separate accounts means a single leaked key cannot both choose a round's pool or price and run it.
Admin or governance adds custom roles with AddRole.
Order realms check authorization with IsAuthorized(target, selector, caller), passing their own package path, or with the non-crossing AssertIsAuthorizedCaller(0, cur, selector), which derives the target from cur.
Roles registered at deployment.
Role labels registered at deployment.
1const (
2 DCATarget = "gno.land/r/gnoswap/order/dca"
3 SelectorExecuteGroup manager.Selector = "ExecuteGroup"
4 SelectorAddWhitelistedPool manager.Selector = "AddWhitelistedPool"
5 SelectorRemoveWhitelistedPool manager.Selector = "RemoveWhitelistedPool"
6 SelectorForceCancelOrder manager.Selector = "ForceCancelOrder"
7
8 SelectorSetTokenMinAmountPerExecution manager.Selector = "SetTokenMinAmountPerExecution"
9 SelectorSetPairPriceLimit manager.Selector = "SetPairPriceLimit"
10
11 LimitTarget = "gno.land/r/gnoswap/order/limit"
12 SelectorExecuteOrder manager.Selector = "ExecuteOrder"
13
14 WhitelistTarget = "gno.land/r/gnoswap/order/whitelist"
15)Order realm targets and keeper selectors.
AddRole registers a custom role with label and returns its id. Admin or governance only.
AssertIsAuthorizedCaller panics unless the caller of rlm may call selector on the realm of rlm. Order realms call it with their own realm value, so a realm can only assert for itself.
GetRoleGrantDelay returns the grant delay of role in effect now, in seconds.
GetRoleLabel returns the label of a registered role, or "".
GetRoleMemberSince returns when account's membership of role becomes active, or 0 if account is not a member.
GetRolesJSON returns the registered roles as a JSON array of {"id", "label"} objects, ordered by id.
GetTargetFunctionRole returns the role assigned to selector on target. Unassigned selectors return manager.AdminRole, which no account holds.
GrantRole grants role to account and reports whether account is a new member. Membership starts after the role's grant delay. Admin or governance only.
HasRole reports whether account is an active member of role.
IsAuthorized reports whether caller may call selector on target now.
IsTargetClosed reports whether target rejects every call.
RenounceRole revokes role from the caller. callerConfirmation must be the caller's address.
RevokeRole revokes role from account and reports whether it was a member. Admin or governance only.
SetRoleGrantDelay schedules the delay, in seconds, before new members of role become active. The change itself waits manager.MinSetback. Admin or governance only.
SetRoleLabel renames a registered role. Admin or governance only.
SetTargetClosed closes or reopens target. A closed target rejects every call, whatever its selector roles. Admin or governance only.
1func SetTargetFunctionRole(cur realm, target string, selector manager.Selector, role manager.RoleId)SetTargetFunctionRole assigns role, or manager.PublicRole for anyone, to selector on target (a realm package path). Admin or governance only.
1func SetTargetFunctionRoles(cur realm, target string, selectors []manager.Selector, role manager.RoleId)SetTargetFunctionRoles assigns role to several selectors on target. Admin or governance only.