@waterx/sdk 3.0.3 → 3.1.1

package/README.md

@@ -11,13 +11,18 @@ The perp and prediction lines expose builder functions with **colliding names**
 ```ts
 import { WaterXClient } from "@waterx/sdk";
 
-const client = await WaterXClient.create({ network: "TESTNET" });
+// waterxConfigUrl is REQUIRED — the SDK has no built-in default and never reads env.
+const client = await WaterXClient.create({
+  network: "TESTNET",
+  waterxConfigUrl: "https://raw.githubusercontent.com/WaterXProtocol/waterx-config/main/testnet.json",
+});
 client.account.createAccount(tx, { alias });  // shared waterx_account + funding (credit/custody)
 client.perp.buildPlaceOrderTx(params);        // perpetuals
 client.predict.placeOrder(tx, params);        // prediction markets
 // client.perp / client.predict ARE the line clients — sign/execute on them directly:
 //   await client.perp.signAndExecuteTransaction({ transaction: tx, signer })
-// each line can target a different network: WaterXClient.create({ perp: { network: "MAINNET" }, predict: { network: "TESTNET" } })
+// each line can target a different network + URL:
+//   WaterXClient.create({ perp: { network: "MAINNET", waterxConfigUrl: mainnetUrl }, predict: { network: "TESTNET", waterxConfigUrl: testnetUrl } })
 ```
 
 > `WaterXClient` is the umbrella entry point. `Client` is kept as a **deprecated alias** for one major cycle.
@@ -41,13 +46,16 @@ Consumers: `pnpm add @waterx/sdk @mysten/sui`
 
 ## Quickstart (unified client)
 
-`WaterXClient.create()` loads each line's deployment config from the canonical `waterx-config` JSON and returns a ready client. Builders are **build-only** — they return / mutate a `Transaction`; signing & execution stay with the caller (`client.perp` / `client.predict` are the line clients, or a frontend wallet), so multi-step Pyth injection and wallet flows keep working.
+`WaterXClient.create()` loads each line's deployment config from the canonical `waterx-config` JSON (its URL passed via the **required** `waterxConfigUrl` option — the SDK has no default and never reads env) and returns a ready client. Builders are **build-only** — they return / mutate a `Transaction`; signing & execution stay with the caller (`client.perp` / `client.predict` are the line clients, or a frontend wallet), so multi-step Pyth injection and wallet flows keep working.
 
 ```ts
 import { WaterXClient, rawPrice } from "@waterx/sdk";
 import { Transaction } from "@mysten/sui/transactions";
 
-const client = await WaterXClient.create({ network: "TESTNET" });
+const client = await WaterXClient.create({
+  network: "TESTNET",
+  waterxConfigUrl: "https://raw.githubusercontent.com/WaterXProtocol/waterx-config/main/testnet.json",
+});
 const signer = /* your Ed25519Keypair or wallet Signer */;
 
 // --- Perp: place a market order ---
@@ -77,14 +85,16 @@ await client.predict.signAndExecuteTransaction({ transaction: ptx, signer });
 
 ## Per-line clients
 
-If you only need one line, construct it directly (both factories are **async** — they fetch deployment config):
+If you only need one line, construct it directly (both factories are **async** — they fetch deployment config; `waterxConfigUrl` is **required**):
 
 ```ts
 import { PerpClient } from "@waterx/sdk/perp";
 import { PredictClient } from "@waterx/sdk/prediction";
 
