global_state.hpp

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

#pragma once
 
 
#include "../../../lib/core/ram_payer.hpp"
#include <eosio/binary_extension.hpp>
 
using namespace eosio;
using std::string;
 
namespace Capital {
 
  // Значения по умолчанию держатся В СООТВЕТСТВИИ с defaultConfig бэкенда
  // (controller/src/extensions/capital/capital-extension.module.ts): именно он
  // задаёт конфигурацию кооперативу при онбординге, а эти значения работают
  // ровно до неё. Пока они расходились, кооператив без явной настройки жил по
  // другим правилам, чем показывал интерфейс.
  struct config {
    double coordinator_bonus_percent = 5;   
    double expense_pool_percent = 100;         
    uint32_t coordinator_invite_validity_days = 30; 
    uint32_t voting_period_in_days = 1;        
    double authors_voting_percent = 62.8;      
    double creators_voting_percent = 62.8;     
 
    // Параметры геймификации
    double energy_decay_rate_per_day = 0.02;  
    uint64_t level_depth_base = 100000000;     
    double level_growth_coefficient = 1.5;     
    double energy_gain_coefficient = 1.0;      
  };
 
  struct [[eosio::table, eosio::contract(CAPITAL)]] global_state {
    eosio::name coopname;                                
    asset global_available_invest_pool = asset(0, _root_govern_symbol); 
    asset program_membership_funded = asset(0, _root_govern_symbol); 
    asset program_membership_available = asset(0, _root_govern_symbol); 
    asset program_membership_distributed = asset(0, _root_govern_symbol); 
    double program_membership_cumulative_reward_per_share;               
 
    config config;                                           
 
    // ВНИМАНИЕ: поля программных расходов добавлены ПОСЛЕ config и обёрнуты в
    // binary_extension. Поля в таблицу EOSIO можно дописывать только в ХВОСТ
    // struct и только через binary_extension — иначе ломается десериализация
    // уже записанного global_state. Инцидент 2026-06-16: эти поля были вставлены
    // перед config напрямую (без extension) и задеплоены на прод — таблица state
    // перестала читаться (get table → "Invalid symbol", action'ы падали на unpack).
    // Инвариант: оба поля материализуются вместе (всегда оба has_value или оба
    // пустые), чтобы порядок хвостовых extension оставался консистентным.
    eosio::binary_extension<asset> program_expense_pool;     
    eosio::binary_extension<asset> program_expense_reserved; 
 
    uint64_t primary_key() const { return coopname.value; }     
  };
 
