@waterx/sdk 4.3.1 → 4.3.3

package/dist/src/perp/client.d.ts

@@ -32,10 +32,11 @@ export interface CreateClientOptions extends LoadConfigOptions {
      *   and a `pythApiKey` (Lazer is auth-first); Lazer infra lives in the
      *   source's own `LAZER_INFRA` table.
      * - `'waterx_rule'` — the first-party WaterX quote-center (Nautilus-TEE,
-     *   ed25519-signed batches): ONE envelope covering the build's tickers,
-     *   verified AND fed by a single `collect_batch_latest` per collector. No
-     *   credential and no per-update fee; needs `packages.waterx_rule` with
-     *   feeds. Quote-center infra lives in the source's own `WATERX_INFRA`
+     *   ed25519-signed prices): one signed Merkle LEAF per ticker, verified AND
+     *   fed by a single `collect_single_with_proof` per collector (falling back to
+     *   one whole-batch envelope + `collect_batch_latest` against a quote-center
+     *   with no leaf route). No credential and no per-update fee; needs
+     *   `packages.waterx_rule` with feeds. Quote-center infra lives in the source's own `WATERX_INFRA`
      *   table; endpoint/transport overridable via
      *   {@link CreateClientOptions.waterxEndpoint} /
      *   {@link CreateClientOptions.waterxFetch} — the browser-CORS proxy hook,
