@meddleware/token-deployer-ui 0.0.9 → 0.0.10

package/.env.example

@@ -16,12 +16,11 @@ VITE_FEE_MIST=1000000000
 VITE_FEE_TREASURY_TESTNET=0xe6b2810abfc5a6f37a375f73e3ba76cfc37584196e453255ad3c9ca2f0ede0ed
 VITE_FEE_TREASURY_MAINNET=0xe6b2810abfc5a6f37a375f73e3ba76cfc37584196e453255ad3c9ca2f0ede0ed
 
-# Optional RPC overrides. Set a paid/private endpoint for production to avoid public
-# rate limits. NOTE: the official testnet fullnode (fullnode.testnet.sui.io) is gRPC-only
-# and 404s for JSON-RPC — use a JSON-RPC-capable endpoint for testnet (the app defaults to
-# https://sui-testnet-rpc.publicnode.com). The same VITE_RPC_TESTNET is what the real-chain
-# e2e (npm run e2e:testnet) builds against; point E2E_RPC at the same endpoint.
-# VITE_RPC_TESTNET=https://sui-testnet-rpc.publicnode.com
+# Optional gRPC fullnode overrides. Set a paid/private endpoint for production to avoid
+# public rate limits. These must be gRPC(-web) endpoints — public fullnodes have deprecated
+# JSON-RPC. The same VITE_RPC_TESTNET is what the real-chain e2e (npm run e2e:testnet)
+# builds against; point E2E_RPC at the same endpoint.
+# VITE_RPC_TESTNET=https://fullnode.testnet.sui.io:443
 # VITE_RPC_MAINNET=https://fullnode.mainnet.sui.io:443
 
 # Optional publish gas budget (MIST).
@@ -35,10 +34,8 @@ VITE_FEE_TREASURY_MAINNET=0xe6b2810abfc5a6f37a375f73e3ba76cfc37584196e453255ad3c
 # VITE_WALRUS_RELAY_TESTNET=https://sui-walrus-relay-testnet.meddleware.co.uk
 # VITE_WALRUS_RELAY_MAINNET=https://sui-walrus-relay.meddleware.co.uk
 
-# gRPC fullnode for the Walrus icon-upload client (a SuiGrpcClient). This is a
-# *gRPC* endpoint and is SEPARATE from VITE_RPC_* (the JSON-RPC deploy endpoints) —
-# the two protocols are not interchangeable. Defaults to the public gRPC fullnodes
-# (rate-limited); set your own for production to avoid limits.
+# Optional separate gRPC fullnode for the Walrus icon-upload client. Defaults to
+# VITE_RPC_* (also gRPC); set only if Walrus traffic should use a different node.
 # VITE_WALRUS_RPC_TESTNET=https://fullnode.testnet.sui.io:443
 # VITE_WALRUS_RPC_MAINNET=https://fullnode.mainnet.sui.io:443
 
@@ -72,4 +69,4 @@ VITE_FEE_TREASURY_MAINNET=0xe6b2810abfc5a6f37a375f73e3ba76cfc37584196e453255ad3c
 # Public site origin for canonical/OpenGraph/JSON-LD URLs (index.html). Committed
 # defaults live in .env.production / .env.development; a staging deploy should set
 # this so it never claims the production URL.
-# VITE_PUBLIC_URL=https://tokens.meddleware.co.uk
+# VITE_PUBLIC_URL=https://sui-token-deployer.meddleware.co.uk

package/.github/workflows/e2e-realchain.yml

@@ -8,7 +8,7 @@
 # Secrets required (repository or environment secrets):
 #   SUI_PRIV_TESTNET / SUI_PRIV_MAINNET  — bech32 suiprivkey1… for a funded deployer key.
 #   FEE_TREASURY_TESTNET / FEE_TREASURY_MAINNET — operator treasury address (fee recipient).
-#   RPC_TESTNET / RPC_MAINNET (optional) — JSON-RPC endpoint override (public testnet is gRPC-only).
+#   RPC_TESTNET / RPC_MAINNET (optional) — gRPC endpoint override (defaults to the public fullnodes).
 
 name: token-deployer real-chain e2e
 

package/CLAUDE.md

@@ -27,11 +27,18 @@ The pattern mirrors `@meddleware/walrus-ui`, `@meddleware/seal-ui`, and
 must **not** render its own wallet bar, header, or footer when embedded.
 
 **Deploy executor note:** The wallet-adapter `Executor` only returns `{ digest }` — insufficient
