🏦 Кошелек

Кошелёк — это базовая сущность, через которую происходят все финансовые операции: приём депозитов, отправка средств, списания комиссий и т.д. Каждый кошелёк может принадлежать юниту, контрагенту или инвойсу (в зависимости от контекста использования).

---

📘 Общая структура

{
  "id": 2629,
  "createdAt": "2025-10-16T12:18:59.252Z",
  "updatedAt": "2025-10-30T15:15:20.705Z",
  "subId": null,
  "clientId": null,
  "unitId": 239,
  "invoiceId": null,
  "name": null,
  "currency": "USDT",
  "network": "ERC20",
  "balance": 79.999381,
  "transit_balance": 0,
  "service_fee_balance": 0,
  "walletAddress": "0x42E22919D1133cea77c23e29e05a63787044ebf1",
  "riskScore": 0.64,
  "total_deposits": "100000000"
}

---

💱 Поддерживаемые валюты и сети

Валюта	Сеть	Пример адреса	Примечание
USDT	TRC20	TNfJbJrL5b4oRVLhU3Gz6rj2qg4U5Kk5Uv	Основная сеть для стабильных монет. Низкая комиссия.
USDT	ERC20	0xA9F9a81A624d2C18c57E5e1A2C7b9fB8F10D7E89	Сеть Ethereum, используется для интеграций с DeFi.
USDC	ERC20	0x7E62e5cDfB2Cf3E2f6bDdD3928eF4f8211A5c7b1	Стейблкоин от Circle, эквивалент доллара США.
BTC	Bitcoin	bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh	Классическая сеть Bitcoin.
ETH	ERC20	0xF67eDe3b8421f438C21bD46C84515f78F90E9A34	Нативная валюта Ethereum, используется для оплаты газа.
TRX	TRC20	TX8ZKzyAqD7TTS7ZT6X1a1YqkAF8KWWU77	Нативная монета TRON, используется для комиссий TRC20.

---

🧩 Перечисления (Enums)

Для унификации и предотвращения ошибок при интеграции рекомендуется использовать фиксированные значения валют и сетей из перечислений ниже 👇

💰 WalletCurrencyEnum

enum WalletCurrencyEnum {
  BTC = 'BTC',
  ETH = 'ETH',
  TRX = 'TRX',
  USDT = 'USDT',
  USDC = 'USDC',
}

🌐 WalletNetworkEnum

enum WalletNetworkEnum {
  BITCOIN = 'Bitcoin',
  ERC20 = 'ERC20',
  TRC20 = 'TRC20',
}

🧠 Примечание:

• Поле currency всегда должно принимать одно из значений WalletCurrencyEnum.

• Поле network — одно из WalletNetworkEnum.

🧩 Поля сущности

Поле	Тип	Nullable	Описание
id	number	❌	Уникальный идентификатор кошелька в системе.
createdAt	string (ISO 8601)	❌	Дата создания кошелька.
updatedAt	string (ISO 8601)	❌	Дата последнего обновления кошелька.
subId	string | null	✅	Вспомогательный идентификатор для вложенных систем (например, суб-аккаунтов).
clientId	number | null	✅	Если кошелёк принадлежит клиенту — указывается clientId.
unitId	number | null	✅	Если кошелёк принадлежит юниту — указывается unitId.
invoiceId	number | null	✅	Если кошелёк создан для приёма оплаты по инвойсу — указывается invoiceId.
name	string | null	✅	Пользовательское имя кошелька (опционально).
currency	WalletCurrencyEnum	✅	Валюта кошелька. Может быть BTC, ETH, USDT, USDC и т.д.
network	WalletNetworkEnum	✅	Сеть, в которой находится кошелёк (например, Bitcoin, TRC20, ERC20).
balance	number	✅	Текущий доступный баланс кошелька.
transit_balance	number	✅	Баланс, находящийся "в пути" (например, неподтверждённые транзакции).
service_fee_balance	number	✅	Баланс, зарезервированный под сервисные комиссии.
walletAddress	string	✅	Публичный адрес кошелька.
riskScore	number	✅	Риск-оценка адреса (например, по данным AML-сервисов).
total_deposits	string	✅	Суммарная сумма всех поступлений на кошелёк.

---

🔗 Связи с другими сущностями

Сущность	Поле связи	Описание
Unit	unitId	Кошелёк принадлежит бизнес-юниту.
Client	clientId	Кошелёк закреплён за конкретным клиентом или контрагентом.
Invoice	invoiceId	Кошелёк создан специально под оплату инвойса.

---

⚙️ Использование

Кошельки используются для:

• Приёма депозитов (например, клиент оплачивает инвойс);

• Выполнения исходящих транзакций;

• Учёта комиссий и рисков;

• Группировки средств внутри юнитов и клиентов.

---