@arbiwallet/contracts 1.0.8 → 1.0.10

package/gen/custody.ts

@@ -0,0 +1,169 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.11.4
+//   protoc               v7.34.0
+// source: custody.proto
+
+/* eslint-disable */
+import { GrpcMethod, GrpcStreamMethod } from "@nestjs/microservices";
+import { Observable } from "rxjs";
+
+export const protobufPackage = "custody.v1";
+
+/** Статус отслеживания депозита в рамках ответа GetDepositStatus (не полный on-chain индекс). */
+export enum DepositTrackingStatus {
+  DEPOSIT_TRACKING_STATUS_UNSPECIFIED = 0,
+  /** DEPOSIT_TRACKING_STATUS_UNKNOWN - Адрес не найден / нет данных. */
+  DEPOSIT_TRACKING_STATUS_UNKNOWN = 1,
+  /** DEPOSIT_TRACKING_STATUS_PENDING - Адрес выдан, ожидание/не подтверждено в этом сервисе. */
+  DEPOSIT_TRACKING_STATUS_PENDING = 2,
+  /** DEPOSIT_TRACKING_STATUS_CONFIRMED - Подтверждено (если сервис отдаёт такой уровень детализации). */
+  DEPOSIT_TRACKING_STATUS_CONFIRMED = 3,
+  DEPOSIT_TRACKING_STATUS_FAILED = 4,
+  UNRECOGNIZED = -1,
+}
+
+export interface GetDepositAddressRequest {
+  /** Идентификатор пользователя (на wire при longs:String — строка). */
+  userId: number;
+  /** TRON | BSC и т.д. */
+  network: string;
+  /** По умолчанию USDT. */
+  asset: string;
+}
+
+export interface GetDepositAddressResponse {
+  userId: number;
+  network: string;
+  asset: string;
+  /** Депозитный адрес для пополнения. */
+  address: string;
+}
+
+export interface CreateWithdrawalRequest {
+  /** Уникальный id заявки со стороны продукта (идемпотентность на уровне mpc/БД). */
+  withdrawRequestId: string;
+  userId: number;
+  network: string;
+  /** Сумма в decimal-строке. */
+  amount: string;
+  /** Адрес получателя в целевой сети. */
+  toAddress: string;
+}
+
+export interface CreateWithdrawalResponse {
+  withdrawRequestId: string;
+  /** Id трансфера в BitGo (исторически назывался fireblocks_tx_id). */
+  custodyTransferId: string;
+  /** Унифицированный статус вывода для внутренней логики (CREATED, BROADCASTING, …). */
+  mappedStatus: string;
+}
+
+export interface GetWithdrawalStatusRequest {
+  withdrawRequestId: string;
+}
+
+export interface GetWithdrawalStatusResponse {
+  withdrawRequestId: string;
+  custodyTransferId: string;
+  mappedStatus: string;
+  /** Сырой статус от BitGo. */
+  rawCustodyStatus: string;
+  txHash?: string | undefined;
+  errorCode?: string | undefined;
+  errorMessage?: string | undefined;
+}
+
+export interface GetDepositStatusRequest {
+  userId: number;
+  network: string;
+  /** Ранее выданный депозитный адрес. */
+  address: string;
+  /** Опционально: подсказка по конкретной транзакции (информативно). */
+  txHash?: string | undefined;
+}
+
+export interface GetDepositStatusResponse {
+  status: DepositTrackingStatus;
+  /** Человекочитаемое пояснение (например, куда смотреть дальше — Ledger). */
+  message: string;
+  txHash?: string | undefined;
+}
+
+export const CUSTODY_V1_PACKAGE_NAME = "custody.v1";
+
+/** CustodyService — операции с кастоди-кошельком от имени пользователя (без прямого доступа клиента к BitGo). */
+
+export interface CustodyServiceClient {
+  /**
+   * Выдать существующий или создать новый депозитный адрес пользователя для пары (сеть, актив).
+   * При создании адрес регистрируется в Ledger через исходящий gRPC mpc → ledger.
+   */
+
+  getOrCreateDepositAddress(request: GetDepositAddressRequest): Observable<GetDepositAddressResponse>;
+
+  /** Инициировать вывод средств на указанный on-chain адрес; возвращает id трансфера в custody и унифицированный статус. */
+
+  createWithdrawal(request: CreateWithdrawalRequest): Observable<CreateWithdrawalResponse>;
+
+  /** Получить текущий статус ранее созданного вывода по внешнему id заявки (withdraw_request_id). */
+
+  getWithdrawalStatus(request: GetWithdrawalStatusRequest): Observable<GetWithdrawalStatusResponse>;
+
+  /** Упрощённый статус «депозита по адресу» на стороне custody (выдача адреса / ожидание on-chain — без полного трекинга в этой БД). */
+
+  getDepositStatus(request: GetDepositStatusRequest): Observable<GetDepositStatusResponse>;
+}
+
+/** CustodyService — операции с кастоди-кошельком от имени пользователя (без прямого доступа клиента к BitGo). */
+
+export interface CustodyServiceController {
+  /**
+   * Выдать существующий или создать новый депозитный адрес пользователя для пары (сеть, актив).
+   * При создании адрес регистрируется в Ledger через исходящий gRPC mpc → ledger.
+   */
+
+  getOrCreateDepositAddress(
+    request: GetDepositAddressRequest,
+  ): Promise<GetDepositAddressResponse> | Observable<GetDepositAddressResponse> | GetDepositAddressResponse;
+
+  /** Инициировать вывод средств на указанный on-chain адрес; возвращает id трансфера в custody и унифицированный статус. */
+
+  createWithdrawal(
+    request: CreateWithdrawalRequest,
+  ): Promise<CreateWithdrawalResponse> | Observable<CreateWithdrawalResponse> | CreateWithdrawalResponse;
+
+  /** Получить текущий статус ранее созданного вывода по внешнему id заявки (withdraw_request_id). */
+
+  getWithdrawalStatus(
+    request: GetWithdrawalStatusRequest,
+  ): Promise<GetWithdrawalStatusResponse> | Observable<GetWithdrawalStatusResponse> | GetWithdrawalStatusResponse;
+
+  /** Упрощённый статус «депозита по адресу» на стороне custody (выдача адреса / ожидание on-chain — без полного трекинга в этой БД). */
+
+  getDepositStatus(
+    request: GetDepositStatusRequest,
+  ): Promise<GetDepositStatusResponse> | Observable<GetDepositStatusResponse> | GetDepositStatusResponse;
+}
+
+export function CustodyServiceControllerMethods() {
+  return function (constructor: Function) {
+    const grpcMethods: string[] = [
+      "getOrCreateDepositAddress",
+      "createWithdrawal",
+      "getWithdrawalStatus",
+      "getDepositStatus",
+    ];
+    for (const method of grpcMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcMethod("CustodyService", method)(constructor.prototype[method], method, descriptor);
+    }
+    const grpcStreamMethods: string[] = [];
+    for (const method of grpcStreamMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcStreamMethod("CustodyService", method)(constructor.prototype[method], method, descriptor);
+    }
+  };
+}
+
+export const CUSTODY_SERVICE_NAME = "CustodyService";