-for the deploy flow, which requires `objectChanges` to extract the packageId, coin type,
-TreasuryCap, and MetadataCap. `src/lib/deployExecutor.ts` uses the wallet-adapter singleton for
-wallet connection state, but builds its own `SuiJsonRpcClient` (`@mysten/sui/jsonRpc`) to execute
-with `showEffects + showObjectChanges`. This is intentional — do not replace it with the
-wallet-adapter `buildExecutor`.
+for the deploy flow, which requires the created objects to extract the packageId, coin type,
+TreasuryCap, MetadataCap and the Currency ref. `src/lib/deployExecutor.ts` uses the wallet-adapter
+singleton for wallet connection state, but executes through the app's own `SuiGrpcClient`
+(`getReadClient`) with `include: { effects, objectTypes }`, and `toSuiTxResult` (`src/lib/deploy.ts`)
+maps `effects.changedObjects` onto the `objectChanges` shape `extractPublishResult` reads. This is
+intentional — do not replace it with the wallet-adapter `buildExecutor`.
+
+**gRPC only.** Public fullnodes have deprecated JSON-RPC; every chain call (app and `scripts/`)
+goes through `SuiGrpcClient`, and `VITE_RPC_*` / `E2E_RPC` must be gRPC(-web) endpoints. Do not
+reintroduce `@mysten/sui/jsonRpc`. gRPC may render framework addresses in long form
+(`0x000…02::coin::…`) — match types tolerantly. E2E builds (`VITE_E2E=1`) inject a stub client via
+`setReadClient` because gRPC-web responses cannot be faked at the `fetch` layer.
 
 ## Architecture (the money/parity paths matter most)
 
@@ -105,7 +112,7 @@ the relay source `crates/walrus-upload-relay`.)
 - **NFT / usage-ticket per-wallet gating is IMPLEMENTED (2026-08-05)** via the standalone
   `nft-gate` project: an `nft-gate` gateway fronts the operator relay and admits only
   holders of an `access_gate` NFT. The app gates the operator-relay option on ownership
-  (`useAccessGate` → `getOwnedObjects`), offers a permissionless purchase CTA, and attaches
+  (`useAccessGate` → `listOwnedObjects`), offers a permissionless purchase CTA, and attaches
   a wallet-signed access proof (`sui:signPersonalMessage` → `uploadRelayAuthToken`) when the
   operator relay is used. Unset `VITE_ACCESS_GATE_*` → no gating (unchanged behaviour). The
   tip and the NFT are **independent levers** (tip = per-upload cost; NFT = access/abuse).

package/Dockerfile

@@ -18,7 +18,7 @@
 #   VITE_WALRUS_RELAY_MAINNET           — operator relay URL for mainnet (optional)
 #   VITE_WALRUS_RPC_TESTNET             — gRPC fullnode for Walrus testnet (optional)
 #   VITE_WALRUS_RPC_MAINNET             — gRPC fullnode for Walrus mainnet (optional)
-#   VITE_RPC_TESTNET / VITE_RPC_MAINNET — override JSON-RPC fullnode URLs (optional)
+#   VITE_RPC_TESTNET / VITE_RPC_MAINNET — override gRPC fullnode URLs (optional)
 #   VITE_ACCESS_GATE_ID_{NET}           — operator's Gate shared object ID (optional)
 #   VITE_ACCESS_GATE_NFT_TYPE_{NET}     — access NFT type (optional)
 #   VITE_ACCESS_GATE_SOULBOUND_{NET}    — "true" if soulbound (optional)

package/LICENSE

@@ -1,121 +1,14 @@
-Creative Commons Legal Code
+BSD Zero Clause License
 
-CC0 1.0 Universal
+Copyright (c) 2026 MeddleWare
 
-    CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE
-    LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN
-    ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS
-    INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES
-    REGARDING THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS
-    PROVIDED HEREUNDER, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM
-    THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED
-    HEREUNDER.
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
 
