wallets.hpp

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

#pragma once
 
#include <array>
#include <cstdint>
#include <string_view>
 
#include <eosio/eosio.hpp>
 
struct ledger2_wallets {
  // wallet — паевой фонд + возвраты + ЦК
  static constexpr eosio::name SHARE_FUND_PAY       = "w.wal.share"_n;   
  static constexpr eosio::name CK_MEMBER            = "w.wal.member"_n;  
  static constexpr eosio::name WITHDRAWALS_SINK     = "w.wal.wthdrw"_n;  
  static constexpr eosio::name WITHDRAW_PENDING     = "w.wal.wpend"_n;   
 
  // registrator — минимальный паевой + вступительные + суспенс
  static constexpr eosio::name MIN_SHARE_FUND       = "w.reg.minshr"_n;  
  static constexpr eosio::name ENTRANCE_FEES        = "w.reg.entry"_n;   
  static constexpr eosio::name REGISTRATION_PENDING = "w.reg.pend"_n;    
 
  // soviet — членские (инфраструктура) + делегатские + хоз.расходы + использованные паевые
  static constexpr eosio::name INFRA_FEES           = "w.sov.infra"_n;   
  static constexpr eosio::name DELEGATE_FEES        = "w.sov.delgte"_n;  
  static constexpr eosio::name SOV_EXPENSES         = "w.sov.expns"_n;   
  static constexpr eosio::name MIN_SHARE_USED       = "w.sov.mnused"_n;  
  static constexpr eosio::name NDFL_WITHHELD        = "w.sov.ndfl"_n;   
 
  // capital — единые программные кошельки + займы + пред-импорт
  static constexpr eosio::name LOAN_ISSUED          = "w.cap.loan"_n;    
  static constexpr eosio::name BLAGOROST_FUND       = "w.cap.blago"_n;   
  static constexpr eosio::name GENERATOR_FUND       = "w.cap.gen"_n;     
  static constexpr eosio::name PREIMP_FUND          = "w.cap.preimp"_n;  
  static constexpr eosio::name PROGRAM_EXPENSE_POOL = "w.cap.pgexp"_n;   
 
  // marketplace — резерв под Order + членский «Стола заказов» + выплаты
  static constexpr eosio::name MARKETPLACE_ORDER_LOCK = "w.mkt.order"_n;   
  static constexpr eosio::name MARKETPLACE_MEMBER_FUND = "w.mkt.member"_n; 
  static constexpr eosio::name SUPPLIER_PAYMENTS      = "w.mkt.payout"_n;  
  static constexpr eosio::name MARKETPLACE_FEE_POOL   = "w.mkt.fee"_n;     
 
  // branch — экономика кооперативного участка (requirement b6 «Экономика КУ», раунд 5: приоритет общего кошелька)
  static constexpr eosio::name BRANCH_PERSONAL        = "w.brn.person"_n;  
  static constexpr eosio::name BRANCH_COMMON          = "w.brn.common"_n;  
  static constexpr eosio::name BRANCH_DISTRIBUTION_POOL = "w.brn.pool"_n;  
  static constexpr eosio::name BRANCH_EXPENSE_POOL    = "w.brn.expns"_n;  
 
 
  // expense — шасси расходов (подотчёт пайщика, USER_SHARED)
  // Зеркало паттерна w.wal.wpend: кошелёк-резерв на пайщике-получателе ADVANCE-механики.
  // На момент выдачи аванса фиксирует ответственность пайщика; на отчёте — BURN без новой бухпроводки
  // (canal Дт 08 / Кт 51 уже сделан на o.exp.blgadv).
  static constexpr eosio::name ADVANCE_HOLD         = "w.exp.adv"_n;     
};
 
enum class WalletKind : uint8_t {
  USER_SHARED  = 0,
  COOPERATIVE  = 1,
};
 
struct Ledger2WalletMeta {
  eosio::name      name;
  std::string_view human_name;
  WalletKind       kind;
};
 
