This package is used to manage the authentication of callers for any arbitrary message type.
Usage
The first step is to create some sort of config type which has access to stored addresses.
#[derive(Copy,Display)]#[cw_serde]pubenumConfig{Admin,Bot,}Then you should impl GetPermissionGroup for the Config.
implGetPermissionGroupforConfig{fnget_permission_group(&self,deps:Deps<implCustomQuery>,_env:&Env) -> Result<PermissionGroup,NeptAuthError>{// How your config accesses storage is up to you// Here we use a map from cw_storage_plusOk(vec![self.load(deps).unwrap()].into())}}Then you can can assign a permission group for each variant in a given message type. Here I use ExecuteMsg as an example.
usecrate::config::Config::*;implNeptuneAuthforExecuteMsg{fnpermissions(&self) -> Result<Vec<&dynGetPermissionGroup>,NeptAuthError>{Ok(matchself{ExecuteMsg::SetConfig{ .. } => vec![&Admin],ExecuteMsg::AddAsset{ .. } => vec![&Bot],ExecuteMsg::RemoveAsset{ .. } => vec![&Bot],ExecuteMsg::UpdatePrices{ .. } => vec![&Admin,&Bot],})}}And finally you place the authorization check inside the execute entry point (or wherever else you'd like to verify authorization).
#[cfg_attr(not(feature = "library"), entry_point)]pubfnexecute(deps:DepsMut<implCustomQuery>,env:Env,info:MessageInfo,msg:ExecuteMsg) -> Result<Response,MyError>{// This is the line that checks the permissions// It will return an error if the caller does not have the required permissions
msg.neptune_authorize(deps.as_ref(),&env,&info.sender)?;
...}