@instadapp/fluid-sui-read-sdk 0.2.0 → 0.3.0

package/README.md

@@ -162,18 +162,19 @@ npm run example     # prints every resolver against mainnet
 
 ## Config
 
-🔴 **The built-in ids are the STAGING deployment on Sui mainnet, not production.** They will change at the production launch.
+**There is no default network**: every client passes `network` explicitly.
 
-**There is no default network**: every client passes `network` explicitly, so nobody reads staging believing it is production. `STAGING` (in `src/config.ts`; `network: "staging"`) is the current deployment (staging gist, 2026-09-30): library / liquidity / lending from 2026-09-18, oracle `0xc1e7…4814` and vaults `0x08a3…6f20` from 2026-09-30. Vault 1 = `VaultMarket<SUI, USDC>` `0x3ba5…72b8` on oracle nonce 1 `0x1a69…b279`. `oracle` holds the RedStone adapter and the Pyth `PriceInfoObject` per feed id.
+- `network: "mainnet"` = `PROD` (alias `MAINNET`): the production deployment (2026-11-02), same ids as the write SDK and fluid-packages-sui `deployments/mainnet.json`. Day one: fUSDC and vault 1 = `VaultMarket<hBTC, USDC>` `0x1aa7…a624` on oracle nonce 1 `0x6f74…3784` (RedStone BTC main + Pyth BTC/USD guard).
+- `network: "staging"` = `STAGING`: the staging-on-mainnet deployment (staging gist, 2026-09-30): library / liquidity / lending from 2026-09-18, oracle `0xc1e7…4814` and vaults `0x08a3…6f20` from 2026-09-30. Vaults 1 SUI/USDC + 2 SUI/USDSUI, fUSDC + fUSDSUI. `npx tsx scripts/smoke-staging.ts` checks it with zero config.
 
-`network: "mainnet"` throws: it used to alias the staging config, and there is no production deployment yet. Build production with `configFromDeployment` when it ships. The `MAINNET` constant stays only as a deprecated alias of staging for existing imports. The staging config is the live staging-on-mainnet deployment, same ids as the write SDK (fluid-packages-sui `deployments/mainnet.json`): vaults 1 SUI/USDC + 2 SUI/USDSUI, fUSDC + fUSDSUI. `npx tsx scripts/smoke-staging.ts` checks it with zero config.
+`oracle` holds the RedStone adapter and the Pyth `PriceInfoObject` per feed id.
 
 - **Don't depend on the built-in ids:** build the config from a deployment record (fluid-packages-sui `deployments/<network>.json`, the write SDK's source) and pass it in:
   ```ts
   import { readFileSync } from "node:fs";
-  import { Client, configFromDeployment, STAGING } from "@instadapp/fluid-sui-read-sdk";
+  import { Client, configFromDeployment, PROD } from "@instadapp/fluid-sui-read-sdk";
   const rec = JSON.parse(readFileSync("deployments/mainnet.json", "utf8"));
-  const cfg = configFromDeployment(rec, { network: "mainnet", oracle: STAGING.oracle });
+  const cfg = configFromDeployment(rec, { network: "mainnet", oracle: PROD.oracle });
   const client = new Client(undefined, { network: cfg });
   ```
   The record has no RedStone package or Pyth feed map, so `oracle` is passed in.

package/dist/index.d.mts

