@suigar/sdk 2.0.0-beta.8 → 2.0.0-beta.9

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @suigar/sdk
 
+## 2.0.0-beta.9
+
+### Patch Changes
+
+- eaf8b3a: Fix metadata encoding so partner metadata is only added when configured and hex metadata values are encoded consistently as bytes. Improve supported-coin and price-info resolution error handling for transaction configuration.
+- 9929e05: Refine Move parser helpers by simplifying BCS type usage, normalizing missing
+  `i64` and float mantissa values to `0`, and documenting the numeric conversion
+  behavior in `fromMoveI64` and `fromMoveFloat`.
+
 ## 2.0.0-beta.8
 
 ### Patch Changes

package/README.md

@@ -110,7 +110,7 @@ Creates a named Sui client extension. By default, it registers under `client.sui
 ### Partner Setup
 
 > **Important:** `partner` is the partner wallet address. Configure it once
-> when you register the extension so the SDK can append that wallet address to
+> when you register the extension so the SDK can prepend that wallet address to
 > supported bet metadata automatically.
 
 ```ts
@@ -310,7 +310,7 @@ Shared behavior:
 - `cashStake` controls the withdrawn balance and defaults to `stake`
 - `betCount` defaults to `1`
 - `metadata` is encoded into `keys` and `values` byte arrays
-- `partner` configured via `suigar({ partner })` is appended automatically to metadata as the partner wallet address
+- `partner` configured via `suigar({ partner })` is prepended automatically to metadata as the partner wallet address
 - `metadata.partner` and `metadata.referrer` are reserved and ignored with a warning
 - the SDK resolves the price info object from the configured supported-coin mapping
 - the reward object is transferred back to `playerAddress`

package/dist/{chunk-YGYMLRE4.js → chunk-FEQY5O43.js}

@@ -256,36 +256,28 @@ var GAME_DETAILS_SCHEMA = {
 };
 
 // src/utils/parser.ts