  typedef eosio::multi_index<"state"_n, global_state> global_state_table; 
 
  
  
 
namespace State {
 
inline asset ext_or_zero(const eosio::binary_extension<asset>& v, const eosio::symbol& sym) {
  if (!v.has_value()) {
    return asset(0, sym);
  }
  const asset &a = v.value();
  if (a.symbol == sym) {
    return a;
  }
  eosio::check(a.amount == 0,
               "program_expense_* содержит ненулевую сумму с несовместимым символом");
  return asset(0, sym);
}
 
inline void update_global_state(const global_state& gs){
  global_state_table global_state_inst(_capital, _capital.value);
  auto itr = global_state_inst.find(gs.coopname.value);
  check(itr != global_state_inst.end(), "Глобальное состояние не найдено");
  const asset pool     = ext_or_zero(gs.program_expense_pool, _root_govern_symbol);
  const asset reserved = ext_or_zero(gs.program_expense_reserved, _root_govern_symbol);
  global_state_inst.modify(itr, RamPayer::of(global_state_inst), [&](auto& s) {
      s = gs;
      s.program_expense_pool     = pool;
      s.program_expense_reserved = reserved;
  });
}
    
inline global_state get_global_state(name coopname) {
    global_state_table global_state_inst(_capital, _capital.value);
    auto itr = global_state_inst.find(coopname.value);
    eosio::check(itr != global_state_inst.end(), "Контракт не инициализирован");
    return global_state(*itr);
}
 
inline void is_initialized(name coopname) {
  global_state_table global_state_inst(_capital, _capital.value);
  auto itr = global_state_inst.find(coopname.value);
  eosio::check(itr != global_state_inst.end(), "Контракт не инициализирован");
}
 
inline void topup_program_expense_pool(eosio::name coopname, const asset &amount) {
  global_state_table global_state_inst(_capital, _capital.value);
  auto itr = global_state_inst.find(coopname.value);
  eosio::check(itr != global_state_inst.end(), "Контракт не инициализирован");
  eosio::check(amount.is_valid() && amount.amount > 0, "Сумма пополнения должна быть положительной");
  eosio::check(amount.symbol == _root_govern_symbol, "Символ суммы пополнения должен совпадать с символом программы");
  eosio::check(itr->global_available_invest_pool >= amount,
               "Недостаточно свободных инвестиций программы для пополнения пула расходов");
 
  global_state_inst.modify(itr, RamPayer::of(global_state_inst), [&](auto &s) {
    asset pool     = ext_or_zero(s.program_expense_pool, amount.symbol);
    asset reserved = ext_or_zero(s.program_expense_reserved, amount.symbol);
    s.global_available_invest_pool -= amount;
    pool += amount;
    s.program_expense_pool     = pool;
    s.program_expense_reserved = reserved;
  });
}
 
inline void reserve_program_expense(eosio::name coopname, const asset &amount) {
  global_state_table global_state_inst(_capital, _capital.value);
  auto itr = global_state_inst.find(coopname.value);
  eosio::check(itr != global_state_inst.end(), "Контракт не инициализирован");
  eosio::check(amount.is_valid() && amount.amount > 0, "Сумма резерва должна быть положительной");
  eosio::check(ext_or_zero(itr->program_expense_pool, amount.symbol) >= amount,
               "Недостаточно средств в пуле программных расходов");
 
  global_state_inst.modify(itr, RamPayer::of(global_state_inst), [&](auto &s) {
    asset pool     = ext_or_zero(s.program_expense_pool, amount.symbol);
    asset reserved = ext_or_zero(s.program_expense_reserved, amount.symbol);
    pool     -= amount;
    reserved += amount;
    s.program_expense_pool     = pool;
    s.program_expense_reserved = reserved;
  });
}
 
inline void release_program_expense(eosio::name coopname, const asset &amount) {
  global_state_table global_state_inst(_capital, _capital.value);
  auto itr = global_state_inst.find(coopname.value);
  eosio::check(itr != global_state_inst.end(), "Контракт не инициализирован");
  eosio::check(amount.is_valid() && amount.amount > 0, "Сумма освобождения должна быть положительной");
  eosio::check(ext_or_zero(itr->program_expense_reserved, amount.symbol) >= amount,
               "Зарезервированных программных расходов меньше указанной суммы");
 
  global_state_inst.modify(itr, RamPayer::of(global_state_inst), [&](auto &s) {
    asset pool     = ext_or_zero(s.program_expense_pool, amount.symbol);
    asset reserved = ext_or_zero(s.program_expense_reserved, amount.symbol);
    reserved -= amount;
    pool     += amount;
    s.program_expense_pool     = pool;
    s.program_expense_reserved = reserved;
  });
}
 
inline void consume_program_expense(eosio::name coopname, const asset &amount) {
  global_state_table global_state_inst(_capital, _capital.value);
  auto itr = global_state_inst.find(coopname.value);
  eosio::check(itr != global_state_inst.end(), "Контракт не инициализирован");
  eosio::check(amount.is_valid() && amount.amount > 0, "Сумма списания должна быть положительной");
  eosio::check(ext_or_zero(itr->program_expense_reserved, amount.symbol) >= amount,
               "Зарезервированных программных расходов меньше указанной суммы");
 
  global_state_inst.modify(itr, RamPayer::of(global_state_inst), [&](auto &s) {
    asset pool     = ext_or_zero(s.program_expense_pool, amount.symbol);
    asset reserved = ext_or_zero(s.program_expense_reserved, amount.symbol);
    reserved -= amount;
    s.program_expense_pool     = pool;
    s.program_expense_reserved = reserved;
  });
}
 
inline void spend_program_expense_pool(eosio::name coopname, const asset &amount) {
  global_state_table global_state_inst(_capital, _capital.value);
  auto itr = global_state_inst.find(coopname.value);
  eosio::check(itr != global_state_inst.end(), "Контракт не инициализирован");
  eosio::check(amount.is_valid() && amount.amount > 0, "Сумма списания должна быть положительной");
  eosio::check(ext_or_zero(itr->program_expense_pool, amount.symbol) >= amount,
               "Недостаточно средств в пуле программных расходов для покрытия перерасхода — пополните пул (topupprogexp)");
 
  global_state_inst.modify(itr, RamPayer::of(global_state_inst), [&](auto &s) {
    asset pool     = ext_or_zero(s.program_expense_pool, amount.symbol);
    asset reserved = ext_or_zero(s.program_expense_reserved, amount.symbol);
    pool -= amount;
    s.program_expense_pool     = pool;
    s.program_expense_reserved = reserved;
  });
}
}// namespace State
 
}// namespace Capital
 
// Плательщик за оперативную память строк таблицы — правило в lib/core/ram_payer.hpp.
RAM_PAYER_CLASS(Capital::global_state, contract);