swig-developer-sdk 0.6.0__py3-none-any.whl

swig_developer_sdk-0.6.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,16 @@
+swig_developer_sdk/__init__.py,sha256=HH1LezUqV673pMoGrCaVijwXVBLUDUC0Tbe5v2rByCc,4680
+swig_developer_sdk/client.py,sha256=GlukId-lsmxpMlvZUSjMJnrmLOEGEmbQvn7kghprMHA,1053
+swig_developer_sdk/common.py,sha256=qtUIlyDiCeVvGyErJAKs8p1erOO__0jbU2zkVmmIMNQ,3548
+swig_developer_sdk/core.py,sha256=Muqt0Q_alsplmsjBWkx7F1j9j-lKC1SbI01JoC5j-CU,5382
+swig_developer_sdk/evm.py,sha256=b9-4OLY2xpwLyIlNkvAoL5GXgsUAy29ILjI7wkQyLVA,2048
+swig_developer_sdk/one_business.py,sha256=eDiwDVs9gfglXJlcQRi0CJS0oFdJeG0ApEc4jj-BObw,5129
+swig_developer_sdk/passkeys.py,sha256=yx3M5dJKSvjrEDUt416D0s-bpdyIoniNL1r0oVY3tX4,4177
+swig_developer_sdk/paymaster.py,sha256=pmdnKoQm8CiJbR_inJACXyhqw6S-dUShPYYH3y7-hm4,3351
+swig_developer_sdk/proxy.py,sha256=hfELdL5dJ5RUmeUa0gM5yNcyRNA7ymfUb2bOmbIXDfQ,26367
+swig_developer_sdk/ramp.py,sha256=nyBfSjJCxtnHFq1A6pk4IEBE2ZWzG-nYdp42ZtNZLhU,24269
+swig_developer_sdk/signing.py,sha256=rXVegrdrpTJUMJaDwFJgGmEBCOdMwgXrBK8dq8-njGM,15831
+swig_developer_sdk/transactions.py,sha256=EY_ti1-P2ayk63c1vqYnfnEjadhV5zJcqOo4Gfu7CHI,9082
+swig_developer_sdk/wallets.py,sha256=jG2kOg37TYN_aDegvFZK9iMk4QhZwwx7xAJwMH6QCQA,47356
+swig_developer_sdk-0.6.0.dist-info/METADATA,sha256=WPfzLtSRZYZO61Awn3zYdHkdQ_dILgGm0ssZbG8rk8A,2940
+swig_developer_sdk-0.6.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+swig_developer_sdk-0.6.0.dist-info/RECORD,,

swig_developer_sdk-0.6.0.dist-info/WHEEL

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