Merge pull request #1 from perps-studio/claude/recursing-goodall-4c5a39

Port hip4 SDK to Python with sync + async clients

Author: dennisfurrer

.gitignore

@@ -0,0 +1,61 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+
+# Distribution / packaging
+.Python
+build/
+dist/
+*.egg-info/
+*.egg
+wheels/
+.installed.cfg
+MANIFEST
+
+# Virtual environments
+.env
+.venv
+env/
+venv/
+ENV/
+
+# Testing & coverage
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.cache
+coverage.xml
+*.cover
+.hypothesis/
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Ruff
+.ruff_cache/
+
+# IDEs
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Poetry
+poetry.lock.bak
+
+# Jupyter
+.ipynb_checkpoints
+
+# Local env files
+.env.local
+.env.*.local

.pre-commit-config.yaml

@@ -0,0 +1,36 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-toml
+      - id: check-added-large-files
+      - id: check-merge-conflict
+      - id: debug-statements
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.8.0
+    hooks:
+      - id: ruff
+        args: [--fix]
+
+  - repo: https://github.com/psf/black
+    rev: 24.10.0
+    hooks:
+      - id: black
+
+  - repo: https://github.com/pycqa/isort
+    rev: 5.13.2
+    hooks:
+      - id: isort
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.14.1
+    hooks:
+      - id: mypy
+        additional_dependencies:
+          - types-requests
+          - eth-account
+        args: [--config-file=pyproject.toml]

LICENSE

@@ -0,0 +1,93 @@
+Business Source License 1.1
+
+License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+---
+
+Parameters
+
+Licensor: Perps S
+
+Licensed Work: @perps/hip4 v1.2.1 (all prior and subsequent versions included)
+The Licensed Work is (c) 2026 Perps Studio.
+
+Additional Use Grant: You may make use of the Licensed Work, provided that
+you may not use the Licensed Work for a Production Use.
+
+                      A "Production Use" is any use of the Licensed Work that
+                      makes the Licensed Work available to third parties as
+                      part of a commercial or non-commercial product,
+                      service, or application, including but not limited to:
+                      (a) incorporating the Licensed Work into a product or
+                          service that is offered to third parties;
+                      (b) using the Licensed Work to operate a service
+                          accessible by third parties;
+                      (c) distributing the Licensed Work or derivative works
+                          to third parties.
+
+                      For purposes of clarity, the following are permitted
+                      under this license without a separate commercial
+                      agreement:
+                      (i)   internal evaluation and testing;
+                      (ii)  non-production development and prototyping;
+                      (iii) academic and educational use;
+                      (iv)  personal, non-commercial projects that are not
+                            offered as a service to third parties.
+
+                      Any Production Use requires a separate commercial
+                      license from the Licensor. Contact: support@perps.studio
+
+Change Date: April 1, 2028
+
+Change License: MIT License
+
+---
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo
+of Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED
+ON AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND
+CONDITIONS, EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT,
+AND TITLE.
+
+IN NO EVENT WILL LICENSOR BE LIABLE FOR ANY DAMAGES, WHETHER DIRECT,
+INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF OR
+IN CONNECTION WITH THIS LICENSE OR THE USE OR INABILITY TO USE THE
+LICENSED WORK, EVEN IF LICENSOR HAS BEEN ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGES.

Makefile

@@ -0,0 +1,69 @@
+.DEFAULT_GOAL := help
+
+PYTHON := python3
+POETRY := poetry
+
+.PHONY: help
+help:
+	@echo "Available targets:"
+	@echo "  install        Install all dependencies (with async extras + dev)"
+	@echo "  install-prod   Install runtime dependencies only"
+	@echo "  test           Run pytest"
+	@echo "  test-cov       Run pytest with coverage report"
+	@echo "  lint           Run ruff + mypy"
+	@echo "  format         Run black + isort"
+	@echo "  format-check   Check formatting without modifying"
+	@echo "  typecheck      Run mypy"
+	@echo "  clean          Remove caches and build artifacts"
+	@echo "  build          Build distribution packages"
+	@echo "  publish        Publish to PyPI (requires credentials)"
+
+.PHONY: install
+install:
+	$(POETRY) install --all-extras --with dev
+
+.PHONY: install-prod
+install-prod:
+	$(POETRY) install --only main
+
+.PHONY: test
+test:
+	$(POETRY) run pytest
+
+.PHONY: test-cov
+test-cov:
+	$(POETRY) run pytest --cov=hip4 --cov-report=term-missing --cov-report=html
+
+.PHONY: lint
+lint:
+	$(POETRY) run ruff check hip4 tests
+	$(POETRY) run mypy hip4
+
+.PHONY: format
+format:
+	$(POETRY) run isort hip4 tests
+	$(POETRY) run black hip4 tests
+
+.PHONY: format-check
+format-check:
+	$(POETRY) run isort --check-only hip4 tests
+	$(POETRY) run black --check hip4 tests
+
+.PHONY: typecheck
+typecheck:
+	$(POETRY) run mypy hip4
+
+.PHONY: clean
+clean:
+	rm -rf build/ dist/ *.egg-info
+	rm -rf .pytest_cache/ .mypy_cache/ .ruff_cache/ htmlcov/ .coverage
+	find . -type d -name __pycache__ -exec rm -rf {} +
+	find . -type f -name "*.pyc" -delete
+
+.PHONY: build
+build:
+	$(POETRY) build
+
+.PHONY: publish
+publish: build
+	$(POETRY) publish