@nockchain/rose 0.1.4-nightly.5

package/sdk/package-lock.json

@@ -0,0 +1,424 @@
+{
+  "name": "@nockchain/sdk",
+  "version": "0.1.4-nightly.5",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "@nockchain/sdk",
+      "version": "0.1.4-nightly.5",
+      "license": "MIT",
+      "dependencies": {
+        "@nockchain/rose-wasm": "^0.1.4-nightly.17.1.a460619",
+        "@scure/base": "2.0.0"
+      },
+      "devDependencies": {
+        "@types/react": "19.2.7",
+        "prettier": "3.7.4",
+        "react": "19.2.3",
+        "typescript": "5.9.3",
+        "vite": "7.3.0"
+      },
+      "peerDependencies": {
+        "react": ">=18"
+      }
+    },
+    "node_modules/@esbuild/darwin-arm64": {
+      "version": "0.27.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.27.2.tgz",
+      "integrity": "sha512-davCD2Zc80nzDVRwXTcQP/28fiJbcOwvdolL0sOiOsbwBa72kegmVU0Wrh1MYrbuCL98Omp5dVhQFWRKR2ZAlg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@nockchain/rose-wasm": {
+      "version": "0.1.4-nightly.17.1.a460619",
+      "resolved": "https://registry.npmjs.org/@nockchain/rose-wasm/-/rose-wasm-0.1.4-nightly.17.1.a460619.tgz",
+      "integrity": "sha512-hKXugCXtGwVAYDnftt+Hqeu2GONsHMJFf1k79UeU3IDsZfvZL0B8+bHuFTlsBG+gfexvpXMuccBlWy1UVGFTaQ==",
+      "license": "MIT"
+    },
+    "node_modules/@rollup/rollup-darwin-arm64": {
+      "version": "4.54.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.54.0.tgz",
+      "integrity": "sha512-k43D4qta/+6Fq+nCDhhv9yP2HdeKeP56QrUUTW7E6PhZP1US6NDqpJj4MY0jBHlJivVJD5P8NxrjuobZBJTCRw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ]
+    },
+    "node_modules/@scure/base": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/@scure/base/-/base-2.0.0.tgz",
+      "integrity": "sha512-3E1kpuZginKkek01ovG8krQ0Z44E3DHPjc5S2rjJw9lZn3KSQOs8S7wqikF/AH7iRanHypj85uGyxk0XAyC37w==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@types/estree": {
+      "version": "1.0.8",
+      "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz",
+      "integrity": "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@types/react": {
+      "version": "19.2.7",
+      "resolved": "https://registry.npmjs.org/@types/react/-/react-19.2.7.tgz",
+      "integrity": "sha512-MWtvHrGZLFttgeEj28VXHxpmwYbor/ATPYbBfSFZEIRK0ecCFLl2Qo55z52Hss+UV9CRN7trSeq1zbgx7YDWWg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "csstype": "^3.2.2"
+      }
+    },
+    "node_modules/csstype": {
+      "version": "3.2.3",
+      "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.2.3.tgz",
+      "integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/esbuild": {
+      "version": "0.27.2",
+      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.27.2.tgz",
+      "integrity": "sha512-HyNQImnsOC7X9PMNaCIeAm4ISCQXs5a5YasTXVliKv4uuBo1dKrG0A+uQS8M5eXjVMnLg3WgXaKvprHlFJQffw==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "bin": {
+        "esbuild": "bin/esbuild"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "optionalDependencies": {
+        "@esbuild/aix-ppc64": "0.27.2",
+        "@esbuild/android-arm": "0.27.2",
+        "@esbuild/android-arm64": "0.27.2",
+        "@esbuild/android-x64": "0.27.2",
+        "@esbuild/darwin-arm64": "0.27.2",
+        "@esbuild/darwin-x64": "0.27.2",
+        "@esbuild/freebsd-arm64": "0.27.2",
+        "@esbuild/freebsd-x64": "0.27.2",
+        "@esbuild/linux-arm": "0.27.2",
+        "@esbuild/linux-arm64": "0.27.2",
+        "@esbuild/linux-ia32": "0.27.2",
+        "@esbuild/linux-loong64": "0.27.2",
+        "@esbuild/linux-mips64el": "0.27.2",
+        "@esbuild/linux-ppc64": "0.27.2",
+        "@esbuild/linux-riscv64": "0.27.2",
+        "@esbuild/linux-s390x": "0.27.2",
+        "@esbuild/linux-x64": "0.27.2",
+        "@esbuild/netbsd-arm64": "0.27.2",
+        "@esbuild/netbsd-x64": "0.27.2",
+        "@esbuild/openbsd-arm64": "0.27.2",
+        "@esbuild/openbsd-x64": "0.27.2",
+        "@esbuild/openharmony-arm64": "0.27.2",
+        "@esbuild/sunos-x64": "0.27.2",
+        "@esbuild/win32-arm64": "0.27.2",
+        "@esbuild/win32-ia32": "0.27.2",
+        "@esbuild/win32-x64": "0.27.2"
+      }
+    },
+    "node_modules/fdir": {
+      "version": "6.5.0",
+      "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz",
+      "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "peerDependencies": {
+        "picomatch": "^3 || ^4"
+      },
+      "peerDependenciesMeta": {
+        "picomatch": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/fsevents": {
+      "version": "2.3.3",
+      "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
+      "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+      }
+    },
+    "node_modules/nanoid": {
+      "version": "3.3.11",
+      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz",
+      "integrity": "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "bin": {
+        "nanoid": "bin/nanoid.cjs"
+      },
+      "engines": {
+        "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
+      }
+    },
+    "node_modules/picocolors": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
+      "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/picomatch": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.3.tgz",
+      "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
+    "node_modules/postcss": {
+      "version": "8.5.6",
+      "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.6.tgz",
+      "integrity": "sha512-3Ybi1tAuwAP9s0r1UQ2J4n5Y0G05bJkpUIO0/bI9MhwmD70S5aTWbXGBwxHrelT+XM1k6dM0pk+SwNkpTRN7Pg==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/postcss/"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/postcss"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "nanoid": "^3.3.11",
+        "picocolors": "^1.1.1",
+        "source-map-js": "^1.2.1"
+      },
+      "engines": {
+        "node": "^10 || ^12 || >=14"
+      }
+    },
+    "node_modules/prettier": {
+      "version": "3.7.4",
+      "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.7.4.tgz",
+      "integrity": "sha512-v6UNi1+3hSlVvv8fSaoUbggEM5VErKmmpGA7Pl3HF8V6uKY7rvClBOJlH6yNwQtfTueNkGVpOv/mtWL9L4bgRA==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "prettier": "bin/prettier.cjs"
+      },
+      "engines": {
+        "node": ">=14"
+      },
+      "funding": {
+        "url": "https://github.com/prettier/prettier?sponsor=1"
+      }
+    },
+    "node_modules/react": {
+      "version": "19.2.3",
+      "resolved": "https://registry.npmjs.org/react/-/react-19.2.3.tgz",
+      "integrity": "sha512-Ku/hhYbVjOQnXDZFv2+RibmLFGwFdeeKHFcOTlrt7xplBnya5OGn/hIRDsqDiSUcfORsDC7MPxwork8jBwsIWA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/rollup": {
+      "version": "4.54.0",
+      "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.54.0.tgz",
+      "integrity": "sha512-3nk8Y3a9Ea8szgKhinMlGMhGMw89mqule3KWczxhIzqudyHdCIOHw8WJlj/r329fACjKLEh13ZSk7oE22kyeIw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/estree": "1.0.8"
+      },
+      "bin": {
+        "rollup": "dist/bin/rollup"
+      },
+      "engines": {
+        "node": ">=18.0.0",
+        "npm": ">=8.0.0"
+      },
+      "optionalDependencies": {
+        "@rollup/rollup-android-arm-eabi": "4.54.0",
+        "@rollup/rollup-android-arm64": "4.54.0",
+        "@rollup/rollup-darwin-arm64": "4.54.0",
+        "@rollup/rollup-darwin-x64": "4.54.0",
+        "@rollup/rollup-freebsd-arm64": "4.54.0",
+        "@rollup/rollup-freebsd-x64": "4.54.0",
+        "@rollup/rollup-linux-arm-gnueabihf": "4.54.0",
+        "@rollup/rollup-linux-arm-musleabihf": "4.54.0",
+        "@rollup/rollup-linux-arm64-gnu": "4.54.0",
+        "@rollup/rollup-linux-arm64-musl": "4.54.0",
+        "@rollup/rollup-linux-loong64-gnu": "4.54.0",
+        "@rollup/rollup-linux-ppc64-gnu": "4.54.0",
+        "@rollup/rollup-linux-riscv64-gnu": "4.54.0",
+        "@rollup/rollup-linux-riscv64-musl": "4.54.0",
+        "@rollup/rollup-linux-s390x-gnu": "4.54.0",
+        "@rollup/rollup-linux-x64-gnu": "4.54.0",
+        "@rollup/rollup-linux-x64-musl": "4.54.0",
+        "@rollup/rollup-openharmony-arm64": "4.54.0",
+        "@rollup/rollup-win32-arm64-msvc": "4.54.0",
+        "@rollup/rollup-win32-ia32-msvc": "4.54.0",
+        "@rollup/rollup-win32-x64-gnu": "4.54.0",
+        "@rollup/rollup-win32-x64-msvc": "4.54.0",
+        "fsevents": "~2.3.2"
+      }
+    },
+    "node_modules/source-map-js": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
+      "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/tinyglobby": {
+      "version": "0.2.15",
+      "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.15.tgz",
+      "integrity": "sha512-j2Zq4NyQYG5XMST4cbs02Ak8iJUdxRM0XI5QyxXuZOzKOINmWurp3smXu3y5wDcJrptwpSjgXHzIQxR0omXljQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "fdir": "^6.5.0",
+        "picomatch": "^4.0.3"
+      },
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/SuperchupuDev"
+      }
+    },
+    "node_modules/typescript": {
+      "version": "5.9.3",
+      "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
+      "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "bin": {
+        "tsc": "bin/tsc",
+        "tsserver": "bin/tsserver"
+      },
+      "engines": {
+        "node": ">=14.17"
+      }
+    },
+    "node_modules/vite": {
+      "version": "7.3.0",
+      "resolved": "https://registry.npmjs.org/vite/-/vite-7.3.0.tgz",
+      "integrity": "sha512-dZwN5L1VlUBewiP6H9s2+B3e3Jg96D0vzN+Ry73sOefebhYr9f94wwkMNN/9ouoU8pV1BqA1d1zGk8928cx0rg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "esbuild": "^0.27.0",
+        "fdir": "^6.5.0",
+        "picomatch": "^4.0.3",
+        "postcss": "^8.5.6",
+        "rollup": "^4.43.0",
+        "tinyglobby": "^0.2.15"
+      },
+      "bin": {
+        "vite": "bin/vite.js"
+      },
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      },
+      "funding": {
+        "url": "https://github.com/vitejs/vite?sponsor=1"
+      },
+      "optionalDependencies": {
+        "fsevents": "~2.3.3"
+      },
+      "peerDependencies": {
+        "@types/node": "^20.19.0 || >=22.12.0",
+        "jiti": ">=1.21.0",
+        "less": "^4.0.0",
+        "lightningcss": "^1.21.0",
+        "sass": "^1.70.0",
+        "sass-embedded": "^1.70.0",
+        "stylus": ">=0.54.8",
+        "sugarss": "^5.0.0",
+        "terser": "^5.16.0",
+        "tsx": "^4.8.1",
+        "yaml": "^2.4.2"
+      },
+      "peerDependenciesMeta": {
+        "@types/node": {
+          "optional": true
+        },
+        "jiti": {
+          "optional": true
+        },
+        "less": {
+          "optional": true
+        },
+        "lightningcss": {
+          "optional": true
+        },
+        "sass": {
+          "optional": true
+        },
+        "sass-embedded": {
+          "optional": true
+        },
+        "stylus": {
+          "optional": true
+        },
+        "sugarss": {
+          "optional": true
+        },
+        "terser": {
+          "optional": true
+        },
+        "tsx": {
+          "optional": true
+        },
+        "yaml": {
+          "optional": true
+        }
+      }
+    }
+  }
+}

