github.com/Finschia/finschia-sdk@v0.48.1/proto/lbm/token/v1/tx.proto

syntax = "proto3";
package lbm.token.v1;

import "gogoproto/gogo.proto";
import "lbm/token/v1/token.proto";

option go_package = "github.com/Finschia/finschia-sdk/x/token";

option (gogoproto.equal_all)           = false;
option (gogoproto.goproto_getters_all) = false;

// Msg defines the token Msg service.
service Msg {
  // Send defines a method to send tokens from one account to another account.
  // Fires:
  // - EventSent
  // - transfer (deprecated, not typed)
  rpc Send(MsgSend) returns (MsgSendResponse);

  // OperatorSend defines a method to send tokens from one account to another account by the operator.
  // Fires:
  // - EventSent
  // - transfer_from (deprecated, not typed)
  // Note: the approval has no value of limit (not ERC20 compliant).
  rpc OperatorSend(MsgOperatorSend) returns (MsgOperatorSendResponse);

  // RevokeOperator revoke the authorization of the operator to send the holder's tokens.
  // Fires:
  // - EventRevokedOperator
  // Note: it introduces breaking change, because the legacy clients cannot track this revocation.
  // Since: 0.46.0 (finschia)
  rpc RevokeOperator(MsgRevokeOperator) returns (MsgRevokeOperatorResponse);

  // AuthorizeOperator allows one to send tokens on behalf of the holder.
  // Fires:
  // - EventAuthorizedOperator
  // - approve_token (deprecated, not typed)
  rpc AuthorizeOperator(MsgAuthorizeOperator) returns (MsgAuthorizeOperatorResponse);

  // Issue defines a method to create a class of token.
  // it grants `mint`, `burn` and `modify` permissions on the token class to its creator (see also `mintable`).
  // Fires:
  // - EventIssue
  // - EventMinted
  // - issue (deprecated, not typed)
  rpc Issue(MsgIssue) returns (MsgIssueResponse);

  // GrantPermission allows one to mint or burn tokens or modify a token metadata.
  // Fires:
  // - EventGrant
  // - grant_perm (deprecated, not typed)
  rpc GrantPermission(MsgGrantPermission) returns (MsgGrantPermissionResponse);

  // RevokePermission abandons a permission.
  // Fires:
  // - EventAbandon
  // - revoke_perm (deprecated, not typed)
  rpc RevokePermission(MsgRevokePermission) returns (MsgRevokePermissionResponse);

  // Mint defines a method to mint tokens.
  // Fires:
  // - EventMinted
  // - mint (deprecated, not typed)
  rpc Mint(MsgMint) returns (MsgMintResponse);

  // Burn defines a method to burn tokens.
  // Fires:
  // - EventBurned
  // - burn (deprecated, not typed)
  rpc Burn(MsgBurn) returns (MsgBurnResponse);

  // OperatorBurn defines a method to burn tokens by the operator.
  // Fires:
  // - EventBurned
  // - burn_from (deprecated, not typed)
  rpc OperatorBurn(MsgOperatorBurn) returns (MsgOperatorBurnResponse);

  // Modify defines a method to modify a token class.
  // Fires:
  // - EventModified
  // - modify_token (deprecated, not typed)
  rpc Modify(MsgModify) returns (MsgModifyResponse);
}

// MsgSend defines the Msg/Send request type.
//
// Signer: `from`
message MsgSend {
  // contract id associated with the token class.
  string contract_id = 1;
  // holder whose tokens are being sent.
  string from = 2;
  // recipient of the tokens.
  string to = 3;
  // number of tokens to send.
  string amount = 4 [(gogoproto.customtype) = "github.com/Finschia/finschia-sdk/types.Int", (gogoproto.nullable) = false];
}

// MsgSendResponse defines the Msg/Send response type.
message MsgSendResponse {}

// MsgOperatorSend defines the Msg/OperatorSend request type.
//
// Signer: `operator`
message MsgOperatorSend {
  // contract id associated with the token class.
  string contract_id = 1;
  // the address of the operator.
  string operator = 2;
  // the address which the transfer is from.
  string from = 3;
  // the address which the transfer is to.
  string to = 4;
  // the amount of the transfer.
  string amount = 5 [(gogoproto.customtype) = "github.com/Finschia/finschia-sdk/types.Int", (gogoproto.nullable) = false];
}

// MsgOperatorSendResponse defines the Msg/OperatorSend response type.
message MsgOperatorSendResponse {}

// MsgRevokeOperator defines the Msg/RevokeOperator request type.
//
// Signer: `holder`
//
// Since: 0.46.0 (finschia)
message MsgRevokeOperator {
  // contract id associated with the token class.
  string contract_id = 1;
  // address of a holder which revokes the `operator` address as an operator.
  string holder = 2;
  // address to rescind as an operator for `holder`.
  string operator = 3;
}

