feat: Support Soroban WASM contract upload from URL

[dotunv]

Overview

Support uploading Soroban WASM contract code from a URL instead of requiring users to upload the binary file directly.

Motivation

Developers often host their compiled WASM contracts on GitHub releases, IPFS, or their own servers. Requiring direct file upload forces them to download the binary first, adding friction to the deployment workflow.

Proposed Design

1. Extend the contract deploy endpoint to accept a wasm_url field in addition to file upload
2. Download the WASM binary from the URL with a size limit (e.g., 5MB)
3. Validate the downloaded content is valid WASM before deployment
4. Cache downloaded WASM by content hash to avoid re-downloading for duplicate deployments
5. Support ipfs:// and ar:// URL schemes via gateway resolution

Acceptance Criteria

• Contract deploy accepts wasm_url parameter
• Downloaded WASM is validated before deployment
• File size limit is enforced (5MB default)
• Content hash caching prevents redundant downloads
• IPFS and Arweave URLs are resolved via public gateways
• Error handling covers invalid URLs, timeout, and oversized files
• Integration tests cover URL-based deployment flow

Labels

enhancement, backend, Maybe Rewarded, GrantFox OSS, Official Campaign

[samueldoo]

Hello Maintainer, I’d love to take ownership of this issue and submit a high-quality pull request once completed.

[badmusdare4]

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

Can I work on this issue

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

[billcode124]

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

Hi maintainer, can I work on this now?

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

[drips-wave]

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

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