@msafe/sui-app-store 0.0.362 → 0.0.364

package/README.md

@@ -10,19 +10,48 @@
   <tr>
     <td align="center">
 
-### This repository is not an onboarding surface
+### Integration is now the same as any Sui wallet
 
-**Writing a helper, forking `src/apps/**`, or opening a PR here will not list your dApp.**
+You **do not write a helper**. You **do not wait for this package to publish**. You build a real `Transaction` in your dApp — the same object you already send to Slush — and submit it with `@msafe/sui-wallet`.
 
-MSafe no longer accepts new App Store adapters. Integrate the same way you integrate Slush: build a real Sui `Transaction` in your dApp and submit it with `@msafe/sui-wallet`.
+Writing a helper, forking `src/apps/**`, or opening a PR here will **not** list your dApp.
 
-**If you already started the old helper work → [How to change your dApp](#how-to-change-your-dapp)**  
-**If you are new → [Current integration](#current-integration)**
+**New listing → [What you gain](#what-you-gain-in-this-version)** then [Current integration](#current-integration)  
+**Already started a helper → [How to change your dApp](#how-to-change-your-dapp)**  
+**Have an agent do the edit → [Prompt for your coding agent](#prompt-for-your-coding-agent)**
 
 </td>
   </tr>
 </table>
 
+> [!TIP]
+> **This version’s point:** drop the adapter. If your dApp can sign with a normal wallet, it can sign with MSafe. Listing is a store card (name, icon, URL), usually done in a day — not a week of helper review and an MSafe release.
+
+---
+
+## What you gain in this version
+
+The old path existed because a queued multisig tx had to be **rebuilt** later, so every protocol needed an MSafe-owned helper. That is no longer how new apps enter the store. You submit the finished transaction once; MSafe simulates, votes, and executes **that** PTB.
+
+| | ~~Before (helper)~~ | **Now (wallet `Transaction`)** |
+| --- | --- | --- |
+| What you write | Intention class + `deserialize` / `build` + tests + PR in **this** repo | The PTB you already build for other wallets |
+| Extra dependency | `@msafe/sui-app-store` + `appContext` | `@msafe/sui-wallet` only |
+| Who ships your adapter | MSafe reviews, merges, and **publishes a new app-store version** | **Nobody.** There is no adapter. |
+| Time to first live tx | Often **weeks** (review + our release train) | **Days** — usually the time to wire the wallet and send a card |
+| Blocked on | Our sprint, this repo’s CI, npm publish | Your own PTB being correct |
+| Mysten / protocol SDK upgrades | Helper in this repo had to follow; you waited on us | You upgrade **your** dApp; we are not in the loop |
+| Three new protocols at once | Three helper PRs, serialized on our side | Three teams in parallel; we only add three cards |
+
+**You delete work, you do not add a new integration style.**
+
+- No `BaseIntention` / `YourHelper` / `src/apps/<name>`
+- No empty `new Transaction()` + `appContext` so we can rebuild later
+- No “please merge our helper” email
+- No holding a launch for `@msafe/sui-app-store@x.y.z`
+
+Users still get the full multisig flow (simulate → approve → execute). New apps use a generic transaction view instead of a custom swap card. That is the trade for **not** being on our release calendar.
+
 > [!CAUTION]
 > **DEPRECATED:** `BaseIntention`, `IAppHelperInternal`, `src/apps/<your-app>`, `appContext`, and “fork this repo + wait for our release” are retired for **all new listings**.
 >
@@ -33,6 +62,56 @@ MSafe no longer accepts new App Store adapters. Integrate the same way you integ
 
 ---
 
+## Prompt for your coding agent
+
+Copy the block below into Cursor, Claude, Codex, or any repo agent. It will read this README and apply the migration in **your dApp** (not in `msafe-sui-app-store`).
+
+```text
+You are migrating this dApp onto the current MSafe store integration.
+
+1. Read this README first and treat it as the only spec:
+   https://github.com/Momentum-Safe/msafe-sui-app-store/blob/main/README.md
+   If the user attached or opened a local copy of that README, use the local copy.
+   Follow “How to change your dApp” and “Current integration”.
+   Ignore the collapsed “DEPRECATED archive”. Do not implement a helper.
+
+2. Goal: MSafe is a normal Sui wallet. We submit a fully assembled Transaction.
+   We do NOT write BaseIntention / IAppHelperInternal / src/apps helpers.
+   We do NOT open a PR against Momentum-Safe/msafe-sui-app-store.
+   We do NOT wait for @msafe/sui-app-store to publish.
+
+3. Search the repo for and remove MSafe-helper-only code:
+   - imports of @msafe/sui-app-store, appHelpers, BaseIntention, IAppHelperInternal
+   - appContext passed into signTransaction / signAndExecuteTransaction / signTransactionBlock
+   - empty `new Transaction()` (or TransactionBlock) created only so a helper can build() later
+   - local forks or copies of msafe-sui-app-store helpers
+   Keep protocol SDKs and the real PTB those SDKs already produce.
+
+4. Implement the wallet path:
+   - Add @msafe/sui-wallet if missing.
+   - Register once at app startup:
+     registerWallet(new MSafeWallet('<stable-app-name>', rpcUrl, 'sui:mainnet' | 'sui:testnet'));
+     Use a stable app name (same string we will put on the MSafe store card).
+   - Connect with @mysten/dapp-kit or wallet-standard, same as other wallets.
+   - Every MSafe sign call must pass a Transaction with commands.length > 0.
+   - tx.setSender(...) must be the connected MSafe multisig address.
+   - Do not pass appContext.
+   - Prefer signTransaction / signAndExecuteTransaction. Do not expect a digest:
+     signAndExecuteTransaction only proposes; owners vote and execute inside MSafe.
+
+5. Remove @msafe/sui-app-store from package.json / lockfile if nothing else needs it.
+
+6. Do not edit files under a clone of msafe-sui-app-store to “register” us.
+   After code lands, tell the human what to send MSafe for the store card:
+   app name, icon, production URL.
+
+7. When done, list changed files and remaining checklist items from the README.
+```
+
+After the agent finishes: send MSafe the app name, icon, and production URL so the store card can go up.
+
+---
+
 ## How to change your dApp
 
 Use this section if your team followed the old README: created an intention class, a helper, `appContext`, or a PR against this repo.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@msafe/sui-app-store",
-  "version": "0.0.362",
+  "version": "0.0.364",
   "description": "MSafe Sui app store repository",
   "author": "Momentum Safe",
   "license": "MIT",