package/sdk/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@nockchain/sdk",
+  "version": "0.1.4-nightly.5",
+  "description": "TypeScript SDK for interacting with Nockchain wallet extensions",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./wasm": {
+      "types": "./dist/wasm.d.ts",
+      "import": "./dist/wasm.js"
+    },
+    "./hooks": {
+      "types": "./dist/hooks/index.d.ts",
+      "import": "./dist/hooks/index.js"
+    },
+    "./hooks/use-rose": {
+      "types": "./dist/hooks/use-rose.d.ts",
+      "import": "./dist/hooks/use-rose.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "nockchain",
+    "wallet",
+    "web3",
+    "blockchain",
+    "schnorr"
+  ],
+  "author": "Nockchain.net LLC",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nocktoshi/rose.git",
+    "directory": "sdk"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build-example": "npm run build && tsc --project examples/tsconfig.json && vite build --config vite.config.examples.ts",
+    "dev": "tsc --watch",
+    "dev-example": "vite --config vite.config.examples.ts",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@nockchain/rose-wasm": "^0.1.4-nightly.17.1.a460619",
+    "@scure/base": "2.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "19.2.7",
+    "prettier": "3.7.4",
+    "react": "19.2.3",
+    "typescript": "5.9.3",
+    "vite": "7.3.0"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  }
+}