-const perp = await PerpClient.create("TESTNET"); // or PerpClient.testnet()
-const predict = await PredictClient.create("TESTNET"); // or PredictClient.testnet()
+const waterxConfigUrl =
+  "https://raw.githubusercontent.com/WaterXProtocol/waterx-config/main/testnet.json";
+const perp = await PerpClient.create("TESTNET", { waterxConfigUrl }); // or PerpClient.testnet({ waterxConfigUrl })
+const predict = await PredictClient.create("TESTNET", { waterxConfigUrl }); // or PredictClient.testnet({ waterxConfigUrl })
 ```
 
 Read-only queries use gRPC `simulateTransaction` (no signer) — the `getX` view helpers, e.g. `await perp.simulate(tx)` or `getMarketData(perp, …)`.

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

@@ -95,18 +95,13 @@ export interface WaterXConfig {
 }
 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}.
+     * Canonical `waterx-config` JSON URL to fetch, **as-is** (no `<network>.json`
+     * / git ref appended). Required — {@link loadConfig} reads the URL only from
+     * this option (there is no env-var fallback and no built-in default) and
+     * throws when it is unset. Point it at a staging deployment or local mirror
+     * as needed.
      */
-    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;
+    waterxConfigUrl?: string;
     /**
      * Reuse a previously-fetched config from the in-memory cache (keyed by
      * the effective URL). Default: false (always fetch fresh).
@@ -117,10 +112,5 @@ export interface LoadConfigOptions {
     /** 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

@@ -11,7 +11,6 @@
  */
 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");
@@ -40,22 +39,15 @@ exports.WORMHOLE_DEFAULTS = {
         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);
+    const url = opts.waterxConfigUrl;
+    if (!url) {
+        throw new Error("loadConfig: no config URL — pass opts.waterxConfigUrl");
+    }
     if (opts.cache && cache.has(url)) {
         return cache.get(url);
     }

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

@@ -1,6 +1,6 @@
 export { PerpClient } from "./client.ts";
 export type { CreateClientOptions } from "./client.ts";
-export { PYTH_DEFAULTS, WORMHOLE_DEFAULTS, clearConfigCache, defaultConfigUrl, loadConfig, } from "./config.ts";
+export { PYTH_DEFAULTS, WORMHOLE_DEFAULTS, clearConfigCache, loadConfig } from "./config.ts";
 export type { BasePackageEntry, ConstantFeedEntry, WaterxReferralPackage, LoadConfigOptions, NativeCustodyAsset, NativeCustodyPackage, PythInfraConfig, PythRulePackage, PythSponsorRulePackage, SupraFeedEntry, SupraRulePackage, TestnetFaucetPackage, TrustedEmitterRow, WaterXConfig, WaterXPackages, WaterxCreditPackage, WaterxOraclePackage, WaterxPerpMarketEntry, WaterxPerpPackage, WaterxStakingPackage, WithdrawalQueuePackage, WlpPackage, WormholeBridgePackage, WormholeInfraConfig, WxaAccountPackage, } from "./config.ts";
 export { ACTION_ADD_PRE_ORDER, ACTION_CANCEL_ORDER, ACTION_CANCEL_PRE_ORDER, ACTION_CLOSE_POSITION, ACTION_DECREASE_POSITION, ACTION_DEPOSIT_COLLATERAL, ACTION_INCREASE_POSITION, ACTION_LIQUIDATE, ACTION_OPEN_POSITION, ACTION_PLACE_ORDER, ACTION_UPDATE_ORDER, ACTION_WITHDRAW_COLLATERAL, BPS_SCALE, CRYPTO_FEE_RATE, DOUBLE_SCALE, DRY_RUN_SENDER, FLOAT_SCALE, MAINTENANCE_MARGIN_RATE, ORDER_LIMIT_BUY, ORDER_LIMIT_SELL, ORDER_STOP_BUY, ORDER_STOP_SELL, ORDER_TAG_WILDCARD, PERM_ALL, PERM_ALL_TRADING, PERM_CANCEL_ORDER, PERM_CLOSE_POSITION, PERM_DECREASE_POSITION, PERM_DEPOSIT_COLLATERAL, PERM_INCREASE_POSITION, PERM_MINT_WLP, PERM_OPEN_POSITION, PERM_PLACE_ORDER, PERM_REDEEM_WLP, PERM_WITHDRAW_COLLATERAL, STAKING_PERM_DEPOSIT_STAKE, STAKING_PERM_REDEEM_STAKE, STAKING_PERM_CLAIM_REWARD, STAKING_PERM_ALL, STOCK_FEE_RATE, MS_PER_YEAR, SUI_DECIMALS, WLP_DECIMALS, COLLATERAL_DECIMALS, TOKEN_DECIMALS, } from "./constants.ts";
 export type { Network } from "./constants.ts";

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

@@ -36,9 +36,9 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.COLLATERAL_DECIMALS = exports.WLP_DECIMALS = exports.SUI_DECIMALS = exports.MS_PER_YEAR = exports.STOCK_FEE_RATE = exports.STAKING_PERM_ALL = exports.STAKING_PERM_CLAIM_REWARD = exports.STAKING_PERM_REDEEM_STAKE = exports.STAKING_PERM_DEPOSIT_STAKE = exports.PERM_WITHDRAW_COLLATERAL = exports.PERM_REDEEM_WLP = exports.PERM_PLACE_ORDER = exports.PERM_OPEN_POSITION = exports.PERM_MINT_WLP = exports.PERM_INCREASE_POSITION = exports.PERM_DEPOSIT_COLLATERAL = exports.PERM_DECREASE_POSITION = exports.PERM_CLOSE_POSITION = exports.PERM_CANCEL_ORDER = exports.PERM_ALL_TRADING = exports.PERM_ALL = exports.ORDER_TAG_WILDCARD = exports.ORDER_STOP_SELL = exports.ORDER_STOP_BUY = exports.ORDER_LIMIT_SELL = exports.ORDER_LIMIT_BUY = exports.MAINTENANCE_MARGIN_RATE = exports.FLOAT_SCALE = exports.DRY_RUN_SENDER = exports.DOUBLE_SCALE = exports.CRYPTO_FEE_RATE = exports.BPS_SCALE = exports.ACTION_WITHDRAW_COLLATERAL = exports.ACTION_UPDATE_ORDER = exports.ACTION_PLACE_ORDER = exports.ACTION_OPEN_POSITION = exports.ACTION_LIQUIDATE = exports.ACTION_INCREASE_POSITION = exports.ACTION_DEPOSIT_COLLATERAL = exports.ACTION_DECREASE_POSITION = exports.ACTION_CLOSE_POSITION = exports.ACTION_CANCEL_PRE_ORDER = exports.ACTION_CANCEL_ORDER = exports.ACTION_ADD_PRE_ORDER = exports.loadConfig = exports.defaultConfigUrl = exports.clearConfigCache = exports.WORMHOLE_DEFAULTS = exports.PYTH_DEFAULTS = exports.PerpClient = void 0;
-exports.PoolDataBcs = exports.OrderDataBcs = exports.MarketDataBcs = exports.GlobalConfigDataBcs = exports.AccountDataBcs = exports.waitForVaa = exports.vaaBytesToBase64 = exports.vaaBase64ToHex = exports.vaaBase64ToBytes = exports.toWormholescanEmitter = exports.padEvmEmitter = exports.listVaasByEmitter = exports.listBridgeWithdrawalVaas = exports.fetchVaa = exports.fetchDepositVaa = exports.updatePythPrices = exports.refreshOraclePrices = exports.fetchPriceFeedsUpdateData = exports.buildPythPriceUpdateCalls = exports.aggregateTickerWithPyth = exports.aggregateTickerWithConstant = exports.aggregateTicker = exports.PythCache = exports.rawPrice = exports.decodeFundingIndexDelta = exports.calcWlpRedeemOut = exports.calcWlpPrice = exports.calcWlpMintOut = exports.calcWlpIncentiveApy = exports.calcUnrealizedPnl = exports.calcTotalTradingFeeRate = exports.calcTokenUtilizationBps = exports.calcPositionBorrowFee = exports.calcNotional = exports.calcMaxReducibleCollateralUsd = exports.calcLeverage = exports.calcImpactFeeRate = exports.calcFundingRate = exports.calcFundingFeeUsd = exports.calcFee = exports.calcEstLiqPrice = exports.calcEffectiveCollateralUsd = exports.calcDynamicFeeBps = exports.calcBorrowRateAccrual = exports.calcBorrowRate = exports.annualizeFundingRate = exports.annualizedApyFromRatio = exports.getCollateralAssets = exports.getMarketTickers = exports.TOKEN_DECIMALS = void 0;
-exports.withdrawalQueueCalls = exports.nativeCustodyCalls = exports.referralCalls = exports.pythSponsorRuleCalls = exports.pythRuleCalls = exports.oracleCalls = exports.stakingCalls = exports.wxaAccountCalls = exports.viewCalls = exports.lpPoolCalls = exports.tradingCalls = exports.MarketConfigBcs = exports.MarketBcs = exports.OrderBcs = exports.PositionBcs = exports.TokenPoolDataBcs = exports.RedeemRequestDataBcs = exports.PositionDataBcs = void 0;
+exports.TOKEN_DECIMALS = exports.COLLATERAL_DECIMALS = exports.WLP_DECIMALS = exports.SUI_DECIMALS = exports.MS_PER_YEAR = exports.STOCK_FEE_RATE = exports.STAKING_PERM_ALL = exports.STAKING_PERM_CLAIM_REWARD = exports.STAKING_PERM_REDEEM_STAKE = exports.STAKING_PERM_DEPOSIT_STAKE = exports.PERM_WITHDRAW_COLLATERAL = exports.PERM_REDEEM_WLP = exports.PERM_PLACE_ORDER = exports.PERM_OPEN_POSITION = exports.PERM_MINT_WLP = exports.PERM_INCREASE_POSITION = exports.PERM_DEPOSIT_COLLATERAL = exports.PERM_DECREASE_POSITION = exports.PERM_CLOSE_POSITION = exports.PERM_CANCEL_ORDER = exports.PERM_ALL_TRADING = exports.PERM_ALL = exports.ORDER_TAG_WILDCARD = exports.ORDER_STOP_SELL = exports.ORDER_STOP_BUY = exports.ORDER_LIMIT_SELL = exports.ORDER_LIMIT_BUY = exports.MAINTENANCE_MARGIN_RATE = exports.FLOAT_SCALE = exports.DRY_RUN_SENDER = exports.DOUBLE_SCALE = exports.CRYPTO_FEE_RATE = exports.BPS_SCALE = exports.ACTION_WITHDRAW_COLLATERAL = exports.ACTION_UPDATE_ORDER = exports.ACTION_PLACE_ORDER = exports.ACTION_OPEN_POSITION = exports.ACTION_LIQUIDATE = exports.ACTION_INCREASE_POSITION = exports.ACTION_DEPOSIT_COLLATERAL = exports.ACTION_DECREASE_POSITION = exports.ACTION_CLOSE_POSITION = exports.ACTION_CANCEL_PRE_ORDER = exports.ACTION_CANCEL_ORDER = exports.ACTION_ADD_PRE_ORDER = exports.loadConfig = exports.clearConfigCache = exports.WORMHOLE_DEFAULTS = exports.PYTH_DEFAULTS = exports.PerpClient = void 0;
+exports.PositionDataBcs = exports.PoolDataBcs = exports.OrderDataBcs = exports.MarketDataBcs = exports.GlobalConfigDataBcs = exports.AccountDataBcs = exports.waitForVaa = exports.vaaBytesToBase64 = exports.vaaBase64ToHex = exports.vaaBase64ToBytes = exports.toWormholescanEmitter = exports.padEvmEmitter = exports.listVaasByEmitter = exports.listBridgeWithdrawalVaas = exports.fetchVaa = exports.fetchDepositVaa = exports.updatePythPrices = exports.refreshOraclePrices = exports.fetchPriceFeedsUpdateData = exports.buildPythPriceUpdateCalls = exports.aggregateTickerWithPyth = exports.aggregateTickerWithConstant = exports.aggregateTicker = exports.PythCache = exports.rawPrice = exports.decodeFundingIndexDelta = exports.calcWlpRedeemOut = exports.calcWlpPrice = exports.calcWlpMintOut = exports.calcWlpIncentiveApy = exports.calcUnrealizedPnl = exports.calcTotalTradingFeeRate = exports.calcTokenUtilizationBps = exports.calcPositionBorrowFee = exports.calcNotional = exports.calcMaxReducibleCollateralUsd = exports.calcLeverage = exports.calcImpactFeeRate = exports.calcFundingRate = exports.calcFundingFeeUsd = exports.calcFee = exports.calcEstLiqPrice = exports.calcEffectiveCollateralUsd = exports.calcDynamicFeeBps = exports.calcBorrowRateAccrual = exports.calcBorrowRate = exports.annualizeFundingRate = exports.annualizedApyFromRatio = exports.getCollateralAssets = exports.getMarketTickers = void 0;
+exports.withdrawalQueueCalls = exports.nativeCustodyCalls = exports.referralCalls = exports.pythSponsorRuleCalls = exports.pythRuleCalls = exports.oracleCalls = exports.stakingCalls = exports.wxaAccountCalls = exports.viewCalls = exports.lpPoolCalls = exports.tradingCalls = exports.MarketConfigBcs = exports.MarketBcs = exports.OrderBcs = exports.PositionBcs = exports.TokenPoolDataBcs = exports.RedeemRequestDataBcs = void 0;
 // ======== Core ========
 var client_ts_1 = require("./client.js");
 Object.defineProperty(exports, "PerpClient", { enumerable: true, get: function () { return client_ts_1.PerpClient; } });
@@ -46,7 +46,6 @@ var config_ts_1 = require("./config.js");
 Object.defineProperty(exports, "PYTH_DEFAULTS", { enumerable: true, get: function () { return config_ts_1.PYTH_DEFAULTS; } });
 Object.defineProperty(exports, "WORMHOLE_DEFAULTS", { enumerable: true, get: function () { return config_ts_1.WORMHOLE_DEFAULTS; } });
 Object.defineProperty(exports, "clearConfigCache", { enumerable: true, get: function () { return config_ts_1.clearConfigCache; } });
-Object.defineProperty(exports, "defaultConfigUrl", { enumerable: true, get: function () { return config_ts_1.defaultConfigUrl; } });
 Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return config_ts_1.loadConfig; } });
 // ======== Constants & enums ========
 var constants_ts_1 = require("./constants.js");

package/dist/cjs/src/prediction/client.d.ts

@@ -40,6 +40,17 @@ export declare class PredictClient extends BaseLineClient<WaterxPredictionConfig
     waterxAccountAdminCap(): string;
     waterxPredictionGiftPackageId(): string;
     claimableLinkConfigId(): string;
+    /**
+     * Original (first-published) id of the gift package. Used ONLY for the
+     * `GiftKey` type tag in derived-object address computation
+     * (`deriveGiftAddress`). Sui pins a struct's type identity to its
+     * defining package's *original* id — it never advances across upgrades,
+     * unlike `published_at`. So the off-chain `gift_id` derivation must key
+     * on this, or it diverges from the on-chain `derive_gift_address` after
+     * the first upgrade. Falls back to `published_at` when `original_id` is
+     * absent (fresh deployments where the two are equal).
+     */
+    waterxPredictionGiftTypeOriginId(): string;
     waterxReferralPackageId(): string;
     referralTableId(): string;
 }

package/dist/cjs/src/prediction/client.js

@@ -71,6 +71,22 @@ class PredictClient extends base_client_ts_1.BaseLineClient {
     claimableLinkConfigId() {
         return requireConfigValue(this.config.packages.waterx_prediction_gift, "claimable_link_config", "packages.waterx_prediction_gift.claimable_link_config");
     }
+    /**
+     * Original (first-published) id of the gift package. Used ONLY for the
+     * `GiftKey` type tag in derived-object address computation
+     * (`deriveGiftAddress`). Sui pins a struct's type identity to its
+     * defining package's *original* id — it never advances across upgrades,
+     * unlike `published_at`. So the off-chain `gift_id` derivation must key
+     * on this, or it diverges from the on-chain `derive_gift_address` after
+     * the first upgrade. Falls back to `published_at` when `original_id` is
+     * absent (fresh deployments where the two are equal).
+     */
+    waterxPredictionGiftTypeOriginId() {
+        const origin = this.config.packages.waterx_prediction_gift?.original_id;
+        return typeof origin === "string" && origin.length > 0
+            ? origin
+            : this.waterxPredictionGiftPackageId();
+    }
     waterxReferralPackageId() {
         return requireConfigValue(this.config.packages.waterx_referral, "published_at", "packages.waterx_referral.published_at");
     }

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

@@ -47,17 +47,12 @@ export interface WaterxPredictionConfig {
 }
 export interface LoadConfigOptions {
     /**
-     * Override the default waterx-config raw JSON URL. Use this to point at a
-     * local mirror during development. Takes precedence over {@link configRef}.
+     * Canonical `waterx-config` JSON URL to fetch, **as-is** (no `<network>.json`
+     * / git ref appended). Required — {@link loadConfig} reads the URL only from
+     * this option (there is no env-var fallback and no built-in default) and
+     * throws when it is unset.
      */
-    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;
+    waterxConfigUrl?: string;
     /** Reuse a previously fetched config in memory. Default: false. */
     cache?: boolean;
     /** Optional fetch implementation for tests or runtimes without global fetch. */
@@ -65,10 +60,5 @@ export interface LoadConfigOptions {
     /** 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<WaterxPredictionConfig>;

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

@@ -6,25 +6,17 @@
  * and fetches it from GitHub raw by default.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultConfigUrl = defaultConfigUrl;
 exports.clearConfigCache = clearConfigCache;
 exports.loadConfig = loadConfig;
-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 configCache = new Map();
 function clearConfigCache() {
     configCache.clear();
 }
 async function loadConfig(network, opts = {}) {
-    const url = opts.configUrl ?? defaultConfigUrl(network, opts.configRef);
+    const url = opts.waterxConfigUrl;
+    if (!url) {
+        throw new Error("loadConfig: no config URL — pass opts.waterxConfigUrl");
+    }
     if (opts.cache && configCache.has(url)) {
         return configCache.get(url);
     }

package/dist/cjs/src/prediction/fetch.d.ts

@@ -1,5 +1,5 @@
 import type { PredictClient } from "./client.ts";
-import type { AccountDataView, CursorView, MarketExposure, MarketIdInput, MarketView, OrderView, PositionView, RegistryView } from "./types.ts";
+import type { AccountDataView, CursorView, MarketExposure, MarketIdInput, MarketPage, MarketView, OrderView, PageParams, PositionPage, PositionView, RegistryView } from "./types.ts";
 export declare function extractReturnBytes(result: any, commandIndex?: number, returnIndex?: number): Uint8Array;
 export interface ViewBaseParams {
     packageId?: string;
@@ -30,6 +30,11 @@ export declare function getOrderCursor(client: PredictClient, params?: ViewBaseP
 export declare function getPositionCursor(client: PredictClient, params?: ViewBaseParams): Promise<CursorView>;
 export declare function getUnresolvedMarketCursor(client: PredictClient, params?: ViewBaseParams): Promise<CursorView>;
 export declare function getResolvedMarketCursor(client: PredictClient, params?: ViewBaseParams): Promise<CursorView>;
+/** Every unresolved (active) market in one call. Prefer `getUnresolvedMarketsPage` when the table is large. */
+export declare function getUnresolvedMarkets(client: PredictClient, params?: ViewBaseParams): Promise<MarketView[]>;
+export declare function getUnresolvedMarketsPage(client: PredictClient, params?: PageParams): Promise<MarketPage>;
+export declare function getResolvedMarketsPage(client: PredictClient, params?: PageParams): Promise<MarketPage>;
+export declare function getPositionsPage(client: PredictClient, params?: PageParams): Promise<PositionPage>;
 export interface GetAccountIdsParams {
     /** Wallet address that owns sub-accounts in the registry. */
     owner: string;

package/dist/cjs/src/prediction/fetch.js

@@ -12,6 +12,10 @@ exports.getOrderCursor = getOrderCursor;
 exports.getPositionCursor = getPositionCursor;
 exports.getUnresolvedMarketCursor = getUnresolvedMarketCursor;
 exports.getResolvedMarketCursor = getResolvedMarketCursor;
+exports.getUnresolvedMarkets = getUnresolvedMarkets;
+exports.getUnresolvedMarketsPage = getUnresolvedMarketsPage;
+exports.getResolvedMarketsPage = getResolvedMarketsPage;
+exports.getPositionsPage = getPositionsPage;
 exports.getAccountIds = getAccountIds;
 exports.getAccountData = getAccountData;
 exports.getAccountOrderIds = getAccountOrderIds;
@@ -149,6 +153,66 @@ function getUnresolvedMarketCursor(client, params = {}) {
 function getResolvedMarketCursor(client, params = {}) {
     return readCursor(client, "resolved_market_cursor", params);
 }
+const DEFAULT_PAGE_LIMIT = 100n;
+/** Encode an optional cursor key as a Move `Option<u64>` pure arg (`undefined` → none / from front). */
+function startArg(tx, start) {
+    return tx.pure(bcs_1.bcs.option(bcs_1.bcs.u64()).serialize(start === undefined ? null : (0, utils_ts_1.toBigInt)(start)));
+}
+/** Every unresolved (active) market in one call. Prefer `getUnresolvedMarketsPage` when the table is large. */
+async function getUnresolvedMarkets(client, params = {}) {
+    const tx = new transactions_1.Transaction();
+    tx.moveCall({
+        target: `${(0, utils_ts_1.resolvePackageId)(client, params.packageId)}::view::unresolved_markets`,
+        typeArguments: [(0, utils_ts_1.resolveSettlementCoinType)(client, params.settlementCoinType)],
+        arguments: [tx.object((0, utils_ts_1.resolveMarketRegistry)(client, params.marketRegistry))],
+    });
+    const result = await client.simulate(tx);
+    return bcs_1.bcs.vector(bcs_ts_1.MarketViewBcs).parse(extractReturnBytes(result)).map(bcs_ts_1.mapMarketView);
+}
+async function readMarketsPage(client, functionName, params = {}) {
+    const tx = new transactions_1.Transaction();
+    tx.moveCall({
+        target: `${(0, utils_ts_1.resolvePackageId)(client, params.packageId)}::view::${functionName}`,
+        typeArguments: [(0, utils_ts_1.resolveSettlementCoinType)(client, params.settlementCoinType)],
+        arguments: [
+            tx.object((0, utils_ts_1.resolveMarketRegistry)(client, params.marketRegistry)),
+            startArg(tx, params.start),
+            tx.pure.u64(params.limit === undefined ? DEFAULT_PAGE_LIMIT : (0, utils_ts_1.toBigInt)(params.limit)),
+        ],
+    });
+    const result = await client.simulate(tx);
+    const markets = bcs_1.bcs
+        .vector(bcs_ts_1.MarketViewBcs)
+        .parse(extractReturnBytes(result, 0, 0))
+        .map(bcs_ts_1.mapMarketView);
+    const next = bcs_1.bcs.option(bcs_1.bcs.u64()).parse(extractReturnBytes(result, 0, 1));
+    return { markets, nextCursor: next == null ? null : BigInt(next) };
+}
+function getUnresolvedMarketsPage(client, params = {}) {
+    return readMarketsPage(client, "unresolved_markets_page", params);
+}
+function getResolvedMarketsPage(client, params = {}) {
+    return readMarketsPage(client, "resolved_markets_page", params);
+}
+async function getPositionsPage(client, params = {}) {
+    const tx = new transactions_1.Transaction();
+    tx.moveCall({
+        target: `${(0, utils_ts_1.resolvePackageId)(client, params.packageId)}::view::positions_page`,
+        typeArguments: [(0, utils_ts_1.resolveSettlementCoinType)(client, params.settlementCoinType)],
+        arguments: [
+            tx.object((0, utils_ts_1.resolveMarketRegistry)(client, params.marketRegistry)),
+            startArg(tx, params.start),
+            tx.pure.u64(params.limit === undefined ? DEFAULT_PAGE_LIMIT : (0, utils_ts_1.toBigInt)(params.limit)),
+        ],
+    });
+    const result = await client.simulate(tx);
+    const positions = bcs_1.bcs
+        .vector(bcs_ts_1.PositionViewBcs)
+        .parse(extractReturnBytes(result, 0, 0))
+        .map(bcs_ts_1.mapPositionView);
+    const next = bcs_1.bcs.option(bcs_1.bcs.u64()).parse(extractReturnBytes(result, 0, 1));
+    return { positions, nextCursor: next == null ? null : BigInt(next) };
+}
 /**
  * Registry account ids (`0x2::object::ID`) for an owner via `waterx_account::account::account_ids`.
  * Use these ids with `getAccountData`, `deposit`, and `placeOrder` — not Suiscan "Account" object addresses.

package/dist/cjs/src/prediction/gift.d.ts

@@ -25,6 +25,16 @@ import type { AccountIdentityParams, IdArgument, Selection } from "./types.ts";
 export interface GiftBaseParams {
     /** `waterx_prediction_gift` package id. Defaults to `client.waterxPredictionGiftPackageId()`. */
     giftPackageId?: string;
+    /**
+     * `waterx_prediction_gift` *original* (first-published) package id, used
+     * ONLY for the `GiftKey` type tag in {@link deriveGiftAddress}. Defaults to
+     * `client.waterxPredictionGiftTypeOriginId()` (config `original_id`, falling
+     * back to `giftPackageId`/`published_at`). Distinct from `giftPackageId`,
+     * which selects the *runtime* package for moveCall targets — after a package
+     * upgrade the two diverge, and only the original id reproduces the on-chain
+     * `gift_id`. Override only for offline derivation against a custom deploy.
+     */
+    giftTypeOriginId?: string;
     /** `ClaimableLinkConfig` object id. Defaults to `client.claimableLinkConfigId()`. */
     claimableLinkConfig?: string;
     /** Collateral / settlement coin type for the position's `Gift<T>`. Defaults to `client.settlementCoinType()`. */
@@ -72,6 +82,15 @@ export declare function signGiftClaim(giftKeypair: Ed25519Keypair, giftId: strin
 /**
  * Compute the `gift_id` that `create_gift` will produce for the given
  * pubkey, offline. No RPC. Mirrors `claimable_link::derive_gift_address`.
+ *
+ * The `GiftKey` type tag is keyed on the gift package's *original* id
+ * (via {@link resolveGiftTypeOriginId}), NOT `published_at`. On Sui a
+ * struct's type identity stays pinned to its defining package's original
+ * id and never advances across upgrades, so `derive_gift_address`
+ * hashes `GiftKey` under that original id. Using `published_at` here would
+ * silently diverge from the chain after the first package upgrade, yielding
+ * the wrong `gift_id` for every gift. The moveCall targets elsewhere in
+ * this module correctly stay on `published_at` (latest code).
  */
 export declare function deriveGiftAddress(client: PredictClient, pubkey: Uint8Array, params?: GiftBaseParams): string;
 export interface CreateGiftParams extends GiftBaseParams, GiftReferralParams, AccountIdentityParams {

package/dist/cjs/src/prediction/gift.js

@@ -54,6 +54,22 @@ function resolveGiftPackageId(client, override) {
         ? client.waterxPredictionGiftPackageId()
         : override;
 }
+/**
+ * Resolve the package id for the `GiftKey` type tag in
+ * {@link deriveGiftAddress}. Precedence: explicit `giftTypeOriginId`, then
+ * the runtime `giftPackageId` override (a self-contained deploy where
+ * original == published), then the client's config `original_id` (falling
+ * back to `published_at`). This must key on the *original* id so the
+ * off-chain derivation matches the on-chain type identity, which never
+ * advances across package upgrades.
+ */
+function resolveGiftTypeOriginId(client, originOverride, pkgOverride) {
+    if (originOverride !== undefined && originOverride !== "")
+        return originOverride;
+    if (pkgOverride !== undefined && pkgOverride !== "")
+        return pkgOverride;
+    return client.waterxPredictionGiftTypeOriginId();
+}
 function resolveClaimableLinkConfig(client, override) {
     return override === undefined || override === "" ? client.claimableLinkConfigId() : override;
 }
@@ -167,12 +183,21 @@ const GiftKeyBcs = bcs_1.bcs.struct("GiftKey", {
 /**
  * Compute the `gift_id` that `create_gift` will produce for the given
  * pubkey, offline. No RPC. Mirrors `claimable_link::derive_gift_address`.
+ *
+ * The `GiftKey` type tag is keyed on the gift package's *original* id
+ * (via {@link resolveGiftTypeOriginId}), NOT `published_at`. On Sui a
+ * struct's type identity stays pinned to its defining package's original
+ * id and never advances across upgrades, so `derive_gift_address`
+ * hashes `GiftKey` under that original id. Using `published_at` here would
+ * silently diverge from the chain after the first package upgrade, yielding
+ * the wrong `gift_id` for every gift. The moveCall targets elsewhere in
+ * this module correctly stay on `published_at` (latest code).
  */
 function deriveGiftAddress(client, pubkey, params = {}) {
     if (pubkey.length !== constants_ts_1.GIFT_PUBKEY_LEN) {
         throw new Error(`Gift pubkey must be ${constants_ts_1.GIFT_PUBKEY_LEN} bytes, got ${pubkey.length}`);
     }
-    const giftPkg = resolveGiftPackageId(client, params.giftPackageId);
+    const giftPkg = resolveGiftTypeOriginId(client, params.giftTypeOriginId, params.giftPackageId);
     const configId = resolveClaimableLinkConfig(client, params.claimableLinkConfig);
     const keyBytes = GiftKeyBcs.serialize({ pubkey: Array.from(pubkey) }).toBytes();
     return (0, utils_1.deriveObjectID)(configId, `${giftPkg}::claimable_link::GiftKey`, keyBytes);

package/dist/cjs/src/prediction/index.d.ts

@@ -1,6 +1,6 @@
 export { PredictClient } from "./client.ts";
 export type { CreateClientOptions } from "./client.ts";
-export { clearConfigCache, defaultConfigUrl, loadConfig } from "./config.ts";
+export { clearConfigCache, loadConfig } from "./config.ts";
 export type { LoadConfigOptions, WaterxAccountPackage, WaterxConfigPackageBase, WaterxPredictionConfig, WaterxPredictionConfigPackages, WaterxPredictionGiftPackage, WaterxPredictionPackage, WaterxReferralPackage, } from "./config.ts";
 export * from "./constants.ts";
 export * from "./types.ts";
@@ -14,7 +14,7 @@ export { adminPlaceOrderFor, batchClaim, batchForceClaim, buildBatchForceClaimTr
 export type { AdminPlaceOrderForParams, BatchClaimParams, BatchForceClaimParams, BuildBatchForceClaimTransactionsParams, CancelCloseParams, CancelOrderParams, ClaimParams, ConfirmCloseParams, FillOrderParams, ForceClaimParams, PlaceOrderParams, RequestCloseParams, RequestPartialCloseParams, ResolveMarketParams, SelfCancelCloseParams, SelfCancelOrderParams, SplitPositionParams, TransferPositionParams, } from "./prediction.ts";
 export { buildBatchClaimTx, buildPlaceOrderTx } from "./tx-builders.ts";
 export type { BuildBatchClaimTxParams, BuildPlaceOrderTxParams, PredictCommonBuildOpts, } from "./tx-builders.ts";
-export { getAccountData, getAccountIds, getAccountOrderIds, getAccountOrderIdsByMarketId, getAccountPositionIds, getAccountPositionIdsByMarketId, getKeeperAddresses, getAllowedVersions, getMarketExposure, getMarketExposureByKey, getMarketById, getMarketByKey, getOrder, getOrderCursor, getPosition, getPositionCursor, getRegistry, getResolvedMarketCursor, getUnresolvedMarketCursor, isKeeper, isPredictionProtocolAssetAllowed, } from "./fetch.ts";
+export { getAccountData, getAccountIds, getAccountOrderIds, getAccountOrderIdsByMarketId, getAccountPositionIds, getAccountPositionIdsByMarketId, getKeeperAddresses, getAllowedVersions, getMarketExposure, getMarketExposureByKey, getMarketById, getMarketByKey, getOrder, getOrderCursor, getPosition, getPositionCursor, getPositionsPage, getRegistry, getResolvedMarketCursor, getResolvedMarketsPage, getUnresolvedMarketCursor, getUnresolvedMarkets, getUnresolvedMarketsPage, isKeeper, isPredictionProtocolAssetAllowed, } from "./fetch.ts";
 export type { GetAccountIdsParams, ViewBaseParams } from "./fetch.ts";
 export { base64UrlNoPadDecode, base64UrlNoPadEncode, buildClaimShareFlow, buildCreateGiftFlow, buildGiftClaimMessage, claimShare, createGift, deleteGift, deriveGiftAddress, deriveGiftKeypair, encodeGiftUrl, generateGiftSeed, getCreatorGiftCount, getCreatorGiftIds, getGift, getGiftConfigPaused, getGiftControllerAddress, getGiftHasClaimed, parseGiftUrl, signGiftClaim, } from "./gift.ts";
 export type { BuildClaimShareFlowParams, BuildClaimShareFlowResult, BuildCreateGiftFlowResult, ClaimShareParams, CreateGiftParams, DeleteGiftParams, GiftBaseParams, GiftReferralParams, GiftUrlParts, GiftView, } from "./gift.ts";

package/dist/cjs/src/prediction/index.js

@@ -36,14 +36,13 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.splitPosition = exports.selfCancelOrder = exports.selfCancelClose = exports.selectionArg = exports.resolveMarket = exports.requestPartialClose = exports.requestClose = exports.placeOrder = exports.outcomeArg = exports.forceClaim = exports.fillOrder = exports.confirmClose = exports.claim = exports.cancelOrder = exports.cancelClose = exports.buildBatchForceClaimTransactions = exports.batchForceClaim = exports.batchClaim = exports.adminPlaceOrderFor = exports.unpauseMarket = exports.setOrderCancelCooldownMs = exports.setMinReserve = exports.removeKeeper = exports.pauseMarket = exports.depositSettlement = exports.createMarketRegistry = exports.adminWithdraw = exports.addKeeper = exports.withdraw = exports.whitelistPredictionProtocol = exports.transferCoinToAccount = exports.setDelegatePredictionPermission = exports.requestWithdraw = exports.requestDepositFromReceivings = exports.requestDeposit = exports.resolveRegistryAccountId = exports.removeDelegate = exports.disallowPredictionProtocolAsset = exports.deposit = exports.createAccount = exports.consumeWithdrawDirect = exports.consumeDepositDirect = exports.allowPredictionProtocolAsset = exports.addDelegate = exports.utils = exports.user = exports.loadConfig = exports.defaultConfigUrl = exports.clearConfigCache = exports.PredictClient = void 0;
-exports.predictionPositionCalls = exports.predictionOutcomeCalls = exports.predictionGlobalConfigCalls = exports.predictionAccountDataCalls = exports.waterxAccountCalls = exports.bucketFrameworkAccountCalls = exports.signGiftClaim = exports.parseGiftUrl = exports.getGiftHasClaimed = exports.getGiftControllerAddress = exports.getGiftConfigPaused = exports.getGift = exports.getCreatorGiftIds = exports.getCreatorGiftCount = exports.generateGiftSeed = exports.encodeGiftUrl = exports.deriveGiftKeypair = exports.deriveGiftAddress = exports.deleteGift = exports.createGift = exports.claimShare = exports.buildGiftClaimMessage = exports.buildCreateGiftFlow = exports.buildClaimShareFlow = exports.base64UrlNoPadEncode = exports.base64UrlNoPadDecode = exports.isPredictionProtocolAssetAllowed = exports.isKeeper = exports.getUnresolvedMarketCursor = exports.getResolvedMarketCursor = exports.getRegistry = exports.getPositionCursor = exports.getPosition = exports.getOrderCursor = exports.getOrder = exports.getMarketByKey = exports.getMarketById = exports.getMarketExposureByKey = exports.getMarketExposure = exports.getAllowedVersions = exports.getKeeperAddresses = exports.getAccountPositionIdsByMarketId = exports.getAccountPositionIds = exports.getAccountOrderIdsByMarketId = exports.getAccountOrderIds = exports.getAccountIds = exports.getAccountData = exports.buildPlaceOrderTx = exports.buildBatchClaimTx = exports.transferPosition = void 0;
-exports.predictionCalls = exports.predictionViewCalls = exports.predictionVersionCalls = void 0;
+exports.transferPosition = exports.splitPosition = exports.selfCancelOrder = exports.selfCancelClose = exports.selectionArg = exports.resolveMarket = exports.requestPartialClose = exports.requestClose = exports.placeOrder = exports.outcomeArg = exports.forceClaim = exports.fillOrder = exports.confirmClose = exports.claim = exports.cancelOrder = exports.cancelClose = exports.buildBatchForceClaimTransactions = exports.batchForceClaim = exports.batchClaim = exports.adminPlaceOrderFor = exports.unpauseMarket = exports.setOrderCancelCooldownMs = exports.setMinReserve = exports.removeKeeper = exports.pauseMarket = exports.depositSettlement = exports.createMarketRegistry = exports.adminWithdraw = exports.addKeeper = exports.withdraw = exports.whitelistPredictionProtocol = exports.transferCoinToAccount = exports.setDelegatePredictionPermission = exports.requestWithdraw = exports.requestDepositFromReceivings = exports.requestDeposit = exports.resolveRegistryAccountId = exports.removeDelegate = exports.disallowPredictionProtocolAsset = exports.deposit = exports.createAccount = exports.consumeWithdrawDirect = exports.consumeDepositDirect = exports.allowPredictionProtocolAsset = exports.addDelegate = exports.utils = exports.user = exports.loadConfig = exports.clearConfigCache = exports.PredictClient = void 0;
+exports.predictionAccountDataCalls = exports.waterxAccountCalls = exports.bucketFrameworkAccountCalls = exports.signGiftClaim = exports.parseGiftUrl = exports.getGiftHasClaimed = exports.getGiftControllerAddress = exports.getGiftConfigPaused = exports.getGift = exports.getCreatorGiftIds = exports.getCreatorGiftCount = exports.generateGiftSeed = exports.encodeGiftUrl = exports.deriveGiftKeypair = exports.deriveGiftAddress = exports.deleteGift = exports.createGift = exports.claimShare = exports.buildGiftClaimMessage = exports.buildCreateGiftFlow = exports.buildClaimShareFlow = exports.base64UrlNoPadEncode = exports.base64UrlNoPadDecode = exports.isPredictionProtocolAssetAllowed = exports.isKeeper = exports.getUnresolvedMarketsPage = exports.getUnresolvedMarkets = exports.getUnresolvedMarketCursor = exports.getResolvedMarketsPage = exports.getResolvedMarketCursor = exports.getRegistry = exports.getPositionsPage = exports.getPositionCursor = exports.getPosition = exports.getOrderCursor = exports.getOrder = exports.getMarketByKey = exports.getMarketById = exports.getMarketExposureByKey = exports.getMarketExposure = exports.getAllowedVersions = exports.getKeeperAddresses = exports.getAccountPositionIdsByMarketId = exports.getAccountPositionIds = exports.getAccountOrderIdsByMarketId = exports.getAccountOrderIds = exports.getAccountIds = exports.getAccountData = exports.buildPlaceOrderTx = exports.buildBatchClaimTx = void 0;
+exports.predictionCalls = exports.predictionViewCalls = exports.predictionVersionCalls = exports.predictionPositionCalls = exports.predictionOutcomeCalls = exports.predictionGlobalConfigCalls = void 0;
 var client_ts_1 = require("./client.js");
 Object.defineProperty(exports, "PredictClient", { enumerable: true, get: function () { return client_ts_1.PredictClient; } });
 var config_ts_1 = require("./config.js");
 Object.defineProperty(exports, "clearConfigCache", { enumerable: true, get: function () { return config_ts_1.clearConfigCache; } });
-Object.defineProperty(exports, "defaultConfigUrl", { enumerable: true, get: function () { return config_ts_1.defaultConfigUrl; } });
 Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return config_ts_1.loadConfig; } });
 __exportStar(require("./constants.js"), exports);
 __exportStar(require("./types.js"), exports);
@@ -117,9 +116,13 @@ Object.defineProperty(exports, "getOrder", { enumerable: true, get: function ()
 Object.defineProperty(exports, "getOrderCursor", { enumerable: true, get: function () { return fetch_ts_1.getOrderCursor; } });
 Object.defineProperty(exports, "getPosition", { enumerable: true, get: function () { return fetch_ts_1.getPosition; } });
 Object.defineProperty(exports, "getPositionCursor", { enumerable: true, get: function () { return fetch_ts_1.getPositionCursor; } });
+Object.defineProperty(exports, "getPositionsPage", { enumerable: true, get: function () { return fetch_ts_1.getPositionsPage; } });
 Object.defineProperty(exports, "getRegistry", { enumerable: true, get: function () { return fetch_ts_1.getRegistry; } });
 Object.defineProperty(exports, "getResolvedMarketCursor", { enumerable: true, get: function () { return fetch_ts_1.getResolvedMarketCursor; } });
+Object.defineProperty(exports, "getResolvedMarketsPage", { enumerable: true, get: function () { return fetch_ts_1.getResolvedMarketsPage; } });
 Object.defineProperty(exports, "getUnresolvedMarketCursor", { enumerable: true, get: function () { return fetch_ts_1.getUnresolvedMarketCursor; } });
+Object.defineProperty(exports, "getUnresolvedMarkets", { enumerable: true, get: function () { return fetch_ts_1.getUnresolvedMarkets; } });
+Object.defineProperty(exports, "getUnresolvedMarketsPage", { enumerable: true, get: function () { return fetch_ts_1.getUnresolvedMarketsPage; } });
 Object.defineProperty(exports, "isKeeper", { enumerable: true, get: function () { return fetch_ts_1.isKeeper; } });
 Object.defineProperty(exports, "isPredictionProtocolAssetAllowed", { enumerable: true, get: function () { return fetch_ts_1.isPredictionProtocolAssetAllowed; } });
 var gift_ts_1 = require("./gift.js");

package/dist/cjs/src/prediction/types.d.ts

@@ -88,6 +88,25 @@ export interface CursorView {
     front: bigint | null;
     back: bigint | null;
 }
+export interface PageParams {
+    packageId?: string;
+    marketRegistry?: string;
+    settlementCoinType?: string;
+    /** Cursor key to resume from; omit to start at the front of the table. */
+    start?: bigint | number | string;
+    /** Max entries in this page (default 100). */
+    limit?: bigint | number | string;
+}
+export interface MarketPage {
+    markets: MarketView[];
+    /** Pass as `start` for the next page; `null` when the table is exhausted. */
+    nextCursor: bigint | null;
+}
+export interface PositionPage {
+    positions: PositionView[];
+    /** Pass as `start` for the next page; `null` when the table is exhausted. */
+    nextCursor: bigint | null;
+}
 export interface CoinRef {
     objectId: string;
     version: string | bigint | number;

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

@@ -263,6 +263,10 @@ declare const predictOps: {
     getPositionCursor(client: PredictClient, params?: predFetch.ViewBaseParams): Promise<import("./prediction/types.ts").CursorView>;
     getUnresolvedMarketCursor(client: PredictClient, params?: predFetch.ViewBaseParams): Promise<import("./prediction/types.ts").CursorView>;
     getResolvedMarketCursor(client: PredictClient, params?: predFetch.ViewBaseParams): Promise<import("./prediction/types.ts").CursorView>;
+    getUnresolvedMarkets(client: PredictClient, params?: predFetch.ViewBaseParams): Promise<import("./prediction/types.ts").MarketView[]>;
+    getUnresolvedMarketsPage(client: PredictClient, params?: import("./prediction/types.ts").PageParams): Promise<import("./prediction/types.ts").MarketPage>;
+    getResolvedMarketsPage(client: PredictClient, params?: import("./prediction/types.ts").PageParams): Promise<import("./prediction/types.ts").MarketPage>;
+    getPositionsPage(client: PredictClient, params?: import("./prediction/types.ts").PageParams): Promise<import("./prediction/types.ts").PositionPage>;
     getAccountIds(client: PredictClient, params: predFetch.GetAccountIdsParams): Promise<string[]>;
     getAccountData(client: PredictClient, params: predFetch.ViewBaseParams & {
         accountId: string;
@@ -354,13 +358,14 @@ export interface ClientCreateOptions {
     network?: Network;
     /** Default gRPC URL for both lines. */
     grpcUrl?: string;
-    /** Default `waterx-config` JSON URL for both lines. */
-    configUrl?: string;
+    /** Default `waterx-config` JSON URL for both lines (fetched as-is). Required
+     *  unless supplied per-line via `perp` / `predict`. */
+    waterxConfigUrl?: string;
     /** Memoize the fetched config JSON. */
     cache?: boolean;
-    /** Perp-line overrides (network, grpcUrl, configUrl, cache, …). */
+    /** Perp-line overrides (network, grpcUrl, waterxConfigUrl, cache, …). */
     perp?: PerpLineOptions;
-    /** Prediction-line overrides (network, grpcUrl, configUrl, cache, settlement, …). */
+    /** Prediction-line overrides (network, grpcUrl, waterxConfigUrl, cache, settlement, …). */
     predict?: PredictLineOptions;
 }
 export declare class WaterXClient {

package/dist/cjs/src/unified-client.js

@@ -202,13 +202,13 @@ class WaterXClient {
         }
         const perpClient = await client_ts_1.PerpClient.create(resolvedPerpNetwork, {
             grpcUrl: opts.grpcUrl,
-            configUrl: opts.configUrl,
+            waterxConfigUrl: opts.waterxConfigUrl,
             cache: opts.cache,
             ...perpRest,
         });
         const predictClient = await client_ts_2.PredictClient.create(resolvedPredictNetwork, {
             grpcUrl: opts.grpcUrl,
-            configUrl: opts.configUrl,
+            waterxConfigUrl: opts.waterxConfigUrl,
             cache: opts.cache,
             ...predictRest,
         });

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

@@ -95,18 +95,13 @@ export interface WaterXConfig {
 }
 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}.
+     * Canonical `waterx-config` JSON URL to fetch, **as-is** (no `<network>.json`
+     * / git ref appended). Required — {@link loadConfig} reads the URL only from
+     * this option (there is no env-var fallback and no built-in default) and
+     * throws when it is unset. Point it at a staging deployment or local mirror
+     * as needed.
      */
-    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;
+    waterxConfigUrl?: string;
     /**
      * Reuse a previously-fetched config from the in-memory cache (keyed by
      * the effective URL). Default: false (always fetch fresh).
@@ -117,10 +112,5 @@ export interface LoadConfigOptions {
     /** 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/src/perp/config.js

@@ -33,22 +33,15 @@ export const WORMHOLE_DEFAULTS = {
         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`.
