From 33249533429a72533ea7437624cdf3b5930a0954 Mon Sep 17 00:00:00 2001
From: "john.xlm" <60260750+JFWooten4@users.noreply.github.com>
Date: Tue, 28 Apr 2026 09:10:06 -0400
Subject: [PATCH 01/10] inline note
---
docs/learn/fundamentals/fees-resource-limits-metering.mdx | 8 +++++++-
1 file changed, 7 insertions(+), 1 deletion(-)
diff --git a/docs/learn/fundamentals/fees-resource-limits-metering.mdx b/docs/learn/fundamentals/fees-resource-limits-metering.mdx
index cef23d2a46..225697df27 100644
--- a/docs/learn/fundamentals/fees-resource-limits-metering.mdx
+++ b/docs/learn/fundamentals/fees-resource-limits-metering.mdx
@@ -29,7 +29,13 @@ All smart contract transactions require a resource fee in addition to an inclusi
Transactions that do not execute a smart contract can be thought of as having a resource fee of zero (`resourceFee == 0`). Conversely, for smart contract transactions, you can subtract the resource fee from the total transaction fee to derive the equivalent classic transaction fee component, which is the inclusion fee.
- _\* Diagram: Solid line boxes are what is actually present in the transaction, while dotted lines are derivable._
+ _\*
+
+:::note
+
+Solid line boxes are what is actually present in the transaction, while dotted lines are derivable.
+
+:::
Smart contracts on Stellar use a multidimensional resource fee model that charges fees for several resource types using [network-defined rates](https://lab.stellar.org/network-limits) on the Stellar Lab. The resource fee is calculated based on the resource consumption declared in the transaction and can fluctuate based on a mutable storage write fee (more on that in the [Storage Dynamic Pricing section](#dynamic-pricing-for-storage) below). If the transaction attempts to exceed the declared resource limits, it will fail. If the transaction uses fewer resources than declared, there will be no refunds [(with a couple of exceptions)](#refundable-and-non-refundable-resource-fees).
From 3c16798b6c6358a68cc65064b3dd26cc7ce5e23c Mon Sep 17 00:00:00 2001
From: "john.xlm" <60260750+JFWooten4@users.noreply.github.com>
Date: Tue, 28 Apr 2026 09:10:21 -0400
Subject: [PATCH 02/10] starthitg code
---
docs/learn/fundamentals/fees-resource-limits-metering.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/learn/fundamentals/fees-resource-limits-metering.mdx b/docs/learn/fundamentals/fees-resource-limits-metering.mdx
index 225697df27..2b8a40a79e 100644
--- a/docs/learn/fundamentals/fees-resource-limits-metering.mdx
+++ b/docs/learn/fundamentals/fees-resource-limits-metering.mdx
@@ -29,7 +29,7 @@ All smart contract transactions require a resource fee in addition to an inclusi
Transactions that do not execute a smart contract can be thought of as having a resource fee of zero (`resourceFee == 0`). Conversely, for smart contract transactions, you can subtract the resource fee from the total transaction fee to derive the equivalent classic transaction fee component, which is the inclusion fee.
- _\*
+block-beta columns 6 txFee["tx.fee"]:6 resourceFee["tx.v1.sorobanData.resourceFee"]:5 inclusionFeeTop["inclusion
fee"]:1 fixed["fixed resource fee calculated based on tx.v1.sorobanData.resources.*
instructions
read
write
bandwidth (size of tx)"]:4 refundable["refundable
resource fee
rent
events
return value"]:1 inclusionFeeBottom["inclusion
fee"]:1 style inclusionFeeTop stroke-dasharray: 8 6 style fixed stroke-dasharray: 8 6 style refundable stroke-dasharray: 8 6 style inclusionFeeBottom stroke-dasharray: 8 6
:::note
From 0aa8461af1454e7a8c04919f8fd3287423db5a52 Mon Sep 17 00:00:00 2001
From: "john.xlm" <60260750+JFWooten4@users.noreply.github.com>
Date: Tue, 28 Apr 2026 09:11:07 -0400
Subject: [PATCH 03/10] impornt meraamid
---
docs/learn/fundamentals/fees-resource-limits-metering.mdx | 2 ++
1 file changed, 2 insertions(+)
diff --git a/docs/learn/fundamentals/fees-resource-limits-metering.mdx b/docs/learn/fundamentals/fees-resource-limits-metering.mdx
index 2b8a40a79e..bbaf49d7bd 100644
--- a/docs/learn/fundamentals/fees-resource-limits-metering.mdx
+++ b/docs/learn/fundamentals/fees-resource-limits-metering.mdx
@@ -5,6 +5,8 @@ description: "Learn how fees, resource limits, and metering work on the Stellar
sidebar_position: 70
---
+todo mermaid !
+
# Fees, Resource Limits, and Metering
## Fees overview
From 6c0466c00d1b7ce2c1be4944067a31c5b326b0f5 Mon Sep 17 00:00:00 2001
From: "john.xlm" <60260750+JFWooten4@users.noreply.github.com>
Date: Tue, 28 Apr 2026 09:11:43 -0400
Subject: [PATCH 04/10] rm png
---
static/assets/diagrams/soroban_fees.png | Bin 99373 -> 0 bytes
1 file changed, 0 insertions(+), 0 deletions(-)
delete mode 100644 static/assets/diagrams/soroban_fees.png
diff --git a/static/assets/diagrams/soroban_fees.png b/static/assets/diagrams/soroban_fees.png
deleted file mode 100644
index 6d9c864d52955a9202adbefc67c2ebc873a68489..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001
literal 99373
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