@block52/poker-vm-sdk 1.1.7 → 1.1.9

package/README.md

@@ -145,36 +145,65 @@ console.log("Balance:", client.b52usdcToUsdc(balance), "USDC");
 
 ### SigningCosmosClient
 
-The main client for interacting with the poker blockchain with signing capabilities.
+Extends `CosmosClient` with transaction signing capabilities. Includes all query methods from `CosmosClient` plus:
 
-#### Methods
+#### Transaction Methods
 
 - `createGame(gameFormat, gameVariant, minPlayers, maxPlayers, minBuyIn, maxBuyIn, smallBlind, bigBlind, timeout, rakeConfig?, sngConfig?)` - Create a new poker game
 - `joinGame(gameId, seat, buyInAmount)` - Join an existing game at a specific seat
-- `performAction(gameId, action, amount?, data?)` - Perform a poker action (fold, call, raise, check)
 - `leaveGame(gameId)` - Leave a game and cash out
+- `performAction(gameId, action, amount?, data?)` - Perform a poker action (fold, call, raise, check, all-in, deal)
+- `topUp(gameId, amount)` - Add chips to your stack at a table
+- `sendTokens(fromAddress, toAddress, amount, denom?, memo?)` - Send tokens to another address
+- `sendB52USDC(fromAddress, toAddress, amount, memo?)` - Send b52USDC tokens
+
+#### Bridge Methods
+
+- `processDeposit(depositIndex)` - Process a bridge deposit from Ethereum by index
+- `initiateWithdrawal(baseAddress, amount)` - Initiate withdrawal to Base chain
+- `getWithdrawalRequest(nonce)` - Query a specific withdrawal request by nonce
+- `listWithdrawalRequests(cosmosAddress?)` - List withdrawal requests
+
+#### Wallet Methods
+
 - `getWalletAddress()` - Get the current wallet address
-- `getB52USDCBalance(address)` - Get USDC balance for an address
-- `getTx(hash)` - Get transaction details by hash
+- `setWallet(wallet)` - Set a new wallet for signing
+- `getWallet()` - Get the current wallet instance
 - `disconnect()` - Close the client connection
 
 ### CosmosClient
 
-Query-only client for reading blockchain state.
+Query-only client for reading blockchain state via REST API.
 
-#### Methods
+#### Blockchain Query Methods
 
-- `getGame(gameId)` - Get game options/configuration by ID
-- `getGameState(gameId)` - Get current game state by ID
-- `listGames()` - Get all games
-- `findGames(min?, max?)` - Find games by blind range
-- `getPlayerGames(playerAddress)` - Get games for a specific player
-- `getLegalActions(gameId, playerAddress?)` - Get legal actions for a game
-- `getBalance(address, denom?)` - Query token balance
-- `getAllBalances(address)` - Get all token balances
 - `getAccount(address)` - Get account information
+- `getAllBalances(address)` - Get all token balances for an address
+- `getBalance(address, denom?)` - Get specific token balance (default: b52USDC)
 - `getHeight()` - Get current block height
 - `getTx(txHash)` - Get transaction by hash
+- `getBlock(height)` - Get a specific block by height
+- `getLatestBlock()` - Get the most recent block
+- `getBlocks(startHeight, count?)` - Get multiple blocks starting from a height
+- `getLatestBlocks(count?)` - Get the most recent N blocks
+
+#### Game Query Methods
+
+- `getGame(gameId)` - Get game options/configuration by ID
+- `getGameState(gameId)` - Get current game state by ID
+- `listGames()` - Get all active games
+- `findGames(min?, max?)` - Find games by player capacity (minPlayers/maxPlayers)
+- `getPlayerGames(playerAddress)` - Get all games for a specific player
+- `getLegalActions(gameId, playerAddress?)` - Get legal actions for a player in a game
+
+#### Token & Utility Methods
+
+- `getB52USDCBalance(address)` - Get b52USDC balance for an address
+- `b52usdcToUsdc(amount)` - Convert b52USDC (micro units) to USDC display format
+- `usdcToB52usdc(amount)` - Convert USDC to b52USDC (micro units)
+- `calculateEquity(hands, board?, dead?, simulations?)` - Calculate hand equity via Monte Carlo
+- `calculateEquityFull(hands, board?, dead?, simulations?)` - Calculate equity with full metadata
+- `listWithdrawalRequests(cosmosAddress?)` - List withdrawal requests (all or for specific address)
 
 ### Deck
 
@@ -278,6 +307,43 @@ yarn test
 yarn lint
 ```
 
+### Publishing to npm
+
+The SDK is automatically published to npm via GitHub Actions when a release is created.
+
+#### Automated Publishing Process
+
+1. **Update the version** in `package.json`:
+   ```bash
+   cd sdk
+   # Edit package.json to update version (e.g., "1.1.9")
+   ```
+
+2. **Commit and push** the version change:
+   ```bash
+   git add package.json
+   git commit -m "chore: update SDK version to 1.1.9"
+   git push
+   ```
+
+3. **Create a GitHub release** with a tag matching `sdk-v*`:
+   ```bash
+   gh release create sdk-v1.1.9 --title "SDK v1.1.9" --notes "Release notes here"
+   ```
+
+The GitHub Action workflow will automatically:
+- Install dependencies
+- Run tests
+- Build the SDK
+- Verify the package.json version matches the release tag
+- Publish to npm with public access
+
+**Important Notes:**
+- The release tag must start with `sdk-v` (e.g., `sdk-v1.1.9`)
+- The version in `package.json` must match the tag version (e.g., `1.1.9` for tag `sdk-v1.1.9`)
+- The `NPM_TOKEN` secret must be configured in GitHub repository settings
+- The workflow uses `--ignore-scripts` to skip the `prepublishOnly` script since it already builds the SDK
+
 ### Project Structure
 
 ```

package/dist/index.d.ts

@@ -44952,6 +44952,8 @@ interface MsgPerformAction {
     gameId: string;
     action: string;
     amount: Long;
+    /** Optional action data (e.g., "method=post-now" for sit-in) */
+    data: string;
 }
 declare const MsgPerformAction: MessageFns<MsgPerformAction>;
 /** MsgMint defines the MsgMint message. */
@@ -45424,6 +45426,8 @@ type TexasHoldemStateDTO = {
     round: TexasHoldemRound;
     winners: WinnerDTO[];
     results: ResultDTO[];
+    legalActions: LegalActionDTO[];
+    availableSeats: number[];
     signature: string;
 };
 /**