How-to: add a contract function and expose it in the app

Branch: Open your PR against dev. PRs targeting main are closed automatically.

Description:
Write contracts/docs/howto-add-contract-function.md: the full path from a new #[contractimpl] function to a working UI action — Rust implementation, tests, snapshot updates, rebuild and redeploy, frontend invocation through apps/web/src/lib/soroban.ts and Freighter, and backend sync if the function emits an event the Stellar listener should record.

Acceptance criteria:

A worked example of a small read-only function and a small state-changing one
Documents regenerating test_snapshots/ and the CI checks that will fail if it is forgotten
Documents the frontend side: building, simulating, signing and submitting the call
Documents when the backend's Stellar listener (Rate limiting on the key-bundle fetch endpoint #331) must change, and links to the events reference (Device identity keypair persistence via IndexedDB #351)

@Luna-netty

@Luna-netty has applied to work on this issue as part of the Stellar Wave Program's 10th wave.

Hello Maintainer, I'd like to take this issue. I'll begin immediately and work toward delivering a clean, production-ready PR within an hour or two if assigned now.

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

@fortunesayspump

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

Hi maintainers — I checked the current dev branch before applying. The requested contracts/docs/howto-add-contract-function.md is absent; the existing deployment guide covers today’s build/deploy/invoke flow, and apps/web/src/lib/soroban.ts shows the current Freighter simulate–sign–submit–poll path, but there is no contributor walkthrough for carrying a new #[contractimpl] function through the whole stack. After assignment, I’ll write that focused guide with one small read-only and one state-changing worked example, covering Rust implementation and tests, snapshot regeneration and the CI checks that enforce it, rebuild/redeploy, frontend construction, simulation, Freighter signing and submission, and when emitted events require apps/backend/src/services/stellarListener.ts changes. I’ll cross-link #331 and the existing contract-events reference, verify every path and command against dev, and target the PR to dev as required. I’ll wait for assignment before editing.

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

@kosisochukwu1234

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

Hello, I would love to take on this issue. I'm a software engineer with over 4 years experience. and i'm confident I can resolve this issue

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

@Themancalledpg

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

hey maintainer please can i work on this issue?

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

@Themancalledpg

Congratulations, @Themancalledpg! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on October 22, 2026.

🧑‍💻 @Themancalledpg: 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 🌊

docs: message edit/delete semantics, AI assistant bridge, push decisi…

Closed by #680, merged into dev.

@Themancalledpg

This issue has been completed by @Themancalledpg as part of the Stellar Wave Program's 10th Wave 🥳

😎 @Themancalledpg: You earned 200 Points for completing this issue! Once the Wave's rewards are finalized, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here. You can also Leave a review to share your experience working on this issue.

🧑‍💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.

Navigation Menu

Repository navigation

How-to: add a contract function and expose it in the app #635

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

How-to: add a contract function and expose it in the app #635

Description

Activity

Luna-netty commented on Oct 19, 2026

fortunesayspump commented on Oct 20, 2026

kosisochukwu1234 commented on Oct 20, 2026

Themancalledpg commented on Oct 20, 2026

drips-wave commented on Oct 20, 2026

github-actions commented on Oct 22, 2026

drips-wave commented on Oct 22, 2026

Metadata

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

Issue actions