@arbiwallet/contracts 1.0.119 → 1.0.121

package/gen/card.ts

@@ -207,7 +207,6 @@ export interface ScanGiftCardQrRequest {
   accountId: number;
   uid: number;
   bin: string;
-  cardHolderName: string;
 }
 
 export interface ScanGiftCardQrResponse {
@@ -308,6 +307,18 @@ export interface GetCardTransactionsResponse {
   edge: Edge | undefined;
 }
 
+export interface SyncRecentUserCardHistoryRequest {
+  accountId: number;
+  size: number;
+  cooldownSeconds: number;
+}
+
+export interface SyncRecentUserCardHistoryResponse {
+  syncedCards: number;
+  skippedCards: number;
+  failedCards: number;
+}
+
 export interface GetCardAuthTransactionsRequest {
   accountId: number;
   cardId: number;
@@ -422,6 +433,20 @@ export interface GetRegionsResponse {
   regions: string[];
 }
 
+export interface HandleBincentricWebhookRequest {
+  rawBody: Uint8Array;
+  webhookTimestamp: string;
+  webhookSignature: string;
+}
+
+export interface HandleBincentricWebhookResponse {
+  ok: boolean;
+  handled: boolean;
+  eventType: string;
+  cardId: number;
+  reason: string;
+}
+
 export const CARD_V1_PACKAGE_NAME = "card.v1";
 
 export interface CardServiceClient {
@@ -453,6 +478,8 @@ export interface CardServiceClient {
 
   getCardTransactions(request: GetCardTransactionsRequest): Observable<GetCardTransactionsResponse>;
 
+  syncRecentUserCardHistory(request: SyncRecentUserCardHistoryRequest): Observable<SyncRecentUserCardHistoryResponse>;
+
   getCardAuthTransactions(request: GetCardAuthTransactionsRequest): Observable<GetCardAuthTransactionsResponse>;
 
   getCard3DsCodes(request: GetCard3dsCodesRequest): Observable<GetCard3dsCodesResponse>;
@@ -474,6 +501,8 @@ export interface CardServiceClient {
   getAreaCodes(request: GetAreaCodesRequest): Observable<GetAreaCodesResponse>;
 
   getRegions(request: GetRegionsRequest): Observable<GetRegionsResponse>;
+
+  handleBincentricWebhook(request: HandleBincentricWebhookRequest): Observable<HandleBincentricWebhookResponse>;
 }
 
 export interface CardServiceController {
@@ -531,6 +560,13 @@ export interface CardServiceController {
     request: GetCardTransactionsRequest,
   ): Promise<GetCardTransactionsResponse> | Observable<GetCardTransactionsResponse> | GetCardTransactionsResponse;
 
+  syncRecentUserCardHistory(
+    request: SyncRecentUserCardHistoryRequest,
+  ):
+    | Promise<SyncRecentUserCardHistoryResponse>
+    | Observable<SyncRecentUserCardHistoryResponse>
+    | SyncRecentUserCardHistoryResponse;
+
   getCardAuthTransactions(
     request: GetCardAuthTransactionsRequest,
   ):
@@ -567,6 +603,13 @@ export interface CardServiceController {
   getRegions(
     request: GetRegionsRequest,
   ): Promise<GetRegionsResponse> | Observable<GetRegionsResponse> | GetRegionsResponse;
+
+  handleBincentricWebhook(
+    request: HandleBincentricWebhookRequest,
+  ):
+    | Promise<HandleBincentricWebhookResponse>
+    | Observable<HandleBincentricWebhookResponse>
+    | HandleBincentricWebhookResponse;
 }
 
 export function CardServiceControllerMethods() {
@@ -586,6 +629,7 @@ export function CardServiceControllerMethods() {
       "getCard",
       "getCardBalance",
       "getCardTransactions",
+      "syncRecentUserCardHistory",
       "getCardAuthTransactions",
       "getCard3DsCodes",
       "updateCardStatus",
@@ -597,6 +641,7 @@ export function CardServiceControllerMethods() {
       "getBinsExists",
       "getAreaCodes",
       "getRegions",
+      "handleBincentricWebhook",
     ];
     for (const method of grpcMethods) {
       const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);

package/gen/ledger.ts

@@ -349,6 +349,7 @@ export interface GetTransactionFeedRequest {
     | undefined;
   /** true: все события по выводу (RESERVED, WITHDRAWAL_STATUS, FINALIZED, …). По умолчанию — одна строка на вывод (последнее событие). */
   expandWithdrawalTimeline?: boolean | undefined;
+  referenceId?: string | undefined;
 }
 
 export interface GetTransactionFeedResponse {
@@ -360,6 +361,20 @@ export interface GetTransactionFeedResponse {
   totalReturned: number;
 }
 
+export interface AppendTransactionFeedItemRequest {
+  userId: string;
+  type: string;
+  asset: string;
+  network: string;
+  amount?: string | undefined;
+  referenceType?: string | undefined;
+  referenceId?: string | undefined;
+  title?: string | undefined;
+  metadataJson?: string | undefined;
+  idempotencyKey: string;
+  createdAt?: string | undefined;
+}
+
 export interface ListTransactionsRequest {
   page?: number | undefined;
   limit?: number | undefined;
@@ -473,6 +488,10 @@ export interface LedgerServiceClient {
 
   getTransactionFeed(request: GetTransactionFeedRequest): Observable<GetTransactionFeedResponse>;
 
+  /** Идемпотентное добавление внешнего события в UI-ленту (например card provider events). */
+
+  appendTransactionFeedItem(request: AppendTransactionFeedItemRequest): Observable<TransactionFeedItem>;
+
   /** Админский список всех транзакций с пагинацией/фильтрами/поиском. */
 
   listTransactions(request: ListTransactionsRequest): Observable<ListTransactionsResponse>;
@@ -579,6 +598,12 @@ export interface LedgerServiceController {
     request: GetTransactionFeedRequest,
   ): Promise<GetTransactionFeedResponse> | Observable<GetTransactionFeedResponse> | GetTransactionFeedResponse;
 
+  /** Идемпотентное добавление внешнего события в UI-ленту (например card provider events). */
+
+  appendTransactionFeedItem(
+    request: AppendTransactionFeedItemRequest,
+  ): Promise<TransactionFeedItem> | Observable<TransactionFeedItem> | TransactionFeedItem;
+
   /** Админский список всех транзакций с пагинацией/фильтрами/поиском. */
 
   listTransactions(
@@ -610,6 +635,7 @@ export function LedgerServiceControllerMethods() {
       "getBalancesBatch",
       "getFxRatesUsd",
       "getTransactionFeed",
+      "appendTransactionFeedItem",
       "listTransactions",
       "internalTransfer",
     ];

package/package.json

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

package/proto/card.proto

@@ -23,6 +23,7 @@ service CardService {
   rpc GetCardBalance(GetCardBalanceRequest) returns (GetCardBalanceResponse);
 
   rpc GetCardTransactions(GetCardTransactionsRequest) returns (GetCardTransactionsResponse);
+  rpc SyncRecentUserCardHistory(SyncRecentUserCardHistoryRequest) returns (SyncRecentUserCardHistoryResponse);
   rpc GetCardAuthTransactions(GetCardAuthTransactionsRequest) returns (GetCardAuthTransactionsResponse);
   rpc GetCard3dsCodes(GetCard3dsCodesRequest) returns (GetCard3dsCodesResponse);
 
@@ -36,6 +37,8 @@ service CardService {
   rpc GetBinsExists(GetBinsExistsRequest) returns (GetBinsExistsResponse);
   rpc GetAreaCodes(GetAreaCodesRequest) returns (GetAreaCodesResponse);
   rpc GetRegions(GetRegionsRequest) returns (GetRegionsResponse);
+
+  rpc HandleBincentricWebhook(HandleBincentricWebhookRequest) returns (HandleBincentricWebhookResponse);
 }
 
 enum CardStatus {
@@ -235,7 +238,6 @@ message ScanGiftCardQrRequest {
   int64 account_id = 1;
   int64 uid = 2;
   string bin = 3;
-  string card_holder_name = 4;
 }
 
 message ScanGiftCardQrResponse {
@@ -336,6 +338,18 @@ message GetCardTransactionsResponse {
   Edge edge = 2;
 }
 
+message SyncRecentUserCardHistoryRequest {
+  int64 account_id = 1;
+  int32 size = 2;
+  int32 cooldown_seconds = 3;
+}
+
+message SyncRecentUserCardHistoryResponse {
+  int32 synced_cards = 1;
+  int32 skipped_cards = 2;
+  int32 failed_cards = 3;
+}
+
 message GetCardAuthTransactionsRequest {
   int64 account_id = 1;
   int64 card_id = 2;
@@ -449,3 +463,17 @@ message GetAreaCodesResponse {
 message GetRegionsResponse {
   repeated string regions = 1;
 }
+
+message HandleBincentricWebhookRequest {
+  bytes raw_body = 1;
+  string webhook_timestamp = 2;
+  string webhook_signature = 3;
+}
+
+message HandleBincentricWebhookResponse {
+  bool ok = 1;
+  bool handled = 2;
+  string event_type = 3;
+  int64 card_id = 4;
+  string reason = 5;
+}

package/proto/ledger.proto

@@ -39,6 +39,8 @@ service LedgerService {
   rpc GetFxRatesUsd(GetFxRatesUsdRequest) returns (GetFxRatesUsdResponse);
   // Постраничная лента операций пользователя (история для UI); курсор и offset — на усмотрение сервера.
   rpc GetTransactionFeed(GetTransactionFeedRequest) returns (GetTransactionFeedResponse);
+  // Идемпотентное добавление внешнего события в UI-ленту (например card provider events).
+  rpc AppendTransactionFeedItem(AppendTransactionFeedItemRequest) returns (TransactionFeedItem);
   // Админский список всех транзакций с пагинацией/фильтрами/поиском.
   rpc ListTransactions(ListTransactionsRequest) returns (ListTransactionsResponse);
   // Внутренний перевод между пользователями приложения (только ledger, без сетевой комиссии).
@@ -304,6 +306,7 @@ message GetTransactionFeedRequest {
   optional string reference_kind = 7;
   // true: все события по выводу (RESERVED, WITHDRAWAL_STATUS, FINALIZED, …). По умолчанию — одна строка на вывод (последнее событие).
   optional bool expand_withdrawal_timeline = 8;
+  optional string reference_id = 9;
 }
 
 message GetTransactionFeedResponse {
@@ -312,6 +315,20 @@ message GetTransactionFeedResponse {
   int32 total_returned = 3;        // Число элементов в этом ответе.
 }
 
+message AppendTransactionFeedItemRequest {
+  string user_id = 1;
+  string type = 2;
+  string asset = 3;
+  string network = 4;
+  optional string amount = 5;
+  optional string reference_type = 6;
+  optional string reference_id = 7;
+  optional string title = 8;
+  optional string metadata_json = 9;
+  string idempotency_key = 10;
+  optional string created_at = 11;
+}
+
 enum TransactionSortBy {
   TRANSACTION_SORT_BY_CREATED_AT = 0;
   TRANSACTION_SORT_BY_TYPE = 1;