区块链【免费下载链接】eosAn open source smart contract platform项目地址https://gitcode.com/gh_mirrors/eo/eos点击查看免费下载cleos get currency是 EOSIO 区块链客户端 cleos 提供的标准货币查询子命令组用于直接读取链上代币合约典型如eosio.token中某个账户的代币余额balance与某类代币的发行统计stats。本文以仓库文档 currency.md 为主体结合 cleos 与 nodeos 的源码实现完整讲解这两个子命令的参数、用法、输出格式及其底层 RPC 机制读者读完即可熟练编写余额与发行量查询脚本并理解查询结果背后的链上数据结构。命令概览get currency 能做什么在 EOSIO 生态中标准代币如 SYS、EOS由代币合约管理最典型的是eosio.token合约。每个代币合约内部维护两类核心表accounts表按账户记录其持有的各类代币余额stat表按代币符号记录该类代币的发行总量、最大供给量与发行方。cleos get currency正是围绕这两张表提供的高层查询入口其下包含两个子命令对应原文档的 Subcommands 部分子命令功能对应文档balance检索某账户在给定代币合约下的余额currency-balance.mdstats检索给定代币的发行统计信息currency-stats.md在 cleos 源码中这两个子命令注册于 programs/cleos/main.cpp#L2935-L2973get_currency作为get的子命令并通过require_subcommand()强制要求跟随子命令因此cleos get currency单独执行会提示缺少子命令。cleos get currency # 必须继续指定 balance 或 stats cleos get currency balance # 查询账户余额 cleos get currency stats # 查询代币发行统计执行这两个查询需要 nodeos 节点启动 chain_api_plugin依赖 chain_plugincleos 通过 HTTP 调用节点的只读接口完成查询不会产生交易、不需要消耗资源也无需解锁钱包。子命令一cleos get currency balance功能与适用场景balance子命令用于检索一个账户在某个代币合约下持有的代币余额。典型场景包括验证转账是否到账查询目标账户在eosio.token合约下的余额编写钱包或区块浏览器批量展示用户持有的各种代币脚本化监控定时轮询大户地址或交易所热钱包余额。位置参数详解balance接受三个位置参数其中contract与account为必填symbol为可选源码中该选项未标记required()参见 programs/cleos/main.cpp#L2942-L2944参数类型必填说明contractTEXT是操作该货币的代币合约账户名例如eosio.tokenaccountTEXT是要查询余额的账户名例如eosiosymbolTEXT否代币符号仅当合约管理多种货币时需要指定如SYS关于symbol的说明EOSIO 代币合约通常允许同一合约发行多种符号的代币每种符号对应一个stat行而accounts表按账户存储其所有符号的余额。因此省略symbol时会返回该账户在该合约下的全部余额指定symbol则只返回匹配的那一条。源码中省略 symbol 时以空 variant 传入 RPC 请求programs/cleos/main.cpp#L2947-L2951。选项原文档声明该子命令没有选项There are no options for this subcommand。不过从当前仓库源码看balance还额外注册了一个--json短选项-j用于以 JSON 格式输出结果programs/cleos/main.cpp#L2945cleos get currency balance --json eosio.token eosio SYS默认不加--json时cleos 会逐行打印余额资产字符串加上--json后则输出原始 JSON 数组programs/cleos/main.cpp#L2952-L2959便于脚本解析。实际使用以所构建版本的 cleos 帮助输出cleos get currency balance --help为准。实战示例原文档示例查询eosio账户在eosio.token合约下SYS符号的余额cleos get currency balance eosio.token eosio SYS999999920.0000 SYS输出中的999999920.0000 SYS是一个完整的资产asset字符串0000表示精度为 4 位小数SYS为符号名。若账户在合约下持有多种代币省略 symbol 可一次查看全部cleos get currency balance eosio.token myaccount # 可能的输出每行一种资产 10.0000 SYS 5.0000 OTHER指定不存在的账户或未持有任何代币的账户时默认输出为空不加--json时不打印任何行。子命令二cleos get currency stats功能与适用场景stats子命令用于检索给定代币的发行统计信息即该代币当前供给量、最大供给量与发行方。典型场景包括核查代币总发行量与是否触及最大供给确认代币的发行方账户上币审核与风控校验代币合约参数是否合规。位置参数详解stats接受两个位置参数均为必填programs/cleos/main.cpp#L2963-L2964参数类型必填说明contractTEXT是操作该货币的代币合约账户名例如eosio.tokensymbolTEXT是代币符号例如SYS与balance不同stats的symbol是必填的因为stat表按符号组织数据查询必须明确目标符号。实战示例原文档示例查询SYS代币在eosio.token合约下的发行统计cleos get currency stats eosio.token SYS输出为 JSON 对象以符号名为键{ SYS: { supply: 1000000000.0000 SYS, max_supply: 10000000000.0000 SYS, issuer: eosio } }字段含义字段说明supply当前已发行总量asset 字符串含精度max_supply最大供给量代币发行不得超过此上限issuer发行方账户名只有该账户有权执行issue增发操作底层原理RPC 端点与链上数据表HTTP 端点映射balance与stats并非 cleos 本地逻辑而是封装了对 nodeos 只读 RPC 接口的 HTTP 调用。cleos 侧端点定义在 programs/cleos/httpc.hpp#L99-L100const string get_currency_balance_func chain_func_base /get_currency_balance; const string get_currency_stats_func chain_func_base /get_currency_stats;其中chain_func_base即/v1/chain因此两个接口对应POST /v1/chain/get_currency_balancePOST /v1/chain/get_currency_stats这两个路由在 chain_api_plugin.cpp 中注册为只读调用CHAIN_RO_CALL参数必填也就是说任何能访问 nodeos HTTP 端口的客户端都可以绕过 cleos 直接调用例如curl -X POST http://127.0.0.1:8888/v1/chain/get_currency_balance \ -d {code:eosio.token,account:eosio,symbol:SYS} curl -X POST http://127.0.0.1:8888/v1/chain/get_currency_stats \ -d {code:eosio.token,symbol:SYS}RPC 请求参数结构定义于 plugins/chain_plugin/include/eosio/chain_plugin/chain_plugin.hpp#L397-L417get_currency_balance_params含code、account、可选的symbolget_currency_stats_params含code、symbolget_currency_stats_result则对应supply、max_supply、issuer三个字段。服务端实现balance 读取 accounts 表服务端实现在 plugins/chain_plugin/chain_plugin.cpp#L2587-L2611 的read_only::get_currency_balance读取代币合约的 ABI并校验其中存在accounts表以查询账户p.account为 scope 遍历accounts表walk_key_value_table(p.code, p.account, accounts_n, ...)将表内每行的 value 反序列化为asset资产 数量 精度 符号并校验合法性若请求指定了symbol则按符号名忽略大小写匹配过滤boost::iequals返回匹配的资产列表vectorasset一个账户持有多种代币时返回多条。这正是cleos get currency balance eosio.token eosio SYS输出999999920.0000 SYS的来源——该值来自eosio账户在eosio.token合约accounts表 scope 下的数据行。服务端实现stats 读取 stat 表read_only::get_currency_stats实现在 plugins/chain_plugin/chain_plugin.cpp#L2613-L2636读取合约 ABI校验存在stat表将符号字符串大写后编码为 64 位整数并右移 8 位作为stat表的 scopestring_to_symbol(0, upper(symbol)) 8即每种符号对应stat表的一个独立 scope遍历该 scope 下的stat表数据行反序列化出supply、max_supply、issuer以符号名为键组装成 JSON 对象返回。由此可知stats返回的supply/max_supply直接来自代币合约stat表中存储的资产字段是发行操作的最终状态issuer则记录了最初创建该代币并持有增发权限的账户。开发者视角测试用例与脚本化使用仓库测试代码广泛使用了这些查询能力可作为开发者理解其行为的参考libraries/testing/include/eosio/testing/tester.hpp#L317 与 libraries/testing/tester.cpp#L969 提供了测试辅助函数base_tester::get_currency_balance供单元测试直接断言链上余额unittests/currency_tests.cpp 中大量调用get_currency_balance(eosio.token_n, symbol(...), account)来校验转账、增发、销毁等操作后的余额变化unittests/delay_tests.cpp 也通过get_currency_balance辅助函数验证延迟交易生效后的资金状态。对于脚本化运维建议在 cleos 命令后追加--json并结合jq处理例如cleos get currency balance --json eosio.token myaccount | jq -r .[] | select(. | contains(SYS))注意事项前提条件使用前需保证本地或远程 nodeos 已开启 chain_api_plugin其依赖 chain_plugin并已通过--http-server-address暴露 HTTP 端口cleos 可通过-u/--url指向目标节点。symbol 大小写不敏感服务端按忽略大小写的方式匹配符号名cleos get currency balance eosio.token eosio sys与使用SYS效果一致。balance 与 stats 的 symbol 必填性不同balance的symbol可选省略返回全部余额stats的symbol必填直接调用 RPC 时同理。输出精度输出中的小数位数由代币精度决定示例为 4 位小数0000并非固定值解析资产字符串时需按精度处理。只读查询两个子命令均为只读链上查询不发送交易、不消耗 CPU/NET/RAM 资源也不要求解锁钱包。赞分享区块链【免费下载链接】eosAn open source smart contract platform项目地址https://gitcode.com/gh_mirrors/eo/eos点击查看免费下载相关推荐EOSIO cleos get currency balance 命令详解查询账户代币余额的完整指南EOSIO cleos get currency balance 命令详解查询账户代币余额的完整指南 导读 cleos get currency balanc区块链EOSIO cleos get accounts 命令详解按公钥查询关联账户EOSIO cleos get accounts 命令详解按公钥查询关联账户 导读 cleos get accounts 是 EOSIO 命令行客户端 cle区块链Archon archon-post-review-to-pr 详解将代码审查结果自动发布为 GitHub PR 评论的确定性 Agent 命令模板Archon archon post review to pr 详解将代码审查结果自动发布为 GitHub PR 评论的确定性 Agent 命令模板 本文以区块链创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