- */
-export function defaultConfigUrl(network, ref = DEFAULT_CONFIG_REF) {
-    return `${CONFIG_REPO_RAW_BASE}/${ref}/${network.toLowerCase()}.json`;
-}
 const cache = new Map();
 export function clearConfigCache() {
     cache.clear();
 }
 export async function loadConfig(network, opts = {}) {
-    const url = opts.configUrl ?? defaultConfigUrl(network, opts.configRef);
+    const url = opts.waterxConfigUrl;
+    if (!url) {
+        throw new Error("loadConfig: no config URL — pass opts.waterxConfigUrl");
+    }
     if (opts.cache && cache.has(url)) {
         return cache.get(url);
     }

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

@@ -1,6 +1,6 @@
 export { PerpClient } from "./client.ts";
 export type { CreateClientOptions } from "./client.ts";
-export { PYTH_DEFAULTS, WORMHOLE_DEFAULTS, clearConfigCache, defaultConfigUrl, loadConfig, } from "./config.ts";
+export { PYTH_DEFAULTS, WORMHOLE_DEFAULTS, clearConfigCache, loadConfig } from "./config.ts";
 export type { BasePackageEntry, ConstantFeedEntry, WaterxReferralPackage, LoadConfigOptions, NativeCustodyAsset, NativeCustodyPackage, PythInfraConfig, PythRulePackage, PythSponsorRulePackage, SupraFeedEntry, SupraRulePackage, TestnetFaucetPackage, TrustedEmitterRow, WaterXConfig, WaterXPackages, WaterxCreditPackage, WaterxOraclePackage, WaterxPerpMarketEntry, WaterxPerpPackage, WaterxStakingPackage, WithdrawalQueuePackage, WlpPackage, WormholeBridgePackage, WormholeInfraConfig, WxaAccountPackage, } from "./config.ts";
 export { ACTION_ADD_PRE_ORDER, ACTION_CANCEL_ORDER, ACTION_CANCEL_PRE_ORDER, ACTION_CLOSE_POSITION, ACTION_DECREASE_POSITION, ACTION_DEPOSIT_COLLATERAL, ACTION_INCREASE_POSITION, ACTION_LIQUIDATE, ACTION_OPEN_POSITION, ACTION_PLACE_ORDER, ACTION_UPDATE_ORDER, ACTION_WITHDRAW_COLLATERAL, BPS_SCALE, CRYPTO_FEE_RATE, DOUBLE_SCALE, DRY_RUN_SENDER, FLOAT_SCALE, MAINTENANCE_MARGIN_RATE, ORDER_LIMIT_BUY, ORDER_LIMIT_SELL, ORDER_STOP_BUY, ORDER_STOP_SELL, ORDER_TAG_WILDCARD, PERM_ALL, PERM_ALL_TRADING, PERM_CANCEL_ORDER, PERM_CLOSE_POSITION, PERM_DECREASE_POSITION, PERM_DEPOSIT_COLLATERAL, PERM_INCREASE_POSITION, PERM_MINT_WLP, PERM_OPEN_POSITION, PERM_PLACE_ORDER, PERM_REDEEM_WLP, PERM_WITHDRAW_COLLATERAL, STAKING_PERM_DEPOSIT_STAKE, STAKING_PERM_REDEEM_STAKE, STAKING_PERM_CLAIM_REWARD, STAKING_PERM_ALL, STOCK_FEE_RATE, MS_PER_YEAR, SUI_DECIMALS, WLP_DECIMALS, COLLATERAL_DECIMALS, TOKEN_DECIMALS, } from "./constants.ts";
 export type { Network } from "./constants.ts";

package/dist/src/perp/index.js

@@ -1,6 +1,6 @@
 // ======== Core ========
 export { PerpClient } from "./client.js";
-export { PYTH_DEFAULTS, WORMHOLE_DEFAULTS, clearConfigCache, defaultConfigUrl, loadConfig, } from "./config.js";
+export { PYTH_DEFAULTS, WORMHOLE_DEFAULTS, clearConfigCache, loadConfig } from "./config.js";
 // ======== Constants & enums ========
 export { ACTION_ADD_PRE_ORDER, ACTION_CANCEL_ORDER, ACTION_CANCEL_PRE_ORDER, ACTION_CLOSE_POSITION, ACTION_DECREASE_POSITION, ACTION_DEPOSIT_COLLATERAL, ACTION_INCREASE_POSITION, ACTION_LIQUIDATE, ACTION_OPEN_POSITION, ACTION_PLACE_ORDER, ACTION_UPDATE_ORDER, ACTION_WITHDRAW_COLLATERAL, BPS_SCALE, CRYPTO_FEE_RATE, DOUBLE_SCALE, DRY_RUN_SENDER, FLOAT_SCALE, MAINTENANCE_MARGIN_RATE, ORDER_LIMIT_BUY, ORDER_LIMIT_SELL, ORDER_STOP_BUY, ORDER_STOP_SELL, ORDER_TAG_WILDCARD, PERM_ALL, PERM_ALL_TRADING, PERM_CANCEL_ORDER, PERM_CLOSE_POSITION, PERM_DECREASE_POSITION, PERM_DEPOSIT_COLLATERAL, PERM_INCREASE_POSITION, PERM_MINT_WLP, PERM_OPEN_POSITION, PERM_PLACE_ORDER, PERM_REDEEM_WLP, PERM_WITHDRAW_COLLATERAL, STAKING_PERM_DEPOSIT_STAKE, STAKING_PERM_REDEEM_STAKE, STAKING_PERM_CLAIM_REWARD, STAKING_PERM_ALL, STOCK_FEE_RATE, MS_PER_YEAR, SUI_DECIMALS, WLP_DECIMALS, COLLATERAL_DECIMALS, TOKEN_DECIMALS, } from "./constants.js";
 // ======== Utilities ========

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

@@ -40,6 +40,17 @@ export declare class PredictClient extends BaseLineClient<WaterxPredictionConfig
     waterxAccountAdminCap(): string;
     waterxPredictionGiftPackageId(): string;
     claimableLinkConfigId(): string;
+    /**
+     * Original (first-published) id of the gift package. Used ONLY for the
+     * `GiftKey` type tag in derived-object address computation
+     * (`deriveGiftAddress`). Sui pins a struct's type identity to its
+     * defining package's *original* id — it never advances across upgrades,
+     * unlike `published_at`. So the off-chain `gift_id` derivation must key
+     * on this, or it diverges from the on-chain `derive_gift_address` after
+     * the first upgrade. Falls back to `published_at` when `original_id` is
+     * absent (fresh deployments where the two are equal).
+     */
+    waterxPredictionGiftTypeOriginId(): string;
     waterxReferralPackageId(): string;
     referralTableId(): string;
 }

