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

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @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
+
+- 0292edb: Rename transaction builder option `owner` to `playerAddress` and remove the separate `sender` option so all game transactions use a single explicit player address.
+- 20311be: Improve the public JSDoc for `parseGameDetails`, `toBigInt`, and `toU8` so the
+  generated API surface explains their coercion, validation, and decoding
+  behavior more clearly.
+- a2aa324: Update PvP coinflip lookup helpers to use bulk object reads for unresolved lobby discovery and support forwarded lookup options.
+  - Make `getPvPCoinflipGames()` parse bulk `client.core.getObjects()` results instead of resolving each game individually.
+  - Skip per-object fetch or parse failures by default and continue supporting strict rejection with `throwOnError: true`.
+  - Forward supported lookup options such as `signal` through `getPvPCoinflipGames()` and `resolvePvPConflipGame(gameId, options?)`.
+  - Update tests, README guidance, and repo-local PvP skill documentation to match the current client behavior.
+
 ## 2.0.0-beta.7
 
 ### Patch Changes

package/README.md

@@ -92,7 +92,7 @@ const client = new SuiGrpcClient({
 }).$extend(suigar());
 
 const tx = client.suigar.tx.createBetTransaction('coinflip', {
-	owner: '0x123',
+	playerAddress: '0x123',
 	coinType: '0x2::sui::SUI',
 	stake: 1_000_000_000n,
 	side: 'heads',
@@ -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
@@ -200,17 +200,20 @@ const base64 = await client.suigar.serializeTransactionToBase64(tx);
 Lists unresolved PvP coinflip games from the configured PvP registry.
 
 This reads the registry dynamic fields for the active network and resolves each
-entry into parsed game state through `resolvePvPConflipGame()`. Registry
+entry into parsed game state through a bulk `client.core.getObjects()` lookup. Registry
 membership is the unresolved-state signal: once a match is joined and resolved,
 the Move flow removes it from the registry and deletes the live `Game` object.
 
 Use this when a product needs the current set of open PvP coinflip matches for
 browsing or lobby views.
 
-By default, failures to resolve an individual game are skipped so one broken or
+By default, per-object fetch or parse failures are skipped so one broken or
 already-deleted registry entry does not reject the full lookup. Pass
 `throwOnError: true` if you want the call to reject instead.
 
+Any supported `listDynamicFields()` options such as `limit`, `cursor`, or
+`signal` can be passed through `options`.
+
 ```ts
 const games = await client.suigar.getPvPCoinflipGames({ limit: 20 });
 
@@ -227,14 +230,15 @@ const games = await client.suigar.getPvPCoinflipGames({
 });
 ```
 
-### `resolvePvPConflipGame(gameId)`
+### `resolvePvPConflipGame(gameId, options?)`
 
 Fetches a PvP coinflip game object from chain and parses it into the SDK's
 normalized runtime shape.
 
 This requires the object's `content`, decodes it with the generated
 `PvPCoinflipGame` parser, and normalizes the generic coin type into a standard
-struct tag string.
+struct tag string. You can optionally pass through `getObject()` options such as
+`signal`.
 
 Use this when a product needs the live onchain match state for a specific
 pending match before rendering join or cancel actions, or inspecting the stake
@@ -249,6 +253,14 @@ console.log(game.stake_per_player);
 console.log(game.is_private);
 ```
 
+```ts
+const controller = new AbortController();
+
+const game = await client.suigar.resolvePvPConflipGame('0xGAME_ID', {
+	signal: controller.signal,
+});
+```
+
 > **Note:**
 >
 > - it throws if the object response does not include decodable `content`
@@ -274,7 +286,7 @@ Use `createBetTransaction(gameId, options)` for:
 
 ```ts
 const tx = client.suigar.tx.createBetTransaction('coinflip', {
-	owner: '0x123',
+	playerAddress: '0x123',
 	coinType: '0x2::sui::SUI',
 	stake: 1_000_000_000n,
 	side: 'tails',
@@ -283,14 +295,13 @@ const tx = client.suigar.tx.createBetTransaction('coinflip', {
 
 Shared option shape:
 
-- `owner: string`
+- `playerAddress: string`
 - `coinType: string`
 - `stake: number | bigint`
 - `cashStake?: number | bigint`
 - `betCount?: number | bigint`
 - `metadata?: Record<string, string | number | boolean | bigint | Uint8Array | number[] | null | undefined>`
 - `gasBudget?: number | bigint`
-- `sender?: string`
 - `allowGasCoinShortcut?: boolean`
 
 Shared behavior:
@@ -298,12 +309,11 @@ Shared behavior:
 - `stake` is the logical stake passed into the Move call
 - `cashStake` controls the withdrawn balance and defaults to `stake`
 - `betCount` defaults to `1`
-- `sender` overrides the transaction sender
 - `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 `owner`
+- the reward object is transferred back to `playerAddress`
 
 Per-game options:
 
@@ -317,14 +327,14 @@ Examples:
 
 ```ts
 const limboTx = client.suigar.tx.createBetTransaction('limbo', {
-	owner: '0x123',
+	playerAddress: '0x123',
 	coinType: '0x2::sui::SUI',
 	stake: 1_000_000_000n,
 	targetMultiplier: 2.5,
 });
 
 const rangeTx = client.suigar.tx.createBetTransaction('range', {
-	owner: '0x123',
+	playerAddress: '0x123',
 	coinType: '0x2::sui::SUI',
 	stake: 1_000_000_000n,
 	leftPoint: 25,
@@ -359,7 +369,7 @@ Create:
 
 ```ts
 const tx = client.suigar.tx.createPvPCoinflipTransaction('create', {
-	owner: '0x123',
+	playerAddress: '0x123',
 	coinType: '0x2::sui::SUI',
 	stake: 1_000_000_000n,
 	side: 'heads',
@@ -371,7 +381,7 @@ Join:
 
 ```ts
 const tx = client.suigar.tx.createPvPCoinflipTransaction('join', {
-	owner: '0x123',
+	playerAddress: '0x123',
 	coinType: '0x2::sui::SUI',
 	gameId: '0xGAME_ID',
 });
@@ -381,7 +391,7 @@ Cancel:
 
 ```ts
 const tx = client.suigar.tx.createPvPCoinflipTransaction('cancel', {
-	owner: '0x123',
+	playerAddress: '0x123',
 	coinType: '0x2::sui::SUI',
 	gameId: '0xGAME_ID',
 });
@@ -392,11 +402,10 @@ id for `coinType`.
 
 PvP shared options:
 
-- `owner: string`
+- `playerAddress: string`
 - `coinType: string`
 - `metadata?: Record<string, string | number | boolean | bigint | Uint8Array | number[] | null | undefined>`
 - `gasBudget?: number | bigint`
-- `sender?: string`
 - `allowGasCoinShortcut?: boolean`
 
 Action-specific options:
@@ -542,7 +551,7 @@ npm test
 
 ## Example App
 
-This repository now includes a Next.js integration example in [examples/game-integration](/Users/lucas/Documents/Github/suigar-sdk/examples/game-integration).
+This repository includes a Next.js integration example in [examples/game-integration](examples/game-integration).
 
 It demonstrates:
 

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/{games--Haw_z7M.d.cts → games-BccpPyWd.d.cts}

@@ -1,3 +1,5 @@
+import { Transaction } from '@mysten/sui/transactions';
+
 declare const GAMES: readonly ["coinflip", "limbo", "plinko", "pvp-coinflip", "range", "wheel"];
 type Game = (typeof GAMES)[number];
 type StandardGame = Exclude<Game, PvPGame>;
@@ -26,22 +28,27 @@ type SuigarConfig = {
     priceInfoObjectIds: SuigarPriceInfoObjectId;
 };
 
-type SharedBetTransactionOptions = {
+type WithGasBudget = {
+    gasBudget?: Parameters<Transaction['setGasBudgetIfNotSet']>[0];
+};
+type WithThrowOnError<T = object> = T & {
+    throwOnError?: boolean;
+};
+type BaseTransactionOptions = WithGasBudget & {
     config: SuigarConfig;
-    owner: string;
+    playerAddress: string;
+};
+type CoinTransactionOptions = {
     coinType: string;
-    stake: number | bigint;
-    cashStake?: number | bigint;
-    betCount?: number | bigint;
     metadata?: BetMetadataInput;
-    gasBudget?: number | bigint;
-    sender?: string;
     allowGasCoinShortcut?: boolean;
 };
-
-type WithThrowOnError<T = object> = T & {
-    throwOnError?: boolean;
+type StakeTransactionOptions = {
+    stake: number | bigint;
+    cashStake?: number | bigint;
+    betCount?: number | bigint;
 };
+type SharedBetTransactionOptions = BaseTransactionOptions & CoinTransactionOptions & StakeTransactionOptions;
 type BuildCoinflipTransactionOptions = SharedBetTransactionOptions & {
     side: CoinSide;
 };
@@ -62,17 +69,9 @@ type BuildWheelTransactionOptions = SharedBetTransactionOptions & {
     configId: number;
 };
 type PvPCoinflipAction = 'create' | 'join' | 'cancel';
-type SharedPvPCoinflipTransactionOptions = {
-    config: SuigarConfig;
-    owner: string;
-    coinType: string;
-    metadata?: BetMetadataInput;
-    gasBudget?: number | bigint;
-    sender?: string;
-    allowGasCoinShortcut?: boolean;
-};
+type SharedPvPCoinflipTransactionOptions = BaseTransactionOptions & CoinTransactionOptions;
 type BuildCreatePvPCoinflipTransactionOptions = SharedPvPCoinflipTransactionOptions & {
-    stake: number | bigint;
+    stake: StakeTransactionOptions['stake'];
     side: CoinSide;
     isPrivate?: boolean;
 };

package/dist/{games--Haw_z7M.d.ts → games-BccpPyWd.d.ts}

@@ -1,3 +1,5 @@
+import { Transaction } from '@mysten/sui/transactions';
+
 declare const GAMES: readonly ["coinflip", "limbo", "plinko", "pvp-coinflip", "range", "wheel"];
 type Game = (typeof GAMES)[number];
 type StandardGame = Exclude<Game, PvPGame>;
@@ -26,22 +28,27 @@ type SuigarConfig = {
     priceInfoObjectIds: SuigarPriceInfoObjectId;
 };
 
-type SharedBetTransactionOptions = {
+type WithGasBudget = {
+    gasBudget?: Parameters<Transaction['setGasBudgetIfNotSet']>[0];
+};
+type WithThrowOnError<T = object> = T & {
+    throwOnError?: boolean;
+};
+type BaseTransactionOptions = WithGasBudget & {
     config: SuigarConfig;
-    owner: string;
+    playerAddress: string;
+};
+type CoinTransactionOptions = {
     coinType: string;
-    stake: number | bigint;
-    cashStake?: number | bigint;
-    betCount?: number | bigint;
     metadata?: BetMetadataInput;
-    gasBudget?: number | bigint;
-    sender?: string;
     allowGasCoinShortcut?: boolean;
 };
-
-type WithThrowOnError<T = object> = T & {
-    throwOnError?: boolean;
+type StakeTransactionOptions = {
+    stake: number | bigint;
+    cashStake?: number | bigint;
+    betCount?: number | bigint;
 };
+type SharedBetTransactionOptions = BaseTransactionOptions & CoinTransactionOptions & StakeTransactionOptions;
 type BuildCoinflipTransactionOptions = SharedBetTransactionOptions & {
     side: CoinSide;
 };
@@ -62,17 +69,9 @@ type BuildWheelTransactionOptions = SharedBetTransactionOptions & {
     configId: number;
 };
 type PvPCoinflipAction = 'create' | 'join' | 'cancel';
-type SharedPvPCoinflipTransactionOptions = {
-    config: SuigarConfig;
-    owner: string;
-    coinType: string;
-    metadata?: BetMetadataInput;
-    gasBudget?: number | bigint;
-    sender?: string;
-    allowGasCoinShortcut?: boolean;
-};
+type SharedPvPCoinflipTransactionOptions = BaseTransactionOptions & CoinTransactionOptions;
 type BuildCreatePvPCoinflipTransactionOptions = SharedPvPCoinflipTransactionOptions & {
-    stake: number | bigint;
+    stake: StakeTransactionOptions['stake'];
     side: CoinSide;
     isPrivate?: boolean;
 };

package/dist/games.d.cts

@@ -1 +1,2 @@
-export { h as BuildCancelPvPCoinflipTransactionOptions, B as BuildCoinflipTransactionOptions, i as BuildCreatePvPCoinflipTransactionOptions, j as BuildJoinPvPCoinflipTransactionOptions, b as BuildLimboTransactionOptions, c as BuildPlinkoTransactionOptions, d as BuildRangeTransactionOptions, a as BuildWheelTransactionOptions, C as CoinSide, P as PvPCoinflipAction } from './games--Haw_z7M.cjs';
+export { h as BuildCancelPvPCoinflipTransactionOptions, B as BuildCoinflipTransactionOptions, i as BuildCreatePvPCoinflipTransactionOptions, j as BuildJoinPvPCoinflipTransactionOptions, b as BuildLimboTransactionOptions, c as BuildPlinkoTransactionOptions, d as BuildRangeTransactionOptions, a as BuildWheelTransactionOptions, C as CoinSide, P as PvPCoinflipAction } from './games-BccpPyWd.cjs';
+import '@mysten/sui/transactions';

package/dist/games.d.ts

@@ -1 +1,2 @@
-export { h as BuildCancelPvPCoinflipTransactionOptions, B as BuildCoinflipTransactionOptions, i as BuildCreatePvPCoinflipTransactionOptions, j as BuildJoinPvPCoinflipTransactionOptions, b as BuildLimboTransactionOptions, c as BuildPlinkoTransactionOptions, d as BuildRangeTransactionOptions, a as BuildWheelTransactionOptions, C as CoinSide, P as PvPCoinflipAction } from './games--Haw_z7M.js';
+export { h as BuildCancelPvPCoinflipTransactionOptions, B as BuildCoinflipTransactionOptions, i as BuildCreatePvPCoinflipTransactionOptions, j as BuildJoinPvPCoinflipTransactionOptions, b as BuildLimboTransactionOptions, c as BuildPlinkoTransactionOptions, d as BuildRangeTransactionOptions, a as BuildWheelTransactionOptions, C as CoinSide, P as PvPCoinflipAction } from './games-BccpPyWd.js';
+import '@mysten/sui/transactions';

package/dist/{index-jwSXA8q3.d.ts → 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.cts → 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;