-Statement of Purpose
-
-The laws of most jurisdictions throughout the world automatically confer
-exclusive Copyright and Related Rights (defined below) upon the creator
-and subsequent owner(s) (each and all, an "owner") of an original work of
-authorship and/or a database (each, a "Work").
-
-Certain owners wish to permanently relinquish those rights to a Work for
-the purpose of contributing to a commons of creative, cultural and
-scientific works ("Commons") that the public can reliably and without fear
-of later claims of infringement build upon, modify, incorporate in other
-works, reuse and redistribute as freely as possible in any form whatsoever
-and for any purposes, including without limitation commercial purposes.
-These owners may contribute to the Commons to promote the ideal of a free
-culture and the further production of creative, cultural and scientific
-works, or to gain reputation or greater distribution for their Work in
-part through the use and efforts of others.
-
-For these and/or other purposes and motivations, and without any
-expectation of additional consideration or compensation, the person
-associating CC0 with a Work (the "Affirmer"), to the extent that he or she
-is an owner of Copyright and Related Rights in the Work, voluntarily
-elects to apply CC0 to the Work and publicly distribute the Work under its
-terms, with knowledge of his or her Copyright and Related Rights in the
-Work and the meaning and intended legal effect of CC0 on those rights.
-
-1. Copyright and Related Rights. A Work made available under CC0 may be
-protected by copyright and related or neighboring rights ("Copyright and
-Related Rights"). Copyright and Related Rights include, but are not
-limited to, the following:
-
-  i. the right to reproduce, adapt, distribute, perform, display,
-     communicate, and translate a Work;
- ii. moral rights retained by the original author(s) and/or performer(s);
-iii. publicity and privacy rights pertaining to a person's image or
-     likeness depicted in a Work;
- iv. rights protecting against unfair competition in regards to a Work,
-     subject to the limitations in paragraph 4(a), below;
-  v. rights protecting the extraction, dissemination, use and reuse of data
-     in a Work;
- vi. database rights (such as those arising under Directive 96/9/EC of the
-     European Parliament and of the Council of 11 March 1996 on the legal
-     protection of databases, and under any national implementation
-     thereof, including any amended or successor version of such
-     directive); and
-vii. other similar, equivalent or corresponding rights throughout the
-     world based on applicable law or treaty, and any national
-     implementations thereof.
-
-2. Waiver. To the greatest extent permitted by, but not in contravention
-of, applicable law, Affirmer hereby overtly, fully, permanently,
-irrevocably and unconditionally waives, abandons, and surrenders all of
-Affirmer's Copyright and Related Rights and associated claims and causes
-of action, whether now known or unknown (including existing as well as
-future claims and causes of action), in the Work (i) in all territories
-worldwide, (ii) for the maximum duration provided by applicable law or
-treaty (including future time extensions), (iii) in any current or future
-medium and for any number of copies, and (iv) for any purpose whatsoever,
-including without limitation commercial, advertising or promotional
-purposes (the "Waiver"). Affirmer makes the Waiver for the benefit of each
-member of the public at large and to the detriment of Affirmer's heirs and
-successors, fully intending that such Waiver shall not be subject to
-revocation, rescission, cancellation, termination, or any other legal or
-equitable action to disrupt the quiet enjoyment of the Work by the public
-as contemplated by Affirmer's express Statement of Purpose.
-
-3. Public License Fallback. Should any part of the Waiver for any reason
-be judged legally invalid or ineffective under applicable law, then the
-Waiver shall be preserved to the maximum extent permitted taking into
-account Affirmer's express Statement of Purpose. In addition, to the
-extent the Waiver is so judged Affirmer hereby grants to each affected
-person a royalty-free, non transferable, non sublicensable, non exclusive,
-irrevocable and unconditional license to exercise Affirmer's Copyright and
-Related Rights in the Work (i) in all territories worldwide, (ii) for the
-maximum duration provided by applicable law or treaty (including future
-time extensions), (iii) in any current or future medium and for any number
-of copies, and (iv) for any purpose whatsoever, including without
-limitation commercial, advertising or promotional purposes (the
-"License"). The License shall be deemed effective as of the date CC0 was
-applied by Affirmer to the Work. Should any part of the License for any
-reason be judged legally invalid or ineffective under applicable law, such
-partial invalidity or ineffectiveness shall not invalidate the remainder
-of the License, and in such case Affirmer hereby affirms that he or she
-will not (i) exercise any of his or her remaining Copyright and Related
-Rights in the Work or (ii) assert any associated claims and causes of
-action with respect to the Work, in either case contrary to Affirmer's
-express Statement of Purpose.
-
-4. Limitations and Disclaimers.
-
- a. No trademark or patent rights held by Affirmer are waived, abandoned,
-    surrendered, licensed or otherwise affected by this document.
- b. Affirmer offers the Work as-is and makes no representations or
-    warranties of any kind concerning the Work, express, implied,
-    statutory or otherwise, including without limitation warranties of
-    title, merchantability, fitness for a particular purpose, non
-    infringement, or the absence of latent or other defects, accuracy, or
-    the present or absence of errors, whether or not discoverable, all to
-    the greatest extent permissible under applicable law.
- c. Affirmer disclaims responsibility for clearing rights of other persons
-    that may apply to the Work or any use thereof, including without
-    limitation any person's Copyright and Related Rights in the Work.
-    Further, Affirmer disclaims responsibility for obtaining any necessary
-    consents, permissions or other rights required for any use of the
-    Work.
- d. Affirmer understands and acknowledges that Creative Commons is not a
-    party to this document and has no duty or obligation with respect to
-    this CC0 or use of the Work.
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -68,9 +68,9 @@ host dashboard. See [.env.example](.env.example) for the full list.
 | --- | --- | --- |
 | `VITE_FEE_TREASURY_TESTNET` / `_MAINNET` | Operator treasury that receives the fee. **A production build fails if either is the zero address** (bypass with `VITE_ALLOW_UNSET_TREASURY=1`). | committed operator address |
 | `VITE_FEE_MIST` | Flat fee split from the user's gas coin. | `1000000000` (1 SUI) |
-| `VITE_RPC_TESTNET` / `_MAINNET` | JSON-RPC endpoint (set a paid RPC for production). | public endpoints |
+| `VITE_RPC_TESTNET` / `_MAINNET` | gRPC fullnode endpoint (set a paid RPC for production). JSON-RPC-only endpoints do not work. | public fullnodes |
 | `VITE_PUBLISH_GAS_BUDGET` | Publish gas budget (MIST). | `500000000` |
-| `VITE_PUBLIC_URL` | Site origin for canonical/OG/JSON-LD URLs. | `https://tokens.meddleware.co.uk` |
+| `VITE_PUBLIC_URL` | Site origin (no trailing slash) for the canonical URL and Open Graph tags in `index.html`. | `https://sui-token-deployer.meddleware.co.uk` (`.env.production`) |
 | `VITE_WALRUS_RELAY_TESTNET` / `_MAINNET` | Your own upload relay (to collect the tip). Unset → public Mysten relay (earns nothing). | public relay |
 | `VITE_WALRUS_MAX_TIP_MIST` | Client-side max relay tip. **Must exceed your relay's tip** or uploads fail. | `50000000` (0.05 SUI) |
 | `VITE_ICON_MAX_BYTES` / `VITE_ICON_ALLOWED_TYPES` | Client icon size/type gate (UX only). | `102400` / PNG,JPEG,WebP,SVG |
@@ -192,7 +192,7 @@ testnet mode with the RPC pointed at the local node).
 | `SUI_PRIV` | bech32 `suiprivkey1…` for a **funded** deployer key. Export the CLI key: `sui keytool export --key-identity <addr>`. Never faucet-funded on a real network. |
 | `VITE_FEE_TREASURY_TESTNET` / `_MAINNET` | Operator treasury baked into the build (already set in `.env.production`). The build fails if it is the zero address. |
 | `E2E_FEE_ADDR` | The treasury to watch for the fee-delta assertion — set it equal to the built treasury. If unset, the fee check is skipped (the app still charges the fee). |