@@ -72,15 +73,16 @@ export interface CreateClientOptions extends LoadConfigOptions {
      * Quote-center base URL for `oracleSource: 'waterx_rule'` — overrides the
      * source's own per-network `WATERX_INFRA` default.
      *
-     * This is the one source a BROWSER fetches itself (the signed envelope is
-     * pulled from the page), so it is bound by the quote-center deployment's CORS
+     * This is the one source a BROWSER fetches itself (the signed price is pulled
+     * from the page), so it is bound by the quote-center deployment's CORS
      * allowlist. A front end whose origin is not allowed — or one that must route
      * egress through its own backend — points this at a same-origin proxy that
-     * forwards `GET /v1/quotes/update`. Unused by the Pyth sources.
+     * forwards `GET /v1/quotes/leaves` (and `GET /v1/quotes/update`, the fallback
+     * route). Unused by the Pyth sources.
      *
      * An absolute URL. Any base PATH is preserved (`joinEndpointPath`), so
      * `https://app.example/api/quote-center` fetches
-     * `https://app.example/api/quote-center/v1/quotes/update` — a proxy route
+     * `https://app.example/api/quote-center/v1/quotes/leaves` — a proxy route
      * survives instead of being rewritten to the origin root.
      */
     waterxEndpoint?: string;

package/dist/src/perp/index.d.ts

@@ -13,8 +13,8 @@ export type { EstLiqPriceViewOpts } from "./liq-view.ts";
 export * from "./user/index.ts";
 export * from "./tx-builders.ts";
 export * from "./fetch.ts";
-export { FetchPolicyError, LazerApiKeyMissingError, OracleFeeSourceUnavailableError, OracleSourceNotImplementedError, PythCache, aggregateTicker, aggregateTickerWithConstant, aggregateTickerWithPyth, ORACLE_SOURCES, buildPythPriceUpdateCalls, fetchPriceFeedsUpdateData, isOracleSource, parseOracleSourceList, pythCoreHermesEndpoint, pythProHermesEndpoint, refreshOraclePrices, resolveHermesReadEndpoint, updatePythPrices, waterxEnvelopeOf, waterxQuoteCenterEndpoint, } from "../oracle/index.ts";
-export type { FetchPolicy, OracleFeeSource, OracleSource, UpdateDataProvider, } from "../oracle/index.ts";
+export { FetchPolicyError, LazerApiKeyMissingError, OracleFeeSourceUnavailableError, OracleSourceNotImplementedError, PythCache, aggregateTicker, aggregateTickerWithConstant, aggregateTickerWithPyth, ORACLE_SOURCES, buildPythPriceUpdateCalls, fetchPriceFeedsUpdateData, isOracleSource, parseOracleSourceList, pythCoreHermesEndpoint, pythProHermesEndpoint, refreshOraclePrices, resolveHermesReadEndpoint, updatePythPrices, waterxEnvelopeOf, waterxLeavesOf, parseSignedLeaves, MERKLE_ROOT_INTENT, waterxQuoteCenterEndpoint, } from "../oracle/index.ts";
+export type { FetchPolicy, OracleFeeSource, OracleSource, UpdateDataProvider, WaterxBatchItem, WaterxEnvelopePayload, WaterxLeafPayload, WaterxSignedEnvelope, WaterxSignedLeaf, WaterxUpdatePayload, } from "../oracle/index.ts";
 export { fetchDepositVaa, fetchVaa, listBridgeWithdrawalVaas, listVaasByEmitter, padEvmEmitter, toWormholescanEmitter, vaaBase64ToBytes, vaaBase64ToHex, vaaBytesToBase64, waitForVaa, } from "../account/funding/wormhole.ts";
 export type { VaaListItem, VaaResponse, WormholescanOptions } from "../account/funding/wormhole.ts";
 export { AccountData as AccountDataBcs, GlobalConfigData as GlobalConfigDataBcs, MarketData as MarketDataBcs, OrderData as OrderDataBcs, PoolData as PoolDataBcs, PositionData as PositionDataBcs, RedeemRequestData as RedeemRequestDataBcs, TokenPoolData as TokenPoolDataBcs, } from "../generated/waterx_perp_view/view.ts";

package/dist/src/perp/index.js

@@ -15,7 +15,13 @@ export * from "./tx-builders.js";
 // ======== Read-only queries ========
 export * from "./fetch.js";
 // ======== Oracle utilities (Pyth source + rule aggregation) ========
-export { FetchPolicyError, LazerApiKeyMissingError, OracleFeeSourceUnavailableError, OracleSourceNotImplementedError, PythCache, aggregateTicker, aggregateTickerWithConstant, aggregateTickerWithPyth, ORACLE_SOURCES, buildPythPriceUpdateCalls, fetchPriceFeedsUpdateData, isOracleSource, parseOracleSourceList, pythCoreHermesEndpoint, pythProHermesEndpoint, refreshOraclePrices, resolveHermesReadEndpoint, updatePythPrices, waterxEnvelopeOf, waterxQuoteCenterEndpoint, } from "../oracle/index.js";
+export { FetchPolicyError, LazerApiKeyMissingError, OracleFeeSourceUnavailableError, OracleSourceNotImplementedError, PythCache, aggregateTicker, aggregateTickerWithConstant, aggregateTickerWithPyth, ORACLE_SOURCES, buildPythPriceUpdateCalls, fetchPriceFeedsUpdateData, isOracleSource, parseOracleSourceList, pythCoreHermesEndpoint, pythProHermesEndpoint, refreshOraclePrices, resolveHermesReadEndpoint, updatePythPrices, waterxEnvelopeOf, 
+// Leaves are the DEFAULT waterx wire shape, so their accessor + parser belong
+// on the same surface as `waterxEnvelopeOf` (and on the root, which re-exports
+// this file). A prefetch cache written against the envelope-only surface would
+// otherwise get `null` from its only accessor on the normal path and have to
+// discover `@waterx/sdk/oracle` to fix it.
+waterxLeavesOf, parseSignedLeaves, MERKLE_ROOT_INTENT, waterxQuoteCenterEndpoint, } from "../oracle/index.js";
 // ======== Wormhole / Wormholescan utilities (credit bridge) ========
 export { fetchDepositVaa, fetchVaa, listBridgeWithdrawalVaas, listVaasByEmitter, padEvmEmitter, toWormholescanEmitter, vaaBase64ToBytes, vaaBase64ToHex, vaaBytesToBase64, waitForVaa, } from "../account/funding/wormhole.js";
 // ======== Generated BCS types (sui-ts-codegen) ========

package/dist/src/unified-client.d.ts

@@ -406,7 +406,7 @@ export interface ClientCreateOptions {
      * the quote-center deployment's CORS allowlist: a front end whose origin is
      * not allowed points this at its own same-origin proxy. An absolute URL whose
      * base PATH is preserved — `https://app.example/api/quote-center` fetches
-     * `…/api/quote-center/v1/quotes/update`. Unused by the Pyth sources.
+     * `…/api/quote-center/v1/quotes/leaves`. Unused by the Pyth sources.
      */
     waterxEndpoint?: string;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@waterx/sdk",
-  "version": "4.3.1",
+  "version": "4.3.3",
   "description": "WaterX SDK — perpetuals and prediction markets on Sui",
   "license": "MIT",
   "author": "WaterX",
@@ -155,8 +155,13 @@
     },
     "./package.json": "./package.json"
   },
+  "engines": {
+    "node": ">=22"
+  },
   "files": [
     "dist",
+    ".claude/skills/waterx-sdk-integration/SKILL.md",
+    "SKILLS.md",
     "LICENSE",
     "package.json"
   ],
@@ -174,7 +179,8 @@
     "oracle:aggregates:testnet": "tsx scripts/print-oracle-aggregates.ts --testnet",
     "oracle:aggregates:mainnet": "tsx scripts/print-oracle-aggregates.ts --mainnet",
     "typecheck": "tsc --noEmit",
-    "check": "pnpm lint && pnpm typecheck && pnpm test:unit",
+    "docs:check": "tsx scripts/check-docs-links.ts",
+    "check": "pnpm docs:check && pnpm typecheck && pnpm test:unit && pnpm lint",
     "test": "vitest run --project unit --project predict-unit",
     "test:unit": "vitest run --project unit --project predict-unit",
     "test:unit:perp": "vitest run --project unit",