swig-developer-sdk 0.6.0__tar.gz → 0.7.0__tar.gz

{swig_developer_sdk-0.6.0 → swig_developer_sdk-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: swig-developer-sdk
-Version: 0.6.0
+Version: 0.7.0
 Summary: Python SDK for preparing and locally signing Swig wallet transactions
 Project-URL: Repository, https://github.com/anagrambuild/swig-ts
 Author: Anagram
@@ -39,6 +39,10 @@ prepared = await wallet.transfer.sol(
 )
 ```
 
+Use `wallet.build_transaction(...)` to supply raw Solana instructions for the
+backend to wrap in the Swig signing flow. The returned transaction is still
+signed and submitted client-side.
+
 `wallet.transfer(...)` and `wallet.swap(...)` are callable like their
 TypeScript counterparts. Their explicit `sol`, `token`, `spl_token`, and
 `jupiter` methods are available as well.

{swig_developer_sdk-0.6.0 → swig_developer_sdk-0.7.0}/README.md

@@ -26,6 +26,10 @@ prepared = await wallet.transfer.sol(
 )
 ```
 
+Use `wallet.build_transaction(...)` to supply raw Solana instructions for the
+backend to wrap in the Swig signing flow. The returned transaction is still
+signed and submitted client-side.
+
 `wallet.transfer(...)` and `wallet.swap(...)` are callable like their
 TypeScript counterparts. Their explicit `sol`, `token`, `spl_token`, and
 `jupiter` methods are available as well.

{swig_developer_sdk-0.6.0 → swig_developer_sdk-0.7.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "swig-developer-sdk"
-version = "0.6.0"
+version = "0.7.0"
 description = "Python SDK for preparing and locally signing Swig wallet transactions"
 readme = "README.md"
 requires-python = ">=3.10"

{swig_developer_sdk-0.6.0 → swig_developer_sdk-0.7.0}/src/swig_developer_sdk/wallets.py

@@ -295,7 +295,7 @@ class WalletsClient:
     ) -> PreparedTransactionsResult:
         authority = _requester_authority(wallet, requester_authority)
         response = await self._http.post(
-            "/transaction/prepare",
+            "/transaction/prepare/batch",
             {
                 **_base_write_request(
                     wallet, fee_payer, network, self._default_network
@@ -575,26 +575,29 @@ class WalletsClient:
             )
         )
 
-    async def execute(
+    async def build_transaction(
         self,
         wallet: WalletHandle,
         *,
+        fee_payer: str,
         instructions: Sequence[SolanaInstructionInput],
+        requester_authority: WalletAuthority | None = None,
         address_lookup_table_accounts: Sequence[str] | None = None,
         network: Network | None = None,
-        idempotency_key: str | None = None,
     ) -> PreparedTransaction:
+        authority = _requester_authority(wallet, requester_authority)
         return normalize_prepared_transaction(
             await self._http.post(
-                f"/v1/wallets/{quote(wallet.swig_config_address, safe='')}/execute",
+                "/transaction/prepare/custom",
                 {
-                    "wallet": wallet.swig_config_address,
-                    "network": network or wallet.network or self._default_network,
+                    **_base_write_request(
+                        wallet, fee_payer, network, self._default_network
+                    ),
+                    "requesterAuthority": wallet_authority_to_wire(authority),
                     "instructions": [
                         _instruction_to_wire(item) for item in instructions
                     ],
                     "addressLookupTableAccounts": address_lookup_table_accounts,
-                    "idempotencyKey": idempotency_key,
                 },
             )
         )
@@ -679,20 +682,22 @@ class WalletHandle:
             idempotency_key=idempotency_key,
         )
 
-    async def execute(
+    async def build_transaction(
         self,
         *,
+        fee_payer: str,
         instructions: Sequence[SolanaInstructionInput],
+        requester_authority: WalletAuthority | None = None,
         address_lookup_table_accounts: Sequence[str] | None = None,
         network: Network | None = None,
-        idempotency_key: str | None = None,
     ) -> PreparedTransaction:
-        return await self._wallets.execute(
+        return await self._wallets.build_transaction(
             self,
+            fee_payer=fee_payer,
             instructions=instructions,
+            requester_authority=requester_authority,
             address_lookup_table_accounts=address_lookup_table_accounts,
             network=network,
-            idempotency_key=idempotency_key,
         )
 
     async def get_usd_balance(

{swig_developer_sdk-0.6.0 → swig_developer_sdk-0.7.0}/tests/test_client.py

@@ -5,7 +5,14 @@ import json
 import httpx
 import pytest
 
-from swig_developer_sdk import RetryOptions, SwigClient, SwigDeveloperSdkError
+from swig_developer_sdk import (
+    RetryOptions,
+    SolanaAccountMeta,
+    SolanaInstructionInput,
+    SwigClient,
+    SwigDeveloperSdkError,
+    TransferSolOperation,
+)
 
 
 async def test_wallet_transfer_matches_typescript_wire_contract() -> None:
@@ -65,6 +72,111 @@ async def test_wallet_transfer_matches_typescript_wire_contract() -> None:
     }
 
 
+async def test_wallet_prepare_uses_batch_preparation_endpoint() -> None:
+    requests: list[httpx.Request] = []
+
+    def handler(request: httpx.Request) -> httpx.Response:
+        requests.append(request)
+        return httpx.Response(
+            200,
+            json={"data": {"transactions": [], "network": "NETWORK_DEVNET"}},
+        )
+
+    swig = SwigClient(
+        api_key="secret",
+        base_url="https://example.test",
+        network="devnet",
+        transport=httpx.MockTransport(handler),
+    )
+    wallet = swig.wallets.use(
+        "swig-address",
+        requester_authority={"ed25519": {"publicKey": "requester"}},
+    )
+
+    await wallet.prepare(
+        fee_payer="payer",
+        operations=(TransferSolOperation(destination="destination", amount=123),),
+    )
+
+    assert requests[0].url.path == "/transaction/prepare/batch"
+    assert json.loads(requests[0].content) == {
+        "network": "NETWORK_DEVNET",
+        "feePayer": "payer",
+        "swigAddress": "swig-address",
+        "requesterAuthority": {"ed25519": {"publicKey": "requester"}},
+        "operations": [
+            {"transferSol": {"destination": "destination", "lamports": "123"}}
+        ],
+    }
+
+
+async def test_wallet_build_transaction_matches_custom_preparation_contract() -> None:
+    requests: list[httpx.Request] = []
+
+    def handler(request: httpx.Request) -> httpx.Response:
+        requests.append(request)
+        return httpx.Response(
+            200,
+            json={
+                "data": {
+                    "transaction": "prepared-custom-base64",
+                    "transactionEncoding": "TRANSACTION_ENCODING_BASE64",
+                    "network": "NETWORK_DEVNET",
+                }
+            },
+        )
+
+    swig = SwigClient(
+        api_key="secret",
+        base_url="https://example.test",
+        network="devnet",
+        transport=httpx.MockTransport(handler),
+    )
+    wallet = swig.wallets.use(
+        "swig-address",
+        requester_authority={"ed25519": {"publicKey": "requester"}},
+    )
+
+    prepared = await wallet.build_transaction(
+        fee_payer="payer",
+        instructions=(
+            SolanaInstructionInput(
+                program_id="program",
+                accounts=(
+                    SolanaAccountMeta(
+                        pubkey="account", is_signer=True, is_writable=True
+                    ),
+                ),
+                data=b"\x01\x02\x03",
+            ),
+        ),
+        address_lookup_table_accounts=("lookup-table",),
+    )
+
+    assert prepared.transaction == "prepared-custom-base64"
+    assert requests[0].url.path == "/transaction/prepare/custom"
+    assert json.loads(requests[0].content) == {
+        "network": "NETWORK_DEVNET",
+        "feePayer": "payer",
+        "swigAddress": "swig-address",
+        "requesterAuthority": {"ed25519": {"publicKey": "requester"}},
+        "instructions": [
+            {
+                "programId": "program",
+                "accounts": [
+                    {
+                        "pubkey": "account",
+                        "isSigner": True,
+                        "isWritable": True,
+                    }
+                ],
+                "data": "AQID",
+            }
+        ],
+        "addressLookupTableAccounts": ["lookup-table"],
+    }
+
+
 async def test_http_client_does_not_retry_client_errors() -> None:
     attempts = 0
 

{swig_developer_sdk-0.6.0 → swig_developer_sdk-0.7.0}/uv.lock

@@ -575,7 +575,7 @@ wheels = [
 
 [[package]]
 name = "swig-developer-sdk"
-version = "0.6.0"
+version = "0.7.0"
 source = { editable = "." }
 dependencies = [
     { name = "base58" },