Class AdvancedFeeCalculator

Advanced fee calculator with stamp-specific optimizations

Hierarchy (View Summary)

FeeEstimator
- AdvancedFeeCalculator

Constructors

constructor

new AdvancedFeeCalculator(
options?: { networkType?: "mainnet" | "testnet" | "regtest" },
): AdvancedFeeCalculator
Parameters
- Optionaloptions: { networkType?: "mainnet" | "testnet" | "regtest" }
Returns AdvancedFeeCalculator
Overrides FeeEstimator.constructor
- Defined in calculators/advanced-fee-calculator.ts:99

Methods

analyzeCompressionSavings

analyzeCompressionSavings(data: Buffer): CompressionAnalysis
Analyze potential compression savings for witness data Can achieve 2-8% savings on data-heavy stamp operations
Parameters
- data: Buffer
Returns CompressionAnalysis
- Defined in calculators/advanced-fee-calculator.ts:181

calculateBatchFee

calculateBatchFee(stamps: StampData[], feeRateSatsPerVB: number): FeeBreakdown
Calculate batch transaction fee with amortization using normalized satsPerVB Achieves 5-15% savings through intelligent batching
Parameters
- stamps: StampData[]
- feeRateSatsPerVB: number
Returns FeeBreakdown
- Defined in calculators/advanced-fee-calculator.ts:112

calculateCPFP

calculateCPFP(
    parentTxid: string,
    parentFee: number,
    childSize: number,
    targetFeeRate: number,
): Promise<number>
Calculate CPFP (Child Pays For Parent) fee
Parameters
- parentTxid: string
- parentFee: number
- childSize: number
- targetFeeRate: number
Returns Promise<number>
Inherited from FeeEstimator.calculateCPFP
- Defined in core/fee-estimator.ts:298

calculateOptimalDustThreshold

calculateOptimalDustThreshold(
network: "mainnet" | "testnet",
feeRate?: number,
): number
Calculate optimal dust threshold based on network conditions using normalized satsPerVB Dynamically adjusts to current fee environment
Parameters
- network: "mainnet" | "testnet"
- OptionalfeeRate: number
Returns number
- Defined in calculators/advanced-fee-calculator.ts:232

calculateRBF

calculateRBF(originalFee: number, minRelayFee?: number): number
Calculate RBF (Replace By Fee) fee
Parameters
- originalFee: number
- minRelayFee: number = 1
Returns number
Inherited from FeeEstimator.calculateRBF
- Defined in core/fee-estimator.ts:341

calculateRBFBump

calculateRBFBump(
    originalFee: number,
    targetConfirmation: number,
    feeRates?: { high: number; low: number; medium: number; urgent?: number },
): number
Calculate RBF fee bump with stamp-specific considerations using normalized satsPerVB Optimizes fee bumps for stamp transactions
Parameters
- originalFee: number
- targetConfirmation: number
- OptionalfeeRates: { high: number; low: number; medium: number; urgent?: number }
Returns number
- Defined in calculators/advanced-fee-calculator.ts:330

calculateTransactionSize

calculateTransactionSize(
inputs: { type: InputType; witnessScript?: Buffer<ArrayBufferLike> }[],
outputs: { size?: number; type: OutputType }[],
): SizeCalculation
Calculate accurate transaction size with witness data
Parameters
- inputs: { type: InputType; witnessScript?: Buffer<ArrayBufferLike> }[]
- outputs: { size?: number; type: OutputType }[]
Returns SizeCalculation
Inherited from FeeEstimator.calculateTransactionSize
- Defined in core/fee-estimator.ts:195

estimateFee

estimateFee(
size: number,
priority: "low" | "medium" | "high" | "urgent",
): Promise<FeeEstimate>
Estimate fee for transaction with enhanced calculation
Parameters
- size: number
- priority: "low" | "medium" | "high" | "urgent"
Returns Promise<FeeEstimate>
Inherited from FeeEstimator.estimateFee
- Defined in core/fee-estimator.ts:155

getDustThresholds

getDustThresholds(feeRate?: number): DustThresholds
Get dynamic dust thresholds based on fee rates
Parameters
- OptionalfeeRate: number
Returns DustThresholds
Inherited from FeeEstimator.getDustThresholds
- Defined in core/fee-estimator.ts:268

getFeeRates

getFeeRates(): Promise<FeeRate>
Get current fee rates with historical context

Returns Promise<FeeRate>
Inherited from FeeEstimator.getFeeRates
- Defined in core/fee-estimator.ts:100

getInputSize

getInputSize(
type: InputType,
witnessScript?: Buffer<ArrayBufferLike>,
): SizeCalculation
Calculate input type specific sizes
Parameters
- type: InputType
- OptionalwitnessScript: Buffer<ArrayBufferLike>
Returns SizeCalculation
Inherited from FeeEstimator.getInputSize
- Defined in core/fee-estimator.ts:224

getNormalizedFeeRates

getNormalizedFeeRates(): Promise<
    {
        high: NormalizedFeeRate;
        low: NormalizedFeeRate;
        medium: NormalizedFeeRate;
        urgent: NormalizedFeeRate;
    },
>
Get normalized fee rates for all priority levels

Returns Promise<
    {
        high: NormalizedFeeRate;
        low: NormalizedFeeRate;
        medium: NormalizedFeeRate;
        urgent: NormalizedFeeRate;
    },
