@waterx/sdk 2.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bucket Protocol
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,204 @@
+# @waterx/sdk
+
+TypeScript SDK for the WaterX perpetual protocol on Sui: build PTBs with **gRPC** (`@mysten/sui`), run read-only **simulateTransaction** queries, and optional **Pyth** helpers.
+
+> **ABI note:** PTB entry points follow `contracts/waterx_perp` in this repo. **Read-only `view::*` helpers** resolve the module package from each **shared object’s on-chain type** (so `Market` / `WlpPool` can sit on a newer publish than `GlobalConfig` / `AccountRegistry`). BCS layouts for `MarketSummary`, `PositionInfo`, and `TokenPoolSummary` match the **deployed** `view` structs (see `contracts/waterx_perp/package_summaries/waterx_perp/view.json`). Pin `WaterXConfig` to your environment’s package and object IDs.
+
+## Install & build
+
+```bash
+pnpm install
+pnpm build
+```
+
+Consumers:
+
+```bash
+pnpm add @waterx/sdk @mysten/sui
+```
+
+### Breaking changes (WLP high-level builders)
+
+`buildMintWlpTx` and `buildSettleRedeemWlpTx` are **`async`** and return `Promise<Transaction>` (they resolve deposit / redeem coin oracle wiring). Callers must **`await`**:
+
+```ts
+const tx = await buildMintWlpTx(client, params);
+const tx2 = await buildSettleRedeemWlpTx(client, { requestId: 1n });
+```
+
+### Size calculation requires explicit price
+
+`buildOpenPositionTx` and `buildPlaceOrderTx` no longer fall back to hardcoded prices when computing position size from leverage. You must provide either **`size`** (exact) or **`approxPrice`** (USD price for leverage math). Omitting both throws.
+
+### Naming: collateral on an open position
+
+Move entry points are `deposit_collateral_request` / `withdraw_collateral_request`. The SDK exposes **`depositCollateral`** / **`withdrawCollateral`** as the preferred names; **`increaseCollateral`** / **`releaseCollateral`** remain as deprecated aliases (same parameters). High-level helpers: **`buildDepositCollateralTx`** / **`buildWithdrawCollateralTx`** (deprecated: `buildIncreaseCollateralTx` / `buildReleaseCollateralTx`).
+
+Withdraw paths take **`collateralAmount`** for the size to pull from margin; **`amount`** is a deprecated alias (if both are passed, `collateralAmount` wins).
+
+### UserAccount address in PTB params
+
+Trading (`openPosition`, `closePosition`, …), account helpers (`depositToAccount`, delegates, …), high-level `build*Tx`, and orders (`placeOrder`, `cancelOrder`) all use **`accountObjectAddress`**: the **UserAccount object id** (hex). Trading paths pass it as `tx.pure.address`; registry calls use `tx.pure.id`. It is **not** a numeric registry index.
+
+`getAccountsByOwner` returns a `string[]` of `accountObjectAddress`es (the on-chain `account::account_ids` view returns `vector<ID>`).
+
+High-level `build*Tx` helpers also accept optional **`collateralTokenType`** (defaults to `WaterXConfig.usdcType`). Only token types wired in `resolveTokenPriceFeed` (`src/tx-builders.ts`) get automatic Pyth updates; extend there when the protocol adds collaterals.
+
+---
+
+## Initialize the client
+
+All network I/O uses **gRPC** (`SuiGrpcClient`). Trading helpers require `bucketFrameworkPackageId` (Bucket `bucket_v2_framework` package) so the PTB can call `account::request`.
+
+**Testnet (built-in constants):**
+
+```ts
+import { WaterXClient } from "@waterx/sdk";
+
+const client = WaterXClient.testnet();
+// optional: custom fullnode gRPC URL
+// const client = WaterXClient.testnet({ grpcUrl: "https://fullnode.testnet.sui.io:443" });
+```
+
+**Custom config (any network):**
+
+```ts
+import { createTestnetConfig, WaterXClient, type WaterXConfig } from "@waterx/sdk";
+
+const config: WaterXConfig = {
+  ...createTestnetConfig(),
+  packageId: "0x...", // your deployed waterx_perp package
+  globalConfig: "0x...",
+  // ...all other object IDs and token type strings
+};
+const client = new WaterXClient(config);
+```
+
+---
+
+## Examples
+
+### Read-only: pool summary & WLP metrics
+
+Uses gRPC `simulateTransaction` + BCS (no signer).
+
+```ts
+import { getPoolSummary, getWlpTotalSupply, getWlpTvlUsd, WaterXClient } from "@waterx/sdk";
+
+const client = WaterXClient.testnet();
+
+const pool = await getPoolSummary(client);
+console.log("LP supply (raw):", pool.totalLpSupply.toString());
+console.log("TVL (u128):", pool.tvlUsd.toString());
+
+const supply = await getWlpTotalSupply(client);
+const tvl = await getWlpTvlUsd(client);
+```
+
+### Read-only: accounts & position
+
+```ts
+import { getAccountsByOwner, getPosition, positionExists, WaterXClient } from "@waterx/sdk";
+
+const client = WaterXClient.testnet();
+const owner = "0x..."; // Sui address
+
+const accounts = await getAccountsByOwner(client, owner);
+const accountObjectAddress = accounts[0]!;
+
+const market = client.config.btcMarket;
+const has = await positionExists(client, market, 0n);
+if (has) {
+  const pos = await getPosition(client, market, 0n);
+  // `accountObjectAddress` = on-chain `user_address`; `marketIndex` = pool row index (not Market object id).
+  console.log(pos.accountObjectAddress, pos.marketIndex, pos.sizeAmount);
+}
+```
+
+### High-level PTB: open position (Pyth + testnet IDs wired in)
+
+Returns a `Transaction` you sign and execute with the same client.
+
+```ts
+import { Ed25519Keypair } from "@mysten/sui/keypairs/ed25519";
+import { buildOpenPositionTx, WaterXClient } from "@waterx/sdk";
+
+const client = WaterXClient.testnet();
+// Use your own keypair or any @mysten/sui Signer (e.g. wallet adapter).
+const keypair = Ed25519Keypair.generate();
+
+const tx = await buildOpenPositionTx(client, {
+  accountObjectAddress: "0x...", // UserAccount object id (hex), not a numeric id
+  base: "BTC",
+  isLong: true,
+  leverage: 10,
+  collateralAmount: 1_000_000_000n, // 1000 USDC if 6 decimals
+  approxPrice: 95_000, // required when `size` is not provided
+});
+
+const result = await client.signAndExecuteTransaction({
+  transaction: tx,
+  signer: keypair,
+});
+console.log(result.digest);
+```
+
+### Low-level PTB: same flow, your oracle wiring
+
+Create a `Transaction`, append Pyth / aggregator calls (`updatePythPrices`, `buildPythRuleFeedCalls` from this package — mirror `src/tx-builders.ts`), then call `openPosition(client, tx, openPositionParams)` (or any other builder in `src/user/`). Params are typed as `OpenPositionParams`, `ClosePositionParams`, etc.
+
+---
+
+## API overview
+
+### Core
+
+| Export                  | Purpose                                                               |
+| ----------------------- | --------------------------------------------------------------------- |
+| `WaterXClient`          | gRPC client, `simulate()`, `signAndExecuteTransaction()`              |
+| `createTestnetConfig()` | Default testnet package/object/token IDs + Pyth config                |
+| `WaterXConfig`          | Full config; must include `bucketFrameworkPackageId` for trading PTBs |
+
+### Transaction builders (append to `Transaction`)
+
+| Group    | Functions                                                                                                                                                                                                                   |
+| -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Shared   | `accountSenderRequest(tx, client)`                                                                                                                                                                                          |
+| Trading  | `openPosition`, `closePosition`, `increasePosition`, `decreasePosition`, `depositCollateral`, `withdrawCollateral` (`increaseCollateral` / `releaseCollateral` deprecated), `liquidate`, `matchOrders`, `updateFundingRate` |
+| Orders   | `placeOrder`, `cancelOrder`                                                                                                                                                                                                 |
+| WLP      | `mintWlp`, `requestRedeemWlp`, `cancelRedeemWlp`, `settleRedeemWlp`                                                                                                                                                         |
+| Account  | `createAccount`, `depositToAccount`, `receiveCoin`, `transferAccount`, `addDelegate`, `removeDelegate`, `updateDelegatePermissions`                                                                                         |
+| Referral | `setReferralCode`, `useReferralCode`, `registerReferralCode`, `bindReferral`                                                                                                                                                |
+
+Param types: `OpenPositionParams`, `IncreasePositionParams`, `DecreasePositionParams`, etc. (see `src/index.ts`).
+
+### Read-only queries (simulate + BCS)
+
+| Area          | Functions                                                                                                                                                                                      |
+| ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Account       | `getAccountsByOwner`, `getAccountDelegates`, `getAccountObjectId` (deprecated — use `accountObjectAddress` directly), `getAccountCoins`, `getAccountBalance`, `selectCoinsForAmount`           |
+| Market / pool | `getMarketSummary` (`view::market_summary<LP>` — optional `typeArgs`: LP type string or `{ lpTokenType? }` only), `getPoolSummary`, `getWlpTotalSupply`, `getWlpTvlUsd`, `getTokenPoolSummary` |
+| Position      | `getPosition`, `positionExists` (same LP type-arg rules as `getMarketSummary`)                                                                                                                 |
+
+**View return shapes:** `MarketSummary` includes `marketIndex` (on-chain index). `PositionInfoView` exposes `marketIndex` (bigint) and `accountObjectAddress` (from `user_address`). `getTokenPoolSummary` maps `TokenPoolSummary.lastPriceRefreshTimestamp` when the return payload includes it; older 72-byte deployments surface `0n` (see `parseTokenPoolSummaryReturn` in `fetch.ts`).
+
+### High-level PTB helpers
+
+`buildOpenPositionTx`, `buildClosePositionTx`, `buildIncreasePositionTx`, `buildDecreasePositionTx`, `buildDepositCollateralTx`, `buildWithdrawCollateralTx` (`buildIncreaseCollateralTx` / `buildReleaseCollateralTx` deprecated), `buildPlaceOrderTx`, `buildCancelOrderTx` (all `async`, Pyth-backed). All WLP builders are `async` and refresh every pool token's Pyth feed before the call (required by `assert_prices_fresh`): `buildMintWlpTx`, `buildMintAndStakeWlpTx`, `buildRequestRedeemWlpTx` (requires `recipient`), `buildSettleRedeemWlpTx`, `buildCancelRedeemWlpTx`, `buildUnstakeAndRequestRedeemWlpTx`.
+
+### Constants & Pyth
+
+Permission bits, order tags, testnet IDs, Pyth feeds: `src/constants.ts`.  
+On testnet, `TESTNET_TYPES.WLP` is the LP type wired to the live **`WlpPool` / `Market`** (`wlp_token::WLP_TOKEN`); `TESTNET_PACKAGE_IDS.WLP_STANDALONE` points at the standalone `contracts/wlp` publish for reference.  
+Oracle wiring: `fetchPriceFeedsUpdateData`, `updatePythPrices`, `buildPythRuleFeedCalls`, `PythCache`, etc. in `src/utils/pyth.ts`.
+
+---
+
+## Development
+
+| Command                     | Use                                  |
+| --------------------------- | ------------------------------------ |
+| `pnpm typecheck`            | Typecheck                            |
+| `pnpm test`                 | Tests                                |
+| `pnpm lint` / `pnpm format` | Prettier                             |
+| `pnpm codegen`              | Regenerate `src/generated` from Move |

