@kassealhq/sdk 0.1.0 → 0.2.0

package/docs/wallets.md

@@ -25,7 +25,7 @@ browser wallet with the SDK's adapters.
 
 ### Routes
 
-All under the API base URL (testnet-10: `https://app.kasseal.com/v1`). Public, read-only, no key.
+All under the API base URL (mainnet: `https://app.kasseal.com/v1`, testnet-10: `https://testnet.kasseal.com/v1`). Public, read-only, no key.
 
 | Route | Returns |
 |---|---|
@@ -87,7 +87,7 @@ anything you display as verified.
   extension background requests with host permissions are not affected. Ask Kasseal to allow your web origin if you
   call the API from a web page.
 - **Live updates.** Polling `GET /tokens?sort=new` every 30 to 60 seconds is enough for a wallet. The stream
-  (`wss://app.kasseal.com/v1/stream` on testnet-10) pushes trades and launches; a page that sends an `Origin` header
+  (`wss://app.kasseal.com/v1/stream` on mainnet, `wss://testnet.kasseal.com/v1/stream` on testnet-10) pushes trades and launches; a page that sends an `Origin` header
   is refused unless that origin is allowed.
 - **Signed messages.** The only API writes a wallet is ever asked to sign for are Kasseal's own app actions
   (sign-in, terms, comments, follows). Their messages name the site, so a signature made for another site does not
@@ -122,7 +122,21 @@ const signed = await signBuilt(wallet, built);      // one wallet popup
 **Loading the web entry.** Call `initWeb` once before you build. It instantiates the bundled Kaspa WASM SDK
 (rusty-kaspa v2.1.0) and installs the contract artifacts. If you serve the WASM file yourself (`wasm` option: bytes,
 a URL or a `Response`), the SDK hashes the bytes against the pinned SHA-256 before instantiating them and throws
-`SdkWasmMismatch` on any difference.
+`SdkIntegrityError` on any difference. A wallet or extension that serves one network can import
+`@kassealhq/sdk/web/mainnet` (or `@kassealhq/sdk/web/testnet-10`) instead of `@kassealhq/sdk/web`: same exports,
+but only that network's contract artifacts are reachable by import, so the other build's chunks never end up in your
+package. Its `initWeb` takes no `network`, and refuses any other one.
+
+**Using the wallet's own Kaspa SDK.** A wallet that already ships rusty-kaspa v2.1.0 (web target) need not ship a
+second copy: pass it as `initWeb({ network, kaspa: { module, wasm, sha256 } })`, where `module` is your imported
+bindings namespace (`import * as kaspa from '…/kaspa.js'`), `wasm` its binary (bytes, a URL or a `Response`; leave it
+out if your app has already initialised the module) and `sha256` your binary's digest (optional). Your build need not
+be byte-identical to ours: it is accepted when it reports 2.1.0, exposes the functions the builders call, and
+reproduces the pinned build's known answers (transactions, txids, sighashes, genesis covenant ids, signatures that
+verify) through the builders' own code paths. Otherwise `initWeb` rejects with `SdkCompatibilityError`, whose
+`failures` list every difference, and installs nothing. Run `initWeb` with your build in a test before you ship it. Import `@kassealhq/sdk/web-lite/mainnet` (or
+`@kassealhq/sdk/web-lite/testnet-10`) to leave our bundled Kaspa SDK out of your package: same API, `kaspa` required,
+and neither `kaspa.js` nor `kaspa_bg.wasm` is reachable from it.
 
 **What the wallet signs.** `signBuilt` passes the wallet exactly `built.inputsToSign`: the user's own KAS inputs and,
 for a sell, the user's own token cell. Every signature is `SIGHASH_ALL`. The wallet never signs a curve or pool input.

package/examples/README.md

@@ -1,6 +1,6 @@
 # Examples
 
-Small TypeScript programs against **testnet-10** and the public API at `https://app.kasseal.com/v1`. They are not
+Small TypeScript programs against **testnet-10** and the public API at `https://testnet.kasseal.com/v1`. They are not
 run in CI. Use a testnet-10 wallet with test KAS only; never a mainnet key.
 
 Run them with Node 22.6 or later (`node --experimental-strip-types examples/<file>.ts`) or any TypeScript runner.

package/examples/lib/api.ts

@@ -8,7 +8,7 @@
 import { ApiError, outpointKey, type BuiltTx, type FundingUtxo, type KassealNetwork } from '@kassealhq/sdk';
 
 export const NETWORK: KassealNetwork = 'testnet-10';
-export const API_BASE = 'https://app.kasseal.com/v1';
+export const API_BASE = 'https://testnet.kasseal.com/v1';
 
 /* -------------------------------------------------------------------------- */
 /* HTTP                                                                        */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kassealhq/sdk",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Quotes, transaction builders, launch-proof verification and wallet adapters for Kasseal tokens on Kaspa.",
   "license": "MIT",
   "type": "module",
@@ -36,6 +36,22 @@
       "types": "./dist/web.d.ts",
       "default": "./dist/web.js"
     },
+    "./web/mainnet": {
+      "types": "./dist/web-mainnet.d.ts",
+      "default": "./dist/web-mainnet.js"
+    },
+    "./web/testnet-10": {
+      "types": "./dist/web-testnet-10.d.ts",
+      "default": "./dist/web-testnet-10.js"
+    },
+    "./web-lite/mainnet": {
+      "types": "./dist/web-lite-mainnet.d.ts",
+      "default": "./dist/web-lite-mainnet.js"
+    },
+    "./web-lite/testnet-10": {
+      "types": "./dist/web-lite-testnet-10.d.ts",
+      "default": "./dist/web-lite-testnet-10.js"
+    },
     "./package.json": "./package.json"
   },
   "main": "./dist/index.js",
@@ -64,6 +80,7 @@
     "gen": "node scripts/build.mjs --gen-only",
     "typecheck": "node scripts/build.mjs --gen-only && tsc -p tsconfig.json && tsc -p tsconfig.web.json",
     "test": "node scripts/build.mjs && node --test test/*.test.mjs",
+    "kat:fixtures": "node scripts/kat-fixtures.mjs",
     "release:check": "node scripts/release-check.mjs"
   },
   "devDependencies": {