@mysten/deepbook-v3 2.0.0 → 2.1.3

package/dist/predict/config/testnet.d.mts

@@ -0,0 +1,17 @@
+import { PredictConfig } from "./types.mjs";
+
+//#region src/predict/config/testnet.d.ts
+/**
+ * Testnet deployment constants, read from the shared generated record in
+ * `src/deployments/` rather than transcribed here. `/account` and `/sessions` read slices of
+ * that same record, so a redeploy (`pnpm sync-deployment`) moves every subpath together and
+ * they cannot end up addressing different deployments.
+ *
+ * The record is generated from the deploy tooling's `deployment.testnet.json`; see
+ * `scripts/sync-deployment.ts`. `getDeployment('testnet')` names the deployment and the
+ * deepbookv3 commit these ids came from.
+ */
+declare const TESTNET_CONFIG: PredictConfig;
+//#endregion
+export { TESTNET_CONFIG };
+//# sourceMappingURL=testnet.d.mts.map

package/dist/predict/config/testnet.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testnet.d.mts","names":[],"sources":["../../../src/predict/config/testnet.ts"],"mappings":";;;;;AAgBA;;;;;;;;cAAa,cAAA,EAAgB,aAAA"}

package/dist/predict/config/testnet.mjs

@@ -0,0 +1,26 @@
+import { TESTNET_PREDICT } from "../../deployments/testnet.mjs";
+
+//#region src/predict/config/testnet.ts
+/**
+* Testnet deployment constants, read from the shared generated record in
+* `src/deployments/` rather than transcribed here. `/account` and `/sessions` read slices of
+* that same record, so a redeploy (`pnpm sync-deployment`) moves every subpath together and
+* they cannot end up addressing different deployments.
+*
+* The record is generated from the deploy tooling's `deployment.testnet.json`; see
+* `scripts/sync-deployment.ts`. `getDeployment('testnet')` names the deployment and the
+* deepbookv3 commit these ids came from.
+*/
+const TESTNET_CONFIG = Object.freeze({
+	network: "testnet",
+	packages: TESTNET_PREDICT.packages,
+	objects: TESTNET_PREDICT.objects,
+	quoteCoinType: TESTNET_PREDICT.quoteCoinType,
+	coinTypes: TESTNET_PREDICT.coinTypes,
+	units: TESTNET_PREDICT.units,
+	underlyings: TESTNET_PREDICT.underlyings
+});
+
+//#endregion
+export { TESTNET_CONFIG };
+//# sourceMappingURL=testnet.mjs.map

package/dist/predict/config/testnet.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"testnet.mjs","names":[],"sources":["../../../src/predict/config/testnet.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { TESTNET_PREDICT } from '../../deployments/testnet.js';\nimport type { PredictConfig } from './types.js';\n\n/**\n * Testnet deployment constants, read from the shared generated record in\n * `src/deployments/` rather than transcribed here. `/account` and `/sessions` read slices of\n * that same record, so a redeploy (`pnpm sync-deployment`) moves every subpath together and\n * they cannot end up addressing different deployments.\n *\n * The record is generated from the deploy tooling's `deployment.testnet.json`; see\n * `scripts/sync-deployment.ts`. `getDeployment('testnet')` names the deployment and the\n * deepbookv3 commit these ids came from.\n */\nexport const TESTNET_CONFIG: PredictConfig = Object.freeze({\n\t// The record widens `network` to `string` so the published types don't pin a literal;\n\t// this file is the testnet config by construction.\n\tnetwork: 'testnet',\n\tpackages: TESTNET_PREDICT.packages,\n\tobjects: TESTNET_PREDICT.objects,\n\tquoteCoinType: TESTNET_PREDICT.quoteCoinType,\n\tcoinTypes: TESTNET_PREDICT.coinTypes,\n\tunits: TESTNET_PREDICT.units,\n\tunderlyings: TESTNET_PREDICT.underlyings,\n});\n"],"mappings":";;;;;;;;;;;;;AAgBA,MAAa,iBAAgC,OAAO,OAAO;CAG1D,SAAS;CACT,UAAU,gBAAgB;CAC1B,SAAS,gBAAgB;CACzB,eAAe,gBAAgB;CAC/B,WAAW,gBAAgB;CAC3B,OAAO,gBAAgB;CACvB,aAAa,gBAAgB;CAC7B,CAAC"}

package/dist/predict/config/types.d.mts

@@ -0,0 +1,55 @@
+//#region src/predict/config/types.d.ts
+/** The three published Move packages a Predict deployment spans. */
+interface PredictPackages {
+  predict: string;
+  account: string;
+  propbook: string;
+}
+/**
+ * Per-underlying oracle wiring: the propbook underlying id plus the feed object ids the
+ * live pricer reads. Names mirror the deployment manifest
+ * (`packages/predict/deployment/deployment.testnet.json` → `underlyings`).
+ */
+interface UnderlyingConfig {
+  symbol: string;
+  propbookUnderlyingId: number;
+  /** `&PythFeed` — spot price feed. */
+  pythFeed: string;
+  /** `&BlockScholesValueStore` — Black-Scholes value store. */
+  blockScholesValueStore: string;
+  /** `&BlockScholesSVIStore` — SVI-surface store. */
+  blockScholesSviStore: string;
+}
+/** Everything a tx builder or read needs to address a Predict deployment on one network. */
+interface PredictConfig {
+  network: 'testnet' | 'mainnet' | 'custom';
+  packages: PredictPackages;
+  objects: {
+    registry: string;
+    protocolConfig: string;
+    poolVault: string;
+    oracleRegistry: string;
+    accountRegistry: string;
+  };
+  quoteCoinType: string;
+  /**
+   * Coin types the deployment owns. `plp` is NOT derivable from `packages.predict`: a Move
+   * type tag keeps the ORIGINAL package id across an upgrade, while `packages.predict`
+   * moves to the latest.
+   */
+  coinTypes: {
+    plp: string;
+    deep: string;
+  };
+  /** Scale constants the deploy owns rather than the SDK. */
+  units: {
+    positionLotSize: number;
+    fixedPointScale: number;
+    quoteCoinDecimals: number;
+    positionQuantityDecimals: number;
+  };
+  underlyings: Record<string, UnderlyingConfig>;
+}
+//#endregion
+export { PredictConfig, PredictPackages, UnderlyingConfig };
+//# sourceMappingURL=types.d.mts.map

package/dist/predict/config/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/predict/config/types.ts"],"mappings":";;UAGiB,eAAA;EAChB,OAAA;EACA,OAAA;EACA,QAAA;AAAA;;;;;AAQD;UAAiB,gBAAA;EAChB,MAAA;EACA,oBAAA;EADA;EAGA,QAAA;EAAA;EAEA,sBAAA;EAEA;EAAA,oBAAA;AAAA;AAID;AAAA,UAAiB,aAAA;EAChB,OAAA;EACA,QAAA,EAAU,eAAA;EACV,OAAA;IACC,QAAA;IACA,cAAA;IACA,SAAA;IACA,cAAA;IACA,eAAA;EAAA;EAED,aAAA;EANC;;;;;EAYD,SAAA;IAAa,GAAA;IAAa,IAAA;EAAA;EAE1B;EAAA,KAAA;IACC,eAAA;IACA,eAAA;IACA,iBAAA;IACA,wBAAA;EAAA;EAED,WAAA,EAAa,MAAA,SAAe,gBAAA;AAAA"}

package/dist/predict/decode.d.mts