package/gen/ledger.ts

@@ -0,0 +1,370 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.11.4
+//   protoc               v7.34.0
+// source: ledger.proto
+
+/* eslint-disable */
+import { GrpcMethod, GrpcStreamMethod } from "@nestjs/microservices";
+import { Observable } from "rxjs";
+
+export const protobufPackage = "ledger.v1";
+
+export interface RegisterDepositAddressRequest {
+  /** Идентификатор пользователя (строка, часто decimal bigint). */
+  userId: string;
+  /** On-chain адрес приёма. */
+  address: string;
+  /** Код актива, напр. USDT. */
+  asset: string;
+  /** Сеть, напр. TRON, BSC. */
+  network: string;
+  /** Опционально: id кошелька/аккаунта в custody. */
+  custodyWalletId?: string | undefined;
+}
+
+export interface RegisterDepositAddressResponse {
+  /** Id записи адреса в ledger. */
+  id: string;
+  userId: string;
+  address: string;
+  asset: string;
+  network: string;
+  custodyWalletId?:
+    | string
+    | undefined;
+  /** ISO 8601. */
+  createdAt: string;
+}
+
+export interface CreditUserBalanceRequest {
+  userId: string;
+  asset: string;
+  network: string;
+  /** Десятичная строка (фиксированная точность по правилам сервиса). */
+  amount: string;
+  /** Идентификатор транзакции в сети или суррогат для идемпотентности. */
+  txHash: string;
+  /** Внешний id операции (custody, провайдер). */
+  externalOperationId: string;
+  /** Ключ идемпотентности вызова. */
+  idempotencyKey: string;
+  /** Опционально: число подтверждений на момент зачисления. */
+  confirmations?: number | undefined;
+}
+
+export interface CreditUserBalanceResponse {
+  /** Id созданной/найденной записи депозита. */
+  depositId: string;
+  /** Id ledger-операции. */
+  ledgerOperationId: string;
+  /** Доступно после операции. */
+  available: string;
+  reserved: string;
+  total: string;
+}
+
+export interface RegisterWithdrawalRequest {
+  userId: string;
+  asset: string;
+  network: string;
+  amount: string;
+  /** Адрес получателя в сети. */
+  destinationAddress: string;
+  /** Внешний id заявки (idempotency с точки зрения продукта). */
+  requestId: string;
+  /** Id трансфера в custody (BitGo), если уже известен. */
+  externalWithdrawalId?:
+    | string
+    | undefined;
+  /** Комиссия сервиса, строка decimal. */
+  serviceFee: string;
+  /** Сетевая комиссия, строка decimal. */
+  networkFee: string;
+  /** Ключ идемпотентности вызова RegisterWithdrawal. */
+  idempotencyKey: string;
+}
+
+export interface RegisterWithdrawalResponse {
+  /** Внутренний id вывода в ledger. */
+  withdrawalId: string;
+  /** Текущий статус (enum строкой, см. реализацию). */
+  status: string;
+}
+
+export interface ReserveFundsRequest {
+  userId: string;
+  asset: string;
+  network: string;
+  amount: string;
+  /** Внутренний id вывода, под который резервируются средства. */
+  withdrawalId: string;
+  idempotencyKey: string;
+}
+
+export interface ReserveFundsResponse {
+  ledgerOperationId: string;
+  available: string;
+  reserved: string;
+  total: string;
+}
+
+export interface ReleaseFundsRequest {
+  withdrawalId: string;
+  /** Причина снятия резерва (аудит). */
+  reason: string;
+  idempotencyKey: string;
+}
+
+export interface ReleaseFundsResponse {
+  ledgerOperationId: string;
+  available: string;
+  reserved: string;
+  total: string;
+}
+
+export interface FinalizeWithdrawalRequest {
+  withdrawalId: string;
+  txHash: string;
+  /** ISO 8601 время финализации. */
+  finalizedAt: string;
+  idempotencyKey: string;
+}
+
+export interface FinalizeWithdrawalResponse {
+  ledgerOperationId: string;
+  available: string;
+  reserved: string;
+  total: string;
+}
+
+export interface UpdateWithdrawalStatusRequest {
+  /** Внутренний id вывода в ledger. */
+  withdrawalId?:
+    | string
+    | undefined;
+  /** Id в custody (например BitGo transfer id). */
+  externalWithdrawalId?:
+    | string
+    | undefined;
+  /** Целевой статус (строка enum Prisma/ledger). */
+  newStatus: string;
+  txHash?:
+    | string
+    | undefined;
+  /** Сырой JSON от custody/webhook для аудита. */
+  rawPayloadJson?: string | undefined;
+}
+
+export interface UpdateWithdrawalStatusResponse {
+  withdrawalId: string;
+  status: string;
+  /** Была ли выполнена финализация в рамках этого вызова. */
+  finalized: boolean;
+  /** Был ли снят резерв (отмена/ошибка). */
+  released: boolean;
+}
+
+export interface GetBalanceRequest {
+  userId: string;
+  asset: string;
+  network: string;
+}
+
+export interface GetBalanceResponse {
+  userId: string;
+  asset: string;
+  network: string;
+  available: string;
+  reserved: string;
+  total: string;
+}
+
+export interface GetBalancesRequest {
+  userId: string;
+}
+
+export interface BalanceRow {
+  userId: string;
+  asset: string;
+  network: string;
+  available: string;
+  reserved: string;
+  total: string;
+}
+
+export interface GetBalancesResponse {
+  balances: BalanceRow[];
+}
+
+export interface TransactionFeedItem {
+  id: string;
+  /** Тип события ленты (строка, см. TransactionFeedType в реализации). */
+  type: string;
+  asset: string;
+  network: string;
+  amount?: string | undefined;
+  referenceType?: string | undefined;
+  referenceId?: string | undefined;
+  title?: string | undefined;
+  createdAt: string;
+  /** JSON-строка с доп. полями. */
+  metadataJson?: string | undefined;
+}
+
+export interface GetTransactionFeedRequest {
+  userId: string;
+  limit: number;
+  /** Курсор для следующей страницы. */
+  cursorId?: string | undefined;
+  offset?: number | undefined;
+}
+
+export interface GetTransactionFeedResponse {
+  items: TransactionFeedItem[];
+  nextCursorId?:
+    | string
+    | undefined;
+  /** Число элементов в этом ответе. */
+  totalReturned: number;
+}
+
+export const LEDGER_V1_PACKAGE_NAME = "ledger.v1";
+
+export interface LedgerServiceClient {
+  /** Регистрация депозитного адреса: привязка on-chain адреса к пользователю, активу и сети (до зачисления средств). */
+
+  registerDepositAddress(request: RegisterDepositAddressRequest): Observable<RegisterDepositAddressResponse>;
+
+  /** Зачисление средств на доступный баланс пользователя (подтверждённый депозит); идемпотентность по ключу и внешнему id операции. */
+
+  creditUserBalance(request: CreditUserBalanceRequest): Observable<CreditUserBalanceResponse>;
+
+  /** Создание записи о выводе в учёте (черновик заявки); дальнейшие шаги — резерв, смена статусов, финализация. */
+
+  registerWithdrawal(request: RegisterWithdrawalRequest): Observable<RegisterWithdrawalResponse>;
+
+  /** Блокировка (резерв) средств на балансе под конкретный вывод после прохождения проверок. */
+
+  reserveFunds(request: ReserveFundsRequest): Observable<ReserveFundsResponse>;
+
+  /** Снятие резерва (отмена вывода, ошибка custody и т.п.) с возвратом средств в available. */
+
+  releaseFunds(request: ReleaseFundsRequest): Observable<ReleaseFundsResponse>;
+
+  /** Фиксация успешного вывода в сеть: списание из резерва, сохранение tx hash. */
+
+  finalizeWithdrawal(request: FinalizeWithdrawalRequest): Observable<FinalizeWithdrawalResponse>;
+
+  /** Обновление статуса вывода по внутреннему id или внешнему id custody (BitGo transfer id); переходы валидируются по правилам ledger. */
+
+  updateWithdrawalStatus(request: UpdateWithdrawalStatusRequest): Observable<UpdateWithdrawalStatusResponse>;
+
+  /** Снимок баланса пользователя по одной паре (asset, network): available / reserved / total. */
+
+  getBalance(request: GetBalanceRequest): Observable<GetBalanceResponse>;
+
+  /** Все балансовые позиции пользователя по всем активам и сетям. */
+
+  getBalances(request: GetBalancesRequest): Observable<GetBalancesResponse>;
+
+  /** Постраничная лента операций пользователя (история для UI); курсор и offset — на усмотрение сервера. */
+
+  getTransactionFeed(request: GetTransactionFeedRequest): Observable<GetTransactionFeedResponse>;
+}
+
+export interface LedgerServiceController {
+  /** Регистрация депозитного адреса: привязка on-chain адреса к пользователю, активу и сети (до зачисления средств). */
+
+  registerDepositAddress(
+    request: RegisterDepositAddressRequest,
+  ):
+    | Promise<RegisterDepositAddressResponse>
+    | Observable<RegisterDepositAddressResponse>
+    | RegisterDepositAddressResponse;
+
+  /** Зачисление средств на доступный баланс пользователя (подтверждённый депозит); идемпотентность по ключу и внешнему id операции. */
+
+  creditUserBalance(
+    request: CreditUserBalanceRequest,
+  ): Promise<CreditUserBalanceResponse> | Observable<CreditUserBalanceResponse> | CreditUserBalanceResponse;
+
+  /** Создание записи о выводе в учёте (черновик заявки); дальнейшие шаги — резерв, смена статусов, финализация. */
+
+  registerWithdrawal(
+    request: RegisterWithdrawalRequest,
+  ): Promise<RegisterWithdrawalResponse> | Observable<RegisterWithdrawalResponse> | RegisterWithdrawalResponse;
+
+  /** Блокировка (резерв) средств на балансе под конкретный вывод после прохождения проверок. */
+
+  reserveFunds(
+    request: ReserveFundsRequest,
+  ): Promise<ReserveFundsResponse> | Observable<ReserveFundsResponse> | ReserveFundsResponse;
+
+  /** Снятие резерва (отмена вывода, ошибка custody и т.п.) с возвратом средств в available. */
+
+  releaseFunds(
+    request: ReleaseFundsRequest,
+  ): Promise<ReleaseFundsResponse> | Observable<ReleaseFundsResponse> | ReleaseFundsResponse;
+
+  /** Фиксация успешного вывода в сеть: списание из резерва, сохранение tx hash. */
+
+  finalizeWithdrawal(
+    request: FinalizeWithdrawalRequest,
+  ): Promise<FinalizeWithdrawalResponse> | Observable<FinalizeWithdrawalResponse> | FinalizeWithdrawalResponse;
+
+  /** Обновление статуса вывода по внутреннему id или внешнему id custody (BitGo transfer id); переходы валидируются по правилам ledger. */
+
+  updateWithdrawalStatus(
+    request: UpdateWithdrawalStatusRequest,
+  ):
+    | Promise<UpdateWithdrawalStatusResponse>
+    | Observable<UpdateWithdrawalStatusResponse>
+    | UpdateWithdrawalStatusResponse;
+
+  /** Снимок баланса пользователя по одной паре (asset, network): available / reserved / total. */
+
+  getBalance(
+    request: GetBalanceRequest,
+  ): Promise<GetBalanceResponse> | Observable<GetBalanceResponse> | GetBalanceResponse;
+
+  /** Все балансовые позиции пользователя по всем активам и сетям. */
+
+  getBalances(
+    request: GetBalancesRequest,
+  ): Promise<GetBalancesResponse> | Observable<GetBalancesResponse> | GetBalancesResponse;
+
+  /** Постраничная лента операций пользователя (история для UI); курсор и offset — на усмотрение сервера. */
+
+  getTransactionFeed(
+    request: GetTransactionFeedRequest,
+  ): Promise<GetTransactionFeedResponse> | Observable<GetTransactionFeedResponse> | GetTransactionFeedResponse;
+}
+
+export function LedgerServiceControllerMethods() {
+  return function (constructor: Function) {
+    const grpcMethods: string[] = [
+      "registerDepositAddress",
+      "creditUserBalance",
+      "registerWithdrawal",
+      "reserveFunds",
+      "releaseFunds",
+      "finalizeWithdrawal",
+      "updateWithdrawalStatus",
+      "getBalance",
+      "getBalances",
+      "getTransactionFeed",
+    ];
+    for (const method of grpcMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcMethod("LedgerService", method)(constructor.prototype[method], method, descriptor);
+    }
+    const grpcStreamMethods: string[] = [];
+    for (const method of grpcStreamMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcStreamMethod("LedgerService", method)(constructor.prototype[method], method, descriptor);
+    }
+  };
+}
+
+export const LEDGER_SERVICE_NAME = "LedgerService";

