@waterx/sdk 3.0.1 → 3.0.3

package/dist/cjs/src/perp/config-view.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Perp config-schema views — read-only lookups over the parsed `waterx-config`
+ * JSON, with no transport dependency.
+ *
+ * Split off the transport client (`PerpClient`) so the two responsibilities stay
+ * separate: `BaseLineClient` owns the gRPC half, this class owns the
+ * canonical-schema half. `PerpClient` composes one of these and delegates, so
+ * callers keep calling `client.getMarket(...)` / `client.wlpType()` unchanged.
+ * Tested in isolation against a plain config object — no network needed.
+ */
+import type { NativeCustodyAsset, WaterXConfig, WormholeInfraConfig } from "./config.ts";
+export declare class PerpConfigView {
+    private readonly getConfig;
+    private readonly getWormhole;
+    constructor(getConfig: () => WaterXConfig, getWormhole: () => WormholeInfraConfig);
+    private get config();
+    private get wormhole();
+    /** `waterx_perp.markets[ticker]`, throws if unknown. */
+    getMarket(ticker: string): import("./config.ts").WaterxPerpMarketEntry;
+    /** `waterx_oracle.aggregators[ticker]`, throws if unknown. */
+    getAggregator(ticker: string): string;
+    /** `pyth_rule.feeds[ticker]`, throws if unknown. */
+    getPythFeed(ticker: string): {
+        feed_id: string;
+        price_info_object: string;
+    };
+    /**
+     * True when `ticker` is priced by `constant_rule` (a constant pin,
+     * e.g. `USDCUSD → $1`) rather than Pyth. Such tickers are fed via
+     * `constant_rule::feed` and need no Pyth update; see {@link refreshOraclePrices}.
+     *
+     * All-or-nothing, mirroring {@link getSupraRule} and the keeper: only routes a
+     * ticker to the constant rule when the rule is FULLY wired (`published_at` +
+     * `config` present). A half-populated block — a `feeds` entry listed before the
+     * rule is deployed, a realistic mid-rollout state — would otherwise make this
+     * true while {@link aggregateTicker} throws, aborting the whole price-refresh PTB
+     * instead of safely falling back to Pyth.
+     *
+     * Whether a constant ticker is *also* Pyth-fed (the dual-feed transition state)
+     * or constant-only is not a separate flag — it falls out of whether the ticker
+     * still has a `pyth_rule.feeds` entry. {@link aggregateTicker} feeds each rule the
+     * ticker is configured for, so no `isDualFeed` / `isConstantOnly` predicate is needed.
+     */
+    isConstantTicker(ticker: string): boolean;
+    /**
+     * The `supra_rule` config when it is deployed, enabled, and fully wired
+     * (`config` + `oracle_holder`), else `undefined`. When present, callers feed
+     * `supra_rule::feed` as a second weighted rule alongside Pyth on the same
+     * collector; see {@link refreshOraclePrices}. Default-off, so a Pyth-only
+     * deployment returns `undefined` here.
+     */
+    getSupraRule(): {
+        published_at: string;
+        config: string;
+        oracle_holder: string;
+    } | undefined;
+    /**
+     * Resolve a WLP pool token's fully-qualified Move type.
+     *
+     * `wlp.pool_tokens` is keyed by **oracle ticker** (e.g. `"USDCUSD"`) — the
+     * Rust keeper requires this, since it reuses each key to look up the token's
+     * aggregator + pyth feed. For ergonomics this also accepts the coin symbol
+     * (the trailing `::Struct` segment, e.g. `"USD"` → `…::usd::USD`): an exact
+     * ticker hit wins, otherwise we match by coin name. Throws if neither hits.
+     */
+    getPoolTokenType(tickerOrName: string): string;
+    /** Fully-qualified WLP coin type derived from `wlp.original_id`. */
+    wlpType(): string;
+    /**
+     * List of rewarders registered for a staking pool alias, e.g. `"WLP"`.
+     * Returns an empty array if the deployment has no rewarders configured.
+     * Each entry carries the rewarder shared object ID + the fully-qualified
+     * reward coin type, so callers don't need a separate alias-to-type lookup.
+     */
+    getRewarders(stakeAlias: string): {
+        alias: string;
+        rewarder_id: string;
+        coin_type: string;
+        decimals: number;
+    }[];
+    /** Type list of every reward coin for a stake pool — convenience for stake/unstake/claim. */
+    getRewarderTypes(stakeAlias: string): string[];
+    /** `waterx_credit` package entry, throws if the deployment has no bridge. */
+    getCredit(): import("./config.ts").WaterxCreditPackage;
+    /**
+     * Fully-qualified CREDIT coin Move type, taken verbatim from
+     * `waterx_credit.credit_type` (e.g. `0x..::usd::USD`). Throws if absent —
+     * the deprecated `usdx` OTW package is intentionally not consulted.
+     */
+    creditType(): string;
+    /** `wormhole_bridge` package entry, throws if absent. */
+    getBridge(): import("./config.ts").WormholeBridgePackage;
+    /**
+     * Sui Wormhole `State` object id — prefers the per-deployment
+     * `wormhole_bridge.wormhole_state`, falls back to the line's `wormhole` infra.
+     */
+    wormholeStateId(): string;
+    /** All native-custody backing-asset rows (throws if no custody vault). */
+    getNativeAssets(): readonly NativeCustodyAsset[];
+    /** A native-custody asset row by its fully-qualified Move type, throws if unknown. */
+    getNativeAsset(moveType: string): NativeCustodyAsset;
+}