@@ -0,0 +1,162 @@
+//#region src/predict/decode.d.ts
+/** The slice of an executed/simulated transaction result the decoders need. */
+interface DecodableEvent {
+  /** Full type tag `0xpkg::module::Name` (gRPC `eventType`, legacy `type`). */
+  eventType?: string;
+  type?: string;
+  packageId?: string;
+  module?: string;
+  /** Struct name, when the transport supplies it separately from a full type tag. */
+  name?: string;
+  /** Canonical BCS payload; some transports deliver it base64-encoded. */
+  bcs?: Uint8Array | string;
+}
+interface DecodableTransactionResult {
+  events?: readonly DecodableEvent[] | null;
+}
+interface MintReceipt {
+  marketId: string;
+  accountId: string;
+  owner: string;
+  /** Persist this: required to redeem/claim the position later. */
+  orderId: bigint;
+  /** Stable across partial-close replacements; equals orderId at mint. */
+  positionRootId: bigint;
+  lowerTick: bigint;
+  higherTick: bigint;
+  /** 0..1 range probability quoted at entry (your fill price per $1 payout). */
+  entryProbability: number;
+  /** Max payout actually minted, in quote units (mintAmount: chain-floored). */
+  quantity: number;
+  /** Premium paid into LP backing, in quote units. */
+  premium: number;
+  /**
+   * Fee breakdown. `referral` is the slice of the trader-paid trading fee and
+   * congestion surcharge delivered to the referrer; `inventoryImpact` is the
+   * path-independent inventory-impact charge assessed on the mint.
+   */
+  fees: {
+    trading: number;
+    subsidy: number;
+    builder: number;
+    penalty: number;
+    referral: number;
+    inventoryImpact: number;
+  };
+  builderCodeId: string | null;
+  raw: {
+    quantity: bigint;
+    premium: bigint;
+    tradingFee: bigint;
+    feeIncentiveSubsidy: bigint;
+    builderFee: bigint;
+    penaltyFee: bigint;
+    referralFee: bigint;
+    inventoryImpactCharge: bigint;
+    entryProbability: bigint;
+  };
+}
+interface RedeemReceipt {
+  marketId: string;
+  accountId: string;
+  owner: string;
+  orderId: bigint;
+  positionRootId: bigint;
+  quantityClosed: number;
+  remaining: number;
+  /**
+   * A partial close RETIRES the old order id and issues this replacement for
+   * the remaining quantity — update your stored id or it goes silently stale.
+   */
+  replacementOrderId: bigint | null;
+  /** NET quote credited to the account: gross + inventoryImpactRebate − trading −
+   * builder − penalty — the same expression the chain asserts `min_proceeds`
+   * against, and what `settle_live_redeem_payment` actually deposits. */
+  proceeds: number;
+  /** Gross close value before fees (the event's redeem_amount). */
+  gross: number;
+  /**
+   * Fee breakdown. `inventoryImpactRebate` is the path-independent
+   * inventory-impact rebate credited back on the close.
+   */
+  fees: {
+    trading: number;
+    builder: number;
+    penalty: number;
+    inventoryImpactRebate: number;
+  };
+  builderCodeId: string | null;
+  raw: {
+    quantityClosed: bigint;
+    remaining: bigint;
+    proceeds: bigint;
+    gross: bigint;
+    tradingFee: bigint;
+    builderFee: bigint;
+    penaltyFee: bigint;
+    inventoryImpactRebate: bigint;
+  };
+}
+interface ClaimReceipt {
+  marketId: string;
+  accountId: string;
+  owner: string;
+  orderId: bigint;
+  positionRootId: bigint;
+  /** Quote units paid out. A settled claim closes the order in full. */
+  payout: number;
+  raw: {
+    payout: bigint;
+  };
+}
+interface CreateManagerReceipt {
+  accountId: string;
+  wrapperId: string;
+  owner: string;
+  selfOwned: boolean;
+}
+interface BalanceChangeReceipt {
+  accountId: string;
+  coinType: string;
+  /** Display value assuming a 6-decimal coin (quote + PLP both are). */
+  amount: number;
+  newBalance: number;
+  raw: {
+    amount: bigint;
+    newBalance: bigint;
+  };
+}
+interface PlpRequestReceipt {
+  kind: 'supply' | 'withdraw';
+  vaultId: string;
+  accountId: string;
+  recipient: string;
+  /** Feed straight into cancelSupplyPlp / cancelWithdrawPlp. */
+  index: bigint;
+  /** Quote units for supply; PLP shares (6-dec) for withdraw. */
+  amount: number;
+  raw: {
+    amount: bigint;
+  };
+}
+interface PlpCancelReceipt {
+  vaultId: string;
+  accountId: string;
+  recipient: string;
+  index: bigint;
+  isSupply: boolean;
+  /** Refund returned to the account (quote for supply, PLP for withdraw). */
+  amount: number;
+  raw: {
+    amount: bigint;
+  };
+}
+interface BuilderCodeReceipt {
+  accountId: string;
+  owner: string;
+  /** Null after unsetBuilderCode. */
+  builderCodeId: string | null;
+}
+//#endregion
+export { BalanceChangeReceipt, BuilderCodeReceipt, ClaimReceipt, CreateManagerReceipt, DecodableEvent, DecodableTransactionResult, MintReceipt, PlpCancelReceipt, PlpRequestReceipt, RedeemReceipt };
+//# sourceMappingURL=decode.d.mts.map

package/dist/predict/decode.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode.d.mts","names":[],"sources":["../../src/predict/decode.ts"],"mappings":";AA2BA;AAAA,UAAiB,cAAA;;EAEhB,SAAA;EACA,IAAA;EACA,SAAA;EACA,MAAA;EAAA;EAEA,IAAA;EAEA;EAAA,GAAA,GAAM,UAAA;AAAA;AAAA,UAGU,0BAAA;EAChB,MAAA,YAAkB,cAAA;AAAA;AAAA,UAkEF,WAAA;EAChB,QAAA;EACA,SAAA;EACA,KAAA;;EAEA,OAAA;EAJA;EAMA,cAAA;EACA,SAAA;EACA,UAAA;EAFA;EAIA,gBAAA;EAFA;EAIA,QAAA;EAAA;EAEA,OAAA;EAMA;;;;;EAAA,IAAA;IACC,OAAA;IACA,OAAA;IACA,OAAA;IACA,OAAA;IACA,QAAA;IACA,eAAA;EAAA;EAED,aAAA;EACA,GAAA;IACC,QAAA;IACA,OAAA;IACA,UAAA;IACA,mBAAA;IACA,UAAA;IACA,UAAA;IACA,WAAA;IACA,qBAAA;IACA,gBAAA;EAAA;AAAA;AAAA,UAIe,aAAA;EAChB,QAAA;EACA,SAAA;EACA,KAAA;EACA,OAAA;EACA,cAAA;EACA,cAAA;EACA,SAAA;EAgBA;;;;EAXA,kBAAA;EAYA;;;EARA,QAAA;EAYC;EAVD,KAAA;EAYC;;;;EAPD,IAAA;IAAQ,OAAA;IAAiB,OAAA;IAAiB,OAAA;IAAiB,qBAAA;EAAA;EAC3D,aAAA;EACA,GAAA;IACC,cAAA;IACA,SAAA;IACA,QAAA;IACA,KAAA;IACA,UAAA;IACA,UAAA;IACA,UAAA;IACA,qBAAA;EAAA;AAAA;AAAA,UAIe,YAAA;EAChB,QAAA;EACA,SAAA;EACA,KAAA;EACA,OAAA;EACA,cAAA;EAUS;EART,MAAA;EACA,GAAA;IAAO,MAAA;EAAA;AAAA;AAAA,UAGS,oBAAA;EAChB,SAAA;EACA,SAAA;EACA,KAAA;EACA,SAAA;AAAA;AAAA,UAGgB,oBAAA;EAChB,SAAA;EACA,QAAA;EAOgB;EALhB,MAAA;EACA,UAAA;EACA,GAAA;IAAO,MAAA;IAAgB,UAAA;EAAA;AAAA;AAAA,UAGP,iBAAA;EAChB,IAAA;EACA,OAAA;EACA,SAAA;EACA,SAAA;EAKa;EAHb,KAAA;EAMgC;EAJhC,MAAA;EACA,GAAA;IAAO,MAAA;EAAA;AAAA;AAAA,UAGS,gBAAA;EAChB,OAAA;EACA,SAAA;EACA,SAAA;EACA,KAAA;EACA,QAAA;EAGa;EADb,MAAA;EACA,GAAA;IAAO,MAAA;EAAA;AAAA;AAAA,UAGS,kBAAA;EAChB,SAAA;EACA,KAAA;EAEa;EAAb,aAAA;AAAA"}

