shared_ledger.hpp

См. документацию.

#pragma once
 
 struct [[eosio::table, eosio::contract(LEDGER)]] laccount {
  uint64_t id;                    
  std::string name;               
  eosio::asset available;         
  eosio::asset blocked;           
  eosio::asset writeoff;          
 
  uint64_t primary_key() const { return id; }
  
  bool is_empty() const {
    return available.amount == 0 && blocked.amount == 0 && writeoff.amount == 0;
  }
  
  eosio::asset get_total() const {
    return available + blocked + writeoff;
  }
  
  eosio::asset get_balance() const {
    return available + blocked;
  }
};
 
typedef eosio::multi_index<"accounts"_n, laccount> laccounts_index;
 
struct [[eosio::table, eosio::contract(LEDGER)]] writeoff_op {
  uint64_t id;                    
  eosio::name coopname;           
  eosio::name username;           
  uint64_t account_id;            
  eosio::asset quantity;          
  std::string reason;             
  document2 document;             
  checksum256 writeoff_hash;      
  eosio::name status;             
 
  uint64_t primary_key() const { return id; }
  uint64_t by_coop() const { return coopname.value; }
  checksum256 by_hash() const { return writeoff_hash; }
};
 
typedef eosio::multi_index<"writeoffs"_n, writeoff_op,
  eosio::indexed_by<"bycoop"_n, eosio::const_mem_fun<writeoff_op, uint64_t, &writeoff_op::by_coop>>,
  eosio::indexed_by<"byhash"_n, eosio::const_mem_fun<writeoff_op, checksum256, &writeoff_op::by_hash>>
> writeoffs_index;
 
 
class Ledger {
public:
  
  static const std::set<eosio::name> ledger_actions;
  
  static eosio::name get_valid_ledger_action(const eosio::name& action);
 
  static void check_ledger_symbol(const eosio::asset& amount);
 
  static void check_positive_amount(const eosio::asset& amount);
 
  // Основные операции
  static void add(eosio::name actor, eosio::name coopname, uint64_t account_id, eosio::asset quantity, std::string comment);
  static void sub(eosio::name actor, eosio::name coopname, uint64_t account_id, eosio::asset quantity, std::string comment);
  static void transfer(eosio::name actor, eosio::name coopname, uint64_t from_account_id, uint64_t to_account_id, eosio::asset quantity, std::string comment);
  
  // Операции блокировки/разблокировки
  static void block(eosio::name actor, eosio::name coopname, uint64_t account_id, eosio::asset quantity, std::string comment);
  static void unblock(eosio::name actor, eosio::name coopname, uint64_t account_id, eosio::asset quantity, std::string comment);
  
  // Атомарные операции списания
  static void writeoff(eosio::name actor, eosio::name coopname, uint64_t account_id, eosio::asset quantity, std::string comment);
  static void writeoffcnsl(eosio::name actor, eosio::name coopname, uint64_t account_id, eosio::asset quantity, std::string comment);
  
  // Специализированные методы для членских взносов
  static void add_membership_fee(eosio::name actor, eosio::name coopname, eosio::asset quantity, std::string comment);
  static void sub_membership_fee(eosio::name actor, eosio::name coopname, eosio::asset quantity, std::string comment);
  static void block_membership_fee(eosio::name actor, eosio::name coopname, eosio::asset quantity, std::string comment);
  static void unblock_membership_fee(eosio::name actor, eosio::name coopname, eosio::asset quantity, std::string comment);
 
  static std::optional<writeoff_op> get_writeoff_by_hash(const checksum256 &writeoff_hash);
  
  static std::string get_account_name_by_id(uint64_t account_id);
 
  struct accounts {
    // Денежные средства
    static constexpr uint64_t CASH = 50;                    
    static constexpr uint64_t BANK_ACCOUNT = 51;            
    
    // Расчеты с пайщиками
    static constexpr uint64_t MEMBER_SETTLEMENTS = 75;       
    static constexpr uint64_t MEMBER_DEBT = 751;            
    static constexpr uint64_t INCOME_ACCRUALS = 752;        
    
    // Паевой фонд
    static constexpr uint64_t SHARE_FUND = 80;              
    
