@augustdigital/sdk 5.1.1 → 7.0.0

package/lib/adapters/solana/vault.actions.js

@@ -7,14 +7,18 @@ const web3_js_1 = require("@solana/web3.js");
 const spl_token_1 = require("@solana/spl-token");
 const constants_1 = require("./constants");
 const utils_1 = require("./utils");
+const core_1 = require("../../core");
 async function handleSolanaDeposit({ provider, connection, network = constants_1.fallbackNetwork, vaultProgramId, vaultAddress, depositAmount, publicKey, sendTransaction, idl, }) {
     try {
         if (!publicKey)
-            throw new Error('Wallet not connected');
-        if (!depositAmount)
-            throw new Error('Please enter an amount to deposit');
+            throw new core_1.AugustValidationError('INVALID_INPUT', 'handleSolanaDeposit: wallet not connected');
+        if (depositAmount === undefined ||
+            depositAmount === null ||
+            (typeof depositAmount === 'bigint' && depositAmount <= 0n) ||
+            (typeof depositAmount === 'number' && !(depositAmount > 0)))
+            throw new core_1.AugustValidationError('INVALID_INPUT', 'handleSolanaDeposit: depositAmount is required and must be > 0');
         if (!vaultProgramId)
-            throw new Error('Please enter a vault program ID');
+            throw new core_1.AugustValidationError('INVALID_INPUT', 'handleSolanaDeposit: vaultProgramId is required');
         const { depositMint, shareMint, vaultVersion } = await utils_1.SolanaUtils.getVaultMints({
             network,
             connection,
@@ -33,71 +37,72 @@ async function handleSolanaDeposit({ provider, connection, network = constants_1
             idl,
             programId: _vaultProgramId.toBase58(),
         });
-        console.log('Program', program);
+        core_1.Logger.log.info('handleSolanaDeposit', 'Program', program);
         const vaultStatePda = vaultAddress
             ? new web3_js_1.PublicKey(vaultAddress)
             : utils_1.SolanaUtils.deriveVaultStatePda(_vaultProgramId);
-        console.log('Vault state PDA', vaultStatePda.toBase58());
+        core_1.Logger.log.info('handleSolanaDeposit', 'Vault state PDA', vaultStatePda.toBase58());
         const vaultTokenAtaPda = utils_1.SolanaUtils.deriveVaultTokenAtaPda(_vaultProgramId, _depositMint, vaultVersion);
-        console.log('Vault token ATA PDA', vaultTokenAtaPda.toBase58());
+        core_1.Logger.log.info('handleSolanaDeposit', 'Vault token ATA PDA', vaultTokenAtaPda.toBase58());
         const shareMintAddr = new web3_js_1.PublicKey(shareMint);
-        console.log('Share mint', shareMintAddr.toBase58());
+        core_1.Logger.log.info('handleSolanaDeposit', 'Share mint', shareMintAddr.toBase58());
         const mintInfo = await connection.getParsedAccountInfo(_depositMint);
         if (!mintInfo.value) {
             throw new Error('Could not fetch mint info');
         }
         const { decimals } = mintInfo.value.data.parsed.info;
-        0;
-        const depositAmountStr = depositAmount.toString();
-        const [whole, fraction = ''] = depositAmountStr.split('.');
-        const paddedFraction = fraction.padEnd(decimals, '0').slice(0, decimals);
-        const rawAmountStr = whole + paddedFraction;
-        const depositAmountRaw = new anchor_1.BN(rawAmountStr.replace(/^0+/, '') || '0');
-        if (isNaN(depositAmount)) {
-            throw new Error('Please enter a valid number for the deposit amount');
+        let depositAmountRaw;
+        if (typeof depositAmount === 'bigint') {
+            depositAmountRaw = new anchor_1.BN(depositAmount.toString());
         }
-        if (depositAmount <= 0) {
-            throw new Error('Deposit amount must be greater than 0');
+        else {
+            if (isNaN(depositAmount)) {
+                throw new core_1.AugustValidationError('INVALID_INPUT', 'Please enter a valid number for the deposit amount');
+            }
+            if (depositAmount <= 0) {
+                throw new core_1.AugustValidationError('INVALID_INPUT', 'Deposit amount must be greater than 0');
+            }
+            depositAmountRaw = (0, utils_1.uiAmountToRawBn)(depositAmount, decimals);
         }
         const userTokenAccounts = await connection.getParsedTokenAccountsByOwner(_publicKey, {
             mint: _depositMint,
         });
-        console.log('User token accounts', userTokenAccounts);
+        core_1.Logger.log.info('handleSolanaDeposit', 'User token accounts', userTokenAccounts);
         const userShareAccounts = await connection.getParsedTokenAccountsByOwner(_publicKey, {
             mint: shareMintAddr,
         });
-        console.log('User share accounts', userShareAccounts);
+        core_1.Logger.log.info('handleSolanaDeposit', 'User share accounts', userShareAccounts);
         if (userTokenAccounts.value.length === 0) {
-            throw new Error('No token account found for deposit mint. Please create a token account first.');
+            throw new core_1.AugustValidationError('INVALID_INPUT', 'No token account found for deposit mint. Please create a token account first.');
         }
         let senderShareAccount;
         if (userShareAccounts.value.length === 0) {
-            console.log('Creating share account');
+            core_1.Logger.log.info('handleSolanaDeposit', 'Creating share account');
             senderShareAccount = await (0, spl_token_1.getAssociatedTokenAddress)(shareMintAddr, _publicKey);
-            console.log('Sender share account', senderShareAccount.toBase58());
+            core_1.Logger.log.info('handleSolanaDeposit', 'Sender share account', senderShareAccount.toBase58());
             const createAtaIx = (0, spl_token_1.createAssociatedTokenAccountInstruction)(_publicKey, senderShareAccount, _publicKey, shareMintAddr);
-            console.log('Create ATA Ix', createAtaIx.programId.toBase58());
+            core_1.Logger.log.info('handleSolanaDeposit', 'Create ATA Ix', createAtaIx.programId.toBase58());
             const transaction = new web3_js_1.Transaction().add(createAtaIx);
             const signature = await sendTransaction(transaction, connection);
-            console.log('Created share account:', signature.toString());
+            core_1.Logger.log.info('handleSolanaDeposit', 'Created share account:', signature.toString());
         }
         else {
             senderShareAccount = userShareAccounts.value[0]?.pubkey;
         }
         const senderTokenAccount = userTokenAccounts.value[0]?.pubkey;
-        console.log('Sender token account', senderTokenAccount);
-        console.log('\n\nDeposit TX Params:\n');
-        console.log('Program', depositAmountRaw);
-        console.log('Vault state PDA', vaultStatePda.toBase58());
-        console.log('Vault token ATA PDA', vaultTokenAtaPda.toBase58());
-        console.log('Sender token account', senderTokenAccount?.toBase58());
-        console.log('Sender share account', senderShareAccount?.toBase58());
-        console.log('Share mint', shareMintAddr.toBase58());
-        console.log('Deposit mint', _depositMint?.toBase58());
-        console.log('Signer', _publicKey.toBase58());
+        core_1.Logger.log.info('handleSolanaDeposit', 'Sender token account', senderTokenAccount);
+        core_1.Logger.log.info('handleSolanaDeposit', '\n\nDeposit TX Params:\n');
+        core_1.Logger.log.info('handleSolanaDeposit', 'Program', depositAmountRaw);
+        core_1.Logger.log.info('handleSolanaDeposit', 'Vault state PDA', vaultStatePda.toBase58());
+        core_1.Logger.log.info('handleSolanaDeposit', 'Vault token ATA PDA', vaultTokenAtaPda.toBase58());
+        core_1.Logger.log.info('handleSolanaDeposit', 'Sender token account', senderTokenAccount?.toBase58());
+        core_1.Logger.log.info('handleSolanaDeposit', 'Sender share account', senderShareAccount?.toBase58());
+        core_1.Logger.log.info('handleSolanaDeposit', 'Share mint', shareMintAddr.toBase58());
+        core_1.Logger.log.info('handleSolanaDeposit', 'Deposit mint', _depositMint?.toBase58());
+        core_1.Logger.log.info('handleSolanaDeposit', 'Signer', _publicKey.toBase58());
         const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash('confirmed');
         const tx = await program.methods
-            .deposit(new anchor_1.BN(depositAmountRaw))
+            .deposit(depositAmountRaw)
             .accounts({
             vaultState: vaultStatePda,
             vaultTokenAta: vaultTokenAtaPda,
@@ -112,7 +117,7 @@ async function handleSolanaDeposit({ provider, connection, network = constants_1
             skipPreflight: false,
             preflightCommitment: 'confirmed',
         });
-        console.log('Deposit successful:', tx);
+        core_1.Logger.log.info('handleSolanaDeposit', 'Deposit successful:', tx);
         await connection.confirmTransaction({
             signature: tx,
             blockhash,
@@ -121,18 +126,37 @@ async function handleSolanaDeposit({ provider, connection, network = constants_1
         return tx;
     }
     catch (e) {
-        console.error('Deposit failed:', e);
-        return null;
+        if (e instanceof core_1.AugustSDKError)
+            throw e;
+        const depositAmountForLog = typeof depositAmount === 'bigint'
+            ? depositAmount.toString()
+            : depositAmount;
+        core_1.Logger.log.error('handleSolanaDeposit', e, {
+            vaultProgramId: String(vaultProgramId),
+            vaultAddress: vaultAddress ? String(vaultAddress) : undefined,
+            depositAmount: depositAmountForLog,
+        });
+        throw new core_1.AugustSDKError('UNKNOWN', `Solana deposit failed: ${e instanceof Error ? e.message : 'Unknown error'}`, {
+            cause: e,
+            context: {
+                vaultProgramId: String(vaultProgramId),
+                vaultAddress: vaultAddress ? String(vaultAddress) : undefined,
+                depositAmount: depositAmountForLog,
+            },
+        });
     }
 }
 async function handleSolanaRedeem({ provider, connection, vaultProgramId, vaultAddress, publicKey, redeemShares, sendTransaction, idl, }) {
     try {
         if (!publicKey)
-            throw new Error('Wallet not connected');
-        if (!redeemShares)
-            throw new Error('Please enter shares to redeem');
+            throw new core_1.AugustValidationError('INVALID_INPUT', 'handleSolanaRedeem: wallet not connected');
+        if (redeemShares === undefined ||
+            redeemShares === null ||
+            (typeof redeemShares === 'bigint' && redeemShares <= 0n) ||
+            (typeof redeemShares === 'number' && !(redeemShares > 0)))
+            throw new core_1.AugustValidationError('INVALID_INPUT', 'handleSolanaRedeem: redeemShares is required and must be > 0');
         if (!vaultProgramId)
-            throw new Error('Please enter a vault program ID');
+            throw new core_1.AugustValidationError('INVALID_INPUT', 'handleSolanaRedeem: vaultProgramId is required');
         const { depositMint, shareMint, vaultVersion } = await utils_1.SolanaUtils.getVaultMints({
             network: provider.connection.rpcEndpoint.includes('devnet')
                 ? 'devnet'
@@ -164,18 +188,18 @@ async function handleSolanaRedeem({ provider, connection, vaultProgramId, vaultA
         }
         const shareDecimals = shareMintInfo.value.data.parsed.info
             .decimals;
-        const redeemSharesStr = redeemShares.toString();
-        const [whole, fraction = ''] = redeemSharesStr.split('.');
-        const paddedFraction = fraction
-            .padEnd(shareDecimals, '0')
-            .slice(0, shareDecimals);
-        const rawAmountStr = whole + paddedFraction;
-        const redeemSharesRaw = parseInt(rawAmountStr.replace(/^0+/, '') || '0', 10);
-        if (isNaN(redeemShares)) {
-            throw new Error('Please enter a valid number for the shares to redeem');
+        let redeemSharesRaw;
+        if (typeof redeemShares === 'bigint') {
+            redeemSharesRaw = new anchor_1.BN(redeemShares.toString());
         }
-        if (redeemShares <= 0) {
-            throw new Error('Shares to redeem must be greater than 0');
+        else {
+            if (isNaN(redeemShares)) {
+                throw new core_1.AugustValidationError('INVALID_INPUT', 'Please enter a valid number for the shares to redeem');
+            }
+            if (redeemShares <= 0) {
+                throw new core_1.AugustValidationError('INVALID_INPUT', 'Shares to redeem must be greater than 0');
+            }
+            redeemSharesRaw = (0, utils_1.uiAmountToRawBn)(redeemShares, shareDecimals);
         }
         const userTokenAccounts = await connection.getParsedTokenAccountsByOwner(_publicKey, {
             mint: _depositMint,
@@ -184,10 +208,10 @@ async function handleSolanaRedeem({ provider, connection, vaultProgramId, vaultA
             mint: shareMintAddr,
         });
         if (userTokenAccounts.value.length === 0) {
-            throw new Error('No token account found for deposit mint. Please create a token account first.');
+            throw new core_1.AugustValidationError('INVALID_INPUT', 'No token account found for deposit mint. Please create a token account first.');
         }
         if (userShareAccounts.value.length === 0) {
-            throw new Error('No share account found. You need to deposit first to get shares before you can redeem.');
+            throw new core_1.AugustValidationError('INVALID_INPUT', 'No share account found. You need to deposit first to get shares before you can redeem.');
         }
         const senderTokenAccount = userTokenAccounts?.value[0]?.pubkey;
         const senderShareAccount = userShareAccounts?.value[0]?.pubkey;
@@ -204,27 +228,27 @@ async function handleSolanaRedeem({ provider, connection, vaultProgramId, vaultA
             const createFeeRecipientAtaIx = (0, spl_token_1.createAssociatedTokenAccountInstruction)(_publicKey, feeRecipientTokenAccount, vaultStateData.feeRecipient, _depositMint);
             const createAccountTx = new web3_js_1.Transaction().add(createFeeRecipientAtaIx);
             const createAccountSignature = await sendTransaction(createAccountTx, connection);
-            console.log('Fee recipient token account created:', createAccountSignature);
+            core_1.Logger.log.info('handleSolanaRedeem', 'Fee recipient token account created:', createAccountSignature);
             await new Promise((resolve) => setTimeout(resolve, 1000));
         }
         else {
-            console.log('Fee recipient token account already exists');
+            core_1.Logger.log.info('handleSolanaRedeem', 'Fee recipient token account already exists');
         }
-        console.log('\n\nRedeem TX Params:\n');
-        console.log('Redeem shares (UI):', redeemShares);
-        console.log('Redeem shares (raw):', redeemSharesRaw);
-        console.log('Share decimals:', shareDecimals);
-        console.log('Vault state PDA:', vaultStatePda.toBase58());
-        console.log('Vault token ATA PDA:', vaultTokenAtaPda.toBase58());
-        console.log('Sender token account:', senderTokenAccount?.toBase58());
-        console.log('Sender share account:', senderShareAccount?.toBase58());
-        console.log('Fee recipient account:', feeRecipientTokenAccount.toBase58());
-        console.log('Share mint:', shareMintAddr.toBase58());
-        console.log('Deposit mint:', _depositMint?.toBase58());
-        console.log('Signer:', _publicKey.toBase58());
+        core_1.Logger.log.info('handleSolanaRedeem', '\n\nRedeem TX Params:\n');
+        core_1.Logger.log.info('handleSolanaRedeem', 'Redeem shares (UI):', redeemShares);
+        core_1.Logger.log.info('handleSolanaRedeem', 'Redeem shares (raw):', redeemSharesRaw);
+        core_1.Logger.log.info('handleSolanaRedeem', 'Share decimals:', shareDecimals);
+        core_1.Logger.log.info('handleSolanaRedeem', 'Vault state PDA:', vaultStatePda.toBase58());
+        core_1.Logger.log.info('handleSolanaRedeem', 'Vault token ATA PDA:', vaultTokenAtaPda.toBase58());
+        core_1.Logger.log.info('handleSolanaRedeem', 'Sender token account:', senderTokenAccount?.toBase58());
+        core_1.Logger.log.info('handleSolanaRedeem', 'Sender share account:', senderShareAccount?.toBase58());
+        core_1.Logger.log.info('handleSolanaRedeem', 'Fee recipient account:', feeRecipientTokenAccount.toBase58());
+        core_1.Logger.log.info('handleSolanaRedeem', 'Share mint:', shareMintAddr.toBase58());
+        core_1.Logger.log.info('handleSolanaRedeem', 'Deposit mint:', _depositMint?.toBase58());
+        core_1.Logger.log.info('handleSolanaRedeem', 'Signer:', _publicKey.toBase58());
         const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash('confirmed');
         const tx = await program.methods
-            .redeem(new anchor_1.BN(redeemSharesRaw))
+            .redeem(redeemSharesRaw)
             .accounts({
             vaultState: vaultStatePda,
             vaultDepositAta: vaultTokenAtaPda,
@@ -240,7 +264,7 @@ async function handleSolanaRedeem({ provider, connection, vaultProgramId, vaultA
             skipPreflight: false,
             preflightCommitment: 'confirmed',
         });
-        console.log('Redeem successful:', tx);
+        core_1.Logger.log.info('handleSolanaRedeem', 'Redeem successful:', tx);
         await connection.confirmTransaction({
             signature: tx,
             blockhash,
@@ -249,8 +273,22 @@ async function handleSolanaRedeem({ provider, connection, vaultProgramId, vaultA
         return tx;
     }
     catch (e) {
-        console.error('Redeem failed:', e);
-        return null;
+        if (e instanceof core_1.AugustSDKError)
+            throw e;
+        const redeemSharesForLog = typeof redeemShares === 'bigint' ? redeemShares.toString() : redeemShares;
+        core_1.Logger.log.error('handleSolanaRedeem', e, {
+            vaultProgramId: String(vaultProgramId),
+            vaultAddress: vaultAddress ? String(vaultAddress) : undefined,
+            redeemShares: redeemSharesForLog,
+        });
+        throw new core_1.AugustSDKError('UNKNOWN', `Solana redeem failed: ${e instanceof Error ? e.message : 'Unknown error'}`, {
+            cause: e,
+            context: {
+                vaultProgramId: String(vaultProgramId),
+                vaultAddress: vaultAddress ? String(vaultAddress) : undefined,
+                redeemShares: redeemSharesForLog,
+            },
+        });
     }
 }
 //# sourceMappingURL=vault.actions.js.map

package/lib/adapters/stellar/actions.js

@@ -5,14 +5,15 @@ exports.handleStellarRedeem = handleStellarRedeem;
 const stellar_sdk_1 = require("@stellar/stellar-sdk");
 const soroban_1 = require("./soroban");
 const utils_1 = require("./utils");
+const core_1 = require("../../core");
 function validateContractAddress(contractId) {
     if (!(0, utils_1.isStellarAddress)(contractId) || contractId[0] !== 'C') {
-        throw new Error(`Invalid contract address: expected a Stellar contract (C-prefix), got "${contractId}"`);
+        throw new core_1.AugustValidationError('INVALID_ADDRESS', `Invalid contract address: expected a Stellar contract (C-prefix), got "${contractId}"`);
     }
 }
 function validateAccountAddress(address, label) {
     if (!(0, utils_1.isStellarAddress)(address) || address[0] !== 'G') {
-        throw new Error(`Invalid ${label} address: expected a Stellar account (G-prefix), got "${address}"`);
+        throw new core_1.AugustValidationError('INVALID_ADDRESS', `Invalid ${label} address: expected a Stellar account (G-prefix), got "${address}"`);
     }
 }
 function buildSelfOperationArgs(amount, userAddress) {

package/lib/adapters/stellar/constants.d.ts

@@ -12,4 +12,6 @@ export declare const TX_TIMEOUT_SECONDS = 120;
 export declare const QUERY_TIMEOUT_SECONDS = 10;
 export declare const MAX_FEE_STROOPS = "1000000";
 export declare const POLL_INTERVAL_MS = 2000;
+export declare const POLL_INTERVAL_MAX_MS = 8000;
+export declare const POLL_INTERVAL_BACKOFF = 1.5;
 export declare const MAX_POLL_ATTEMPTS = 30;

package/lib/adapters/stellar/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MAX_POLL_ATTEMPTS = exports.POLL_INTERVAL_MS = exports.MAX_FEE_STROOPS = exports.QUERY_TIMEOUT_SECONDS = exports.TX_TIMEOUT_SECONDS = exports.STELLAR_FALLBACK_DECIMALS = exports.NETWORK_PASSPHRASES = exports.SOROBAN_RPC_URLS = exports.STELLAR_CHAIN = exports.STELLAR_CHAIN_ID = void 0;
+exports.MAX_POLL_ATTEMPTS = exports.POLL_INTERVAL_BACKOFF = exports.POLL_INTERVAL_MAX_MS = exports.POLL_INTERVAL_MS = exports.MAX_FEE_STROOPS = exports.QUERY_TIMEOUT_SECONDS = exports.TX_TIMEOUT_SECONDS = exports.STELLAR_FALLBACK_DECIMALS = exports.NETWORK_PASSPHRASES = exports.SOROBAN_RPC_URLS = exports.STELLAR_CHAIN = exports.STELLAR_CHAIN_ID = void 0;
 const stellar_sdk_1 = require("@stellar/stellar-sdk");
 const web3_1 = require("../../core/constants/web3");
 exports.STELLAR_CHAIN_ID = web3_1.SPECIAL_CHAINS.stellar.chainId;
@@ -18,5 +18,7 @@ exports.TX_TIMEOUT_SECONDS = 120;
 exports.QUERY_TIMEOUT_SECONDS = 10;
 exports.MAX_FEE_STROOPS = '1000000';
 exports.POLL_INTERVAL_MS = 2000;
+exports.POLL_INTERVAL_MAX_MS = 8000;
+exports.POLL_INTERVAL_BACKOFF = 1.5;
 exports.MAX_POLL_ATTEMPTS = 30;
 //# sourceMappingURL=constants.js.map

package/lib/adapters/stellar/getters.js

@@ -118,7 +118,7 @@ const getStellarUserPosition = async (vaultAddress, walletAddress, network = 'ma
         userAddress = new stellar_sdk_1.Address(walletAddress);
     }
     catch (addrErr) {
-        throw new Error(`getStellarUserPosition: invalid walletAddress "${walletAddress}": ${String(addrErr)}`);
+        throw new core_1.AugustValidationError('INVALID_ADDRESS', `getStellarUserPosition: invalid walletAddress "${walletAddress}": ${String(addrErr)}`, { cause: addrErr });
     }
     try {
         const [balanceResult, decimalsResult] = await Promise.all([
@@ -165,7 +165,7 @@ const convertToShares = async (vaultAddress, rawAmount, network = 'mainnet') =>
         new stellar_sdk_1.Address(vaultAddress);
     }
     catch (addrErr) {
-        throw new Error(`convertToShares: invalid vaultAddress "${vaultAddress}": ${String(addrErr)}`);
+        throw new core_1.AugustValidationError('INVALID_ADDRESS', `convertToShares: invalid vaultAddress "${vaultAddress}": ${String(addrErr)}`, { cause: addrErr });
     }
     const config = (0, soroban_1.resolveNetworkConfig)(network);
     const amountBigInt = (0, soroban_1.toBigIntAmount)(rawAmount, 'rawAmount');

package/lib/adapters/stellar/soroban.js

@@ -21,17 +21,17 @@ function resolveNetworkConfig(network) {
 }
 function toBigIntAmount(value, label) {
     if (value === '') {
-        throw new Error(`Invalid ${label}: value must not be empty`);
+        throw new core_1.AugustValidationError('INVALID_INPUT', `Invalid ${label}: value must not be empty`);
     }
     let result;
     try {
         result = BigInt(value);
     }
     catch {
-        throw new Error(`Invalid ${label}: "${value}" is not a valid integer string`);
+        throw new core_1.AugustValidationError('INVALID_INPUT', `Invalid ${label}: "${value}" is not a valid integer string`);
     }
     if (result < 0n) {
-        throw new Error(`Invalid ${label}: value must be non-negative, got "${value}"`);
+        throw new core_1.AugustValidationError('INVALID_INPUT', `Invalid ${label}: value must be non-negative, got "${value}"`);
     }
     return result;
 }
@@ -78,7 +78,18 @@ async function queryContract(config, contractId, method, args = []) {
 }
 async function buildSorobanTx(config, sourceAddress, contractId, method, args) {
     const server = createServer(config.rpcUrl);
-    const account = await server.getAccount(sourceAddress);
+    let account;
+    try {
+        account = await server.getAccount(sourceAddress);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        const isAccountNotFound = err instanceof stellar_sdk_1.NotFoundError || /Account not found/.test(msg);
+        if (isAccountNotFound) {
+            throw new core_1.AugustValidationError('INVALID_INPUT', `Stellar account ${sourceAddress} is not funded. Send at least 1 XLM to this address to activate it before depositing or redeeming.`, { cause: err, context: { sourceAddress, method, contractId } });
+        }
+        throw err;
+    }
     const contract = new stellar_sdk_1.Contract(contractId);
     const tx = new stellar_sdk_1.TransactionBuilder(account, {
         fee: constants_1.MAX_FEE_STROOPS,
@@ -89,18 +100,18 @@ async function buildSorobanTx(config, sourceAddress, contractId, method, args) {
         .build();
     const simulated = await server.simulateTransaction(tx);
     if (stellar_sdk_1.rpc.Api.isSimulationError(simulated)) {
-        throw new Error(`Soroban simulation failed: ${extractSimulationError(simulated)}`);
+        throw new core_1.AugustSDKError('UNKNOWN', `Soroban simulation failed: ${extractSimulationError(simulated)}`, { context: { method, contractId } });
     }
     if ('restorePreamble' in simulated && simulated.restorePreamble) {
-        throw new Error(`Contract ledger state needs restoration before invoking ${method}. ` +
-            'Submit a restore footprint transaction first.');
+        throw new core_1.AugustSDKError('UNKNOWN', `Contract ledger state needs restoration before invoking ${method}. ` +
+            'Submit a restore footprint transaction first.', { context: { method, contractId } });
     }
     try {
         const assembled = stellar_sdk_1.rpc.assembleTransaction(tx, simulated).build();
         return assembled.toXDR();
     }
     catch (assemblyErr) {
-        throw new Error(`Failed to assemble Soroban transaction for ${method}: ${String(assemblyErr)}`);
+        throw new core_1.AugustSDKError('UNKNOWN', `Failed to assemble Soroban transaction for ${method}: ${String(assemblyErr)}`, { cause: assemblyErr, context: { method, contractId } });
     }
 }
 //# sourceMappingURL=soroban.js.map

package/lib/adapters/stellar/submit.js

@@ -14,26 +14,34 @@ async function submitStellarTransaction(signedXdr, network) {
         const detail = 'errorResult' in sendResult ? JSON.stringify(sendResult.errorResult) : '';
         const msg = `Transaction submission failed: ${detail || sendResult.status}`;
         core_1.Logger.log.error('submitStellarTransaction', msg, { network });
-        throw new Error(msg);
+        throw new core_1.AugustSDKError('UNKNOWN', msg, {
+            context: { network, status: sendResult.status },
+        });
     }
     if (sendResult.status !== 'PENDING' && sendResult.status !== 'DUPLICATE') {
         const msg = `Transaction not accepted by RPC (status: ${sendResult.status}). ` +
             'This may be retryable — the RPC node could be overloaded.';
         core_1.Logger.log.error('submitStellarTransaction', msg, { network });
-        throw new Error(msg);
+        throw new core_1.AugustSDKError('UNKNOWN', msg, {
+            context: { network, status: sendResult.status },
+        });
     }
     let getResult = await server.getTransaction(sendResult.hash);
     let polls = 0;
+    let nextDelay = constants_1.POLL_INTERVAL_MS;
     while (getResult.status === 'NOT_FOUND') {
         if (++polls >= constants_1.MAX_POLL_ATTEMPTS) {
-            const msg = `Transaction ${sendResult.hash} not confirmed after ${(constants_1.MAX_POLL_ATTEMPTS * constants_1.POLL_INTERVAL_MS) / 1000}s`;
+            const msg = `Transaction ${sendResult.hash} not confirmed after ${constants_1.MAX_POLL_ATTEMPTS} poll attempts`;
             core_1.Logger.log.error('submitStellarTransaction', msg, {
                 hash: sendResult.hash,
                 network,
             });
-            throw new Error(msg);
+            throw new core_1.AugustTimeoutError(msg, constants_1.POLL_INTERVAL_MAX_MS * polls, {
+                context: { hash: sendResult.hash, network },
+            });
         }
-        await new Promise((r) => setTimeout(r, constants_1.POLL_INTERVAL_MS));
+        await new Promise((r) => setTimeout(r, nextDelay));
+        nextDelay = Math.min(Math.round(nextDelay * constants_1.POLL_INTERVAL_BACKOFF), constants_1.POLL_INTERVAL_MAX_MS);
         getResult = await server.getTransaction(sendResult.hash);
     }
     if (getResult.status === 'SUCCESS') {
@@ -45,6 +53,8 @@ async function submitStellarTransaction(signedXdr, network) {
         hash: sendResult.hash,
         network,
     });
-    throw new Error(msg);
+    throw new core_1.AugustSDKError('UNKNOWN', msg, {
+        context: { hash: sendResult.hash, network, status: getResult.status },
+    });
 }
 //# sourceMappingURL=submit.js.map

package/lib/adapters/stellar/utils.d.ts

@@ -1,5 +1,6 @@
 import type { IStellarNetwork } from './types';
-export declare function isStellarAddress(address: string): boolean;
+import { isStellarAddress } from '../../core/helpers/chain-address';
+export { isStellarAddress };
 export declare function getExplorerLink({ id, type, network, }: {
     id: string;
     type?: 'contract' | 'account' | 'tx';

package/lib/adapters/stellar/utils.js

@@ -1,31 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.StellarUtils = void 0;
-exports.isStellarAddress = isStellarAddress;
+exports.StellarUtils = exports.isStellarAddress = void 0;
 exports.getExplorerLink = getExplorerLink;
 exports.assertNotStellar = assertNotStellar;
-const STELLAR_ADDRESS_RE = /^[A-Z2-7]{56}$/;
-function isStellarAddress(address) {
-    if (!address || typeof address !== 'string')
-        return false;
-    if (address.length !== 56)
-        return false;
-    if (address[0] !== 'G' && address[0] !== 'C')
-        return false;
-    return STELLAR_ADDRESS_RE.test(address);
-}
+const core_1 = require("../../core");
+const chain_address_1 = require("../../core/helpers/chain-address");
+Object.defineProperty(exports, "isStellarAddress", { enumerable: true, get: function () { return chain_address_1.isStellarAddress; } });
 function getExplorerLink({ id, type = 'contract', network = 'mainnet', }) {
     const baseUrl = 'https://stellar.expert/explorer';
     const net = network === 'mainnet' ? 'public' : 'testnet';
     return `${baseUrl}/${net}/${type}/${id}`;
 }
 function assertNotStellar(address, operation) {
-    if (isStellarAddress(address)) {
-        throw new Error(`${operation} is not yet supported for Stellar vaults: ${address}`);
+    if ((0, chain_address_1.isStellarAddress)(address)) {
+        throw new core_1.AugustValidationError('INVALID_CHAIN', `${operation} is not yet supported for Stellar vaults: ${address}`);
     }
 }
 exports.StellarUtils = {
-    isStellarAddress,
+    isStellarAddress: chain_address_1.isStellarAddress,
     getExplorerLink,
     assertNotStellar,
 };

package/lib/adapters/sui/utils.d.ts

@@ -1,4 +1,4 @@
 export declare function convertFromE9(value: string | number): number;
 export declare function calculateUtilization(current: string | number, maximum: string | number): number;
-export declare function isSuiAddress(address: string): boolean;
+export { isSuiAddress } from '../../core/helpers/chain-address';
 export declare function isSuiVault(chainId: number): boolean;

package/lib/adapters/sui/utils.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSuiAddress = void 0;
 exports.convertFromE9 = convertFromE9;
 exports.calculateUtilization = calculateUtilization;
-exports.isSuiAddress = isSuiAddress;
 exports.isSuiVault = isSuiVault;
 const constants_1 = require("./constants");
 function convertFromE9(value) {
@@ -15,12 +15,8 @@ function calculateUtilization(current, maximum) {
         return 0;
     return Math.min((currentValue / maxValue) * 100, 100);
 }
-function isSuiAddress(address) {
-    if (!address || typeof address !== 'string')
-        return false;
-    const hexRegex = /^0x[a-fA-F0-9]{64}$/;
-    return hexRegex.test(address);
-}
+var chain_address_1 = require("../../core/helpers/chain-address");
+Object.defineProperty(exports, "isSuiAddress", { enumerable: true, get: function () { return chain_address_1.isSuiAddress; } });
 function isSuiVault(chainId) {
     return chainId === constants_1.SUI_CHAIN_ID;
 }

package/lib/core/analytics/chain-name.d.ts

@@ -0,0 +1 @@
+export declare function chainIdToTagValue(chainId: number | undefined): string;

package/lib/core/analytics/chain-name.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chainIdToTagValue = chainIdToTagValue;
+const web3_1 = require("../constants/web3");
+function chainIdToTagValue(chainId) {
+    if (chainId === undefined || chainId === null || Number.isNaN(chainId)) {
+        return 'unknown';
+    }
+    for (const entry of Object.values(web3_1.SPECIAL_CHAINS)) {
+        if (entry.chainId === chainId) {
+            return slugify(entry.name);
+        }
+    }
+    const network = web3_1.NETWORKS[chainId];
+    if (network) {
+        return slugify(network.name);
+    }
+    return `unknown:${chainId}`;
+}
+function slugify(input) {
+    return input
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+//# sourceMappingURL=chain-name.js.map

package/lib/core/analytics/env.d.ts

@@ -0,0 +1,4 @@
+export declare function readEnv(name: string): string | undefined;
+export declare function isAnalyticsForcedOnViaEnv(): boolean;
+export declare function isAnalyticsDisabledViaEnv(): boolean;
+export declare function isNodeDevOrTestEnv(): boolean;

package/lib/core/analytics/env.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readEnv = readEnv;
+exports.isAnalyticsForcedOnViaEnv = isAnalyticsForcedOnViaEnv;
+exports.isAnalyticsDisabledViaEnv = isAnalyticsDisabledViaEnv;
+exports.isNodeDevOrTestEnv = isNodeDevOrTestEnv;
+function readEnv(name) {
+    try {
+        if (typeof process !== 'undefined' && process.env) {
+            return process.env[name];
+        }
+    }
+    catch {
+    }
+    return undefined;
+}
+function isTruthyEnv(value) {
+    if (!value)
+        return false;
+    const v = value.toLowerCase();
+    return v === '1' || v === 'true' || v === 'yes' || v === 'on';
+}
+function isAnalyticsForcedOnViaEnv() {
+    return isTruthyEnv(readEnv('AUGUST_SDK_FORCE_ANALYTICS'));
+}
+function isAnalyticsDisabledViaEnv() {
+    return isTruthyEnv(readEnv('AUGUST_SDK_DISABLE_ANALYTICS'));
+}
+function isNodeDevOrTestEnv() {
+    const env = readEnv('NODE_ENV');
+    return env === 'development' || env === 'test';
+}
+//# sourceMappingURL=env.js.map