package/gen/user.ts

@@ -0,0 +1,57 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.11.4
+//   protoc               v7.34.0
+// source: user.proto
+
+/* eslint-disable */
+import { GrpcMethod, GrpcStreamMethod } from "@nestjs/microservices";
+import { Observable } from "rxjs";
+
+export const protobufPackage = "user";
+
+export interface GetUserRequest {
+  id: number;
+}
+
+export interface UserResponse {
+  id: number;
+  email?: string | undefined;
+  phone?: string | undefined;
+  telegramId?: string | undefined;
+  telegramUsername?: string | undefined;
+  appleSub?: string | undefined;
+  registrationType: string;
+  firstName?: string | undefined;
+  lastName?: string | undefined;
+  avatar?: string | undefined;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export const USER_PACKAGE_NAME = "user";
+
+export interface UserServiceClient {
+  getUser(request: GetUserRequest): Observable<UserResponse>;
+}
+
+export interface UserServiceController {
+  getUser(request: GetUserRequest): Promise<UserResponse> | Observable<UserResponse> | UserResponse;
+}
+
+export function UserServiceControllerMethods() {
+  return function (constructor: Function) {
+    const grpcMethods: string[] = ["getUser"];
+    for (const method of grpcMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcMethod("UserService", method)(constructor.prototype[method], method, descriptor);
+    }
+    const grpcStreamMethods: string[] = [];
+    for (const method of grpcStreamMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcStreamMethod("UserService", method)(constructor.prototype[method], method, descriptor);
+    }
+  };
+}
+
+export const USER_SERVICE_NAME = "UserService";

package/gen/webhook.ts

@@ -0,0 +1,65 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.11.4
+//   protoc               v7.34.0
+// source: webhook.proto
+
+/* eslint-disable */
+import { GrpcMethod, GrpcStreamMethod } from "@nestjs/microservices";
+import { Observable } from "rxjs";
+
+export const protobufPackage = "webhook.v1";
+
+export interface ProcessWebhookRequest {
+  /**
+   * Полное тело webhook от BitGo в виде одной JSON-строки (как получено после парсинга HTTP, объекты сериализованы стандартно).
+   * Клиент (gateway) обязан передавать валидный JSON; mpc парсит и маппит поля transfer / state / data и т.д.
+   */
+  jsonPayload: string;
+}
+
+export interface ProcessWebhookResponse {
+  /** true, если обработка завершилась без фатальной ошибки. */
+  ok: boolean;
+  /** Стабильный id события (хеш, transfer id и т.п.) — для логов и ответа вызывающей стороне. */
+  eventId: string;
+}
+
+export const WEBHOOK_V1_PACKAGE_NAME = "webhook.v1";
+
+export interface WebhookServiceClient {
+  /**
+   * Обработка одного события webhook BitGo: разбор JSON, дедупликация по event_id, обновление custody-транзакций,
+   * при необходимости — gRPC в Ledger (статус вывода, зачисление депозита) и уведомления.
+   */
+
+  processBitGoWebhook(request: ProcessWebhookRequest): Observable<ProcessWebhookResponse>;
+}
+
+export interface WebhookServiceController {
+  /**
+   * Обработка одного события webhook BitGo: разбор JSON, дедупликация по event_id, обновление custody-транзакций,
+   * при необходимости — gRPC в Ledger (статус вывода, зачисление депозита) и уведомления.
+   */
+
+  processBitGoWebhook(
+    request: ProcessWebhookRequest,
+  ): Promise<ProcessWebhookResponse> | Observable<ProcessWebhookResponse> | ProcessWebhookResponse;
+}
+
+export function WebhookServiceControllerMethods() {
+  return function (constructor: Function) {
+    const grpcMethods: string[] = ["processBitGoWebhook"];
+    for (const method of grpcMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcMethod("WebhookService", method)(constructor.prototype[method], method, descriptor);
+    }
+    const grpcStreamMethods: string[] = [];
+    for (const method of grpcStreamMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcStreamMethod("WebhookService", method)(constructor.prototype[method], method, descriptor);
+    }
+  };
+}
+
+export const WEBHOOK_SERVICE_NAME = "WebhookService";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@arbiwallet/contracts",
   "descriptions": "Generate and manage smart contracts for ArbiWallet",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "scripts": {
     "generate": "protoc -I ./proto ./proto/*.proto --ts_proto_out=./gen --ts_proto_opt=nestJs=true,package=omit"
   },

package/proto/custody.proto

@@ -0,0 +1,81 @@
+syntax = "proto3";
+
+// Пакет gRPC публичного API custody-слоя (mpc_service): выдача депозитных адресов, выводы, статусы.
+// Интеграция с BitGo; вызовы от gateway или внутренних сервисов с доверенной сети.
+package custody.v1;
+
+// CustodyService — операции с кастоди-кошельком от имени пользователя (без прямого доступа клиента к BitGo).
+service CustodyService {
+  // Выдать существующий или создать новый депозитный адрес пользователя для пары (сеть, актив).
+  // При создании адрес регистрируется в Ledger через исходящий gRPC mpc → ledger.
+  rpc GetOrCreateDepositAddress(GetDepositAddressRequest) returns (GetDepositAddressResponse);
+  // Инициировать вывод средств на указанный on-chain адрес; возвращает id трансфера в custody и унифицированный статус.
+  rpc CreateWithdrawal(CreateWithdrawalRequest) returns (CreateWithdrawalResponse);
+  // Получить текущий статус ранее созданного вывода по внешнему id заявки (withdraw_request_id).
+  rpc GetWithdrawalStatus(GetWithdrawalStatusRequest) returns (GetWithdrawalStatusResponse);
+  // Упрощённый статус «депозита по адресу» на стороне custody (выдача адреса / ожидание on-chain — без полного трекинга в этой БД).
+  rpc GetDepositStatus(GetDepositStatusRequest) returns (GetDepositStatusResponse);
+}
+
+message GetDepositAddressRequest {
+  int64 user_id = 1;               // Идентификатор пользователя (на wire при longs:String — строка).
+  string network = 2;              // TRON | BSC и т.д.
+  string asset = 3;                // По умолчанию USDT.
+}
+
+message GetDepositAddressResponse {
+  int64 user_id = 1;
+  string network = 2;
+  string asset = 3;
+  string address = 4;              // Депозитный адрес для пополнения.
+}
+
+message CreateWithdrawalRequest {
+  string withdraw_request_id = 1;  // Уникальный id заявки со стороны продукта (идемпотентность на уровне mpc/БД).
+  int64 user_id = 2;
+  string network = 3;
+  string amount = 4;               // Сумма в decimal-строке.
+  string to_address = 5;           // Адрес получателя в целевой сети.
+}
+
+message CreateWithdrawalResponse {
+  string withdraw_request_id = 1;
+  string custody_transfer_id = 2;  // Id трансфера в BitGo (исторически назывался fireblocks_tx_id).
+  string mapped_status = 3;        // Унифицированный статус вывода для внутренней логики (CREATED, BROADCASTING, …).
+}
+
+message GetWithdrawalStatusRequest {
+  string withdraw_request_id = 1;
+}
+
+message GetWithdrawalStatusResponse {
+  string withdraw_request_id = 1;
+  string custody_transfer_id = 2;
+  string mapped_status = 3;
+  string raw_custody_status = 4;   // Сырой статус от BitGo.
+  optional string tx_hash = 5;
+  optional string error_code = 6;
+  optional string error_message = 7;
+}
+
+message GetDepositStatusRequest {
+  int64 user_id = 1;
+  string network = 2;
+  string address = 3;              // Ранее выданный депозитный адрес.
+  optional string tx_hash = 4;     // Опционально: подсказка по конкретной транзакции (информативно).
+}
+
+// Статус отслеживания депозита в рамках ответа GetDepositStatus (не полный on-chain индекс).
+enum DepositTrackingStatus {
+  DEPOSIT_TRACKING_STATUS_UNSPECIFIED = 0;
+  DEPOSIT_TRACKING_STATUS_UNKNOWN = 1;   // Адрес не найден / нет данных.
+  DEPOSIT_TRACKING_STATUS_PENDING = 2;    // Адрес выдан, ожидание/не подтверждено в этом сервисе.
+  DEPOSIT_TRACKING_STATUS_CONFIRMED = 3;  // Подтверждено (если сервис отдаёт такой уровень детализации).
+  DEPOSIT_TRACKING_STATUS_FAILED = 4;
+}
+
+message GetDepositStatusResponse {
+  DepositTrackingStatus status = 1;
+  string message = 2;              // Человекочитаемое пояснение (например, куда смотреть дальше — Ledger).
+  optional string tx_hash = 3;
+}

package/proto/ledger.proto

@@ -0,0 +1,205 @@
+syntax = "proto3";
+
+// Пакет gRPC API микросервиса Ledger (внутренний баланс, депозиты, выводы, лента операций).
+// Реализация: ledger_microservice; клиенты: gateway, mpc_service и др.
+package ledger.v1;
+
+option csharp_namespace = "Ledger.V1";
+option java_multiple_files = true;
+option java_package = "com.arbiwallet.ledger.v1";
+
+service LedgerService {
+  // Регистрация депозитного адреса: привязка on-chain адреса к пользователю, активу и сети (до зачисления средств).
+  rpc RegisterDepositAddress(RegisterDepositAddressRequest) returns (RegisterDepositAddressResponse);
+  // Зачисление средств на доступный баланс пользователя (подтверждённый депозит); идемпотентность по ключу и внешнему id операции.
+  rpc CreditUserBalance(CreditUserBalanceRequest) returns (CreditUserBalanceResponse);
+  // Создание записи о выводе в учёте (черновик заявки); дальнейшие шаги — резерв, смена статусов, финализация.
+  rpc RegisterWithdrawal(RegisterWithdrawalRequest) returns (RegisterWithdrawalResponse);
+  // Блокировка (резерв) средств на балансе под конкретный вывод после прохождения проверок.
+  rpc ReserveFunds(ReserveFundsRequest) returns (ReserveFundsResponse);
+  // Снятие резерва (отмена вывода, ошибка custody и т.п.) с возвратом средств в available.
+  rpc ReleaseFunds(ReleaseFundsRequest) returns (ReleaseFundsResponse);
+  // Фиксация успешного вывода в сеть: списание из резерва, сохранение tx hash.
+  rpc FinalizeWithdrawal(FinalizeWithdrawalRequest) returns (FinalizeWithdrawalResponse);
+  // Обновление статуса вывода по внутреннему id или внешнему id custody (BitGo transfer id); переходы валидируются по правилам ledger.
+  rpc UpdateWithdrawalStatus(UpdateWithdrawalStatusRequest) returns (UpdateWithdrawalStatusResponse);
+  // Снимок баланса пользователя по одной паре (asset, network): available / reserved / total.
+  rpc GetBalance(GetBalanceRequest) returns (GetBalanceResponse);
+  // Все балансовые позиции пользователя по всем активам и сетям.
+  rpc GetBalances(GetBalancesRequest) returns (GetBalancesResponse);
+  // Постраничная лента операций пользователя (история для UI); курсор и offset — на усмотрение сервера.
+  rpc GetTransactionFeed(GetTransactionFeedRequest) returns (GetTransactionFeedResponse);
+}
+
+message RegisterDepositAddressRequest {
+  string user_id = 1;              // Идентификатор пользователя (строка, часто decimal bigint).
+  string address = 2;              // On-chain адрес приёма.
+  string asset = 3;                // Код актива, напр. USDT.
+  string network = 4;              // Сеть, напр. TRON, BSC.
+  optional string custody_wallet_id = 5; // Опционально: id кошелька/аккаунта в custody.
+}
+
+message RegisterDepositAddressResponse {
+  string id = 1;                   // Id записи адреса в ledger.
+  string user_id = 2;
+  string address = 3;
+  string asset = 4;
+  string network = 5;
+  optional string custody_wallet_id = 6;
+  string created_at = 7;           // ISO 8601.
+}
+
+message CreditUserBalanceRequest {
+  string user_id = 1;
+  string asset = 2;
+  string network = 3;
+  string amount = 4;               // Десятичная строка (фиксированная точность по правилам сервиса).
+  string tx_hash = 5;            // Идентификатор транзакции в сети или суррогат для идемпотентности.
+  string external_operation_id = 6; // Внешний id операции (custody, провайдер).
+  string idempotency_key = 7;      // Ключ идемпотентности вызова.
+  optional int32 confirmations = 8;   // Опционально: число подтверждений на момент зачисления.
+}
+
+message CreditUserBalanceResponse {
+  string deposit_id = 1;           // Id созданной/найденной записи депозита.
+  string ledger_operation_id = 2; // Id ledger-операции.
+  string available = 3;            // Доступно после операции.
+  string reserved = 4;
+  string total = 5;
+}
+
+message RegisterWithdrawalRequest {
+  string user_id = 1;
+  string asset = 2;
+  string network = 3;
+  string amount = 4;
+  string destination_address = 5;  // Адрес получателя в сети.
+  string request_id = 6;           // Внешний id заявки (idempotency с точки зрения продукта).
+  optional string external_withdrawal_id = 7; // Id трансфера в custody (BitGo), если уже известен.
+  string service_fee = 8;          // Комиссия сервиса, строка decimal.
+  string network_fee = 9;          // Сетевая комиссия, строка decimal.
+  string idempotency_key = 10;     // Ключ идемпотентности вызова RegisterWithdrawal.
+}
+
+message RegisterWithdrawalResponse {
+  string withdrawal_id = 1;      // Внутренний id вывода в ledger.
+  string status = 2;               // Текущий статус (enum строкой, см. реализацию).
+}
+
+message ReserveFundsRequest {
+  string user_id = 1;
+  string asset = 2;
+  string network = 3;
+  string amount = 4;
+  string withdrawal_id = 5;        // Внутренний id вывода, под который резервируются средства.
+  string idempotency_key = 6;
+}
+
+message ReserveFundsResponse {
+  string ledger_operation_id = 1;
+  string available = 2;
+  string reserved = 3;
+  string total = 4;
+}
+
+message ReleaseFundsRequest {
+  string withdrawal_id = 1;
+  string reason = 2;               // Причина снятия резерва (аудит).
+  string idempotency_key = 3;
+}
+
+message ReleaseFundsResponse {
+  string ledger_operation_id = 1;
+  string available = 2;
+  string reserved = 3;
+  string total = 4;
+}
+
+message FinalizeWithdrawalRequest {
+  string withdrawal_id = 1;
+  string tx_hash = 2;
+  string finalized_at = 3;         // ISO 8601 время финализации.
+  string idempotency_key = 4;
+}
+
+message FinalizeWithdrawalResponse {
+  string ledger_operation_id = 1;
+  string available = 2;
+  string reserved = 3;
+  string total = 4;
+}
+
+message UpdateWithdrawalStatusRequest {
+  oneof selector {
+    string withdrawal_id = 1;      // Внутренний id вывода в ledger.
+    string external_withdrawal_id = 2; // Id в custody (например BitGo transfer id).
+  }
+  string new_status = 3;           // Целевой статус (строка enum Prisma/ledger).
+  optional string tx_hash = 4;
+  optional string raw_payload_json = 5; // Сырой JSON от custody/webhook для аудита.
+}
+
+message UpdateWithdrawalStatusResponse {
+  string withdrawal_id = 1;
+  string status = 2;
+  bool finalized = 3;              // Была ли выполнена финализация в рамках этого вызова.
+  bool released = 4;               // Был ли снят резерв (отмена/ошибка).
+}
+
+message GetBalanceRequest {
+  string user_id = 1;
+  string asset = 2;
+  string network = 3;
+}
+
+message GetBalanceResponse {
+  string user_id = 1;
+  string asset = 2;
+  string network = 3;
+  string available = 4;
+  string reserved = 5;
+  string total = 6;
+}
+
+message GetBalancesRequest {
+  string user_id = 1;
+}
+
+message BalanceRow {
+  string user_id = 1;
+  string asset = 2;
+  string network = 3;
+  string available = 4;
+  string reserved = 5;
+  string total = 6;
+}
+
+message GetBalancesResponse {
+  repeated BalanceRow balances = 1;
+}
+
+message TransactionFeedItem {
+  string id = 1;
+  string type = 2;                 // Тип события ленты (строка, см. TransactionFeedType в реализации).
+  string asset = 3;
+  string network = 4;
+  optional string amount = 5;
+  optional string reference_type = 6;
+  optional string reference_id = 7;
+  optional string title = 8;
+  string created_at = 9;
+  optional string metadata_json = 10; // JSON-строка с доп. полями.
+}
+
+message GetTransactionFeedRequest {
+  string user_id = 1;
+  int32 limit = 2;
+  optional string cursor_id = 3;   // Курсор для следующей страницы.
+  optional int32 offset = 4;
+}
+
+message GetTransactionFeedResponse {
+  repeated TransactionFeedItem items = 1;
+  optional string next_cursor_id = 2;
+  int32 total_returned = 3;        // Число элементов в этом ответе.
+}

package/proto/user.proto

@@ -0,0 +1,25 @@
+syntax = "proto3";
+package user;
+
+service UserService {
+  rpc GetUser (GetUserRequest) returns (UserResponse);
+}
+
+message GetUserRequest {
+  int32 id = 1;
+}
+
+message UserResponse {
+  int32 id = 1;
+  optional string email = 2;
+  optional string phone = 3;
+  optional string telegram_id = 4;
+  optional string telegram_username = 5;
+  optional string apple_sub = 6;
+  string registration_type = 7;
+  optional string first_name = 8;
+  optional string last_name = 9;
+  optional string avatar = 10;
+  string created_at = 11;
+  string updated_at = 12;
+}

package/proto/webhook.proto

@@ -0,0 +1,23 @@
+syntax = "proto3";
+
+// Пакет внутреннего gRPC для передачи событий BitGo в mpc_service без публичного HTTP на mpc.
+// Типичный поток: WalletGateway принимает POST /webhooks/bitgo → вызывает ProcessBitGoWebhook с JSON телом.
+// Та же бизнес-логика, что у HTTP-обработчика webhook в mpc (дедуп, обновление транзакций, вызовы Ledger/Notification).
+package webhook.v1;
+
+service WebhookService {
+  // Обработка одного события webhook BitGo: разбор JSON, дедупликация по event_id, обновление custody-транзакций,
+  // при необходимости — gRPC в Ledger (статус вывода, зачисление депозита) и уведомления.
+  rpc ProcessBitGoWebhook(ProcessWebhookRequest) returns (ProcessWebhookResponse);
+}
+
+message ProcessWebhookRequest {
+  // Полное тело webhook от BitGo в виде одной JSON-строки (как получено после парсинга HTTP, объекты сериализованы стандартно).
+  // Клиент (gateway) обязан передавать валидный JSON; mpc парсит и маппит поля transfer / state / data и т.д.
+  string json_payload = 1;
+}
+
+message ProcessWebhookResponse {
+  bool ok = 1;                     // true, если обработка завершилась без фатальной ошибки.
+  string event_id = 2;             // Стабильный id события (хеш, transfer id и т.п.) — для логов и ответа вызывающей стороне.
+}