package/dist/predict/decode.mjs

@@ -0,0 +1,175 @@
+import { AccountCreated, Deposited, Withdrawn } from "../contracts/account/account_events.mjs";
+import { BuilderCodeSet } from "../contracts/deepbook_predict/builder_code_events.mjs";
+import { LiveOrderRedeemed, OrderMinted, SettledOrderRedeemed } from "../contracts/deepbook_predict/order_events.mjs";
+import { RequestCancelled, SupplyRequested, WithdrawRequested } from "../contracts/deepbook_predict/vault_events.mjs";
+import { PredictInputError } from "./errors.mjs";
+import { fromRaw } from "./units.mjs";
+import { fromBase64, normalizeSuiAddress } from "@mysten/sui/utils";
+
+//#region src/predict/decode.ts
+function eventBytes(e) {
+	if (e.bcs instanceof Uint8Array) return e.bcs;
+	if (typeof e.bcs === "string") return fromBase64(e.bcs);
+	return null;
+}
+function matches(e, pkg, module, name) {
+	const tag = e.eventType ?? e.type;
+	if (tag) {
+		const parts = tag.split("::");
+		if (parts.length !== 3) return false;
+		return normalizeSuiAddress(parts[0]) === normalizeSuiAddress(pkg) && parts[1] === module && parts[2] === name;
+	}
+	if (e.module !== module || e.packageId == null) return false;
+	if (normalizeSuiAddress(e.packageId) !== normalizeSuiAddress(pkg)) return false;
+	return e.name == null || e.name === name;
+}
+function decodeAll(result, pkg, module, name, layout) {
+	const out = [];
+	for (const e of result.events ?? []) {
+		if (!matches(e, pkg, module, name)) continue;
+		const bytes = eventBytes(e);
+		if (!bytes) throw new PredictInputError(`${module}::${name} event has no BCS payload — execute/simulate with events included`);
+		out.push(layout.parse(bytes));
+	}
+	return out;
+}
+function exactlyOne(items, what) {
+	if (items.length !== 1) throw new PredictInputError(`expected exactly one ${what} event, found ${items.length}`);
+	return items[0];
+}
+const optId = (v) => v == null ? null : normalizeSuiAddress(v);
+function decodeMints(cfg, result) {
+	return decodeAll(result, cfg.packages.predict, "order_events", "OrderMinted", OrderMinted).map((e) => ({
+		marketId: normalizeSuiAddress(e.expiry_market_id),
+		accountId: normalizeSuiAddress(e.account_id),
+		owner: normalizeSuiAddress(e.owner),
+		orderId: e.order_id,
+		positionRootId: e.position_root_id,
+		lowerTick: e.lower_tick,
+		higherTick: e.higher_tick,
+		entryProbability: fromRaw(e.entry_probability, 9),
+		quantity: fromRaw(e.quantity, 6),
+		premium: fromRaw(e.premium, 6),
+		fees: {
+			trading: fromRaw(e.trading_fee, 6),
+			subsidy: fromRaw(e.fee_incentive_subsidy, 6),
+			builder: fromRaw(e.builder_fee, 6),
+			penalty: fromRaw(e.penalty_fee, 6),
+			referral: fromRaw(e.referral_fee, 6),
+			inventoryImpact: fromRaw(e.inventory_impact_charge, 6)
+		},
+		builderCodeId: optId(e.builder_code_id),
+		raw: {
+			quantity: e.quantity,
+			premium: e.premium,
+			tradingFee: e.trading_fee,
+			feeIncentiveSubsidy: e.fee_incentive_subsidy,
+			builderFee: e.builder_fee,
+			penaltyFee: e.penalty_fee,
+			referralFee: e.referral_fee,
+			inventoryImpactCharge: e.inventory_impact_charge,
+			entryProbability: e.entry_probability
+		}
+	}));
+}
+function decodeRedeems(cfg, result) {
+	const pkg = cfg.packages.predict;
+	return decodeAll(result, pkg, "order_events", "LiveOrderRedeemed", LiveOrderRedeemed).map((e) => ({
+		marketId: normalizeSuiAddress(e.expiry_market_id),
+		accountId: normalizeSuiAddress(e.account_id),
+		owner: normalizeSuiAddress(e.owner),
+		orderId: e.order_id,
+		positionRootId: e.position_root_id,
+		quantityClosed: fromRaw(e.quantity_closed, 6),
+		remaining: fromRaw(e.remaining_quantity, 6),
+		replacementOrderId: e.replacement_order_id,
+		proceeds: fromRaw(e.redeem_amount + e.inventory_impact_rebate - e.trading_fee - e.builder_fee - e.penalty_fee, 6),
+		gross: fromRaw(e.redeem_amount, 6),
+		fees: {
+			trading: fromRaw(e.trading_fee, 6),
+			builder: fromRaw(e.builder_fee, 6),
+			penalty: fromRaw(e.penalty_fee, 6),
+			inventoryImpactRebate: fromRaw(e.inventory_impact_rebate, 6)
+		},
+		builderCodeId: optId(e.builder_code_id),
+		raw: {
+			quantityClosed: e.quantity_closed,
+			remaining: e.remaining_quantity,
+			proceeds: e.redeem_amount + e.inventory_impact_rebate - e.trading_fee - e.builder_fee - e.penalty_fee,
+			gross: e.redeem_amount,
+			tradingFee: e.trading_fee,
+			builderFee: e.builder_fee,
+			penaltyFee: e.penalty_fee,
+			inventoryImpactRebate: e.inventory_impact_rebate
+		}
+	}));
+}
+function decodeClaims(cfg, result) {
+	return decodeAll(result, cfg.packages.predict, "order_events", "SettledOrderRedeemed", SettledOrderRedeemed).map((e) => ({
+		marketId: normalizeSuiAddress(e.expiry_market_id),
+		accountId: normalizeSuiAddress(e.account_id),
+		owner: normalizeSuiAddress(e.owner),
+		orderId: e.order_id,
+		positionRootId: e.position_root_id,
+		payout: fromRaw(e.payout_amount, 6),
+		raw: { payout: e.payout_amount }
+	}));
+}
+function decodeAccountsCreated(cfg, result) {
+	return decodeAll(result, cfg.packages.account, "account_events", "AccountCreated", AccountCreated).map((e) => ({
+		accountId: normalizeSuiAddress(e.account_id),
+		wrapperId: normalizeSuiAddress(e.wrapper_id),
+		owner: normalizeSuiAddress(e.owner),
+		selfOwned: e.self_owned
+	}));
+}
+function decodeBalanceChanges(cfg, result, name) {
+	const layout = name === "Deposited" ? Deposited : Withdrawn;
+	return decodeAll(result, cfg.packages.account, "account_events", name, layout).map((e) => ({
+		accountId: normalizeSuiAddress(e.account_id),
+		coinType: e.coin_type,
+		amount: fromRaw(e.amount, 6),
+		newBalance: fromRaw(e.new_balance, 6),
+		raw: {
+			amount: e.amount,
+			newBalance: e.new_balance
+		}
+	}));
+}
+const decodeDeposits = (cfg, result) => decodeBalanceChanges(cfg, result, "Deposited");
+const decodeWithdrawals = (cfg, result) => decodeBalanceChanges(cfg, result, "Withdrawn");
+function decodePlpRequests(cfg, result) {
+	const pkg = cfg.packages.predict;
+	const make = (kind) => (e) => ({
+		kind,
+		vaultId: normalizeSuiAddress(e.pool_vault_id),
+		accountId: normalizeSuiAddress(e.account_id),
+		recipient: normalizeSuiAddress(e.recipient),
+		index: e.index,
+		amount: fromRaw(e.amount, 6),
+		raw: { amount: e.amount }
+	});
+	return [...decodeAll(result, pkg, "vault_events", "SupplyRequested", SupplyRequested).map(make("supply")), ...decodeAll(result, pkg, "vault_events", "WithdrawRequested", WithdrawRequested).map(make("withdraw"))];
+}
+function decodePlpCancels(cfg, result) {
+	return decodeAll(result, cfg.packages.predict, "vault_events", "RequestCancelled", RequestCancelled).map((e) => ({
+		vaultId: normalizeSuiAddress(e.pool_vault_id),
+		accountId: normalizeSuiAddress(e.account_id),
+		recipient: normalizeSuiAddress(e.recipient),
+		index: e.index,
+		isSupply: e.is_supply,
+		amount: fromRaw(e.amount, 6),
+		raw: { amount: e.amount }
+	}));
+}
+function decodeBuilderCodeSets(cfg, result) {
+	return decodeAll(result, cfg.packages.predict, "builder_code_events", "BuilderCodeSet", BuilderCodeSet).map((e) => ({
+		accountId: normalizeSuiAddress(e.account_id),
+		owner: normalizeSuiAddress(e.owner),
+		builderCodeId: optId(e.builder_code_id)
+	}));
+}
+
+//#endregion
+export { decodeAccountsCreated, decodeBuilderCodeSets, decodeClaims, decodeDeposits, decodeMints, decodePlpCancels, decodePlpRequests, decodeRedeems, decodeWithdrawals, exactlyOne };
+//# sourceMappingURL=decode.mjs.map

