@arbiwallet/contracts 1.0.49 → 1.0.50

package/gen/card.ts

@@ -0,0 +1,505 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.11.4
+//   protoc               v7.34.0
+// source: card.proto
+
+/* eslint-disable */
+import { GrpcMethod, GrpcStreamMethod } from "@nestjs/microservices";
+import { Observable } from "rxjs";
+
+export const protobufPackage = "card.v1";
+
+export enum CardStatus {
+  CARD_STATUS_UNSPECIFIED = 0,
+  CARD_STATUS_CREATED = 1,
+  CARD_STATUS_ACTIVE = 2,
+  CARD_STATUS_FROZEN = 3,
+  CARD_STATUS_BLOCKED = 4,
+  CARD_STATUS_DELETED = 5,
+  CARD_STATUS_ERROR = 6,
+  UNRECOGNIZED = -1,
+}
+
+export interface GetCardProvidersInfoRequest {
+  accountId: number;
+}
+
+export interface CardProviderInfo {
+  id: number;
+  cardType: string;
+  currency: string;
+  bin: string;
+  cardFormFactor: string;
+  kycRequired: boolean;
+  initBalance: string;
+  regions: string[];
+  phonePrefixes: string[];
+  cardRegion: string;
+}
+
+export interface GetCardProvidersInfoResponse {
+  providers: CardProviderInfo[];
+}
+
+export interface CreateCardRequest {
+  accountId: number;
+  name: string;
+  currency: string;
+  cardType: string;
+  isVirtual: boolean;
+  bin: string;
+  cardHolderName: string;
+  phone: string;
+  email: string;
+  externalUuid: string;
+  otpCode: string;
+  isAutoTopup: boolean;
+  autoTopAmount: string;
+  autoTopupLimit: string;
+  cardBalanceThreshold: string;
+}
+
+export interface CreateCardsBatchRequest {
+  template: CreateCardRequest | undefined;
+  numberOfCards: number;
+}
+
+export interface CreateCardsBatchResponse {
+  cards: CardResponse[];
+}
+
+export interface TopupCardRequest {
+  accountId: number;
+  cardId: number;
+  amount: string;
+  cardCryptoCurrency: string;
+  otpCode: string;
+}
+
+export interface TopupCardResponse {
+  cardId: number;
+  currencyCredit: string;
+  amountCredit: string;
+  amountDebit: string;
+  currencyDebit: string;
+  fee: string;
+  totalAmount: string;
+}
+
+export interface GetTopupFeeRequest {
+  accountId: number;
+  cardId: number;
+  amount: string;
+  cardCryptoCurrency: string;
+}
+
+export interface GetTopupFeeResponse {
+  cardId: number;
+  amount: string;
+  cardCryptoCurrency: string;
+  feeAmount: string;
+  feeCurrency: string;
+  cardCurrency: string;
+  amountToCard: string;
+}
+
+export interface UpdateAutoTopupRequest {
+  accountId: number;
+  cardId: number;
+  isAutoTopup: boolean;
+  autoTopAmount: string;
+  autoTopupLimit: string;
+  currentAutoTopupAmount: string;
+  cardBalanceThreshold: string;
+}
+
+export interface GetAutoTopupRequest {
+  accountId: number;
+  cardId: number;
+}
+
+export interface AutoTopupResponse {
+  cardId: number;
+  isAutoTopup: boolean;
+  autoTopAmount: string;
+  autoTopupLimit: string;
+  currentAutoTopupAmount: string;
+  cardBalanceThreshold: string;
+}
+
+export interface ListCardsRequest {
+  accountId: number;
+}
+
+export interface ListCardsResponse {
+  cards: CardResponse[];
+}
+
+export interface ListCardsPaginatedRequest {
+  accountId: number;
+  page: number;
+  size: number;
+}
+
+export interface ListCardsPaginatedResponse {
+  items: CardResponse[];
+  total: number;
+  page: number;
+  size: number;
+  pages: number;
+}
+
+export interface GetCardRequest {
+  accountId: number;
+  cardId: number;
+}
+
+export interface CardResponse {
+  id: number;
+  name: string;
+  accountId: number;
+  balance: string;
+  currency: string;
+  cardNumber: string;
+  issuerId: number;
+  cardType: string;
+  cvv: string;
+  status: CardStatus;
+  isVirtual: boolean;
+  createdAt: string;
+  expiresAt: string;
+  phone: string;
+  email: string;
+  cardHolderName: string;
+  externalUuid: string;
+  isAutoTopup: boolean;
+  autoTopAmount: string;
+  autoTopupLimit: string;
+  currentAutoTopupAmount: string;
+  cardBalanceThreshold: string;
+}
+
+export interface GetCardBalanceRequest {
+  accountId: number;
+  cardId: number;
+}
+
+export interface GetCardBalanceResponse {
+  cardId: number;
+  balance: string;
+  currency: string;
+}
+
+export interface GetCardTransactionsRequest {
+  accountId: number;
+  cardId: number;
+  pagerOffset: number;
+  pagerSize: number;
+}
+
+export interface CardTransaction {
+  paymentId: number;
+  cardId: number;
+  cardNumber: string;
+  amount: string;
+  cardCurrency: string;
+  operationType: string;
+  status: string;
+  createdAt: string;
+}
+
+export interface Edge {
+  offset: number;
+  size: number;
+  total: number;
+}
+
+export interface GetCardTransactionsResponse {
+  payments: CardTransaction[];
+  edge: Edge | undefined;
+}
+
+export interface GetCardAuthTransactionsRequest {
+  accountId: number;
+  cardId: number;
+  pagerOffset: number;
+  pagerSize: number;
+}
+
+export interface CardAuthTransaction {
+  id: number;
+  cardId: number;
+  currency: string;
+  amount: string;
+  authorizedAmount: string;
+  authorizedCurrency: string;
+  merchantName: string;
+  type: string;
+  status: string;
+  description: string;
+  transactionTime: string;
+  settleDate: string;
+}
+
+export interface GetCardAuthTransactionsResponse {
+  transactions: CardAuthTransaction[];
+  edge: Edge | undefined;
+}
+
+export interface GetCard3dsCodesRequest {
+  accountId: number;
+  cardId: number;
+  pagerOffset: number;
+  pagerSize: number;
+}
+
+export interface Card3dsInfo {
+  id: number;
+  cardId: number;
+  currency: string;
+  amount: string;
+  merchantName: string;
+  type: string;
+  values: string;
+  description: string;
+  transactionTime: string;
+  expirationTime: string;
+}
+
+export interface GetCard3dsCodesResponse {
+  card3dsInfo: Card3dsInfo[];
+  edge: Edge | undefined;
+}
+
+export interface UpdateCardStatusRequest {
+  accountId: number;
+  cardId: number;
+  status: CardStatus;
+}
+
+export interface CardActionRequest {
+  accountId: number;
+  cardId: number;
+}
+
+export interface DeleteCardResponse {
+  ok: boolean;
+}
+
+export interface GetBinsRequest {
+  accountId: number;
+}
+
+export interface GetBinRequest {
+  accountId: number;
+  bin: string;
+}
+
+export interface GetBinsExistsRequest {
+  accountId: number;
+}
+
+export interface GetAreaCodesRequest {
+  accountId: number;
+  bin: string;
+}
+
+export interface GetRegionsRequest {
+  accountId: number;
+  bin: string;
+}
+
+export interface BinResponse {
+  bin: string;
+  cardType: string;
+  currency: string;
+  provider: string;
+  kycRequired: boolean;
+}
+
+export interface GetBinsResponse {
+  bins: BinResponse[];
+}
+
+export interface GetBinsExistsResponse {
+  bins: string[];
+}
+
+export interface GetAreaCodesResponse {
+  areaCodes: string[];
+}
+
+export interface GetRegionsResponse {
+  regions: string[];
+}
+
+export const CARD_V1_PACKAGE_NAME = "card.v1";
+
+export interface CardServiceClient {
+  getCardProvidersInfo(request: GetCardProvidersInfoRequest): Observable<GetCardProvidersInfoResponse>;
+
+  createCard(request: CreateCardRequest): Observable<CardResponse>;
+
+  createCardsBatch(request: CreateCardsBatchRequest): Observable<CreateCardsBatchResponse>;
+
+  topupCard(request: TopupCardRequest): Observable<TopupCardResponse>;
+
+  getTopupFee(request: GetTopupFeeRequest): Observable<GetTopupFeeResponse>;
+
+  updateAutoTopup(request: UpdateAutoTopupRequest): Observable<AutoTopupResponse>;
+
+  getAutoTopup(request: GetAutoTopupRequest): Observable<AutoTopupResponse>;
+
+  listCards(request: ListCardsRequest): Observable<ListCardsResponse>;
+
+  listCardsPaginated(request: ListCardsPaginatedRequest): Observable<ListCardsPaginatedResponse>;
+
+  getCard(request: GetCardRequest): Observable<CardResponse>;
+
+  getCardBalance(request: GetCardBalanceRequest): Observable<GetCardBalanceResponse>;
+
+  getCardTransactions(request: GetCardTransactionsRequest): Observable<GetCardTransactionsResponse>;
+
+  getCardAuthTransactions(request: GetCardAuthTransactionsRequest): Observable<GetCardAuthTransactionsResponse>;
+
+  getCard3DsCodes(request: GetCard3dsCodesRequest): Observable<GetCard3dsCodesResponse>;
+
+  updateCardStatus(request: UpdateCardStatusRequest): Observable<CardResponse>;
+
+  freezeCard(request: CardActionRequest): Observable<CardResponse>;
+
+  unfreezeCard(request: CardActionRequest): Observable<CardResponse>;
+
+  deleteCard(request: CardActionRequest): Observable<DeleteCardResponse>;
+
+  getBins(request: GetBinsRequest): Observable<GetBinsResponse>;
+
+  getBin(request: GetBinRequest): Observable<BinResponse>;
+
+  getBinsExists(request: GetBinsExistsRequest): Observable<GetBinsExistsResponse>;
+
+  getAreaCodes(request: GetAreaCodesRequest): Observable<GetAreaCodesResponse>;
+
+  getRegions(request: GetRegionsRequest): Observable<GetRegionsResponse>;
+}
+
+export interface CardServiceController {
+  getCardProvidersInfo(
+    request: GetCardProvidersInfoRequest,
+  ): Promise<GetCardProvidersInfoResponse> | Observable<GetCardProvidersInfoResponse> | GetCardProvidersInfoResponse;
+
+  createCard(request: CreateCardRequest): Promise<CardResponse> | Observable<CardResponse> | CardResponse;
+
+  createCardsBatch(
+    request: CreateCardsBatchRequest,
+  ): Promise<CreateCardsBatchResponse> | Observable<CreateCardsBatchResponse> | CreateCardsBatchResponse;
+
+  topupCard(request: TopupCardRequest): Promise<TopupCardResponse> | Observable<TopupCardResponse> | TopupCardResponse;
+
+  getTopupFee(
+    request: GetTopupFeeRequest,
+  ): Promise<GetTopupFeeResponse> | Observable<GetTopupFeeResponse> | GetTopupFeeResponse;
+
+  updateAutoTopup(
+    request: UpdateAutoTopupRequest,
+  ): Promise<AutoTopupResponse> | Observable<AutoTopupResponse> | AutoTopupResponse;
+
+  getAutoTopup(
+    request: GetAutoTopupRequest,
+  ): Promise<AutoTopupResponse> | Observable<AutoTopupResponse> | AutoTopupResponse;
+
+  listCards(request: ListCardsRequest): Promise<ListCardsResponse> | Observable<ListCardsResponse> | ListCardsResponse;
+
+  listCardsPaginated(
+    request: ListCardsPaginatedRequest,
+  ): Promise<ListCardsPaginatedResponse> | Observable<ListCardsPaginatedResponse> | ListCardsPaginatedResponse;
+
+  getCard(request: GetCardRequest): Promise<CardResponse> | Observable<CardResponse> | CardResponse;
+
+  getCardBalance(
+    request: GetCardBalanceRequest,
+  ): Promise<GetCardBalanceResponse> | Observable<GetCardBalanceResponse> | GetCardBalanceResponse;
+
+  getCardTransactions(
+    request: GetCardTransactionsRequest,
+  ): Promise<GetCardTransactionsResponse> | Observable<GetCardTransactionsResponse> | GetCardTransactionsResponse;
+
+  getCardAuthTransactions(
+    request: GetCardAuthTransactionsRequest,
+  ):
+    | Promise<GetCardAuthTransactionsResponse>
+    | Observable<GetCardAuthTransactionsResponse>
+    | GetCardAuthTransactionsResponse;
+
+  getCard3DsCodes(
+    request: GetCard3dsCodesRequest,
+  ): Promise<GetCard3dsCodesResponse> | Observable<GetCard3dsCodesResponse> | GetCard3dsCodesResponse;
+
+  updateCardStatus(request: UpdateCardStatusRequest): Promise<CardResponse> | Observable<CardResponse> | CardResponse;
+
+  freezeCard(request: CardActionRequest): Promise<CardResponse> | Observable<CardResponse> | CardResponse;
+
+  unfreezeCard(request: CardActionRequest): Promise<CardResponse> | Observable<CardResponse> | CardResponse;
+
+  deleteCard(
+    request: CardActionRequest,
+  ): Promise<DeleteCardResponse> | Observable<DeleteCardResponse> | DeleteCardResponse;
+
+  getBins(request: GetBinsRequest): Promise<GetBinsResponse> | Observable<GetBinsResponse> | GetBinsResponse;
+
+  getBin(request: GetBinRequest): Promise<BinResponse> | Observable<BinResponse> | BinResponse;
+
+  getBinsExists(
+    request: GetBinsExistsRequest,
+  ): Promise<GetBinsExistsResponse> | Observable<GetBinsExistsResponse> | GetBinsExistsResponse;
+
+  getAreaCodes(
+    request: GetAreaCodesRequest,
+  ): Promise<GetAreaCodesResponse> | Observable<GetAreaCodesResponse> | GetAreaCodesResponse;
+
+  getRegions(
+    request: GetRegionsRequest,
+  ): Promise<GetRegionsResponse> | Observable<GetRegionsResponse> | GetRegionsResponse;
+}
+
+export function CardServiceControllerMethods() {
+  return function (constructor: Function) {
+    const grpcMethods: string[] = [
+      "getCardProvidersInfo",
+      "createCard",
+      "createCardsBatch",
+      "topupCard",
+      "getTopupFee",
+      "updateAutoTopup",
+      "getAutoTopup",
+      "listCards",
+      "listCardsPaginated",
+      "getCard",
+      "getCardBalance",
+      "getCardTransactions",
+      "getCardAuthTransactions",
+      "getCard3DsCodes",
+      "updateCardStatus",
+      "freezeCard",
+      "unfreezeCard",
+      "deleteCard",
+      "getBins",
+      "getBin",
+      "getBinsExists",
+      "getAreaCodes",
+      "getRegions",
+    ];
+    for (const method of grpcMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcMethod("CardService", method)(constructor.prototype[method], method, descriptor);
+    }
+    const grpcStreamMethods: string[] = [];
+    for (const method of grpcStreamMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcStreamMethod("CardService", method)(constructor.prototype[method], method, descriptor);
+    }
+  };
+}
+
+export const CARD_SERVICE_NAME = "CardService";