package/sdk/src/constants.ts

@@ -0,0 +1,28 @@
+/**
+ * Provider method constants for Nockchain wallet
+ * These methods can be called by dApps via window.nockchain
+ */
+export const PROVIDER_METHODS = {
+  /** Connect to the wallet and request access */
+  CONNECT: 'nock_connect',
+
+  /** Sign an arbitrary message */
+  SIGN_MESSAGE: 'nock_signMessage',
+
+  /** Sign and send a transaction */
+  SEND_TRANSACTION: 'nock_sendTransaction',
+
+  /** Get wallet information (PKH + gRPC endpoint) */
+  GET_WALLET_INFO: 'nock_getWalletInfo',
+
+  /** Sign a raw transaction */
+  SIGN_RAW_TX: 'nock_signRawTx',
+
+  /** v0 migration: check if v0 seed is stored */
+  MIGRATE_V0_GET_STATUS: 'nock_migrateV0GetStatus',
+
+  /** v0 migration: sign a raw tx with stored v0 key */
+  MIGRATE_V0_SIGN_RAW_TX: 'nock_migrateV0SignRawTx',
+} as const;
+
+export type ProviderMethod = (typeof PROVIDER_METHODS)[keyof typeof PROVIDER_METHODS];

package/sdk/src/errors.ts