package/dist/predict/decode.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode.mjs","names":["orderEvents.OrderMinted","orderEvents.LiveOrderRedeemed","orderEvents.SettledOrderRedeemed","accountEvents.AccountCreated","accountEvents.Deposited","accountEvents.Withdrawn","vaultEvents.SupplyRequested","vaultEvents.WithdrawRequested","vaultEvents.RequestCancelled","builderCodeEvents.BuilderCodeSet"],"sources":["../../src/predict/decode.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\nimport { fromBase64, normalizeSuiAddress } from '@mysten/sui/utils';\nimport type { PredictConfig } from './config/index.js';\nimport { accountEvents } from '../account.js';\nimport * as builderCodeEvents from '../contracts/deepbook_predict/builder_code_events.js';\nimport * as orderEvents from '../contracts/deepbook_predict/order_events.js';\nimport * as vaultEvents from '../contracts/deepbook_predict/vault_events.js';\nimport { PredictInputError } from './errors.js';\nimport { fromRaw } from './units.js';\n\n// ============================================================================\n// Execution-result decoders.\n//\n// Every tx.* builder returns a Transaction; after the app executes it (with\n// events included), the deployed contracts emit typed events carrying the full\n// receipt — order ids, fills, fees, queue indexes, new balances. These pure\n// functions turn that result into typed receipts. No network, no client.\n//\n// Decoding uses each event's BCS bytes, not its `json`: the client typings\n// warn the JSON rendering varies across transports (JSON-RPC/gRPC/GraphQL),\n// while BCS is canonical. Layouts come from the GENERATED event MoveStructs\n// (src/contracts/{deepbook_predict,account}/*_events.ts), whose field order\n// mirrors the deployed Move — regenerate the bindings if the package changes.\n// ============================================================================\n\n/** The slice of an executed/simulated transaction result the decoders need. */\nexport interface DecodableEvent {\n\t/** Full type tag `0xpkg::module::Name` (gRPC `eventType`, legacy `type`). */\n\teventType?: string;\n\ttype?: string;\n\tpackageId?: string;\n\tmodule?: string;\n\t/** Struct name, when the transport supplies it separately from a full type tag. */\n\tname?: string;\n\t/** Canonical BCS payload; some transports deliver it base64-encoded. */\n\tbcs?: Uint8Array | string;\n}\n\nexport interface DecodableTransactionResult {\n\tevents?: readonly DecodableEvent[] | null;\n}\n\n// --- matching + plumbing ----------------------------------------------------\n\nfunction eventBytes(e: DecodableEvent): Uint8Array | null {\n\tif (e.bcs instanceof Uint8Array) return e.bcs;\n\tif (typeof e.bcs === 'string') return fromBase64(e.bcs);\n\treturn null;\n}\n\n// Match by defining package + module + struct name. Events are typed by the\n// ORIGINAL package id; for the current v1 deployments that equals the config\n// package id.\nfunction matches(e: DecodableEvent, pkg: string, module: string, name: string): boolean {\n\tconst tag = e.eventType ?? e.type;\n\tif (tag) {\n\t\tconst parts = tag.split('::');\n\t\tif (parts.length !== 3) return false;\n\t\treturn (\n\t\t\tnormalizeSuiAddress(parts[0]) === normalizeSuiAddress(pkg) &&\n\t\t\tparts[1] === module &&\n\t\t\tparts[2] === name\n\t\t);\n\t}\n\t// No type tag. Match on what the transport did give us — and on `name` when it is\n\t// present, because module+package alone matches EVERY struct in the module, so one\n\t// decoder would happily take another's event and fail deep inside BCS.\n\tif (e.module !== module || e.packageId == null) return false;\n\tif (normalizeSuiAddress(e.packageId) !== normalizeSuiAddress(pkg)) return false;\n\treturn e.name == null || e.name === name;\n}\n\nfunction decodeAll<T>(\n\tresult: DecodableTransactionResult,\n\tpkg: string,\n\tmodule: string,\n\tname: string,\n\tlayout: { parse(bytes: Uint8Array): T },\n): T[] {\n\tconst out: T[] = [];\n\tfor (const e of result.events ?? []) {\n\t\tif (!matches(e, pkg, module, name)) continue;\n\t\tconst bytes = eventBytes(e);\n\t\tif (!bytes) {\n\t\t\tthrow new PredictInputError(\n\t\t\t\t`${module}::${name} event has no BCS payload — execute/simulate with events included`,\n\t\t\t);\n\t\t}\n\t\tout.push(layout.parse(bytes));\n\t}\n\treturn out;\n}\n\nfunction exactlyOne<T>(items: T[], what: string): T {\n\tif (items.length !== 1) {\n\t\tthrow new PredictInputError(`expected exactly one ${what} event, found ${items.length}`);\n\t}\n\treturn items[0];\n}\n\nconst optId = (v: string | null | undefined): string | null =>\n\tv == null ? null : normalizeSuiAddress(v);\n\n// --- receipts ---------------------------------------------------------------\n\nexport interface MintReceipt {\n\tmarketId: string;\n\taccountId: string;\n\towner: string;\n\t/** Persist this: required to redeem/claim the position later. */\n\torderId: bigint;\n\t/** Stable across partial-close replacements; equals orderId at mint. */\n\tpositionRootId: bigint;\n\tlowerTick: bigint;\n\thigherTick: bigint;\n\t/** 0..1 range probability quoted at entry (your fill price per $1 payout). */\n\tentryProbability: number;\n\t/** Max payout actually minted, in quote units (mintAmount: chain-floored). */\n\tquantity: number;\n\t/** Premium paid into LP backing, in quote units. */\n\tpremium: number;\n\t/**\n\t * Fee breakdown. `referral` is the slice of the trader-paid trading fee and\n\t * congestion surcharge delivered to the referrer; `inventoryImpact` is the\n\t * path-independent inventory-impact charge assessed on the mint.\n\t */\n\tfees: {\n\t\ttrading: number;\n\t\tsubsidy: number;\n\t\tbuilder: number;\n\t\tpenalty: number;\n\t\treferral: number;\n\t\tinventoryImpact: number;\n\t};\n\tbuilderCodeId: string | null;\n\traw: {\n\t\tquantity: bigint;\n\t\tpremium: bigint;\n\t\ttradingFee: bigint;\n\t\tfeeIncentiveSubsidy: bigint;\n\t\tbuilderFee: bigint;\n\t\tpenaltyFee: bigint;\n\t\treferralFee: bigint;\n\t\tinventoryImpactCharge: bigint;\n\t\tentryProbability: bigint;\n\t};\n}\n\nexport interface RedeemReceipt {\n\tmarketId: string;\n\taccountId: string;\n\towner: string;\n\torderId: bigint;\n\tpositionRootId: bigint;\n\tquantityClosed: number;\n\tremaining: number;\n\t/**\n\t * A partial close RETIRES the old order id and issues this replacement for\n\t * the remaining quantity — update your stored id or it goes silently stale.\n\t */\n\treplacementOrderId: bigint | null;\n\t/** NET quote credited to the account: gross + inventoryImpactRebate − trading −\n\t * builder − penalty — the same expression the chain asserts `min_proceeds`\n\t * against, and what `settle_live_redeem_payment` actually deposits. */\n\tproceeds: number;\n\t/** Gross close value before fees (the event's redeem_amount). */\n\tgross: number;\n\t/**\n\t * Fee breakdown. `inventoryImpactRebate` is the path-independent\n\t * inventory-impact rebate credited back on the close.\n\t */\n\tfees: { trading: number; builder: number; penalty: number; inventoryImpactRebate: number };\n\tbuilderCodeId: string | null;\n\traw: {\n\t\tquantityClosed: bigint;\n\t\tremaining: bigint;\n\t\tproceeds: bigint;\n\t\tgross: bigint;\n\t\ttradingFee: bigint;\n\t\tbuilderFee: bigint;\n\t\tpenaltyFee: bigint;\n\t\tinventoryImpactRebate: bigint;\n\t};\n}\n\nexport interface ClaimReceipt {\n\tmarketId: string;\n\taccountId: string;\n\towner: string;\n\torderId: bigint;\n\tpositionRootId: bigint;\n\t/** Quote units paid out. A settled claim closes the order in full. */\n\tpayout: number;\n\traw: { payout: bigint };\n}\n\nexport interface CreateManagerReceipt {\n\taccountId: string;\n\twrapperId: string;\n\towner: string;\n\tselfOwned: boolean;\n}\n\nexport interface BalanceChangeReceipt {\n\taccountId: string;\n\tcoinType: string;\n\t/** Display value assuming a 6-decimal coin (quote + PLP both are). */\n\tamount: number;\n\tnewBalance: number;\n\traw: { amount: bigint; newBalance: bigint };\n}\n\nexport interface PlpRequestReceipt {\n\tkind: 'supply' | 'withdraw';\n\tvaultId: string;\n\taccountId: string;\n\trecipient: string;\n\t/** Feed straight into cancelSupplyPlp / cancelWithdrawPlp. */\n\tindex: bigint;\n\t/** Quote units for supply; PLP shares (6-dec) for withdraw. */\n\tamount: number;\n\traw: { amount: bigint };\n}\n\nexport interface PlpCancelReceipt {\n\tvaultId: string;\n\taccountId: string;\n\trecipient: string;\n\tindex: bigint;\n\tisSupply: boolean;\n\t/** Refund returned to the account (quote for supply, PLP for withdraw). */\n\tamount: number;\n\traw: { amount: bigint };\n}\n\nexport interface BuilderCodeReceipt {\n\taccountId: string;\n\towner: string;\n\t/** Null after unsetBuilderCode. */\n\tbuilderCodeId: string | null;\n}\n\n// --- decoders (plural = all matching events, in event order) ----------------\n\nexport function decodeMints(cfg: PredictConfig, result: DecodableTransactionResult): MintReceipt[] {\n\treturn decodeAll(\n\t\tresult,\n\t\tcfg.packages.predict,\n\t\t'order_events',\n\t\t'OrderMinted',\n\t\torderEvents.OrderMinted,\n\t).map((e) => ({\n\t\tmarketId: normalizeSuiAddress(e.expiry_market_id),\n\t\taccountId: normalizeSuiAddress(e.account_id),\n\t\towner: normalizeSuiAddress(e.owner),\n\t\torderId: e.order_id,\n\t\tpositionRootId: e.position_root_id,\n\t\tlowerTick: e.lower_tick,\n\t\thigherTick: e.higher_tick,\n\t\tentryProbability: fromRaw(e.entry_probability, 9),\n\t\tquantity: fromRaw(e.quantity, 6),\n\t\tpremium: fromRaw(e.premium, 6),\n\t\tfees: {\n\t\t\ttrading: fromRaw(e.trading_fee, 6),\n\t\t\tsubsidy: fromRaw(e.fee_incentive_subsidy, 6),\n\t\t\tbuilder: fromRaw(e.builder_fee, 6),\n\t\t\tpenalty: fromRaw(e.penalty_fee, 6),\n\t\t\treferral: fromRaw(e.referral_fee, 6),\n\t\t\tinventoryImpact: fromRaw(e.inventory_impact_charge, 6),\n\t\t},\n\t\tbuilderCodeId: optId(e.builder_code_id),\n\t\traw: {\n\t\t\tquantity: e.quantity,\n\t\t\tpremium: e.premium,\n\t\t\ttradingFee: e.trading_fee,\n\t\t\tfeeIncentiveSubsidy: e.fee_incentive_subsidy,\n\t\t\tbuilderFee: e.builder_fee,\n\t\t\tpenaltyFee: e.penalty_fee,\n\t\t\treferralFee: e.referral_fee,\n\t\t\tinventoryImpactCharge: e.inventory_impact_charge,\n\t\t\tentryProbability: e.entry_probability,\n\t\t},\n\t}));\n}\n\nexport function decodeRedeems(\n\tcfg: PredictConfig,\n\tresult: DecodableTransactionResult,\n): RedeemReceipt[] {\n\tconst pkg = cfg.packages.predict;\n\tconst live = decodeAll(\n\t\tresult,\n\t\tpkg,\n\t\t'order_events',\n\t\t'LiveOrderRedeemed',\n\t\torderEvents.LiveOrderRedeemed,\n\t).map((e): RedeemReceipt => ({\n\t\tmarketId: normalizeSuiAddress(e.expiry_market_id),\n\t\taccountId: normalizeSuiAddress(e.account_id),\n\t\towner: normalizeSuiAddress(e.owner),\n\t\torderId: e.order_id,\n\t\tpositionRootId: e.position_root_id,\n\t\tquantityClosed: fromRaw(e.quantity_closed, 6),\n\t\tremaining: fromRaw(e.remaining_quantity, 6),\n\t\treplacementOrderId: e.replacement_order_id,\n\t\t// Mirrors the deployed close-side accounting exactly (the same expression\n\t\t// `min_proceeds` is asserted against): the net credited to the account is\n\t\t// redeem_amount PLUS the inventory-impact rebate, minus trading, builder and\n\t\t// penalty fees. The event's redeem_amount is GROSS.\n\t\tproceeds: fromRaw(\n\t\t\te.redeem_amount + e.inventory_impact_rebate - e.trading_fee - e.builder_fee - e.penalty_fee,\n\t\t\t6,\n\t\t),\n\t\tgross: fromRaw(e.redeem_amount, 6),\n\t\tfees: {\n\t\t\ttrading: fromRaw(e.trading_fee, 6),\n\t\t\tbuilder: fromRaw(e.builder_fee, 6),\n\t\t\tpenalty: fromRaw(e.penalty_fee, 6),\n\t\t\tinventoryImpactRebate: fromRaw(e.inventory_impact_rebate, 6),\n\t\t},\n\t\tbuilderCodeId: optId(e.builder_code_id),\n\t\traw: {\n\t\t\tquantityClosed: e.quantity_closed,\n\t\t\tremaining: e.remaining_quantity,\n\t\t\tproceeds:\n\t\t\t\te.redeem_amount + e.inventory_impact_rebate - e.trading_fee - e.builder_fee - e.penalty_fee,\n\t\t\tgross: e.redeem_amount,\n\t\t\ttradingFee: e.trading_fee,\n\t\t\tbuilderFee: e.builder_fee,\n\t\t\tpenaltyFee: e.penalty_fee,\n\t\t\tinventoryImpactRebate: e.inventory_impact_rebate,\n\t\t},\n\t}));\n\treturn live;\n}\n\nexport function decodeClaims(\n\tcfg: PredictConfig,\n\tresult: DecodableTransactionResult,\n): ClaimReceipt[] {\n\treturn decodeAll(\n\t\tresult,\n\t\tcfg.packages.predict,\n\t\t'order_events',\n\t\t'SettledOrderRedeemed',\n\t\torderEvents.SettledOrderRedeemed,\n\t).map((e) => ({\n\t\tmarketId: normalizeSuiAddress(e.expiry_market_id),\n\t\taccountId: normalizeSuiAddress(e.account_id),\n\t\towner: normalizeSuiAddress(e.owner),\n\t\torderId: e.order_id,\n\t\tpositionRootId: e.position_root_id,\n\t\tpayout: fromRaw(e.payout_amount, 6),\n\t\traw: { payout: e.payout_amount },\n\t}));\n}\n\nexport function decodeAccountsCreated(\n\tcfg: PredictConfig,\n\tresult: DecodableTransactionResult,\n): CreateManagerReceipt[] {\n\treturn decodeAll(\n\t\tresult,\n\t\tcfg.packages.account,\n\t\t'account_events',\n\t\t'AccountCreated',\n\t\taccountEvents.AccountCreated,\n\t).map((e) => ({\n\t\taccountId: normalizeSuiAddress(e.account_id),\n\t\twrapperId: normalizeSuiAddress(e.wrapper_id),\n\t\towner: normalizeSuiAddress(e.owner),\n\t\tselfOwned: e.self_owned,\n\t}));\n}\n\nfunction decodeBalanceChanges(\n\tcfg: PredictConfig,\n\tresult: DecodableTransactionResult,\n\tname: 'Deposited' | 'Withdrawn',\n): BalanceChangeReceipt[] {\n\tconst layout = name === 'Deposited' ? accountEvents.Deposited : accountEvents.Withdrawn;\n\treturn decodeAll(result, cfg.packages.account, 'account_events', name, layout).map((e) => ({\n\t\taccountId: normalizeSuiAddress(e.account_id),\n\t\tcoinType: e.coin_type,\n\t\tamount: fromRaw(e.amount, 6),\n\t\tnewBalance: fromRaw(e.new_balance, 6),\n\t\traw: { amount: e.amount, newBalance: e.new_balance },\n\t}));\n}\n\nexport const decodeDeposits = (\n\tcfg: PredictConfig,\n\tresult: DecodableTransactionResult,\n): BalanceChangeReceipt[] => decodeBalanceChanges(cfg, result, 'Deposited');\n\nexport const decodeWithdrawals = (\n\tcfg: PredictConfig,\n\tresult: DecodableTransactionResult,\n): BalanceChangeReceipt[] => decodeBalanceChanges(cfg, result, 'Withdrawn');\n\nexport function decodePlpRequests(\n\tcfg: PredictConfig,\n\tresult: DecodableTransactionResult,\n): PlpRequestReceipt[] {\n\tconst pkg = cfg.packages.predict;\n\t// Supply/WithdrawRequested differ only in their min-out field (unused here);\n\t// pick the fields both share so either generated struct's parse feeds `make`.\n\ttype RequestedCommon = Pick<\n\t\t(typeof vaultEvents.SupplyRequested)['$inferType'],\n\t\t'pool_vault_id' | 'account_id' | 'recipient' | 'index' | 'amount'\n\t>;\n\tconst make =\n\t\t(kind: 'supply' | 'withdraw') =>\n\t\t(e: RequestedCommon): PlpRequestReceipt => ({\n\t\t\tkind,\n\t\t\tvaultId: normalizeSuiAddress(e.pool_vault_id),\n\t\t\taccountId: normalizeSuiAddress(e.account_id),\n\t\t\trecipient: normalizeSuiAddress(e.recipient),\n\t\t\tindex: e.index,\n\t\t\tamount: fromRaw(e.amount, 6),\n\t\t\traw: { amount: e.amount },\n\t\t});\n\treturn [\n\t\t...decodeAll(result, pkg, 'vault_events', 'SupplyRequested', vaultEvents.SupplyRequested).map(\n\t\t\tmake('supply'),\n\t\t),\n\t\t...decodeAll(\n\t\t\tresult,\n\t\t\tpkg,\n\t\t\t'vault_events',\n\t\t\t'WithdrawRequested',\n\t\t\tvaultEvents.WithdrawRequested,\n\t\t).map(make('withdraw')),\n\t];\n}\n\nexport function decodePlpCancels(\n\tcfg: PredictConfig,\n\tresult: DecodableTransactionResult,\n): PlpCancelReceipt[] {\n\treturn decodeAll(\n\t\tresult,\n\t\tcfg.packages.predict,\n\t\t'vault_events',\n\t\t'RequestCancelled',\n\t\tvaultEvents.RequestCancelled,\n\t).map((e) => ({\n\t\tvaultId: normalizeSuiAddress(e.pool_vault_id),\n\t\taccountId: normalizeSuiAddress(e.account_id),\n\t\trecipient: normalizeSuiAddress(e.recipient),\n\t\tindex: e.index,\n\t\tisSupply: e.is_supply,\n\t\tamount: fromRaw(e.amount, 6),\n\t\traw: { amount: e.amount },\n\t}));\n}\n\nexport function decodeBuilderCodeSets(\n\tcfg: PredictConfig,\n\tresult: DecodableTransactionResult,\n): BuilderCodeReceipt[] {\n\treturn decodeAll(\n\t\tresult,\n\t\tcfg.packages.predict,\n\t\t'builder_code_events',\n\t\t'BuilderCodeSet',\n\t\tbuilderCodeEvents.BuilderCodeSet,\n\t).map((e) => ({\n\t\taccountId: normalizeSuiAddress(e.account_id),\n\t\towner: normalizeSuiAddress(e.owner),\n\t\tbuilderCodeId: optId(e.builder_code_id),\n\t}));\n}\n\nexport { exactlyOne };\n"],"mappings":"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"}