inline constexpr std::array<Ledger2WalletMeta, 26> LEDGER2_WALLET_REGISTRY = {{
  // USER_SHARED (11) — L3-разрез по пайщику (у w.brn.common — по braname КУ)
  { ledger2_wallets::MIN_SHARE_FUND,        "Минимальный паевой взнос",                                 WalletKind::USER_SHARED },
  { ledger2_wallets::SHARE_FUND_PAY,        "Паевой взнос пайщика",                                     WalletKind::USER_SHARED },
  { ledger2_wallets::CK_MEMBER,             "ЦК — членская часть пайщика",                              WalletKind::USER_SHARED },
  { ledger2_wallets::BLAGOROST_FUND,        "ЦПП «Благорост» — единый кошелёк программы у пайщика",     WalletKind::USER_SHARED },
  { ledger2_wallets::PREIMP_FUND,           "Первичный учёт РИД-взносов до перехода на электронный учёт", WalletKind::USER_SHARED },
  { ledger2_wallets::MARKETPLACE_ORDER_LOCK,"ЦПП «Стол Заказов» — резерв под заказ у пайщика",         WalletKind::USER_SHARED },
  { ledger2_wallets::MARKETPLACE_MEMBER_FUND,"ЦПП «Стол Заказов» — членский кошелёк пайщика программы",  WalletKind::USER_SHARED },
  { ledger2_wallets::BRANCH_PERSONAL,       "Персональный кошелёк доверенного кооперативного участка",   WalletKind::USER_SHARED },
  { ledger2_wallets::BRANCH_COMMON,         "Общий кошелёк членских взносов кооперативного участка",     WalletKind::USER_SHARED },
  { ledger2_wallets::ADVANCE_HOLD,          "Подотчётные средства пайщика",                             WalletKind::USER_SHARED },
  { ledger2_wallets::REGISTRATION_PENDING,  "Регистрационный взнос в ожидании решения совета",          WalletKind::USER_SHARED },
 
  // COOPERATIVE (14) — единый кооперативный баланс, без L3
  // GENERATOR_FUND переведён сюда из USER_SHARED (см. wallets.hpp:64) —
  // CRPS-распределение между сегментами проекта не поддерживает per-user
  // компенсирующие TRANSFER на approvecmmt, поэтому L3-проверка walletop
  // ломала convertsegm у пайщиков, чья доля выросла через CRPS.
  { ledger2_wallets::GENERATOR_FUND,    "ЦПП «Генератор» — единый кошелёк программы",               WalletKind::COOPERATIVE },
  { ledger2_wallets::ENTRANCE_FEES,     "Вступительные взносы",                                     WalletKind::COOPERATIVE },
  { ledger2_wallets::WITHDRAWALS_SINK,  "Возвраты паевых взносов пайщикам (deprecated, не используется в новых операциях)", WalletKind::COOPERATIVE },
  { ledger2_wallets::WITHDRAW_PENDING,  "Резерв паевого под заявку на возврат",                     WalletKind::COOPERATIVE },
  { ledger2_wallets::INFRA_FEES,        "Членские взносы за инфраструктуру кооп. платформы",        WalletKind::COOPERATIVE },
  { ledger2_wallets::DELEGATE_FEES,     "Делегатские членские взносы",                              WalletKind::COOPERATIVE },
  { ledger2_wallets::SOV_EXPENSES,      "Хозяйственные расходы из числа целевого финансирования",   WalletKind::COOPERATIVE },
  { ledger2_wallets::MIN_SHARE_USED,    "Использованные минимальные паевые взносы",                 WalletKind::COOPERATIVE },
  { ledger2_wallets::LOAN_ISSUED,       "Выданные пайщикам беспроцентные займы",                    WalletKind::COOPERATIVE },
  { ledger2_wallets::SUPPLIER_PAYMENTS, "Выплаты поставщикам",                                      WalletKind::COOPERATIVE },
  { ledger2_wallets::MARKETPLACE_FEE_POOL, "Резерв членских взносов «Стола заказов» под заказы",    WalletKind::COOPERATIVE },
  { ledger2_wallets::BRANCH_DISTRIBUTION_POOL, "Транзитный пул ручного распределения кооперативного участка", WalletKind::COOPERATIVE },
  { ledger2_wallets::BRANCH_EXPENSE_POOL,   "Пул расходов кооперативного участка",                       WalletKind::COOPERATIVE },
  { ledger2_wallets::PROGRAM_EXPENSE_POOL, "Пул программных расходов ЦПП «Благорост»",              WalletKind::COOPERATIVE },
  { ledger2_wallets::NDFL_WITHHELD,      "Удержанный НДФЛ к перечислению",                          WalletKind::COOPERATIVE },
}};
 
