[BFS-847] Add Support for Coin Module in SDK

[abdullahabro]

Overview

This PR introduces comprehensive support for the Coin Module in the SDK, providing a set of utilities for managing SUI coins.

Key Changes

1. New Coin Interfaces (src/sui_utils/sui_interfaces.py)

• Added structured interfaces for SUI objects and responses:
  • Coin: Represents a SUI coin with properties like type, object ID, balance
  • CoinMetadata: Contains coin metadata (decimals, name, symbol)
  • TransactionResult: Structured transaction response with effects
  • SuiGetResponse: Handles paginated responses for coin queries
  • Supporting classes for gas, owner, reference, and effects

2. Coin Utilities (src/sui_utils/coin_utils.py)

• New CoinUtils class with methods for:
  • create_coin_with_balance: Creates a new coin with specified balance
  • merge_coins: Merges multiple coins into a primary coin
  • split_coin: Splits a coin into multiple coins of specified amounts
  • find_coin_with_balance: Finds a coin with exact or sufficient balance
  • sort_ascending: Sorts coins by balance
  • sum_coins: Calculates total balance of multiple coins
  • get_all_coins: Retrieves all coins for an address

3. RPC Enhancements (src/sui_utils/rpc.py)

• Added new RPC methods:
  • rpc_sui_createSplitCoinsTransaction: Creates transaction for splitting coins
  • rpc_sui_createMergeCoinsTransaction: Creates transaction for merging coins
  • rpc_sui_getTransactionBytes: Generic method for getting transaction bytes
  • get_coin_metadata: Fetches metadata for coin types
• Improved existing methods:
  • Enhanced get_coins_with_type with pagination support
  • Updated get_coin_balance to use new response structures
  • Refactored get_coin_having_balance to work with new interfaces

4. Signer Improvements (src/sui_utils/signer.py)

• Enhanced Signer class with new features:
  • Added constructor to optionally initialize with a SuiWallet
  • New sign_and_execute_tx method for one-step transaction signing and execution
  • Improved method signatures with optional wallet parameters
  • Added comprehensive docstrings and type hints
  • Enhanced error handling and validation
  • Improved signature verification and parsing
  • Better support for personal message signing
  • Added flexibility in private key handling