package/dist/src/client.d.ts

@@ -0,0 +1,109 @@
+/**
+ * WaterX Protocol client.
+ *
+ * Initialization is async — config is fetched from the canonical
+ * `waterx-config` JSON (default: GitHub raw). See `WaterXClient.create()`.
+ */
+import { SuiGrpcClient } from "@mysten/sui/grpc";
+import { Transaction } from "@mysten/sui/transactions";
+import { type LoadConfigOptions, type NativeCustodyAsset, type PythInfraConfig, type WaterXConfig, type WormholeInfraConfig } from "./config.ts";
+import type { Network } from "./constants.ts";
+export interface CreateClientOptions extends LoadConfigOptions {
+    grpcUrl?: string;
+}
+export declare class WaterXClient {
+    /** gRPC client — all RPC including `simulateTransaction`. */
+    grpcClient: SuiGrpcClient;
+    /** Network identifier in upper case (`MAINNET` / `TESTNET`). */
+    network: Network;
+    /** Parsed canonical `waterx-config` JSON. */
+    config: WaterXConfig;
+    /** Pyth infra (network defaults unless overridden in JSON). */
+    pyth: PythInfraConfig;
+    /** Wormhole infra for the credit bridge (network defaults unless overridden). */
+    wormhole: WormholeInfraConfig;
+    constructor(network: Network, config: WaterXConfig, opts?: {
+        grpcUrl?: string;
+    });
+    /**
+     * Async factory: fetches the deployment config for `network` and returns
+     * a ready-to-use client. Pass `opts.cache=true` to memoize the JSON.
+     */
+    static create(network: Network, opts?: CreateClientOptions): Promise<WaterXClient>;
+    static mainnet(opts?: CreateClientOptions): Promise<WaterXClient>;
+    static testnet(opts?: CreateClientOptions): Promise<WaterXClient>;
+    getObject(objectId: string): Promise<import("@mysten/sui/client").SuiClientTypes.GetObjectResponse<{}>>;
+    getObjects(objectIds: string[]): Promise<import("@mysten/sui/client").SuiClientTypes.GetObjectsResponse<{}>>;
+    listOwnedObjects(owner: string): Promise<import("@mysten/sui/client").SuiClientTypes.ListOwnedObjectsResponse<{}>>;
+    listCoins(params: {
+        owner: string;
+        coinType?: string;
+    }): Promise<import("@mysten/sui/client").SuiClientTypes.ListCoinsResponse>;
+    getBalance(params: {
+        owner: string;
+        coinType?: string;
+    }): Promise<import("@mysten/sui/client").SuiClientTypes.GetBalanceResponse>;
+    listDynamicFields(parentId: string): ReturnType<SuiGrpcClient["listDynamicFields"]>;
+    getDynamicField(parentId: string, name: {
+        type: string;
+        bcs: Uint8Array;
+    }): Promise<import("@mysten/sui/client").SuiClientTypes.GetDynamicFieldResponse>;
+    waitForTransaction(digest: string): Promise<import("@mysten/sui/client").SuiClientTypes.TransactionResult<{}>>;
+    simulate(tx: Transaction): Promise<import("@mysten/sui/client").SuiClientTypes.SimulateTransactionResult<{
+        commandResults: true;
+    }>>;
+    signAndExecuteTransaction(params: {
+        signer: {
+            toSuiAddress: () => string;
+        } & import("@mysten/sui/cryptography").Signer;
+        transaction: Transaction;
+    }): Promise<import("@mysten/sui/client").SuiClientTypes.TransactionResult<{}>>;
+    /** All package IDs (`published_at`) keyed by package name. */
+    packageIds(): Record<string, string>;
+    /** `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;
+    };
+    /** `wlp.pool_tokens[ticker]` (fully-qualified Move type), throws if unknown. */
+    getPoolTokenType(ticker: 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 `client.wormhole`.
+     */
+    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/src/client.js

@@ -0,0 +1,197 @@
+/**
+ * WaterX Protocol client.
+ *
+ * Initialization is async — config is fetched from the canonical
+ * `waterx-config` JSON (default: GitHub raw). See `WaterXClient.create()`.
+ */
+import { SuiGrpcClient } from "@mysten/sui/grpc";
+import { loadConfig, PYTH_DEFAULTS, WORMHOLE_DEFAULTS, } from "./config.js";
+// ======== gRPC base URLs by network ========
+const DEFAULT_GRPC_URLS = {
+    MAINNET: "https://fullnode.mainnet.sui.io:443",
+    TESTNET: "https://fullnode.testnet.sui.io:443",
+};
+export class WaterXClient {
+    /** gRPC client — all RPC including `simulateTransaction`. */
+    grpcClient;
+    /** Network identifier in upper case (`MAINNET` / `TESTNET`). */
+    network;
+    /** Parsed canonical `waterx-config` JSON. */
+    config;
+    /** Pyth infra (network defaults unless overridden in JSON). */
+    pyth;
+    /** Wormhole infra for the credit bridge (network defaults unless overridden). */
+    wormhole;
+    constructor(network, config, opts = {}) {
+        this.network = network;
+        this.config = config;
+        this.pyth = config.pyth ?? PYTH_DEFAULTS[network];
+        this.wormhole = config.wormhole ?? WORMHOLE_DEFAULTS[network];
+        const grpcUrl = opts.grpcUrl ?? config.grpcUrl ?? DEFAULT_GRPC_URLS[network];
+        this.grpcClient = new SuiGrpcClient({
+            baseUrl: grpcUrl,
+            network: network.toLowerCase(),
+        });
+    }
+    /**
+     * Async factory: fetches the deployment config for `network` and returns
+     * a ready-to-use client. Pass `opts.cache=true` to memoize the JSON.
+     */
+    static async create(network, opts = {}) {
+        const config = await loadConfig(network, opts);
+        return new WaterXClient(network, config, { grpcUrl: opts.grpcUrl });
+    }
+    static mainnet(opts = {}) {
+        return WaterXClient.create("MAINNET", opts);
+    }
+    static testnet(opts = {}) {
+        return WaterXClient.create("TESTNET", opts);
+    }
+    // ========================================================
+    // gRPC convenience wrappers
+    // ========================================================
+    getObject(objectId) {
+        return this.grpcClient.getObject({ objectId });
+    }
+    getObjects(objectIds) {
+        return this.grpcClient.getObjects({ objectIds });
+    }
+    listOwnedObjects(owner) {
+        return this.grpcClient.listOwnedObjects({ owner });
+    }
+    listCoins(params) {
+        return this.grpcClient.listCoins(params);
+    }
+    getBalance(params) {
+        return this.grpcClient.getBalance(params);
+    }
+    listDynamicFields(parentId) {
+        return this.grpcClient.listDynamicFields({ parentId });
+    }
+    getDynamicField(parentId, name) {
+        return this.grpcClient.getDynamicField({ parentId, name });
+    }
+    waitForTransaction(digest) {
+        return this.grpcClient.waitForTransaction({ digest });
+    }
+    async simulate(tx) {
+        return this.grpcClient.simulateTransaction({
+            transaction: tx,
+            include: { commandResults: true },
+        });
+    }
+    async signAndExecuteTransaction(params) {
+        return this.grpcClient.signAndExecuteTransaction(params);
+    }
+    // ========================================================
+    // Shorthand accessors (canonical-schema lookups)
+    // ========================================================
+    /** All package IDs (`published_at`) keyed by package name. */
+    packageIds() {
+        const out = {};
+        for (const [name, pkg] of Object.entries(this.config.packages)) {
+            if (pkg && typeof pkg === "object" && "published_at" in pkg && pkg.published_at) {
+                out[name] = pkg.published_at;
+            }
+        }
+        return out;
+    }
+    /** `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;
+    }
+    /** `wlp.pool_tokens[ticker]` (fully-qualified Move type), throws if unknown. */
+    getPoolTokenType(ticker) {
+        const t = this.config.packages.wlp?.pool_tokens?.[ticker];
+        if (!t)
+            throw new Error(`No pool token registered for ticker: ${ticker}`);
+        return t;
+    }
+    /** 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 `client.wormhole`.
+     */
+    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;
+    }
+}