@@ -0,0 +1,74 @@
+/**
+ * Custom error classes for Rose SDK
+ */
+
+/**
+ * Thrown when the Rose wallet extension is not installed
+ */
+export class WalletNotInstalledError extends Error {
+  constructor() {
+    super('Rose wallet extension not installed. Please install it from the Chrome Web Store.');
+    this.name = 'WalletNotInstalledError';
+    Object.setPrototypeOf(this, WalletNotInstalledError.prototype);
+  }
+}
+
+/**
+ * Thrown when the user rejects a transaction or request
+ */
+export class UserRejectedError extends Error {
+  constructor(message = 'User rejected the request') {
+    super(message);
+    this.name = 'UserRejectedError';
+    Object.setPrototypeOf(this, UserRejectedError.prototype);
+  }
+}
+
+/**
+ * Thrown when an invalid Nockchain address is provided
+ */
+export class InvalidAddressError extends Error {
+  constructor(address: string) {
+    super(`Invalid Nockchain address: ${address}`);
+    this.name = 'InvalidAddressError';
+    Object.setPrototypeOf(this, InvalidAddressError.prototype);
+  }
+}
+
+/**
+ * Thrown when transaction building fails due to missing or invalid fields
+ */
+export class InvalidTransactionError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = 'InvalidTransactionError';
+    Object.setPrototypeOf(this, InvalidTransactionError.prototype);
+  }
+}
+
+/**
+ * Thrown when a method is called that requires an account, but no account is connected
+ */
+export class NoAccountError extends Error {
+  constructor() {
+    super('No account connected. Call requestAccounts() first.');
+    this.name = 'NoAccountError';
+    Object.setPrototypeOf(this, NoAccountError.prototype);
+  }
+}
+
+/**
+ * Thrown when the RPC request to the extension fails
+ */
+export class RpcError extends Error {
+  public code: number;
+  public data?: unknown;
+
+  constructor(code: number, message: string, data?: unknown) {
+    super(message);
+    this.name = 'RpcError';
+    this.code = code;
+    this.data = data;
+    Object.setPrototypeOf(this, RpcError.prototype);
+  }
+}