package/dist/predict/errors.d.mts

@@ -0,0 +1,42 @@
+//#region src/predict/errors.d.ts
+/** A caller-supplied argument the SDK rejected before building/sending a tx. */
+declare class PredictInputError extends Error {
+  constructor(message: string);
+}
+/** A Move `abort` decoded from a simulate/read failure. */
+declare class PredictMoveError extends Error {
+  readonly module: string;
+  /** Exact u64 abort code — bigint because clever-error encodings pack data
+   * into the high bits, which Number would silently truncate. */
+  readonly code: bigint;
+  /** The `E…` constant name, decoded from the clever-error abort code by the
+   * fullnode, or null when the transport surfaced no name (a non-clever abort,
+   * or a JSON-RPC failure that carries only a line number). */
+  readonly abortName: string | null;
+  constructor(module: string, code: bigint, abortName: string | null);
+}
+interface MoveAbortError {
+  MoveAbort?: {
+    abortCode?: string | number | bigint;
+    location?: {
+      module?: string;
+    };
+    cleverError?: {
+      constantName?: string;
+    };
+  };
+}
+/**
+ * Decode a `@mysten/sui` MoveAbort execution error into a {@link PredictMoveError}.
+ * Returns null when `error` carries no MoveAbort (InsufficientGas, a size error, any
+ * non-abort failure), so callers can fall back to a plain Error.
+ *
+ * `abortName` is taken straight from the chain-decoded clever-error constant; it is
+ * null when the abort predates clever errors or the transport didn't surface a name.
+ * `code` stays a bigint — a clever-error abort code packs the module, line, and
+ * constant index into the high bits of the u64 and would lose precision as a Number.
+ */
+declare function decodeMoveAbort(error: MoveAbortError | null | undefined): PredictMoveError | null;
+//#endregion
+export { MoveAbortError, PredictInputError, PredictMoveError, decodeMoveAbort };
+//# sourceMappingURL=errors.d.mts.map

