Add TokenReturn transaction

services/basic_types.proto

@@ -1017,6 +1017,11 @@ enum HederaFunctionality {
      * Unpause the Token
      */
     TokenUnpause = 80;
+
+    /**
+     * Return the Token
+     */
+    TokenReturn = 81;
 }
 
 /**

services/schedulable_transaction_body.proto

@@ -64,6 +64,7 @@ import "token_associate.proto";
 import "token_dissociate.proto";
 import "token_pause.proto";
 import "token_unpause.proto";
+import "token_return.proto";
 
 import "schedule_delete.proto";
 
@@ -255,5 +256,10 @@ message SchedulableTransactionBody {
      * Marks a schedule in the network's action queue as deleted, preventing it from executing
      */
     ScheduleDeleteTransactionBody scheduleDelete = 34;
+
+    /**
+     * Returns the token
+     */
+    TokenReturnTransactionBody tokenReturn = 37;
   }
 }

services/token_return.proto

@@ -0,0 +1,50 @@
+syntax = "proto3";
+
+package proto;
+
+/*-
+ * ‌
+ * Hedera Network Services Protobuf
+ * ​
+ * Copyright (C) 2018 - 2021 Hedera Hashgraph, LLC
+ * ​
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ * ‍
+ */
+
+option java_package = "com.hederahashgraph.api.proto.java";
+option java_multiple_files = true;
+
+import "basic_types.proto";
+
+/**
+ * An account returns the token back to its treasury and dissociates from it.
+ * This operation is free from customFee and does not stop if account is frozen for the token or
+ * kyc on this token is revoked for this account or even if the token is paused.
+ * If the provided account is not found, the transaction will resolve to INVALID_ACCOUNT_ID.
+ * If the provided token has been deleted, the transaction will resolve to ACCOUNT_DELETED.
+ * If the provided token is not found, the transaction will resolve to INVALID_TOKEN_ID.
+ * If the provided token has been deleted, the transaction will resolve to TOKEN_WAS_DELETED.
+ * If the provided token is not associated with the provided account, the transaction will resolve to TOKEN_NOT_ASSOCIATED_TO_ACCOUNT.
+ */
+message TokenReturnTransactionBody {
+  /**
+   * The token to be returned.
+   */
+  TokenID token = 1;
+
+  /**
+   * The account which returns the token to its treasury
+   */
+  AccountID account = 2;
+}

services/token_service.proto

@@ -127,4 +127,7 @@ service TokenService {
 
     //  Unpause the token
     rpc unpauseToken (Transaction) returns (TransactionResponse);
+
+    // Return the token
+    rpc returnToken (Transaction) returns (TransactionResponse);
 }

services/transaction_body.proto

@@ -71,6 +71,7 @@ import "token_dissociate.proto";
 import "token_fee_schedule_update.proto";
 import "token_pause.proto";
 import "token_unpause.proto";
+import "token_return.proto";
 
 import "schedule_create.proto";
 import "schedule_delete.proto";
@@ -314,5 +315,10 @@ message TransactionBody {
      * Adds one or more Ed25519 keys to the affirmed signers of a scheduled transaction
      */
     ScheduleSignTransactionBody scheduleSign = 44;
+
+    /**
+     * Returns the token
+     */
+    TokenReturnTransactionBody token_Return = 48;
   }
 }