package/gen/ledger.ts

@@ -294,6 +294,21 @@ export interface GetBalancesBatchResponse {
   users: UserBalancesRow[];
 }
 
+export interface GetFxRatesUsdRequest {
+}
+
+export interface FxRateUsdRow {
+  asset: string;
+  priceUsd: string;
+}
+
+export interface GetFxRatesUsdResponse {
+  quoteCurrency: string;
+  updatedAt: string;
+  stale: boolean;
+  rates: FxRateUsdRow[];
+}
+
 export interface TransactionFeedItem {
   id: string;
   /** Тип события ленты (строка, см. TransactionFeedType в реализации). */
@@ -450,6 +465,10 @@ export interface LedgerServiceClient {
 
   getBalancesBatch(request: GetBalancesBatchRequest): Observable<GetBalancesBatchResponse>;
 
+  /** Курсы поддерживаемых активов к USD (внешний провайдер, кэш в Ledger); без user_id — публичная справка для UI. */
+
+  getFxRatesUsd(request: GetFxRatesUsdRequest): Observable<GetFxRatesUsdResponse>;
+
   /** Постраничная лента операций пользователя (история для UI); курсор и offset — на усмотрение сервера. */
 
   getTransactionFeed(request: GetTransactionFeedRequest): Observable<GetTransactionFeedResponse>;
@@ -548,6 +567,12 @@ export interface LedgerServiceController {
     request: GetBalancesBatchRequest,
   ): Promise<GetBalancesBatchResponse> | Observable<GetBalancesBatchResponse> | GetBalancesBatchResponse;
 
+  /** Курсы поддерживаемых активов к USD (внешний провайдер, кэш в Ledger); без user_id — публичная справка для UI. */
+
+  getFxRatesUsd(
+    request: GetFxRatesUsdRequest,
+  ): Promise<GetFxRatesUsdResponse> | Observable<GetFxRatesUsdResponse> | GetFxRatesUsdResponse;
+
   /** Постраничная лента операций пользователя (история для UI); курсор и offset — на усмотрение сервера. */
 
   getTransactionFeed(
@@ -583,6 +608,7 @@ export function LedgerServiceControllerMethods() {
       "getBalance",
       "getBalances",
       "getBalancesBatch",
+      "getFxRatesUsd",
       "getTransactionFeed",
       "listTransactions",
       "internalTransfer",

package/package.json

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

package/proto/card.proto

@@ -0,0 +1,360 @@
+syntax = "proto3";
+
+package card.v1;
+
+option csharp_namespace = "Card.V1";
+option java_multiple_files = true;
+option java_package = "com.arbiwallet.card.v1";
+
+service CardService {
+  rpc GetCardProvidersInfo(GetCardProvidersInfoRequest) returns (GetCardProvidersInfoResponse);
+  rpc CreateCard(CreateCardRequest) returns (CardResponse);
+  rpc CreateCardsBatch(CreateCardsBatchRequest) returns (CreateCardsBatchResponse);
+  rpc TopupCard(TopupCardRequest) returns (TopupCardResponse);
+  rpc GetTopupFee(GetTopupFeeRequest) returns (GetTopupFeeResponse);
+  rpc UpdateAutoTopup(UpdateAutoTopupRequest) returns (AutoTopupResponse);
+  rpc GetAutoTopup(GetAutoTopupRequest) returns (AutoTopupResponse);
+
+  rpc ListCards(ListCardsRequest) returns (ListCardsResponse);
+  rpc ListCardsPaginated(ListCardsPaginatedRequest) returns (ListCardsPaginatedResponse);
+  rpc GetCard(GetCardRequest) returns (CardResponse);
+  rpc GetCardBalance(GetCardBalanceRequest) returns (GetCardBalanceResponse);
+
+  rpc GetCardTransactions(GetCardTransactionsRequest) returns (GetCardTransactionsResponse);
+  rpc GetCardAuthTransactions(GetCardAuthTransactionsRequest) returns (GetCardAuthTransactionsResponse);
+  rpc GetCard3dsCodes(GetCard3dsCodesRequest) returns (GetCard3dsCodesResponse);
+
+  rpc UpdateCardStatus(UpdateCardStatusRequest) returns (CardResponse);
+  rpc FreezeCard(CardActionRequest) returns (CardResponse);
+  rpc UnfreezeCard(CardActionRequest) returns (CardResponse);
+  rpc DeleteCard(CardActionRequest) returns (DeleteCardResponse);
+
+  rpc GetBins(GetBinsRequest) returns (GetBinsResponse);
+  rpc GetBin(GetBinRequest) returns (BinResponse);
+  rpc GetBinsExists(GetBinsExistsRequest) returns (GetBinsExistsResponse);
+  rpc GetAreaCodes(GetAreaCodesRequest) returns (GetAreaCodesResponse);
+  rpc GetRegions(GetRegionsRequest) returns (GetRegionsResponse);
+}
+
+enum CardStatus {
+  CARD_STATUS_UNSPECIFIED = 0;
+  CARD_STATUS_CREATED = 1;
+  CARD_STATUS_ACTIVE = 2;
+  CARD_STATUS_FROZEN = 3;
+  CARD_STATUS_BLOCKED = 4;
+  CARD_STATUS_DELETED = 5;
+  CARD_STATUS_ERROR = 6;
+}
+
+message GetCardProvidersInfoRequest {
+  int64 account_id = 1;
+}
+
+message CardProviderInfo {
+  int64 id = 1;
+  string card_type = 2;
+  string currency = 3;
+  string bin = 4;
+  string card_form_factor = 5;
+  bool kyc_required = 6;
+  string init_balance = 7;
+  repeated string regions = 8;
+  repeated string phone_prefixes = 9;
+  string card_region = 10;
+}
+
+message GetCardProvidersInfoResponse {
+  repeated CardProviderInfo providers = 1;
+}
+
+message CreateCardRequest {
+  int64 account_id = 1;
+  string name = 2;
+  string currency = 3;
+  string card_type = 4;
+  bool is_virtual = 5;
+  string bin = 6;
+  string card_holder_name = 7;
+  string phone = 8;
+  string email = 9;
+  string external_uuid = 10;
+  string otp_code = 11;
+  bool is_auto_topup = 12;
+  string auto_top_amount = 13;
+  string auto_topup_limit = 14;
+  string card_balance_threshold = 15;
+}
+
+message CreateCardsBatchRequest {
+  CreateCardRequest template = 1;
+  int32 number_of_cards = 2;
+}
+
+message CreateCardsBatchResponse {
+  repeated CardResponse cards = 1;
+}
+
+message TopupCardRequest {
+  int64 account_id = 1;
+  int64 card_id = 2;
+  string amount = 3;
+  string card_crypto_currency = 4;
+  string otp_code = 5;
+}
+
+message TopupCardResponse {
+  int64 card_id = 1;
+  string currency_credit = 2;
+  string amount_credit = 3;
+  string amount_debit = 4;
+  string currency_debit = 5;
+  string fee = 6;
+  string total_amount = 7;
+}
+
+message GetTopupFeeRequest {
+  int64 account_id = 1;
+  int64 card_id = 2;
+  string amount = 3;
+  string card_crypto_currency = 4;
+}
+
+message GetTopupFeeResponse {
+  int64 card_id = 1;
+  string amount = 2;
+  string card_crypto_currency = 3;
+  string fee_amount = 4;
+  string fee_currency = 5;
+  string card_currency = 6;
+  string amount_to_card = 7;
+}
+
+message UpdateAutoTopupRequest {
+  int64 account_id = 1;
+  int64 card_id = 2;
+  bool is_auto_topup = 3;
+  string auto_top_amount = 4;
+  string auto_topup_limit = 5;
+  string current_auto_topup_amount = 6;
+  string card_balance_threshold = 7;
+}
+
+message GetAutoTopupRequest {
+  int64 account_id = 1;
+  int64 card_id = 2;
+}
+
+message AutoTopupResponse {
+  int64 card_id = 1;
+  bool is_auto_topup = 2;
+  string auto_top_amount = 3;
+  string auto_topup_limit = 4;
+  string current_auto_topup_amount = 5;
+  string card_balance_threshold = 6;
+}
+
+message ListCardsRequest {
+  int64 account_id = 1;
+}
+
+message ListCardsResponse {
+  repeated CardResponse cards = 1;
+}
+
+message ListCardsPaginatedRequest {
+  int64 account_id = 1;
+  int32 page = 2;
+  int32 size = 3;
+}
+
+message ListCardsPaginatedResponse {
+  repeated CardResponse items = 1;
+  int32 total = 2;
+  int32 page = 3;
+  int32 size = 4;
+  int32 pages = 5;
+}
+
+message GetCardRequest {
+  int64 account_id = 1;
+  int64 card_id = 2;
+}
+
+message CardResponse {
+  int64 id = 1;
+  string name = 2;
+  int64 account_id = 3;
+  string balance = 4;
+  string currency = 5;
+  string card_number = 6;
+  int64 issuer_id = 7;
+  string card_type = 8;
+  string cvv = 9;
+  CardStatus status = 10;
+  bool is_virtual = 11;
+  string created_at = 12;
+  string expires_at = 13;
+  string phone = 14;
+  string email = 15;
+  string card_holder_name = 16;
+  string external_uuid = 17;
+  bool is_auto_topup = 18;
+  string auto_top_amount = 19;
+  string auto_topup_limit = 20;
+  string current_auto_topup_amount = 21;
+  string card_balance_threshold = 22;
+}
+
+message GetCardBalanceRequest {
+  int64 account_id = 1;
+  int64 card_id = 2;
+}
+
+message GetCardBalanceResponse {
+  int64 card_id = 1;
+  string balance = 2;
+  string currency = 3;
+}
+
+message GetCardTransactionsRequest {
+  int64 account_id = 1;
+  int64 card_id = 2;
+  int32 pager_offset = 3;
+  int32 pager_size = 4;
+}
+
+message CardTransaction {
+  int64 payment_id = 1;
+  int64 card_id = 2;
+  string card_number = 3;
+  string amount = 4;
+  string card_currency = 5;
+  string operation_type = 6;
+  string status = 7;
+  string created_at = 8;
+}
+
+message Edge {
+  int32 offset = 1;
+  int32 size = 2;
+  int32 total = 3;
+}
+
+message GetCardTransactionsResponse {
+  repeated CardTransaction payments = 1;
+  Edge edge = 2;
+}
+
+message GetCardAuthTransactionsRequest {
+  int64 account_id = 1;
+  int64 card_id = 2;
+  int32 pager_offset = 3;
+  int32 pager_size = 4;
+}
+
+message CardAuthTransaction {
+  int64 id = 1;
+  int64 card_id = 2;
+  string currency = 3;
+  string amount = 4;
+  string authorized_amount = 5;
+  string authorized_currency = 6;
+  string merchant_name = 7;
+  string type = 8;
+  string status = 9;
+  string description = 10;
+  string transaction_time = 11;
+  string settle_date = 12;
+}
+
+message GetCardAuthTransactionsResponse {
+  repeated CardAuthTransaction transactions = 1;
+  Edge edge = 2;
+}
+
+message GetCard3dsCodesRequest {
+  int64 account_id = 1;
+  int64 card_id = 2;
+  int32 pager_offset = 3;
+  int32 pager_size = 4;
+}
+
+message Card3dsInfo {
+  int64 id = 1;
+  int64 card_id = 2;
+  string currency = 3;
+  string amount = 4;
+  string merchant_name = 5;
+  string type = 6;
+  string values = 7;
+  string description = 8;
+  string transaction_time = 9;
+  string expiration_time = 10;
+}
+
+message GetCard3dsCodesResponse {
+  repeated Card3dsInfo card_3ds_info = 1;
+  Edge edge = 2;
+}
+
+message UpdateCardStatusRequest {
+  int64 account_id = 1;
+  int64 card_id = 2;
+  CardStatus status = 3;
+}
+
+message CardActionRequest {
+  int64 account_id = 1;
+  int64 card_id = 2;
+}
+
+message DeleteCardResponse {
+  bool ok = 1;
+}
+
+message GetBinsRequest {
+  int64 account_id = 1;
+}
+
+message GetBinRequest {
+  int64 account_id = 1;
+  string bin = 2;
+}
+
+message GetBinsExistsRequest {
+  int64 account_id = 1;
+}
+
+message GetAreaCodesRequest {
+  int64 account_id = 1;
+  string bin = 2;
+}
+
+message GetRegionsRequest {
+  int64 account_id = 1;
+  string bin = 2;
+}
+
+message BinResponse {
+  string bin = 1;
+  string card_type = 2;
+  string currency = 3;
+  string provider = 4;
+  bool kyc_required = 5;
+}
+
+message GetBinsResponse {
+  repeated BinResponse bins = 1;
+}
+
+message GetBinsExistsResponse {
+  repeated string bins = 1;
+}
+
+message GetAreaCodesResponse {
+  repeated string area_codes = 1;
+}
+
+message GetRegionsResponse {
+  repeated string regions = 1;
+}

package/proto/ledger.proto

@@ -35,6 +35,8 @@ service LedgerService {
   rpc GetBalances(GetBalancesRequest) returns (GetBalancesResponse);
   // Балансовые позиции сразу для массива пользователей.
   rpc GetBalancesBatch(GetBalancesBatchRequest) returns (GetBalancesBatchResponse);
+  // Курсы поддерживаемых активов к USD (внешний провайдер, кэш в Ledger); без user_id — публичная справка для UI.
+  rpc GetFxRatesUsd(GetFxRatesUsdRequest) returns (GetFxRatesUsdResponse);
   // Постраничная лента операций пользователя (история для UI); курсор и offset — на усмотрение сервера.
   rpc GetTransactionFeed(GetTransactionFeedRequest) returns (GetTransactionFeedResponse);
   // Админский список всех транзакций с пагинацией/фильтрами/поиском.
@@ -263,6 +265,20 @@ message GetBalancesBatchResponse {
   repeated UserBalancesRow users = 1;
 }
 
+message GetFxRatesUsdRequest {}
+
+message FxRateUsdRow {
+  string asset = 1;
+  string price_usd = 2;
+}
+
+message GetFxRatesUsdResponse {
+  string quote_currency = 1;
+  string updated_at = 2;
+  bool stale = 3;
+  repeated FxRateUsdRow rates = 4;
+}
+
 message TransactionFeedItem {
   string id = 1;
   string type = 2;                 // Тип события ленты (строка, см. TransactionFeedType в реализации).