package/dist/predict/errors.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.mts","names":[],"sources":["../../src/predict/errors.ts"],"mappings":";;cAca,iBAAA,SAA0B,KAAA;cAC1B,OAAA;AAAA;;cAOA,gBAAA,SAAyB,KAAA;EAAA,SAC5B,MAAA;EARG;;EAAA,SAWH,IAAA;EAJG;;;EAAA,SAQH,SAAA;cAEG,MAAA,UAAgB,IAAA,UAAc,SAAA;AAAA;AAAA,UAyB1B,cAAA;EAChB,SAAA;IACC,SAAA;IACA,QAAA;MAAa,MAAA;IAAA;IACb,WAAA;MAAgB,YAAA;IAAA;EAAA;AAAA;;;;;;;;;;AAclB;iBAAgB,eAAA,CAAgB,KAAA,EAAO,cAAA,sBAAoC,gBAAA"}

package/dist/predict/errors.mjs

@@ -0,0 +1,37 @@
+//#region src/predict/errors.ts
+/** A caller-supplied argument the SDK rejected before building/sending a tx. */
+var PredictInputError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "PredictInputError";
+	}
+};
+/** A Move `abort` decoded from a simulate/read failure. */
+var PredictMoveError = class extends Error {
+	constructor(module, code, abortName) {
+		super(abortName ? `Move abort in ${module}: ${abortName} (code ${code})` : `Move abort in ${module}: code ${code}`);
+		this.name = "PredictMoveError";
+		this.module = module;
+		this.code = code;
+		this.abortName = abortName;
+	}
+};
+/**
+* Decode a `@mysten/sui` MoveAbort execution error into a {@link PredictMoveError}.
+* Returns null when `error` carries no MoveAbort (InsufficientGas, a size error, any
+* non-abort failure), so callers can fall back to a plain Error.
+*
+* `abortName` is taken straight from the chain-decoded clever-error constant; it is
+* null when the abort predates clever errors or the transport didn't surface a name.
+* `code` stays a bigint — a clever-error abort code packs the module, line, and
+* constant index into the high bits of the u64 and would lose precision as a Number.
+*/
+function decodeMoveAbort(error) {
+	const abort = error?.MoveAbort;
+	if (!abort) return null;
+	return new PredictMoveError(abort.location?.module ?? "", abort.abortCode != null ? BigInt(abort.abortCode) : 0n, abort.cleverError?.constantName ?? null);
+}
+
+//#endregion
+export { PredictInputError, PredictMoveError, decodeMoveAbort };
+//# sourceMappingURL=errors.mjs.map

