@vaultum/sdk 0.1.7 → 0.1.9

package/dist/index.d.mts

@@ -138,6 +138,14 @@ interface AccountCreateResult {
     userOpHash: Hex;
     vaultGroupId: number;
     vaultIndex: number;
+    sponsorship?: {
+        mode: 'sponsored' | 'self_funded';
+        fallbackReason?: string;
+    };
+    funding?: {
+        requiredPrefundWei: string;
+        recommendedPrefundWei: string;
+    };
 }
 interface AccountVerifyResult {
     address: Address;
@@ -326,18 +334,59 @@ interface FinalizedProposal {
     userOp: Record<string, unknown>;
 }
 interface SettlementTokens {
+    chainId: number;
+    paymaster: Address | null;
     tokens: Array<{
         symbol: string;
         address: Address;
-        decimals: number;
+        pricing: {
+            currentRate: string;
+            minRate: string;
+            maxRate: string;
+            maxChargePerOp: string;
+        };
     }>;
 }
 interface SettlementQuote {
-    token: string;
-    tokenAmount: string;
-    gasCostWei: string;
-    exchangeRate: string;
-    validUntil: number;
+    chainId: number;
+    sender: Address;
+    token: {
+        symbol: string;
+        address: Address;
+    };
+    quote: {
+        tokenPerEth: string;
+        maxTokenCharge: string;
+        postOpGasOverhead: string;
+        validAfter: number;
+        validUntil: number;
+        nonce: string;
+        bounds: {
+            min: string;
+            max: string;
+        };
+    };
+    gasLimits: {
+        paymasterVerificationGasLimit: string;
+        paymasterPostOpGasLimit: string;
+    };
+}
+interface SettlementPrepareResult {
+    paymasterAndData: Hex;
+    token: {
+        symbol: string;
+        address: Address;
+    };
+    quote: {
+        tokenPerEth: string;
+        validUntil: number;
+        bounds: {
+            min: string;
+            max: string;
+        };
+    };
+    nonce: string;
+    policyVersion: number;
 }
 type SwapRouteStepType = 'swap' | 'bridge';
 interface SwapRouteStep {
@@ -1346,6 +1395,7 @@ declare class VaultumClient {
         sessionKeyAddress: Address;
         chain?: string;
         vaultIndex?: number;
+        sponsorshipMode?: 'required' | 'prefer' | 'disabled';
         salt?: Hex;
         owners?: Address[];
         threshold?: number;
@@ -1489,19 +1539,19 @@ declare class VaultumClient {
     getSettlementQuote(params: {
         chain: string;
         sender: Address;
-        token: 'USDC' | 'USDT';
+        token: string;
         maxGasCost: string;
         maxFeePerGas: string;
         signal?: AbortSignal;
     }): Promise<SettlementQuote>;
     prepareSettlement(params: {
         chain: string;
-        token: 'USDC' | 'USDT';
+        token: string;
         userOp: UserOperation | PackedUserOperation | Record<string, unknown>;
         idempotencyKey?: string;
         timestamp?: number;
         signal?: AbortSignal;
-    }): Promise<UserOpResponse>;
+    }): Promise<SettlementPrepareResult>;
     swapQuote(params: {
         wallet: Address;
         fromChain: string;
@@ -2325,4 +2375,4 @@ declare function hashCrossChainRootTypedData(params: CrossChainRootTypedDataPara
 
 declare const VERSION: string;
 
-export { API, type AccountCreateResult, type AccountOperation, type AccountOperations, type AccountRoles, type AccountVerifyResult, type ActorPermissions, type AddressBookEntry, type AddressBookPage, type AddressCapabilities, type AggregatedRecoveryInitiateResponse, type AggregatedRecoveryPrepareExecutionResponse, type AggregatedRecoveryStatus, type AllowlistRoots, type AllowlistStatus, type ApiUser, type ArmedStatus, type AuthMeResponse, type AuthTokenResponse, type Automation, type AutomationDetails, type AutomationExecution, type AutomationExecutionStatus, type AutomationPage, type AutomationResponse, type AutomationStatus, type AutomationType, type BanStatus, CONTRACTS, type CanaryOptIn, type Capabilities, type ContractName, type CrossChainConfig, type CrossChainGasLimit, type CrossChainPendingProposal, type CrossChainReceiverState, type CrossChainRootTypedDataParams, type CrossChainRootTypedMessage, type CrossChainSkipProposal, type CursorPage, type EIP712Template, ENTRYPOINT_V07, type EnabledFeature, type ExecuteCall, FEATURE_IDS, FEATURE_ID_STRINGS, type FeatureConfig, type FeatureInfo, type FeatureInternal, type FinalizedProposal, GOVERNANCE_DOMAIN_NAME, GOVERNANCE_DOMAIN_VERSION, type GloballyPaused, type GuardianApproval, type GuardianConfig, type HasRole, type HealthStatus, type IsGuardian, type LogoutResponse, type NativeLimitConfig, type NativeLimitStatus, type OnChainRecoveryStatus, type OpWaitResponse, type OperationResult, type OperationState, type OtpInitResponse, type OtpVerifyResponse, type PackedUserOperation, type PasskeySignupResponse, type PasskeySuborgsResponse, type PortfolioTokenItem, type PortfolioTokensResponse, type Proposal, type ProposalCall, type ProposalDigest, type ProposalSignature, type ProposalsPage, type QuoteResponse, type QuoteResponseRaw, type RecoveryGuardians, type RecoveryProposal, type RecoveryProposalInfo, type RecoveryProposalState, type RecoveryStatus, type RegistryFeatures, type RegistryVersion, type RelayEstimate, type RequestContext, type RequestInterceptor, type ResponseContext, type ResponseInterceptor, type RetryConfig, type RoleBudget, type RoleInfo, type RolesInfo, type SDKErrorCode, type SelectorIndex, type SessionKeyCount, type SessionKeyInfo, type SessionKeyList, type SessionKeyPolicySigner, type SessionKeyRoles, type SessionKeyStatus, type SessionKeyTokenLimit, type SettlementQuote, type SettlementTokens, type SpendingLimitBucket, type SpendingLimitPreview, type SpendingLimitStatus, type SpendingLimitSummary, type TargetIndex, type TimestampValidation, type TimingConfig, type TokenLimitConfig, type TokenLimitFullStatus, type TokenLimitStatus, type TokenMaxTransfer, type TriggerAutomationResponse, UserOpBuilder, type UserOpBuilderConfig, type UserOpGasLimits, type UserOpResponse, type UserOpSimulationResponse, type UserOpTemplate, type UserOperation, type UserWalletInfo, VERSION, type ValidatorSelectorPermitted, type VaultDeployment, type VaultGroup, type VaultGroupsResponse, type VaultState, VaultumClient, type VaultumConfig, VaultumError, type WaitOptions, type WalletChallengeResponse, type WalletsResponse, buildCrossChainRootTypedData, createUserOpBuilder, getUserOpHash, hashCrossChainRootTypedData, packGasFees, packGasLimits, parseQuoteResponse, unpackGasFees, unpackGasLimits };
+export { API, type AccountCreateResult, type AccountOperation, type AccountOperations, type AccountRoles, type AccountVerifyResult, type ActorPermissions, type AddressBookEntry, type AddressBookPage, type AddressCapabilities, type AggregatedRecoveryInitiateResponse, type AggregatedRecoveryPrepareExecutionResponse, type AggregatedRecoveryStatus, type AllowlistRoots, type AllowlistStatus, type ApiUser, type ArmedStatus, type AuthMeResponse, type AuthTokenResponse, type Automation, type AutomationDetails, type AutomationExecution, type AutomationExecutionStatus, type AutomationPage, type AutomationResponse, type AutomationStatus, type AutomationType, type BanStatus, CONTRACTS, type CanaryOptIn, type Capabilities, type ContractName, type CrossChainConfig, type CrossChainGasLimit, type CrossChainPendingProposal, type CrossChainReceiverState, type CrossChainRootTypedDataParams, type CrossChainRootTypedMessage, type CrossChainSkipProposal, type CursorPage, type EIP712Template, ENTRYPOINT_V07, type EnabledFeature, type ExecuteCall, FEATURE_IDS, FEATURE_ID_STRINGS, type FeatureConfig, type FeatureInfo, type FeatureInternal, type FinalizedProposal, GOVERNANCE_DOMAIN_NAME, GOVERNANCE_DOMAIN_VERSION, type GloballyPaused, type GuardianApproval, type GuardianConfig, type HasRole, type HealthStatus, type IsGuardian, type LogoutResponse, type NativeLimitConfig, type NativeLimitStatus, type OnChainRecoveryStatus, type OpWaitResponse, type OperationResult, type OperationState, type OtpInitResponse, type OtpVerifyResponse, type PackedUserOperation, type PasskeySignupResponse, type PasskeySuborgsResponse, type PortfolioTokenItem, type PortfolioTokensResponse, type Proposal, type ProposalCall, type ProposalDigest, type ProposalSignature, type ProposalsPage, type QuoteResponse, type QuoteResponseRaw, type RecoveryGuardians, type RecoveryProposal, type RecoveryProposalInfo, type RecoveryProposalState, type RecoveryStatus, type RegistryFeatures, type RegistryVersion, type RelayEstimate, type RequestContext, type RequestInterceptor, type ResponseContext, type ResponseInterceptor, type RetryConfig, type RoleBudget, type RoleInfo, type RolesInfo, type SDKErrorCode, type SelectorIndex, type SessionKeyCount, type SessionKeyInfo, type SessionKeyList, type SessionKeyPolicySigner, type SessionKeyRoles, type SessionKeyStatus, type SessionKeyTokenLimit, type SettlementPrepareResult, type SettlementQuote, type SettlementTokens, type SpendingLimitBucket, type SpendingLimitPreview, type SpendingLimitStatus, type SpendingLimitSummary, type TargetIndex, type TimestampValidation, type TimingConfig, type TokenLimitConfig, type TokenLimitFullStatus, type TokenLimitStatus, type TokenMaxTransfer, type TriggerAutomationResponse, UserOpBuilder, type UserOpBuilderConfig, type UserOpGasLimits, type UserOpResponse, type UserOpSimulationResponse, type UserOpTemplate, type UserOperation, type UserWalletInfo, VERSION, type ValidatorSelectorPermitted, type VaultDeployment, type VaultGroup, type VaultGroupsResponse, type VaultState, VaultumClient, type VaultumConfig, VaultumError, type WaitOptions, type WalletChallengeResponse, type WalletsResponse, buildCrossChainRootTypedData, createUserOpBuilder, getUserOpHash, hashCrossChainRootTypedData, packGasFees, packGasLimits, parseQuoteResponse, unpackGasFees, unpackGasLimits };

package/dist/index.d.ts

@@ -138,6 +138,14 @@ interface AccountCreateResult {
     userOpHash: Hex;
     vaultGroupId: number;
     vaultIndex: number;
+    sponsorship?: {
+        mode: 'sponsored' | 'self_funded';
+        fallbackReason?: string;
+    };
+    funding?: {
+        requiredPrefundWei: string;
+        recommendedPrefundWei: string;
+    };
 }
 interface AccountVerifyResult {
     address: Address;
@@ -326,18 +334,59 @@ interface FinalizedProposal {
     userOp: Record<string, unknown>;
 }
 interface SettlementTokens {
+    chainId: number;
+    paymaster: Address | null;
     tokens: Array<{
         symbol: string;
         address: Address;
-        decimals: number;
+        pricing: {
+            currentRate: string;
+            minRate: string;
+            maxRate: string;
+            maxChargePerOp: string;
+        };
     }>;
 }
 interface SettlementQuote {
-    token: string;
-    tokenAmount: string;
-    gasCostWei: string;
-    exchangeRate: string;
-    validUntil: number;
+    chainId: number;
+    sender: Address;
+    token: {
+        symbol: string;
+        address: Address;
+    };
+    quote: {
+        tokenPerEth: string;
+        maxTokenCharge: string;
+        postOpGasOverhead: string;
+        validAfter: number;
+        validUntil: number;
+        nonce: string;
+        bounds: {
+            min: string;
+            max: string;
+        };
+    };
+    gasLimits: {
+        paymasterVerificationGasLimit: string;
+        paymasterPostOpGasLimit: string;
+    };
+}
+interface SettlementPrepareResult {
+    paymasterAndData: Hex;
+    token: {
+        symbol: string;
+        address: Address;
+    };
+    quote: {
+        tokenPerEth: string;
+        validUntil: number;
+        bounds: {
+            min: string;
+            max: string;
+        };
+    };
+    nonce: string;
+    policyVersion: number;
 }
 type SwapRouteStepType = 'swap' | 'bridge';
 interface SwapRouteStep {
@@ -1346,6 +1395,7 @@ declare class VaultumClient {
         sessionKeyAddress: Address;
         chain?: string;
         vaultIndex?: number;
+        sponsorshipMode?: 'required' | 'prefer' | 'disabled';
         salt?: Hex;
         owners?: Address[];
         threshold?: number;
@@ -1489,19 +1539,19 @@ declare class VaultumClient {
     getSettlementQuote(params: {
         chain: string;
         sender: Address;
-        token: 'USDC' | 'USDT';
+        token: string;
         maxGasCost: string;
         maxFeePerGas: string;
         signal?: AbortSignal;
     }): Promise<SettlementQuote>;
     prepareSettlement(params: {
         chain: string;
-        token: 'USDC' | 'USDT';
+        token: string;
         userOp: UserOperation | PackedUserOperation | Record<string, unknown>;
         idempotencyKey?: string;
         timestamp?: number;
         signal?: AbortSignal;
-    }): Promise<UserOpResponse>;
+    }): Promise<SettlementPrepareResult>;
     swapQuote(params: {
         wallet: Address;
         fromChain: string;
@@ -2325,4 +2375,4 @@ declare function hashCrossChainRootTypedData(params: CrossChainRootTypedDataPara
 
 declare const VERSION: string;
 
-export { API, type AccountCreateResult, type AccountOperation, type AccountOperations, type AccountRoles, type AccountVerifyResult, type ActorPermissions, type AddressBookEntry, type AddressBookPage, type AddressCapabilities, type AggregatedRecoveryInitiateResponse, type AggregatedRecoveryPrepareExecutionResponse, type AggregatedRecoveryStatus, type AllowlistRoots, type AllowlistStatus, type ApiUser, type ArmedStatus, type AuthMeResponse, type AuthTokenResponse, type Automation, type AutomationDetails, type AutomationExecution, type AutomationExecutionStatus, type AutomationPage, type AutomationResponse, type AutomationStatus, type AutomationType, type BanStatus, CONTRACTS, type CanaryOptIn, type Capabilities, type ContractName, type CrossChainConfig, type CrossChainGasLimit, type CrossChainPendingProposal, type CrossChainReceiverState, type CrossChainRootTypedDataParams, type CrossChainRootTypedMessage, type CrossChainSkipProposal, type CursorPage, type EIP712Template, ENTRYPOINT_V07, type EnabledFeature, type ExecuteCall, FEATURE_IDS, FEATURE_ID_STRINGS, type FeatureConfig, type FeatureInfo, type FeatureInternal, type FinalizedProposal, GOVERNANCE_DOMAIN_NAME, GOVERNANCE_DOMAIN_VERSION, type GloballyPaused, type GuardianApproval, type GuardianConfig, type HasRole, type HealthStatus, type IsGuardian, type LogoutResponse, type NativeLimitConfig, type NativeLimitStatus, type OnChainRecoveryStatus, type OpWaitResponse, type OperationResult, type OperationState, type OtpInitResponse, type OtpVerifyResponse, type PackedUserOperation, type PasskeySignupResponse, type PasskeySuborgsResponse, type PortfolioTokenItem, type PortfolioTokensResponse, type Proposal, type ProposalCall, type ProposalDigest, type ProposalSignature, type ProposalsPage, type QuoteResponse, type QuoteResponseRaw, type RecoveryGuardians, type RecoveryProposal, type RecoveryProposalInfo, type RecoveryProposalState, type RecoveryStatus, type RegistryFeatures, type RegistryVersion, type RelayEstimate, type RequestContext, type RequestInterceptor, type ResponseContext, type ResponseInterceptor, type RetryConfig, type RoleBudget, type RoleInfo, type RolesInfo, type SDKErrorCode, type SelectorIndex, type SessionKeyCount, type SessionKeyInfo, type SessionKeyList, type SessionKeyPolicySigner, type SessionKeyRoles, type SessionKeyStatus, type SessionKeyTokenLimit, type SettlementQuote, type SettlementTokens, type SpendingLimitBucket, type SpendingLimitPreview, type SpendingLimitStatus, type SpendingLimitSummary, type TargetIndex, type TimestampValidation, type TimingConfig, type TokenLimitConfig, type TokenLimitFullStatus, type TokenLimitStatus, type TokenMaxTransfer, type TriggerAutomationResponse, UserOpBuilder, type UserOpBuilderConfig, type UserOpGasLimits, type UserOpResponse, type UserOpSimulationResponse, type UserOpTemplate, type UserOperation, type UserWalletInfo, VERSION, type ValidatorSelectorPermitted, type VaultDeployment, type VaultGroup, type VaultGroupsResponse, type VaultState, VaultumClient, type VaultumConfig, VaultumError, type WaitOptions, type WalletChallengeResponse, type WalletsResponse, buildCrossChainRootTypedData, createUserOpBuilder, getUserOpHash, hashCrossChainRootTypedData, packGasFees, packGasLimits, parseQuoteResponse, unpackGasFees, unpackGasLimits };
+export { API, type AccountCreateResult, type AccountOperation, type AccountOperations, type AccountRoles, type AccountVerifyResult, type ActorPermissions, type AddressBookEntry, type AddressBookPage, type AddressCapabilities, type AggregatedRecoveryInitiateResponse, type AggregatedRecoveryPrepareExecutionResponse, type AggregatedRecoveryStatus, type AllowlistRoots, type AllowlistStatus, type ApiUser, type ArmedStatus, type AuthMeResponse, type AuthTokenResponse, type Automation, type AutomationDetails, type AutomationExecution, type AutomationExecutionStatus, type AutomationPage, type AutomationResponse, type AutomationStatus, type AutomationType, type BanStatus, CONTRACTS, type CanaryOptIn, type Capabilities, type ContractName, type CrossChainConfig, type CrossChainGasLimit, type CrossChainPendingProposal, type CrossChainReceiverState, type CrossChainRootTypedDataParams, type CrossChainRootTypedMessage, type CrossChainSkipProposal, type CursorPage, type EIP712Template, ENTRYPOINT_V07, type EnabledFeature, type ExecuteCall, FEATURE_IDS, FEATURE_ID_STRINGS, type FeatureConfig, type FeatureInfo, type FeatureInternal, type FinalizedProposal, GOVERNANCE_DOMAIN_NAME, GOVERNANCE_DOMAIN_VERSION, type GloballyPaused, type GuardianApproval, type GuardianConfig, type HasRole, type HealthStatus, type IsGuardian, type LogoutResponse, type NativeLimitConfig, type NativeLimitStatus, type OnChainRecoveryStatus, type OpWaitResponse, type OperationResult, type OperationState, type OtpInitResponse, type OtpVerifyResponse, type PackedUserOperation, type PasskeySignupResponse, type PasskeySuborgsResponse, type PortfolioTokenItem, type PortfolioTokensResponse, type Proposal, type ProposalCall, type ProposalDigest, type ProposalSignature, type ProposalsPage, type QuoteResponse, type QuoteResponseRaw, type RecoveryGuardians, type RecoveryProposal, type RecoveryProposalInfo, type RecoveryProposalState, type RecoveryStatus, type RegistryFeatures, type RegistryVersion, type RelayEstimate, type RequestContext, type RequestInterceptor, type ResponseContext, type ResponseInterceptor, type RetryConfig, type RoleBudget, type RoleInfo, type RolesInfo, type SDKErrorCode, type SelectorIndex, type SessionKeyCount, type SessionKeyInfo, type SessionKeyList, type SessionKeyPolicySigner, type SessionKeyRoles, type SessionKeyStatus, type SessionKeyTokenLimit, type SettlementPrepareResult, type SettlementQuote, type SettlementTokens, type SpendingLimitBucket, type SpendingLimitPreview, type SpendingLimitStatus, type SpendingLimitSummary, type TargetIndex, type TimestampValidation, type TimingConfig, type TokenLimitConfig, type TokenLimitFullStatus, type TokenLimitStatus, type TokenMaxTransfer, type TriggerAutomationResponse, UserOpBuilder, type UserOpBuilderConfig, type UserOpGasLimits, type UserOpResponse, type UserOpSimulationResponse, type UserOpTemplate, type UserOperation, type UserWalletInfo, VERSION, type ValidatorSelectorPermitted, type VaultDeployment, type VaultGroup, type VaultGroupsResponse, type VaultState, VaultumClient, type VaultumConfig, VaultumError, type WaitOptions, type WalletChallengeResponse, type WalletsResponse, buildCrossChainRootTypedData, createUserOpBuilder, getUserOpHash, hashCrossChainRootTypedData, packGasFees, packGasLimits, parseQuoteResponse, unpackGasFees, unpackGasLimits };

package/dist/index.js

@@ -744,13 +744,28 @@ var VaultumClient = class {
         const data = await res.json().catch(() => ({}));
         if (!res.ok) {
           const errBody = data;
-          const rawCode = errBody.code ?? errBody.error;
+          let rawCode;
+          let message;
+          let details;
+          if (typeof errBody.code === "string") rawCode = errBody.code;
+          if (typeof errBody.message === "string") message = errBody.message;
+          if ("details" in errBody) details = errBody.details;
+          const nested = errBody.error;
+          if (nested && typeof nested === "object") {
+            const nestedErr = nested;
+            if (!rawCode && typeof nestedErr.code === "string") rawCode = nestedErr.code;
+            if (!message && typeof nestedErr.message === "string") message = nestedErr.message;
+            if (details === void 0 && "details" in nestedErr) details = nestedErr.details;
+          } else if (typeof nested === "string") {
+            if (!rawCode) rawCode = nested;
+          }
           const code = mapErrorCode(rawCode, res.status);
+          const fallbackMessage = message ?? (typeof nested === "string" ? nested : void 0) ?? `Request failed: ${res.status}`;
           throw new VaultumError(
-            errBody.message ?? errBody.error ?? `Request failed: ${res.status}`,
+            fallbackMessage,
             code,
             res.status,
-            errBody.details,
+            details,
             RETRYABLE_CODES.has(code) || RETRYABLE_STATUS.has(res.status),
             rawCode
           );
@@ -911,10 +926,10 @@ var VaultumClient = class {
     return {
       vaultGroups: (raw.vaultGroups ?? []).map((g) => ({
         id: g.id,
-        vaultIndex: g.vault_index,
+        vaultIndex: g.vaultIndex,
         address: g.address.toLowerCase(),
         deployments: (g.deployments ?? []).map((d) => ({
-          chainId: d.chain_id,
+          chainId: d.chainId,
           deployed: d.deployed
         }))
       }))
@@ -983,6 +998,7 @@ var VaultumClient = class {
       type: "create",
       chain: options.chain ?? this.chain,
       vaultIndex: options.vaultIndex,
+      sponsorshipMode: options.sponsorshipMode ?? "prefer",
       salt: options.salt,
       owners: options.owners?.map((a) => a.toLowerCase()),
       threshold: options.threshold,
@@ -1126,16 +1142,57 @@ var VaultumClient = class {
   }
   async getSettlementTokens(options) {
     const chain = options?.chain ?? this.chain ?? "sepolia";
-    return this.request("GET", `${API.settlement.tokens}?chain=${chain}`, void 0, { signal: options?.signal });
+    const raw = await this.request("GET", `${API.settlement.tokens}?chain=${chain}`, void 0, {
+      signal: options?.signal
+    });
+    return {
+      chainId: Number(raw.chainId),
+      paymaster: raw.paymaster ? raw.paymaster.toLowerCase() : null,
+      tokens: (raw.tokens ?? []).map((token) => ({
+        symbol: token.symbol,
+        address: token.address.toLowerCase(),
+        pricing: {
+          currentRate: token.pricing.currentRate,
+          minRate: token.pricing.minRate,
+          maxRate: token.pricing.maxRate,
+          maxChargePerOp: token.pricing.maxChargePerOp
+        }
+      }))
+    };
   }
   async getSettlementQuote(params) {
-    return this.request("POST", API.settlement.quote, {
+    const raw = await this.request("POST", API.settlement.quote, {
       chain: params.chain,
       sender: params.sender.toLowerCase(),
       token: params.token,
       maxGasCost: params.maxGasCost,
       maxFeePerGas: params.maxFeePerGas
     }, { signal: params.signal });
+    const quote = raw;
+    return {
+      chainId: Number(quote.chainId),
+      sender: quote.sender.toLowerCase(),
+      token: {
+        symbol: quote.token.symbol,
+        address: quote.token.address.toLowerCase()
+      },
+      quote: {
+        tokenPerEth: quote.quote.tokenPerEth,
+        maxTokenCharge: quote.quote.maxTokenCharge,
+        postOpGasOverhead: quote.quote.postOpGasOverhead,
+        validAfter: Number(quote.quote.validAfter),
+        validUntil: Number(quote.quote.validUntil),
+        nonce: quote.quote.nonce,
+        bounds: {
+          min: quote.quote.bounds.min,
+          max: quote.quote.bounds.max
+        }
+      },
+      gasLimits: {
+        paymasterVerificationGasLimit: quote.gasLimits.paymasterVerificationGasLimit,
+        paymasterPostOpGasLimit: quote.gasLimits.paymasterPostOpGasLimit
+      }
+    };
   }
   async prepareSettlement(params) {
     const userOp = isPackedUserOp(params.userOp) ? packedToUserOperation(params.userOp) : isUserOperation(params.userOp) ? normalizeUserOperation(params.userOp) : params.userOp;
@@ -1146,11 +1203,29 @@ var VaultumClient = class {
     };
     const idempotencyKey = params.idempotencyKey ?? autoIdempotencyKey(body);
     const timestamp = params.timestamp ?? nowUnix();
-    return this.request("POST", API.settlement.prepare, body, {
+    const raw = await this.request("POST", API.settlement.prepare, body, {
       idempotencyKey,
       timestamp,
       signal: params.signal
     });
+    const prepared = raw;
+    return {
+      paymasterAndData: prepared.paymasterAndData,
+      token: {
+        symbol: prepared.token.symbol,
+        address: prepared.token.address.toLowerCase()
+      },
+      quote: {
+        tokenPerEth: prepared.quote.tokenPerEth,
+        validUntil: Number(prepared.quote.validUntil),
+        bounds: {
+          min: prepared.quote.bounds.min,
+          max: prepared.quote.bounds.max
+        }
+      },
+      nonce: prepared.nonce,
+      policyVersion: Number(prepared.policyVersion)
+    };
   }
   async swapQuote(params) {
     return this.request("POST", API.swap.quote, {
@@ -2067,7 +2142,7 @@ function hashCrossChainRootTypedData(params) {
 }
 
 // src/index.ts
-var VERSION = "0.1.7";
+var VERSION = "0.1.9";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   API,

package/dist/index.mjs

@@ -708,13 +708,28 @@ var VaultumClient = class {
         const data = await res.json().catch(() => ({}));
         if (!res.ok) {
           const errBody = data;
-          const rawCode = errBody.code ?? errBody.error;
+          let rawCode;
+          let message;
+          let details;
+          if (typeof errBody.code === "string") rawCode = errBody.code;
+          if (typeof errBody.message === "string") message = errBody.message;
+          if ("details" in errBody) details = errBody.details;
+          const nested = errBody.error;
+          if (nested && typeof nested === "object") {
+            const nestedErr = nested;
+            if (!rawCode && typeof nestedErr.code === "string") rawCode = nestedErr.code;
+            if (!message && typeof nestedErr.message === "string") message = nestedErr.message;
+            if (details === void 0 && "details" in nestedErr) details = nestedErr.details;
+          } else if (typeof nested === "string") {
+            if (!rawCode) rawCode = nested;
+          }
           const code = mapErrorCode(rawCode, res.status);
+          const fallbackMessage = message ?? (typeof nested === "string" ? nested : void 0) ?? `Request failed: ${res.status}`;
           throw new VaultumError(
-            errBody.message ?? errBody.error ?? `Request failed: ${res.status}`,
+            fallbackMessage,
             code,
             res.status,
-            errBody.details,
+            details,
             RETRYABLE_CODES.has(code) || RETRYABLE_STATUS.has(res.status),
             rawCode
           );
@@ -875,10 +890,10 @@ var VaultumClient = class {
     return {
       vaultGroups: (raw.vaultGroups ?? []).map((g) => ({
         id: g.id,
-        vaultIndex: g.vault_index,
+        vaultIndex: g.vaultIndex,
         address: g.address.toLowerCase(),
         deployments: (g.deployments ?? []).map((d) => ({
-          chainId: d.chain_id,
+          chainId: d.chainId,
           deployed: d.deployed
         }))
       }))
@@ -947,6 +962,7 @@ var VaultumClient = class {
       type: "create",
       chain: options.chain ?? this.chain,
       vaultIndex: options.vaultIndex,
+      sponsorshipMode: options.sponsorshipMode ?? "prefer",
       salt: options.salt,
       owners: options.owners?.map((a) => a.toLowerCase()),
       threshold: options.threshold,
@@ -1090,16 +1106,57 @@ var VaultumClient = class {
   }
   async getSettlementTokens(options) {
     const chain = options?.chain ?? this.chain ?? "sepolia";
-    return this.request("GET", `${API.settlement.tokens}?chain=${chain}`, void 0, { signal: options?.signal });
+    const raw = await this.request("GET", `${API.settlement.tokens}?chain=${chain}`, void 0, {
+      signal: options?.signal
+    });
+    return {
+      chainId: Number(raw.chainId),
+      paymaster: raw.paymaster ? raw.paymaster.toLowerCase() : null,
+      tokens: (raw.tokens ?? []).map((token) => ({
+        symbol: token.symbol,
+        address: token.address.toLowerCase(),
+        pricing: {
+          currentRate: token.pricing.currentRate,
+          minRate: token.pricing.minRate,
+          maxRate: token.pricing.maxRate,
+          maxChargePerOp: token.pricing.maxChargePerOp
+        }
+      }))
+    };
   }
   async getSettlementQuote(params) {
-    return this.request("POST", API.settlement.quote, {
+    const raw = await this.request("POST", API.settlement.quote, {
       chain: params.chain,
       sender: params.sender.toLowerCase(),
       token: params.token,
       maxGasCost: params.maxGasCost,
       maxFeePerGas: params.maxFeePerGas
     }, { signal: params.signal });
+    const quote = raw;
+    return {
+      chainId: Number(quote.chainId),
+      sender: quote.sender.toLowerCase(),
+      token: {
+        symbol: quote.token.symbol,
+        address: quote.token.address.toLowerCase()
+      },
+      quote: {
+        tokenPerEth: quote.quote.tokenPerEth,
+        maxTokenCharge: quote.quote.maxTokenCharge,
+        postOpGasOverhead: quote.quote.postOpGasOverhead,
+        validAfter: Number(quote.quote.validAfter),
+        validUntil: Number(quote.quote.validUntil),
+        nonce: quote.quote.nonce,
+        bounds: {
+          min: quote.quote.bounds.min,
+          max: quote.quote.bounds.max
+        }
+      },
+      gasLimits: {
+        paymasterVerificationGasLimit: quote.gasLimits.paymasterVerificationGasLimit,
+        paymasterPostOpGasLimit: quote.gasLimits.paymasterPostOpGasLimit
+      }
+    };
   }
   async prepareSettlement(params) {
     const userOp = isPackedUserOp(params.userOp) ? packedToUserOperation(params.userOp) : isUserOperation(params.userOp) ? normalizeUserOperation(params.userOp) : params.userOp;
@@ -1110,11 +1167,29 @@ var VaultumClient = class {
     };
     const idempotencyKey = params.idempotencyKey ?? autoIdempotencyKey(body);
     const timestamp = params.timestamp ?? nowUnix();
-    return this.request("POST", API.settlement.prepare, body, {
+    const raw = await this.request("POST", API.settlement.prepare, body, {
       idempotencyKey,
       timestamp,
       signal: params.signal
     });
+    const prepared = raw;
+    return {
+      paymasterAndData: prepared.paymasterAndData,
+      token: {
+        symbol: prepared.token.symbol,
+        address: prepared.token.address.toLowerCase()
+      },
+      quote: {
+        tokenPerEth: prepared.quote.tokenPerEth,
+        validUntil: Number(prepared.quote.validUntil),
+        bounds: {
+          min: prepared.quote.bounds.min,
+          max: prepared.quote.bounds.max
+        }
+      },
+      nonce: prepared.nonce,
+      policyVersion: Number(prepared.policyVersion)
+    };
   }
   async swapQuote(params) {
     return this.request("POST", API.swap.quote, {
@@ -2031,7 +2106,7 @@ function hashCrossChainRootTypedData(params) {
 }
 
 // src/index.ts
-var VERSION = "0.1.7";
+var VERSION = "0.1.9";
 export {
   API,
   CONTRACTS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vaultum/sdk",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "TypeScript SDK for Vaultum smart wallet",
   "main": "dist/index.js",
   "module": "dist/index.mjs",