Repository navigation
Conversation
4e3b974 to
a96a30a
Compare
There was a problem hiding this comment.
Good stuff. I can add my ideas as separate deliverables tomorrow, but here were my rough notes before I looked at this; def some overlap:
# overarching story for Q4: Registry is ready, now drive adoption
Registry is now a sophisticated product that offers huge productivity gains across the Stellar ecosystem. Now we help people unlock those gains. And let's ship the stuff they already said they want, and that we know will help them do even more with Registry.
- Onboard N community partners (2 or 3?)
- personalized intro session for their teams
- send PRs to integrate Registry into their codebases/workflows
- transfer authorship/admin rights on Registry Wasms/Contracts/Accounts to them
- Stellar.Expert to show Registry info
- Any other "get them to use Registry" products/partners to target?
- All outstanding "stretch goals" from Q3 roadmap
- including `import_contract!` macros; we need this early so Scaffold can consume it
- G-address maturation
- support C-address accounts (smart accounts)
- governance forms to request them
- `stellar-registry/actions` maturation and adoption throughout Aha-maintained contracts
- also make actual create `upgrade` proposal on Tansu
- UI refresh
- debugger for SACs
- less space taken by metadata
- page-per-function for debugger (show list of all functions in sidebar, like RAEN, with a separate URL for each)
- URL-encode the filled values in the debugger
- implement [Soroban Simulator](https://theahaco.github.io/soroban-sim/) to bypass `simulate` network call|
Go forth and push your commits! For onboarding partners, my only hesitations there are to have a clear idea of the who, and that they're on board, before we put it in our concrete goals. For example, we manage OZ's published right now, right? Could we get them onboarded? Does XOXNO have any relevant contracts for us to work together on? that line of thinking. |
|
🤖 Automated Housekeeping: I detected merge commits in this branch. To keep our history linear, I have automatically rebased your changes onto
|
|
The failing This workflow is inherited from the upstream SCF repo. It will fail the same way on every push to any PR targeting the proposals branch, so a re-run won't help. Its later step would also overwrite the PR body with the file contents. Fixing it means disabling or scoping this workflow in our fork, which is outside this PR. Generated by Claude Code |
|
🤖 Automated Housekeeping: I detected merge commits in this branch. To keep our history linear, I have automatically rebased your changes onto
|
…ification - D6: list merged governance form PRs; subregistry form and live end-to-end proposal remain pending - D8: mark complete as scoped down to contract support (contracts#37, SCF-Public-Goods-Maintenance#38); UI/CLI/docs/adoption proposed for Q4 - D9: list SEP-58 indexer + Wasm page work; contract page and independent verifier status remain pending Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01RBsh3GR3B9UhLBNTv8eqPJ
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01RBsh3GR3B9UhLBNTv8eqPJ
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01RBsh3GR3B9UhLBNTv8eqPJ
Co-authored-by: Chad Ostrowski <221614+chadoh@users.noreply.github.com> Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01RBsh3GR3B9UhLBNTv8eqPJ
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01RBsh3GR3B9UhLBNTv8eqPJ
Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KoeERVajCgEAd3mhfNCye3
3b15dcf to
41122e5
Compare
|
The Generated by Claude Code |
|
Thanks @pselle; this PR got all fucked up because the target branch had the name that the upstream repo keys on. I'm going to move this all to a newly-created |
Stellar Registry
Stellar Registry is an on-chain smart contract registry for Soroban that lets developers publish,
version, discover, and deploy Wasm binaries and contract instances, making contracts reusable across
the ecosystem like packages.
Project Description
Registry is the missing infrastructure layer between "I wrote a smart contract" and "the ecosystem
can safely use my smart contract."
Registry tracks two things:
well as tracking a contract's owner and its Wasm.
(Wasm) binary that defines its behavior. Many contracts can use the same Wasm binary, but today
that's impractical because Wasms are identified only by a gobbledigook ID.
Registry makes these usable. It gives them both names and versions, making the development
experience feel like familiar package management—like crates.io or NPM.
Team & Experience
Scaffold Stellar is built and maintained by The Aha Company, a team of 13+
senior engineers deeply embedded in the Stellar ecosystem.
Copy/update rest of bio from Q3 proposal
Retroactive Impact
In Q3 2026...
Q3 Deliverables
✅ D1: Complete the Mainnet Launch (carried from Q2)
Description from last quarter:
✅ Complete
stellar registrycommands working across both testnet and mainnet (see @kalepail's request at Registry request: project subregistries for the KALEpail estate (kale/,kalepail/,kalien/,smart-account-kit/,passkey-kit/) gov#1 as proof)Q3 stretch goal (not hard-committed in Q3 deliverables; nice-to-have):
✅ D2: Release
import_contract!(carried from Q2)Description from last quarter:
✅ Complete
The macro has landed! This was a hefty engineering task that entailed two large-scale re-architectures, code consolidation from other repositories (
stellar-scaffold/clirepo is no longer the home of related macrosimport_contract_client!andimport_asset!), and the creation of a newstellar-registry-namecrate. With this release, we declared all Stellar Registry crates to have reached official beta, marking them all as version 0.1.0.import_contract!documentation and examples at both crates.io and docs.rsimport_contract!added in macro's introductory PR atcrates/stellar-registry-macro/src/contract.rs; all tests run on every commit to the GitHub repoQ3 stretch goal (not hard-committed in Q3 deliverables; nice-to-have):
import_contract!macro contracts#24Once this is done, people will have not just the documentation examples from crates.io and docs.rs, but a cookbook-style example using real working code.
✅ D3: Flagged Contract Enforcement at Build Time (carried from Q2)
Description from last quarter:
✅ Complete
import_contract!introductory PR added flagged-contract handling (see in PR'scrates/stellar-registry-macro/src/contract.rs#157or onmain)stellar registry fetch-contract-idto fail-by-default for flagged contracts. Sinceimport_contract!relies onfetch-contract-id, it also satisfies the requirement to prove the behavior for the macro.)✅ D4: Finish Search, Pagination & Sorting on rgstry.xyz (carried from Q2)
Description from last quarter:
✅ Complete
✅ D5: Contract Explorer, Deploy Button & Verified-Build Badges (carried from Q2)
Description from last quarter:
✅ Complete
Description from last quarter:
✅ Complete
Tracking issue: stellar-registry/ui#51. A new Governance section on rgstry.xyz hosts one form per operation. On testnet, a form builds the on-chain outcome transaction, pins
proposal.mdto IPFS, and creates a Tansu proposal signed with the user's wallet. On mainnet, the form opens a prefilled issue in https://github.com/stellar-registry/gov.preauthorize_author_transfer(feat: callpreauthorize_author_transferto transfer wasm authorship contracts#34), but long-term need for this as a governance form has been judged dubious upon further review. (In the short-term, Wasms & Contracts seeded as part of initial Registry rollout need to be transferred to their appropriate teams. Beyond this one-time mass authorship reassignment, there will be no steady-state demand for this governance operation.)trigger, and link the transaction here✅ D7: Registry Documentation & Education (carried from Q2)
Description from last quarter:
✅ Complete
Q3 stretch goals:
✅ D8: Support named G-addresses
Description from last quarter:
✅ Complete
Scope was narrowed during Q3 to foundational contract-level support; see tracking issue stellar-registry/cli#51.
accountnamespace in the registry contract withregister_accountandfetch_account_id/fetch_account_owner, using the same auth style asregister_contractAddresshas no muxed variant, so muxed IDs can't be represented on-chainDisplaying names in the rgstry.xyz UI (e.g. "Deployer" and "Admin" fields), CLI support, documentation and community outreach, and onboarding non-Aha addresses will be proposed as Q4 work.
✅ D9: Surface emerging Source Verification information
Description from last quarter:
✅ Complete
✅ D10: guide Tansu evolution to support Registry needs
Description from last quarter:
✅ Complete
841dd84, "Add the registry manager to tansu itself", merged to Tansumainon 2026-09-02 (Radicle tracking issue https://radicle.network/nodes/radicle.consulting-manao.com/rad%3AzssaAF91kxuquZmZCV2SiK2FNX6s/issues/3111b944792c0b5da9f6c8f88e52cdeebd1a3d82)tansu-stubregistry-tansu-managerandtansu-stubfrom stellar-registry/contracts: Remove registry-tansu-manager and tansu-stub now that Tansu hosts the manager contracts#49✅ D11: Registry GH Workflow to publish Wasms and upgrade contracts
Description from last quarter:
✅ Complete
main, https://stellar.expert/explorer/testnet/tx/5793597e4fce5cc536d22263d57bd583d06da2d8e4a648e3b268bc29c0a52cbc demonstrates that it works.github/workflows/build.ymlto newstellar-registry/releaserepo oz-combined-wasms#1, adding new Registry GitHub workflow to ouroz-combined-wasmsrepository✅ D12: UI: Expose full contract version history
Description from last quarter:
✅ Complete
Stretch Goal: UI improvements to make "Versions" experience consistent across app: stellar-registry/ui#63
✅ D13: Documentation consolidation & redesign; potential migration of rgstry.xyz
Description from last quarter:
✅ Complete
domain move discussion: no public link. History of discussion:
✅ D14: Extend
import_contract!macro to support SAC and XLMDescription from last quarter:
Note that
import_asset!was already available and reasonable as an alternative at the end of Q2. The goal here is to ensure thatimport_contract!(xlm)and similar (such asimport_contract!("circle/usdc")) work as-expected, so that users have a choice betweenimport_asset!andimport_contract!, whereimport_contract!alternative works for any SAC registered in stellar.rgstry.xyz.✅ Complete
✅ D15: Verified Build Integration with Stellar Expert
This is copied from D6 in Q2, as outlined in the Q3 Proposal discussion. It was not hard-committed in the Tansu vote, but was soft-committed in the linked discussion.
Description from Q2:
Extra details from Q3 Proposal discussion:
✅ Complete
Q3 Stretch Goals
Proposed Q4 Impact
Overarching Q4 story: Registry is ready, now drive adoption.
Q3 saw Registry become a sophisticated product offering huge productivity gains to any team that adopts it. And: the more everyone adopts it, the more everyone benefits. In Q4 we accelerate those gains.
We'll also ship the stuff early adopters have already asked for.
Proposed Q4 Deliverables
D1: Help Community Projects Use Registry Internally
Work intensively with at least two key partners to onboard their projects to Registry, specifically focusing on improvements to their toolchains and processes. This deliverable is about getting partners to use Registry in their own workflows. Along the way, we will discover Registry gotchas, improving the product to accelerate further rollout.
Possible partners & projects: XOXNO, Reflector (Orbitlens), Stellar Broker (Orbitlens), Crossmint (Overcat), Rozo (Shawn), LiFi, Soroswap (Palta Labs / Esteblock).
Value to ecosystem: more teams are saving time by using Registry and their contracts and Wasms are easier to find & use for the rest of the ecosystem.
Issue: stellar-registry/ui#102
Proof:
D2: Help Community Projects Show Registry Info
Starting with Stellar.Expert, we'll help community partners display Registry info, turning opaque hashes and IDs into human-friendly names.
Value to ecosystem: in the systems that people are already relying on, contracts and Wasms are identified by human-friendly names and versions, rather than opaque hashes and IDs.
Issues:
Proof:
D3: Developer outreach & education
We will continue to present and teach about Registry at Stellar community events and support other teams who do the same.
Value to ecosystem: help people learn about and onboard to Registry.
Issues:
Proof: links to recorded videos or event links
D4: Smart account support in the
accountnamespaceThe
accountnamespace shipped in Q3 only accepts classic G-addresses:register_accountrejects contract addresses withNotAccountAddress. Smart wallets such as Nido (passkey-based) are contract accounts (C-addresses), so their users can't get a name today.Issues:
register_accountand the account lifecycle functions, while keeping them distinct from entries in thecontractnamespaceValue to ecosystem: one naming system for every kind of Stellar account, so passkey and other smart-wallet users get the same human-readable names as classic accounts.
Proof: registry contract released with smart-account support; at least one Nido wallet registered under a name and resolvable on rgstry.xyz and from the CLI.
D5: Named G-addresses, from contract to ecosystem (follow-on from Q3 D8)
Q3 shipped named G-address support in the registry contract (stellar-registry/contracts#37, stellar-registry/contracts#38). Make it usable and adopted.
This follows D4 intentionally: either style of named account (whether backed by a G-address or a smart account C-address) must be supported in all situations.
Issues:
Value to ecosystem: human-readable names for accounts, not only contracts & Wasms; reduce copy-paste mistakes and make on-chain activity legible.
Proof: names shown on rgstry.xyz and resolvable from the CLI; docs published and announced; named addresses registered by at least one team other than Aha; SEP draft or discussion linked.
D6: Simplify
import_contract!testingimport_contract!works well on testnet and mainnet, but local development and unit tests need a registry with the depended-on contracts already registered, which each team has to set up themselves. Build the workaround from stellar-registry/cli#64 into the libraryIssue: stellar-registry/cli#65
Value to ecosystem: teams adopting
import_contract!get a working dev and test setup without retracing our steps.Proof: linked issue address with a PR using a newly-cut release of
stellar-registrycrateD7: Contract Details UI Revamp
The amount of information shown on Contract Details pages has grown, and it's starting to feel cluttered. Let's clean it up and prioritize what's important.
D8: Fix core
deployworkflow when using Secure StoreWhen following security best practices, keeping secret keys and seed phrases off the file system and instead using macOS Secure Store or a hardware wallet like Ledger, the Registry CLI falls victim to an upstream Stellar CLI bug.
Issue: stellar-registry/cli#14
Value to ecosystem: No longer force users into clumsy and potentially insecure workarounds for core Registry CLI workflows.
Proof: Issues and PRs created in https://github.com/stellar/stellar-cli, and communications sent to Stellar CLI via our shared Slack channel to attempt to secure a review of these issues & PRs.
D9:
stellar-registry/actionsmaturation & adoptionQ3's D11 saw us add automatic Wasm publishing to Registry via GitHub Workflow, added to Registry's own Wasm in stellar-registry/contracts#53. In Q4 we add contract upgrades to the core actions workflow, add more discerning Mainnet publish pathway, and adopt these workflows in all Aha-maintained projects. Along the way, we turn any rough edges or tooling/documentation gaps into new issues or PRs.
Issues:
upgrade" workflow stepValue to ecosystem: maturation of
stellar-registry/actionsahead of Q1 rollout to partner teams and broader ecosystem; simplified & automatic best-practices publishing of Wasms with associated contract upgrades for all projects that adopt the workflow.Proof:
Metrics loaded from PG Atlas
Legal Acknowledgements