#cosmwasm #cosmos #ownership #ownable #smart-contracts #controlling #contract

luru20-cw-ownable

CosmWasm智能合约所有权控制的实用工具

3个稳定版本

2.0.2 2024年4月2日
2.0.0 2024年4月1日

#2 in #ownable

Apache-2.0

29KB
409 代码行

Luru20 CW Ownable

控制CosmWasm智能合约所有权的实用工具。

如何使用

使用此crate提供的 initialize_owner 方法在实例化期间初始化所有者

use cosmwasm_std::{entry_point, DepsMut, Env, MessageInfo, Response};
use luru20_cw_ownable::OwnershipError;

#[entry_point]
pub fn instantiate(
    deps: DepsMut,
    env: Env,
    _info: MessageInfo,
    msg: InstantiateMsg,
) -> Result<Response<Empty>, OwnershipError> {
    luru20_cw_ownable::initialize_owner(deps.storage, deps.api, msg.owner.as_deref())?;
    Ok(Response::new())
}

使用 #[cw_ownable_execute] 宏来扩展您的执行消息

use cosmwasm_schema::cw_serde;
use luru20_cw_ownable::cw_ownable_execute;

#[cw_ownable_execute]
#[cw_serde]
enum ExecuteMsg {
    Foo {},
    Bar {},
}

该宏将一个新变体 UpdateOwnership 插入到枚举中

#[cw_serde]
enum ExecuteMsg {
    UpdateOwnership(luru20_cw_ownable::Action),
    Foo {},
    Bar {},
}

其中 Action 可以是以下三种之一

  • 提议将合约所有权转让给另一个账户
  • 接受提议的所有权转让
  • 放弃所有权,永久将合约所有者设置为空

使用此crate提供的 update_ownership 函数处理消息

use cosmwasm_std::{entry_point, DepsMut, Env, MessageInfo, Response};
use luru20_cw_ownable::{cw_serde, update_ownership, OwnershipError};

#[entry_point]
pub fn execute(
    deps: DepsMut,
    env: Env,
    info: MessageInfo,
    msg: ExecuteMsg,
) -> Result<Response, OwnershipError> {
    match msg {
        ExecuteMsg::UpdateOwnership(action) => {
            update_ownership(deps, &env.block, &info.sender, action)?;
        }
        _ => unimplemneted!(),
    }
    Ok(Response::new())
}

使用 #[cw_ownable_query] 宏来扩展您的查询消息

use cosmwasm_schema::{cw_serde, QueryResponses};
use luru20_cw_ownable::cw_ownable_query;

#[cw_ownable_query]
#[cw_serde]
#[derive(QueryResponses)]
pub enum QueryMsg {
    #[returns(FooResponse)]
    Foo {},
    #[returns(BarResponse)]
    Bar {},
}

该宏插入一个新变体 Ownership

#[cw_serde]
#[derive(QueryResponses)]
enum QueryMsg {
    #[returns(Ownership<String>)]
    Ownership {},
    #[returns(FooResponse)]
    Foo {},
    #[returns(BarResponse)]
    Bar {},
}

使用此crate提供的 get_ownership 函数处理消息

use cosmwasm_std::{entry_point, Deps, Env, Binary};
use luru20_cw_ownable::get_ownership;

#[entry_point]
pub fn query(deps: Deps, env: Env, msg: QueryMsg) -> StdResult<Binary> {
    match msg {
        QueryMsg::Ownership {} => to_binary(&get_ownership(deps.storage)?),
        _ => unimplemented!(),
    }
}

许可证

此crate版本 2.0.0 及以前的版本内容根据 GNU Affero General Public License v3 或更高版本发布;该版本之后的版本根据 Apache-2.0 许可证发布。

依赖

~5–8MB
~170K SLoC