一、目的
本文档围绕 EOS 系统合约的九种基本链账户在源码中的使用情况进行介绍，适用于想要了解系统合约链账户的初学者和开发者，帮助其快速了解和上手 EOS 系统合约链账户创建与使用。
二、链账户介绍
EOS 账户是存储在区块链中的可读标识符。由权限配置决定，该账户是个人授权还是多人授权拥有。EOS 账户有 12 个字符的限制（允许字符 a～z、1～5），该字符由 64 位整数的 base-32 编码衍生而来。
EOS 短账户是通过账户之间竞拍购买得到的账户，如：com、a 等，短账户非常稀少。由竞拍获得的短账户创建的二级账户也是短账户，类似于网站域名，比如：com 账户可以创建 a.com、1.com 等子账户。短账户可以参与账户竞拍获得，但是拍卖成交价一般在数千到数万 EOS 不等。也可以向短账户拥有者购买二级账户，如：向 e 账户购买 e.e 账户。
三、系统链账户介绍
1、系统账户介绍
在基于 EOSIO 的区块链的起源当中，只有一个账户存在，也就是 eosio 账户。它是主要的系统账户，还有一些其他的系统账户，都由它创建。以下是几个重要的系统账户：
2、链账户在源码中的使用
（1）eosio.msig
在 EOS 中，eosio.msig 是一个特殊的链账户，用于管理多签名 (multisig)操作，部署提案合约。
多签名（Multisig）：多签名是一种安全机制，其中需要多个账户的授权才能执行某些敏感操作或交易。对于 eosio.msig 账户来说，多个账户可以被配置为需要授权才能执行事务。
eosio.msig 账户功能：eosio.msig 账户是 EOS.0 软件平台中的一个特殊账户，负责管理和执行多签名操作。
多签名交易执行过程：
创建提案：使用 eosio.msig 账户创建一个提案（proposal），其中包括待执行的交易和所需的签名授权列表。
授权签名：参与多签名的账户根据规定的授权列表对提案进行签名。一旦所有所的签名被授权，提案就可以准备执行。
执行提案：eosio.msig 账户可以执行已收集足够授权签名的提案，从而触发交易的执行。
（2）eosio.names
eosio.names：持有命名空间拍卖资金的帐户。投标名称操作，允许帐户 bidder 为名称 newname 出价。参数如下：
bidder：获得退款的帐户；
newname：投标的名称；
bid：为投标支付的系统代币数量；
账户在源码 eosio.system.hpp 中的别名定义：
` static constexpr eosio::name names_account{"eosio.names"_n};`
复制代码
在源码 eosio.system/src/namebidding.cpp 中的使用：
void system_contract::bidname( const name& bidder, const name& newname, const asset& bid ) { ......//other code require_auth( bidder );check( (bool)newname check( newname.suffix() == newname, "you can only bid on top-level suffix" );
check( (bool)newname, "the empty name is not a valid account name to bid on" ); check( (newname.value & 0xFull) == 0, "13 character names are not valid account names to bid on" ); check( (newname.value & 0x1F0ull) == 0, "accounts with 12 character names and no dots can be created without bidding required" ); check( !is_account( newname ), "account already exists" ); check( bid.symbol == core_symbol(), "asset must be system token" ); check( bid.amount > 0, "insufficient bid" ); //代币从bidder转移到names_account token::transfer_action transfer_act{ token_account, { {bidder, active_permission} } }; transfer_act.send( bidder, names_account, bid, std::string("bid name ")+ newname.to_string() );}
复制代码
出价退款操作，允许帐户 bidder 取回到目前为止对 newname 名称出价的金额。参数如下：
bidder：获得退款的帐户；
newname：投标的名称；现在可以退款；
在源码 eosio.system/src/namebidding.cpp 中的使用：
void system_contract::bidrefund( const name& bidder, const name& newname ) { bid_refund_table refunds_table(get_self(), newname.value); auto it = refunds_table.find( bidder.value ); check( it != refunds_table.end(), "refund not found" );
//代币从names_account转移到bidder token::transfer_action transfer_act{ token_account, { {names_account, active_permission}, {bidder, active_permission} } }; transfer_act.send( names_account, bidder, asset(it->amount), std::string("refund bid on name")+(name{newname}).to_string() ); refunds_table.erase( it ); }
复制代码
（3）eosio.saving、eosio.bpay 和 eosio.vpay 使用
eosio.saving：持有 4%网络通胀的账户。
eosio.bpay：支付块生产者生产块的账户，根据区块生产者过去 24 小时内创建的区块数量分配 0.25%的通胀。
eosio.vpay：用赢得的选票向区块生产者支付相应费用的账户。根据区块生产者在过去 24 小时内赢得的票数分配 0.75%的通货膨胀率。
账户在源码 eosio.system.hpp 中的别名定义：
static constexpr eosio::name saving_account{"eosio.saving"_n};static constexpr eosio::name bpay_account{"eosio.bpay"_n};static constexpr eosio::name vpay_account{"eosio.vpay"_n};
复制代码
在源码 eosio.system/src/producer_pay.cpp 中的使用：
if( new_tokens > 0 ) { { token::issue_action issue_act{ token_account, { {get_self(), active_permission} } }; issue_act.send( get_self(), asset(new_tokens, core_symbol()), "issue tokens for producer pay and savings" ); } { token::transfer_action transfer_act{ token_account, { {get_self(), active_permission} } }; if( to_savings > 0 ) { transfer_act.send( get_self(), saving_account, asset(to_savings, core_symbol()), "unallocated inflation" ); } if( to_per_block_pay > 0 ) { transfer_act.send( get_self(), bpay_account, asset(to_per_block_pay, core_symbol()), "fund per-block bucket" ); } if( to_per_vote_pay > 0 ) { transfer_act.send( get_self(), vpay_account, asset(to_per_vote_pay, core_symbol()), "fund per-vote bucket" ); } } }
复制代码
（4）eosio.ram 和 eosio.ramfee 使用
eosio.ram：根据用户购买或出售 ram 的行为跟踪 SYS 余额的账户。
eosio.ramfee：跟踪从用户 ram 交易行为收取的费用的账户，每笔交易价值的 0.5%进入该账户。
账户在源码 eosio.system.hpp 中的别名定义：
static constexpr eosio::name ram_account{"eosio.ram"_n};static constexpr eosio::name ramfee_account{"eosio.ramfee"_n};
复制代码
当购买 ram 时，付款人不可逆地将数量转移到系统合约，只有接收者可以通过 sellram 操作收回代币。接收方支付与此操作相关联的所有数据库记录的存储费用。RAM 是一种稀缺资源，其供应量由全局属性 max_RAM_size 定义。RAM 使用 bancor 算法定价，使得每个字节的价格具有 100:1 的恒定储备比。
在源码 eosio.system/src/delegate_bandwidth.cpp 中的使用：
// 如果quant.amount>1，则quant_after_fee.amount应>0。如果quant.amaunt==1，则quant_after_fee.amount==0，并且下一次内联传输将失败，导致buyram操作失败。 { token::transfer_action transfer_act{ token_account, { {payer, active_permission}, {ram_account, active_permission} } }; transfer_act.send( payer, ram_account, quant_after_fee, "buy ram" ); } if ( fee.amount > 0 ) { token::transfer_action transfer_act{ token_account, { {payer, active_permission} } }; transfer_act.send( payer, ramfee_account, fee, "ram fee" ); channel_to_rex( ramfee_account, fee ); }
复制代码
（5）eosio.stake 使用
eosio.stake：跟踪所有为 NET 或 CPU 宽带质押的 SYS 代币的账户。
账户在源码 eosio.system.hpp 中的别名定义：
static constexpr eosio::name stake_account{"eosio.stake"_n};
复制代码
在源码 eosio.system/src/delegate_bandwidth.cpp 中的使用：
auto transfer_amount = net_balance + cpu_balance;//NET或CPU if ( 0 < transfer_amount.amount ) { token::transfer_action transfer_act{ token_account, { {source_stake_from, active_permission} } }; transfer_act.send( source_stake_from, stake_account, asset(transfer_amount), "stake bandwidth" ); }
复制代码
（6）eosio.rex 使用
eosio.rex：跟踪费用和余额的账户是由 REX 相关操作执行产生的。
账户在源码 eosio.system.hpp 中的别名定义：
static constexpr eosio::name rex_account{"eosio.rex"_n};
复制代码
在源码 eosio.system\src\rex.cpp 中的使用：
const asset payment = from_net + from_cpu; // inline transfer from stake_account to rex_account 从stake_account到rex_account的内联转账 { token::transfer_action transfer_act{ token_account, { stake_account, active_permission } }; transfer_act.send( stake_account, rex_account, payment, "buy REX with staked tokens" ); //使用赌注代币购买REX } const asset rex_received = add_to_rex_pool( payment ); add_to_rex_balance( owner, payment, rex_received ); runrex(2); update_rex_account( owner, asset( 0, core_symbol() ), asset( 0, core_symbol() ), true ); // dummy action added so that amount of REX tokens purchased shows up in action trace 添加了虚拟操作，以便购买的REX代币数量显示在操作跟踪中 rex_results::buyresult_action buyrex_act( rex_account, std::vector<eosio::permission_level>{ } ); buyrex_act.send( rex_received );
复制代码
评论