    // Расчеты с пайщиками (дебиторами и кредиторами)
    static constexpr uint64_t MEMBER_FEES = 761;            
    static constexpr uint64_t PROPERTY_TRANSFER = 762;       
    static constexpr uint64_t OTHER_SETTLEMENTS = 763;       
    
    // Расчеты по займам
    static constexpr uint64_t LOANS_ISSUED = 583;           
    static constexpr uint64_t LOAN_INTEREST = 911;          
    
    // Финансовые вложения из средств ПО
    static constexpr uint64_t FINANCIAL_INVESTMENTS = 58;   
    static constexpr uint64_t SHARES_AND_STAKES = 581;      
    static constexpr uint64_t SECURITIES = 582;             
    
    // Расчеты с дебиторами и кредиторами
    static constexpr uint64_t DEBTORS_CREDITORS = 76;       
    
    // Запасы, затраты, расчеты, собственные средства
    static constexpr uint64_t FIXED_ASSETS = 1;             
    static constexpr uint64_t INTANGIBLE_ASSETS = 4;        
    static constexpr uint64_t MATERIALS_GOODS = 10;         
    static constexpr uint64_t MAIN_PRODUCTION = 20;         
    static constexpr uint64_t NON_PROFIT_ACTIVITY = 201;    
    static constexpr uint64_t GENERAL_EXPENSES = 26;        
    static constexpr uint64_t RESERVES = 63;                
    static constexpr uint64_t LONG_TERM_LOANS = 67;         
    static constexpr uint64_t TAXES_FEES = 68;              
    static constexpr uint64_t SOCIAL_INSURANCE = 69;        
    static constexpr uint64_t SALARY = 70;                  
    static constexpr uint64_t ACCOUNTABLE_PERSONS = 71;     
    static constexpr uint64_t ADDITIONAL_CAPITAL = 83;      
    static constexpr uint64_t FUNDS_PO_1 = 831;            
    static constexpr uint64_t CURRENT_YEAR_PROFIT = 841;    
    static constexpr uint64_t PREVIOUS_YEARS_PROFIT = 842;  
    static constexpr uint64_t FUNDS_PO_2 = 843;            
    static constexpr uint64_t UNDISTRIBUTED_PROFIT = 84;    
    static constexpr uint64_t TARGET_RECEIPTS = 86;         
    static constexpr uint64_t ENTRANCE_FEES = 861;          
    static constexpr uint64_t RESERVE_FUND = 862;           
    static constexpr uint64_t INDIVISIBLE_FUND = 863;       
    static constexpr uint64_t ECONOMIC_ACTIVITY_FUND = 864; 
    static constexpr uint64_t MUTUAL_SECURITY_FUND = 865;   
    static constexpr uint64_t DEVELOPMENT_FUND = 866;       
    static constexpr uint64_t OTHER_INCOME_EXPENSES = 91;   
    static constexpr uint64_t FUTURE_EXPENSES_RESERVE = 96; 
    static constexpr uint64_t FUTURE_INCOME = 98;           
    static constexpr uint64_t FREE_RECEIPT = 981;           
  };
};
 