-| `VITE_RPC_TESTNET` / `_MAINNET` and `E2E_RPC` | JSON-RPC endpoint for the build (browser) and the node-side verifier. Use a JSON-RPC-capable endpoint — the official testnet fullnode is gRPC-only. |
+| `VITE_RPC_TESTNET` / `_MAINNET` and `E2E_RPC` | gRPC endpoint for the build (browser) and the node-side verifier. Defaults to the public fullnodes. |
 | `E2E_MAINNET_CONFIRM=1` | **Mainnet only.** Without it the mainnet runner aborts cleanly (fail-safe default) so it can never publish by accident. |
 
 A full fee-charging run needs the key to hold **≥ gas + fee** (~0.5 SUI gas + 1 SUI fee = ~1.5 SUI).
@@ -203,8 +203,6 @@ Example (testnet):
 
 ```bash
 export SUI_PRIV="$(sui keytool export --key-identity 0xYOURADDR --json | jq -r .exportedPrivateKey)"
-VITE_RPC_TESTNET=https://sui-testnet-rpc.publicnode.com \
-E2E_RPC=https://sui-testnet-rpc.publicnode.com \
 VITE_FEE_TREASURY_TESTNET=0xYOURTREASURY \
 E2E_FEE_ADDR=0xYOURTREASURY \
 npm run e2e:testnet

package/index.html

@@ -2,9 +2,18 @@
 <html lang="en">
   <head>
     <meta charset="UTF-8">
-    <link rel="icon" href="/favicon.ico">
+    <link rel="icon" href="/favicon.svg" type="image/svg+xml">
+    <link rel="icon" href="/favicon.ico" sizes="any">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Vite App</title>
+    <title>Token Deployer · MeddleWare</title>
+    <meta name="description" content="Create your own Sui coin in the browser — your wallet signs and pays gas, nothing is compiled or signed on a server, and you keep the full, verifiable source package.">
+    <link rel="canonical" href="%VITE_PUBLIC_URL%/">
+    <meta property="og:type" content="website">
+    <meta property="og:title" content="Token Deployer · MeddleWare">
+    <meta property="og:description" content="Create your own Sui coin in the browser — no server, no custody, full source included.">
+    <meta property="og:url" content="%VITE_PUBLIC_URL%/">
+    <meta property="og:image" content="%VITE_PUBLIC_URL%/og-image.png">
+    <meta name="twitter:card" content="summary_large_image">
   </head>
   <body>
     <div id="app"></div>

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@meddleware/token-deployer-ui",
-  "version": "0.0.9",
+  "version": "0.0.10",
   "type": "module",
+  "license": "0BSD",
   "exports": {
     ".": {
       "default": "./src/index.ts"
@@ -39,11 +40,11 @@
   "dependencies": {
     "@meddleware/design-tokens": "^0.1.7",
     "@meddleware/ui": "^0.1.28",
-    "@meddleware/wallet-adapter": "^0.0.9",
-    "@meddleware/walrus-relay": "^0.1.18",
+    "@meddleware/wallet-adapter": "^0.0.10",
+    "@meddleware/walrus-relay": "^0.1.19",
     "@mysten/bcs": "~2.1.0",
     "@mysten/move-bytecode-template": "~0.4.0",
-    "@mysten/sui": "^2.33.0",
+    "@mysten/sui": "^2.33.1",
     "@mysten/walrus": "~1.2.0",
     "fflate": "^0.8.3",
     "vue": "^3.5.0"
@@ -81,7 +82,7 @@
     "vue-tsc": "~3.3.0"
   },
   "optionalDependencies": {
-    "@meddleware/sui-token-template": "^1.0.4"
+    "@meddleware/sui-token-template": "^1.0.5"
   },
   "engines": {
     "node": "^22.18.0 || >=24.12.0"

package/public/robots.txt

@@ -1,3 +1,3 @@
 User-agent: *
 Allow: /
-Sitemap: https://tokens.meddleware.co.uk/sitemap.xml
+Sitemap: https://sui-token-deployer.meddleware.co.uk/sitemap.xml

package/public/sitemap.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
   <url>
-    <loc>https://tokens.meddleware.co.uk/</loc>
+    <loc>https://sui-token-deployer.meddleware.co.uk/</loc>
     <changefreq>monthly</changefreq>
     <priority>1.0</priority>
   </url>

package/scripts/e2e-deploy.mjs

@@ -19,7 +19,7 @@
 
 import { readFileSync, existsSync } from 'node:fs'
 import { chromium } from 'playwright'
-import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc'
+import { SuiGrpcClient } from '@mysten/sui/grpc'
 import { requestSuiFromFaucetV2 } from '@mysten/sui/faucet'
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519'
 import { Transaction } from '@mysten/sui/transactions'
@@ -37,7 +37,7 @@ const APP_NETWORK = NETWORK === 'mainnet' ? 'mainnet' : 'testnet'
 
 const DEFAULT_RPC = {
   localnet: 'http://127.0.0.1:9000',
-  testnet: 'https://sui-testnet-rpc.publicnode.com',
+  testnet: 'https://fullnode.testnet.sui.io:443',
   mainnet: 'https://fullnode.mainnet.sui.io:443',
 }
 const RPC = process.env.E2E_RPC || DEFAULT_RPC[NETWORK]
@@ -83,9 +83,15 @@ if (NETWORK === 'localnet') {
 }
 const address = keypair.toSuiAddress()
 
-// Node-side client points at the PHYSICAL RPC; its `network` label is the app network so the
-// built transaction's chain identifier matches what the wallet/app sign under.
-const client = new SuiJsonRpcClient({ url: RPC, network: APP_NETWORK })
+// Node-side gRPC client points at the PHYSICAL RPC; its `network` label is the app network so
+// the built transaction's chain identifier matches what the wallet/app sign under.
+const client = new SuiGrpcClient({ baseUrl: RPC, network: APP_NETWORK })
+
+/** Total SUI balance (MIST) of `owner`. */
+async function suiBalance(owner) {
+  const { balance } = await client.getBalance({ owner })
+  return BigInt(balance.balance)
+}
 
 const EXPECT_FEE = Boolean(FEE_ADDR) && FEE_ADDR !== ZERO_ADDR
 
@@ -95,19 +101,16 @@ async function main() {
   if (NETWORK === 'localnet') {
     await requestSuiFromFaucetV2({ host: FAUCET, recipient: address })
     for (let i = 0; i < 25; i++) {
-      const b = await client.getBalance({ owner: address })
-      if (BigInt(b.totalBalance) > 0n) break
+      if ((await suiBalance(address)) > 0n) break
       await new Promise((r) => setTimeout(r, 1000))
     }
   }
 
-  const balance = BigInt((await client.getBalance({ owner: address })).totalBalance)
+  const balance = await suiBalance(address)
   console.log('sender:', address, 'balance:', balance.toString(), 'MIST')
   if (balance === 0n) fail(`sender ${address} has no SUI on ${NETWORK}`)
 
-  const feeBefore = EXPECT_FEE
-    ? BigInt((await client.getBalance({ owner: FEE_ADDR })).totalBalance)
-    : 0n
+  const feeBefore = EXPECT_FEE ? await suiBalance(FEE_ADDR) : 0n
 
   // Browser resolution: explicit CHROME_PATH → a locally-installed Chrome → Playwright's
   // bundled Chromium (CI installs it via `npx playwright install chromium`).
@@ -167,7 +170,7 @@ async function main() {
 
   // Connect: open the dialog, select the app network if it differs from the testnet default,
   // then pick the injected wallet.
-  await page.getByRole('button', { name: 'Connect Wallet' }).click()
+  await page.getByRole('button', { name: 'Connect Wallet', exact: true }).click()
   if (APP_NETWORK !== 'testnet') {
     await page.locator('#dialog-network-select').selectOption(APP_NETWORK)
   }
@@ -175,15 +178,17 @@ async function main() {
   await page.getByText(/Mock Test Wallet ·/).waitFor({ timeout: 10000 })
   console.log('wallet connected in UI')
 
-  // Fill the form.
+  // Fill the wizard: identity → token → settings (defaults) → terms (first run) → review.
+  await page.locator('#package').fill('browser_coin')
+  await page.locator('#module').fill('browsercoin')
+  await page.getByRole('button', { name: 'Next', exact: true }).click()
   await page.locator('#name').fill('Browser Coin')
   await page.locator('#symbol').fill('BRWC')
   await page.locator('#description').fill('Deployed via headless browser e2e')
   await page.locator('#decimals').fill('6')
-  await page.locator('#package').fill('browser_coin')
-  await page.locator('#module').fill('browsercoin')
-
+  await page.getByRole('button', { name: 'Next', exact: true }).click()
   await page.getByRole('button', { name: /Review & deploy/ }).click()
+  await page.getByRole('button', { name: /I understand — continue/ }).click()
   await page.getByRole('button', { name: /Confirm & deploy/ }).click()
   console.log('confirmed; deploying (real publish + confirmation)…')
 
@@ -208,7 +213,7 @@ async function main() {
   if (!coinType.includes('::browsercoin::BROWSERCOIN')) fail(`unexpected coin type: ${coinType}`)
 
   if (EXPECT_FEE) {
-    const feeAfter = BigInt((await client.getBalance({ owner: FEE_ADDR })).totalBalance)
+    const feeAfter = await suiBalance(FEE_ADDR)
     const feeDelta = feeAfter - feeBefore
     console.log('fee delivered this run:', feeDelta.toString(), 'MIST (to', FEE_ADDR + ')')
     if (feeDelta !== EXPECT_FEE_MIST) fail(`expected ${EXPECT_FEE_MIST} MIST fee this run, got ${feeDelta}`)

package/scripts/e2e-localnet.mjs

@@ -1,18 +1,21 @@
 // End-to-end: patch -> publish (fee + immutable) -> finalize (mint + fixed supply
 // + frozen metadata) against localnet, using the actual app lib.
 import init from '@mysten/move-bytecode-template';
-import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
+import { SuiGrpcClient } from '@mysten/sui/grpc';
 import { requestSuiFromFaucetV2 } from '@mysten/sui/faucet';
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
 import { patchTemplateModule } from '../src/lib/template.ts';
 import { buildPublishTransaction, buildFinalizeTransaction, extractPublishResult, needsFinalize } from '../src/lib/buildPublishTx.ts';
+import { toSuiTxResult } from '../src/lib/deploy.ts';
 
 await (init)();
-const client = new SuiJsonRpcClient({ url: 'http://127.0.0.1:9000' });
+const client = new SuiGrpcClient({ baseUrl: 'http://127.0.0.1:9000', network: 'localnet' });
+const balanceOf = async (owner, coinType) => BigInt((await client.getBalance({ owner, coinType })).balance.balance);
+const include = { effects: true, objectTypes: true };
 const kp = new Ed25519Keypair(); const sender = kp.toSuiAddress();
 const feeRecipient = new Ed25519Keypair().toSuiAddress();
 await requestSuiFromFaucetV2({ host: 'http://127.0.0.1:9123', recipient: sender });
-for (let i=0;i<25;i++){ const b=await client.getBalance({owner:sender}); if(BigInt(b.totalBalance)>0n)break; await new Promise(r=>setTimeout(r,1000)); }
+for (let i=0;i<25;i++){ if((await balanceOf(sender))>0n)break; await new Promise(r=>setTimeout(r,1000)); }
 
 const config = {
   packageName:'fixed_token', moduleName:'fixedtok', structName:'FIXEDTOK',
@@ -24,7 +27,7 @@ const config = {
 const moduleBytes = await patchTemplateModule(config);
 const feeMist = 250000000n;
 const pubTx = buildPublishTransaction({ moduleBytes, sender, feeMist, feeRecipient, gasBudget: 500000000n, packagePolicy: config.packagePolicy });
-const pub = await client.signAndExecuteTransaction({ signer: kp, transaction: pubTx, options: { showEffects:true, showObjectChanges:true, showBalanceChanges:true } });
+const pub = toSuiTxResult(await client.signAndExecuteTransaction({ signer: kp, transaction: pubTx, include }));
 console.log('publish status:', pub.effects?.status?.status);
 if (pub.effects?.status?.status !== 'success') { console.log(JSON.stringify(pub.effects?.status)); process.exit(1); }
 
@@ -35,30 +38,29 @@ console.log('coinType:', result.coinType);
 console.log('caps:', { t: !!result.treasuryCapId, m: !!result.metadataCapId, upgrade: result.upgradeCapId ?? '(burned=immutable)' });
 
 // fee arrived?
-const feeBal = await client.getBalance({ owner: feeRecipient });
-console.log('fee recipient balance:', feeBal.totalBalance, feeBal.totalBalance === feeMist.toString() ? 'OK' : 'MISMATCH');
+const feeBal = await balanceOf(feeRecipient);
+console.log('fee recipient balance:', feeBal.toString(), feeBal === feeMist ? 'OK' : 'MISMATCH');
 
 // finalize
 console.log('needsFinalize:', needsFinalize(config, sender));
 const finTx = buildFinalizeTransaction({ config, coinType: result.coinType, treasuryCapId: result.treasuryCapId, metadataCapId: result.metadataCapId, sender, gasBudget: 500000000n });
-const fin = await client.signAndExecuteTransaction({ signer: kp, transaction: finTx, options: { showEffects:true, showObjectChanges:true } });
+const fin = toSuiTxResult(await client.signAndExecuteTransaction({ signer: kp, transaction: finTx, include }));
 await client.waitForTransaction({ digest: fin.digest });
 console.log('finalize status:', fin.effects?.status?.status);
 if (fin.effects?.status?.status !== 'success') { console.log(JSON.stringify(fin.effects?.status)); process.exit(1); }
 
 // minted coin present?
-const coins = await client.getCoins({ owner: sender, coinType: result.coinType });
-const total = coins.data.reduce((a,c)=>a+BigInt(c.balance), 0n);
+const total = await balanceOf(sender, result.coinType);
 const expected = 1000n * 10n**6n;
 console.log('minted balance:', total.toString(), total===expected ? 'OK (1000 * 10^6)' : 'MISMATCH exp '+expected);
 
 // treasury cap frozen (immutable owner)?
-const tcap = await client.getObject({ id: result.treasuryCapId, options:{ showOwner:true } });
-const owner = tcap.data?.owner ?? tcap.object?.owner ?? tcap.owner;
+const { object: tcap } = await client.getObject({ objectId: result.treasuryCapId });
+const owner = tcap.owner;
 console.log('treasuryCap owner after fixed-supply freeze:', JSON.stringify(owner));
 
 const ok = result.coinType.endsWith('::fixedtok::FIXEDTOK')
-  && feeBal.totalBalance === feeMist.toString()
+  && feeBal === feeMist
   && !result.upgradeCapId
   && total === expected;
 console.log('\nE2E', ok ? 'PASS ✓' : 'FAIL ✗');

package/scripts/e2e-walrus-browser.mjs

@@ -8,15 +8,12 @@
 
 import { readFileSync } from 'node:fs'
 import { chromium } from 'playwright'
-import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc'
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519'
 import { toBase64 } from '@mysten/sui/utils'
 
 const APP_URL = process.env.APP_URL || 'http://localhost:4173'
-const RPC = process.env.RPC || 'https://sui-testnet-rpc.publicnode.com'
 const ICON = '/tmp/test-icon.svg'
 
-const _client = new SuiJsonRpcClient({ url: RPC, network: 'testnet' })
 const keypair = Ed25519Keypair.fromSecretKey(process.env.SUI_PRIV)
 const address = keypair.toSuiAddress()
 
@@ -30,7 +27,7 @@ async function main() {
   const browser = await chromium.launch({
     headless: true,
     executablePath: process.env.CHROME_PATH || '/usr/bin/google-chrome',
-    // Bypass CORS so the in-browser tx.build() can hit the testnet RPC.
+    // Bypass CORS so the in-browser tx.build() can hit the testnet gRPC endpoint.
     args: ['--disable-web-security', '--disable-features=IsolateOrigins,site-per-process'],
   })
   const page = await browser.newPage()

package/scripts/gen-og-image.mjs

@@ -14,13 +14,13 @@ h1 .accent{color:#6ea8fe}
 p{font-size:34px;line-height:1.35;color:#aebfd6;max-width:960px}
 .row{display:flex;gap:18px;margin-top:52px}
 .chip{font-size:24px;color:#cfe0f7;background:#16233d;border:1px solid #26365a;border-radius:10px;padding:12px 20px}
-.url{position:absolute;bottom:56px;right:80px;font-size:26px;color:#6ea8fe;font-weight:600}
+.url{position:absolute;top:84px;right:80px;font-size:26px;color:#6ea8fe;font-weight:600}
 </style></head><body>
 <div class="badge">Sui &middot; client-side</div>
 <h1>Create your own <span class="accent">Sui coin</span><br>in the browser</h1>
 <p>Your wallet signs and pays gas &mdash; nothing is compiled or signed on a server. Keep the full, verifiable source package.</p>
 <div class="row"><div class="chip">No server</div><div class="chip">No custody</div><div class="chip">Full source included</div></div>
-<div class="url">tokens.meddleware.co.uk</div>
+<div class="url">sui-token-deployer.meddleware.co.uk</div>
 </body></html>`
 
 const browser = await chromium.launch({ executablePath: process.env.CHROME_PATH || '/usr/bin/google-chrome' })