package/dist/cjs/src/perp/config-view.js

@@ -0,0 +1,178 @@
+"use strict";
+/**
+ * Perp config-schema views — read-only lookups over the parsed `waterx-config`
+ * JSON, with no transport dependency.
+ *
+ * Split off the transport client (`PerpClient`) so the two responsibilities stay
+ * separate: `BaseLineClient` owns the gRPC half, this class owns the
+ * canonical-schema half. `PerpClient` composes one of these and delegates, so
+ * callers keep calling `client.getMarket(...)` / `client.wlpType()` unchanged.
+ * Tested in isolation against a plain config object — no network needed.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PerpConfigView = void 0;
+class PerpConfigView {
+    getConfig;
+    getWormhole;
+    // Config/wormhole are read through providers, not captured by value, so a later
+    // `client.config = …` reassignment stays live (matches the pre-split behaviour
+    // where every lookup read `this.config` fresh).
+    constructor(getConfig, getWormhole) {
+        this.getConfig = getConfig;
+        this.getWormhole = getWormhole;
+    }
+    get config() {
+        return this.getConfig();
+    }
+    get wormhole() {
+        return this.getWormhole();
+    }
+    /** `waterx_perp.markets[ticker]`, throws if unknown. */
+    getMarket(ticker) {
+        const m = this.config.packages.waterx_perp?.markets?.[ticker];
+        if (!m)
+            throw new Error(`Unknown market ticker: ${ticker}`);
+        return m;
+    }
+    /** `waterx_oracle.aggregators[ticker]`, throws if unknown. */
+    getAggregator(ticker) {
+        const a = this.config.packages.waterx_oracle?.aggregators?.[ticker];
+        if (!a)
+            throw new Error(`No aggregator listed for ticker: ${ticker}`);
+        return a;
+    }
+    /** `pyth_rule.feeds[ticker]`, throws if unknown. */
+    getPythFeed(ticker) {
+        const f = this.config.packages.pyth_rule?.feeds?.[ticker];
+        if (!f)
+            throw new Error(`No pyth feed listed for ticker: ${ticker}`);
+        return f;
+    }
+    /**
+     * True when `ticker` is priced by `constant_rule` (a constant pin,
+     * e.g. `USDCUSD → $1`) rather than Pyth. Such tickers are fed via
+     * `constant_rule::feed` and need no Pyth update; see {@link refreshOraclePrices}.
+     *
+     * All-or-nothing, mirroring {@link getSupraRule} and the keeper: only routes a
+     * ticker to the constant rule when the rule is FULLY wired (`published_at` +
+     * `config` present). A half-populated block — a `feeds` entry listed before the
+     * rule is deployed, a realistic mid-rollout state — would otherwise make this
+     * true while {@link aggregateTicker} throws, aborting the whole price-refresh PTB
+     * instead of safely falling back to Pyth.
+     *
+     * Whether a constant ticker is *also* Pyth-fed (the dual-feed transition state)
+     * or constant-only is not a separate flag — it falls out of whether the ticker
+     * still has a `pyth_rule.feeds` entry. {@link aggregateTicker} feeds each rule the
+     * ticker is configured for, so no `isDualFeed` / `isConstantOnly` predicate is needed.
+     */
+    isConstantTicker(ticker) {
+        const c = this.config.packages.constant_rule;
+        if (!c?.published_at || !c.config)
+            return false;
+        return c.feeds?.[ticker] !== undefined;
+    }
+    /**
+     * The `supra_rule` config when it is deployed, enabled, and fully wired
+     * (`config` + `oracle_holder`), else `undefined`. When present, callers feed
+     * `supra_rule::feed` as a second weighted rule alongside Pyth on the same
+     * collector; see {@link refreshOraclePrices}. Default-off, so a Pyth-only
+     * deployment returns `undefined` here.
+     */
+    getSupraRule() {
+        const s = this.config.packages.supra_rule;
+        if (!s?.enabled || !s.published_at || !s.config || !s.oracle_holder)
+            return undefined;
+        return { published_at: s.published_at, config: s.config, oracle_holder: s.oracle_holder };
+    }
+    /**
+     * Resolve a WLP pool token's fully-qualified Move type.
+     *
+     * `wlp.pool_tokens` is keyed by **oracle ticker** (e.g. `"USDCUSD"`) — the
+     * Rust keeper requires this, since it reuses each key to look up the token's
+     * aggregator + pyth feed. For ergonomics this also accepts the coin symbol
+     * (the trailing `::Struct` segment, e.g. `"USD"` → `…::usd::USD`): an exact
+     * ticker hit wins, otherwise we match by coin name. Throws if neither hits.
+     */
+    getPoolTokenType(tickerOrName) {
+        const poolTokens = this.config.packages.wlp?.pool_tokens ?? {};
+        const exact = poolTokens[tickerOrName];
+        if (exact)
+            return exact;
+        for (const t of Object.values(poolTokens)) {
+            if (typeof t === "string" && t.split("::").pop() === tickerOrName)
+                return t;
+        }
+        throw new Error(`No pool token registered for ticker/name: ${tickerOrName}`);
+    }
+    /** Fully-qualified WLP coin type derived from `wlp.original_id`. */
+    wlpType() {
+        const w = this.config.packages.wlp;
+        if (!w?.original_id)
+            throw new Error("wlp.original_id missing from config");
+        return `${w.original_id}::wlp::WLP`;
+    }
+    /**
+     * List of rewarders registered for a staking pool alias, e.g. `"WLP"`.
+     * Returns an empty array if the deployment has no rewarders configured.
+     * Each entry carries the rewarder shared object ID + the fully-qualified
+     * reward coin type, so callers don't need a separate alias-to-type lookup.
+     */
+    getRewarders(stakeAlias) {
+        const map = this.config.packages.waterx_staking?.rewarders?.[stakeAlias];
+        if (!map)
+            return [];
+        return Object.entries(map).map(([alias, entry]) => ({ alias, ...entry }));
+    }
+    /** Type list of every reward coin for a stake pool — convenience for stake/unstake/claim. */
+    getRewarderTypes(stakeAlias) {
+        return this.getRewarders(stakeAlias).map((r) => r.coin_type);
+    }
+    /** `waterx_credit` package entry, throws if the deployment has no bridge. */
+    getCredit() {
+        const c = this.config.packages.waterx_credit;
+        if (!c)
+            throw new Error("waterx_credit not configured for this deployment");
+        return c;
+    }
+    /**
+     * Fully-qualified CREDIT coin Move type, taken verbatim from
+     * `waterx_credit.credit_type` (e.g. `0x..::usd::USD`). Throws if absent —
+     * the deprecated `usdx` OTW package is intentionally not consulted.
+     */
+    creditType() {
+        const t = this.config.packages.waterx_credit?.credit_type;
+        if (!t) {
+            throw new Error("creditType: packages.waterx_credit.credit_type missing from config");
+        }
+        return t;
+    }
+    /** `wormhole_bridge` package entry, throws if absent. */
+    getBridge() {
+        const b = this.config.packages.wormhole_bridge;
+        if (!b)
+            throw new Error("wormhole_bridge not configured for this deployment");
+        return b;
+    }
+    /**
+     * Sui Wormhole `State` object id — prefers the per-deployment
+     * `wormhole_bridge.wormhole_state`, falls back to the line's `wormhole` infra.
+     */
+    wormholeStateId() {
+        return this.config.packages.wormhole_bridge?.wormhole_state ?? this.wormhole.state_id;
+    }
+    /** All native-custody backing-asset rows (throws if no custody vault). */
+    getNativeAssets() {
+        const nc = this.config.packages.native_custody;
+        if (!nc)
+            throw new Error("native_custody not configured for this deployment");
+        return nc.assets;
+    }
+    /** A native-custody asset row by its fully-qualified Move type, throws if unknown. */
+    getNativeAsset(moveType) {
+        const row = this.getNativeAssets().find((a) => a.type === moveType);
+        if (!row)
+            throw new Error(`No native custody asset registered for type: ${moveType}`);
+        return row;
+    }
+}
+exports.PerpConfigView = PerpConfigView;