package/dist/predict/errors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.mjs","names":[],"sources":["../../src/predict/errors.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n// Typed errors for the Predict SDK.\n//\n// Two failure kinds cross the SDK boundary:\n//   - PredictInputError — a caller gave us something we rejected before touching\n//     the chain (unknown underlying, malformed argument, …).\n//   - PredictMoveError — a Move `abort` surfaced by a read/simulate. The deployed\n//     Predict packages are compiled with CLEVER ERRORS, so the fullnode decodes the\n//     `E…` error-constant name out of the abort code's high bits and returns it on\n//     the structured execution error. We read that name straight from chain instead\n//     of maintaining a module→code→name table that goes stale on every redeploy.\n\n/** A caller-supplied argument the SDK rejected before building/sending a tx. */\nexport class PredictInputError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = 'PredictInputError';\n\t}\n}\n\n/** A Move `abort` decoded from a simulate/read failure. */\nexport class PredictMoveError extends Error {\n\treadonly module: string;\n\t/** Exact u64 abort code — bigint because clever-error encodings pack data\n\t * into the high bits, which Number would silently truncate. */\n\treadonly code: bigint;\n\t/** The `E…` constant name, decoded from the clever-error abort code by the\n\t * fullnode, or null when the transport surfaced no name (a non-clever abort,\n\t * or a JSON-RPC failure that carries only a line number). */\n\treadonly abortName: string | null;\n\n\tconstructor(module: string, code: bigint, abortName: string | null) {\n\t\tsuper(\n\t\t\tabortName\n\t\t\t\t? `Move abort in ${module}: ${abortName} (code ${code})`\n\t\t\t\t: `Move abort in ${module}: code ${code}`,\n\t\t);\n\t\tthis.name = 'PredictMoveError';\n\t\tthis.module = module;\n\t\tthis.code = code;\n\t\tthis.abortName = abortName;\n\t}\n}\n\n// The structured MoveAbort execution error surfaced by `@mysten/sui` on a failed\n// simulate/execute. Read structurally rather than via the client's exported\n// `SuiClientTypes.ExecutionError` (`@mysten/sui/client`) so mocked simulate results\n// and future API-shape drift still satisfy it — the same convention reads/inspect.ts\n// uses for its simulate seam. Field provenance:\n//   - `MoveAbort.abortCode`                → u64 abort code as a decimal string.\n//   - `MoveAbort.location.module`          → the aborting module's short name.\n//   - `MoveAbort.cleverError.constantName` → the `E…` error constant, decoded by the\n//     fullnode from the clever-error bits of the abort code and surfaced by the gRPC\n//     (`grpc/core.ts` parseMoveAbort) and GraphQL transports. This is the on-chain\n//     name that replaces the old hand-maintained ABORT_TABLES. JSON-RPC surfaces only\n//     a line number, so `constantName` (and thus `abortName`) is absent there.\nexport interface MoveAbortError {\n\tMoveAbort?: {\n\t\tabortCode?: string | number | bigint;\n\t\tlocation?: { module?: string };\n\t\tcleverError?: { constantName?: string };\n\t};\n}\n\n/**\n * Decode a `@mysten/sui` MoveAbort execution error into a {@link PredictMoveError}.\n * Returns null when `error` carries no MoveAbort (InsufficientGas, a size error, any\n * non-abort failure), so callers can fall back to a plain Error.\n *\n * `abortName` is taken straight from the chain-decoded clever-error constant; it is\n * null when the abort predates clever errors or the transport didn't surface a name.\n * `code` stays a bigint — a clever-error abort code packs the module, line, and\n * constant index into the high bits of the u64 and would lose precision as a Number.\n */\nexport function decodeMoveAbort(error: MoveAbortError | null | undefined): PredictMoveError | null {\n\tconst abort = error?.MoveAbort;\n\tif (!abort) return null;\n\tconst module = abort.location?.module ?? '';\n\tconst code = abort.abortCode != null ? BigInt(abort.abortCode) : 0n;\n\tconst abortName = abort.cleverError?.constantName ?? null;\n\treturn new PredictMoveError(module, code, abortName);\n}\n"],"mappings":";;AAcA,IAAa,oBAAb,cAAuC,MAAM;CAC5C,YAAY,SAAiB;AAC5B,QAAM,QAAQ;AACd,OAAK,OAAO;;;;AAKd,IAAa,mBAAb,cAAsC,MAAM;CAU3C,YAAY,QAAgB,MAAc,WAA0B;AACnE,QACC,YACG,iBAAiB,OAAO,IAAI,UAAU,SAAS,KAAK,KACpD,iBAAiB,OAAO,SAAS,OACpC;AACD,OAAK,OAAO;AACZ,OAAK,SAAS;AACd,OAAK,OAAO;AACZ,OAAK,YAAY;;;;;;;;;;;;;AAkCnB,SAAgB,gBAAgB,OAAmE;CAClG,MAAM,QAAQ,OAAO;AACrB,KAAI,CAAC,MAAO,QAAO;AAInB,QAAO,IAAI,iBAHI,MAAM,UAAU,UAAU,IAC5B,MAAM,aAAa,OAAO,OAAO,MAAM,UAAU,GAAG,IAC/C,MAAM,aAAa,gBAAgB,KACD"}

