@1stdex/first-sdk 1.0.68 → 1.0.70

package/dist/types/calls/batch/index.d.ts

@@ -1,4 +1,5 @@
 export { prepareLimitOrderWithSetup } from './prepare-limit-order-with-setup';
 export { prepareMarketOrderWithSetup } from './prepare-market-order-with-setup';
+export { prepareWithdraw, NotEnoughFundsError } from './prepare-withdraw';
 export type { BatchCall } from './prepare-limit-order-with-setup';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/calls/batch/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/calls/batch/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAChF,YAAY,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/calls/batch/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,YAAY,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/types/calls/batch/prepare-withdraw.d.ts

@@ -0,0 +1,49 @@
+import { CHAIN_IDS } from '../../constants/chain-configs/chain';
+import { DefaultWriteContractOptions } from '../../types';
+import { BatchCall } from './prepare-limit-order-with-setup';
+/**
+ * Error thrown when there are insufficient funds in wallet and vault combined.
+ */
+export declare class NotEnoughFundsError extends Error {
+    readonly required: bigint;
+    readonly available: bigint;
+    constructor(message: string, required: bigint, available: bigint);
+}
+/**
+ * Prepares transactions to withdraw tokens optimally from wallet and/or vault to a recipient.
+ * If wallet has sufficient balance, transfers directly. Otherwise, withdraws the shortfall from
+ * vault to wallet (with approval if needed), then transfers the full amount to recipient.
+ * Throws NotEnoughFundsError if combined wallet + vault balance is insufficient.
+ *
+ * @param chainId The chain ID.
+ * @param userAddress The user address (wallet and vault owner).
+ * @param toAddress The recipient address.
+ * @param currency The currency/token address.
+ * @param amount The amount to send (in wei).
+ * @param options Optional parameters.
+ * @returns Promise resolving to array of batch calls.
+ * @example
+ * import { prepareWithdraw } from '@1stdex/first-sdk'
+ * import { useSmartWallets } from '@privy-io/react-auth/smart-wallets'
+ *
+ * const calls = await prepareWithdraw({
+ *   chainId: 421614,
+ *   userAddress: '0xF8c1869Ecd4df136693C45EcE1b67f85B6bDaE69',
+ *   toAddress: '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb',
+ *   currency: '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0',
+ *   amount: 1000000000000000000n // 1 token (18 decimals)
+ * })
+ *
+ * // Send all calls in one batched transaction
+ * const { client } = useSmartWallets()
+ * const txHash = await client.sendUserOperation({ calls })
+ */
+export declare const prepareWithdraw: ({ chainId, userAddress, toAddress, currency, amount, options, }: {
+    chainId: CHAIN_IDS;
+    userAddress: `0x${string}`;
+    toAddress: `0x${string}`;
+    currency: `0x${string}`;
+    amount: bigint;
+    options?: DefaultWriteContractOptions;
+}) => Promise<BatchCall[]>;
+//# sourceMappingURL=prepare-withdraw.d.ts.map

package/dist/types/calls/batch/prepare-withdraw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-withdraw.d.ts","sourceRoot":"","sources":["../../../../src/calls/batch/prepare-withdraw.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAa,MAAM,qCAAqC,CAAC;AAK3E,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAE7D;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;aAG1B,QAAQ,EAAE,MAAM;aAChB,SAAS,EAAE,MAAM;gBAFjC,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM;CAMpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,eAAe,oEAOzB;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;IAC3B,SAAS,EAAE,KAAK,MAAM,EAAE,CAAC;IACzB,QAAQ,EAAE,KAAK,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,2BAA2B,CAAC;CACvC,KAAG,QAAQ,SAAS,EAAE,CAiHtB,CAAC"}

package/dist/types/calls/index.d.ts

@@ -8,6 +8,6 @@ export { setApprovalOfOpenOrdersForAll } from './approval/open-order';
 export { setTokenAllowances } from './approval/token';
 export { approveAllForMarket } from './approval/market';
 export { setVault, removeVault, depositToVault, withdrawFromVault, } from './vault';
-export { prepareLimitOrderWithSetup, prepareMarketOrderWithSetup, } from './batch';
+export { prepareLimitOrderWithSetup, prepareMarketOrderWithSetup, prepareWithdraw, NotEnoughFundsError, } from './batch';
 export type { BatchCall } from './batch';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/calls/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/calls/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EACL,WAAW,EACX,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE5D,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,EACL,QAAQ,EACR,WAAW,EACX,cAAc,EACd,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/calls/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EACL,WAAW,EACX,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE5D,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,EACL,QAAQ,EACR,WAAW,EACX,cAAc,EACd,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,eAAe,EACf,mBAAmB,GACpB,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1stdex/first-sdk",
-  "version": "1.0.68",
+  "version": "1.0.70",
   "description": "🛠 An SDK for building applications on top of 1st V2",
   "files": [
     "dist"