package/dist/cjs/src/perp/config.d.ts

@@ -0,0 +1,126 @@
+/**
+ * WaterX deployment config — fetched at client init from the canonical
+ * `waterx-config` repo (default: GitHub raw).
+ *
+ * The schema mirrors the canonical JSON layout one-to-one (each package
+ * groups its own object IDs + per-ticker maps). External chain infra
+ * (Pyth state, Wormhole state/core, Hermes & Wormholescan endpoints) is
+ * **not** in the JSON — it lives in `PYTH_DEFAULTS` / `WORMHOLE_DEFAULTS`
+ * below, keyed by network.
+ */
+import type { AccountPackages, BasePackageEntry, WormholeInfraConfig } from "../account/config.ts";
+import type { OraclePackages, PythInfraConfig } from "../oracle/config.ts";
+import type { Network } from "./constants.ts";
+export type { AccountConfig, AccountPackages, BasePackageEntry, NativeCustodyAsset, NativeCustodyPackage, TrustedEmitterRow, WaterxCreditPackage, WaterxReferralPackage, WithdrawalQueuePackage, WormholeBridgePackage, WormholeInfraConfig, WxaAccountPackage, } from "../account/config.ts";
+export type { ConstantFeedEntry, OracleConfig, OraclePackages, PythInfraConfig, PythRulePackage, PythSponsorRulePackage, SupraFeedEntry, SupraRulePackage, WaterxConstantRulePackage, WaterxOraclePackage, } from "../oracle/config.ts";
+export { PYTH_DEFAULTS } from "../oracle/config.ts";
+export interface WaterxPerpMarketEntry {
+    market: string;
+    config: string;
+}
+export interface WaterxPerpPackage extends BasePackageEntry {
+    admin_cap: string;
+    global_config: string;
+    market_registry_wlp: string;
+    markets: Record<string, WaterxPerpMarketEntry>;
+}
+export interface RewarderEntry {
+    /** `Rewarder<STAKE, R>` shared object ID. */
+    rewarder_id: string;
+    /** Fully-qualified reward coin Move type (e.g. `0x2::sui::SUI`). */
+    coin_type: string;
+    /** Reward coin display decimals. */
+    decimals: number;
+}
+export interface WaterxStakingPackage extends BasePackageEntry {
+    admin_cap?: string;
+    /** Map of stake-type alias (e.g. `"WLP"`) → `StakingPool<STAKE>` shared object ID. */
+    pools?: Record<string, string>;
+    /**
+     * Map of stake-type alias → reward-token alias → rewarder metadata.
+     * Reward-token alias is display-only (e.g. `"SUI"`, `"MOCK_SUI"`); the
+     * fully-qualified coin Move type lives on the {@link RewarderEntry}.
+     */
+    rewarders?: Record<string, Record<string, RewarderEntry>>;
+}
+export interface WlpPackage extends BasePackageEntry {
+    metadata_cap?: string;
+    currency?: string;
+    wlp_pool: string;
+    /** Optional `WlpAum<LP>` shared object; required by `mint_wlp` / `settle_redeem`. */
+    wlp_aum?: string;
+    /** Map of oracle ticker → fully-qualified Move type registered via `lp_pool::add_token`. */
+    pool_tokens: Record<string, string>;
+}
+export interface MockCoinPackage extends BasePackageEntry {
+    currency?: string;
+    treasury_cap?: string;
+    metadata_cap?: string;
+}
+export interface TestnetFaucetPackage {
+    published_at: string;
+    whitelist?: string[];
+    faucet?: string;
+}
+export interface WaterXPackages extends AccountPackages, OraclePackages {
+    waterx_perp: WaterxPerpPackage;
+    waterx_perp_view: BasePackageEntry;
+    waterx_staking?: WaterxStakingPackage;
+    wlp: WlpPackage;
+    testnet_faucet?: TestnetFaucetPackage;
+    mock_usdc?: MockCoinPackage;
+    mock_usdsui?: MockCoinPackage;
+    mock_sui?: MockCoinPackage;
+    waterx_rule?: BasePackageEntry;
+    waterx_rule_nautilus_enclave?: BasePackageEntry;
+}
+export declare const WORMHOLE_DEFAULTS: Record<Network, WormholeInfraConfig>;
+export interface WaterXConfig {
+    /** Absent on credit-only deployment files. */
+    network?: "mainnet" | "testnet";
+    chain_id?: string | number | null;
+    /** Sui gRPC base URL (default: public Mysten fullnode for the network). */
+    grpcUrl?: string;
+    packages: WaterXPackages;
+    /** Pyth infra override (defaults from `PYTH_DEFAULTS[network]`). */
+    pyth?: PythInfraConfig;
+    /** Wormhole infra override (defaults from `WORMHOLE_DEFAULTS[network]`). */
+    wormhole?: WormholeInfraConfig;
+    /** Sui `CoinRegistry` shared object (credit deployments). */
+    coin_registry?: string;
+    /** Per-module credit supply caps (credit deployments). */
+    credit_caps?: Record<string, string>;
+    /** Deploy-script phase completion flags (credit deployments). */
+    done?: Record<string, boolean>;
+}
+export interface LoadConfigOptions {
+    /**
+     * Override the default config URL. Use this to point at a staging branch
+     * (`?ref=staging`) or a local mirror during development. Takes precedence
+     * over {@link configRef}.
+     */
+    configUrl?: string;
+    /**
+     * Pin the canonical config to a specific git ref — a commit SHA, branch,
+     * or tag — instead of the default `main` branch. Resolves to
+     * `https://raw.githubusercontent.com/WaterXProtocol/waterx-config/<ref>/<network>.json`.
+     * Ignored when {@link configUrl} is set.
+     */
+    configRef?: string;
+    /**
+     * Reuse a previously-fetched config from the in-memory cache (keyed by
+     * the effective URL). Default: false (always fetch fresh).
+     */
+    cache?: boolean;
+    /** Optional fetch implementation (for tests or environments without global `fetch`). */
+    fetchImpl?: typeof fetch;
+    /** Optional request timeout in ms. Default 10_000. */
+    timeoutMs?: number;
+}
+/**
+ * Build the canonical config URL for `network`, optionally pinned to a
+ * specific git `ref` (commit SHA, branch, or tag). Defaults to `main`.
+ */
+export declare function defaultConfigUrl(network: Network, ref?: string): string;
+export declare function clearConfigCache(): void;
+export declare function loadConfig(network: Network, opts?: LoadConfigOptions): Promise<WaterXConfig>;

