Feature/stellar fees

[abbys-code-hub]

Closes #36

docs: add Stellar fee estimation and budgeting guide

Objective

This PR introduces a comprehensive guide detailing Stellar's classic transaction fee model, Soroban's multi-dimensional resource fees, fee-bump sponsorship mechanisms, and production budgeting heuristics. It also updates navigation and cross-links the new guide across the documentation site.

Changes

1. New Content

stellar-fees.mdx
:
Explains the hybrid fee structure (Inclusion Fee + Soroban Resource Fee).
Breaks down the multi-dimensional Soroban resource dimensions (CPU, RAM, read/write entries/bytes, and event bytes).
Discusses classic and Soroban surge pricing models.
Explains Fee-Bump Transactions and how they enable fee-sponsored, gasless stealth address UX.
Cites exact audited baseline resource consumption numbers from contracts/stellar/PERF.md for the entire contract suite (stealth-announcer, stealth-registry, stealth-sender, and wraith-names).
Establishes annual storage rent estimates under Protocol 23's low-fee model.
Provides worked step-by-step examples for Send, Withdraw, and Batch Send (10 recipients).
Contains an SDK integration code sample showing how to use rpcServer.prepareTransaction to simulate and estimate fees.
2. Navigation & Syntax Fixes
docs.json: Registered /guides/stellar-fees in the sidebar and fixed a missing comma syntax error in the Guides array.
3. Cross-Linking
getting-started.mdx: Added a reference under Next Steps to guide developers to fee documentation.
sdk/chains/stellar.mdx: Renamed the Troubleshooting section to Troubleshooting & Fees and added links to the new guide.
4. Dependency Updates
Committed package-lock.json following package resolution checks.
Verification and Testing
Snippet Compiler Check (npm run check:snippets): All MDX code blocks successfully compiled and typechecked:

MDX files scanned: 29
Code fences found: 307
Checked snippets: 299
Skipped no-check snippets: 8
Snippet check passed.
Testnet Node Check (npm run check:stellar-testnet): Stellar testnet endpoints verified:

Stellar testnet checks passed: root, latest ledger, fee stats, native asset, operations

[drips-wave]

@abbys-code-hub Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

[truthixify]

The Stellar fees guide content + cross-links look good. One blocker: 2184-line package-lock.json shouldn't be in the PR (this repo uses pnpm).

rm package-lock.json
git add package-lock.json
git commit --amend --no-edit
git push --force-with-lease

Then I will merge.

[abbys-code-hub]

The Stellar fees guide content + cross-links look good. One blocker: 2184-line package-lock.json shouldn't be in the PR (this repo uses pnpm).

rm package-lock.json
git add package-lock.json
git commit --amend --no-edit
git push --force-with-lease

Then I will merge.

Hi... I have made the changes you mentioned

[truthixify]

Lockfile gone — good. But the rebase needs another pass because more docs PRs landed since: now conflicts in docs.json and sdk/chains/stellar.mdx.

git fetch origin
git rebase origin/develop
git push --force-with-lease

Stellar fees guide content lands clean.