package/scripts/publish-localnet.mjs

@@ -1,16 +1,17 @@
 import { readFileSync } from 'node:fs';
 import { bcs } from '@mysten/bcs';
 import * as tpl from '@mysten/move-bytecode-template';
-import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
+import { SuiGrpcClient } from '@mysten/sui/grpc';
 import { requestSuiFromFaucetV2 } from '@mysten/sui/faucet';
 import { Transaction } from '@mysten/sui/transactions';
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
 import { toBase64 } from '@mysten/sui/utils';
+import { toSuiTxResult } from '../src/lib/deploy.ts';
 
 const init = tpl.default ?? tpl.init;
 try { if (typeof init === 'function') await init(); } catch {}
 
-const client = new SuiJsonRpcClient({ url: 'http://127.0.0.1:9000' });
+const client = new SuiGrpcClient({ baseUrl: 'http://127.0.0.1:9000', network: 'localnet' });
 
 const orig = new Uint8Array(readFileSync(new URL('../src/move-template/sui_token_template.mv', import.meta.url)));
 const json = tpl.deserialize(orig);
@@ -29,7 +30,7 @@ const addr = kp.toSuiAddress();
 console.log('address:', addr);
 await requestSuiFromFaucetV2({ host: 'http://127.0.0.1:9123', recipient: addr });
 let bal = '0';