static constexpr size_t LEDGER2_WALLET_REGISTRY_SIZE = LEDGER2_WALLET_REGISTRY.size();
 
// =====================================================================
// Compile-time валидация реестра.
// =====================================================================
//
// Правила (ADR-002):
//  1. Имена уникальны.
//  2. Имена непустые (sentinel `eosio::name{}` запрещён).
//  3. USER_SHARED-имена соответствуют конвенции `w.<3-char-contract>.<verb>`
//     (символ 0 = 'w', символы 1 и 5 = '.').
//
// Полнота поля `kind` обеспечена структурно: в `Ledger2WalletMeta` поле без
// значения по умолчанию — попытка добавить элемент реестра без явного
// `WalletKind` ломает сборку.
namespace ledger2_wallets_detail {
  // base32 кодирование eosio::name (`.12345abcdefghijklmnopqrstuvwxyz`):
  //   '.' = 0
  //   '1'..'5' = 1..5
  //   'a'..'z' = 6..31
  // 64-битное value делится на 12 5-битных позиций (старшие биты — первый символ);
  // 13-й символ (4 младших бита) для финального реестра не используется (имена ≤ 13 символов).
  static constexpr uint8_t CHAR_DOT = 0;   // '.'
  static constexpr uint8_t CHAR_W   = 28;  // 'w' = 6 + ('w' - 'a') = 6 + 22
 
  constexpr uint8_t decode_char_at(uint64_t value, size_t pos /* 0..11 */) {
    // pos = 0 — старшие 5 бит (биты 59..63)
    return static_cast<uint8_t>((value >> (59 - 5 * pos)) & 0x1F);
  }
 
  constexpr bool wallet_names_unique() {
    for (size_t i = 0; i < LEDGER2_WALLET_REGISTRY_SIZE; ++i) {
      for (size_t j = i + 1; j < LEDGER2_WALLET_REGISTRY_SIZE; ++j) {
        if (LEDGER2_WALLET_REGISTRY[i].name == LEDGER2_WALLET_REGISTRY[j].name) return false;
      }
    }
    return true;
  }
 
  constexpr bool wallet_names_nonempty() {
    for (size_t i = 0; i < LEDGER2_WALLET_REGISTRY_SIZE; ++i) {
      if (LEDGER2_WALLET_REGISTRY[i].name.value == 0) return false;
    }
    return true;
  }
 
  // ADR-002: USER_SHARED-имена обязаны соответствовать конвенции `w.<contract>.<verb>`.
  // Конкретно: символ 0 = 'w', символ 1 = '.', символ 5 = '.' (после 3-символьного contract).
  constexpr bool user_shared_naming_convention() {
    for (size_t i = 0; i < LEDGER2_WALLET_REGISTRY_SIZE; ++i) {
      const auto& e = LEDGER2_WALLET_REGISTRY[i];
      if (e.kind != WalletKind::USER_SHARED) continue;
      const uint64_t v = e.name.value;
      if (decode_char_at(v, 0) != CHAR_W)   return false;  // 'w'
      if (decode_char_at(v, 1) != CHAR_DOT) return false;  // '.'
      if (decode_char_at(v, 5) != CHAR_DOT) return false;  // '.' после 3-char contract
    }
    return true;
  }
}
 
static_assert(ledger2_wallets_detail::wallet_names_unique(),
              "LEDGER2_WALLET_REGISTRY: duplicate wallet name detected");
static_assert(ledger2_wallets_detail::wallet_names_nonempty(),
              "LEDGER2_WALLET_REGISTRY: empty eosio::name (sentinel) не должно быть в реестре");
static_assert(ledger2_wallets_detail::user_shared_naming_convention(),
              "LEDGER2_WALLET_REGISTRY: USER_SHARED-имя не соответствует конвенции `w.<3-char-contract>.<verb>`");
 