package/dist/src/prediction/client.js

@@ -68,6 +68,22 @@ export class PredictClient extends BaseLineClient {
     claimableLinkConfigId() {
         return requireConfigValue(this.config.packages.waterx_prediction_gift, "claimable_link_config", "packages.waterx_prediction_gift.claimable_link_config");
     }
+    /**
+     * Original (first-published) id of the gift package. Used ONLY for the
+     * `GiftKey` type tag in derived-object address computation
+     * (`deriveGiftAddress`). Sui pins a struct's type identity to its
+     * defining package's *original* id — it never advances across upgrades,
+     * unlike `published_at`. So the off-chain `gift_id` derivation must key
+     * on this, or it diverges from the on-chain `derive_gift_address` after
+     * the first upgrade. Falls back to `published_at` when `original_id` is
+     * absent (fresh deployments where the two are equal).
+     */
+    waterxPredictionGiftTypeOriginId() {
+        const origin = this.config.packages.waterx_prediction_gift?.original_id;
+        return typeof origin === "string" && origin.length > 0
+            ? origin
+            : this.waterxPredictionGiftPackageId();
+    }
     waterxReferralPackageId() {
         return requireConfigValue(this.config.packages.waterx_referral, "published_at", "packages.waterx_referral.published_at");
     }

package/dist/src/prediction/config.d.ts

@@ -47,17 +47,12 @@ export interface WaterxPredictionConfig {
 }
 export interface LoadConfigOptions {
     /**
-     * Override the default waterx-config raw JSON URL. Use this to point at a
-     * local mirror during development. Takes precedence over {@link configRef}.
+     * Canonical `waterx-config` JSON URL to fetch, **as-is** (no `<network>.json`
+     * / git ref appended). Required — {@link loadConfig} reads the URL only from
+     * this option (there is no env-var fallback and no built-in default) and
+     * throws when it is unset.
      */
-    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;
+    waterxConfigUrl?: string;
     /** Reuse a previously fetched config in memory. Default: false. */
     cache?: boolean;
     /** Optional fetch implementation for tests or runtimes without global fetch. */
@@ -65,10 +60,5 @@ export interface LoadConfigOptions {
     /** 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<WaterxPredictionConfig>;

package/dist/src/prediction/config.js

@@ -4,22 +4,15 @@
  * Mirrors the canonical `waterx-config` JSON for the packages used by this SDK
  * and fetches it from GitHub raw by default.
  */
-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`.
- */
-export function defaultConfigUrl(network, ref = DEFAULT_CONFIG_REF) {
-    return `${CONFIG_REPO_RAW_BASE}/${ref}/${network.toLowerCase()}.json`;
-}
 const configCache = new Map();
 export function clearConfigCache() {
     configCache.clear();
 }
 export async function loadConfig(network, opts = {}) {
-    const url = opts.configUrl ?? defaultConfigUrl(network, opts.configRef);
+    const url = opts.waterxConfigUrl;
+    if (!url) {
+        throw new Error("loadConfig: no config URL — pass opts.waterxConfigUrl");
+    }
     if (opts.cache && configCache.has(url)) {
         return configCache.get(url);
     }

package/dist/src/prediction/fetch.d.ts

@@ -1,5 +1,5 @@
 import type { PredictClient } from "./client.ts";
-import type { AccountDataView, CursorView, MarketExposure, MarketIdInput, MarketView, OrderView, PositionView, RegistryView } from "./types.ts";
+import type { AccountDataView, CursorView, MarketExposure, MarketIdInput, MarketPage, MarketView, OrderView, PageParams, PositionPage, PositionView, RegistryView } from "./types.ts";
 export declare function extractReturnBytes(result: any, commandIndex?: number, returnIndex?: number): Uint8Array;
 export interface ViewBaseParams {
     packageId?: string;
@@ -30,6 +30,11 @@ export declare function getOrderCursor(client: PredictClient, params?: ViewBaseP
 export declare function getPositionCursor(client: PredictClient, params?: ViewBaseParams): Promise<CursorView>;
 export declare function getUnresolvedMarketCursor(client: PredictClient, params?: ViewBaseParams): Promise<CursorView>;
 export declare function getResolvedMarketCursor(client: PredictClient, params?: ViewBaseParams): Promise<CursorView>;
+/** Every unresolved (active) market in one call. Prefer `getUnresolvedMarketsPage` when the table is large. */
+export declare function getUnresolvedMarkets(client: PredictClient, params?: ViewBaseParams): Promise<MarketView[]>;
+export declare function getUnresolvedMarketsPage(client: PredictClient, params?: PageParams): Promise<MarketPage>;
+export declare function getResolvedMarketsPage(client: PredictClient, params?: PageParams): Promise<MarketPage>;
+export declare function getPositionsPage(client: PredictClient, params?: PageParams): Promise<PositionPage>;
 export interface GetAccountIdsParams {
     /** Wallet address that owns sub-accounts in the registry. */
     owner: string;

package/dist/src/prediction/fetch.js

@@ -125,6 +125,66 @@ export function getUnresolvedMarketCursor(client, params = {}) {
 export function getResolvedMarketCursor(client, params = {}) {
     return readCursor(client, "resolved_market_cursor", params);
 }
+const DEFAULT_PAGE_LIMIT = 100n;
+/** Encode an optional cursor key as a Move `Option<u64>` pure arg (`undefined` → none / from front). */
+function startArg(tx, start) {
+    return tx.pure(bcs.option(bcs.u64()).serialize(start === undefined ? null : toBigInt(start)));
+}
+/** Every unresolved (active) market in one call. Prefer `getUnresolvedMarketsPage` when the table is large. */
+export async function getUnresolvedMarkets(client, params = {}) {
+    const tx = new Transaction();
+    tx.moveCall({
+        target: `${resolvePackageId(client, params.packageId)}::view::unresolved_markets`,
+        typeArguments: [resolveSettlementCoinType(client, params.settlementCoinType)],
+        arguments: [tx.object(resolveMarketRegistry(client, params.marketRegistry))],
+    });
+    const result = await client.simulate(tx);
+    return bcs.vector(MarketViewBcs).parse(extractReturnBytes(result)).map(mapMarketView);
+}
+async function readMarketsPage(client, functionName, params = {}) {
+    const tx = new Transaction();
+    tx.moveCall({
+        target: `${resolvePackageId(client, params.packageId)}::view::${functionName}`,
+        typeArguments: [resolveSettlementCoinType(client, params.settlementCoinType)],
+        arguments: [
+            tx.object(resolveMarketRegistry(client, params.marketRegistry)),
+            startArg(tx, params.start),
+            tx.pure.u64(params.limit === undefined ? DEFAULT_PAGE_LIMIT : toBigInt(params.limit)),
+        ],
+    });
+    const result = await client.simulate(tx);
+    const markets = bcs
+        .vector(MarketViewBcs)
+        .parse(extractReturnBytes(result, 0, 0))
+        .map(mapMarketView);
+    const next = bcs.option(bcs.u64()).parse(extractReturnBytes(result, 0, 1));
+    return { markets, nextCursor: next == null ? null : BigInt(next) };
+}
+export function getUnresolvedMarketsPage(client, params = {}) {
+    return readMarketsPage(client, "unresolved_markets_page", params);
+}
+export function getResolvedMarketsPage(client, params = {}) {
+    return readMarketsPage(client, "resolved_markets_page", params);
+}
+export async function getPositionsPage(client, params = {}) {
+    const tx = new Transaction();
+    tx.moveCall({
+        target: `${resolvePackageId(client, params.packageId)}::view::positions_page`,
+        typeArguments: [resolveSettlementCoinType(client, params.settlementCoinType)],
+        arguments: [
+            tx.object(resolveMarketRegistry(client, params.marketRegistry)),
+            startArg(tx, params.start),
+            tx.pure.u64(params.limit === undefined ? DEFAULT_PAGE_LIMIT : toBigInt(params.limit)),
+        ],
+    });
+    const result = await client.simulate(tx);
+    const positions = bcs
+        .vector(PositionViewBcs)
+        .parse(extractReturnBytes(result, 0, 0))
+        .map(mapPositionView);
+    const next = bcs.option(bcs.u64()).parse(extractReturnBytes(result, 0, 1));
+    return { positions, nextCursor: next == null ? null : BigInt(next) };
+}
 /**
  * Registry account ids (`0x2::object::ID`) for an owner via `waterx_account::account::account_ids`.
  * Use these ids with `getAccountData`, `deposit`, and `placeOrder` — not Suiscan "Account" object addresses.

package/dist/src/prediction/gift.d.ts

@@ -25,6 +25,16 @@ import type { AccountIdentityParams, IdArgument, Selection } from "./types.ts";
 export interface GiftBaseParams {
     /** `waterx_prediction_gift` package id. Defaults to `client.waterxPredictionGiftPackageId()`. */
     giftPackageId?: string;
+    /**
+     * `waterx_prediction_gift` *original* (first-published) package id, used
+     * ONLY for the `GiftKey` type tag in {@link deriveGiftAddress}. Defaults to
+     * `client.waterxPredictionGiftTypeOriginId()` (config `original_id`, falling
+     * back to `giftPackageId`/`published_at`). Distinct from `giftPackageId`,
+     * which selects the *runtime* package for moveCall targets — after a package
+     * upgrade the two diverge, and only the original id reproduces the on-chain
+     * `gift_id`. Override only for offline derivation against a custom deploy.
+     */
+    giftTypeOriginId?: string;
     /** `ClaimableLinkConfig` object id. Defaults to `client.claimableLinkConfigId()`. */
     claimableLinkConfig?: string;
     /** Collateral / settlement coin type for the position's `Gift<T>`. Defaults to `client.settlementCoinType()`. */
@@ -72,6 +82,15 @@ export declare function signGiftClaim(giftKeypair: Ed25519Keypair, giftId: strin
 /**
  * Compute the `gift_id` that `create_gift` will produce for the given
  * pubkey, offline. No RPC. Mirrors `claimable_link::derive_gift_address`.
+ *
+ * The `GiftKey` type tag is keyed on the gift package's *original* id
+ * (via {@link resolveGiftTypeOriginId}), NOT `published_at`. On Sui a
+ * struct's type identity stays pinned to its defining package's original
+ * id and never advances across upgrades, so `derive_gift_address`
+ * hashes `GiftKey` under that original id. Using `published_at` here would
+ * silently diverge from the chain after the first package upgrade, yielding
+ * the wrong `gift_id` for every gift. The moveCall targets elsewhere in
+ * this module correctly stay on `published_at` (latest code).
  */
 export declare function deriveGiftAddress(client: PredictClient, pubkey: Uint8Array, params?: GiftBaseParams): string;
 export interface CreateGiftParams extends GiftBaseParams, GiftReferralParams, AccountIdentityParams {

package/dist/src/prediction/gift.js

@@ -32,6 +32,22 @@ function resolveGiftPackageId(client, override) {
         ? client.waterxPredictionGiftPackageId()
         : override;
 }
+/**
+ * Resolve the package id for the `GiftKey` type tag in
+ * {@link deriveGiftAddress}. Precedence: explicit `giftTypeOriginId`, then
+ * the runtime `giftPackageId` override (a self-contained deploy where
+ * original == published), then the client's config `original_id` (falling
+ * back to `published_at`). This must key on the *original* id so the
+ * off-chain derivation matches the on-chain type identity, which never
+ * advances across package upgrades.
+ */
+function resolveGiftTypeOriginId(client, originOverride, pkgOverride) {
+    if (originOverride !== undefined && originOverride !== "")
+        return originOverride;
+    if (pkgOverride !== undefined && pkgOverride !== "")
+        return pkgOverride;
+    return client.waterxPredictionGiftTypeOriginId();
+}
 function resolveClaimableLinkConfig(client, override) {
     return override === undefined || override === "" ? client.claimableLinkConfigId() : override;
 }
@@ -145,12 +161,21 @@ const GiftKeyBcs = bcs.struct("GiftKey", {
 /**
  * Compute the `gift_id` that `create_gift` will produce for the given
  * pubkey, offline. No RPC. Mirrors `claimable_link::derive_gift_address`.
+ *
+ * The `GiftKey` type tag is keyed on the gift package's *original* id
+ * (via {@link resolveGiftTypeOriginId}), NOT `published_at`. On Sui a
+ * struct's type identity stays pinned to its defining package's original
+ * id and never advances across upgrades, so `derive_gift_address`
+ * hashes `GiftKey` under that original id. Using `published_at` here would
+ * silently diverge from the chain after the first package upgrade, yielding
+ * the wrong `gift_id` for every gift. The moveCall targets elsewhere in
+ * this module correctly stay on `published_at` (latest code).
  */
 export function deriveGiftAddress(client, pubkey, params = {}) {
     if (pubkey.length !== GIFT_PUBKEY_LEN) {
         throw new Error(`Gift pubkey must be ${GIFT_PUBKEY_LEN} bytes, got ${pubkey.length}`);
     }
-    const giftPkg = resolveGiftPackageId(client, params.giftPackageId);
+    const giftPkg = resolveGiftTypeOriginId(client, params.giftTypeOriginId, params.giftPackageId);
     const configId = resolveClaimableLinkConfig(client, params.claimableLinkConfig);
     const keyBytes = GiftKeyBcs.serialize({ pubkey: Array.from(pubkey) }).toBytes();
     return deriveObjectID(configId, `${giftPkg}::claimable_link::GiftKey`, keyBytes);

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

@@ -1,6 +1,6 @@
 export { PredictClient } from "./client.ts";
 export type { CreateClientOptions } from "./client.ts";
-export { clearConfigCache, defaultConfigUrl, loadConfig } from "./config.ts";
+export { clearConfigCache, loadConfig } from "./config.ts";
 export type { LoadConfigOptions, WaterxAccountPackage, WaterxConfigPackageBase, WaterxPredictionConfig, WaterxPredictionConfigPackages, WaterxPredictionGiftPackage, WaterxPredictionPackage, WaterxReferralPackage, } from "./config.ts";
 export * from "./constants.ts";
 export * from "./types.ts";
@@ -14,7 +14,7 @@ export { adminPlaceOrderFor, batchClaim, batchForceClaim, buildBatchForceClaimTr
 export type { AdminPlaceOrderForParams, BatchClaimParams, BatchForceClaimParams, BuildBatchForceClaimTransactionsParams, CancelCloseParams, CancelOrderParams, ClaimParams, ConfirmCloseParams, FillOrderParams, ForceClaimParams, PlaceOrderParams, RequestCloseParams, RequestPartialCloseParams, ResolveMarketParams, SelfCancelCloseParams, SelfCancelOrderParams, SplitPositionParams, TransferPositionParams, } from "./prediction.ts";
 export { buildBatchClaimTx, buildPlaceOrderTx } from "./tx-builders.ts";
 export type { BuildBatchClaimTxParams, BuildPlaceOrderTxParams, PredictCommonBuildOpts, } from "./tx-builders.ts";
-export { getAccountData, getAccountIds, getAccountOrderIds, getAccountOrderIdsByMarketId, getAccountPositionIds, getAccountPositionIdsByMarketId, getKeeperAddresses, getAllowedVersions, getMarketExposure, getMarketExposureByKey, getMarketById, getMarketByKey, getOrder, getOrderCursor, getPosition, getPositionCursor, getRegistry, getResolvedMarketCursor, getUnresolvedMarketCursor, isKeeper, isPredictionProtocolAssetAllowed, } from "./fetch.ts";
+export { getAccountData, getAccountIds, getAccountOrderIds, getAccountOrderIdsByMarketId, getAccountPositionIds, getAccountPositionIdsByMarketId, getKeeperAddresses, getAllowedVersions, getMarketExposure, getMarketExposureByKey, getMarketById, getMarketByKey, getOrder, getOrderCursor, getPosition, getPositionCursor, getPositionsPage, getRegistry, getResolvedMarketCursor, getResolvedMarketsPage, getUnresolvedMarketCursor, getUnresolvedMarkets, getUnresolvedMarketsPage, isKeeper, isPredictionProtocolAssetAllowed, } from "./fetch.ts";
 export type { GetAccountIdsParams, ViewBaseParams } from "./fetch.ts";
 export { base64UrlNoPadDecode, base64UrlNoPadEncode, buildClaimShareFlow, buildCreateGiftFlow, buildGiftClaimMessage, claimShare, createGift, deleteGift, deriveGiftAddress, deriveGiftKeypair, encodeGiftUrl, generateGiftSeed, getCreatorGiftCount, getCreatorGiftIds, getGift, getGiftConfigPaused, getGiftControllerAddress, getGiftHasClaimed, parseGiftUrl, signGiftClaim, } from "./gift.ts";
 export type { BuildClaimShareFlowParams, BuildClaimShareFlowResult, BuildCreateGiftFlowResult, ClaimShareParams, CreateGiftParams, DeleteGiftParams, GiftBaseParams, GiftReferralParams, GiftUrlParts, GiftView, } from "./gift.ts";

package/dist/src/prediction/index.js

@@ -1,5 +1,5 @@
 export { PredictClient } from "./client.js";
-export { clearConfigCache, defaultConfigUrl, loadConfig } from "./config.js";
+export { clearConfigCache, loadConfig } from "./config.js";
 export * from "./constants.js";
 export * from "./types.js";
 export * as user from "./user/index.js";
@@ -8,7 +8,7 @@ export { addDelegate, allowPredictionProtocolAsset, consumeDepositDirect, consum
 export { addKeeper, adminWithdraw, createMarketRegistry, depositSettlement, pauseMarket, removeKeeper, setMinReserve, setOrderCancelCooldownMs, unpauseMarket, } from "./admin.js";
 export { adminPlaceOrderFor, batchClaim, batchForceClaim, buildBatchForceClaimTransactions, cancelClose, cancelOrder, claim, confirmClose, fillOrder, forceClaim, outcomeArg, placeOrder, requestClose, requestPartialClose, resolveMarket, selectionArg, selfCancelClose, selfCancelOrder, splitPosition, transferPosition, } from "./prediction.js";
 export { buildBatchClaimTx, buildPlaceOrderTx } from "./tx-builders.js";
-export { getAccountData, getAccountIds, getAccountOrderIds, getAccountOrderIdsByMarketId, getAccountPositionIds, getAccountPositionIdsByMarketId, getKeeperAddresses, getAllowedVersions, getMarketExposure, getMarketExposureByKey, getMarketById, getMarketByKey, getOrder, getOrderCursor, getPosition, getPositionCursor, getRegistry, getResolvedMarketCursor, getUnresolvedMarketCursor, isKeeper, isPredictionProtocolAssetAllowed, } from "./fetch.js";
+export { getAccountData, getAccountIds, getAccountOrderIds, getAccountOrderIdsByMarketId, getAccountPositionIds, getAccountPositionIdsByMarketId, getKeeperAddresses, getAllowedVersions, getMarketExposure, getMarketExposureByKey, getMarketById, getMarketByKey, getOrder, getOrderCursor, getPosition, getPositionCursor, getPositionsPage, getRegistry, getResolvedMarketCursor, getResolvedMarketsPage, getUnresolvedMarketCursor, getUnresolvedMarkets, getUnresolvedMarketsPage, isKeeper, isPredictionProtocolAssetAllowed, } from "./fetch.js";
 export { base64UrlNoPadDecode, base64UrlNoPadEncode, buildClaimShareFlow, buildCreateGiftFlow, buildGiftClaimMessage, claimShare, createGift, deleteGift, deriveGiftAddress, deriveGiftKeypair, encodeGiftUrl, generateGiftSeed, getCreatorGiftCount, getCreatorGiftIds, getGift, getGiftConfigPaused, getGiftControllerAddress, getGiftHasClaimed, parseGiftUrl, signGiftClaim, } from "./gift.js";
 export * as bucketFrameworkAccountCalls from "../generated/bucket_v2_framework/account.js";
 export * as waterxAccountCalls from "../generated/waterx_account/account.js";

package/dist/src/prediction/types.d.ts

@@ -88,6 +88,25 @@ export interface CursorView {
     front: bigint | null;
     back: bigint | null;
 }
+export interface PageParams {
+    packageId?: string;
+    marketRegistry?: string;
+    settlementCoinType?: string;
+    /** Cursor key to resume from; omit to start at the front of the table. */
+    start?: bigint | number | string;
+    /** Max entries in this page (default 100). */
+    limit?: bigint | number | string;
+}
+export interface MarketPage {
+    markets: MarketView[];
+    /** Pass as `start` for the next page; `null` when the table is exhausted. */
+    nextCursor: bigint | null;
+}
+export interface PositionPage {
+    positions: PositionView[];
+    /** Pass as `start` for the next page; `null` when the table is exhausted. */
+    nextCursor: bigint | null;
+}
 export interface CoinRef {
     objectId: string;
     version: string | bigint | number;

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

@@ -263,6 +263,10 @@ declare const predictOps: {
     getPositionCursor(client: PredictClient, params?: predFetch.ViewBaseParams): Promise<import("./prediction/types.ts").CursorView>;
     getUnresolvedMarketCursor(client: PredictClient, params?: predFetch.ViewBaseParams): Promise<import("./prediction/types.ts").CursorView>;
     getResolvedMarketCursor(client: PredictClient, params?: predFetch.ViewBaseParams): Promise<import("./prediction/types.ts").CursorView>;
+    getUnresolvedMarkets(client: PredictClient, params?: predFetch.ViewBaseParams): Promise<import("./prediction/types.ts").MarketView[]>;
+    getUnresolvedMarketsPage(client: PredictClient, params?: import("./prediction/types.ts").PageParams): Promise<import("./prediction/types.ts").MarketPage>;
+    getResolvedMarketsPage(client: PredictClient, params?: import("./prediction/types.ts").PageParams): Promise<import("./prediction/types.ts").MarketPage>;
+    getPositionsPage(client: PredictClient, params?: import("./prediction/types.ts").PageParams): Promise<import("./prediction/types.ts").PositionPage>;
     getAccountIds(client: PredictClient, params: predFetch.GetAccountIdsParams): Promise<string[]>;
     getAccountData(client: PredictClient, params: predFetch.ViewBaseParams & {
         accountId: string;
@@ -354,13 +358,14 @@ export interface ClientCreateOptions {
     network?: Network;
     /** Default gRPC URL for both lines. */
     grpcUrl?: string;
-    /** Default `waterx-config` JSON URL for both lines. */
-    configUrl?: string;
+    /** Default `waterx-config` JSON URL for both lines (fetched as-is). Required
+     *  unless supplied per-line via `perp` / `predict`. */
+    waterxConfigUrl?: string;
     /** Memoize the fetched config JSON. */
     cache?: boolean;
-    /** Perp-line overrides (network, grpcUrl, configUrl, cache, …). */
+    /** Perp-line overrides (network, grpcUrl, waterxConfigUrl, cache, …). */
     perp?: PerpLineOptions;
-    /** Prediction-line overrides (network, grpcUrl, configUrl, cache, settlement, …). */
+    /** Prediction-line overrides (network, grpcUrl, waterxConfigUrl, cache, settlement, …). */
     predict?: PredictLineOptions;
 }
 export declare class WaterXClient {

package/dist/src/unified-client.js

@@ -166,13 +166,13 @@ export class WaterXClient {
         }
         const perpClient = await PerpClient.create(resolvedPerpNetwork, {
             grpcUrl: opts.grpcUrl,
-            configUrl: opts.configUrl,
+            waterxConfigUrl: opts.waterxConfigUrl,
             cache: opts.cache,
             ...perpRest,
         });
         const predictClient = await PredictClient.create(resolvedPredictNetwork, {
             grpcUrl: opts.grpcUrl,
-            configUrl: opts.configUrl,
+            waterxConfigUrl: opts.waterxConfigUrl,
             cache: opts.cache,
             ...predictRest,
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@waterx/sdk",
-  "version": "3.0.3",
+  "version": "3.1.1",
   "description": "WaterX SDK — perpetuals and prediction markets on Sui",
   "license": "MIT",
   "author": "WaterX",