safe-kit 0.0.11__py3-none-any.whl

safe_kit-0.0.11.dist-info/METADATA

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: safe-kit
+Version: 0.0.11
+Summary: Python implementation of the Safe Protocol Kit
+License: MIT
+License-File: LICENSE
+Keywords: ethereum,safe,gnosis-safe,web3,sdk,blockchain
+Author: smallyu
+Author-email: smallyu@users.noreply.github.com
+Requires-Python: >=3.10,<4.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: eth-account (>=0.11.0,<0.12.0)
+Requires-Dist: eth-typing (<5.0.0)
+Requires-Dist: pydantic (>=2.0.0,<3.0.0)
+Requires-Dist: requests (>=2.0.0,<3.0.0)
+Requires-Dist: setuptools
+Requires-Dist: web3 (>=6.0.0,<7.0.0)
+Project-URL: Documentation, https://github.com/smallyunet/safe-kit
+Project-URL: Homepage, https://github.com/smallyunet/safe-kit
+Project-URL: Repository, https://github.com/smallyunet/safe-kit
+Description-Content-Type: text/markdown
+
+# Safe Kit (Python)
+
+[![PyPI version](https://img.shields.io/pypi/v/safe-kit.svg)](https://pypi.org/project/safe-kit/)
+[![Python versions](https://img.shields.io/pypi/pyversions/safe-kit.svg)](https://pypi.org/project/safe-kit/)
+[![License](https://img.shields.io/pypi/l/safe-kit.svg)](https://github.com/smallyunet/safe-kit/blob/main/LICENSE)
+[![CI](https://github.com/smallyunet/safe-kit/actions/workflows/ci.yml/badge.svg)](https://github.com/smallyunet/safe-kit/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/smallyunet/safe-kit/branch/main/graph/badge.svg)](https://codecov.io/gh/smallyunet/safe-kit)
+
+A Python implementation of the [Safe Protocol Kit](https://github.com/safe-global/safe-core-sdk), designed to mirror the developer experience of the official Node.js SDK.
+
+## Features
+
+- **DX First**: Intuitive API for interacting with Safe smart accounts.
+- **Type Safe**: Built with Pydantic and fully typed for robust development.
+- **Modern Stack**: Uses Web3.py, Eth-account, and Python 3.10+.
+- **Full Protocol Support**: Supports Safe deployment, transaction creation, signing (EIP-712 & eth_sign), and execution.
+- **Advanced Features**: MultiSend (batching), Safe Transaction Service integration, and more.
+
+## Installation
+
+You can install `safe-kit` via pip:
+
+```bash
+pip install safe-kit
+```
+
+Or with Poetry:
+
+```bash
+poetry add safe-kit
+```
+
+## Usage
+
+### Initialization
+
+```python
+from web3 import Web3
+from eth_account import Account
+from safe_kit.safe import Safe
+from safe_kit.adapter import Web3Adapter
+
+# Setup Web3 and Signer
+w3 = Web3(Web3.HTTPProvider("RPC_URL"))
+owner = Account.from_key("PRIVATE_KEY")
+adapter = Web3Adapter(web3=w3, signer=owner)
+
+# Initialize Safe
+safe = Safe(eth_adapter=adapter, safe_address="0xSafeAddress")
+```
+
+### Creating and Signing Transactions
+
+```python
+from safe_kit.types import SafeTransactionData
+
+# Create a transaction (e.g., send ETH)
+tx_data = SafeTransactionData(
+    to="0xRecipient",
+    value=1000000000000000000, # 1 ETH
+    data="0x"
+)
+
+safe_tx = safe.create_transaction(tx_data)
+
+# Sign the transaction
+# Supports "eth_sign_typed_data" (default, EIP-712) or "eth_sign" (legacy)
+signed_tx = safe.sign_transaction(safe_tx)
+```
+
+### Executing Transactions
+
+```python
+# Execute the transaction on-chain
+tx_hash = safe.execute_transaction(signed_tx)
+print(f"Transaction executed: {tx_hash}")
+```
+
+For more advanced usage (Batching, Transaction Service, Deployment), please refer to the [User Guide](https://smallyunet.github.io/safe-kit/user_guide/).
+
+## Development
+
+### Setup
+
+```bash
+# Install dependencies
+poetry install
+```
+
+### Running Tests
+
+```bash
+poetry run pytest
+```
+
+### Linting
+
+```bash
+poetry run ruff check .
+poetry run mypy .
+```
+
+## Roadmap
+
+See [docs/roadmap.md](docs/roadmap.md) for the current implementation status.
+

safe_kit-0.0.11.dist-info/RECORD

@@ -0,0 +1,20 @@
+safe_kit/__init__.py,sha256=IdkQGluiCnWhNipRzKaAaCy3rOfPip83NR09xIu-YP0,640
+safe_kit/abis.py,sha256=GABlARwUpYV5VO1_vs1rkA6tu9NDRIYXrJL52THkBVA,13135
+safe_kit/adapter.py,sha256=NUtDKOjQqPG4XjbcHI5M8CsfOyUHkj8KwfVKfYxSgjs,4309
+safe_kit/contract_types.py,sha256=6ATY0O4eaaoB_W-puPbSH7tIfc61aDAXZKu1P388Yw0,2642
+safe_kit/errors.py,sha256=GxxuctxqBCNPfDh3nfnvOf7VRyITx5ItK_t_aGu3Hus,2097
+safe_kit/factory.py,sha256=zHuncqOrTuYfiB87bxSP83asULS135uJ_19W8n5C_wY,5021
+safe_kit/managers/__init__.py,sha256=-3jVIeEgXeSJF3NJeFwky1NocPHvxXojCYjeOgZoSRc,422
+safe_kit/managers/guard_manager.py,sha256=58eih6HBAWeHoD8NxCGxaA30xum0f4-JCWRz-eziISs,2099
+safe_kit/managers/module_manager.py,sha256=dwv31NZsshJJwM4y2o9YrBgZmRAZiCGro5H6UFOSzcQ,2607
+safe_kit/managers/owner_manager.py,sha256=tTwiG7_1623OeUGAvlbXH4APPbudxC0L6SovJqP9JAg,3016
+safe_kit/managers/token_manager.py,sha256=E0XCzrUGg_5JGKHPAXTLaCRMAqQWSbNSO1m07nFZx1g,3215
+safe_kit/multisend.py,sha256=6OzznO1ziEIrL3LCjNUGDLKFfaXh601d0yrfzVDPL9I,1252
+safe_kit/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+safe_kit/safe.py,sha256=BJbi6PGjwFESKuimXew3YM8R4N8jVmpXeggcgCXb08Y,14073
+safe_kit/service.py,sha256=TkSKGQP0IeK3zqCqa3JWmqNSDttgCwtULl4C0jdF8DI,11954
+safe_kit/types.py,sha256=vc9miABzsKwGv8-Niss0GCud4vBv9prZPKQQqhA_PKQ,7374
+safe_kit-0.0.11.dist-info/METADATA,sha256=N9m7gRNGNtVW5AQByD7wMEYyC-NgljYA_OVOG61M92Q,4089
+safe_kit-0.0.11.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+safe_kit-0.0.11.dist-info/licenses/LICENSE,sha256=YypDTCKk9BYU9jm_LE6nMaSpID4pwh1WLthxpvPgiI0,1064
+safe_kit-0.0.11.dist-info/RECORD,,

safe_kit-0.0.11.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 2.2.1
+Root-Is-Purelib: true
+Tag: py3-none-any

safe_kit-0.0.11.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 smallyu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.