-var bcsU8 = bcs.u8();
-var bcsU64 = bcs.u64();
-var bcsBool = bcs.bool();
-var bcsString = bcs.string();
 var textDecoder = new TextDecoder();
 var GAME_DETAIL_BCS = {
-  u8: bcsU8,
-  u64: bcsU64,
-  bool: bcsBool,
+  u8: bcs.U8,
+  u64: bcs.U64,
+  bool: bcs.Bool,
   float: Float,
-  string: bcsString
+  string: bcs.String
 };
 function fromMoveI64(i64) {
   try {
-    const value = BigInt(i64.bits ?? 0);
-    const maxPositive = 1n << 63n;
-    const twoPow64 = 1n << 64n;
-    const signed = value >= maxPositive ? value - twoPow64 : value;
-    return Number(signed);
+    return Number(BigInt.asIntN(64, BigInt(i64.bits ?? 0)));
   } catch {
     return 0;
   }
 }
 function fromMoveFloat(float) {
-  const mantissa = BigInt(float.mant);
+  const mantissa = BigInt(float.mant ?? 0);
   if (mantissa === 0n) {
     return 0;
   }
   const exponent = fromMoveI64(float.exp) - 52;
-  const magnitude = Number(mantissa) * Math.pow(2, exponent);
+  const magnitude = Number(mantissa) * 2 ** exponent;
   return float.is_negative ? -magnitude : magnitude;
 }
 function normalizeGameDetailValue(valueType, parsed) {
@@ -300,7 +292,7 @@ function normalizeGameDetailValue(valueType, parsed) {
 function parseStringGameDetail(value) {
   const bytes = Uint8Array.from(value);
   try {
-    return bcsString.parse(bytes);
+    return bcs.String.parse(bytes);
   } catch {
     return textDecoder.decode(bytes);
   }

package/dist/{index-jwSXA8q3.d.cts → index-3P_LBbDM.d.cts}

@@ -1,12 +1,12 @@
 import { BcsType, BcsStruct } from '@mysten/sui/bcs';
 import { SuiClientTypes, ClientWithCoreApi } from '@mysten/sui/client';
 
-interface GetOptions<Include extends Omit<SuiClientTypes.ObjectInclude, 'content'> = {}> extends SuiClientTypes.GetObjectOptions<Include> {
+type GetOptions<Include extends Omit<SuiClientTypes.ObjectInclude, 'content'> = {}> = SuiClientTypes.GetObjectOptions<Include> & {
     client: ClientWithCoreApi;
-}
-interface GetManyOptions<Include extends Omit<SuiClientTypes.ObjectInclude, 'content'> = {}> extends SuiClientTypes.GetObjectsOptions<Include> {
+};
+type GetManyOptions<Include extends Omit<SuiClientTypes.ObjectInclude, 'content'> = {}> = SuiClientTypes.GetObjectsOptions<Include> & {
     client: ClientWithCoreApi;
-}
+};
 declare class MoveStruct<T extends Record<string, BcsType<any>>, const Name extends string = string> extends BcsStruct<T, Name> {
     get<Include extends Omit<SuiClientTypes.ObjectInclude, 'content' | 'json'> = {}>({ objectId, ...options }: GetOptions<Include>): Promise<SuiClientTypes.Object<Include & {
         content: true;

package/dist/{index-jwSXA8q3.d.ts → index-3P_LBbDM.d.ts}

@@ -1,12 +1,12 @@
 import { BcsType, BcsStruct } from '@mysten/sui/bcs';
 import { SuiClientTypes, ClientWithCoreApi } from '@mysten/sui/client';
 
-interface GetOptions<Include extends Omit<SuiClientTypes.ObjectInclude, 'content'> = {}> extends SuiClientTypes.GetObjectOptions<Include> {
+type GetOptions<Include extends Omit<SuiClientTypes.ObjectInclude, 'content'> = {}> = SuiClientTypes.GetObjectOptions<Include> & {
     client: ClientWithCoreApi;
-}
-interface GetManyOptions<Include extends Omit<SuiClientTypes.ObjectInclude, 'content'> = {}> extends SuiClientTypes.GetObjectsOptions<Include> {
+};
+type GetManyOptions<Include extends Omit<SuiClientTypes.ObjectInclude, 'content'> = {}> = SuiClientTypes.GetObjectsOptions<Include> & {
     client: ClientWithCoreApi;
-}
+};
 declare class MoveStruct<T extends Record<string, BcsType<any>>, const Name extends string = string> extends BcsStruct<T, Name> {
     get<Include extends Omit<SuiClientTypes.ObjectInclude, 'content' | 'json'> = {}>({ objectId, ...options }: GetOptions<Include>): Promise<SuiClientTypes.Object<Include & {
         content: true;

package/dist/index.cjs

@@ -126,56 +126,44 @@ function resolvePriceInfoObjectId(config, coinType) {
   const normalizedCoinType = utils.normalizeStructTag(coinType);
   const supportedCoin = resolveSupportedCoin(config, normalizedCoinType);
   const objectId = config.priceInfoObjectIds[supportedCoin];
-  if (objectId) {
-    return objectId;
+  if (!objectId) {
+    throw new Error(
+      `Missing price info object configuration for coin type ${coinType}`
+    );
   }
-  throw new Error(
-    `Missing price info object configuration for coin type ${coinType}`
-  );
+  return objectId;
 }
 function resolveSupportedCoin(config, coinType) {
-  const entries = Object.entries(config.coinTypes);
-  const supportedCoin = entries.find(
-    ([, configuredCoinType]) => configuredCoinType === coinType
-  )?.[0];
-  if (supportedCoin) {
-    return supportedCoin;
+  const [supportedCoin] = Object.entries(config.coinTypes).find(([_, value]) => value === coinType) ?? [];
+  if (!supportedCoin) {
+    throw new Error(
+      `Unsupported coin type ${coinType}. Supported coin types: ${Object.values(
+        config.coinTypes
+      ).join(", ")}`
+    );
   }
-  throw new Error(
-    `Unsupported coin type ${coinType}. Supported coin types: ${entries.map(([, configuredCoinType]) => configuredCoinType).join(", ")}`
-  );
+  return supportedCoin;
 }
-var ADDRESS_METADATA_KEYS = /* @__PURE__ */ new Set(["partner"]);
-var RESERVED_METADATA_KEYS = /* @__PURE__ */ new Set([...ADDRESS_METADATA_KEYS, "referrer"]);
+var PARTNER_METADATA_KEY = "partner";
+var RESERVED_METADATA_KEYS = /* @__PURE__ */ new Set([PARTNER_METADATA_KEY, "referrer"]);
 var textEncoder = new TextEncoder();
 function parseHexAddress(value) {
-  const trimmed = value.trim();
-  if (!trimmed || !utils.isValidSuiAddress(trimmed)) return null;
   try {
-    const normalized = utils.normalizeSuiAddress(trimmed).slice(2);
-    const bytes = new Uint8Array(normalized.length / 2);
-    for (let index = 0; index < normalized.length; index += 2) {
-      bytes[index / 2] = Number.parseInt(
-        normalized.slice(index, index + 2),
-        16
-      );
-    }
-    return bytes;
+    return utils.fromHex(value);
   } catch {
     return null;
   }
 }
-function encodeMetadataValue(key, value) {
+function encodeMetadataValue(value) {
   if (value instanceof Uint8Array) {
     return Array.from(value);
   }
   if (Array.isArray(value)) {
     return value;
   }
-  if (typeof value === "string" && ADDRESS_METADATA_KEYS.has(key)) {
-    return Array.from(parseHexAddress(value) ?? textEncoder.encode(value));
-  }
-  return Array.from(textEncoder.encode(String(value)));
+  return Array.from(
+    parseHexAddress(String(value)) ?? textEncoder.encode(String(value))
+  );
 }
 function encodeBetMetadata(metadata, partner) {
   const keys = [];
@@ -191,14 +179,15 @@ function encodeBetMetadata(metadata, partner) {
       continue;
     }
     keys.push(key);
-    values.push(encodeMetadataValue(key, value));
+    values.push(encodeMetadataValue(value));
   }
-  if (!partner?.trim()) {
-    return { keys, values };
+  if (partner?.trim()) {
+    keys.unshift(PARTNER_METADATA_KEY);
+    values.unshift(encodeMetadataValue(partner));
   }
   return {
-    keys: [...keys, "partner"],
-    values: [...values, encodeMetadataValue("partner", partner)]
+    keys,
+    values
   };
 }
 var MOVE_STDLIB_ADDRESS = utils.normalizeSuiAddress("0x1");

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { M as MoveStruct } from './index-jwSXA8q3.cjs';
+import { M as MoveStruct } from './index-3P_LBbDM.cjs';
 import * as _mysten_bcs from '@mysten/bcs';
 import { ClientWithCoreApi, SuiClientTypes } from '@mysten/sui/client';
 import { Transaction, BuildTransactionOptions } from '@mysten/sui/transactions';

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { M as MoveStruct } from './index-jwSXA8q3.js';
+import { M as MoveStruct } from './index-3P_LBbDM.js';
 import * as _mysten_bcs from '@mysten/bcs';
 import { ClientWithCoreApi, SuiClientTypes } from '@mysten/sui/client';
 import { Transaction, BuildTransactionOptions } from '@mysten/sui/transactions';

package/dist/index.js

@@ -1,5 +1,5 @@
-import { MoveStruct, Float, toBigInt, toU8, DEFAULT_GAS_BUDGET_MIST, normalizeMoveArguments, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE } from './chunk-YGYMLRE4.js';
-import { toBase64, normalizeStructTag, parseStructTag, normalizeSuiAddress, isValidSuiAddress } from '@mysten/sui/utils';
+import { MoveStruct, Float, toBigInt, toU8, DEFAULT_GAS_BUDGET_MIST, normalizeMoveArguments, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE } from './chunk-FEQY5O43.js';
+import { toBase64, normalizeStructTag, parseStructTag, normalizeSuiAddress, fromHex } from '@mysten/sui/utils';
 import { Transaction } from '@mysten/sui/transactions';
 import { bcs } from '@mysten/sui/bcs';
 
@@ -123,56 +123,44 @@ function resolvePriceInfoObjectId(config, coinType) {
   const normalizedCoinType = normalizeStructTag(coinType);
   const supportedCoin = resolveSupportedCoin(config, normalizedCoinType);
   const objectId = config.priceInfoObjectIds[supportedCoin];
-  if (objectId) {
-    return objectId;
+  if (!objectId) {
+    throw new Error(
+      `Missing price info object configuration for coin type ${coinType}`
+    );
   }
-  throw new Error(
-    `Missing price info object configuration for coin type ${coinType}`
-  );
+  return objectId;
 }
 function resolveSupportedCoin(config, coinType) {
-  const entries = Object.entries(config.coinTypes);
-  const supportedCoin = entries.find(
-    ([, configuredCoinType]) => configuredCoinType === coinType
-  )?.[0];
-  if (supportedCoin) {
-    return supportedCoin;
+  const [supportedCoin] = Object.entries(config.coinTypes).find(([_, value]) => value === coinType) ?? [];
+  if (!supportedCoin) {
+    throw new Error(
+      `Unsupported coin type ${coinType}. Supported coin types: ${Object.values(
+        config.coinTypes
+      ).join(", ")}`
+    );
   }
-  throw new Error(
-    `Unsupported coin type ${coinType}. Supported coin types: ${entries.map(([, configuredCoinType]) => configuredCoinType).join(", ")}`
-  );
+  return supportedCoin;
 }
-var ADDRESS_METADATA_KEYS = /* @__PURE__ */ new Set(["partner"]);
-var RESERVED_METADATA_KEYS = /* @__PURE__ */ new Set([...ADDRESS_METADATA_KEYS, "referrer"]);
+var PARTNER_METADATA_KEY = "partner";
+var RESERVED_METADATA_KEYS = /* @__PURE__ */ new Set([PARTNER_METADATA_KEY, "referrer"]);
 var textEncoder = new TextEncoder();
 function parseHexAddress(value) {
-  const trimmed = value.trim();
-  if (!trimmed || !isValidSuiAddress(trimmed)) return null;
   try {
-    const normalized = normalizeSuiAddress(trimmed).slice(2);
-    const bytes = new Uint8Array(normalized.length / 2);
-    for (let index = 0; index < normalized.length; index += 2) {
-      bytes[index / 2] = Number.parseInt(
-        normalized.slice(index, index + 2),
-        16
-      );
-    }
-    return bytes;
+    return fromHex(value);
   } catch {
     return null;
   }
 }
-function encodeMetadataValue(key, value) {
+function encodeMetadataValue(value) {
   if (value instanceof Uint8Array) {
     return Array.from(value);
   }
   if (Array.isArray(value)) {
     return value;
   }
-  if (typeof value === "string" && ADDRESS_METADATA_KEYS.has(key)) {
-    return Array.from(parseHexAddress(value) ?? textEncoder.encode(value));
-  }
-  return Array.from(textEncoder.encode(String(value)));
+  return Array.from(
+    parseHexAddress(String(value)) ?? textEncoder.encode(String(value))
+  );
 }
 function encodeBetMetadata(metadata, partner) {
   const keys = [];
@@ -188,14 +176,15 @@ function encodeBetMetadata(metadata, partner) {
       continue;
     }
     keys.push(key);
-    values.push(encodeMetadataValue(key, value));
+    values.push(encodeMetadataValue(value));
   }
-  if (!partner?.trim()) {
-    return { keys, values };
+  if (partner?.trim()) {
+    keys.unshift(PARTNER_METADATA_KEY);
+    values.unshift(encodeMetadataValue(partner));
   }
   return {
-    keys: [...keys, "partner"],
-    values: [...values, encodeMetadataValue("partner", partner)]
+    keys,
+    values
   };
 }
 

package/dist/utils.cjs

@@ -146,36 +146,28 @@ var GAME_DETAILS_SCHEMA = {
 };
 
 // src/utils/parser.ts
-var bcsU8 = bcs.bcs.u8();
-var bcsU64 = bcs.bcs.u64();
-var bcsBool = bcs.bcs.bool();
-var bcsString = bcs.bcs.string();
 var textDecoder = new TextDecoder();
 var GAME_DETAIL_BCS = {
-  u8: bcsU8,
-  u64: bcsU64,
-  bool: bcsBool,
+  u8: bcs.bcs.U8,
+  u64: bcs.bcs.U64,
+  bool: bcs.bcs.Bool,
   float: Float,
-  string: bcsString
+  string: bcs.bcs.String
 };
 function fromMoveI64(i64) {
   try {
-    const value = BigInt(i64.bits ?? 0);
-    const maxPositive = 1n << 63n;
-    const twoPow64 = 1n << 64n;
-    const signed = value >= maxPositive ? value - twoPow64 : value;
-    return Number(signed);
+    return Number(BigInt.asIntN(64, BigInt(i64.bits ?? 0)));
   } catch {
     return 0;
   }
 }
 function fromMoveFloat(float) {
-  const mantissa = BigInt(float.mant);
+  const mantissa = BigInt(float.mant ?? 0);
   if (mantissa === 0n) {
     return 0;
   }
   const exponent = fromMoveI64(float.exp) - 52;
-  const magnitude = Number(mantissa) * Math.pow(2, exponent);
+  const magnitude = Number(mantissa) * 2 ** exponent;
   return float.is_negative ? -magnitude : magnitude;
 }
 function normalizeGameDetailValue(valueType, parsed) {
@@ -190,7 +182,7 @@ function normalizeGameDetailValue(valueType, parsed) {
 function parseStringGameDetail(value) {
   const bytes = Uint8Array.from(value);
   try {
-    return bcsString.parse(bytes);
+    return bcs.bcs.String.parse(bytes);
   } catch {
     return textDecoder.decode(bytes);
   }

package/dist/utils.d.cts

@@ -1,5 +1,5 @@
 import * as _mysten_bcs from '@mysten/bcs';
-import { M as MoveStruct } from './index-jwSXA8q3.cjs';
+import { M as MoveStruct } from './index-3P_LBbDM.cjs';
 import '@mysten/sui/bcs';
 import '@mysten/sui/client';
 
@@ -96,7 +96,29 @@ declare const Float: MoveStruct<{
 }, "0xf391858d2a08473e8d4defcc8df89976bd7b123d3865c6b9341b237f7853dbbc::float::Float">;
 
 type MoveFloat = ReturnType<(typeof Float)['parse']>;
+/**
+ * Converts a generated Move `i64` wrapper into a JavaScript number.
+ *
+ * The generated bindings expose signed 64-bit integers through a `{ bits }`
+ * field that stores the raw two's-complement bit pattern. This helper
+ * reinterprets those bits as a signed `i64` and returns a plain JS number.
+ * Invalid or missing input falls back to `0`.
+ *
+ * @param i64 Generated Move `i64` value, typically used for float exponents.
+ * @returns The signed 64-bit value as a JavaScript number.
+ */
 declare function fromMoveI64(i64: MoveFloat['exp']): number;
+/**
+ * Converts a generated Move `Float` struct into a JavaScript number.
+ *
+ * Suigar float values are represented as a sign flag, an unsigned mantissa,
+ * and a Move `i64` exponent. This helper rebuilds the numeric value using the
+ * same normalization expected by the onchain format and applies the sign at
+ * the end. Missing mantissas are treated as `0`, and a zero mantissa returns `0`.
+ *
+ * @param float Generated Move float value with `mant`, `exp`, and `is_negative`.
+ * @returns The decoded floating-point value as a JavaScript number.
+ */
 declare function fromMoveFloat(float: MoveFloat): number;
 /**
  * Decodes `BetResultEvent.game_details` into plain application values.

package/dist/utils.d.ts

@@ -1,5 +1,5 @@
 import * as _mysten_bcs from '@mysten/bcs';
-import { M as MoveStruct } from './index-jwSXA8q3.js';
+import { M as MoveStruct } from './index-3P_LBbDM.js';
 import '@mysten/sui/bcs';
 import '@mysten/sui/client';
 
@@ -96,7 +96,29 @@ declare const Float: MoveStruct<{
 }, "0xf391858d2a08473e8d4defcc8df89976bd7b123d3865c6b9341b237f7853dbbc::float::Float">;
 
 type MoveFloat = ReturnType<(typeof Float)['parse']>;
+/**
+ * Converts a generated Move `i64` wrapper into a JavaScript number.
+ *
+ * The generated bindings expose signed 64-bit integers through a `{ bits }`
+ * field that stores the raw two's-complement bit pattern. This helper
+ * reinterprets those bits as a signed `i64` and returns a plain JS number.
+ * Invalid or missing input falls back to `0`.
+ *
+ * @param i64 Generated Move `i64` value, typically used for float exponents.
+ * @returns The signed 64-bit value as a JavaScript number.
+ */
 declare function fromMoveI64(i64: MoveFloat['exp']): number;
+/**
+ * Converts a generated Move `Float` struct into a JavaScript number.
+ *
+ * Suigar float values are represented as a sign flag, an unsigned mantissa,
+ * and a Move `i64` exponent. This helper rebuilds the numeric value using the
+ * same normalization expected by the onchain format and applies the sign at
+ * the end. Missing mantissas are treated as `0`, and a zero mantissa returns `0`.
+ *
+ * @param float Generated Move float value with `mant`, `exp`, and `is_negative`.
+ * @returns The decoded floating-point value as a JavaScript number.
+ */
 declare function fromMoveFloat(float: MoveFloat): number;
 /**
  * Decodes `BetResultEvent.game_details` into plain application values.

package/dist/utils.js

@@ -1 +1 @@
-export { DEFAULT_GAS_BUDGET_MIST, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE, RANGE_POINT_LIMIT, fromMoveFloat, fromMoveI64, parseGameDetails, toBigInt, toU8 } from './chunk-YGYMLRE4.js';
+export { DEFAULT_GAS_BUDGET_MIST, DEFAULT_LIMBO_MULTIPLIER_SCALE, DEFAULT_RANGE_SCALE, RANGE_POINT_LIMIT, fromMoveFloat, fromMoveI64, parseGameDetails, toBigInt, toU8 } from './chunk-FEQY5O43.js';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@suigar/sdk",
-	"version": "2.0.0-beta.8",
+	"version": "2.0.0-beta.9",
 	"description": "TypeScript SDK for Suigar v2 Move contracts on Sui.",
 	"keywords": [
 		"suigar",
@@ -46,18 +46,17 @@
 		"build": "npm run clean && npm run codegen && tsup",
 		"build:ci": "rm -rf dist && tsup",
 		"clean": "rm -rf dist src/contracts .vitest-cache",
-		"codegen": "sui-ts-codegen generate",
+		"codegen": "node ./scripts/update-package-configs.mjs && sui-ts-codegen generate",
 		"changeset": "changeset",
 		"changeset:beta:enter": "changeset pre enter beta",
 		"changeset:beta:exit": "changeset pre exit",
+		"changeset:version": "changeset version",
 		"format": "prettier --write .",
 		"lint": "eslint . --fix && npm run format",
 		"prepare": "husky",
 		"release": "changeset publish",
 		"test": "vitest run",
-		"typecheck": "tsc --noEmit",
-		"update:package-configs": "node ./scripts/update-package-configs.mjs",
-		"version-packages": "changeset version"
+		"typecheck": "tsc --noEmit"
 	},
 	"repository": {
 		"type": "git",
@@ -78,7 +77,7 @@
 		"@changesets/cli": "^2.31.0",
 		"@eslint/js": "^10.0.1",
 		"@mysten/bcs": "^2.0.3",
-		"@mysten/codegen": "^0.9.0",
+		"@mysten/codegen": "^0.10.0",
 		"@mysten/sui": "^2.16.0",
 		"@types/node": "^24.0.0",
 		"eslint": "^10.2.1",
@@ -89,7 +88,7 @@
 		"tsup": "^8.5.1",
 		"tsx": "^4.21.0",
 		"typescript": "^5.9.3",
-		"typescript-eslint": "^8.59.0",
+		"typescript-eslint": "^8.59.1",
 		"vitest": "^4.1.5"
 	}
 }