-for (let i=0;i<25;i++){ const b = await client.getBalance({ owner: addr }); if (BigInt(b.totalBalance) > 0n){ bal=b.totalBalance; break;} await new Promise(r=>setTimeout(r,1000)); }
+for (let i=0;i<25;i++){ const { balance } = await client.getBalance({ owner: addr }); if (BigInt(balance.balance) > 0n){ bal=balance.balance; break;} await new Promise(r=>setTimeout(r,1000)); }
 console.log('balance:', bal);
 
 const tx = new Transaction();
@@ -39,7 +40,7 @@ tx.transferObjects([upgradeCap], addr);
 tx.setGasBudget(500000000);
 
 try {
-  const res = await client.signAndExecuteTransaction({ signer: kp, transaction: tx, options: { showEffects: true, showObjectChanges: true } });
+  const res = toSuiTxResult(await client.signAndExecuteTransaction({ signer: kp, transaction: tx, include: { effects: true, objectTypes: true } }));
   const status = res.effects?.status?.status;
   console.log('\nstatus:', status);
   if (status !== 'success') { console.log('ERR:', JSON.stringify(res.effects?.status)); process.exit(1); }

package/src/components/LicensePicker.vue

@@ -73,7 +73,8 @@ async function openLicenseModal(): Promise<void> {
       <UiFieldHint field-id="license-select">
         Applies only to the downloadable Move source package — embedded in the LICENSE file and
         source headers. Has <b>no effect on the on-chain token</b> or its transferability. Choose
-        <b>CC0-1.0</b> (default) for public domain. Choose <b>None</b> to retain all rights.
+        <b>0BSD</b> (default) for a minimal permissive licence, or <b>CC0-1.0</b> for public domain.
+        Choose <b>None</b> to retain all rights.
       </UiFieldHint>
     </template>
     <template #default="{ attrs }">

package/src/composables/useAccessGate.ts

@@ -22,7 +22,7 @@ export type PersonalMessageSigner = (message: Uint8Array) => Promise<{ signature
  * When no gate is configured for the network (`ACCESS_GATE[network] == null`), the relay is
  * treated as OPEN (`hasAccess === true`) and this composable is inert — behaviour is
  * unchanged from before gating existed. When a gate IS configured, `checkOwnership` decides
- * access with a single `getOwnedObjects` call (the same cheap pattern as the relay health
+ * access with a single `listOwnedObjects` call (the same cheap pattern as the relay health
  * check), and `purchase`/`buildRelayAccessToken` drive the buy + prove flows.
  */
 export function useAccessGate(