package/dist/cjs/src/perp/config.js

@@ -0,0 +1,119 @@
+"use strict";
+/**
+ * WaterX deployment config — fetched at client init from the canonical
+ * `waterx-config` repo (default: GitHub raw).
+ *
+ * The schema mirrors the canonical JSON layout one-to-one (each package
+ * groups its own object IDs + per-ticker maps). External chain infra
+ * (Pyth state, Wormhole state/core, Hermes & Wormholescan endpoints) is
+ * **not** in the JSON — it lives in `PYTH_DEFAULTS` / `WORMHOLE_DEFAULTS`
+ * below, keyed by network.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WORMHOLE_DEFAULTS = exports.PYTH_DEFAULTS = void 0;
+exports.defaultConfigUrl = defaultConfigUrl;
+exports.clearConfigCache = clearConfigCache;
+exports.loadConfig = loadConfig;
+var config_ts_1 = require("../oracle/config.js");
+Object.defineProperty(exports, "PYTH_DEFAULTS", { enumerable: true, get: function () { return config_ts_1.PYTH_DEFAULTS; } });
+// ============================================================================
+// Wormhole / Hermes — external chain infra, defaults by network
+// ============================================================================
+//
+// `PythInfraConfig` + `PYTH_DEFAULTS` live in `oracle/config.ts` (shared infra)
+// and are re-exported at the top of this file.
+// `WormholeInfraConfig` is defined in `account/config.ts` (funding base) and
+// re-exported at the top of this file. `state_id` is the same shared Sui
+// Wormhole `State` object Pyth uses (kept in sync with
+// `PYTH_DEFAULTS[*].wormhole_state_id`).
+exports.WORMHOLE_DEFAULTS = {
+    MAINNET: {
+        state_id: "0xaeab97f96cf9877fee2883315d459552b2b921edc16d7ceac6eab944dd88919c",
+        core_package: "0x5306f64e312b581766351c07af79c72fcb1cd25147157fdc2f8ad76de9a3fb6a",
+        sui_chain_id: 21,
+        wormholescan_api: "https://api.wormholescan.io/api/v1",
+    },
+    TESTNET: {
+        state_id: "0x31358d198147da50db32eda2562951d53973a0c0ad5ed738e9b17d88b213d790",
+        core_package: "0xf47329f4344f3bf0f8e436e2f7b485466cff300f12a166563995d3888c296a94",
+        sui_chain_id: 21,
+        wormholescan_api: "https://api.testnet.wormholescan.io/api/v1",
+    },
+};
+const CONFIG_REPO_RAW_BASE = "https://raw.githubusercontent.com/WaterXProtocol/waterx-config";
+/** Default git ref for the canonical config when none is pinned. */
+const DEFAULT_CONFIG_REF = "main";
+/**
+ * Build the canonical config URL for `network`, optionally pinned to a
+ * specific git `ref` (commit SHA, branch, or tag). Defaults to `main`.
+ */
+function defaultConfigUrl(network, ref = DEFAULT_CONFIG_REF) {
+    return `${CONFIG_REPO_RAW_BASE}/${ref}/${network.toLowerCase()}.json`;
+}
+const cache = new Map();
+function clearConfigCache() {
+    cache.clear();
+}
+async function loadConfig(network, opts = {}) {
+    const url = opts.configUrl ?? defaultConfigUrl(network, opts.configRef);
+    if (opts.cache && cache.has(url)) {
+        return cache.get(url);
+    }
+    const fetchImpl = opts.fetchImpl ?? globalThis.fetch;
+    if (!fetchImpl) {
+        throw new Error("loadConfig: no global `fetch` available; pass opts.fetchImpl");
+    }
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), opts.timeoutMs ?? 10_000);
+    let response;
+    try {
+        response = await fetchImpl(url, { signal: controller.signal });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+    if (!response.ok) {
+        throw new Error(`loadConfig: HTTP ${response.status} fetching ${url}`);
+    }
+    const raw = (await response.json());
+    validateConfig(raw, network, url);
+    if (opts.cache)
+        cache.set(url, raw);
+    return raw;
+}
+function validateConfig(cfg, expected, url) {
+    // `network` is only present on perp deployment files; credit-only files
+    // omit it. Enforce the guard only when the field is present.
+    if (cfg.network !== undefined && cfg.network !== expected.toLowerCase()) {
+        throw new Error(`loadConfig: config at ${url} declares network=${cfg.network} but caller asked for ${expected}`);
+    }
+    if (!cfg.packages || typeof cfg.packages !== "object") {
+        throw new Error(`loadConfig: config at ${url} has no packages object`);
+    }
+    const hasPublishedAt = (k) => {
+        const entry = cfg.packages[k];
+        return !!entry && typeof entry === "object" && !!entry.published_at;
+    };
+    // Validate by deployment kind. A perp config must carry the perp set; a
+    // credit config the credit set. `waterx_account` is common to both.
+    const isPerp = "waterx_perp" in cfg.packages;
+    const isCredit = "waterx_credit" in cfg.packages || "wormhole_bridge" in cfg.packages;
+    const required = isPerp
+        ? [
+            "bucket_framework",
+            "pyth_rule",
+            "waterx_account",
+            "waterx_oracle",
+            "waterx_perp",
+            "waterx_perp_view",
+            "wlp",
+        ]
+        : isCredit
+            ? ["bucket_framework", "waterx_account", "waterx_credit"]
+            : ["bucket_framework", "waterx_account"];
+    for (const k of required) {
+        if (!hasPublishedAt(k)) {
+            throw new Error(`loadConfig: config at ${url} missing packages.${k}.published_at`);
+        }
+    }
+}

