googleapis
diff --git a/‎google/cloud/universalledger/v1/transactions.proto‎
Lines changed: 83 additions & 67 deletions b/‎google/cloud/universalledger/v1/transactions.proto‎
Lines changed: 83 additions & 67 deletions
@@ -38,7 +38,7 @@ enum KeyFormat {
   // format](https://developers.google.com/tink/wire-format#keyset_serialization).
   KEY_FORMAT_TINK_WIRE_FORMAT = 1;
 
-  // A PEM-encoded elliptic curve signing key using the P-256 curve  with
+  // A PEM-encoded elliptic curve signing key using the P-256 curve with
   // SHA256 digest. Signatures must be provided in DER format.
   KEY_FORMAT_PEM_EC_P256_SHA256 = 2;
 }
@@ -71,8 +71,8 @@ enum SettlementMode {
 // transaction that needs to be sent to execute a settlement between the two
 // token managers.
 message SettlementRequest {
-  // Optional. Immutable. The account ID of the party that needs to make the
-  // fund transfer. Deprecated: use `payer_id` instead.
+  // Optional. Immutable. Deprecated: use `payer_id` instead.
+  // The account ID of the party that needs to make the fund transfer.
   Entity payer = 1 [
     deprecated = true,
     (google.api.field_behavior) = IMMUTABLE,
@@ -86,8 +86,8 @@ message SettlementRequest {
     (google.api.field_behavior) = OPTIONAL
   ];
 
-  // Optional. Immutable. The account ID of the party that needs to be paid.
-  // Deprecated: use `beneficiary_id` instead.
+  // Optional. Immutable. Deprecated: use `beneficiary_id` instead.
+  // The account ID of the party that needs to be paid.
   Entity beneficiary = 2 [
     deprecated = true,
     (google.api.field_behavior) = IMMUTABLE,
@@ -148,17 +148,18 @@ message CreateAccount {
   AccountStatus account_status = 3 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Immutable. An opaque comment field that is not interpreted by the
-  // system but stored on the ledger in the account. Maximum length is 128
-  // characters. May be left empty. Once created, the field is immutable.
+  // system but stored on the ledger in the account. Considered public
+  // information. Maximum length is 128 characters. May be left empty. Once
+  // created, the field is immutable.
   string account_comment = 4 [
     (google.api.field_behavior) = OPTIONAL,
     (google.api.field_behavior) = IMMUTABLE
   ];
 
-  // Optional. The token manager for this account. This field is optional and if
-  // not supplied, the default token manager associated to the account manager
+  // Optional. Deprecated: use `token_manager_id` instead.
+  // The token manager for this account. This field is optional and if not
+  // supplied, the default token manager associated to the account manager
   // (that is, the sender of this transaction) will be used.
-  // Deprecated: use `token_manager_id` instead.
   Entity token_manager = 5
       [deprecated = true, (google.api.field_behavior) = OPTIONAL];
 
@@ -175,8 +176,8 @@ message CreateAccount {
 // This implies that the account owner will not be able to make any transactions
 // on the account regardless of the roles.
 message DeactivateAccount {
-  // Optional. The ID of the account to be deactivated.
-  // Deprecated: use `account_id` instead.
+  // Optional. Deprecated: use `account_id` instead.
+  // The ID of the account to be deactivated.
   Entity account = 1
       [deprecated = true, (google.api.field_behavior) = OPTIONAL];
 
@@ -191,8 +192,8 @@ message DeactivateAccount {
 // The account owner can resume normal operations permitted by the roles on the
 // account.
 message ActivateAccount {
-  // Optional. The ID of the account to be activated.
-  // Deprecated: use `account_id` instead.
+  // Optional. Deprecated: use `account_id` instead.
+  // The ID of the account to be activated.
   Entity account = 1
       [deprecated = true, (google.api.field_behavior) = OPTIONAL];
 
@@ -204,8 +205,8 @@ message ActivateAccount {
 // Adds the specified roles to the account. The sender must be the account
 // manager of the account to modify.
 message AddRoles {
-  // Optional. The ID of the account to be modified.
-  // Deprecated: use `account_id` instead.
+  // Optional. Deprecated: use `account_id` instead.
+  // The ID of the account to be modified.
   Entity account = 1
       [deprecated = true, (google.api.field_behavior) = OPTIONAL];
 
@@ -220,8 +221,8 @@ message AddRoles {
 // Removes the specified roles from the account. The sender must be the account
 // manager of the account to modify.
 message RemoveRoles {
-  // Optional. The ID of the account to be modified.
-  // Deprecated: use `account_id` instead.
+  // Optional. Deprecated: use `account_id` instead.
+  // The ID of the account to be modified.
   Entity account = 1
       [deprecated = true, (google.api.field_behavior) = OPTIONAL];
 
@@ -237,8 +238,8 @@ message RemoveRoles {
 // manager. The sender must be the current account manager of the account and,
 // to provide consent, the new manager must also sign this transaction.
 message ChangeAccountManager {
-  // Optional. The ID of the account whose manager is to be changed.
-  // Deprecated: use `account_id` instead.
+  // Optional. Deprecated: use `account_id` instead.
+  // The ID of the account whose manager is to be changed.
   Entity account = 1
       [deprecated = true, (google.api.field_behavior) = OPTIONAL];
 
@@ -247,9 +248,9 @@ message ChangeAccountManager {
   // characters.
   string account_id = 3 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. The ID of the new proposed account manager. Validation requires
-  // that the new manager has also signed this transaction. Deprecated: use
-  // `next_manager_id` instead.
+  // Optional. Deprecated: use `next_manager_id` instead.
+  // The ID of the new proposed account manager. Validation requires that the
+  // new manager has also signed this transaction.
   Entity next_manager = 2
       [deprecated = true, (google.api.field_behavior) = OPTIONAL];
 
@@ -265,9 +266,9 @@ message ChangeAccountManager {
 // increases its token issuance limit. The sender must be a clearinghouse
 // account.
 message IncreaseTokenIssuanceLimit {
-  // Optional. The ID of the institutional account whose mint limit is to be
-  // raised. This account must be a token manager for the transaction to be
-  // valid. Deprecated: use `token_manager_id` instead.
+  // Optional. Deprecated: use `token_manager_id` instead.
+  // The ID of the institutional account whose mint limit is to be raised. This
+  // account must be a token manager for the transaction to be valid.
   Entity token_manager = 1
       [deprecated = true, (google.api.field_behavior) = OPTIONAL];
 
@@ -290,17 +291,16 @@ message IncreaseTokenIssuanceLimit {
 // the transaction to fail (for example, if the minted amount is already above
 // the requested reduced limit).
 message DecreaseTokenIssuanceLimit {
-  // Optional. The ID of the institutional account whose mint limit is to be
-  // lowered. This account must have the `ADMIN_ROLE_TOKEN_MANAGER` permission
-  // on it for the transaction to be valid. Deprecated: use `token_manager_id`
-  // instead.
+  // Optional. Deprecated: use `token_manager_id` instead.
+  // The ID of the institutional account whose mint limit is to be lowered. This
+  // account must be a token manager for the transaction to be valid.
   Entity token_manager = 1
       [deprecated = true, (google.api.field_behavior) = OPTIONAL];
 
   // Optional. The ID of the institutional account whose mint limit is to be
-  // lowered. This account must have the `ADMIN_ROLE_TOKEN_MANAGER` permission
-  // on it for the transaction to be valid. One of `token_manager` or
-  // `token_manager_id` must be specified.
+  // lowered. This account must be a token manager for the transaction to be
+  // valid. One of `token_manager_id` (preferred) or `token_manager`
+  // (deprecated) must be specified.
   string token_manager_id = 3 [(google.api.field_behavior) = OPTIONAL];
 
   // Required. The amount by which to lower the limit. The amount must be
@@ -317,9 +317,9 @@ message Mint {
   // higher than that, the transaction must be rejected
   CurrencyValue mint_amount = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Optional. The account to which the minted amount should be transferred.
+  // Optional. Deprecated: use `beneficiary_id` instead.
+  // The account to which the minted amount should be transferred.
   // The bene
C3FE
ficiary account must have the `ROLE_RECEIVER` enabled on it.
-  // Deprecated: use `beneficiary_id` instead.
   Entity beneficiary = 2
       [deprecated = true, (google.api.field_behavior) = OPTIONAL];
 
@@ -340,8 +340,9 @@ message Burn {
   // Required. The amount to burn.
   CurrencyValue burn_amount = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Optional. The account supplying the tokens to burn. The account must have
-  // the `ROLE_PAYER` enabled on it. Deprecated: use `payer_id` instead.
+  // Optional. Deprecated: use `payer_id` instead.
+  // The account supplying the tokens to burn. The account must have the
+  // `ROLE_PAYER` enabled on it.
   Entity payer = 2 [deprecated = true, (google.api.field_behavior) = OPTIONAL];
 
   // Optional. The ID of the account supplying the tokens to burn. The payer
@@ -357,8 +358,8 @@ message Burn {
 // Additionally, the transaction sender must have the `ROLE_PAYER` enabled on
 // it, while the receiver must have the `ROLE_RECEIVER` enabled on it.
 message Transfer {
-  // Optional. The account that receives the tokens.
-  // Deprecated: use `beneficiary_id` instead.
+  // Optional. Deprecated: use `beneficiary_id` instead.
+  // The account that receives the tokens.
   Entity beneficiary = 1
       [deprecated = true, (google.api.field_behavior) = OPTIONAL];
 
@@ -395,8 +396,9 @@ message CreateTokenManager {
   ];
 
   // Optional. Immutable. An opaque comment field that is not interpreted by the
-  // system but stored on the ledger in the account. Maximum length is 128
-  // characters. May be left empty. Once created, the field is immutable.
+  // system but stored on the ledger in the account. Considered public
+  // information. Maximum length is 128 characters. May be left empty. Once
+  // created, the field is immutable.
   string account_comment = 4 [
     (google.api.field_behavior) = OPTIONAL,
     (google.api.field_behavior) = IMMUTABLE
@@ -427,8 +429,9 @@ message CreateAccountManager {
     (google.api.field_behavior) = IMMUTABLE
   ];
 
-  // Optional. The default token manager for the accounts that will be created
-  // by this manager. Deprecated: use `default_token_manager_id` instead.
+  // Optional. Deprecated: use `default_token_manager_id` instead.
+  // The default token manager for the accounts that will be created by this
+  // manager.
   Entity default_token_manager = 2
       [deprecated = true, (google.api.field_behavior) = OPTIONAL];
 
@@ -437,8 +440,9 @@ message CreateAccountManager {
   string default_token_manager_id = 3 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Immutable. An opaque comment field that is not interpreted by the
-  // system but stored on the ledger in the account. Maximum length is 128
-  // characters. May be left empty. Once created, the field is immutable.
+  // system but stored on the ledger in the account. Considered public
+  // information. Maximum length is 128 characters. May be left empty. Once
+  // created, the field is immutable.
   string account_comment = 4 [
     (google.api.field_behavior) = OPTIONAL,
     (google.api.field_behavior) = IMMUTABLE
@@ -469,8 +473,9 @@ message CreateClearinghouse {
   ];
 
   // Optional. Immutable. An opaque comment field that is not interpreted by the
-  // system but stored on the ledger in the account. Maximum length is 128
-  // characters. May be left empty. Once created, the field is immutable.
+  // system but stored on the ledger in the account. Considered public
+  // information. Maximum length is 128 characters. May be left empty. Once
+  // created, the field is immutable.
   string account_comment = 4 [
     (google.api.field_behavior) = OPTIONAL,
     (google.api.field_behavior) = IMMUTABLE
@@ -505,8 +510,9 @@ message TransferPlatformOperator {
   ];
 
   // Optional. Immutable. An opaque comment field that is not interpreted by the
-  // system but stored on the ledger in the account. Maximum length is 128
-  // characters. May be left empty. Once created, the field is immutable.
+  // system but stored on the ledger in the account. Considered public
+  // information. Maximum length is 128 characters. May be left empty. Once
+  // created, the field is immutable.
   string account_comment = 2 [
     (google.api.field_behavior) = OPTIONAL,
     (google.api.field_behavior) = IMMUTABLE
@@ -542,8 +548,9 @@ message CreateCurrencyOperator {
   ];
 
   // Optional. Immutable. An opaque comment field that is not interpreted by the
-  // system but stored on the ledger in the account. Maximum length is 128
-  // characters. May be left empty. Once created, the field is immutable.
+  // system but stored on the ledger in the account. Considered public
+  // information. Maximum length is 128 characters. May be left empty. Once
+  // created, the field is immutable.
   string account_comment = 2 [
     (google.api.field_behavior) = OPTIONAL,
     (google.api.field_behavior) = IMMUTABLE
@@ -579,15 +586,16 @@ message TransferCurrencyOperator {
   ];
 
   // Optional. Immutable. An opaque comment field that is not interpreted by the
-  // system but stored on the ledger in the account. Maximum length is 128
-  // characters. May be left empty. Once created, the field is immutable.
+  // system but stored on the ledger in the account. Considered public
+  // information. Maximum length is 128 characters. May be left empty. Once
+  // created, the field is immutable.
   string account_comment = 2 [
     (google.api.field_behavior) = OPTIONAL,
     (google.api.field_behavior) = IMMUTABLE
   ];
 
-  // Optional. The currency operator to be replaced. Must be active.
-  // Deprecated: use `currency_operator_id` instead.
+  // Optional. Deprecated: use `currency_operator_id` instead.
+  // The currency operator to be replaced. Must be active.
   Entity currency_operator = 4
       [deprecated = true, (google.api.field_behavior) = OPTIONAL];
 
@@ -609,16 +617,22 @@ message CreateContract {
   // Arguments for the `__init__` method.
   map<string, Value> arguments = 2;
 
-  // An immutable opaque comment field that is associated with the contract.
-  string contract_comment = 3;
+  // Optional. Immutable. An opaque comment field that is not interpreted by the
+  // system but stored on the ledger in the contract. Considered public
+  // information. Maximum length is 128 characters. May be left empty. Once
+  // created, the field is immutable.
+  string contract_comment = 3 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.field_behavior) = IMMUTABLE
+  ];
 }
 
 // Grants permissions to the contract by the transaction sender.
 //
 // Note that, at the moment, there is no support for revoking permissions.
 message GrantContractPermissions {
-  // Optional. ID of the contract to which permissions are being granted.
-  // Deprecated: use `contract_id` instead.
+  // Optional. Deprecated: use `contract_id` instead.
+  // ID of the contract to which permissions are being granted.
   Entity contract = 1
       [deprecated = true, (google.api.field_behavior) = OPTIONAL];
 
@@ -632,8 +646,8 @@ message GrantContractPermissions {
 
 // Invokes the execution of a contract method.
 message InvokeContractMethod {
-  // Optional. ID of the contract to run.
-  // Deprecated: use `contract_id` instead.
+  // Optional. Deprecated: use `contract_id` instead.
+  // ID of the contract to run.
   Entity contract = 1
       [deprecated = true, (google.api.field_behavior) = OPTIONAL];
 
@@ -655,10 +669,10 @@ message InvokeContractMethod {
 
 // Creates a new contract token manager associated with the currency of the
 // operator sending the request. The sender must be a currency operator.
-// The newly created contract token manager will be active by default. If the
+// The newly created contract token manager is active by default. If the
 // contract token manager has to be replaced, the TransferContractTokenManager
 // transaction should be sent instead. If another contract token manager
-// associated to the same currency exists, this transaction will fail.
+// associated with the same currency exists, this transaction will fail.
 //
 // Unlike regular token managers, contract token managers are not allowed to
 // execute transactions such as mint or burn. They can, however, participate in
@@ -679,8 +693,9 @@ message CreateContractTokenManager {
   bytes public_key = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Optional. Immutable. An opaque comment field that is not interpreted by the
-  // system but stored on the ledger in the account. Maximum length is 128
-  // characters. May be left empty. Once created, the field is immutable.
+  // system but stored on the ledger in the account. Considered public
+  // information. Maximum length is 128 characters. May be left empty. Once
+  // created, the field is immutable.
   string account_comment = 2 [
     (google.api.field_behavior) = OPTIONAL,
     (google.api.field_behavior) = IMMUTABLE
@@ -714,8 +729,9 @@ message TransferContractTokenManager {
   bytes public_key = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Optional. Immutable. An opaque comment field that is not interpreted by the
-  // system but stored on the ledger in the account. Maximum length is 128
-  // characters. May be left empty. Once created, the field is immutable.
+  // system but stored on the ledger in the account. Considered public
+  // information. Maximum length is 128 characters. May be left empty. Once
+  // created, the field is immutable.
   string account_comment = 2 [
     (google.api.field_behavior) = OPTIONAL,
     (google.api.field_behavior) = IMMUTABLE