package/sdk/src/hooks/index.ts

@@ -0,0 +1 @@
+export * from './use-rose.js';

package/sdk/src/hooks/use-rose.ts

@@ -0,0 +1,94 @@
+import { useEffect, useMemo, useState } from 'react';
+import { NockchainProvider } from '../provider.js';
+import initWasm from '@nockchain/sdk/wasm';
+import * as wasm from '@nockchain/sdk/wasm';
+
+const ROSE_SDK_WASM_INIT_KEY = '__nockchain_rose_sdk_wasm_init_promise__';
+const ROSE_SDK_PROVIDER_KEY = '__nockchain_rose_sdk_provider__';
+
+/**
+ * Initialize Rose WASM once per page load.
+ * Uses globalThis so React StrictMode + Vite HMR won't accidentally re-init.
+ */
+type WasmInit = ReturnType<typeof initWasm>;
+
+function ensureWasmInitializedOnce(): WasmInit {
+  const g = globalThis as typeof globalThis & Record<string, unknown>;
+
+  const existing = g[ROSE_SDK_WASM_INIT_KEY];
+  if (existing && existing instanceof Promise) {
+    return (existing as WasmInit).catch((err: unknown) => {
+      if (g[ROSE_SDK_WASM_INIT_KEY] === existing) {
+        delete g[ROSE_SDK_WASM_INIT_KEY];
+      }
+      throw err;
+    }) as WasmInit;
+  }
+
+  const p = initWasm().catch((err: unknown) => {
+    if (g[ROSE_SDK_WASM_INIT_KEY] === p) {
+      delete g[ROSE_SDK_WASM_INIT_KEY];
+    }
+    throw err;
+  }) as WasmInit;
+
+  g[ROSE_SDK_WASM_INIT_KEY] = p;
+  return p;
+}
+
+function getProviderOnce(): NockchainProvider {
+  const g = globalThis as typeof globalThis & Record<string, unknown>;
+  const existing = g[ROSE_SDK_PROVIDER_KEY];
+  if (existing instanceof NockchainProvider) return existing;
+
+  const provider = new NockchainProvider();
+  g[ROSE_SDK_PROVIDER_KEY] = provider;
+  return provider;
+}
+
+export type UseRoseStatus = 'idle' | 'loading' | 'ready' | 'error';
+
+export function useRose({ rpcUrl = 'https://rpc.nockbox.org' }: { rpcUrl?: string } = {}) {
+  const [provider, setProvider] = useState<NockchainProvider | null>(null);
+  const [rpcClient, setRpcClient] = useState<unknown>(null);
+  const [status, setStatus] = useState<UseRoseStatus>('idle');
+  const [error, setError] = useState<unknown>(null);
+
+  const options = useMemo(() => ({ rpcUrl }), [rpcUrl]);
+
+  useEffect(() => {
+    let cancelled = false;
+    setStatus('loading');
+    setError(null);
+
+    ensureWasmInitializedOnce()
+      .then(() => {
+        if (cancelled) return;
+        setProvider(getProviderOnce());
+        // The wasm package's type surface may lag runtime exports; keep this resilient.
+        const GrpcClientCtor = (wasm as any).GrpcClient as
+          | (new (rpcUrl: string) => unknown)
+          | undefined;
+        setRpcClient(GrpcClientCtor ? new GrpcClientCtor(options.rpcUrl) : null);
+        setStatus('ready');
+      })
+      .catch((err: unknown) => {
+        if (cancelled) return;
+        setError(err);
+        setStatus('error');
+      });
+
+    return () => {
+      cancelled = true;
+    };
+  }, [options]);
+
+  return {
+    provider,
+    rpcClient,
+    wasm: initWasm,
+    status,
+    error,
+    isReady: status === 'ready',
+  };
+}