@deserialize/multi-vm-wallet 1.4.12 → 1.5.1

package/dist/svm/utils.js

@@ -1,5 +1,4 @@
 "use strict";
-//we will write all the svm utils function here
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getNFTCollection = exports.fetchWalletNfts = exports.transformSolanaNFTToUnified = exports.validateJupiterTokens = exports.getJupiterTokenList = exports.baseUnitsToUiAmount = exports.uiAmountToBaseUnits = exports.executeJupiterSwap = exports.buildJupiterSwapTransaction = exports.getJupiterQuote = exports.discoverTokens = exports.signAndSendTransaction = exports.sendTransaction = exports.signTransaction = exports.getTransferTokenTransaction = exports.getTransferTokenInx = exports.getTokenInfo = exports.getTransferNativeTransaction = exports.getTransferNativeInx = exports.getTokenAccountAccount = exports.getTokenBalance = exports.getSvmNativeBalance = exports.getProgramIdOfToken = exports.getSureAssociatedTokenAddressAndAccount = exports.createAtaAndIx = exports.createV0Transaction = void 0;
 const spl_token_1 = require("@solana/spl-token");
@@ -106,7 +105,6 @@ const getProgramIdOfToken = async (owner, token, connection) => {
     }
 };
 exports.getProgramIdOfToken = getProgramIdOfToken;