@@ -704,9 +704,12 @@ type FluidReadConfig = {
  */
 declare const STAGING: FluidReadConfig;
 /**
- * @deprecated Misleading name kept for compatibility: this is the STAGING deployment
- * (`STAGING`), not production. Use `STAGING` / network "staging".
+ * PRODUCTION deployment on Sui mainnet (2026-11-02), same ids as fluid-packages-sui
+ * deployments/mainnet.json + mainnet-markets.json and the write SDK. Day one: fUSDC and
+ * vault 1 = VaultMarket<hBTC, USDC> 0x1aa7…a624 on oracle nonce 1 0x6f74…3784 (RedStone BTC
+ * main + Pyth BTC/USD guard). Audited maths. Network "mainnet".
  */
+declare const PROD: FluidReadConfig;
 declare const MAINNET: FluidReadConfig;
 declare const CONFIGS: Record<string, FluidReadConfig>;
 /**
@@ -1945,8 +1948,8 @@ declare class Vault {
 declare const DEFAULT_RPC_URL = "https://fullnode.mainnet.sui.io:443";
 type ClientOptions = {
   /**
-   * REQUIRED. Built-in network name ("staging") or a
-   * full config (e.g. production from `configFromDeployment`). No default, so nobody reads
+   * REQUIRED. Built-in network name ("mainnet" = production, "staging") or a
+   * full config (e.g. from `configFromDeployment`). No default, so nobody reads
    * staging believing it is production.
    */
   network: string | FluidReadConfig;
@@ -1968,8 +1971,8 @@ type ClientOptions = {
  * `client.liquidity`, `client.lending`, `client.vault` (+ `client.oracle`, Sui-only).
  *
  * @example
- * const client = new Client(undefined, { network: "staging" });  // staging deployment, Sui mainnet gRPC
- * const client = new Client("https://my-fullnode:443", { network: prodConfig });
+ * const client = new Client(undefined, { network: "mainnet" });  // production deployment, Sui mainnet gRPC
+ * const client = new Client("https://my-fullnode:443", { network: customConfig });
  * const client = new Client(existingSuiGrpcClient, { network: "staging" });
  * const vault = await client.vault.getVaultEntireData(1);
  */
@@ -2149,4 +2152,4 @@ declare function mulBigNumber(a: bigint, b: bigint): bigint;
 /** `big_number::mul_div_normal`: normal * bn1 / bn2. */
 declare function mulDivNormal(normal: bigint, bn1: bigint, bn2: bigint): bigint;
 //#endregion
-export { AllEndpointsFailedError, CONFIGS, CheckpointReadError, Client, type ClientOptions, Configs, ConstantViews, CurrentBranchState, DEFAULT_RPC_URL, DecodedBranch, DecodedTick, DecodedTickIdLiquidation, type DeploymentRecord, type DiscoveryLevel, EXCHANGE_PRICES_PRECISION, EXCHANGE_PRICE_SCALE_FACTOR, ExchangePriceResult, ExchangePricesAndConfig, ExchangePricesAndRates, FOUR_DECIMALS, FTokenDetails, FTokenDetailsUserPosition, FTokenHolder, FTokenHolders, FTokenInternalData, type FailoverOptions, type FluidDerive, type FluidReadConfig, GraphQLError, type GraphQLOptions, JlTokenDetails, JlTokenDetailsUserPosition, JlTokenInternalData, Lending, LendingAccount, type LendingRecord, LendingStateData, LendingUserPosition, LimitsAndAvailability, Liquidity, LiquidityAccount, MAINNET, MAX_REWARDS_RATE, NeedsDiscoveryError, NftPosition, ORACLE_LIMITS, ORACLE_RATE_PRECISION, ObjectNotFoundError, Oracle, OracleData, OraclePrice, OracleRoute, OracleSource, OverallTokenData, POSITION_INDEX_FIX, type PackageIds, type PositionCounts, PositionIndex, type PositionIndexOptions, type PositionSource, PositionWithRiskRatio, PreviewData, RATE_OUTPUT_DECIMALS, RETURN_PERCENT_PRECISION, RateData, RateDataV1, RateDataV2, RateModelAccount, type ReadContext, type ReserveRecord, RewardsRateModelConfig, SECONDS_PER_YEAR, STAGING, SUPPLY_RATE_PRECISION, TotalAmounts, TotalSupplyAndBorrow, UserBorrowData, UserBorrowPositionAccount, UserPosition, UserPositionWithDebt, UserSupplyData, UserSupplyPositionAccount, Vault, VaultConfig, VaultEntireData, VaultEntireDataV2, type VaultReadOpts, type VaultRecord, VaultState, ViewCallError, backoffDelay, bcs_d_exports as bcsTypes, checkpointClient, checkpointTimestampSeconds, clientForEndpoint, configFromDeployment, createDerive, createFailoverClient, divCeil, fluidRead, graphqlQuery, latestCheckpoint, lending_d_exports as lendingMath, liquidity_d_exports as liquidityMath, max, min, mulDiv, mulDivCeil, nowSeconds, resolveConfig, rewardsRateToBps, scaleAndInvert, simulateView, supplyRateToBps, tick_d_exports as tickMath, vault_d_exports as vaultMath };
+export { AllEndpointsFailedError, CONFIGS, CheckpointReadError, Client, type ClientOptions, Configs, ConstantViews, CurrentBranchState, DEFAULT_RPC_URL, DecodedBranch, DecodedTick, DecodedTickIdLiquidation, type DeploymentRecord, type DiscoveryLevel, EXCHANGE_PRICES_PRECISION, EXCHANGE_PRICE_SCALE_FACTOR, ExchangePriceResult, ExchangePricesAndConfig, ExchangePricesAndRates, FOUR_DECIMALS, FTokenDetails, FTokenDetailsUserPosition, FTokenHolder, FTokenHolders, FTokenInternalData, type FailoverOptions, type FluidDerive, type FluidReadConfig, GraphQLError, type GraphQLOptions, JlTokenDetails, JlTokenDetailsUserPosition, JlTokenInternalData, Lending, LendingAccount, type LendingRecord, LendingStateData, LendingUserPosition, LimitsAndAvailability, Liquidity, LiquidityAccount, MAINNET, MAX_REWARDS_RATE, NeedsDiscoveryError, NftPosition, ORACLE_LIMITS, ORACLE_RATE_PRECISION, ObjectNotFoundError, Oracle, OracleData, OraclePrice, OracleRoute, OracleSource, OverallTokenData, POSITION_INDEX_FIX, PROD, type PackageIds, type PositionCounts, PositionIndex, type PositionIndexOptions, type PositionSource, PositionWithRiskRatio, PreviewData, RATE_OUTPUT_DECIMALS, RETURN_PERCENT_PRECISION, RateData, RateDataV1, RateDataV2, RateModelAccount, type ReadContext, type ReserveRecord, RewardsRateModelConfig, SECONDS_PER_YEAR, STAGING, SUPPLY_RATE_PRECISION, TotalAmounts, TotalSupplyAndBorrow, UserBorrowData, UserBorrowPositionAccount, UserPosition, UserPositionWithDebt, UserSupplyData, UserSupplyPositionAccount, Vault, VaultConfig, VaultEntireData, VaultEntireDataV2, type VaultReadOpts, type VaultRecord, VaultState, ViewCallError, backoffDelay, bcs_d_exports as bcsTypes, checkpointClient, checkpointTimestampSeconds, clientForEndpoint, configFromDeployment, createDerive, createFailoverClient, divCeil, fluidRead, graphqlQuery, latestCheckpoint, lending_d_exports as lendingMath, liquidity_d_exports as liquidityMath, max, min, mulDiv, mulDivCeil, nowSeconds, resolveConfig, rewardsRateToBps, scaleAndInvert, simulateView, supplyRateToBps, tick_d_exports as tickMath, vault_d_exports as vaultMath };

package/dist/index.mjs

@@ -66,12 +66,51 @@ const STAGING = {
 	rpcUrls: ["https://fullnode.mainnet.sui.io:443"],
 	graphqlUrl: "https://graphql.mainnet.sui.io/graphql"
 };
+const USDC = "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC";
+const HBTC = "0xd30fb3f8914efdbeb7b8e85fae1d65dc584b44a1281f66737b92bb9f03a59d06::btc::BTC";
 /**
-* @deprecated Misleading name kept for compatibility: this is the STAGING deployment
-* (`STAGING`), not production. Use `STAGING` / network "staging".
+* PRODUCTION deployment on Sui mainnet (2026-11-02), same ids as fluid-packages-sui
+* deployments/mainnet.json + mainnet-markets.json and the write SDK. Day one: fUSDC and
+* vault 1 = VaultMarket<hBTC, USDC> 0x1aa7…a624 on oracle nonce 1 0x6f74…3784 (RedStone BTC
+* main + Pyth BTC/USD guard). Audited maths. Network "mainnet".
 */
-const MAINNET = STAGING;
-const CONFIGS = { staging: STAGING };
+const PROD = {
+	network: "mainnet",
+	packages: {
+		library: same("0xdb1caa95193a0bda87e56a9aaf9878672ca8bea7039447e5c789a572a0621969"),
+		liquidity: same("0x03dbce0f4cbd6325ca81414cc63a82f35e32bb941610b9120fab0997bc70daa3"),
+		lending: same("0xc63078660d7e3ed001e565b8bd7e2e6eb7313ef809051165cda901621e1db842"),
+		lendingRewards: same("0x8269897ee68730b4bde175c883719f1fa108509113c2c177ad1b456bb3782ba2"),
+		oracle: same("0x2caaa38d2c1c424d8ec79750c110d2211f2e06d66a9a261204f721175da15bcc"),
+		vaults: same("0x937156ee38d5c0a9e061dedd549867aeee88c478fad7f3213b66ca4f95906743")
+	},
+	objects: {
+		liquidityRegistry: "0xddeb96aeff09698e7fdcdefb6923642d0e2da1febcaf656371cf7e55bb339a0a",
+		lendingRegistry: "0x98307ab7e769b60257f4b12c20e0976fb57bbe898409b568a3044cf94b3f5647",
+		oracleRegistry: "0x359f818813a10a4bc3862536dafa6bc2bef0bf3597b090539fd05a89cf8fb368",
+		vaultRegistry: "0xe598cc749e0907d6454fdf779611b2efee7fdb2d756ff2706385bfed493bc608",
+		liquidityAuth: "0x1fc3d11285cd7b7ed44bf92f5df3a856c1a45699f59168fd878dfa4eae8e459f",
+		lendingAuth: "0x6e8ca10c5e6f49984106e38a3b6ef49c05a5a5a01f77b04c754e4d6c1e0ec8f7",
+		rewardsAuth: "0xaaf5efdfa300286a719ca8131bcc5f70bc1d3b1fb18a2886f4da04072b5b3bd1",
+		oracleAuth: "0xb498982435b0fdc18126d5febf1327af5dcd02b2e3377b6e5c37ab3eddf08ca8",
+		vaultAdmin: "0x2b3d9ccfb6e1da6ff8acfcb9c56c898a06ae7f3d6f37e3e64e7df34a60ccd887"
+	},
+	oracle: {
+		redstoneAdapter: STAGING.oracle.redstoneAdapter,
+		redstonePackage: STAGING.oracle.redstonePackage,
+		pythPriceInfoObjects: { "0xe62df6c8b4a85fe1a67db44dc12de5db330f7ac66b72dc658afedf0f4a415b43": "0xe64832d1b4c9a75139a7313aee69da891297d8397fda2863b5bdcc4af0b79758" },
+		pythStateId: STAGING.oracle.pythStateId,
+		wormholeStateId: STAGING.oracle.wormholeStateId
+	},
+	tokens: [USDC, HBTC],
+	rpcUrls: ["https://fullnode.mainnet.sui.io:443"],
+	graphqlUrl: "https://graphql.mainnet.sui.io/graphql"
+};
+const MAINNET = PROD;
+const CONFIGS = {
+	mainnet: PROD,
+	staging: STAGING
+};
 /**
 * Build a read config from a deployment record instead of the built-in ids, e.g.
 * `configFromDeployment(JSON.parse(readFileSync(path, "utf8")), { network: "mainnet", oracle })`.
@@ -125,8 +164,7 @@ function configFromDeployment(rec, opts) {
 	return config;
 }
 function resolveConfig(networkOrConfig) {
-	if (networkOrConfig === void 0 || networkOrConfig === null || networkOrConfig === "") throw new Error("Fluid network required: pass { network: \"staging\" } (the live staging-on-mainnet deployment) or a production config from configFromDeployment(...). There is no default.");
-	if (networkOrConfig === "mainnet") throw new Error("No built-in Fluid production deployment yet. \"mainnet\" used to alias the STAGING deployment; pass { network: \"staging\" } for that, or build the production config with configFromDeployment(...) once it ships.");
+	if (networkOrConfig === void 0 || networkOrConfig === null || networkOrConfig === "") throw new Error("Fluid network required: pass { network: \"mainnet\" } (production), { network: \"staging\" } (the staging-on-mainnet deployment) or a config from configFromDeployment(...). There is no default.");
 	const cfg = typeof networkOrConfig === "string" ? CONFIGS[networkOrConfig] : networkOrConfig;
 	if (!cfg) throw new Error(`no built-in Fluid config for network "${String(networkOrConfig)}"`);
 	const n = (p) => ({
@@ -3478,8 +3516,8 @@ const DEFAULT_RPC_URL = "https://fullnode.mainnet.sui.io:443";
 * `client.liquidity`, `client.lending`, `client.vault` (+ `client.oracle`, Sui-only).
 *
 * @example
-* const client = new Client(undefined, { network: "staging" });  // staging deployment, Sui mainnet gRPC
-* const client = new Client("https://my-fullnode:443", { network: prodConfig });
+* const client = new Client(undefined, { network: "mainnet" });  // production deployment, Sui mainnet gRPC
+* const client = new Client("https://my-fullnode:443", { network: customConfig });
 * const client = new Client(existingSuiGrpcClient, { network: "staging" });
 * const vault = await client.vault.getVaultEntireData(1);
 */
@@ -3538,4 +3576,4 @@ function fluidRead(opts) {
 }
 
 //#endregion
-export { AllEndpointsFailedError, CONFIGS, CheckpointReadError, Client, DEFAULT_RPC_URL, EXCHANGE_PRICES_PRECISION, EXCHANGE_PRICE_SCALE_FACTOR, FOUR_DECIMALS, GraphQLError, Lending, Liquidity, MAINNET, MAX_REWARDS_RATE, NeedsDiscoveryError, ORACLE_LIMITS, ORACLE_RATE_PRECISION, ObjectNotFoundError, Oracle, POSITION_INDEX_FIX, PositionIndex, RATE_OUTPUT_DECIMALS, RETURN_PERCENT_PRECISION, SECONDS_PER_YEAR, STAGING, SUPPLY_RATE_PRECISION, Vault, ViewCallError, backoffDelay, bcs_exports as bcsTypes, checkpointClient, checkpointTimestampSeconds, clientForEndpoint, configFromDeployment, createDerive, createFailoverClient, divCeil, fluidRead, graphqlQuery, latestCheckpoint, lending_exports as lendingMath, liquidity_exports as liquidityMath, max, min, mulDiv, mulDivCeil, nowSeconds, resolveConfig, rewardsRateToBps, scaleAndInvert, simulateView, supplyRateToBps, tick_exports as tickMath, vault_exports as vaultMath };
+export { AllEndpointsFailedError, CONFIGS, CheckpointReadError, Client, DEFAULT_RPC_URL, EXCHANGE_PRICES_PRECISION, EXCHANGE_PRICE_SCALE_FACTOR, FOUR_DECIMALS, GraphQLError, Lending, Liquidity, MAINNET, MAX_REWARDS_RATE, NeedsDiscoveryError, ORACLE_LIMITS, ORACLE_RATE_PRECISION, ObjectNotFoundError, Oracle, POSITION_INDEX_FIX, PROD, PositionIndex, RATE_OUTPUT_DECIMALS, RETURN_PERCENT_PRECISION, SECONDS_PER_YEAR, STAGING, SUPPLY_RATE_PRECISION, Vault, ViewCallError, backoffDelay, bcs_exports as bcsTypes, checkpointClient, checkpointTimestampSeconds, clientForEndpoint, configFromDeployment, createDerive, createFailoverClient, divCeil, fluidRead, graphqlQuery, latestCheckpoint, lending_exports as lendingMath, liquidity_exports as liquidityMath, max, min, mulDiv, mulDivCeil, nowSeconds, resolveConfig, rewardsRateToBps, scaleAndInvert, simulateView, supplyRateToBps, tick_exports as tickMath, vault_exports as vaultMath };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@instadapp/fluid-sui-read-sdk",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Read-only TypeScript SDK for Fluid on Sui, shaped like @jup-ag/lend-read",
   "type": "module",
   "engines": {