swig-developer-sdk 0.6.0__tar.gz

swig_developer_sdk-0.6.0/.gitignore

@@ -0,0 +1,164 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Snowpack dependency directory (https://snowpack.dev/)
+web_modules/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional stylelint cache
+.stylelintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+out
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+
+# Gatsby files
+.cache/
+# Comment in the public line in if your project uses Gatsby and not Next.js
+# https://nextjs.org/blog/next-9-1#public-directory-support
+# public
+
+# vuepress build output
+.vuepress/dist
+
+# vuepress v2.x temp and cache directory
+.temp
+.cache
+
+# vitepress build output
+**/.vitepress/dist
+
+# vitepress cache directory
+**/.vitepress/cache
+
+# Docusaurus cache and generated files
+.docusaurus
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# TernJS port file
+.tern-port
+
+# Stores VSCode versions used for testing VSCode extensions
+.vscode-test
+
+# yarn v2
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.yarn/install-state.gz
+.pnp.*
+
+# Mac OS shenanigans
+.DS_Store
+
+# Rust
+target
+
+# Solana
+test-ledger
+
+docs
+
+swig-program
+swig.so
+.nx/cache
+.nx/workspace-data
+.cursor/rules/nx-rules.mdc
+.github/instructions/nx.instructions.md
+*.so
+
+# Python
+__pycache__/
+*.py[cod]
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.venv/
+*.egg-info/

swig_developer_sdk-0.6.0/PKG-INFO

@@ -0,0 +1,89 @@
+Metadata-Version: 2.4
+Name: swig-developer-sdk
+Version: 0.6.0
+Summary: Python SDK for preparing and locally signing Swig wallet transactions
+Project-URL: Repository, https://github.com/anagrambuild/swig-ts
+Author: Anagram
+License: Apache-2.0
+Requires-Python: >=3.10
+Requires-Dist: base58<3,>=2.1
+Requires-Dist: httpx<1,>=0.28
+Requires-Dist: solders<0.29,>=0.28
+Description-Content-Type: text/markdown
+
+# Swig Developer SDK for Python
+
+Python parity for `@swig-wallet/developer-sdk`. The Swig API prepares wallet
+transactions; this SDK invokes application-owned signers and inserts signatures
+locally with `solders`.
+
+```bash
+pip install swig-developer-sdk
+```
+
+## Prepare a transaction
+
+```python
+from swig_developer_sdk import SwigClient
+
+swig = SwigClient(api_key="swig_...", network="devnet")
+wallet = swig.wallets.use(
+    "SWIG_CONFIG_ADDRESS",
+    requester_authority={"ed25519": {"publicKey": "USER_PUBLIC_KEY"}},
+)
+
+prepared = await wallet.transfer.sol(
+    fee_payer="FEE_PAYER",
+    destination="DESTINATION",
+    amount=1_000_000,
+)
+```
+
+`wallet.transfer(...)` and `wallet.swap(...)` are callable like their
+TypeScript counterparts. Their explicit `sol`, `token`, `spl_token`, and
+`jupiter` methods are available as well.
+
+## Sign locally
+
+The generic signer helper works with an application-owned Ed25519 signer. The
+Swig signer helper patches secp256r1 or secp256k1 signatures into both legacy
+and versioned Solana transactions without sending signing material to the API.
+
+```python
+from swig_developer_sdk import sign_prepared_swig_transaction
+
+signed = await sign_prepared_swig_transaction(
+    prepared,
+    secp256r1=application_passkey_signer,
+)
+```
+
+WebAuthn and EIP-1193 adapters are callback-based so applications can connect
+their browser, hardware, wallet, or remote signer without changing the
+transaction preparation API.
+
+## Local end-to-end test
+
+With the `swig-dev-portal` Tilt stack running, this command seeds a temporary
+local API key and exercises wallet creation, real P-256 signing, direct and
+grouped SOL transfers, an SPL-token transfer, and the Python proxy through the
+Developer API. It also verifies the live paymaster balance endpoint and a
+sponsored transfer where the user pays no network fee. Every transaction is
+submitted to Surfpool and verified on-chain; the paymaster flow also retries
+with the same idempotency key and verifies that no balance changes repeat.
+
+```bash
+bun run e2e:developer-sdk:python
+```
+
+The defaults are `http://localhost:8080` for the Developer API,
+`http://localhost:8899` for Surfpool, and the Tilt Postgres instance on port
+`55432`. Override them with `SWIG_TRANSACTION_API_URL`, `SOLANA_RPC_URL`, or
+`SWIG_DATABASE_URL`.
+
+Jupiter and recovery are not counted by this local test: Jupiter needs a
+mainnet-backed Surfpool, while recovery setup needs a reachable operator
+signer.
+
+See the repository-level [parity matrix](../PARITY.md) for the complete mapped
+surface.

swig_developer_sdk-0.6.0/README.md

@@ -0,0 +1,76 @@
+# Swig Developer SDK for Python
+
+Python parity for `@swig-wallet/developer-sdk`. The Swig API prepares wallet
+transactions; this SDK invokes application-owned signers and inserts signatures
+locally with `solders`.
+
+```bash
+pip install swig-developer-sdk
+```
+
+## Prepare a transaction
+
+```python
+from swig_developer_sdk import SwigClient
+
+swig = SwigClient(api_key="swig_...", network="devnet")
+wallet = swig.wallets.use(
+    "SWIG_CONFIG_ADDRESS",
+    requester_authority={"ed25519": {"publicKey": "USER_PUBLIC_KEY"}},
+)
+
+prepared = await wallet.transfer.sol(
+    fee_payer="FEE_PAYER",
+    destination="DESTINATION",
+    amount=1_000_000,
+)
+```
+
+`wallet.transfer(...)` and `wallet.swap(...)` are callable like their
+TypeScript counterparts. Their explicit `sol`, `token`, `spl_token`, and
+`jupiter` methods are available as well.
+
+## Sign locally
+
+The generic signer helper works with an application-owned Ed25519 signer. The
+Swig signer helper patches secp256r1 or secp256k1 signatures into both legacy
+and versioned Solana transactions without sending signing material to the API.
+
+```python
+from swig_developer_sdk import sign_prepared_swig_transaction
+
+signed = await sign_prepared_swig_transaction(
+    prepared,
+    secp256r1=application_passkey_signer,
+)
+```
+
+WebAuthn and EIP-1193 adapters are callback-based so applications can connect
+their browser, hardware, wallet, or remote signer without changing the
+transaction preparation API.
+
+## Local end-to-end test
+
+With the `swig-dev-portal` Tilt stack running, this command seeds a temporary
+local API key and exercises wallet creation, real P-256 signing, direct and
+grouped SOL transfers, an SPL-token transfer, and the Python proxy through the
+Developer API. It also verifies the live paymaster balance endpoint and a
+sponsored transfer where the user pays no network fee. Every transaction is
+submitted to Surfpool and verified on-chain; the paymaster flow also retries
+with the same idempotency key and verifies that no balance changes repeat.
+
+```bash
+bun run e2e:developer-sdk:python
+```
+
+The defaults are `http://localhost:8080` for the Developer API,
+`http://localhost:8899` for Surfpool, and the Tilt Postgres instance on port
+`55432`. Override them with `SWIG_TRANSACTION_API_URL`, `SOLANA_RPC_URL`, or
+`SWIG_DATABASE_URL`.
+
+Jupiter and recovery are not counted by this local test: Jupiter needs a
+mainnet-backed Surfpool, while recovery setup needs a reachable operator
+signer.
+
+See the repository-level [parity matrix](../PARITY.md) for the complete mapped
+surface.

swig_developer_sdk-0.6.0/pyproject.toml

@@ -0,0 +1,49 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+name = "swig-developer-sdk"
+version = "0.6.0"
+description = "Python SDK for preparing and locally signing Swig wallet transactions"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "Apache-2.0" }
+authors = [{ name = "Anagram" }]
+dependencies = [
+  "base58>=2.1,<3",
+  "httpx>=0.28,<1",
+  "solders>=0.28,<0.29",
+]
+
+[project.urls]
+Repository = "https://github.com/anagrambuild/swig-ts"
+
+[dependency-groups]
+dev = [
+  "cryptography>=49.0.0",
+  "mypy>=1.16,<2",
+  "pytest>=8.4,<9",
+  "pytest-asyncio>=1.0,<2",
+  "ruff>=0.12,<1",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/swig_developer_sdk"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 88
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM", "RUF"]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+packages = ["swig_developer_sdk"]
+mypy_path = "src"