Metadata-Version: 2.1
Name: goat-sdk-wallet-evm
Version: 0.1.2
Summary: Goat SDK EVM wallet implementation
Home-page: https://ohmygoat.dev/
Keywords: goat,sdk,web3,agents,ai,evm,wallet
Author: Andrea Villa
Author-email: andreakarimodm@gmail.com
Requires-Python: >=3.10,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: evmchains (>=0.1.3,<0.2.0)
Requires-Dist: goat-sdk (>=0.1.0,<0.2.0)
Requires-Dist: typing-extensions (>=4.12.2,<5.0.0)
Project-URL: Bug Tracker, https://github.com/goat-sdk/goat/issues
Project-URL: Repository, https://github.com/goat-sdk/goat
Description-Content-Type: text/markdown

# EVM Wallet for GOAT SDK

A Python implementation of an EVM wallet for the GOAT SDK, providing secure key management and transaction signing capabilities for Ethereum Virtual Machine compatible networks.

## Installation

```bash
poetry add goat-sdk-wallet-evm
```

## Usage

```python
from goat_wallets.evm import evm_wallet

# Initialize wallet with private key
wallet = evm_wallet(
    private_key="${WALLET_PRIVATE_KEY}",  # Your EVM wallet private key
    rpc_url="${RPC_PROVIDER_URL}"  # Your EVM RPC endpoint
)

# Get wallet address
address = wallet.get_address()

# Get ETH balance
balance = await wallet.get_balance()

# Sign and send transaction
tx_hash = await wallet.sign_and_send_transaction({
    "to": "recipient_address",
    "value": "1000000000000000000",  # 1 ETH in wei
    "data": "0x",  # Optional contract data
})

# Get transaction receipt
receipt = await wallet.get_transaction_receipt(tx_hash)
```

## Features

- Secure Key Management:
  - Private key support
  - Public address derivation
  - Message signing
  
- Transaction Operations:
  - Transaction signing
  - Transaction sending
  - Gas estimation
  - Receipt tracking
  
- Balance Management:
  - Native token balance
  - ERC20 token balance
  - Contract interactions
  
- Network Support:
  - Ethereum
  - Polygon
  - Arbitrum
  - Optimism
  - Base
  - BNB Chain
  - All EVM-compatible chains

## License

This project is licensed under the terms of the MIT license.