static const std::vector<std::tuple<uint64_t, std::string>> ACCOUNT_MAP = {
  {Ledger::accounts::FIXED_ASSETS, "Основные средства"},
  {Ledger::accounts::INTANGIBLE_ASSETS, "Нематериальные активы"},
  {Ledger::accounts::MATERIALS_GOODS, "Материалы, товары"},
  {Ledger::accounts::MAIN_PRODUCTION, "Основное производство"},
  {Ledger::accounts::NON_PROFIT_ACTIVITY, "Некоммерческая деятельность"},
  {Ledger::accounts::GENERAL_EXPENSES, "Общехозяйственные расходы"},
  {Ledger::accounts::CASH, "Касса"},
  {Ledger::accounts::BANK_ACCOUNT, "Расчетный счет"},
  {Ledger::accounts::RESERVES, "Резервы по сомнительным долгам"},
  {Ledger::accounts::LONG_TERM_LOANS, "Расчеты по долгосрочным кредитам и займам"},
  {Ledger::accounts::TAXES_FEES, "Расчеты с бюджетом по налогам и сборам"},
  {Ledger::accounts::SOCIAL_INSURANCE, "Расчеты по социальному страхованию и обеспечению"},
  {Ledger::accounts::SALARY, "Заработная плата"},
  {Ledger::accounts::ACCOUNTABLE_PERSONS, "Расчеты с подотчетными лицами"},
  {Ledger::accounts::MEMBER_SETTLEMENTS, "Расчеты с пайщиками по внесению/возврату паевых взносов"},
  {Ledger::accounts::SHARE_FUND, "Паевой фонд (складочный капитал)"},
  {Ledger::accounts::ADDITIONAL_CAPITAL, "Добавочный капитал"},
  {Ledger::accounts::TARGET_RECEIPTS, "Целевые поступления"},
  {Ledger::accounts::OTHER_INCOME_EXPENSES, "Прочие доходы и расходы"},
  {Ledger::accounts::FUTURE_EXPENSES_RESERVE, "Резерв предстоящих расходов"},
  {Ledger::accounts::FUTURE_INCOME, "Доходы будущих периодов"},
  {Ledger::accounts::SHARES_AND_STAKES, "Доли, паи и акции в организациях"},
  {Ledger::accounts::SECURITIES, "Облигации (государственные ценные бумаги)"},
  {Ledger::accounts::LOANS_ISSUED, "Расчеты по выданным займам"},
  {Ledger::accounts::MEMBER_DEBT, "Задолженность пайщиков по внесению взносов в паевой фонд"},
  {Ledger::accounts::INCOME_ACCRUALS, "Начисление доходов участникам от предпринимательской деятельности ПО"},
  {Ledger::accounts::MEMBER_FEES, "По членским взносам"},
  {Ledger::accounts::PROPERTY_TRANSFER, "По передаче имущества для некоммерческой деятельности"},
  {Ledger::accounts::OTHER_SETTLEMENTS, "Другие расчеты"},
  {Ledger::accounts::DEBTORS_CREDITORS, "Расчеты с дебиторами и кредиторами"},
  {Ledger::accounts::ENTRANCE_FEES, "Вступительные взносы"},
  {Ledger::accounts::FUNDS_PO_1, "Фонды ПО (вариант пополнения фондов ПО)"},
  {Ledger::accounts::CURRENT_YEAR_PROFIT, "Нераспределенная прибыль (убыток) отчетного года"},
  {Ledger::accounts::PREVIOUS_YEARS_PROFIT, "Нераспределенная прибыль (непокрытый убыток) прошлых лет"},
  {Ledger::accounts::FUNDS_PO_2, "Фонды ПО (вариант пополнения фондов ПО)"},
  {Ledger::accounts::UNDISTRIBUTED_PROFIT, "Нераспределенная прибыль (непокрытый убыток)"},
  {Ledger::accounts::RESERVE_FUND, "Резервный фонд"},
  {Ledger::accounts::INDIVISIBLE_FUND, "Неделимый фонд"},
  {Ledger::accounts::ECONOMIC_ACTIVITY_FUND, "Фонд обеспечения хозяйственной деятельности"},
  {Ledger::accounts::MUTUAL_SECURITY_FUND, "Фонд взаимного обеспечения"},
  {Ledger::accounts::DEVELOPMENT_FUND, "Фонд развития потребительской кооперации"},
  {Ledger::accounts::LOAN_INTEREST, "Внесение процентов за пользование займами"},
  {Ledger::accounts::FINANCIAL_INVESTMENTS, "Финансовые вложения из средств ПО"},
  {Ledger::accounts::FREE_RECEIPT, "Безвозмездное получение имущества"}
}; 
 
// Реализация статических методов класса Ledger
 
const std::set<eosio::name> Ledger::ledger_actions = {
    "add"_n,      
    "sub"_n,      
    "block"_n,    
    "unblock"_n,  
    "writeoff"_n, 
    "writeoffcnsl"_n,  
    "create"_n,   
    "auth"_n,     
    "complete"_n, 
    "decline"_n   
};
 
inline eosio::name Ledger::get_valid_ledger_action(const eosio::name& action) {
  eosio::check(ledger_actions.contains(action), "Недопустимое имя действия ledger");
  return action;
}
 
inline void Ledger::check_ledger_symbol(const eosio::asset& amount) {
  eosio::check(amount.symbol == _root_govern_symbol, "Некорректный символ валюты для операций ledger");
}
 
