SDK changes

Author: d4mr

sdk/src/services/BackendWalletService.ts

@@ -629,6 +629,72 @@ export class BackendWalletService {
         });
     }
 
+    /**
+     * Send a batch of raw transactions atomically
+     * Send a batch of raw transactions in a single UserOp. Can only be used with smart wallets.
+     * @param chain A chain ID ("137") or slug ("polygon-amoy-testnet"). Chain ID is preferred.
+     * @param xBackendWalletAddress Backend wallet address
+     * @param requestBody
+     * @param simulateTx Simulates the transaction before adding it to the queue, returning an error if it fails simulation. Note: This step is less performant and recommended only for debugging purposes.
+     * @param xIdempotencyKey Transactions submitted with the same idempotency key will be de-duplicated. Only the last 100000 transactions are compared.
+     * @param xAccountAddress Smart account address
+     * @param xAccountFactoryAddress Smart account factory address. If omitted, Engine will try to resolve it from the contract.
+     * @param xAccountSalt Smart account salt as string or hex. This is used to predict the smart account address. Useful when creating multiple accounts with the same admin and only needed when deploying the account as part of a userop.
+     * @returns any Default Response
+     * @throws ApiError
+     */
+    public sendTransactionsAtomic(
+        chain: string,
+        xBackendWalletAddress: string,
+        requestBody: {
+            transactions: Array<{
+                /**
+                 * A contract or wallet address
+                 */
+                toAddress?: string;
+                data: string;
+                value: string;
+            }>;
+        },
+        simulateTx: boolean = false,
+        xIdempotencyKey?: string,
+        xAccountAddress?: string,
+        xAccountFactoryAddress?: string,
+        xAccountSalt?: string,
+    ): CancelablePromise<{
+        result: {
+            /**
+             * Queue ID
+             */
+            queueId: string;
+        };
+    }> {
+        return this.httpRequest.request({
+            method: 'POST',
+            url: '/backend-wallet/{chain}/send-transactions-atomic',
+            path: {
+                'chain': chain,
+            },
+            headers: {
+                'x-backend-wallet-address': xBackendWalletAddress,
+                'x-idempotency-key': xIdempotencyKey,
+                'x-account-address': xAccountAddress,
+                'x-account-factory-address': xAccountFactoryAddress,
+                'x-account-salt': xAccountSalt,
+            },
+            query: {
+                'simulateTx': simulateTx,
+            },
+            body: requestBody,
+            mediaType: 'application/json',
+            errors: {
+                400: `Bad Request`,
+                404: `Not Found`,
+                500: `Internal Server Error`,
+            },
+        });
+    }
+
     /**
      * Sign a transaction
      * Sign a transaction
@@ -833,6 +899,7 @@ export class BackendWalletService {
                 onchainStatus: ('success' | 'reverted' | null);
                 effectiveGasPrice: (string | null);
                 cumulativeGasUsed: (string | null);
+                batchOperations: null;
             }>;
         };
     }> {
@@ -928,6 +995,7 @@ export class BackendWalletService {
                 onchainStatus: ('success' | 'reverted' | null);
                 effectiveGasPrice: (string | null);
                 cumulativeGasUsed: (string | null);
+                batchOperations: null;
             } | string);
         }>;
     }> {

sdk/src/services/ContractService.ts

@@ -46,6 +46,50 @@ export class ContractService {
         });
     }
 
+    /**
+     * Batch read from multiple contracts
+     * Execute multiple contract read operations in a single call using Multicall
+     * @param chain
+     * @param requestBody
+     * @returns any Default Response
+     * @throws ApiError
+     */
+    public readBatch(
+        chain: string,
+        requestBody: {
+            calls: Array<{
+                contractAddress: string;
+                functionName: string;
+                functionAbi?: string;
+                args?: Array<any>;
+            }>;
+            /**
+             * Address of the multicall contract to use. If omitted, multicall3 contract will be used (0xcA11bde05977b3631167028862bE2a173976CA11).
+             */
+            multicallAddress?: string;
+        },
+    ): CancelablePromise<{
+        results: Array<{
+            success: boolean;
+            result: any;
+        }>;
+    }> {
+        return this.httpRequest.request({
+            method: 'POST',
+            url: '/contract/{chain}/read-batch',
+            path: {
+                'chain': chain,
+            },
+            body: requestBody,
+            mediaType: 'application/json',
+            errors: {
+                400: `Bad Request`,
+                404: `Not Found`,
+                500: `Internal Server Error`,
+            },
+        });
+    }
+
     /**
      * Write to contract
      * Call a write function on a contract.

sdk/src/services/TransactionService.ts

@@ -78,6 +78,7 @@ export class TransactionService {
                 onchainStatus: ('success' | 'reverted' | null);
                 effectiveGasPrice: (string | null);
                 cumulativeGasUsed: (string | null);
+                batchOperations: null;
             }>;
             totalCount: number;
         };
@@ -162,6 +163,7 @@ export class TransactionService {
             onchainStatus: ('success' | 'reverted' | null);
             effectiveGasPrice: (string | null);
             cumulativeGasUsed: (string | null);
+            batchOperations: null;
         };
     }> {
         return this.httpRequest.request({
@@ -245,6 +247,7 @@ export class TransactionService {
                 onchainStatus: ('success' | 'reverted' | null);
                 effectiveGasPrice: (string | null);
                 cumulativeGasUsed: (string | null);
+                batchOperations: null;
             }>;
             totalCount: number;
         };

src/scripts/generate-sdk.ts

@@ -4,7 +4,7 @@ import path from "node:path";
 import { kill } from "node:process";
 
 const ENGINE_OPENAPI_URL = "https://demo.web3api.thirdweb.com/json";
-// const ENGINE_OPENAPI_URL = "http://localhost:3005/json";
+// const ENGINE_OPENAPI_URL = "http://127.0.0.1:3005/json";
 const REPLACE_LOG_FILE = "sdk/replacement_log.txt";
 
 type BasicOpenAPISpec = {

src/server/routes/webhooks/test.ts

@@ -93,6 +93,7 @@ export async function testWebhookRoute(fastify: FastifyInstance) {
         paymasterAndData: null,
         userOpHash: null,
         accountSalt: null,
+        batchOperations: null,
 
         // Off-chain details
         functionName: "transfer",