Enum ConversionInfo 

pub enum ConversionInfo {
    Amm {
        pool_id: String,
        conversion_id: String,
        status: ConversionStatus,
        fee: Option<u128>,
        purpose: Option<ConversionPurpose>,
        amount_adjustment: Option<AmountAdjustmentReason>,
    },
    Orchestra {

        order_id: String,
        quote_id: String,
        read_token: Option<String>,
        chain: String,
        chain_id: Option<String>,
        asset: String,
        recipient_address: String,
        asset_amount_in: Option<u128>,
        estimated_out: u128,
        delivered_amount: Option<u128>,
        status: ConversionStatus,
        fee_amount: Option<u128>,
        service_fee_amount: Option<u128>,
        service_fee_asset: Option<String>,
        asset_decimals: u32,
        asset_contract: Option<String>,
    
},
    Boltz {

        swap_id: String,
        invoice: String,
        invoice_amount_sats: u64,
        bridge_ref: Option<String>,
        max_slippage_bps: u32,
        quote_degraded: bool,
        chain: String,
        chain_id: Option<String>,
        asset: String,
        recipient_address: String,
        estimated_out: u128,
        delivered_amount: Option<u128>,
        status: ConversionStatus,
        asset_amount_in: Option<u128>,
        fee_amount: Option<u128>,
        service_fee_amount: Option<u128>,
        service_fee_asset: Option<String>,
        asset_decimals: u32,
        asset_contract: Option<String>,
    
},
}

Details of the asset conversion attached to a payment, when the payment involves a swap or cross-chain bridge in addition to the on-Spark transfer.

The variant identifies which provider handled the conversion:

• ConversionInfo::Amm for Spark token swaps via Flashnet AMM pools.
• ConversionInfo::Orchestra for cross-chain sends via Flashnet Orchestra (Spark → external chain).
• ConversionInfo::Boltz for sats → stable-coin reverse swaps via Boltz.

Variants

Amm

AMM (Flashnet pool-based) conversion — Spark ↔ Spark token swaps.

Fields

pool_id: String

The pool id associated with the conversion

conversion_id: String

The conversion id shared by both sides of the conversion

status: ConversionStatus

The status of the conversion

fee: Option<u128>

The fee paid for the conversion. Denominated in satoshis if converting from Bitcoin, otherwise in the token base units.

purpose: Option<ConversionPurpose>

The purpose of the conversion

amount_adjustment: Option<AmountAdjustmentReason>

The reason the conversion amount was adjusted, if applicable.

Orchestra

Orchestra cross-chain conversion via the Flashnet orchestration API.

Fields

order_id: String

The Orchestra order id returned by /v1/orchestration/submit.

quote_id: String

The Orchestra quote id used to create this order.

read_token: Option<String>

Opaque token required for querying order status.

chain: String

Chain name (e.g. "base", "solana", "tron").

chain_id: Option<String>

Stable chain identifier (e.g. EVM chainId decimal string "8453" for Base, SLIP-44 or similar for other chains). None if the provider doesn’t expose one for this route.

asset: String

Asset ticker (e.g. "USDC", "USDT").

recipient_address: String

Recipient address on the target chain.

asset_amount_in: Option<u128>

Amount in expressed in the cross-chain asset’s base units, via the rate the SDK used at prepare time.

estimated_out: u128

Estimated recipient amount, frozen at prepare time.

delivered_amount: Option<u128>

Actual delivered amount, Unset until the order reaches a terminal state.

status: ConversionStatus

fee_amount: Option<u128>

Best-available total fee in destination asset base units. Prepare-time estimate while pending, realized fee when Completed.

service_fee_amount: Option<u128>

Orchestra service fee.

service_fee_asset: Option<String>

Asset the service fee is denominated in. Unset means BTC sats.

asset_decimals: u32

Asset decimals (e.g. 6 for USDC).

asset_contract: Option<String>

Token contract / mint address. Unset for native-asset destinations.

Boltz

Boltz reverse swap: cross-chain conversion via Lightning hold invoice.

The swap’s secrets and lifecycle state live on the synced Boltz swap row keyed by swap_id, which also drives cross-instance recovery.

Fields

swap_id: String

The Boltz swap id returned by POST /swap/reverse.

invoice: String

The BOLT11 hold invoice paid on the Spark/Lightning side.

invoice_amount_sats: u64

Amount of the hold invoice in sats.

bridge_ref: Option<String>

Cross-chain bridge tracking handle for bridged swaps: a LayerZero message GUID for OFT (USDT0) routes, or a CCTP reference for USDC routes. None for same-chain (Arbitrum-direct) delivery.

max_slippage_bps: u32

DEX slippage tolerance (basis points) committed at prepare time.

quote_degraded: bool

Whether the claim-time DEX quote drifted beyond max_slippage_bps.

chain: String

Chain name (e.g. "arbitrum", "solana", "tron").

chain_id: Option<String>

Stable chain identifier (e.g. EVM chainId decimal string "42161" for Arbitrum). None if the provider doesn’t expose one for this route.

asset: String

Asset ticker (e.g. "USDT", "USDT0").

recipient_address: String

Recipient address on the target chain.

estimated_out: u128

Estimated amount in the asset’s base units, frozen at prepare time.

delivered_amount: Option<u128>

Actual amount delivered. None until the claim receipt is processed.

status: ConversionStatus

Current status of the reverse swap.

asset_amount_in: Option<u128>

Amount in expressed in the cross-chain asset’s base units, via the BTC/USD rate the SDK used at prepare time.

fee_amount: Option<u128>

Best-available total fee in destination asset base units. Prepare-time estimate while pending, realized fee on Completed.

service_fee_amount: Option<u128>

Boltz spread in sats.

service_fee_asset: Option<String>

Asset service fee is denominated in. Unset means BTC sats.

asset_decimals: u32

Asset decimals (e.g. 6 for USDT).

asset_contract: Option<String>

Token contract / mint address. Unset for native-asset destinations.

Implementations

impl ConversionInfo

pub fn status(&self) -> &ConversionStatus

The current status, regardless of conversion type.

pub fn status_mut(&mut self) -> &mut ConversionStatus

A mutable reference to the status, for in-place updates.

pub fn fee(&self) -> Option<u128>

Headline fee: AMM pool fee in source units, or the cross-chain total in destination-asset base units.

pub fn is_amm(&self) -> bool

Whether this is an AMM (Flashnet pool) conversion.

pub fn is_orchestra(&self) -> bool

Whether this is an Orchestra (cross-chain) conversion.

pub fn is_boltz(&self) -> bool

Whether this is a Boltz reverse swap.

Trait Implementations

impl Clone for ConversionInfo

fn clone(&self) -> ConversionInfo

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ConversionInfo

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ConversionInfo

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ConversionInfo

fn eq(&self, other: &ConversionInfo) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ConversionInfo

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ConversionInfo