-//get native balance
 const getSvmNativeBalance = async (address, connection) => {
     const balance = await connection.getBalance(address);
     return { balance: new bn_js_1.BN(balance), formatted: balance / web3_js_1.LAMPORTS_PER_SOL, decimal: 9 };
@@ -114,7 +112,6 @@ const getSvmNativeBalance = async (address, connection) => {
 exports.getSvmNativeBalance = getSvmNativeBalance;
 const getTokenBalance = async (address, token, connection) => {
     try {
-        // Get the balance from the token account
         const tokenAccount = await (0, exports.getTokenAccountAccount)(token, address, connection);
         if (!tokenAccount) {
             console.log("Token account not found");
@@ -137,12 +134,8 @@ const getTokenBalance = async (address, token, connection) => {
 exports.getTokenBalance = getTokenBalance;
 const getTokenAccountAccount = async (token, address, connection) => {
     try {
-        // Get the associated token account address for the user and the token mint
-        const associatedTokenAccount = await (0, spl_token_1.getAssociatedTokenAddress)(token, // The token mint address
-        address // The user's public key
-        );
+        const associatedTokenAccount = await (0, spl_token_1.getAssociatedTokenAddress)(token, address);
         console.log('Associated token account:', associatedTokenAccount.toString());
-        // Fetch the token account information
         const tokenAccount = await (0, spl_token_1.getAccount)(connection, associatedTokenAccount);
         console.log('Token account retrieved successfully');
         return tokenAccount;
@@ -157,7 +150,7 @@ const getTransferNativeInx = async (from, to, amount) => {
     return web3_js_1.SystemProgram.transfer({
         fromPubkey: from,
         toPubkey: to,
-        lamports: amount * web3_js_1.LAMPORTS_PER_SOL, // Convert SOL to lamports
+        lamports: amount * web3_js_1.LAMPORTS_PER_SOL,
     });
 };
 exports.getTransferNativeInx = getTransferNativeInx;
@@ -176,7 +169,6 @@ const getMetaTokenMetaplexData = async (mintAddress, connection) => {
 };
 const fetchMetadataFromUri = async (uri) => {
     try {
-        // Convert IPFS URI to HTTP gateway if needed
         let fetchUrl = uri;
         if (uri.startsWith('ipfs://')) {
             fetchUrl = uri.replace('ipfs://', 'https://ipfs.io/ipfs/');
@@ -203,14 +195,12 @@ const fetchMetadataFromUri = async (uri) => {
 const getTokenInfo = async (tokenAddress, connection, programId) => {
     let mint;
     const metaplexData = await getMetaTokenMetaplexData(tokenAddress, connection).catch(() => null);
-    // Fetch metadata from URI if available
     let uriMetadata = null;
     if (metaplexData?.uri) {
         uriMetadata = await fetchMetadataFromUri(metaplexData.uri).catch(() => null);
     }
     if (programId) {
         const mint = await (0, spl_token_1.getMint)(connection, tokenAddress, "confirmed", programId);
-        // Build social object from metadata
         const social = {};
         if (uriMetadata?.twitter || uriMetadata?.extensions?.twitter) {
             social.twitter = uriMetadata.twitter || uriMetadata.extensions?.twitter;
@@ -221,7 +211,6 @@ const getTokenInfo = async (tokenAddress, connection, programId) => {
         if (uriMetadata?.discord || uriMetadata?.extensions?.discord) {
             social.discord = uriMetadata.discord || uriMetadata.extensions?.discord;
         }
-        // Add any other social fields from extensions
         if (uriMetadata?.extensions) {
             Object.keys(uriMetadata.extensions).forEach(key => {
                 if (!['twitter', 'telegram', 'discord', 'website'].includes(key) && uriMetadata.extensions[key]) {
@@ -247,7 +236,6 @@ const getTokenInfo = async (tokenAddress, connection, programId) => {
         console.log('error: ', error);
         mint = await (0, spl_token_1.getMint)(connection, tokenAddress, "confirmed", spl_token_1.TOKEN_2022_PROGRAM_ID);
     }
-    // Build social object from metadata
     const social = {};
     if (uriMetadata?.twitter || uriMetadata?.extensions?.twitter) {
         social.twitter = uriMetadata.twitter || uriMetadata.extensions?.twitter;
@@ -258,7 +246,6 @@ const getTokenInfo = async (tokenAddress, connection, programId) => {
     if (uriMetadata?.discord || uriMetadata?.extensions?.discord) {
         social.discord = uriMetadata.discord || uriMetadata.extensions?.discord;
     }
-    // Add any other social fields from extensions
     if (uriMetadata?.extensions) {
         Object.keys(uriMetadata.extensions).forEach(key => {
             if (!['twitter', 'telegram', 'discord', 'website'].includes(key) && uriMetadata.extensions[key]) {
@@ -341,7 +328,6 @@ exports.sendTransaction = sendTransaction;
 const signAndSendTransaction = async (transaction, connection, signers, options) => {
     console.log('signAndSendTransaction: Starting');
     const signedTx = await (0, exports.signTransaction)(transaction, signers);
-    // If feePayer is provided, also sign with feePayer
     if (options?.feePayerSigner) {
         console.log('Signing transaction with fee payer');
         if (transaction instanceof web3_js_1.Transaction) {
@@ -369,7 +355,6 @@ const discoverTokens = async (ownerAddress, connection) => {
     const tokens = await Promise.all(response.value.map(async (accountInfo) => {
         const mintAddress = accountInfo.account.data["parsed"]["info"]["mint"];
         const mint = await (0, exports.getTokenInfo)(new web3_js_1.PublicKey(mintAddress), connection);
-        // console.log('mint: ', mint);
         return {
             owner: accountInfo.account.data["parsed"]["info"]["owner"],
             address: accountInfo.account.data["parsed"]["info"]["mint"],
@@ -383,14 +368,7 @@ const discoverTokens = async (ownerAddress, connection) => {
     return tokens;
 };
 exports.discoverTokens = discoverTokens;
-//swap
-//you will. use jupiter for this
 const getJupiterQuote = async (inputMint, outputMint, amount, slippageBps = 50) => {
-    // console.log('getJupiterQuote: Starting');
-    // console.log('Input mint:', inputMint);
-    // console.log('Output mint:', outputMint);
-    // console.log('Amount:', amount);
-    // console.log('Slippage BPS:', slippageBps);
     const params = new URLSearchParams({
         inputMint,
         outputMint,
@@ -462,7 +440,6 @@ const buildJupiterSwapTransaction = async (quote, userPublicKey, prioritizationF
         try {
             const error = await response.json();
             console.log('Swap build error details:', error);
-            // Check if this is the shared accounts error
             if (error.errorCode === 'NOT_SUPPORTED' &&
                 error.error?.includes('Simple AMMs are not supported with shared accounts')) {
                 console.log('Detected shared accounts incompatibility error');
@@ -472,7 +449,6 @@ const buildJupiterSwapTransaction = async (quote, userPublicKey, prioritizationF
         }
         catch (parseError) {
             console.log('Failed to parse error response:', parseError);
-            // Re-throw if it's our custom error
             if (parseError instanceof Error && parseError.message === 'SHARED_ACCOUNTS_NOT_SUPPORTED') {
                 throw parseError;
             }
@@ -505,21 +481,17 @@ const executeJupiterSwap = async (swapParams, connection, payer) => {
         let usedSharedAccounts = true;
         try {
             console.log('Building swap transaction with shared accounts enabled...');
-            swapResponse = await (0, exports.buildJupiterSwapTransaction)(quote, swapParams.userPublicKey.toString(), undefined, true // Try with shared accounts first
-            );
+            swapResponse = await (0, exports.buildJupiterSwapTransaction)(quote, swapParams.userPublicKey.toString(), undefined, true);
             console.log('Successfully built transaction with shared accounts');
         }
         catch (error) {
             if (error instanceof Error && error.message === 'SHARED_ACCOUNTS_NOT_SUPPORTED') {
                 console.log('Shared accounts not supported, retrying without shared accounts...');
-                // Retry without shared accounts
-                swapResponse = await (0, exports.buildJupiterSwapTransaction)(quote, swapParams.userPublicKey.toString(), undefined, false // Retry with shared accounts disabled
-                );
+                swapResponse = await (0, exports.buildJupiterSwapTransaction)(quote, swapParams.userPublicKey.toString(), undefined, false);
                 usedSharedAccounts = false;
                 console.log('Successfully built transaction without shared accounts');
             }
             else {
-                // Re-throw if it's a different error
                 throw error;
             }
         }
@@ -642,8 +614,8 @@ const transformSolanaNFTToUnified = (nft) => {
         id: nft.mint,
         name: nft.name,
         symbol: nft.symbol,
-        description: '', // Will be populated from metadata URI if needed
-        image: undefined, // Will be populated from metadata URI if needed
+        description: '',
+        image: undefined,
         uri: nft.uri,
         collection: {
             address: nft.mint,
@@ -651,7 +623,7 @@ const transformSolanaNFTToUnified = (nft) => {
             verified: nft.creators?.some(c => c.verified) ?? false,
         },
         chainType: 'SVM',
-        balance: '1', // NFTs on Solana are typically quantity 1
+        balance: '1',
         creators: nft.creators,
         sellerFeeBasisPoints: nft.sellerFeeBasisPoints,
         tokenStandard: 'NonFungible',
@@ -665,16 +637,12 @@ const fetchWalletNfts = async (walletAddress, connection) => {
     console.log('fetchWalletNfts: Starting');
     console.log('Wallet address:', walletAddress.toString());
     try {
-        // Create UMI instance with the connection's RPC endpoint
         const umi = (0, umi_bundle_defaults_1.createUmi)(connection.rpcEndpoint).use((0, mpl_token_metadata_1.mplTokenMetadata)());
         console.log('UMI instance created with RPC endpoint:', connection.rpcEndpoint);
-        // Convert Solana PublicKey to UMI PublicKey
         const owner = (0, umi_1.publicKey)(walletAddress.toString());
         console.log('Fetching NFTs for owner:', owner);
-        // Fetch all digital assets owned by the wallet
         const assets = await (0, mpl_token_metadata_1.fetchAllDigitalAssetByOwner)(umi, owner);
         console.log('Fetched assets count:', assets.length);
-        // Transform the assets into our SolanaNFT format
         const solanaNfts = assets.map((asset) => {
             const metadata = asset.metadata;
             return {
@@ -693,7 +661,6 @@ const fetchWalletNfts = async (walletAddress, connection) => {
                     : undefined,
             };
         });
-        // Transform to unified NFT format
         const nfts = solanaNfts.map(exports.transformSolanaNFTToUnified);
         console.log('fetchWalletNfts: Successfully fetched', nfts.length, 'NFTs');
         return nfts;
@@ -705,45 +672,28 @@ const fetchWalletNfts = async (walletAddress, connection) => {
     }
 };
 exports.fetchWalletNfts = fetchWalletNfts;
-/**
- * Get NFT collection details for a specific collection on Solana
- * @param walletAddress - User's wallet public key
- * @param collectionAddress - The NFT collection address (can be collection mint or update authority)
- * @param connection - Solana connection
- * @returns NFTCollection object with collection details and user's NFTs in that collection
- *
- * Note: On Solana, collections can be identified by:
- * - Collection mint address (from collection field in NFT metadata)
- * - Update authority (who can modify the NFT metadata)
- * This function filters by the collection.address field which is typically the collection mint
- */
 const getNFTCollection = async (walletAddress, collectionAddress, connection) => {
     console.log('getNFTCollection: Starting collection fetch');
     console.log('Wallet address:', walletAddress.toString());
     console.log('Collection Address:', collectionAddress);
     try {
-        // Fetch all NFTs for the user
         const allNfts = await (0, exports.fetchWalletNfts)(walletAddress, connection);
         console.log('getNFTCollection: Fetched', allNfts.length, 'total NFTs');
-        // Filter NFTs by collection address (case-insensitive comparison)
-        // On Solana, we match against the collection.address which is set from the mint
         const collectionNfts = allNfts.filter(nft => nft.collection.address.toLowerCase() === collectionAddress.toLowerCase());
         console.log('getNFTCollection: Found', collectionNfts.length, 'NFTs in collection');
         if (collectionNfts.length === 0) {
             console.log('getNFTCollection: No NFTs found in this collection');
             return null;
         }
-        // Extract collection metadata from the first NFT
         const firstNft = collectionNfts[0];
         const rawSvmNft = firstNft.raw?.svm;
-        // Aggregate creators from all NFTs (they should be the same for a collection)
         const creators = firstNft.creators;
         const collection = {
             address: collectionAddress,
             name: firstNft.collection.name,
             symbol: firstNft.symbol,
-            description: undefined, // Could be fetched from URI metadata if needed
-            image: undefined, // Solana collections don't have a single image
+            description: undefined,
+            image: undefined,
             verified: firstNft.collection.verified,
             chainType: 'SVM',
             nfts: collectionNfts,
@@ -764,4 +714,3 @@ const getNFTCollection = async (walletAddress, collectionAddress, connection) =>
     }
 };
 exports.getNFTCollection = getNFTCollection;
-//# sourceMappingURL=utils.js.map

package/dist/test.d.ts

@@ -1,5 +1 @@
 export {};
-/**
- * Fetches and logs the token metadata for a given mint address.
- * @param mintAddress - The mint address of the token.
- */

package/dist/test.js

@@ -7,20 +7,10 @@ const chains_1 = require("viem/chains");
 const account_abstraction_1 = require("viem/account-abstraction");
 const constants_1 = require("@zerodev/sdk/constants");
 const aa_service_1 = require("./evm/aa-service");
-// const mnemonic = GenerateNewMnemonic()
-// console.log('mnemonic: ', mnemonic);
-// const seed = VM.mnemonicToSeed(mnemonic)
+const savings_1 = require("./savings");
 const pKey = "";
-// const testUserKeyPair = Keypair.fromSecretKey(base58.decode(pKey));
-// const x = testUserKeyPair instanceof Keypair;
-const evmPrivKey = "0xc9ca95aa5f40bae8b0f741ec89acc07b837590b2f9f818d3439df98c6e4f8dbe";
-const evmPrivateKeyExposed = "0x92cccc7792024dcac5992e5d2986dade41770acfd3dab0fe98ee953ed1bf0c3a";
-// const vm = new SVMVM(seed)
-// const vmFromMnemonic = SVMVM.fromMnemonic(mnemonic)
-// const keyFromMnemonic = vmFromMnemonic.generatePrivateKey(0)
-// console.log('keyFromMnemonic: ', keyFromMnemonic.privateKey.publicKey);
-// const key = vm.generatePrivateKey(0)
-// console.log('key: ', key.privateKey.publicKey);
+const evmPrivKey = "0xcd90354282b35344616d6b53684684bef6e8673ed601d562a5866dc67fafd1ef";
+const evmPrivateKeyExposed = "0xcd90354282b35344616d6b53684684bef6e8673ed601d562a5866dc67fafd1ef";
 const chainConfig = {
     chainId: 123456789,
     name: "Solana",
@@ -34,7 +24,6 @@ const chainConfig = {
 const evmChainConfig = {
     chainId: 8453,
     name: "Base",
-    // rpcUrl: "https://base-mainnet.g.alchemy.com/v2/TFdA4BilCnKIwaqtypk0d",
     rpcUrl: chains_1.base.rpcUrls.default.http[0],
     explorerUrl: "https://explorer.ethereum.com",
     nativeToken: { name: "Ethereum", symbol: "ETH", decimals: 18 },
@@ -69,11 +58,9 @@ const OgChainConfig = {
     vmType: "EVM",
     logoUrl: ""
 };
-// const wallet = new SVMChainWallet(chainConfig, testUserKeyPair, 0)
 const wallet = new evm_1.EVMChainWallet(evmChainConfig, evmPrivateKeyExposed, 0);
-//IIFE
-const walletA = new evm_1.EVMChainWallet(evmChainConfig, evmPrivateKeyExposed, 0); //wallet that has usdc to send
-const walletB = new evm_1.EVMChainWallet(evmChainConfig, evmPrivKey, 0); // wallet that has gas
+const walletA = new evm_1.EVMChainWallet(evmChainConfig, evmPrivateKeyExposed, 0);
+const walletB = new evm_1.EVMChainWallet(evmChainConfig, evmPrivKey, 0);
 const SEPOLIA_USDC_ADDRESS = '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238';
 const BASE_USDC_ADDRESS = '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913';
 const bundlerUrl = `https://api.pimlico.io/v2/${evmChainConfig.chainId}/rpc?apikey=pim_3UEhbTpS98H1XFm8p9kRxg`;
@@ -84,28 +71,21 @@ const testSessionKeys = async () => {
     console.log('walletA native balance: ', walletANativeBalance);
     const walletBNativeBalance = await walletB.getNativeBalance();
     console.log('walletB native balance: ', walletBNativeBalance);
-    //wallet B USDC balance
     const walletBUSDCBalance = await walletB.getTokenBalance(BASE_USDC_ADDRESS);
     console.log('walletB USDC balance: ', walletBUSDCBalance);
     console.log("walletB address: ", walletB.address);
-    //extend wallet A wallet to a smart wallet with AA support
     const extendedWalletA = await walletA.extend({
         bundlerUrl: bundlerUrl
     });
-    // console.log('extendedWalletA: ', extendedWalletA);
     const initializedExtendedWalletA = await extendedWalletA.initialize();
-    //now we want to test session keys 
     const sessionKeys = await initializedExtendedWalletA.generateSessionKey();
     console.log('sessionKeys: ', sessionKeys);
-    // return;
-    const usdcPermission = initializedExtendedWalletA.createUSDCPermission(BASE_USDC_ADDRESS, "1", // approve up to 100 USDC,
-    RECIPIENT);
+    const usdcPermission = initializedExtendedWalletA.createUSDCPermission(BASE_USDC_ADDRESS, "1", RECIPIENT);
     console.log('usdcPermission: ', usdcPermission);
     const sessionKeyApproval = await initializedExtendedWalletA.approveSessionKey({
         sessionKeyAddress: sessionKeys.address,
         sessionKeyPrivateKey: sessionKeys.privateKey,
         permissions: [usdcPermission],
-        // useSudoPolicy: true,
     });
     const data = (0, viem_1.encodeFunctionData)({
         abi: (0, viem_1.parseAbi)([
@@ -113,14 +93,13 @@ const testSessionKeys = async () => {
         ]),
         functionName: 'transfer',
         args: [RECIPIENT, (0, viem_1.parseUnits)('0.01', 6)]
-    }); // transfer 10 USDC
+    });
     console.log('sessionKeyApproval: ', sessionKeyApproval);
     const sessionKeyAccount = await (0, aa_service_1.deserializeSessionKey)({
         approval: sessionKeyApproval,
         sessionKeySigner: sessionKeys.signer,
         chain: chains_1.base
     });
-    //send transaction using session key
     const sessionAccount = {
         account: sessionKeyAccount,
         address: sessionKeyAccount.address,
@@ -129,82 +108,23 @@ const testSessionKeys = async () => {
         sessionAccount: sessionAccount
     });
     console.log('hash: ', hash);
-    //get session key client
 };
 const testModule = async () => {
     const extendedWalletA = await walletA.extend({
         bundlerUrl: bundlerUrl
     });
     const initializedExtendedWalletA = await extendedWalletA.initialize();
-    //this is where we will test installation of modules
 };
 const testPrice = async () => {
     walletA.getPrices(['0x98d0baa52b2D063E780DE12F615f963Fe8537553']).then(console.log);
 };
-// testPrice()
-// console.log('wallet: ', wallet);
-// getTokenInfo(new PublicKey("9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump"), wallet.connection!).then(e => console.log('token info: ', e))
-// wallet.getNativeBalance().then(e => console.log('native balance: ', e))
-// const toBuy = new PublicKey("9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump")
-// wallet.swap({
-//     name: NATIVE_MINT.toBase58(),
-//     address: NATIVE_MINT.toBase58(),
-//     symbol: NATIVE_MINT.toBase58(),
-//     decimals: 9
-// }, toBuy, 0.005,).then(res => console.log(res))
-// console.log('wal: ', wal.address);
-// wal.getNativeBalance().then(e => console.log(e))
+const testSavingsPocket = async () => {
+    const mnemonic = evm_1.EVMVM.generateMnemonicFromPrivateKey(evmPrivateKeyExposed);
+    console.log('mnemonic: ', mnemonic);
+    const savingsManager = new savings_1.SavingsManager(mnemonic, evmChainConfig, wallet.index);
+    const pocket0 = savingsManager.getPocket(0);
+    const balance = await savingsManager.getPocketTokenBalance([], 0);
+    console.log('balance: ', balance);
+};
 const RPC_URL = chainConfig.rpcUrl;
 const connection = new web3_js_1.Connection(RPC_URL);
-// const evmConnection = new JsonRpcProvider(evmChainConfig.rpcUrl, {
-//     chainId: evmChainConfig.chainId
-// });
-/**
- * Fetches and logs the token metadata for a given mint address.
- * @param mintAddress - The mint address of the token.
- */
-// get transaction history
-// getTransactionHistory(
-//     connection,
-//     wallet.address,
-//     {
-//         limit: 2,
-//         before: "5RKG5zKJdz9PqWSav1J358hm1GtfnV1QnYcrw3sRpY7aCgT7f4HTKnp4c9pXrJRujcHHisu3Z6jdtbzq5aTRbikq"
-//     }
-// ).then((history: any) => {
-//     console.log("Transaction History:", history);
-// }).catch((error: any) => {
-//     console.error("Error fetching transaction history:", error);
-// });
-// const client = createPublicClient({
-//     chain: base,
-//     transport: http(base.rpcUrls.default.http[0]),
-// })
-// getEVMTransactionHistory(client as PublicClient, "0x9C82CE0e125F61AdE50BC0c19638F6Ba93d71D5e", {
-//     startBlock: BigInt(37427020)
-//     // before: "0xabc..."
-// }).then((history: any) => {
-//     console.log("EVM Transaction History:", history);
-// }).catch((error: any) => {
-//     console.error("Error fetching EVM transaction history:", error);
-// });
-// discoverNFTs("0x498581ff718922c3f8e6a244956af099b2652b2b", evmChainConfig).then(nfts => {
-//     console.log("Discovered NFTs:", nfts);
-// }).catch(error => {
-//     console.error("Error discovering NFTs:", error);
-// });
-// fetchWalletNfts(new PublicKey("LebronkTYWjc5J1gtqntdMcbhBXgwRgYcCxMA8JMA17"), connection).then(nfts => {
-//     console.log("Discovered NFTs:", nfts);
-// }).catch(error => {
-//     console.error("Error discovering NFTs:", error);
-// });
-// discoverTokens(new PublicKey("8AXoqNjEVyhhe43ckDEsYiphWxTBH2oWXkKLZAbCNWLL"), connection).then(tokens => {
-//     console.log("Discovered Tokens:", tokens);
-// }).catch(error => {
-//     console.error("Error discovering Tokens:", error);
-// });
-// //IIFE
-// (async () => {
-//     //GET TOKEN LOGO using @solana/spl-token-metadata
-// })();
-//# sourceMappingURL=test.js.map

package/dist/transaction-utils.d.ts

@@ -0,0 +1,38 @@
+import { JsonRpcProvider } from 'ethers';
+export interface AmountValidationOptions {
+    maxAmount?: bigint;
+    minAmount?: bigint;
+    requirePositive?: boolean;
+    allowFullBalance?: boolean;
+}
+export declare function validateTransferAmount(amount: bigint, balance: bigint, options?: AmountValidationOptions): void;
+export declare function waitForTransaction(txResponse: any, confirmations?: number, timeoutMs?: number): Promise<any>;
+export declare class NonceManager {
+    private pendingNonces;
+    private provider;
+    constructor(provider: JsonRpcProvider);
+    getNextNonce(address: string, forceRefresh?: boolean): Promise<number>;
+    releaseNonce(address: string, nonce: number): void;
+    clearNonces(address: string): void;
+    clearAll(): void;
+}
+export declare function estimateGasWithMargin(provider: JsonRpcProvider, tx: any, marginPercent?: number): Promise<bigint>;
+export declare function calculateMaxTransferAmount(balance: bigint, gasLimit: bigint, gasPrice: bigint): bigint;
+export declare function checkSufficientGas(balance: bigint, amount: bigint, gasLimit: bigint, gasPrice: bigint): boolean;
+export declare class TransactionBuilder {
+    private provider;
+    private tx;
+    constructor(provider: JsonRpcProvider);
+    to(address: string): this;
+    value(amount: bigint): this;
+    data(data: string): this;
+    gasLimit(limit: bigint): this;
+    gasPrice(price: bigint): this;
+    maxFeePerGas(fee: bigint): this;
+    maxPriorityFeePerGas(fee: bigint): this;
+    nonce(nonce: number): this;
+    build(options?: {
+        addGasMargin?: boolean;
+        marginPercent?: number;
+    }): Promise<any>;
+}

package/dist/transaction-utils.js

@@ -0,0 +1,168 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionBuilder = exports.NonceManager = void 0;
+exports.validateTransferAmount = validateTransferAmount;
+exports.waitForTransaction = waitForTransaction;
+exports.estimateGasWithMargin = estimateGasWithMargin;
+exports.calculateMaxTransferAmount = calculateMaxTransferAmount;
+exports.checkSufficientGas = checkSufficientGas;
+function validateTransferAmount(amount, balance, options) {
+    const { maxAmount, minAmount = 1n, requirePositive = true, allowFullBalance = false } = options || {};
+    if (requirePositive && amount <= 0n) {
+        throw new Error(`Amount must be positive, got: ${amount}`);
+    }
+    if (amount < minAmount) {
+        throw new Error(`Amount below minimum: ${amount} < ${minAmount}`);
+    }
+    if (maxAmount && amount > maxAmount) {
+        throw new Error(`Amount exceeds maximum: ${amount} > ${maxAmount}`);
+    }
+    if (amount > balance) {
+        throw new Error(`Insufficient balance: ${amount} > ${balance}`);
+    }
+    if (!allowFullBalance && amount === balance) {
+        throw new Error('Transferring entire balance requires explicit confirmation. ' +
+            'Set allowFullBalance: true to proceed, or leave some balance for gas fees.');
+    }
+}
+async function waitForTransaction(txResponse, confirmations = 1, timeoutMs = 60000) {
+    const txHash = txResponse.hash;
+    const timeoutPromise = new Promise((_, reject) => setTimeout(() => reject(new Error(`Transaction confirmation timeout after ${timeoutMs}ms`)), timeoutMs));
+    const confirmationPromise = txResponse.wait(confirmations);
+    try {
+        const receipt = await Promise.race([
+            confirmationPromise,
+            timeoutPromise
+        ]);
+        return receipt;
+    }
+    catch (error) {
+        if (error.message.includes('timeout')) {
+            throw new Error(`Transaction not confirmed after ${timeoutMs}ms. ` +
+                `Hash: ${txHash}. Check block explorer for status.`);
+        }
+        throw error;
+    }
+}
+class NonceManager {
+    pendingNonces = new Map();
+    provider;
+    constructor(provider) {
+        this.provider = provider;
+    }
+    async getNextNonce(address, forceRefresh = false) {
+        if (forceRefresh) {
+            this.pendingNonces.delete(address);
+        }
+        const chainNonce = await this.provider.getTransactionCount(address, 'latest');
+        const pendingNonce = this.pendingNonces.get(address);
+        const nextNonce = pendingNonce !== undefined
+            ? Math.max(chainNonce, pendingNonce)
+            : chainNonce;
+        this.pendingNonces.set(address, nextNonce + 1);
+        return nextNonce;
+    }
+    releaseNonce(address, nonce) {
+        const pending = this.pendingNonces.get(address);
+        if (pending === nonce + 1) {
+            this.pendingNonces.set(address, nonce);
+        }
+    }
+    clearNonces(address) {
+        this.pendingNonces.delete(address);
+    }
+    clearAll() {
+        this.pendingNonces.clear();
+    }
+}
+exports.NonceManager = NonceManager;
+async function estimateGasWithMargin(provider, tx, marginPercent = 20) {
+    try {
+        const estimate = await provider.estimateGas(tx);
+        const margin = (estimate * BigInt(marginPercent)) / 100n;
+        const withMargin = estimate + margin;
+        try {
+            const block = await provider.getBlock('latest');
+            if (block && block.gasLimit) {
+                const blockGasLimit = BigInt(block.gasLimit.toString());
+                return withMargin > blockGasLimit ? blockGasLimit : withMargin;
+            }
+        }
+        catch (error) {
+        }
+        return withMargin;
+    }
+    catch (error) {
+        console.warn('Gas estimation failed, using conservative default:', error.message);
+        if (tx.data && tx.data !== '0x' && tx.data.length > 2) {
+            return 500000n;
+        }
+        return 21000n;
+    }
+}
+function calculateMaxTransferAmount(balance, gasLimit, gasPrice) {
+    const gasCost = gasLimit * gasPrice;
+    if (balance <= gasCost) {
+        return 0n;
+    }
+    return balance - gasCost;
+}
+function checkSufficientGas(balance, amount, gasLimit, gasPrice) {
+    const gasCost = gasLimit * gasPrice;
+    const totalCost = amount + gasCost;
+    if (totalCost > balance) {
+        const shortfall = totalCost - balance;
+        throw new Error(`Insufficient balance for transaction + gas. ` +
+            `Need: ${totalCost}, Have: ${balance}, Short: ${shortfall}`);
+    }
+    return true;
+}
+class TransactionBuilder {
+    provider;
+    tx = {};
+    constructor(provider) {
+        this.provider = provider;
+    }
+    to(address) {
+        this.tx.to = address;
+        return this;
+    }
+    value(amount) {
+        this.tx.value = amount;
+        return this;
+    }
+    data(data) {
+        this.tx.data = data;
+        return this;
+    }
+    gasLimit(limit) {
+        this.tx.gasLimit = limit;
+        return this;
+    }
+    gasPrice(price) {
+        this.tx.gasPrice = price;
+        return this;
+    }
+    maxFeePerGas(fee) {
+        this.tx.maxFeePerGas = fee;
+        return this;
+    }
+    maxPriorityFeePerGas(fee) {
+        this.tx.maxPriorityFeePerGas = fee;
+        return this;
+    }
+    nonce(nonce) {
+        this.tx.nonce = nonce;
+        return this;
+    }
+    async build(options) {
+        if (!this.tx.to) {
+            throw new Error('Transaction must have a "to" address');
+        }
+        if (!this.tx.gasLimit && options?.addGasMargin) {
+            this.tx.gasLimit = await estimateGasWithMargin(this.provider, this.tx, options.marginPercent);
+        }
+        return { ...this.tx };
+    }
+}
+exports.TransactionBuilder = TransactionBuilder;