Skip to content

PG Award Proposal: Scaffold Stellar#63

Open
github-actions[bot] wants to merge 6 commits intomainfrom
proposals/scaffold-stellar
Open

PG Award Proposal: Scaffold Stellar#63
github-actions[bot] wants to merge 6 commits intomainfrom
proposals/scaffold-stellar

Conversation

@github-actions
Copy link
Copy Markdown

@github-actions github-actions bot commented Apr 12, 2026

Scaffold Stellar

Go from idea to app faster with a custom, pluggable CLI; industry-redefining composability powered
by Stellar Registry; and a customizable, modern frontend.

Category Developer Experience
Website https://scaffoldstellar.org/
Repository https://github.com/theahaco/scaffold-stellar/
First Released May 2025
Intake soft-launch
Budget Requested 50000

Project Description

Scaffold Stellar is an open-source developer toolkit for building decentralized applications (dApps)
and smart contracts on the Stellar blockchain. It helps developers go from idea to working full-stack
dApp faster by providing CLI tools, reusable contract templates, integration with Stellar Registry,
and a modern customizable frontend.

Team & Experience

Scaffold Stellar is built and maintained by The Aha Company (formerly Aha Labs), a team of 10+
senior engineers deeply embedded in the Stellar ecosystem.

Early Soroban origin

In 2022 (before Soroban had a name) SDF already had a clear ambition: launch their upcoming smart
contract platform with a “batteries-included” developer experience. The gap was execution capacity:
there was no in-house team available to design and implement the developer workflows needed to make
that promise real. Tyler van der Hoeven went to major blockchain conferences to find the right team,
and identified The Aha Company as the team with the right combination of product mindset and deep
technical ability to “install the batteries.”

Foundational Stellar developer workflows we designed and shipped

We envisioned, architected, and implemented several of the workflows that have become core to Soroban
development on Stellar, including:

  • Stellar CLI smart contract workflows, such as the contract invoke behavior and associated
    developer ergonomics that leapfrog, rather than ape, other blockchain ecosystems, simplifying
    testing, deployment, and interaction.
  • JavaScript developer experience patterns, including the Contract Client behavior in
    stellar-sdk-js, which helps application developers interact with contracts more safely and
    predictably.

Why we were selected for Scaffold Stellar and our SCF track record

In early 2025, SDF searched for a team that could bring a ScaffoldETH-like end-to-end experience to
Stellar. They selected us based on:

  1. our deep CLI & JS expertise proven through shipped core tooling, and
  2. our track record delivering developer infrastructure via SCF, including:

Scaffold Stellar is a direct continuation of that work: turning the hard-won Developer Experience
(DevX) knowledge from core tooling into a “front door” experience that helps developers go from idea
to proof-of-concept quickly, with strong defaults and a convention-over-configuration approach.

Ongoing maintenance and production-grade integration experience

Since then, we have remained engaged with SDF to support and maintain key tooling (most recently
improving Stellar CLI handling of hardware-based keys) and we continue to operate as an
integration partner on production deployments. Notably, we architected and developed Société
Générale’s EURCV
on Stellar (now live), bringing a rigorous, real-world perspective to developer
tooling and reliability requirements.

Deep community participation and ecosystem leadership

Our team includes well-known ecosystem contributors. Several members hold key community roles (e.g.,
SCF Pilot, category delegates) and actively build their own SCF projects (e.g., Moonlight,
Tansu, Stellar Merch Store, PG Atlas
). We contribute to protocol and tooling discussions, provide
developer support at hackathons and conferences, and invest heavily in community outreach and
education. We show up consistently at major events and actively communicate about Stellar, both its
strengths and the practical realities builders need to know.

Cross-ecosystem perspective (DevX benchmarking)

Beyond Stellar, The Aha Company is also an integration partner in other ecosystems (e.g., Filecoin,
XRPL, Cardano, Canton, Starknet
). This gives us a unique ability to benchmark developer experience
across chains and bring proven patterns back to Stellar—while keeping Scaffold Stellar aligned with
what developers expect from modern, full-stack tooling.

