Hedera Services
Hedera Services release information
MAINNET UPDATE: APRIL 18, 2023
TESTNET UPDATE: APRIL 4, 2023
Coming soon...
MAINNET UPDATE: MARCH 31, 2023
TESTNET UPDATE: MARCH 16, 2023
- After the security incident on March 9th, the engineers conducted a thorough analysis of the Smart Contract Service and the Hedera Token Service system contracts.
- As part of this exercise, we did not find any additional vulnerabilities that could result in an attack that that which we witnessed on March 9th.
- The team also looked for any disparities between the expectations of a typical smart contract developer who is used to working with the Ethereum Virtual Machine (EVM) or ERC token APIs and the behaviors of the Hedera Token Service system contract APIs. Such differences in behavior could be used by a malicious smart contract developer in unexpected ways.
- In order to eliminate the possibility of these behavioral differences being utilized as attack vectors in the future, the consensus node software will align the behaviors of the Hedera Smart Contract Service token system contracts with those of EVM and typical token APIs such as ERC 20 and ERC 721.
- As a result, the following changes are made as of the mainnet 0.35.2 release on March 31st:
- An EOA (externally owned account) will have to provide explicit approval/allowance to a contract if they want the contract to transfer value from their account balance.
- The behavior of
transferFromsystem contract will be exactly the same as that of the ERC 20 and ERC 721 spectransferFromfunction. - For HTS specific token functionality (e.g. Pause, Freeze, or Grant KYC), a contract will be authorized to perform the associated token management function only if the ContractId is listed as a key on the token (i.e. Pause Key, Freeze Key, KYC Key respectively).
- The
transferTokenandtransferNFTAPIs will behave astransferin ERC20/721 if the caller owns the value being transferred, otherwise it will rely on approve spender allowances from the token owner. - The above model will dictate entity (EOA and contracts) permissions during contract executions when modifying state. Contracts will no longer rely on Hedera transaction signature presence, but will instead be in accordance with EVM, ERC and ContractId key models noted.
- As part of this release, the network will include logic to grandfather in previous contracts.
- Any contracts created from this release onwards will utilize the stricter security model and as such will not have considerations for top-level signatures on transactions to provide permissions.
- Existing contracts deployed prior to this upgrade will be automatically grandfathered in and continue to use the old model that was in place prior to this release for a limited time to allow for DApp/UX modification to work with the new security model.
- The grandfather logic will be maintained for an approximate period of 3 months from this release. In a future release in July 2023, the network will remove the grandfather logic, and all contracts will follow the new security model.
- Developers are encouraged to test their DApps with new contracts and UX using the new security model to avoid unintended consequences. If any DApp developers fail to modify their applications or upgrade their contracts (as applicable) to adhere to the new security model, they may experience issues in their applications.
This includes,
- CryptoTransfer to non-existing EVM address alias causing hollow-account creation.
- Finalizing a hollow account with the payer signature in an incoming transaction
Use cases for HIP-583 that work in this release :
- 1.As a user with an ECDSA based account from another chain I can have a new Hedera account created based on on my evm-address alias.
- 2.As a developer, I can create a new account using a evm-address alias via the CryptoTransfer transaction.
- 3.As a developer, I can transfer HBAR or tokens to a Hedera account using their evm-address alias.
- 4.As a Hedera user with an Ethereum-native wallet, I can receive HBAR or tokens in my account by sharing only my evm-address alias.
- 5.As a Hedera user with a Hedera-native wallet, I can transfer HBAR or tokens to another account using only the recipient's evm-address alias.
autoCreation.enabled=true
lazyCreation.enabled=true
cryptoCreateWithAliasAndEvmAddress.enabled=false
contracts.evm.version=v0.34
MAINNET UPDATE: FEBRUARY 9, 2023
TESTNET UPDATE: JANUARY 24, 2023
To ensure full test coverage of this intricate feature, it will first be enabled only on previewnet.
➡️ This release will, however, enable contract expiry on all production networks [previewnet, testnet, and mainnet].
This release will not enable smart contract rent.
MAINNET UPDATE: JANUARY 12, 2023
TESTNET UPDATE: DECEMBER 22, 2022
Services v0.33.0 adds the following features:
- Hyperledger Besu EVM updated to version 22.10.x
- 'accounts send' subcommand added to yahcli to support sending HTS token units
- Developer documentation updates
MAINNET UPDATE: DECEMBER 9, 2022
TESTNET UPDATE: DECEMBER 1, 2022
TESTNET UPDATE: NOVEMBER 11, 2022
TESTNET UPDATE: OCTOBER 27, 2022
Services 0.31 completes the following features:
- HIP-542 roadmap for making payer of the
CryptoTransfersponsor forauto-creation. It also enables auto-creation with Token transfers in addition to Hbar transfers. - HIP-573 roadmap for enabling token creators an option to exempt all of their token’s fee collectors from a custom fee.
In addition to the above features,
- Enables Smart Contract Traceability.
- Adds some changes related to testability improvements.
MAINNET UPDATE: OCTOBER 21, 2022
TESTNET UPDATE: OCTOBER 19, 2022
TESTNET UPDATE: OCTOBER 6, 2022
Services 0.30 completes the HIP-514 roadmap for making Hedera native tokens manageable via smart contracts. There are five new system contracts:
getTokenExpiryInfo(address), updateTokenExpiryInfo(address, Expiry), isToken(address token), getTokenType(address token), and updateTokenInfo(address, HederaToken).The
updateTokenInfo(address, HederaToken) call is especially powerful. If a token's admin key signs the transaction calling a contract, that contract can now make itself the token's treasury, assume authority to mint or burn units or NFTs, and so on.⚠️ Contract authors should know this release initiates Hedera's expiration and rent model for contracts. There will be two visible effects immediately after the 0.30 upgrade:
- All non-deleted contracts will have their expiry extended to at least 90 days after the upgrade date.
- Deleted contracts will start to be purged from state; so a
getContractInfoquery that previously returnedCONTRACT_DELETEDmay now reportINVALID_CONTRACT_ID.
About 90 days after the 0.30 upgrade, some contracts will begin to expire. The network will try to automatically charge the renewal fee (approximately
$0.026 for 90 days) to the expired contract's auto-renew account. If an auto-renew account has zero balance, the network will then try to charge the contract itself.A contract unable to pay renewal fees will enter a week-long "grace period" during which it is unusable, unless its expiry is extended via
ContractUpdate or it receives hbar. After this grace period, the contract will be purged from state.We strongly encourage all contract authors to set an auto-renew account for their contract. This isolates the contract logic from the existence of rent.
This release also brings two peripheral improvements:
- 1.It will become possible to schedule a
CryptoApproveAllowancetransaction. - 2.Mirror node operators will be able to use the daily
NodeStakeUpdateexport to track the current values of several key staking properties. Please review the linked protobuf comments for more details on these properties.
MAINNET UPDATE: SEPTEMBER 27, 2022
TESTNET UPDATE: SEPTEMBER 7, 2022
TESTNET UPDATE: AUGUST 30, 2022
In Services 0.29 we have followed the HIP-514 roadmap to give contract authors many new ways to inspect and manage HTS tokens.
The HIP enumerates the ways; examples include a contract that revokes an account's KYC for a token, or deletes a token for which it has admin privileges, or even changes a token's supply key based on the metadata in an NFT!
Note there are four HIP-514 functions that will be part of release 0.30, as follows:
getTokenExpiryInfo(address), updateTokenExpiryInfo(address, Expiry), updateTokenInfo(address, HederaToken), isToken(address token) and getTokenType(address token).Please note this important deprecation that will change how clients fetch token associations and balances after the November release in this year. At that time, mirror nodes will become the exclusive source of token association metadata. This is because HIP-367 made token associations unlimited, so in the long run it will not be efficient for consensus nodes to serve this information.
MAINNET UPDATE: AUGUST 25, 2022
TESTNET UPDATE: JULY 29, 2022
Services 0.28 gives Hedera devs a new dApp building block in HIP-351 (Pseudorandom Numbers). HAPI has a new
UtilService with a prng transaction that generates a record with either a pseudorandom 48-byte seed, or an integer in a requested range.Smart contracts can also get pseudorandom values by calling a new system contract at address
0x169, using the interface here as in this example. Applications might include NFT mint contracts, lotteries, and so on.📝 The HIP-351 text does not yet reflect the name change from
RandomGenerate to prng, or the system contract specification. It does explain in detail how prng derives its entropy from the running hash of transaction records generated by the network.This release also includes some bug fixes and smaller improvements; notably, it:
- 1.Extends
ContractCallLocalsupport to the ERC-20 and ERC-721 functionsallowance,getApproved, andisApprovedForAll. - 2.Permits staking to contract accounts.
MAINNET UPDATE: AUGUST 9, 2022
Any ledger that will grow to billions of entities must have an efficient way to remove expired entities. In the Hedera network, this means keeping a list of NFTs owned by an account, so that when an account expires, we can return its NFTs to their respective treasury accounts.
Under certain conditions in the 0.27.5 release, a bug in the logic maintaining these lists could cause NFT transfers to fail, without refunding fees.
We appreciate the Hedera community working with us on this issue. We invite any users who were affected by this bug to contact support at [email protected]
MAINNET UPDATE: JULY 21, 2022
TESTNET UPDATE: JULY 1, 2022
The 0.27 release of Hedera Services initiates the first phase of HIP-406 (Staking). We deeply appreciate the community’s feedback on this critical feature!
As wallets and exchanges roll out client support, users will now have the choice to stake their hbar to a node. As nodes accumulate stake, from both individuals and organizations, they will become eligible to pay rewards to their stakers. At this point, once the
0.0.800 account balance has crossed a threshold to be set by the council coin committee, rewards will be permanently activated.This will set the stage for the second phase of staking, in which a node’s contribution to consensus becomes a direct function of its stake, and community nodes with sufficient stake can begin to participate in consensus. Please note the decentralized nature of this process makes it hard to predict exactly when each milestone and phase will be achieved. The immediately visible consequences of the 0.27 release will be simply,
- 1.The consensus nodes handle
CryptoCreateandCryptoUpdatetransactions with staking elections---even if not all wallets and exchanges are updated to make these elections just yet.
Observant readers might recall that an earlier alpha release of Services 0.27 also enabled HIP-423 (Long Term Scheduled Transactions). This is a complex feature with some deep implications, and we have decided to defer for one more release before going to production.
MAINNET UPDATE: JUNE 9, 2022
TESTNET UPDATE: MAY 25, 2022
In this release, we are excited to deploy support for HIP-410 (Wrapping Ethereum Transaction Bytes in a Hedera Transaction). and HIP-415 (Introduction Of Blocks).
HIP-410 adds a HAPI
EthereumTransaction by which an account that was auto-created with an ECDSA(secp256k1) key can submit Ethereum transactions to Hedera by signing with its ECDSA key. (Standard Ethereum restrictions on the sender's nonce apply.) Please see HIP-410 for details, including a summary of some very compelling use cases that the EthereumTransaction enables---for example, "I want to use MetaMask to create a transaction to transfer HBAR to another account".HIP-415 also anticipates such use cases by standardizing the concept of a Hedera "block"; this is important for a full implementation of the Ethereum JSON-RPC API. The definition is simple: One block is all the transactions in a record stream file. The block hash is the 32-byte prefix of the transaction running hash at the end of the file. And the block number is the index of the record file in the full stream history, where the first file had index
0.Approved operators can manage an owner's tokens on their behalf; this is necessary for many consignment use cases with third party brokers/wallets/auctioneers.
Any permissions granted in a contract through
approve() or setApprovalForAll() have an equivalent HAPI cryptoApproveAllowance or cryptoDeleteAllowance expression---and this expression is externalized as a HAPI TransactionBody in the record stream. That is, the HIP-376 system contracts expose a subset of the native HAPI operations, only within the EVM.
MAINNET UPDATE: MAY 19, 2022
TESTNET UPDATE: APRIL 26, 2022
TESTNET UPDATE: APRIL 21, 202
The Hedera Services 0.25 release brings good news for HTS users who manage large numbers of token types, as it delivers HIP-367 (Unlimited Token Associations per Account). In particular, a single account can now serve as treasury for any number of token types. (Please do note the
CryptoService HAPI queries still return information for only an account’s 1000 most recently associated tokens; mirror nodes remain the best source for full history.)We are also very excited to announce support for HIP-358 (Allow
TokenCreate through Hedera Token Service Precompiled Contract). This HIP supercharges contract integration, making it possible for a smart contract to create a new HTS token---fungible or non-fungible, with or without custom fees. (An interested Solidity developer might consult the examples in this contract.)In a harbinger of more upcoming HTS precompile support, this release will also enable HIP-336 (Approval and Allowance API for Tokens). Token owners can now approve other accounts to manage their HTS tokens or NFTs, in direct analogy to the
approve() and transferFrom() mechanisms in ERC-20 and ERC-721 style tokens..png?alt=media)
MAINNET UPDATE: APRIL 15, 2022
TESTNET UPDATE: APRIL 7, 2022
TESTNET UPDATE: MARCH 31, 2022
TESTNET UPDATE: MARCH 24, 2022
In the 0.24 release of Hedera Services, we are excited to give smart contract developers a new level of interoperability with native Hedera Token Service (HTS) tokens via HIP-218 (Smart Contract interactions with Hedera Token Accounts). The Hedera EVM now exposes every HTS fungible token as an ERC-20 token at the address of the token’s
0.0.X entity id; and analogously, every HTS non-fungible token appears as an ERC-721 token. This means a smart contract can look up its balance of a fungible HTS token; or change its behavior based on the owner of a particular HTS NFT. Please see the linked HIP for full details.This upgrade also creates two new system accounts 0.0.800 and 0.0.801 that will hold reward funds.
One change to the Hedera API (HAPI) is that we now have enough evidence to conclude the experimental
getAccountNftInfos and getTokenNftInfos queries do not have a favorable cost/benefit ratio, and these queries are now permanently disabled..jpeg?alt=media&token=fb46e121-e8dd-4f4c-8cb6-c51b83257634)
MAINNET UPDATE: MARCH 10, 2022
TESTNET UPDATE: FEBRUARY 17, 2022
Hedera Services 0.23 fleshes out our smart contract service via the implementation of HIP-329 (Support
CREATE2 opcode). Smart contract developers are now free to use the CREATE2 EVM opcode. A typical use case is a distributed exchange that wants its pair contracts to have deterministic addresses based on the tokens in the pair.Please note two issues fixed in this release. First, in release 0.22, the nodes returned the
bytes ledger_id stipulated by HIP-33 as a UTF-8 encoding of a hex string. The returned bytes are now the big-endian representation of the ledger's numeric id. Second, prior to this release, the record of a dissociateToken from a deleted token did not list the discarded balance of the dissociated account if the token's treasury was missing. This is now fixed..jpeg?alt=media&token=97c145de-792e-4a06-9451-e9bd8569a17e)
MAINNET UPDATE: FEBRUARY 3, 2022
TESTNET UPDATE: JANUARY 20, 2022
The 0.22 release is a paradigm shift for Hedera Services, as we deliver the next major step in our Smart Contracts 2.0 roadmap on the strength of the protean HIP-25, a technical foundation for scaling the world state of our ledger to billions of entities without sacrificing the high TPS enabled by the hashgraph consensus algorithm.
Highlights of this release include:
We expect more progress in these directions over the coming releases. Do note that the gas usage of the HTS integrations is still evolving; follow this issue to track the finalized gas charges leading up to mainnet release.
There are two other HIP's included in this release not related to the smart contract service. First, HIP-33 enhances queries like
CryptoGetInfo with a ledger id that marks which Hedera network answered the query. Second, HIP-31 allows a client to include the expected decimals for a token in a CryptoTransfer. This means a hardware wallet can guarantee its token transactions will have the precision seen by the the user in the device display.While we are gaining momentum in our smart contracts roadmap, we are also deeply committed to improving the developer experience, and welcome issues and ideas in our GitHub repository and Discord!
.jpeg?alt=media&token=2455279c-3e3d-4864-90aa-a46852469865)
MAINNET UPDATE: JANUARY 13, 2022
TESTNET UPDATE: DECEMBER 21, 2021
In Hedera Services 0.21 we are pleased to announce support for ECDSA(secp256k1) keys and auto-account creation.
The Ethereum network makes heavy use of ECDSA cryptography with the secp256k1 curve, and by supporting these keys we ease the developer experience of migrating a dApp to Hedera. Anywhere a Ed25519 key can be used in the Hedera API, it is now possible to substitute an ECDSA(secp256k1) key.
Auto-account creation lets a new user receive ℏ via a
CryptoTransfer without having already created an 0.0.X id on the network. The new user only needs to provide their public key, and when a sponsor account sends ℏ "to" their key via a new AccountID.alias field, the network automatically creates an account with their key. Additional transfers to and from an auto-created account may also use its alias instead of the account id.An alias may also be used to get the account balance and account info for the account. (Do note there is a known issue that causes the
getAccountInfo query response to echo back the account alias instead of its 0.0.<num> id; this will be fixed in the next release. Please use the free getAccountBalance query to check the 0.0.<num> id that corresponds to an alias.) You will be able to use the alias in all other transactions and queries in a future release.Meanwhile, our team continues exhaustive due diligence for Smart Contracts 2.0... 🚀
MAINNET UPDATE: DECEMBER 2,2021
TESTNET UPDATE: NOVEMBER 18, 2021
Hedera Services 0.20 is primarily a scaffolding release, as our team is working heads-down to deliver the Smart Contract Service refresh with massive new scale and performance; as well as smart contract integration with native tokens created using the Hedera Token Service. The scope of this refresh is significant, and we believe it will be well worth the wait.
The main deliverables in this release are improved automation for node operators to use in software upgrades; and a handful of minor bug fixes, including for #2432.
Please also note the following deprecations in the Hedera API protobufs:
- The
ContractUpdateTransactionBody.fileIDfield, which is redundant given the existence of theContractGetBytecodequery. - The
ContractCallLocalQuery.maxResultSizefield, as this limit is now simply a side-effect of the given gas limit.
MAINNET UPDATE: NOVEMBER 4,2021
TESTNET UPDATE: OCTOBER 28, 2021
TESTNET UPDATE: OCTOBER 21, 2021
In Hedera Services 0.19, we are thrilled to announce migration of the Hedera smart contract service to the Hyperledger Besu EVM, as laid out in HIP-26. This enables support for the latest v0.8.9 Solidity contracts, and harmonizes our gas schedule with that of the “London” hard fork. The Besu migration also sets the stage for a step change in smart contract performance on Hedera.
Two other HIPs targeting the Hedera Token Service go live in this release. First, the HIP-23 feature set is now enabled, so that any account that has been configured with a non-zero
maxAutoAssociations can receive air-drops (i.e., units or NFTs of a token type without explicit association). Second, we have also implemented HIP-24, which provides a safety measure for token types created with a pauseKey. If a TokenPause is submitted with this key’s signature, then all operations on the token will be suspended until a subsequent TokenUnpause.MAINNET UPDATE: OCTOBER 7, 2021
In Hedera Services 0.18.1, we have a new scalability profile for NFTs in the Hedera Token Service (HTS). Up to fifty million (50M) NFTs, each with 100 bytes of metadata, may now be minted. Of course our
CryptoTransfer and ConsensusSubmitMessage operations are still supported at 10k TPS even with this scale.In this release, we have also enabled automatic reconnect. This feature comes into play when a network partition causes a node to "fall behind" in the consensus protocol. With reconnect enabled, the node can use a special form of gossip to "catch up" and resume participation in the network with no human intervention. This works even when the node has missed many millions of transactions, and the world state is very different from when it was last active.
We are happy to also announce that accounts can be customized to take advantage of the upcoming HIP-23 (Opt-in Token Associations) feature set. That is, an account owner can now "pre-pay" for token associations via a
CryptoCreate or CryptoUpdate transaction, without knowing in advance which specific token types they will use.Once HIP-23 is fully enabled in release 0.19, when their account receives units or NFT's of a new token type via a
CryptoTransfer, the network will automatically create the needed association---no explicit TokenAssociate transaction needed. This supports several interesting use cases; please see the linked HIP-23 for more details.There are three other points of interest in this release.
First, we have removed the HIP-18 limitations noted in the previous release. The
tokenFeeScheduleUpdate transaction has been re-enabled, and multiple royalty fees can now be charged for a non-fungible token type.Second, the address books in system files
0.0.101 and 0.0.102 will now populate their ServiceEndpoint fields. (However, the deprecated ipAddress, portno, and memo fields will no longer be populated after the next release.)Third, please note that the
TokenService getTokenNftInfos and getAccountNftInfos queries are now deprecated and will be removed in a future release. The best answers to such queries demand historical context that only Mirror Nodes have; so these and related queries will move to mirror REST APIs.Developers will likely appreciate two other release 0.18.1 items. First, we have migrated to Dagger2 for dependency injection. Second, there is a new
getExecutionTime query in the NetworkService that supports granular performance testing in development environments.
TESTNET UPDATE: SEPTEMBER 23, 2021
In Hedera Services 0.18.0, we are happy to announce support for HIP-23 (Opt-in Token Associations). This feature lets an Hedera account owner "pre-pay" for token associations via a
CryptoCreate or CryptoUpdate transaction, without knowing in advance which specific token types they will use.Then, when their account receives units or NFT's of a new token type via a
CryptoTransfer, the network automatically creates the needed association---no explicit TokenAssociate transaction needed. This supports several interesting use cases; please see the linked HIP-23 for more details.There are three other points of interest in this release.
First, we have removed the HIP-18 limitations noted in the previous release. The
tokenFeeScheduleUpdate transaction has been re-enabled, and multiple royalty fees can now be charged for a non-fungible token type.Second, the address books in system files
0.0.101 and 0.0.102 will now populate their ServiceEndpoint fields. (However, the deprecated ipAddress, portno, and memo fields will not be no longer be populated after the next release.)Third, please note that the
TokenService getTokenNftInfos and getAccountNftInfos queries are now deprecated and will be removed in a future release. The best answers to such queries demand historical context that only Mirror Nodes have; so these and related queries will move to mirror REST APIs.Developers will likely appreciate two other release 0.18.0 items. First, we have migrated to Dagger2 for dependency injection. Second, there is a new
getExecutionTime query in the NetworkService that supports granular performance testing in development environments.Performance Measurement Results:
MAINNET UPDATE: SEPTEMBER 2, 2021
TESTNET UPDATE: AUGUST 30, 2021
In Hedera Services 0.17.2, we are excited to announce support for HIP-17 (Non-fungible Tokens), with a complementary extension to HIP-18 (Custom Hedera Token Service Fees) that lets an NFT creator set a royalty fee to be charged when fungible value is exchanged for one of their creations.
Unique token types and minted NFTs are more natural for many use cases than fungible token types. The Hedera Token Service now supports both natively, so that a single
CryptoTransfer can perform atomic swaps with any arbitrary combination of fungible, non-fungible, and ℏ transfers. (Please do note that the "paged" getAccountNftInfos and getTokenNftInfos queries will remain disabled until release 0.18.0, as several large performance improvements are pending.)In this release we have made it possible to denominate a fixed fee in the units of the token to which it is attached (assuming the type of this token is
FUNGIBLE_COMMON). Custom fractional fees may now also be set as "net-of-transfer". In this case the recipient(s) in the transfer list receive the stated amounts, and the assessed fee is charged to the sender.There are a few final points of more specialized interest. First, users of the scheduled transaction facility may now also schedule
TokenBurn and TokenMint transactions. Second, network administrators issuing a CryptoUpdate to change the treasury account's key must now sign with the new treasury key. Third, the supported TLS cipher suites have been updated to the following list:- 1.
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384(TLS v1.2) - 2.
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384(TLS v1.2) - 3.
TLS_AES_256_GCM_SHA384(TLS v1.3)
⚠️ There are two temporary limitations to HIP-18 in this release. First, the
tokenFeeScheduleUpdate transaction is not currently available. Second, only one royalty fee will be charged for a non-fungible token type. Both limitations will be removed in release 0.18.0.
TESTNET UPDATE: AUGUST 24, 2021
Please see 0.17.4 release notes.
TESTNET UPDATE: AUGUST 19, 2021
Please see 0.17.4 release notes.
MAINNET UPDATE COMPLETED: AUGUST 5, 2021
TESTNET UPDATE COMPLETED: JULY 22, 2021
In Hedera Services 0.16.0, we are excited to announce support for HIP-18 (Custom Hedera Token Service Fees).
Hedera tokens can now be created with a schedule of up to 10 custom fees, which are either fixed in units of ℏ or another token; or fractional and computed in the units of the owning token. The ledger automatically charges custom fees to accounts as they send units of a fungible token (or ownership of a NFT, see below) via a
CryptoTransfer.When a custom fee cannot be charged, the
CryptoTransfer fails atomically, changing no balances other than for the Hedera network fees.The five case studies in this document show the basics of how custom fees are charged, and how they appear in records. Note that at most two "levels" of custom HTS fees are allowed, and custom fee-charging cannot require changing more than 20 account balances.
⚠️ There is one variation on custom fees that requires a work-around in this release. Specifically, if a fixed fee should be collected in the units of the "parent" token to whose schedule it belongs, then in Release 0.16.0 this must be accomplished using a
FractionalFee as described in this issue. In Release 0.17.0 the more natural FixedFee configuration will be available.In this release, we have also enabled previewnet support for HIP-17 (Non-fungible Tokens). Unique token types and minted NFTs are more natural for many use cases than fungible token types. The Hedera Token Service will soon support both natively, so that a single
CryptoTransfer can perform atomic swaps with any arbitrary combination of fungible, non-fungible, and ℏ transfers.We are very grateful to the Hedera user community for these interesting and powerful new feature sets.
MAINNET UPDATE COMPLETED: JULY 1, 2021
TESTNET UPDATE COMPLETED: JUNE 17, 2021
In Hedera Services 0.15.1, we improved performance and integrated with the latest Platform SDK to enable full support of network reconnect.
These performance improvements let us augment the Hedera world state with records of all transactions handled in the three minutes of consensus time, even when handling 10,000 transactions per second. The HAPI
GetAccountRecords query now returns, from state, all such records for which the queried account was the payer account.We have also finalized the design for the non-fungible token (NFT) support to be added to the Hedera Token Service (HTS) in release 0.16.0. The protobufs for new HAPI operations are available in the 0.15.0 tag of the hedera-protobufs GitHub repository.
To simplify fee calculations, there is now a maximum entity lifetime of a century for any entity whose lifetime is not _already_ constrained by the maximum auto-renew period. A HAPI transaction that tries to set an expiration further than a century from the current consensus time will resolve to
INVALID_EXPIRATION_TIME.MAINNET UPDATE COMPLETED: JUNE 3, 2021
TESTNET UPDATE COMPLETED: MAY 20, 2021
In Hedera Services 0.14.0, we have implemented account auto-renewal according to the specifications of HIP-16. This feature will not be enabled until a later date, after ensuring universal awareness of its impact in the user community.
This release includes notable infrastructure work to enable use of the Platform reconnect feature. Reconnect allows a node that has fallen behind in consensus gossip to catch back up dynamically.
A minor improvement to the Hedera API is that the GetVersionInfo query now includes the optional pre-release version and build metadata fields from the Semantic Versioning spec (if applicable).
To simplify life for system admins who are updating a system account's key, we now waive the signing requirement for the account's new key.
MAINNET UPDATE COMPLETED: MAY 6, 2021
TESTNET UPDATE COMPLETED: APRIL 29, 2021 [v0.13.2]
TESTNET UPDATE COMPLETED: APRIL 22, 2021 [v0.13.0]
In Hedera Services v0.13.0, we have redesigned schedule transactions. The new design gives collaborating nodes a well-defined workflow if they happen to schedule identical transactions, even if they are using different gRPC client libraries (for example, Go and JavaScript). The new design also reduces the number of signatures required to submit a valid
ScheduleSign transaction in many common use cases. Users will be able to schedule CryptoTransfer and ConsensusSubmitMessage transactions in this release. Other transaction types will be introduced in future releases.Note: The schedule transactions feature will not be enabled in this release; it's expected to be enabled on testnet in a subsequent v0.13.2 update on April 29th. This feature is enabled on previewnet.
This release deprecates three fields in the protobuf for system files
0.0.101 and 0.0.102. The three deprecated fields are ipAddress, portno, and memo. When we rely on these fields, we cannot concisely represent node with multiple IP addresses. For example, take mainnet node 0 (account 0.0.3), which as of this writing has proxy IPs 13.82.40.153, 34.239.82.6, and 35.237.200.180. The mainnet 0.0.101 file must include a NodeAddress entry for each proxy, which means duplicating fields like nodeCertHash.The new protobuf avoid this duplication, letting us represent node 0 in a protobuf equivalent of,
{
"nodeId" : 0,
"certHash" : "337390d8fea144afc12e81254a28dac6ea82893836ac072effd85e0a7748580ef28096648c5a7f8dbb4ce81476815137",
"nodeAccount" : "0.0.3",
"serviceEndpoints" : [ {
"ipAddressV4" : "13.82.40.153",
"port" : 50211
}, {
"ipAddressV4" : "34.239.82.6",
"port" : 50211
}, {
"ipAddressV4" : "35.237.200.180",
"port" : 50211
} ]
}
However, Services will continue to populate the deprecated fields in duplicate entries for six months, to give all consumers of files
0.0.101 and 0.0.102 time to prepare for exclusive use of the new format. After six months, we will eliminate the duplication and the ipAddress, portno, and memo fields will be left empty. (The fields will never be removed to ensure it remains possible to parse early versions of these system files.)In a minor point, Services now rejects any protobuf
string field whose UTF-8 encoding includes the zero-byte character; that is, Unicode code point 0, NUL. Databases (for example, PostgreSQL) commonly reserve this character as a delimiter in their internal formats, so allowing it to occur in entity fields can make life harder for Mirror Node operators.To simplify tasks for network admins, we have also streamlined the signing requirements for updates to system accounts, and introduced a Docker-based utility called "yahcli" for admin actions such as updating system files.
MAINNET UPDATE COMPLETED: MARCH 12, 2021
TESTNET UPDATE COMPLETED: FEBRUARY 26, 2021
In Hedera Services v0.12.0, we completed the MVP implementation of the Hedera Scheduled Transaction Service (HSTS) as detailed in this design document. This service decouples what should execute on the ledger from when it should execute, giving new flexibility and programmability to users. Note that HSTS operations are enabled on Previewnet, but remain disabled on Testnet and Mainnet at this time.
We have given users of the Hedera Token Service (HTS) more control over the lifecycle of their token associations. In v0.11.0, deleted tokens were immediately dissociated from all accounts. This automatic dissociation no longer occurs. If account
X is associated with token Y, then even if token Y is marked for deletion, a getAccountInfo query for X will continue to show the association with Y _until_it is explicitly removed via a tokenDissociateFromAccount transaction. Note that for convenience, queries that return token balances now also return the decimals value for the relevant token. This allows a user to interpret e.g. balance=10050 as 100.50 tokens given decimals=2.In a final Hedera API (HAPI) change, we have extended the
memo field present on contract and topic entities to the account, file, token, and scheduled transaction entities. (Note this memo is distinct from the short-lived memo that may be given to any TransactionBodyfor inclusion in the TransactionRecord.) All of these changes to HAPI are now more easily browsed via GitHub pages here; the new hashgraph/hedera-protobufs repository is now the authoritative source of the protobuf files defining HAPI.Apart from these enhancements to HAPI, the "streams" consumable by mirror node operators now include an alpha version of a protobuf file that contains the same information as the
_Balances.csv files. The type of this file is AllAccountBalances.MAINNET UPDATE COMPLETED: FEBRUARY 4, 2021
TESTNET UPDATE COMPLETED: JANUARY 26, 2021
In Hedera Services v0.11.0, we upgraded the record stream format from v2 to v5 and the event stream format from v3 to v5. These changes are described in detail in the "Record and Event Stream File Formats" article.
We also updated startup code to make the number of system accounts in development and pre-production networks match the number of system accounts on mainnet, creating account numbers
900-1000 on startup if they do not exist.MAINNET UPDATE COMPLETED: JANUARY 7, 2021
TESTNET UPDATE COMPLETED: DECEMBER 17, 2020
In Hedera Services v0.10.0, we improved the usability of the Hedera Token Service (HTS) with a
newTotalSupply field in the receipts of TokenMint and TokenBurn transactions. Without this field, a client must follow the entire record stream of a token's supply changes to be certain of its supply at the consensus timestamp in the receipt. (Note that HTS operations are now enabled on Previewnet and Testnet, but remain disabled on Mainnet at this time. Please consult the SDK documentation for HTS semantics.)Also for HTS, we added a property
fees.tokenTransferUsageMultiplier that scales the resource usage assigned to a CryptoTransfer that changes token balances. This scaling factor is expected to be set so that the cost of a CryptoTransfer that changes two token balances is roughly 10x the cost of a CryptoTransfer that changes only two hbar balances.Apart from HTS, this release drops a restriction on what payer accounts can be used for
CryptoUpdate transactions that target system accounts. (That is, accounts with numbers not greater than hedera.numReservedSystemEntities.) In earlier versions, only three payers were accepted: The target account itself, the system admin account, or the treasury account. Other payers resulted in a status of AUTHORIZATION_FAILED. This entire restriction is removed, with one exception---the treasury must pay for a CryptoUpdate targeting the treasury.Apart from these functional changes, we fixed an unintentional change in the naming of the crypto balances CSV file, and improved the usefulness of clients under test-clients/ for testing reconnect scenarios.
MAINNET UPDATE COMPLETED: DECEMBER 3, 2020
TESTNET UPDATE COMPLETED: NOVEMBER 19, 2020
In Hedera Services v0.9.0, we finished the alpha implementation of the Hedera Token Service (HTS). Note that all HTS operations are enabled on Previewnet, but remain disabled on Testnet and Mainnet. Please consult the SDK documentation for HTS semantics.
We made several changes to the HAPI protobuf. First, we removed the deprecated
SignatureList message type. Second, we added a top-level signedTransactionBytes field to the Transaction message to ensure deterministic transaction hashes across different client libraries; the top-level bodyBytes and sigMap fields are now deprecated and the already-deprecated body field is removed. Third, we deprecated all fields related to non-payer records, include account send and receive thresholds. This followed from the effective removal of non-payer records in v0.8.1.For the same reason, the semantics of the
CryptoGetRecords and ContractGetRecords queries have also changed. The only queryable records are now those granted to the effective payer of a transaction that was handled while the network property ledger.keepRecordsInState=true. Such records have an expiry of 180 seconds. It is important to note that because a contract account can never be the effective payer for a transaction, any ContractGetRecords query will always return an empty record list, and we have deprecated the query.MAINNET UPDATE COMPLETED: OCTOBER 22, 2020
TESTNET UPDATE COMPLETED: OCTOBER 7, 2020
The mainnet release includes the 0.8.0 version updates.
TESTNET UPDATE COMPLETED: SEPTEMBER 17, 2020
In Hedera Services v0.8.0, we made several minor fixes and improvements. This tag also includes pre-release implementations of several operations for an incipient Hedera Token Service (HTS).
NOTE: HTS operations will remain disabled in non-development environments for some time. These operations are under active development; please consult
master for up-to-date semantics.- Update Receipt proto to pair each Status with NodeID - Receipt is deleted only when the latest (duplicate) transaction expires.
getTxRecordAPI will continue to return ALL records with the transaction ID.
MAINNET UPDATE COMPLETED: SEPTEMBER 8, 2020
TESTNET UPDATE COMPLETED: AUGUST 20, 2020
In Hedera Services v0.7.0, we’ve moved to Swirlds SDK release
0.7.3 which enables zero-stake nodes to be part of a network without affecting consensus. Hedera Services v0.7.0 migrated to new interfaces and methods provided in this version of the Swirlds SDK. HCS topic running hashes are now calculated including the payer account id. The release includes other minor fixes and improvements.Enhancements
Documentation changes
Bug fixes
MAINNET UPGRADE COMPLETED: AUGUST 6, 2020
TESTNET UPGRADE COMPLETED: JULY 16, 2020
In Hedera Services v0.6.0, we’ve enhanced the Hedera Consensus Service by supporting HCS Topic Fragmentation. We added, into the
ConsensusSubmitMessageTransactionBody, an optional field for the current chunk information. For every chunk, the payer account that is part of the initialTransactionID must match the Payer Account of this transaction. The entire initialTransactionID should match the transactionID of the first chunk, but this is not checked or enforced by Hedera except when the chunk number is 1.Enhancements
- Add support for HCS Topic Fragmentation
Documentation changes
- Protobuf v0.6.0 with HAPI doc update to support HCS Topic Fragmentation
MAINNET UPGRADE COMPLETED: JUNE 18, 2020
TESTNET UPGRADE COMPLETED: JUNE 8, 2020
Version 0.5.8 includes a patch which addresses the resilience of peer-to-peer networking in the hashgraph consensus platform.
TESTNET UPGRADE COMPLETED: MAY 5, 2020
In Hedera Services v0.5.0, we’ve added TLS for trusted communication with nodes on the Hedera network. For better security, only TLS v1.2 and v1.3 with TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 and TLS_RSA_WITH_AES_256_GCM_SHA384 cipher suites are allowed.
We’ve added new metadata in the Hedera NodeAddressBook, accessible in system file 0.0.101. The versions of the node software and gRPC Hedera API (HAPI) are now queryable via GetVersionInfo under the new NetworkService for node and network-scoped operations.
For Hedera Consensus Service, we’ve updated the topic running hash calculation to use the SHA-384 hash of the submitted message, rather than the message itself. This reduces the storage requirements needed to validate the hash of a topic. The record of a ConsensusSubmitMessage transaction that uses the new hashing scheme will have a new topicRunningHashVersion field in its receipt. The value of the field will be 2.
Hedera File Service also has several fixes of note. First, we enabled immutable files. Second, we relaxed the signing requirements for a FileDelete transaction to match the semantics of a revocation service. Third, we fixed a fee calculation bug that overcharged certain FileUpdate transactions.
For Hedera Smart Contract Service, we’ve improved visibility into transactions that create child contracts using the new keyword by putting created ids in the record of the transaction; and we now propagate parent contract metadata to created children.
Finally, if you use the throttle properties in system file 0.0.121 to estimate network performance limits, you will also be interested in a new standardized format of those properties. The lists below contain these and other minor updates, bug fixes, and documentation changes.
Enhancements
- Add support for TLS
- Expand address book metadata
- Return all created contract ids
- Propagate creator contract metadata
- Introduce GetVersionInfo query
- Standardize throttle configuration
- Enforce file.encoding=utf-8 on startup
- Make duration properties inclusive for readability
Bug fixes
- Use message SHA-384 hash in running hash
- Enable immutable files
- Relax FileDelete signing requirements
- Fix sbh calculation in FileUpdate
- Return metadata for deleted files
- Enforce receiver signing requirements during contract execution
- Reject invalid CryptoGetInfo
- Reject CryptoCreate with empty key
- Return NOT_SUPPORTED for state proof queries
- Waive fees for 0.0.57 updating 0.0.111
- Waive signing requirements for 0.0.55 updating 0.0.121/0.0.122
- Waive all fees for 0.0.2
- Do not throttle system accounts
Documentation changes
- Replace “claim” with “livehash” as appropriate
- Standardize and clarify HAPI doc
- Software update includes the ability for Hedera to dynamically set throttles on network transaction types.
- The following throttles would be updated to: 1000 submit messages per second and 5 topic creates per second.
- Reassigning of new Council Member nodes
- Say hello to the Hedera Consensus Service! This release is the first to include HCS, allowing verifiable timestamping and ordering of application messages.
- Network pricing has been updated to include HCS transactions and queries
- Network throttle for HCS set to 1000 tps for submitting messages, and 100 tps for each of the other HCS operations.
- Improved end to end testing.
- General code clean up and refactoring.
- ContractCall - TransactionReceipt response to ContractCall no longer includes the contractID called
- CryptoUpdate - TransactionReceipt response to CryptoUpdate no longer includes the accountID updated
- CryptoTransfer – CryptoTransfer transactions resulting in INSUFFICIENT_ACCOUNT_BALANCE error no longer list Transfers in the TransactionRecord transferList that were not applied
- Java SDK has been updated to support the Hedera Consensus Service
- JavaScript/Typescript SDK has reached version 1.0.0, supporting all four mainnet services
- JavaScript/Typescript SDK supports both running in the browser (with Envoy Proxy) and in Node.
- Go SDK now supports all four mainnet services.
Fees
- Transfer list within transaction records now shows only a single net amount in or out for each account, reflecting both transfers and any fees paid.
- Fixed bug in fee schedule that had resulted in fees for ContractCallLocal, ContractGetBytecode, and getVersion queries being undercharged by ~33%
- The Hedera SDK Extension Components (SXC) is an open sourced set of pre-built components that aim to provide additional functionality over and above HCS to make it easier and quicker to develop applications, particularly if they require secure communications between participants.
- Components use the Hedera Java SDK to communicate with the Hedera Consensus Service.