protobuf-platform 1.2.719 → 1.2.721

package/bonus/bonus.proto

@@ -44,6 +44,8 @@ service Bonus {
     rpc getCommonUserBonusItems(GetCommonUserBonusItemsRequest) returns (GetCommonUserBonusItemsResponse);
     // Validates one selected wagering user bonus for a game wager list and balance type; returns authoritative state for game-service Redis snapshot.
     rpc validateSelectedWageringUserBonus(ValidateSelectedWageringUserBonusRequest) returns (ValidateSelectedWageringUserBonusResponse);
+    // Resolve a durable provider reward identity before any winnings wallet mutation.
+    rpc resolveProviderRewardWinnings(ResolveProviderRewardWinningsRequest) returns (ResolveProviderRewardWinningsResponse);
     //Common lists
     rpc readListBonusTypes(PaginationRequest) returns (BonusTypesResponse);
     rpc readListBonusStatuses(PaginationRequest) returns (BonusStatusesResponse);
@@ -760,3 +762,26 @@ message BonusClaimedEvent {
     optional string request_id = 12;
     optional bool admin_initiated = 13;
 }
+
+// Authoritative provider units, never account/session-converted values.
+message ResolveProviderRewardWinningsRequest {
+    int64 user_id = 1;
+    string provider_reward_id = 2;
+    string provider_transaction_id = 3;
+    string provider_currency = 4;
+    uint32 provider_currency_scale = 5;
+    string provider_amount_minor = 6;
+}
+
+message ResolveProviderRewardWinningsResponse {
+    // Explicit "legacy" or "normalized". Empty/unknown is not legacy.
+    string mode = 1;
+    optional int64 user_bonus_id = 2;
+    optional string currency = 3;
+    optional uint32 currency_scale = 4;
+    optional string amount_minor = 5;
+    // Versioned audit: explicit frozen pair/rate/scales, original and normalized
+    // minor amounts, UserBonus/snapshot and provider reward/transaction identity.
+    // Required for normalized; missing data must fail closed without session FX.
+    optional string provider_winnings_fx_json = 6;
+}

package/bonus/bonus_grpc_pb.js

@@ -478,6 +478,28 @@ function deserialize_bonus_PongResponse(buffer_arg) {
   return bonus_bonus_pb.PongResponse.deserializeBinary(new Uint8Array(buffer_arg));
 }
 
+function serialize_bonus_ResolveProviderRewardWinningsRequest(arg) {
+  if (!(arg instanceof bonus_bonus_pb.ResolveProviderRewardWinningsRequest)) {
+    throw new Error('Expected argument of type bonus.ResolveProviderRewardWinningsRequest');
+  }
+  return Buffer.from(arg.serializeBinary());
+}
+
+function deserialize_bonus_ResolveProviderRewardWinningsRequest(buffer_arg) {
+  return bonus_bonus_pb.ResolveProviderRewardWinningsRequest.deserializeBinary(new Uint8Array(buffer_arg));
+}
+
+function serialize_bonus_ResolveProviderRewardWinningsResponse(arg) {
+  if (!(arg instanceof bonus_bonus_pb.ResolveProviderRewardWinningsResponse)) {
+    throw new Error('Expected argument of type bonus.ResolveProviderRewardWinningsResponse');
+  }
+  return Buffer.from(arg.serializeBinary());
+}
+
+function deserialize_bonus_ResolveProviderRewardWinningsResponse(buffer_arg) {
+  return bonus_bonus_pb.ResolveProviderRewardWinningsResponse.deserializeBinary(new Uint8Array(buffer_arg));
+}
+
 function serialize_bonus_SingleBonusResponse(arg) {
   if (!(arg instanceof bonus_bonus_pb.SingleBonusResponse)) {
     throw new Error('Expected argument of type bonus.SingleBonusResponse');
@@ -936,6 +958,18 @@ validateSelectedWageringUserBonus: {
     responseSerialize: serialize_bonus_ValidateSelectedWageringUserBonusResponse,
     responseDeserialize: deserialize_bonus_ValidateSelectedWageringUserBonusResponse,
   },
+  // Resolve a durable provider reward identity before any winnings wallet mutation.
+resolveProviderRewardWinnings: {
+    path: '/bonus.Bonus/resolveProviderRewardWinnings',
+    requestStream: false,
+    responseStream: false,
+    requestType: bonus_bonus_pb.ResolveProviderRewardWinningsRequest,
+    responseType: bonus_bonus_pb.ResolveProviderRewardWinningsResponse,
+    requestSerialize: serialize_bonus_ResolveProviderRewardWinningsRequest,
+    requestDeserialize: deserialize_bonus_ResolveProviderRewardWinningsRequest,
+    responseSerialize: serialize_bonus_ResolveProviderRewardWinningsResponse,
+    responseDeserialize: deserialize_bonus_ResolveProviderRewardWinningsResponse,
+  },
   // Common lists
 readListBonusTypes: {
     path: '/bonus.Bonus/readListBonusTypes',

package/bonus/bonus_pb.js

@@ -87,6 +87,8 @@ goog.exportSymbol('proto.bonus.ListSignUpBonusesResponse', null, global);
 goog.exportSymbol('proto.bonus.PaginationRequest', null, global);
 goog.exportSymbol('proto.bonus.PingRequest', null, global);
 goog.exportSymbol('proto.bonus.PongResponse', null, global);
+goog.exportSymbol('proto.bonus.ResolveProviderRewardWinningsRequest', null, global);
+goog.exportSymbol('proto.bonus.ResolveProviderRewardWinningsResponse', null, global);
 goog.exportSymbol('proto.bonus.SearchBonusRequest', null, global);
 goog.exportSymbol('proto.bonus.SignUpBonusListItem', null, global);
 goog.exportSymbol('proto.bonus.SingleBonusItem', null, global);
@@ -1587,6 +1589,48 @@ if (goog.DEBUG && !COMPILED) {
    */
   proto.bonus.BonusClaimedEvent.displayName = 'proto.bonus.BonusClaimedEvent';
 }
+/**
+ * Generated by JsPbCodeGenerator.
+ * @param {Array=} opt_data Optional initial data array, typically from a
+ * server response, or constructed directly in Javascript. The array is used
+ * in place and becomes part of the constructed object. It is not cloned.
+ * If no data is provided, the constructed object will be empty, but still
+ * valid.
+ * @extends {jspb.Message}
+ * @constructor
+ */
+proto.bonus.ResolveProviderRewardWinningsRequest = function(opt_data) {
+  jspb.Message.initialize(this, opt_data, 0, -1, null, null);
+};
+goog.inherits(proto.bonus.ResolveProviderRewardWinningsRequest, jspb.Message);
+if (goog.DEBUG && !COMPILED) {
+  /**
+   * @public
+   * @override
+   */
+  proto.bonus.ResolveProviderRewardWinningsRequest.displayName = 'proto.bonus.ResolveProviderRewardWinningsRequest';
+}
+/**
+ * Generated by JsPbCodeGenerator.
+ * @param {Array=} opt_data Optional initial data array, typically from a
+ * server response, or constructed directly in Javascript. The array is used
+ * in place and becomes part of the constructed object. It is not cloned.
+ * If no data is provided, the constructed object will be empty, but still
+ * valid.
+ * @extends {jspb.Message}
+ * @constructor
+ */
+proto.bonus.ResolveProviderRewardWinningsResponse = function(opt_data) {
+  jspb.Message.initialize(this, opt_data, 0, -1, null, null);
+};
+goog.inherits(proto.bonus.ResolveProviderRewardWinningsResponse, jspb.Message);
+if (goog.DEBUG && !COMPILED) {
+  /**
+   * @public
+   * @override
+   */
+  proto.bonus.ResolveProviderRewardWinningsResponse.displayName = 'proto.bonus.ResolveProviderRewardWinningsResponse';
+}
 
 
 
@@ -31215,4 +31259,654 @@ proto.bonus.BonusClaimedEvent.prototype.hasAdminInitiated = function() {
 };
 
 
+
+
+
+if (jspb.Message.GENERATE_TO_OBJECT) {
+/**
+ * Creates an object representation of this proto.
+ * Field names that are reserved in JavaScript and will be renamed to pb_name.
+ * Optional fields that are not set will be set to undefined.
+ * To access a reserved field use, foo.pb_<name>, eg, foo.pb_default.
+ * For the list of reserved names please see:
+ *     net/proto2/compiler/js/internal/generator.cc#kKeyword.
+ * @param {boolean=} opt_includeInstance Deprecated. whether to include the
+ *     JSPB instance for transitional soy proto support:
+ *     http://goto/soy-param-migration
+ * @return {!Object}
+ */
+proto.bonus.ResolveProviderRewardWinningsRequest.prototype.toObject = function(opt_includeInstance) {
+  return proto.bonus.ResolveProviderRewardWinningsRequest.toObject(opt_includeInstance, this);
+};
+
+
+/**
+ * Static version of the {@see toObject} method.
+ * @param {boolean|undefined} includeInstance Deprecated. Whether to include
+ *     the JSPB instance for transitional soy proto support:
+ *     http://goto/soy-param-migration
+ * @param {!proto.bonus.ResolveProviderRewardWinningsRequest} msg The msg instance to transform.
+ * @return {!Object}
+ * @suppress {unusedLocalVariables} f is only used for nested messages
+ */
+proto.bonus.ResolveProviderRewardWinningsRequest.toObject = function(includeInstance, msg) {
+  var f, obj = {
+    userId: jspb.Message.getFieldWithDefault(msg, 1, 0),
+    providerRewardId: jspb.Message.getFieldWithDefault(msg, 2, ""),
+    providerTransactionId: jspb.Message.getFieldWithDefault(msg, 3, ""),
+    providerCurrency: jspb.Message.getFieldWithDefault(msg, 4, ""),
+    providerCurrencyScale: jspb.Message.getFieldWithDefault(msg, 5, 0),
+    providerAmountMinor: jspb.Message.getFieldWithDefault(msg, 6, "")
+  };
+
+  if (includeInstance) {
+    obj.$jspbMessageInstance = msg;
+  }
+  return obj;
+};
+}
+
+
+/**
+ * Deserializes binary data (in protobuf wire format).
+ * @param {jspb.ByteSource} bytes The bytes to deserialize.
+ * @return {!proto.bonus.ResolveProviderRewardWinningsRequest}
+ */
+proto.bonus.ResolveProviderRewardWinningsRequest.deserializeBinary = function(bytes) {
+  var reader = new jspb.BinaryReader(bytes);
+  var msg = new proto.bonus.ResolveProviderRewardWinningsRequest;
+  return proto.bonus.ResolveProviderRewardWinningsRequest.deserializeBinaryFromReader(msg, reader);
+};
+
+
+/**
+ * Deserializes binary data (in protobuf wire format) from the
+ * given reader into the given message object.
+ * @param {!proto.bonus.ResolveProviderRewardWinningsRequest} msg The message object to deserialize into.
+ * @param {!jspb.BinaryReader} reader The BinaryReader to use.
+ * @return {!proto.bonus.ResolveProviderRewardWinningsRequest}
+ */
+proto.bonus.ResolveProviderRewardWinningsRequest.deserializeBinaryFromReader = function(msg, reader) {
+  while (reader.nextField()) {
+    if (reader.isEndGroup()) {
+      break;
+    }
+    var field = reader.getFieldNumber();
+    switch (field) {
+    case 1:
+      var value = /** @type {number} */ (reader.readInt64());
+      msg.setUserId(value);
+      break;
+    case 2:
+      var value = /** @type {string} */ (reader.readString());
+      msg.setProviderRewardId(value);
+      break;
+    case 3:
+      var value = /** @type {string} */ (reader.readString());
+      msg.setProviderTransactionId(value);
+      break;
+    case 4:
+      var value = /** @type {string} */ (reader.readString());
+      msg.setProviderCurrency(value);
+      break;
+    case 5:
+      var value = /** @type {number} */ (reader.readUint32());
+      msg.setProviderCurrencyScale(value);
+      break;
+    case 6:
+      var value = /** @type {string} */ (reader.readString());
+      msg.setProviderAmountMinor(value);
+      break;
+    default:
+      reader.skipField();
+      break;
+    }
+  }
+  return msg;
+};
+
+
+/**
+ * Serializes the message to binary data (in protobuf wire format).
+ * @return {!Uint8Array}
+ */
+proto.bonus.ResolveProviderRewardWinningsRequest.prototype.serializeBinary = function() {
+  var writer = new jspb.BinaryWriter();
+  proto.bonus.ResolveProviderRewardWinningsRequest.serializeBinaryToWriter(this, writer);
+  return writer.getResultBuffer();
+};
+
+
+/**
+ * Serializes the given message to binary data (in protobuf wire
+ * format), writing to the given BinaryWriter.
+ * @param {!proto.bonus.ResolveProviderRewardWinningsRequest} message
+ * @param {!jspb.BinaryWriter} writer
+ * @suppress {unusedLocalVariables} f is only used for nested messages
+ */
+proto.bonus.ResolveProviderRewardWinningsRequest.serializeBinaryToWriter = function(message, writer) {
+  var f = undefined;
+  f = message.getUserId();
+  if (f !== 0) {
+    writer.writeInt64(
+      1,
+      f
+    );
+  }
+  f = message.getProviderRewardId();
+  if (f.length > 0) {
+    writer.writeString(
+      2,
+      f
+    );
+  }
+  f = message.getProviderTransactionId();
+  if (f.length > 0) {
+    writer.writeString(
+      3,
+      f
+    );
+  }
+  f = message.getProviderCurrency();
+  if (f.length > 0) {
+    writer.writeString(
+      4,
+      f
+    );
+  }
+  f = message.getProviderCurrencyScale();
+  if (f !== 0) {
+    writer.writeUint32(
+      5,
+      f
+    );
+  }
+  f = message.getProviderAmountMinor();
+  if (f.length > 0) {
+    writer.writeString(
+      6,
+      f
+    );
+  }
+};
+
+
+/**
+ * optional int64 user_id = 1;
+ * @return {number}
+ */
+proto.bonus.ResolveProviderRewardWinningsRequest.prototype.getUserId = function() {
+  return /** @type {number} */ (jspb.Message.getFieldWithDefault(this, 1, 0));
+};
+
+
+/**
+ * @param {number} value
+ * @return {!proto.bonus.ResolveProviderRewardWinningsRequest} returns this
+ */
+proto.bonus.ResolveProviderRewardWinningsRequest.prototype.setUserId = function(value) {
+  return jspb.Message.setProto3IntField(this, 1, value);
+};
+
+
+/**
+ * optional string provider_reward_id = 2;
+ * @return {string}
+ */
+proto.bonus.ResolveProviderRewardWinningsRequest.prototype.getProviderRewardId = function() {
+  return /** @type {string} */ (jspb.Message.getFieldWithDefault(this, 2, ""));
+};
+
+
+/**
+ * @param {string} value
+ * @return {!proto.bonus.ResolveProviderRewardWinningsRequest} returns this
+ */
+proto.bonus.ResolveProviderRewardWinningsRequest.prototype.setProviderRewardId = function(value) {
+  return jspb.Message.setProto3StringField(this, 2, value);
+};
+
+
+/**
+ * optional string provider_transaction_id = 3;
+ * @return {string}
+ */
+proto.bonus.ResolveProviderRewardWinningsRequest.prototype.getProviderTransactionId = function() {
+  return /** @type {string} */ (jspb.Message.getFieldWithDefault(this, 3, ""));
+};
+
+
+/**
+ * @param {string} value
+ * @return {!proto.bonus.ResolveProviderRewardWinningsRequest} returns this
+ */
+proto.bonus.ResolveProviderRewardWinningsRequest.prototype.setProviderTransactionId = function(value) {
+  return jspb.Message.setProto3StringField(this, 3, value);
+};
+
+
+/**
+ * optional string provider_currency = 4;
+ * @return {string}
+ */
+proto.bonus.ResolveProviderRewardWinningsRequest.prototype.getProviderCurrency = function() {
+  return /** @type {string} */ (jspb.Message.getFieldWithDefault(this, 4, ""));
+};
+
+
+/**
+ * @param {string} value
+ * @return {!proto.bonus.ResolveProviderRewardWinningsRequest} returns this
+ */
+proto.bonus.ResolveProviderRewardWinningsRequest.prototype.setProviderCurrency = function(value) {
+  return jspb.Message.setProto3StringField(this, 4, value);
+};
+
+
+/**
+ * optional uint32 provider_currency_scale = 5;
+ * @return {number}
+ */
+proto.bonus.ResolveProviderRewardWinningsRequest.prototype.getProviderCurrencyScale = function() {
+  return /** @type {number} */ (jspb.Message.getFieldWithDefault(this, 5, 0));
+};
+
+
+/**
+ * @param {number} value
+ * @return {!proto.bonus.ResolveProviderRewardWinningsRequest} returns this
+ */
+proto.bonus.ResolveProviderRewardWinningsRequest.prototype.setProviderCurrencyScale = function(value) {
+  return jspb.Message.setProto3IntField(this, 5, value);
+};
+
+
+/**
+ * optional string provider_amount_minor = 6;
+ * @return {string}
+ */
+proto.bonus.ResolveProviderRewardWinningsRequest.prototype.getProviderAmountMinor = function() {
+  return /** @type {string} */ (jspb.Message.getFieldWithDefault(this, 6, ""));
+};
+
+
+/**
+ * @param {string} value
+ * @return {!proto.bonus.ResolveProviderRewardWinningsRequest} returns this
+ */
+proto.bonus.ResolveProviderRewardWinningsRequest.prototype.setProviderAmountMinor = function(value) {
+  return jspb.Message.setProto3StringField(this, 6, value);
+};
+
+
+
+
+
+if (jspb.Message.GENERATE_TO_OBJECT) {
+/**
+ * Creates an object representation of this proto.
+ * Field names that are reserved in JavaScript and will be renamed to pb_name.
+ * Optional fields that are not set will be set to undefined.
+ * To access a reserved field use, foo.pb_<name>, eg, foo.pb_default.
+ * For the list of reserved names please see:
+ *     net/proto2/compiler/js/internal/generator.cc#kKeyword.
+ * @param {boolean=} opt_includeInstance Deprecated. whether to include the
+ *     JSPB instance for transitional soy proto support:
+ *     http://goto/soy-param-migration
+ * @return {!Object}
+ */
+proto.bonus.ResolveProviderRewardWinningsResponse.prototype.toObject = function(opt_includeInstance) {
+  return proto.bonus.ResolveProviderRewardWinningsResponse.toObject(opt_includeInstance, this);
+};
+
+
+/**
+ * Static version of the {@see toObject} method.
+ * @param {boolean|undefined} includeInstance Deprecated. Whether to include
+ *     the JSPB instance for transitional soy proto support:
+ *     http://goto/soy-param-migration
+ * @param {!proto.bonus.ResolveProviderRewardWinningsResponse} msg The msg instance to transform.
+ * @return {!Object}
+ * @suppress {unusedLocalVariables} f is only used for nested messages
+ */
+proto.bonus.ResolveProviderRewardWinningsResponse.toObject = function(includeInstance, msg) {
+  var f, obj = {
+    mode: jspb.Message.getFieldWithDefault(msg, 1, ""),
+    userBonusId: jspb.Message.getFieldWithDefault(msg, 2, 0),
+    currency: jspb.Message.getFieldWithDefault(msg, 3, ""),
+    currencyScale: jspb.Message.getFieldWithDefault(msg, 4, 0),
+    amountMinor: jspb.Message.getFieldWithDefault(msg, 5, ""),
+    providerWinningsFxJson: jspb.Message.getFieldWithDefault(msg, 6, "")
+  };
+
+  if (includeInstance) {
+    obj.$jspbMessageInstance = msg;
+  }
+  return obj;
+};
+}
+
+
+/**
+ * Deserializes binary data (in protobuf wire format).
+ * @param {jspb.ByteSource} bytes The bytes to deserialize.
+ * @return {!proto.bonus.ResolveProviderRewardWinningsResponse}
+ */
+proto.bonus.ResolveProviderRewardWinningsResponse.deserializeBinary = function(bytes) {
+  var reader = new jspb.BinaryReader(bytes);
+  var msg = new proto.bonus.ResolveProviderRewardWinningsResponse;
+  return proto.bonus.ResolveProviderRewardWinningsResponse.deserializeBinaryFromReader(msg, reader);
+};
+
+
+/**
+ * Deserializes binary data (in protobuf wire format) from the
+ * given reader into the given message object.
+ * @param {!proto.bonus.ResolveProviderRewardWinningsResponse} msg The message object to deserialize into.
+ * @param {!jspb.BinaryReader} reader The BinaryReader to use.
+ * @return {!proto.bonus.ResolveProviderRewardWinningsResponse}
+ */
+proto.bonus.ResolveProviderRewardWinningsResponse.deserializeBinaryFromReader = function(msg, reader) {
+  while (reader.nextField()) {
+    if (reader.isEndGroup()) {
+      break;
+    }
+    var field = reader.getFieldNumber();
+    switch (field) {
+    case 1:
+      var value = /** @type {string} */ (reader.readString());
+      msg.setMode(value);
+      break;
+    case 2:
+      var value = /** @type {number} */ (reader.readInt64());
+      msg.setUserBonusId(value);
+      break;
+    case 3:
+      var value = /** @type {string} */ (reader.readString());
+      msg.setCurrency(value);
+      break;
+    case 4:
+      var value = /** @type {number} */ (reader.readUint32());
+      msg.setCurrencyScale(value);
+      break;
+    case 5:
+      var value = /** @type {string} */ (reader.readString());
+      msg.setAmountMinor(value);
+      break;
+    case 6:
+      var value = /** @type {string} */ (reader.readString());
+      msg.setProviderWinningsFxJson(value);
+      break;
+    default:
+      reader.skipField();
+      break;
+    }
+  }
+  return msg;
+};
+
+
+/**
+ * Serializes the message to binary data (in protobuf wire format).
+ * @return {!Uint8Array}
+ */
+proto.bonus.ResolveProviderRewardWinningsResponse.prototype.serializeBinary = function() {
+  var writer = new jspb.BinaryWriter();
+  proto.bonus.ResolveProviderRewardWinningsResponse.serializeBinaryToWriter(this, writer);
+  return writer.getResultBuffer();
+};
+
+
+/**
+ * Serializes the given message to binary data (in protobuf wire
+ * format), writing to the given BinaryWriter.
+ * @param {!proto.bonus.ResolveProviderRewardWinningsResponse} message
+ * @param {!jspb.BinaryWriter} writer
+ * @suppress {unusedLocalVariables} f is only used for nested messages
+ */
+proto.bonus.ResolveProviderRewardWinningsResponse.serializeBinaryToWriter = function(message, writer) {
+  var f = undefined;
+  f = message.getMode();
+  if (f.length > 0) {
+    writer.writeString(
+      1,
+      f
+    );
+  }
+  f = /** @type {number} */ (jspb.Message.getField(message, 2));
+  if (f != null) {
+    writer.writeInt64(
+      2,
+      f
+    );
+  }
+  f = /** @type {string} */ (jspb.Message.getField(message, 3));
+  if (f != null) {
+    writer.writeString(
+      3,
+      f
+    );
+  }
+  f = /** @type {number} */ (jspb.Message.getField(message, 4));
+  if (f != null) {
+    writer.writeUint32(
+      4,
+      f
+    );
+  }
+  f = /** @type {string} */ (jspb.Message.getField(message, 5));
+  if (f != null) {
+    writer.writeString(
+      5,
+      f
+    );
+  }
+  f = /** @type {string} */ (jspb.Message.getField(message, 6));
+  if (f != null) {
+    writer.writeString(
+      6,
+      f
+    );
+  }
+};
+
+
+/**
+ * optional string mode = 1;
+ * @return {string}
+ */
+proto.bonus.ResolveProviderRewardWinningsResponse.prototype.getMode = function() {
+  return /** @type {string} */ (jspb.Message.getFieldWithDefault(this, 1, ""));
+};
+
+
+/**
+ * @param {string} value
+ * @return {!proto.bonus.ResolveProviderRewardWinningsResponse} returns this
+ */
+proto.bonus.ResolveProviderRewardWinningsResponse.prototype.setMode = function(value) {
+  return jspb.Message.setProto3StringField(this, 1, value);
+};
+
+
+/**
+ * optional int64 user_bonus_id = 2;
+ * @return {number}
+ */
+proto.bonus.ResolveProviderRewardWinningsResponse.prototype.getUserBonusId = function() {
+  return /** @type {number} */ (jspb.Message.getFieldWithDefault(this, 2, 0));
+};
+
+
+/**
+ * @param {number} value
+ * @return {!proto.bonus.ResolveProviderRewardWinningsResponse} returns this
+ */
+proto.bonus.ResolveProviderRewardWinningsResponse.prototype.setUserBonusId = function(value) {
+  return jspb.Message.setField(this, 2, value);
+};
+
+
+/**
+ * Clears the field making it undefined.
+ * @return {!proto.bonus.ResolveProviderRewardWinningsResponse} returns this
+ */
+proto.bonus.ResolveProviderRewardWinningsResponse.prototype.clearUserBonusId = function() {
+  return jspb.Message.setField(this, 2, undefined);
+};
+
+
+/**
+ * Returns whether this field is set.
+ * @return {boolean}
+ */
+proto.bonus.ResolveProviderRewardWinningsResponse.prototype.hasUserBonusId = function() {
+  return jspb.Message.getField(this, 2) != null;
+};
+
+
+/**
+ * optional string currency = 3;
+ * @return {string}
+ */
+proto.bonus.ResolveProviderRewardWinningsResponse.prototype.getCurrency = function() {
+  return /** @type {string} */ (jspb.Message.getFieldWithDefault(this, 3, ""));
+};
+
+
+/**
+ * @param {string} value
+ * @return {!proto.bonus.ResolveProviderRewardWinningsResponse} returns this
+ */
+proto.bonus.ResolveProviderRewardWinningsResponse.prototype.setCurrency = function(value) {
+  return jspb.Message.setField(this, 3, value);
+};
+
+
+/**
+ * Clears the field making it undefined.
+ * @return {!proto.bonus.ResolveProviderRewardWinningsResponse} returns this
+ */
+proto.bonus.ResolveProviderRewardWinningsResponse.prototype.clearCurrency = function() {
+  return jspb.Message.setField(this, 3, undefined);
+};
+
+
+/**
+ * Returns whether this field is set.
+ * @return {boolean}
+ */
+proto.bonus.ResolveProviderRewardWinningsResponse.prototype.hasCurrency = function() {
+  return jspb.Message.getField(this, 3) != null;
+};
+
+
+/**
+ * optional uint32 currency_scale = 4;
+ * @return {number}
+ */
+proto.bonus.ResolveProviderRewardWinningsResponse.prototype.getCurrencyScale = function() {
+  return /** @type {number} */ (jspb.Message.getFieldWithDefault(this, 4, 0));
+};
+
+
+/**
+ * @param {number} value
+ * @return {!proto.bonus.ResolveProviderRewardWinningsResponse} returns this
+ */
+proto.bonus.ResolveProviderRewardWinningsResponse.prototype.setCurrencyScale = function(value) {
+  return jspb.Message.setField(this, 4, value);
+};
+
+
+/**
+ * Clears the field making it undefined.
+ * @return {!proto.bonus.ResolveProviderRewardWinningsResponse} returns this
+ */
+proto.bonus.ResolveProviderRewardWinningsResponse.prototype.clearCurrencyScale = function() {
+  return jspb.Message.setField(this, 4, undefined);
+};
+
+
+/**
+ * Returns whether this field is set.
+ * @return {boolean}
+ */
+proto.bonus.ResolveProviderRewardWinningsResponse.prototype.hasCurrencyScale = function() {
+  return jspb.Message.getField(this, 4) != null;
+};
+
+
+/**
+ * optional string amount_minor = 5;
+ * @return {string}
+ */
+proto.bonus.ResolveProviderRewardWinningsResponse.prototype.getAmountMinor = function() {
+  return /** @type {string} */ (jspb.Message.getFieldWithDefault(this, 5, ""));
+};
+
+
+/**
+ * @param {string} value
+ * @return {!proto.bonus.ResolveProviderRewardWinningsResponse} returns this
+ */
+proto.bonus.ResolveProviderRewardWinningsResponse.prototype.setAmountMinor = function(value) {
+  return jspb.Message.setField(this, 5, value);
+};
+
+
+/**
+ * Clears the field making it undefined.
+ * @return {!proto.bonus.ResolveProviderRewardWinningsResponse} returns this
+ */
+proto.bonus.ResolveProviderRewardWinningsResponse.prototype.clearAmountMinor = function() {
+  return jspb.Message.setField(this, 5, undefined);
+};
+
+
+/**
+ * Returns whether this field is set.
+ * @return {boolean}
+ */
+proto.bonus.ResolveProviderRewardWinningsResponse.prototype.hasAmountMinor = function() {
+  return jspb.Message.getField(this, 5) != null;
+};
+
+
+/**
+ * optional string provider_winnings_fx_json = 6;
+ * @return {string}
+ */
+proto.bonus.ResolveProviderRewardWinningsResponse.prototype.getProviderWinningsFxJson = function() {
+  return /** @type {string} */ (jspb.Message.getFieldWithDefault(this, 6, ""));
+};
+
+
+/**
+ * @param {string} value
+ * @return {!proto.bonus.ResolveProviderRewardWinningsResponse} returns this
+ */
+proto.bonus.ResolveProviderRewardWinningsResponse.prototype.setProviderWinningsFxJson = function(value) {
+  return jspb.Message.setField(this, 6, value);
+};
+
+
+/**
+ * Clears the field making it undefined.
+ * @return {!proto.bonus.ResolveProviderRewardWinningsResponse} returns this
+ */
+proto.bonus.ResolveProviderRewardWinningsResponse.prototype.clearProviderWinningsFxJson = function() {
+  return jspb.Message.setField(this, 6, undefined);
+};
+
+
+/**
+ * Returns whether this field is set.
+ * @return {boolean}
+ */
+proto.bonus.ResolveProviderRewardWinningsResponse.prototype.hasProviderWinningsFxJson = function() {
+  return jspb.Message.getField(this, 6) != null;
+};
+
+
 goog.object.extend(exports, proto.bonus);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "protobuf-platform",
-  "version": "1.2.719",
+  "version": "1.2.721",
   "description": "Protobuf structures",
   "main": "index.js",
   "scripts": {

package/scripts/verify-canonical-rg-receipt.js

@@ -0,0 +1,38 @@
+'use strict';
+const assert = require('node:assert/strict');
+const M = require('../user/user_pb');
+const T = M.PrecisionRgAdmissionResponse;
+const absent = T.deserializeBinary(new T().serializeBinary());
+assert.equal(absent.hasCanonicalReceiptJson(), false);
+assert.equal(absent.getCanonicalReceiptJson(), '');
+const response = new T();
+response.setCurrentGeneration('9007199254740993');
+response.setAdmissionReceiptId('initial-receipt');
+response.setCanonicalReceiptJson('');
+assert.equal(T.deserializeBinary(response.serializeBinary()).hasCanonicalReceiptJson(), true);
+const packet = { protocolVersion: 2, version: 1, state: 'RESERVED', decision: { allowed: true, evaluatedAt: '2026-11-03T00:00:00.000Z', details: { time_deltas_seconds: {} } } };
+const exact = JSON.stringify(packet);
+response.setCanonicalReceiptJson(exact);
+const decoded = T.deserializeBinary(response.serializeBinary());
+assert.equal(decoded.getCanonicalReceiptJson(), exact);
+assert.equal(decoded.getCurrentGeneration(), '9007199254740993');
+assert.equal(decoded.getAdmissionReceiptId(), 'initial-receipt');
+decoded.clearCanonicalReceiptJson();
+assert.equal(T.deserializeBinary(decoded.serializeBinary()).hasCanonicalReceiptJson(), false);
+console.log('PASS: canonical RG receipt optional presence and lossless JSON wire value; existing fields unchanged');
+const fs = require('node:fs');
+const vm = require('node:vm');
+const { execFileSync } = require('node:child_process');
+const baseline = '7e5f089e5a223061058ad607b7809b89bd3f1282';
+const readOld = (file) => execFileSync('git', ['show', `${baseline}:${file}`], { encoding: 'utf8', maxBuffer: 16 * 1024 * 1024 });
+const source = fs.readFileSync(require('node:path').join(__dirname, '../user/user.proto'), 'utf8');
+assert.equal(source.replace('    // Exact persisted initial SQL-v2 receipt; absent when no initial receipt exists.\n    optional string canonical_receipt_json = 9;\n', ''), readOld('user/user.proto'));
+const sandbox = { exports: {}, require, console };
+vm.runInNewContext(readOld('user/user_pb.js'), sandbox);
+const Old = sandbox.exports.PrecisionRgAdmissionResponse;
+const oldReadsNew = Old.deserializeBinary(response.serializeBinary());
+assert.equal(oldReadsNew.getAdmissionReceiptId(), 'initial-receipt');
+assert.equal(oldReadsNew.getCurrentGeneration(), '9007199254740993');
+assert.equal(T.deserializeBinary(oldReadsNew.serializeBinary()).hasCanonicalReceiptJson(), false);
+assert.equal(T.deserializeBinary(new Old().serializeBinary()).hasCanonicalReceiptJson(), false);
+console.log('PASS: previous released reader interoperability; old reserialization loses optional tag as expected; only approved source addition');

package/scripts/verify-provider-winnings-contract.js

@@ -0,0 +1,65 @@
+'use strict';
+const assert = require('node:assert/strict');
+const { execFileSync } = require('node:child_process');
+const { createRequire } = require('node:module');
+const vm = require('node:vm');
+const path = require('node:path');
+const fs = require('node:fs');
+const pkg = require('..');
+const grpc = pkg.gRPC;
+const messages = pkg.bonus.messages;
+const service = pkg.bonus.service;
+function previous(file) {
+  const source = execFileSync('git', ['show', `4e2cfdb:${file}`], { encoding: 'utf8', maxBuffer: 8 * 1024 * 1024 });
+  const sandbox = { exports: {}, proto: {}, require: createRequire(path.resolve(__dirname, '..', file)) };
+  sandbox.global = sandbox;
+  vm.runInNewContext(source, sandbox);
+  return sandbox.exports;
+}
+async function main() {
+  const oldService = previous('bonus/bonus_grpc_pb.js');
+  const oldMessages = previous('bonus/bonus_pb.js');
+  assert.deepEqual(Object.keys(service.BonusService).filter(k => k !== 'resolveProviderRewardWinnings'), Object.keys(oldService.BonusService));
+  for (const [name, method] of Object.entries(oldService.BonusService)) {
+    const now = service.BonusService[name];
+    for (const key of ['path', 'requestStream', 'responseStream']) assert.equal(now[key], method[key]);
+  }
+  const priorProto = execFileSync('git', ['show', '4e2cfdb:bonus/bonus.proto'], { encoding: 'utf8' });
+  const retained = fs.readFileSync(path.join(__dirname, '../bonus/bonus.proto'), 'utf8')
+    .split('\n// Authoritative provider units, never account/session-converted values.')[0]
+    .replace('    // Resolve a durable provider reward identity before any winnings wallet mutation.\n    rpc resolveProviderRewardWinnings(ResolveProviderRewardWinningsRequest) returns (ResolveProviderRewardWinningsResponse);\n', '');
+  assert.equal(retained.trimEnd(), priorProto.trimEnd());
+  const request = new messages.ResolveProviderRewardWinningsRequest();
+  request.setUserId(462); request.setProviderRewardId('provider-reward-1');
+  request.setProviderTransactionId('provider-tx-1'); request.setProviderCurrency('EUR');
+  request.setProviderCurrencyScale(2); request.setProviderAmountMinor('123456789012345678901234567890123456');
+  const r = messages.ResolveProviderRewardWinningsRequest.deserializeBinary(request.serializeBinary());
+  assert.equal(r.getProviderAmountMinor(), request.getProviderAmountMinor());
+  assert.equal(r.getProviderTransactionId(), 'provider-tx-1');
+  assert.equal(r.getProviderCurrencyScale(), 2);
+  const response = new messages.ResolveProviderRewardWinningsResponse();
+  assert.equal(response.getMode(), '');
+  for (const field of ['UserBonusId', 'Currency', 'CurrencyScale', 'AmountMinor', 'ProviderWinningsFxJson']) assert.equal(response[`has${field}`](), false);
+  response.setMode('normalized'); response.setUserBonusId(2898); response.setCurrency('BTC');
+  response.setCurrencyScale(0); response.setAmountMinor('0'); response.setProviderWinningsFxJson('{"version":1}');
+  const received = messages.ResolveProviderRewardWinningsResponse.deserializeBinary(response.serializeBinary());
+  assert.equal(received.hasCurrencyScale(), true); assert.equal(received.getCurrencyScale(), 0);
+  assert.equal(received.getAmountMinor(), '0'); assert.equal(received.getMode(), 'normalized');
+  const legacy = new messages.ResolveProviderRewardWinningsResponse(); legacy.setMode('legacy');
+  assert.equal(messages.ResolveProviderRewardWinningsResponse.deserializeBinary(legacy.serializeBinary()).hasCurrency(), false);
+  const oldRequest = new oldMessages.ValidateSelectedWageringUserBonusRequest();
+  oldRequest.setUserId(462); oldRequest.setWalletCurrency('USDT');
+  assert.equal(messages.ValidateSelectedWageringUserBonusRequest.deserializeBinary(oldRequest.serializeBinary()).getWalletCurrency(), 'USDT');
+  // Actual old server: a new caller receives UNIMPLEMENTED, not an empty legacy response.
+  const server = new grpc.Server();
+  server.addService(oldService.BonusService, {});
+  const port = await new Promise((resolve, reject) => server.bindAsync('127.0.0.1:0', grpc.ServerCredentials.createInsecure(), (error, value) => error ? reject(error) : resolve(value)));
+  const client = new service.BonusClient(`127.0.0.1:${port}`, grpc.credentials.createInsecure());
+  try {
+    await assert.rejects(new Promise((resolve, reject) => client.resolveProviderRewardWinnings(request,
+      { deadline: Date.now() + 3000 }, (error, value) => error ? reject(error) : resolve(value))),
+    error => error.code === grpc.status.UNIMPLEMENTED);
+  } finally { client.close(); server.forceShutdown(); }
+  console.log('PASS provider winnings contract: unchanged old schema/methods, exact minors, optional presence, explicit modes, old-server UNIMPLEMENTED');
+}
+main().catch(error => { console.error(error); process.exitCode = 1; });

package/user/user.proto

@@ -2691,6 +2691,8 @@ message PrecisionRgAdmissionResponse {
     string release_receipt_id = 6;
     string commit_receipt_id = 7;
     EvaluateResponsibleGamingDecisionResponse decision = 8;
+    // Exact persisted initial SQL-v2 receipt; absent when no initial receipt exists.
+    optional string canonical_receipt_json = 9;
 }
 
 message ImportPlayerInvitationsRequest {

package/user/user_pb.js

@@ -107763,7 +107763,8 @@ proto.user.PrecisionRgAdmissionResponse.toObject = function(includeInstance, msg
     admissionReceiptId: jspb.Message.getFieldWithDefault(msg, 5, ""),
     releaseReceiptId: jspb.Message.getFieldWithDefault(msg, 6, ""),
     commitReceiptId: jspb.Message.getFieldWithDefault(msg, 7, ""),
-    decision: (f = msg.getDecision()) && proto.user.EvaluateResponsibleGamingDecisionResponse.toObject(includeInstance, f)
+    decision: (f = msg.getDecision()) && proto.user.EvaluateResponsibleGamingDecisionResponse.toObject(includeInstance, f),
+    canonicalReceiptJson: jspb.Message.getFieldWithDefault(msg, 9, "")
   };
 
   if (includeInstance) {
@@ -107834,6 +107835,10 @@ proto.user.PrecisionRgAdmissionResponse.deserializeBinaryFromReader = function(m
       reader.readMessage(value,proto.user.EvaluateResponsibleGamingDecisionResponse.deserializeBinaryFromReader);
       msg.setDecision(value);
       break;
+    case 9:
+      var value = /** @type {string} */ (reader.readString());
+      msg.setCanonicalReceiptJson(value);
+      break;
     default:
       reader.skipField();
       break;
@@ -107921,6 +107926,13 @@ proto.user.PrecisionRgAdmissionResponse.serializeBinaryToWriter = function(messa
       proto.user.EvaluateResponsibleGamingDecisionResponse.serializeBinaryToWriter
     );
   }
+  f = /** @type {string} */ (jspb.Message.getField(message, 9));
+  if (f != null) {
+    writer.writeString(
+      9,
+      f
+    );
+  }
 };
 
 
@@ -108106,6 +108118,42 @@ proto.user.PrecisionRgAdmissionResponse.prototype.hasDecision = function() {
 };
 
 
+/**
+ * optional string canonical_receipt_json = 9;
+ * @return {string}
+ */
+proto.user.PrecisionRgAdmissionResponse.prototype.getCanonicalReceiptJson = function() {
+  return /** @type {string} */ (jspb.Message.getFieldWithDefault(this, 9, ""));
+};
+
+
+/**
+ * @param {string} value
+ * @return {!proto.user.PrecisionRgAdmissionResponse} returns this
+ */
+proto.user.PrecisionRgAdmissionResponse.prototype.setCanonicalReceiptJson = function(value) {
+  return jspb.Message.setField(this, 9, value);
+};
+
+
+/**
+ * Clears the field making it undefined.
+ * @return {!proto.user.PrecisionRgAdmissionResponse} returns this
+ */
+proto.user.PrecisionRgAdmissionResponse.prototype.clearCanonicalReceiptJson = function() {
+  return jspb.Message.setField(this, 9, undefined);
+};
+
+
+/**
+ * Returns whether this field is set.
+ * @return {boolean}
+ */
+proto.user.PrecisionRgAdmissionResponse.prototype.hasCanonicalReceiptJson = function() {
+  return jspb.Message.getField(this, 9) != null;
+};
+
+