Retroactive Impact

  • Scaffold Stellar is in the "recommended resources" for all Stellar hackathons, and was used heavily
    (and enjoyed) in the Mexico City hackathon in March. -Shipped Testnet Registry frontend (current
    URL: https://testnet.rgstry.xyz/) and added relevant Testnet contracts & Wasms to it ahead of
    Mexico City hackathon, as requested by SDF DevRel
  • Recommended in
    the official SKILL.

Past Deliverables

Workstream 1 - Stellar Contract Registry: Launch + Trust + Reproducibility

D1. Registry UI (beta) shipped and publicly deployed

  • Deliver a frontend for exploring and consuming contracts (search/browse, contract pages,
    provenance/metadata, usage instructions).
  • Measure: UI deployed to a public URL + documented usage flows.
  • Issue: Build web UI/search for Registry theahaco/scaffold-stellar#169
  • Ecosystem value: makes contract discovery and reuse real for app developers; reduces repeated
    reinventing of standard components.

Testnet Registry frontend is live at https://testnet.rgstry.xyz/

D2. Namespaces + Security Council operationalization

  • Ship namespace support and publish a clear policy/process for trusted namespaces, backed by an
    active security council.
  • Measure: namespaces live + published policy + initial set of trusted namespaces created.
  • Issue: registry contract: allow namespaces theahaco/scaffold-stellar#22
  • Ecosystem value: reduces name-squatting/confusion and establishes a trust layer for contract
    reuse.

Wasms and contracts can only be deployed to unverified namespace by general users; find
unverified Wasms & contracts in the testnet registry with the unverified/ channel prefix. These
are tracked by a separate registry contract that is itself registered in the root/main registry with
the name unverified (https://testnet.rgstry.xyz/contracts/unverified). This same sub-registry
prefixing strategy will be used in mainnet (theahaco/scaffold-stellar#433)
to create dedicated sub-registries / prefixes for popular ecosystem projects & partners like oz,
blend, and defindex. While the root / main registry contract is managed by the Registry Security
Council multisig wallet, these other subregistries will be managed by each ecosystem's own wallet
(whether or not they use multisig is up to them).

D3. Registry documentation and publishing/consumption flows

  • Publish comprehensive docs for publishing and consuming contracts via CLI/Rust SDK; include
    security model and best practices.
  • Measure: docs live + linked from scaffoldstellar.org + examples runnable end-to-end.
  • Issue: docs: update registry related documentation theahaco/scaffold-stellar#102
  • Ecosystem value: lowers onboarding friction and makes registry usage self-serve.

Registry documentation exists at https://scaffoldstellar.org/docs/registry, which is also linked from
top navigation bar on https://testnet.rgstry.xyz/. Additionally, the Registry web app also shows how
to use registered contracts; see https://testnet.rgstry.xyz/contracts/unverified for an example.

D4. Supply-chain safety design implemented

  • Implement mitigations and clear behavior for common supply-chain risks (e.g., name confusion,
    publisher ambiguity), building on the “supply chain brainstorming” work.
  • Measure: documented threat model + implemented checks/UX cues + test coverage.
  • Issue: Supply chain risks overwatch theahaco/scaffold-stellar#350
  • Ecosystem value: improves ecosystem security posture as reuse increases.

"Flagging" behavior agreed upon by SDF project manager (Steph). "Registry as cross-contract proxy"
functionality implemented in theahaco/scaffold-stellar#461. Additional
functionality based on contract & wasm flagging to be implemented in Q2,
theahaco/scaffold-stellar#452, then communicated to ecosystem.

D5. Reset/reseed tooling for testnet & futurenet

Implemented in https://github.com/theahaco/registry-indexer/pull/3; to be tested during next Testnet
reset.

D6. Publish standard OpenZeppelin-based contracts into the registry

See oz- prefixed Wasms here: https://testnet.rgstry.xyz/wasms

Workstream 2 - Scaffold Stellar Extension/Plugin System + Integrations

D7. Extension/Plugin system shipped

Core extension system shipped in theahaco/scaffold-stellar#414; reporter
extension shipped in theahaco/scaffold-stellar#463.

D8. Wallet integration expansion via wallet kit

Support for all wallet modules shipped in
theahaco/scaffold-stellar-frontend#204.

D9. Indexing services and API integrations as extensions

  • Provide extensions for popular indexing services and explore integration of commonly requested
    APIs (e.g., Soroswap API) as optional add-ons.
  • Measure: at least one indexing extension + one API integration prototype + docs.
  • Ecosystem value: makes it easy for teams to adopt ecosystem infrastructure from day one.

Extensively researched and built with Goldsky to build Stellar Registry UI, and determined this
offering is both too immature to build as a Scaffold Stellar Extension for now, as well as being too
much of an edge case for how the extension system ended up working. We now have prior art to use to
implement a Goldsky extension later, which is being tracked in
theahaco/scaffold-stellar#164

Workstream 3 - Core DX Improvements

D10. New project page design update

Shipped in theahaco/scaffold-stellar-frontend#158

D11. Import existing Soroban contracts into Scaffold projects

Shipped in theahaco/scaffold-stellar#327

D12. stellar scaffold clean to improve iteration loops

The command was shipped here: theahaco/scaffold-stellar#352

Maintenance, Release Management, and Community Support

D13. Ongoing maintenance, releases, and field feedback loop

  • Keep templates current (including OpenZeppelin updates), ship releases, triage issues/PRs, and
    collect feedback from builders at upcoming events.
  • Measure: regular tagged releases + changelogs + public roadmap updates + documented learnings
    from events.

See all our releases with notes at https://github.com/theahaco/scaffold-stellar/releases

Proposed Impact

Scaffold Stellar has now launched Stellar Registry as a separate project, highlighting that this is
not merely a useful tool for learners and first-time Stellar builders. It's the foundation, the hub,
for much of the activity of the Stellar development community. With its recently-launched extension
system, Scaffold is poised to become the test ground, the proving site, for a diverse and composable
ecosystem of plugins, apps, and integrations.

This quarter we will continue to see Scaffold Stellar used as the entrypoint for the Stellar
ecosystem, both in documentation and at hackathons. The new extension system provides a focal point
for a themed hackathon of its own; we will advocate with DevRel to realize this. We will also reach
out to James Bachini to get Scaffold integrated directly into his web IDE, another project in this
Public Goods cohort.

Proposed Deliverables

D1: Support Stellar-Wallets-Kit v2

  • Update to Stellar-Wallets-Kit v2, released v2 in Feb 2025, to streamline Developers' experience and
    keep up to date with the latest standards in the ecosystem.
  • Measure: update shipped in frontend
  • Issue: stellar-wallets-kit v2 theahaco/scaffold-stellar#441
  • Ecosystem value: simplifies Scaffold codebase; keeps apps up-to-date with evolving ecosystem

D2: Allow package manager of choice

  • Rather than forcing people to use NPM with Scaffold, allow them to pick the JS package manager of
    their choosing (yarn, bun, deno, etc)
  • Measure: feature shipped, tested, & documented
  • Issue: Allow users to use pnpm/package manager of choice theahaco/scaffold-stellar#162
  • Ecosystem value: Scaffold today locks users to npm. This is a reasonable default and a common
    preference, but the JS ecosystem is fractured, with many people preferring more recent package
    managers such as yarn, bun, and deno. Supporting these options within Scaffold prevents fracturing
    the Stellar ecosystem, enabling people to use Scaffold while keeping their preferred JS tooling.

D3: BYOFrontend

  • Create two new Aha-maintained Scaffold frontend plugins: 1. no frontend, 2. Svelte. In addition,
    create documentation for how community members can contribute their own frontend templates for use
    with Scaffold Stellar.
  • Measure: feature shipped, tested, documented.
  • Issue: BYOFrontend theahaco/scaffold-stellar#161
  • Ecosystem value: Like D2, this allows people to use Scaffold Stellar even if they don't prefer its
    default options of React and Vite, making the entire stack opinionated but also flexible.

D4: SKILL.md to help agentic workflows

  • Add SKILL.md to Scaffold Stellar repository to facilitate more powerful and accurate AI & agentic
    workflows.
  • Measure: feature shipped, tested, and documented.
  • Issue: SKILL.md to help agentic workflows theahaco/scaffold-stellar#394
  • Ecosystem value: many hackathon participants and serious builders prefer to use AI tools in
    addition to, or rather than, coding by hand. This will make that experience more fool-proof and
    powerful, preventing AIs from making silly mistakes.

D5: Improve Scaffold info on main Stellar docs

  • Minimize the info on the Scaffold Stellar page on the main Stellar docs in line with other tools
    that have their own documentations sites, linking prominently to https://scaffoldstellar.org
  • Measure: new documentation page shipped to main Stellar docs
  • Issue: Improve Scaffold info on main Stellar docs theahaco/scaffold-stellar#361
  • Ecosystem value: consolidate Scaffold documentation to a single place to minimize the amount of
    stale information and highlight important resources, such as the Scaffold Showcase.

D6: Monitor releases of ecosystem projects

  • For Scaffold itself and all projects that are built with it, provide automatic notifications
    (perhaps in the form of GitHub issues or pull requests) when complex ecosystem dependencies, such
    as Stellar-Wallets-Kit, are updated.
  • Measure: system in place for notifying Scaffold team of ecosystem project updates
  • Issue: Monitor releases of ecosystem projects theahaco/scaffold-stellar#301
  • Ecosystem value: These projects release their own updates, sometimes with breaking changes that
    could cause Scaffold Stellar to not work at all, or to be out of date with the latest releases of
    ecosystem projects. Updating the corresponding ecosystem project is not always as simple as
    "increment version number" (although sometimes it is), since, in Stellar Wallets Kit's example, the
    tool may be deeply integrated into Scaffold.

D7: Allow building for testnet when localnet unhealthy

D8: Re-architect stellar scaffold build internals & update to latest best practices

Legal Acknowledgements

  • As the project representative, I agree to the Legal Acknowledgements.

@github-actions github-actions bot added the pg-award-proposal PG Award proposal submission label Apr 12, 2026
@github-actions github-actions bot mentioned this pull request Apr 12, 2026
1 task
chadoh
chadoh previously approved these changes Apr 14, 2026
Comment thread docs/projects/scaffold-stellar.md Outdated
Comment thread docs/projects/scaffold-stellar.md Outdated
Comment thread docs/projects/scaffold-stellar.md Outdated
Comment thread docs/projects/scaffold-stellar.md Outdated
Comment thread docs/projects/scaffold-stellar.md Outdated
Comment thread docs/projects/scaffold-stellar.md Outdated
Comment thread docs/projects/scaffold-stellar.md Outdated
Co-authored-by: Chad Ostrowski <221614+chadoh@users.noreply.github.com>
Signed-off-by: Pamphile Roy <23188539+tupui@users.noreply.github.com>
Copy link
Copy Markdown
Member

@aolieman aolieman left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ecosystem impact checks out! Is there any way to quantify adoption? For example, a GitHub code search which reveals the projects that have used Scaffold, or Registry data as a proxy for the dApps that have relied on Scaffold for their contracts?

My general feedback is that I'd like to see a clearer breakdown of how the proposed deliverables lead to this maximum budget request. Now that Registry has spun off, it's not as clear to me why Scaffold needs to be fully staffed in Q2. I also want Aha to dedicate more time to Registry — which is perhaps contrary to what SDF would like to see.

I can tell that Q2 deliverables D1 and D8 are major refactors. For D2-D7 it's harder for me to estimate the amount of work required.


## D3: BYOFrontend

- Create two new Aha-maintained Scaffold frontend plugins: 1. no frontend, 2. Svelte. In addition,
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add 3. Effect? I hope @waldmatias can pitch this; I only have a hunch of how valuable this would be.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We were going off the most recent State of JS survey trying to make our own little tier list based on a mix of the usage and positivity stats plus GitHub stars. Effect isn't on the list. Maybe that will change for this year's survey, but anecdotally I don't hear many folks talking about it.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I really have to defer to @waldmatias on this. I don't do that much frontend work myself. My poorly informed impression is that Effect has particular advantages for interacting with contracts/RPC.

Comment on lines +222 to +226
Extensively researched and built with Goldsky to build Stellar Registry UI, and determined this
offering is both too immature to build as a Scaffold Stellar Extension for now, as well as being too
much of an edge case for how the extension system ended up working. We now have prior art to use to
implement a Goldsky extension later, which is being tracked in
https://github.com/theahaco/scaffold-stellar/issues/164
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's hard for me to judge how well this does or does not fit into the extension system. It's clear that there is demand for help with indexer integration. Custom indexer integration is a lot of work.

Goldsky should not even be looked into imo. They are not active enough to provide good support for Stellar and to stay on top of Soroban SDK and protocol upgrades.

Mercury has rebooted, and with that, their Retroshades again is an attractive solution for within-contract indexer config.

I feel strongly about adding Obsrvr Flow to complete the batteries-included experience that Scaffold aims to offer. It is extremely performant, low hassle, and completely on top of Stellar protocol evolution.

Comment thread docs/projects/scaffold-stellar.md Outdated
Comment thread docs/projects/scaffold-stellar.md Outdated
Comment thread docs/projects/scaffold-stellar.md Outdated
Comment thread docs/projects/scaffold-stellar.md Outdated
Comment thread docs/projects/scaffold-stellar.md Outdated
@zachfedor
Copy link
Copy Markdown

@aolieman Thanks for the feedback. Speaking toward the level of effort required, D2 and D3 both require some foundational work to turn the scaffold init command into more of an interactive command similar to npm init. They'll also require some orchestration changes within Stellar CLI and other Scaffold commands that are expecting certain project structures.

But the real effort is less obvious. First, Scaffold's frontend is built with Stellar Design System and our Contract Explorer, both of which are React only. Second, every new package manager or framework supported supported by Scaffold will exponentially grow the amount of tests to cover all the combinations.

D4 through D7 are smaller deliverables for sure, although D6 will require some testing and CI work with a fair amount of back and forth with multiple teams (OZ, Creit-Tech, etc.) to figure out release schedules and plans to handle each.

tupui and others added 2 commits April 16, 2026 22:03
Co-authored-by: Zach Fedor <zachfedor@gmail.com>
Signed-off-by: Pamphile Roy <23188539+tupui@users.noreply.github.com>
@oceans404 oceans404 mentioned this pull request Apr 17, 2026
1 task
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

pg-award-proposal PG Award proposal submission

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants