Skip to content

HIP-1313: Enable a new high volume entity creation option - #1313

Merged
mgarbs merged 4 commits into
mainfrom
high-volume-entity-creation
Dec 16, 2025
Merged

HIP-1313: Enable a new high volume entity creation option#1313
mgarbs merged 4 commits into
mainfrom
high-volume-entity-creation

Conversation

@jsync-swirlds

@jsync-swirlds jsync-swirlds commented Oct 17, 2025

Copy link
Copy Markdown
Contributor

This new option allows a system submitting a transaction that creates a new entity to use a high volume throttle at a potentially increased cost, based on the overall entity creation rate for the network.

  • Added new hip document with HIP number 1313.

@jsync-swirlds jsync-swirlds self-assigned this Oct 17, 2025
@jsync-swirlds jsync-swirlds changed the title Create new HIP to enable a new high volume option Create new HIP to enable a new high volume entity creation option Oct 17, 2025
@jsync-swirlds
jsync-swirlds force-pushed the high-volume-entity-creation branch from d92c6dc to a43a227 Compare October 17, 2025 23:27
@jsync-swirlds
jsync-swirlds marked this pull request as ready for review October 17, 2025 23:31
@jsync-swirlds
jsync-swirlds requested a review from a team as a code owner October 17, 2025 23:31
@jsync-swirlds jsync-swirlds changed the title Create new HIP to enable a new high volume entity creation option HIP-1313: Create new HIP to enable a new high volume entity creation option Oct 17, 2025
@jsync-swirlds jsync-swirlds changed the title HIP-1313: Create new HIP to enable a new high volume entity creation option HIP-1313: Enable a new high volume entity creation option Oct 21, 2025
@mgarbs mgarbs moved this to Draft in HIP Tracker Oct 27, 2025
@mgarbs
mgarbs requested a review from steven-sheehy November 3, 2025 16:18
Comment thread HIP/hip-1313.md
Comment thread HIP/hip-1313.md Outdated
Comment thread HIP/hip-1313.md Outdated
@jsync-swirlds
jsync-swirlds force-pushed the high-volume-entity-creation branch from a43a227 to f7e0581 Compare November 7, 2025 23:03
Comment thread HIP/hip-1313.md
@jsync-swirlds
jsync-swirlds force-pushed the high-volume-entity-creation branch from f7e0581 to f219097 Compare November 18, 2025 02:28
@kpachhai

Copy link
Copy Markdown
Contributor

Under the section "How to Teach This", I see we are showing how someone would opt in to the "priority lane" using the SDK but how would one opt in from the EVM side using smart contracts? The HIP mentions the following 3 transactions would also be eligible to take this "priority lane":

  1. EthereumTransaction
  2. ContractCreate
  3. ContractCall

However, how would someone explicitly be able to use the priority lane from the smart contract side? or is that only possible by the JSON RPC Relay itself?

Comment thread HIP/hip-1313.md Outdated
@jsync-swirlds
jsync-swirlds force-pushed the high-volume-entity-creation branch from f219097 to 3ca1e14 Compare December 2, 2025 01:38
This new option allows a system submitting a transaction that creates a new
entity to use a high volume throttle at a potentially increased cost, based
on the overall entity creation rate for the network.

* Added new hip document with HIP number `1313`.

Signed-off-by: Joseph S <121976561+jsync-swirlds@users.noreply.github.com>
@jsync-swirlds
jsync-swirlds force-pushed the high-volume-entity-creation branch 2 times, most recently from b5ca8ec to 2127aa2 Compare December 4, 2025 22:36
* Trimmed the sample transaction list
* Modified mirror node requirements to note changes to existing
  APIs rather than new APIs.

Signed-off-by: Joseph S. <121976561+jsync-swirlds@users.noreply.github.com>
@jsync-swirlds
jsync-swirlds force-pushed the high-volume-entity-creation branch from 2127aa2 to bd6c180 Compare December 4, 2025 22:37
@EMerchant90

Copy link
Copy Markdown
Contributor

Good to see that this keeps fairness with ordering remaining FIFO and paying more only grants access to additional capacity and not priority within the lane.

Noticed that this was updated to address HAPI transactions and I think this was a solid pivot.

LGTM!

@ty-swirldslabs

Copy link
Copy Markdown
Contributor

Under the section "How to Teach This", I see we are showing how someone would opt in to the "priority lane" using the SDK but how would one opt in from the EVM side using smart contracts? The HIP mentions the following 3 transactions would also be eligible to take this "priority lane":

  1. EthereumTransaction
  2. ContractCreate
  3. ContractCall

However, how would someone explicitly be able to use the priority lane from the smart contract side? or is that only possible by the JSON RPC Relay itself?

We reduced scope to only HAPI transactions, so this is a good question but will be addressed in a future HIP

@akdev

akdev commented Dec 15, 2025

Copy link
Copy Markdown

One question, which may be outside the scope of this HIP, is whether the fee multiplier will be included as part of the transaction fee data in the block stream.

@jsync-swirlds

Copy link
Copy Markdown
Contributor Author

One question, which may be outside the scope of this HIP, is whether the fee multiplier will be included as part of the transaction fee data in the block stream.

I believe whether to include the multiplier in the record stream can be determined during implementation (I would recommend including it, if not too difficult).
The effective multiplier can, or should, be calculable from data already in the block stream; but it might be appropriate to add the multiplier directly to the block stream transaction result entry as well.

Signed-off-by: Michael Garber <michael.garber@hashgraph.com>
mgarbs
mgarbs previously approved these changes Dec 16, 2025
Signed-off-by: Michael Garber <michael.garber@hashgraph.com>
@mgarbs
mgarbs merged commit d1a005d into main Dec 16, 2025
12 of 14 checks passed
@mgarbs
mgarbs deleted the high-volume-entity-creation branch December 16, 2025 15:36
@github-project-automation github-project-automation Bot moved this from Draft to Withdrawn in HIP Tracker Dec 16, 2025
@mgarbs mgarbs moved this from Withdrawn to Last Call in HIP Tracker Dec 16, 2025
@mgarbs mgarbs moved this from Last Call to Hiero Review in HIP Tracker Jan 7, 2026
Neurone pushed a commit to InternetOfPeers/hiero-improvement-proposals that referenced this pull request Jan 15, 2026
…er#1313)

Signed-off-by: Joseph S <121976561+jsync-swirlds@users.noreply.github.com>
Signed-off-by: Joseph S. <121976561+jsync-swirlds@users.noreply.github.com>
Signed-off-by: Michael Garber <michael.garber@hashgraph.com>
Co-authored-by: Michael Garber <michael.garber@hashgraph.com>
@mgarbs mgarbs moved this from Hiero Review to Approved in HIP Tracker Jan 20, 2026
@mgarbs mgarbs moved this from Approved to Final in HIP Tracker Jun 23, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Final

Development

Successfully merging this pull request may close these issues.

8 participants