>
Inherited from FeeEstimator.getNormalizedFeeRates
- Defined in core/fee-estimator.ts:404

getOptimalFee

getOptimalFee(
    params: {
        inputs: { type: InputType; witnessScript?: Buffer<ArrayBufferLike> }[];
        outputs: { size?: number; type: OutputType }[];
        priority?: "low" | "medium" | "high" | "urgent";
    },
): Promise<FeeEstimate & { sizeBreakdown: SizeCalculation }>
Get fee estimation for specific transaction parameters
Parameters
- params: {
      inputs: { type: InputType; witnessScript?: Buffer<ArrayBufferLike> }[];
      outputs: { size?: number; type: OutputType }[];
      priority?: "low" | "medium" | "high" | "urgent";
  }
Returns Promise<FeeEstimate & { sizeBreakdown: SizeCalculation }>
Inherited from FeeEstimator.getOptimalFee
- Defined in core/fee-estimator.ts:351

getOutputSize

getOutputSize(type: OutputType, scriptSize?: number): number
Calculate output type specific sizes
Parameters
- type: OutputType
- OptionalscriptSize: number
Returns number
Inherited from FeeEstimator.getOutputSize
- Defined in core/fee-estimator.ts:216

getProviderInfo

getProviderInfo(): {
    electrumXConnected: boolean;
    fallbackFeeRate: number;
    provider: string;
    useMockProvider: boolean;
}
Get current provider configuration

Returns {
    electrumXConnected: boolean;
    fallbackFeeRate: number;
    provider: string;
    useMockProvider: boolean;
}
Inherited from FeeEstimator.getProviderInfo
- Defined in core/fee-estimator.ts:550

isAboveDustThreshold

isAboveDustThreshold(
    value: number,
    outputType: OutputType,
    feeRate?: number,
): boolean
Validate if output value is above dust threshold
Parameters
- value: number
- outputType: OutputType
- OptionalfeeRate: number
Returns boolean
Inherited from FeeEstimator.isAboveDustThreshold
- Defined in core/fee-estimator.ts:373

predictMultiStepFees

predictMultiStepFees(operations: Operation[]): FeePrediction
Predict fees for multi-step stamp operations Provides accurate cost estimates for complex workflows
Parameters
- operations: Operation[]
Returns FeePrediction
- Defined in calculators/advanced-fee-calculator.ts:264

setProvider

setProvider(
    provider: NonNullable<
        undefined
        | "mempool"
        | "blockstream"
        | "electrum"
        | "custom",
    >,
): void
Set custom fee provider
Parameters
- provider: NonNullable<undefined | "mempool" | "blockstream" | "electrum" | "custom">
Returns void
Inherited from FeeEstimator.setProvider
- Defined in core/fee-estimator.ts:533

suggestOptimizations

suggestOptimizations(transaction: Transaction): Optimization[]
Suggest optimizations for given transaction Provides actionable recommendations for cost reduction
Parameters
- transaction: Transaction
Returns Optimization[]
- Defined in calculators/advanced-fee-calculator.ts:380

testProvider

testProvider(): Promise<
{ error?: string; latency?: number; provider: string; success: boolean },
>
Test connection to current fee provider

Returns Promise<
{ error?: string; latency?: number; provider: string; success: boolean },
>
Inherited from FeeEstimator.testProvider
- Defined in core/fee-estimator.ts:567

Class AdvancedFeeCalculator

Hierarchy (View Summary)

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns AdvancedFeeCalculator

Methods

analyzeCompressionSavings

Parameters

Returns CompressionAnalysis

calculateBatchFee

Parameters

Returns FeeBreakdown

calculateCPFP

Parameters

Returns Promise<number>

calculateOptimalDustThreshold

Parameters

Returns number

calculateRBF

Parameters

Returns number

calculateRBFBump

Parameters

Returns number

calculateTransactionSize

Parameters

Returns SizeCalculation

estimateFee

Parameters

Returns Promise<FeeEstimate>

getDustThresholds

Parameters

Returns DustThresholds

getFeeRates

Returns Promise<FeeRate>

getInputSize

Parameters

Returns SizeCalculation

getNormalizedFeeRates

Returns Promise< { high: NormalizedFeeRate; low: NormalizedFeeRate; medium: NormalizedFeeRate; urgent: NormalizedFeeRate; },>

getOptimalFee

Parameters

Returns Promise<FeeEstimate & { sizeBreakdown: SizeCalculation }>

getOutputSize

Parameters

Returns number

getProviderInfo

Returns { electrumXConnected: boolean; fallbackFeeRate: number; provider: string; useMockProvider: boolean;}

isAboveDustThreshold

Parameters

Returns boolean

predictMultiStepFees

Parameters

Returns FeePrediction

setProvider

Parameters

Returns void

suggestOptimizations

Parameters

Returns Optimization[]

testProvider

Returns Promise< { error?: string; latency?: number; provider: string; success: boolean },>

Settings

On This Page

Returns Promise<
{
high: NormalizedFeeRate;
low: NormalizedFeeRate;
medium: NormalizedFeeRate;
urgent: NormalizedFeeRate;
},
>

Returns {
electrumXConnected: boolean;
fallbackFeeRate: number;
provider: string;
useMockProvider: boolean;
}

Returns Promise<
{ error?: string; latency?: number; provider: string; success: boolean },
>