// MsgRevokeOperatorResponse defines the Msg/RevokeOperator response type.
//
// Since: 0.46.0 (finschia)
message MsgRevokeOperatorResponse {}

// MsgAuthorizeOperator defines the Msg/AuthorizeOperator request type.
//
// Signer: `holder`
message MsgAuthorizeOperator {
  // contract id associated with the token class.
  string contract_id = 1;
  // address of the token holder which approves the authorization.
  string holder = 2;
  // address of the operator which the authorization is granted to.
  string operator = 3;
}

// MsgAuthorizeOperatorResponse defines the Msg/AuthorizeOperator response type.
message MsgAuthorizeOperatorResponse {}

// MsgIssue defines the Msg/Issue request type.
//
// Signer: `owner`
message MsgIssue {
  // name defines the human-readable name of the token class. mandatory (not ERC20 compliant).
  string name = 1;
  // symbol is an abbreviated name for token class. mandatory (not ERC20 compliant).
  string symbol = 2;
  // uri for the image of the token class stored off chain.
  string uri = 3;
  // meta is a brief description of token class.
  string meta = 4;
  // decimals is the number of decimals which one must divide the amount by to get its user representation.
  int32 decimals = 5;
  // mintable represents whether the token is allowed to mint.
  bool mintable = 6;

  // the address which all permissions on the token class will be granted to (not a permanent property).
  string owner = 7;

  // the address to send the minted token to. mandatory.
  string to = 8;
  // amount of tokens to mint on issuance. mandatory.
  string amount = 9 [(gogoproto.customtype) = "github.com/Finschia/finschia-sdk/types.Int", (gogoproto.nullable) = false];
}

// MsgIssueResponse defines the Msg/Issue response type.
message MsgIssueResponse {
  // id of the new contract.
  string contract_id = 1;
}

// MsgGrantPermission defines the Msg/GrantPermission request type.
//
// Signer: `granter`
message MsgGrantPermission {
  // contract id associated with the token class.
  string contract_id = 1;
  // address of the granter which must have the permission to give.
  string from = 2;
  // address of the grantee.
  string to = 3;
  // permission on the token class.
  string permission = 4;
}

// MsgGrantPermissionResponse defines the Msg/GrantPermission response type.
message MsgGrantPermissionResponse {}

// MsgRevokePermission defines the Msg/RevokePermission request type.
//
// Signer: `grantee`
message MsgRevokePermission {
  // contract id associated with the token class.
  string contract_id = 1;
  // address of the grantee which abandons the permission.
  string from = 2;
  // permission on the token class.
  string permission = 3;
}

// MsgRevokePermissionResponse defines the Msg/RevokePermission response type.
message MsgRevokePermissionResponse {}

// MsgMint defines the Msg/Mint request type.
//
// Signer: `from`
message MsgMint {
  // contract id associated with the token class.
  string contract_id = 1;
  // address which triggers the mint.
  string from = 2;
  // recipient of the tokens.
  string to = 3;
  // number of tokens to mint.
  string amount = 4 [(gogoproto.customtype) = "github.com/Finschia/finschia-sdk/types.Int", (gogoproto.nullable) = false];
}

// MsgMintResponse defines the Msg/Mint response type.
message MsgMintResponse {}

// MsgBurn defines the Msg/Burn request type.
//
// Signer: `from`
message MsgBurn {
  // contract id associated with the token class.
  string contract_id = 1;
  // address whose tokens are being burned.
  string from = 2;
  // number of tokens to burn.
  string amount = 3 [(gogoproto.customtype) = "github.com/Finschia/finschia-sdk/types.Int", (gogoproto.nullable) = false];
}

// MsgBurnResponse defines the Msg/Burn response type.
message MsgBurnResponse {}

// MsgOperatorBurn defines the Msg/OperatorBurn request type.
//
// Signer: `operator`
message MsgOperatorBurn {
  // contract id associated with the token class.
  string contract_id = 1;
  // address which triggers the burn.
  string operator = 2;
  // address which the tokens will be burnt from.
  string from = 3;
  // the amount of the burn.
  string amount = 4 [(gogoproto.customtype) = "github.com/Finschia/finschia-sdk/types.Int", (gogoproto.nullable) = false];
}

// MsgOperatorBurnResponse defines the Msg/OperatorBurn response type.
message MsgOperatorBurnResponse {}

// MsgModify defines the Msg/Modify request type.
//
// Signer: `owner`
message MsgModify {
  // contract id associated with the contract.
  string contract_id = 1;
  // the address of the grantee which must have modify permission.
  string owner = 2;
  // changes to apply.
  // possible attribute keys are: name, uri, img_uri (deprecated), meta
  repeated Attribute changes = 3 [(gogoproto.nullable) = false];
}

// MsgModifyResponse defines the Msg/Modify response type.
message MsgModifyResponse {}