package/dist/predict/index.d.mts

@@ -0,0 +1,18 @@
+import { TESTNET_DEPLOYMENT, TESTNET_UNITS } from "../deployments/testnet.mjs";
+import { getDeployment, getUnits } from "../deployments/index.mjs";
+import { PredictConfig, PredictPackages, UnderlyingConfig } from "./config/types.mjs";
+import { TESTNET_CONFIG } from "./config/testnet.mjs";
+import { getConfig } from "./config/index.mjs";
+import { BalanceChangeReceipt, BuilderCodeReceipt, ClaimReceipt, CreateManagerReceipt, DecodableEvent, DecodableTransactionResult, MintReceipt, PlpCancelReceipt, PlpRequestReceipt, RedeemReceipt } from "./decode.mjs";
+import { GeneratedConfig, toGeneratedConfig } from "./config/generated.mjs";
+import { OpenPosition } from "./reads/positions.mjs";
+import { pricing_d_exports } from "./pricing.mjs";
+import { MarketFeeds, loadLivePricer } from "./tx/trade.mjs";
+import { ReadClient } from "./reads/inspect.mjs";
+import { PricerSnapshot } from "./reads/pricing.mjs";
+import { POS_INF_TICK, Side, binaryRangeTicks } from "./ticks.mjs";
+import { ActiveMarket, CloseOptions, MarketDescriptor, MarketSummary, MintAmountOptions, MintOptions, MintQuote, POSITION_LOT_SIZE, PoolSummary, PredictClient, PredictCompatibleClient, RedeemQuote, predict } from "./client.mjs";
+import { deriveAccountWrapperId, generateAuth } from "./tx/common.mjs";
+import { U64_MAX, priceToRaw, probabilityToRaw, rawToPrice, rawToProbability, rawToUsdc, usdcToRaw } from "./units.mjs";
+import { MoveAbortError, PredictInputError, PredictMoveError, decodeMoveAbort } from "./errors.mjs";
+export { type ActiveMarket, type BalanceChangeReceipt, type BuilderCodeReceipt, type ClaimReceipt, type CloseOptions, type CreateManagerReceipt, type DecodableEvent, type DecodableTransactionResult, type GeneratedConfig, type MarketDescriptor, type MarketFeeds, type MarketSummary, type MintAmountOptions, type MintOptions, type MintQuote, type MintReceipt, type MoveAbortError, type OpenPosition, POSITION_LOT_SIZE, POS_INF_TICK, type PlpCancelReceipt, type PlpRequestReceipt, type PoolSummary, PredictClient, type PredictCompatibleClient, type PredictConfig, PredictInputError, PredictMoveError, type PredictPackages, type PricerSnapshot, type ReadClient, type RedeemQuote, type RedeemReceipt, type Side, TESTNET_CONFIG, TESTNET_DEPLOYMENT, TESTNET_UNITS, U64_MAX, type UnderlyingConfig, binaryRangeTicks, decodeMoveAbort, deriveAccountWrapperId, generateAuth, getConfig, getDeployment, getUnits, loadLivePricer, predict, priceToRaw, pricing_d_exports as pricing, probabilityToRaw, rawToPrice, rawToProbability, rawToUsdc, toGeneratedConfig, usdcToRaw };

package/dist/predict/index.mjs

@@ -0,0 +1,14 @@
+import { TESTNET_DEPLOYMENT, TESTNET_UNITS } from "../deployments/testnet.mjs";
+import { getDeployment, getUnits } from "../deployments/index.mjs";
+import { TESTNET_CONFIG } from "./config/testnet.mjs";
+import { getConfig } from "./config/index.mjs";
+import { toGeneratedConfig } from "./config/generated.mjs";
+import { PredictInputError, PredictMoveError, decodeMoveAbort } from "./errors.mjs";
+import { U64_MAX, priceToRaw, probabilityToRaw, rawToPrice, rawToProbability, rawToUsdc, usdcToRaw } from "./units.mjs";
+import { deriveAccountWrapperId, generateAuth } from "./tx/common.mjs";
+import { POS_INF_TICK, binaryRangeTicks } from "./ticks.mjs";
+import { loadLivePricer } from "./tx/trade.mjs";
+import { pricing_exports } from "./pricing.mjs";
+import { POSITION_LOT_SIZE, PredictClient, predict } from "./client.mjs";
+
+export { POSITION_LOT_SIZE, POS_INF_TICK, PredictClient, PredictInputError, PredictMoveError, TESTNET_CONFIG, TESTNET_DEPLOYMENT, TESTNET_UNITS, U64_MAX, binaryRangeTicks, decodeMoveAbort, deriveAccountWrapperId, generateAuth, getConfig, getDeployment, getUnits, loadLivePricer, predict, priceToRaw, pricing_exports as pricing, probabilityToRaw, rawToPrice, rawToProbability, rawToUsdc, toGeneratedConfig, usdcToRaw };