inline constexpr std::string_view ledger2_get_wallet_human_name(eosio::name wallet_name) {
  for (size_t i = 0; i < LEDGER2_WALLET_REGISTRY_SIZE; ++i) {
    if (LEDGER2_WALLET_REGISTRY[i].name == wallet_name) return LEDGER2_WALLET_REGISTRY[i].human_name;
  }
  return std::string_view{};
}
 
inline constexpr bool ledger2_is_known_wallet(eosio::name wallet_name) {
  for (size_t i = 0; i < LEDGER2_WALLET_REGISTRY_SIZE; ++i) {
    if (LEDGER2_WALLET_REGISTRY[i].name == wallet_name) return true;
  }
  return false;
}
 
struct Ledger2WalletProgramMapping {
  eosio::name wallet_name;
  uint64_t    required_program_id; // 0 = исключение (без проверки)
};
 
inline constexpr std::array<Ledger2WalletProgramMapping, 12> LEDGER2_USER_SHARED_PROGRAM_MAPPING = {{
  { ledger2_wallets::MIN_SHARE_FUND,         0 /* w.reg.minshr — без проверки */    },
  { ledger2_wallets::SHARE_FUND_PAY,         1 /* ЦК */                              },
  { ledger2_wallets::CK_MEMBER,              1 /* ЦК */                              },
  { ledger2_wallets::BLAGOROST_FUND,         4 /* Благорост */                       },
  { ledger2_wallets::GENERATOR_FUND,         3 /* Генератор */                       },
  { ledger2_wallets::PREIMP_FUND,            0 /* w.cap.preimp — РИД-учёт до перехода на электронный учёт, без проверки */ },
  { ledger2_wallets::MARKETPLACE_ORDER_LOCK, 2 /* Marketplace */                    },
  { ledger2_wallets::MARKETPLACE_MEMBER_FUND,2 /* Marketplace */                    },
  { ledger2_wallets::BRANCH_PERSONAL,        0 /* w.brn.person — распределение назначает председатель КУ, программное соглашение не требуется */ },
  { ledger2_wallets::BRANCH_COMMON,          0 /* w.brn.common — L3-разрез по braname КУ (не по пайщику), без проверки */ },
  { ledger2_wallets::ADVANCE_HOLD,           0 /* w.exp.adv — подотчёт пайщика по СЗ; программа-источник проверена контрактом expense, повторная gate не нужна */ },
  { ledger2_wallets::REGISTRATION_PENDING,   0 /* w.reg.pend — кандидат ещё не член, соглашения нет, без проверки */ },
}};
 
inline constexpr std::array<eosio::name, 3> LEDGER2_EXIT_REFUND_WALLETS = {{
  ledger2_wallets::MIN_SHARE_FUND,
  ledger2_wallets::SHARE_FUND_PAY,
  ledger2_wallets::BLAGOROST_FUND,
}};
 
inline uint64_t ledger2_required_program_id(eosio::name wallet_name) {
  for (const auto& m : LEDGER2_USER_SHARED_PROGRAM_MAPPING) {
    if (m.wallet_name == wallet_name) return m.required_program_id;
  }
  // Кошелёк не в маппинге.
  for (size_t i = 0; i < LEDGER2_WALLET_REGISTRY_SIZE; ++i) {
    if (LEDGER2_WALLET_REGISTRY[i].name == wallet_name &&
        LEDGER2_WALLET_REGISTRY[i].kind == WalletKind::USER_SHARED) {
      eosio::check(false,
                   std::string{"ledger2_required_program_id: USER_SHARED-кошелёк "} +
                     wallet_name.to_string() +
                     " не имеет записи в LEDGER2_USER_SHARED_PROGRAM_MAPPING");
    }
  }
  return 0; // не USER_SHARED → без проверки
}
 
inline WalletKind ledger2_get_wallet_kind(eosio::name wallet_name) {
  for (size_t i = 0; i < LEDGER2_WALLET_REGISTRY_SIZE; ++i) {
    if (LEDGER2_WALLET_REGISTRY[i].name == wallet_name) return LEDGER2_WALLET_REGISTRY[i].kind;
  }
  eosio::check(false, "ledger2_get_wallet_kind: wallet_name отсутствует в LEDGER2_WALLET_REGISTRY");
  return WalletKind::COOPERATIVE; // unreachable
}