package/dist/cjs/src/perp/constants.d.ts

@@ -0,0 +1,49 @@
+export * from "../constants.ts";
+/** Default crypto market trading fee rate (3 bps). Per-market value lives in MarketConfig. */
+export declare const CRYPTO_FEE_RATE = 0.0003;
+/** Default stock / commodity market trading fee rate (5 bps). Per-market value lives in MarketConfig. */
+export declare const STOCK_FEE_RATE = 0.0005;
+/** Default maintenance margin rate (150 bps = 1.5%). Per-market value lives in MarketConfig. */
+export declare const MAINTENANCE_MARGIN_RATE = 0.015;
+export declare const PERM_OPEN_POSITION = 1;
+export declare const PERM_CLOSE_POSITION = 2;
+export declare const PERM_INCREASE_POSITION = 4;
+export declare const PERM_DECREASE_POSITION = 8;
+export declare const PERM_PLACE_ORDER = 16;
+export declare const PERM_CANCEL_ORDER = 32;
+export declare const PERM_DEPOSIT_COLLATERAL = 64;
+export declare const PERM_WITHDRAW_COLLATERAL = 128;
+export declare const PERM_MINT_WLP = 256;
+export declare const PERM_REDEEM_WLP = 512;
+export declare const PERM_ALL_TRADING = 255;
+export declare const PERM_ALL = 65535;
+export declare const STAKING_PERM_DEPOSIT_STAKE: number;
+export declare const STAKING_PERM_REDEEM_STAKE: number;
+export declare const STAKING_PERM_CLAIM_REWARD: number;
+export declare const STAKING_PERM_ALL: number;
+export declare const ORDER_LIMIT_BUY = 0;
+export declare const ORDER_LIMIT_SELL = 1;
+export declare const ORDER_STOP_BUY = 2;
+export declare const ORDER_STOP_SELL = 3;
+/** Wildcard tag accepted by `cancel_order_request` — scans all 4 books. */
+export declare const ORDER_TAG_WILDCARD = 255;
+export declare const ACTION_OPEN_POSITION = 0;
+export declare const ACTION_CLOSE_POSITION = 1;
+export declare const ACTION_PLACE_ORDER = 2;
+export declare const ACTION_CANCEL_ORDER = 3;
+export declare const ACTION_DEPOSIT_COLLATERAL = 4;
+export declare const ACTION_WITHDRAW_COLLATERAL = 5;
+export declare const ACTION_LIQUIDATE = 6;
+export declare const ACTION_INCREASE_POSITION = 7;
+export declare const ACTION_DECREASE_POSITION = 8;
+export declare const ACTION_UPDATE_ORDER = 9;
+export declare const ACTION_CANCEL_PRE_ORDER = 10;
+export declare const ACTION_ADD_PRE_ORDER = 11;
+/**
+ * Well-known address of Sui's native funds-accumulator root shared object
+ * (`@0xacc` in the framework). Pass this to `request_deposit_from_funds<T>`
+ * to drain `Balance<T>` parked at an account's address. Defined in
+ * `account/constants.ts` (account-framework constant); re-exported here for
+ * back-compat.
+ */
+export { ACCUMULATOR_ROOT } from "../account/constants.ts";

