Skip to content

docs(contracts): add gas and resource fee estimation guidance for backend integrators - #1929

Open
ravimahatonp wants to merge 1 commit into
DistinctCodes:mainfrom
ravimahatonp:docs/fee-estimation-guide-1897
Open

ravimahatonp wants to merge 1 commit into
DistinctCodes:mainfrom
ravimahatonp:docs/fee-estimation-guide-1897

Conversation

@ravimahatonp

Copy link
Copy Markdown

Summary

Closes #1897

Provided comprehensive gas and resource fee estimation guidance for backend engineers invoking the payment_escrow and revenue_distribution smart contracts from NestJS (backend/src/payments/soroban).

Key Changes

  1. contracts/GAS_AND_FEE_ESTIMATION.md: Created a detailed fee estimation guide:
    • Breakdown of Soroban transaction costs: Inclusion Fee (base_fee) vs Resource Fee (CPU instructions, RAM memory bytes, ledger read/write entries).
    • Resource footprint benchmarks for payment_escrow methods (create, release, refund, get_status) and revenue_distribution batch distribution.
    • Recommended 20% simulation safety buffer formula to prevent BudgetExceeded panics during ledger state bumps.
    • Integration walkthrough for @stellar/stellar-sdk using simulateTransaction and handling restorePreamble for expired storage rent footprints.
    • Network congestion and failure retry policies.
  2. contracts/README.md: Linked the guide under ## Gas & Fee Estimation.

@vercel

vercel Bot commented Oct 1, 2026

Copy link
Copy Markdown

@ravimahatonp is attempting to deploy a commit to the naijabuz's projects Team on Vercel.

A member of the Team first needs to authorize it.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

No documented gas/fee estimation guidance for backend integrators calling the contracts

1 participant