Add a key simulation tool on the key detail page allowing users to model different buy scenarios

[Chucks1093]

Summary

Users want to understand how the bonding curve price will change at different quantities before committing funds. A simulation panel on the key detail page that uses the simulate_buy view function to show price at 1, 5, 10, and 50 keys would help buyers make informed decisions.

Scope

• Add a Price Simulator section on the key detail page below the price chart
• Fetch simulated prices from GET /keys/:keyId/simulate?quantity=1,5,10,50 in a single request
• Render a table with columns: Quantity, Price per Key, Total Cost, Price Impact (%)
• Allow users to enter a custom quantity and fetch the simulation on the fly with a 300ms debounce
• Show a loading skeleton for the table while fetching

Acceptance Criteria

• Preset quantities (1, 5, 10, 50) rendered with correct simulated prices on load
• Custom quantity input fetches and updates the row with a 300ms debounce
• Price Impact computed correctly as (simulated_price - spot_price) / spot_price * 100
• Loading skeleton shown during fetch
• Table hidden when the simulate endpoint returns an error

ETA: 12 hours

---

Coordinate on Telegram

[probablyABug]

@probablyABug has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

hi, i would like to work on this.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @probablyABug to this issue.

[diahtech1]

@diahtech1 has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

please assign to me

ℹ️ Repo Maintainers: To accept this application, review their application or assign @diahtech1 to this issue.

[acejayl]

@acejayl has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

This one's nicely contained since simulate_buy is a read-only view, so nothing I add can move funds. Plan: a simulation panel on the key detail page that calls simulate_buy for 1, 5, 10 and 50 keys and shows the price at each, including the average price per key so the curve's effect is obvious rather than implied. I'd batch the calls and handle the loading and error states so a failed RPC shows a message instead of stale numbers, and reuse whatever formatting helper the page already uses for prices so it matches the rest of the UI. Happy to take it on.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @acejayl to this issue.

[Salome-Agu]

@Salome-Agu has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Hello maintainer, i can fix this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Salome-Agu to this issue.

[Okorie2000-code]

@Okorie2000-code has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Hi maintainer!
I’d love to help out with this issue. I’ve checked the current codebase/documentation and know exactly what needs to be updated to make this clearer. I will ensure everything aligns perfectly with your existing contribution guidelines.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Okorie2000-code to this issue.

[Baytizz]

@Baytizz has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

I would like to work on this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Baytizz to this issue.

[sudo-robi]

@sudo-robi has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Hi maintainer I'm a full stack developer and smart contract developer and auditor let me help you resolve this issue and I assure you it will be thoroughly done neatly as I have seen my way to solve the issue.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @sudo-robi to this issue.

[Wiseman52]

@Wiseman52 has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Hi, kindly assign task. I’ve carefully reviewed the requirements and understand what is needed to resolve the issue.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Wiseman52 to this issue.

[Komelove]

@Komelove has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

I’d be happy to take this issue. I’ve looked through the requirements and have a plan for approaching the implementation. I’ll investigate the existing code and dependencies, make the required changes, verify the behaviour with tests, and provide a concise PR explaining what was changed. I can start immediately and will communicate any blockers during development.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Komelove to this issue.

[jaynomyaks]

@jaynomyaks has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Hello! I'm experienced with Node.js, TypeScript, APIs, databases, and backend architecture. I've reviewed the issue and I'm confident I can implement the required solution efficiently. I'd love to contribute—please assign me.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @jaynomyaks to this issue.

[flexocode442]

@flexocode442 has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

‎Hello Maintainer, I’ve reviewed the issue description and I’m confident I can work on it effectively. Please assign it to me.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @flexocode442 to this issue.

[davedumto]

@davedumto has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Hello can i work on this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @davedumto to this issue.

[drips-wave]

Congratulations, @davedumto! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on August 31, 2026.

🧑‍💻 @davedumto: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