inline void Ledger::check_positive_amount(const eosio::asset& amount) {
  eosio::check(amount.is_valid(), "Некорректная сумма");
  eosio::check(amount.amount > 0, "Сумма должна быть положительной");
}
 
inline std::string Ledger::get_account_name_by_id(uint64_t account_id) {
  for (const auto& account_data : ACCOUNT_MAP) {
    if (std::get<0>(account_data) == account_id) {
      return std::get<1>(account_data);
    }
  }
  return "Неизвестный счет";
}
 
inline void Ledger::add(eosio::name actor, eosio::name coopname, uint64_t account_id, eosio::asset quantity, std::string comment) {
  eosio::action(
    eosio::permission_level{actor, "active"_n},
    _ledger,
    get_valid_ledger_action("add"_n),
    std::make_tuple(coopname, account_id, quantity, comment)
  ).send();
}
 
inline void Ledger::sub(eosio::name actor, eosio::name coopname, uint64_t account_id, eosio::asset quantity, std::string comment) {
  eosio::action(
    eosio::permission_level{actor, "active"_n},
    _ledger,
    get_valid_ledger_action("sub"_n),
    std::make_tuple(coopname, account_id, quantity, comment)
  ).send();
}
 
inline void Ledger::transfer(eosio::name actor, eosio::name coopname, uint64_t from_account_id, uint64_t to_account_id, eosio::asset quantity, std::string comment) {
  add(actor, coopname, from_account_id, quantity, comment);
  sub(actor, coopname, to_account_id, quantity, comment);
}
 
inline void Ledger::block(eosio::name actor, eosio::name coopname, uint64_t account_id, eosio::asset quantity, std::string comment) {
  eosio::action(
    eosio::permission_level{actor, "active"_n},
    _ledger,
    get_valid_ledger_action("block"_n),
    std::make_tuple(coopname, account_id, quantity, comment)
  ).send();
}
 
inline void Ledger::unblock(eosio::name actor, eosio::name coopname, uint64_t account_id, eosio::asset quantity, std::string comment) {
  eosio::action(
    eosio::permission_level{actor, "active"_n},
    _ledger,
    get_valid_ledger_action("unblock"_n),
    std::make_tuple(coopname, account_id, quantity, comment)
  ).send();
}
 
inline void Ledger::writeoff(eosio::name actor, eosio::name coopname, uint64_t account_id, eosio::asset quantity, std::string comment) {
  eosio::action(
    eosio::permission_level{actor, "active"_n},
    _ledger,
    get_valid_ledger_action("writeoff"_n),
    std::make_tuple(coopname, account_id, quantity, comment)
  ).send();
}
 
inline void Ledger::writeoffcnsl(eosio::name actor, eosio::name coopname, uint64_t account_id, eosio::asset quantity, std::string comment) {
  eosio::action(
    eosio::permission_level{actor, "active"_n},
    _ledger,
    get_valid_ledger_action("writeoffcnsl"_n),
    std::make_tuple(coopname, account_id, quantity, comment)
  ).send();
}
 
inline void Ledger::add_membership_fee(eosio::name actor, eosio::name coopname, eosio::asset quantity, std::string comment) {
  add(actor, coopname, accounts::TARGET_RECEIPTS, quantity, comment);
}
 
inline void Ledger::sub_membership_fee(eosio::name actor, eosio::name coopname, eosio::asset quantity, std::string comment) {
  sub(actor, coopname, accounts::TARGET_RECEIPTS, quantity, comment);
}
 
inline void Ledger::block_membership_fee(eosio::name actor, eosio::name coopname, eosio::asset quantity, std::string comment) {
  block(actor, coopname, accounts::TARGET_RECEIPTS, quantity, comment);
}
 
inline void Ledger::unblock_membership_fee(eosio::name actor, eosio::name coopname, eosio::asset quantity, std::string comment) {
  unblock(actor, coopname, accounts::TARGET_RECEIPTS, quantity, comment);
}
 
inline std::optional<writeoff_op> Ledger::get_writeoff_by_hash(const checksum256 &writeoff_hash) {
    writeoffs_index writeoffs(_ledger, _ledger.value);
    auto hash_idx = writeoffs.get_index<"byhash"_n>();
    
    auto op_iter = hash_idx.find(writeoff_hash);
    if (op_iter == hash_idx.end()) {
        return std::nullopt;
    }
    
    return *op_iter;
}