package/dist/cjs/src/perp/constants.js

@@ -0,0 +1,79 @@
+"use strict";
+// Perp-line domain constants (trading permissions / order tags / action codes /
+// fee rates / well-known addresses). Re-exports the shared primitives from
+// `../constants.ts` so perp code and the `./perp` barrel get the full set from
+// a single import.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ACCUMULATOR_ROOT = exports.ACTION_ADD_PRE_ORDER = exports.ACTION_CANCEL_PRE_ORDER = exports.ACTION_UPDATE_ORDER = exports.ACTION_DECREASE_POSITION = exports.ACTION_INCREASE_POSITION = exports.ACTION_LIQUIDATE = exports.ACTION_WITHDRAW_COLLATERAL = exports.ACTION_DEPOSIT_COLLATERAL = exports.ACTION_CANCEL_ORDER = exports.ACTION_PLACE_ORDER = exports.ACTION_CLOSE_POSITION = exports.ACTION_OPEN_POSITION = exports.ORDER_TAG_WILDCARD = exports.ORDER_STOP_SELL = exports.ORDER_STOP_BUY = exports.ORDER_LIMIT_SELL = exports.ORDER_LIMIT_BUY = exports.STAKING_PERM_ALL = exports.STAKING_PERM_CLAIM_REWARD = exports.STAKING_PERM_REDEEM_STAKE = exports.STAKING_PERM_DEPOSIT_STAKE = exports.PERM_ALL = exports.PERM_ALL_TRADING = exports.PERM_REDEEM_WLP = exports.PERM_MINT_WLP = exports.PERM_WITHDRAW_COLLATERAL = exports.PERM_DEPOSIT_COLLATERAL = exports.PERM_CANCEL_ORDER = exports.PERM_PLACE_ORDER = exports.PERM_DECREASE_POSITION = exports.PERM_INCREASE_POSITION = exports.PERM_CLOSE_POSITION = exports.PERM_OPEN_POSITION = exports.MAINTENANCE_MARGIN_RATE = exports.STOCK_FEE_RATE = exports.CRYPTO_FEE_RATE = void 0;
+__exportStar(require("../constants.js"), exports);
+// ======== Fee rates & risk parameters ========
+/** Default crypto market trading fee rate (3 bps). Per-market value lives in MarketConfig. */
+exports.CRYPTO_FEE_RATE = 0.0003;
+/** Default stock / commodity market trading fee rate (5 bps). Per-market value lives in MarketConfig. */
+exports.STOCK_FEE_RATE = 0.0005;
+/** Default maintenance margin rate (150 bps = 1.5%). Per-market value lives in MarketConfig. */
+exports.MAINTENANCE_MARGIN_RATE = 0.015;
+// ======== Permission Bitmasks (matches account_data.move) ========
+exports.PERM_OPEN_POSITION = 1;
+exports.PERM_CLOSE_POSITION = 2;
+exports.PERM_INCREASE_POSITION = 4;
+exports.PERM_DECREASE_POSITION = 8;
+exports.PERM_PLACE_ORDER = 16;
+exports.PERM_CANCEL_ORDER = 32;
+exports.PERM_DEPOSIT_COLLATERAL = 64;
+exports.PERM_WITHDRAW_COLLATERAL = 128;
+exports.PERM_MINT_WLP = 256;
+exports.PERM_REDEEM_WLP = 512;
+exports.PERM_ALL_TRADING = 0xff;
+exports.PERM_ALL = 0xffff;
+// ======== Staking Permission Bitmasks (matches waterx_staking.move) ========
+exports.STAKING_PERM_DEPOSIT_STAKE = 1 << 0;
+exports.STAKING_PERM_REDEEM_STAKE = 1 << 1;
+exports.STAKING_PERM_CLAIM_REWARD = 1 << 2;
+exports.STAKING_PERM_ALL = exports.STAKING_PERM_DEPOSIT_STAKE | exports.STAKING_PERM_REDEEM_STAKE | exports.STAKING_PERM_CLAIM_REWARD;
+// ======== Order Type Tags ========
+exports.ORDER_LIMIT_BUY = 0;
+exports.ORDER_LIMIT_SELL = 1;
+exports.ORDER_STOP_BUY = 2;
+exports.ORDER_STOP_SELL = 3;
+/** Wildcard tag accepted by `cancel_order_request` — scans all 4 books. */
+exports.ORDER_TAG_WILDCARD = 255;
+// ======== Action Type Constants (request.move) ========
+exports.ACTION_OPEN_POSITION = 0;
+exports.ACTION_CLOSE_POSITION = 1;
+exports.ACTION_PLACE_ORDER = 2;
+exports.ACTION_CANCEL_ORDER = 3;
+exports.ACTION_DEPOSIT_COLLATERAL = 4;
+exports.ACTION_WITHDRAW_COLLATERAL = 5;
+exports.ACTION_LIQUIDATE = 6;
+exports.ACTION_INCREASE_POSITION = 7;
+exports.ACTION_DECREASE_POSITION = 8;
+exports.ACTION_UPDATE_ORDER = 9;
+exports.ACTION_CANCEL_PRE_ORDER = 10;
+exports.ACTION_ADD_PRE_ORDER = 11;
+// ======== Misc ========
+// `DRY_RUN_SENDER` (zero-address simulate sender) is a shared primitive defined
+// in `../constants.ts` and re-exported via the `export *` above.
+/**
+ * Well-known address of Sui's native funds-accumulator root shared object
+ * (`@0xacc` in the framework). Pass this to `request_deposit_from_funds<T>`
+ * to drain `Balance<T>` parked at an account's address. Defined in
+ * `account/constants.ts` (account-framework constant); re-exported here for
+ * back-compat.
+ */
+var constants_ts_1 = require("../account/constants.js");
+Object.defineProperty(exports, "ACCUMULATOR_ROOT", { enumerable: true, get: function () { return constants_ts_1.ACCUMULATOR_ROOT; } });