EOS require_auth函数
action的结构
要说清楚这个方法的含义和用法,咱们需要从action
的结构说起。详见eoslib.hpp
中的action类,这里把它的结构简化表示成下面这样:
* struct action { * account_name account; // the contract defining the primary code to execute for code/type * action_name name; // the action to be taken * permission_level[] authorization; // the accounts and permission levels provided * bytes data; // opaque data processed by code * };
一个action的数据包含:
account: action的处理器(handler)所在的合约账号 name: action的名字 authorization: 调用者提供的action的权限列表(可以是一组keys,也可以是一组别人的许可权限,回忆一下前几篇关于自定义许可权限的内容,把知识点打通) data: action的数据参数,如果是transfer action,这里的数据就是类似这样的内容:
{ "from": "inita", "to": "initb", "amount": "100.0000 EOS", "memo": "1234"}
你可能说,“不对,data明明是个byte数组,怎么能存储一个结构呢?”,这其实是数据序列化的结果,关于序列化和反序列化,如果你还不是很了解,可以从网上搜索一下相关知识。
require_auth
现在我们再说require_auth
就比较容易了,先看签名:
/** * Verifies that @ref name exists in the set of provided auths on a action. Throws if not found. * * @brief Verify specified account exists in the set of provided auths * @param name - name of the account to be verified */ void require_auth( account_name name );
英文好的看下注释,再结合action的结构就完全明白了:它校验通过name
形参传进来的账户,看是否在本action已提供的权限列表
中。如果在,则校验通过,否则,抛出异常。
比如如果执行下面的命令发起一个action:
cleos push action hello.code hi '["user"]' -p user@active
这里发起的这个hi
action的结构就是类似这样的:
{ "account": "hello.code", "name": "hi", "authorization": [ {"account": "user", "permission":"active"} ], "data": ["user"] }
所以如果在hi
action的处理器里面调用require_auth(N(user))
是可以通过检查的,因为user
在authorization
数组中;而require_auth(N(hello.code))
就会检测失败,并抛出异常。
有时候,你可能就想看看某个账户是否在action的已提供权限列表
里,并不想抛出异常,那该怎么办?
这个时候可以用has_auth方法:
/** * Verifies that @ref name has auth. * * @brief Verifies that @ref name has auth. * @param name - name of the account to be verified */ bool has_auth( account_name name );
require_auth2
还有一个类似的require_auth2
方法,它的签名是这样的:
/** * Verifies that @ref name exists in the set of provided auths on a action. Throws if not found. * * @brief Verify specified account exists in the set of provided auths * @param name - name of the account to be verified * @param permission - permission level to be verified */ void require_auth2( account_name name, permission_name permission );
这个检查更为严格一点,除了指定账户,还要指定许可。这个许可是严格检查的,也就是说,假如你在代码里写的是:
require_auth(N(user), N(active));
那么下面的命令是通不过这个检查的:
cleos push action hello.code hi '["user"]' -p user@owner
尽管这里使用的是更高的权限user@owner
,也无法通过检查。
原文地址:https://www.cnblogs.com/zhangmingcheng/p/11532548.html
- JavaScript 教程
- JavaScript 编辑工具
- JavaScript 与HTML
- JavaScript 与Java
- JavaScript 数据结构
- JavaScript 基本数据类型
- JavaScript 特殊数据类型
- JavaScript 运算符
- JavaScript typeof 运算符
- JavaScript 表达式
- JavaScript 类型转换
- JavaScript 基本语法
- JavaScript 注释
- Javascript 基本处理流程
- Javascript 选择结构
- Javascript if 语句
- Javascript if 语句的嵌套
- Javascript switch 语句
- Javascript 循环结构
- Javascript 循环结构实例
- Javascript 跳转语句
- Javascript 控制语句总结
- Javascript 函数介绍
- Javascript 函数的定义
- Javascript 函数调用
- Javascript 几种特殊的函数
- JavaScript 内置函数简介
- Javascript eval() 函数
- Javascript isFinite() 函数
- Javascript isNaN() 函数
- parseInt() 与 parseFloat()
- escape() 与 unescape()
- Javascript 字符串介绍
- Javascript length属性
- javascript 字符串函数
- Javascript 日期对象简介
- Javascript 日期对象用途
- Date 对象属性和方法
- Javascript 数组是什么
- Javascript 创建数组
- Javascript 数组赋值与取值
- Javascript 数组属性和方法
- REST服务,使用Dubbo还是SpringMVC?
- Linux系统下Anaconda的安装和使用教程
- Flutter Dojo设计之道——利用Github打造完善的开源项目
- 最强 Redis 客户端 lettuce 已支持 Redis6客户端
- 还在手动整理数据库文档?试试这个工具
- Elasticsearch 常见的 8 种错误及最佳实践
- Spark流式状态管理
- Scala中的IO操作及ArrayBuffer线程安全问题
- 设计模式之单例模式
- Roslyn 理解 msbuild 的清理过程
- gorm聚合查询group结合join和count
- 潘石屹用Python解决100个问题 | 集合
- Catalina 默认使用zsh了,你可习惯
- LeetCode 354 Russian Doll Envelopes (动态规划)
- 设计模式之原型模式