Files
breez-sdk-liquid/packages/dart/lib/src/model.dart
Ross Savage 3867fa91da Get Payment (#476)
* Get payment by destination

* CI fixes

* Remove claim_address from query

* Add PaymentDestination enum

* Add payment hash as a payment query option

* Bump Flutter dependencies

* Move destination/address queries to list_payments

* Apply suggestions from code review

Co-authored-by: yse <70684173+hydra-yse@users.noreply.github.com>

---------

Co-authored-by: yse <70684173+hydra-yse@users.noreply.github.com>
2024-10-10 17:44:32 +02:00

1232 lines
35 KiB
Dart

// This file is automatically generated, so please do not edit it.
// @generated by `flutter_rust_bridge`@ 2.4.0.
// ignore_for_file: invalid_use_of_internal_member, unused_import, unnecessary_import
import 'bindings.dart';
import 'frb_generated.dart';
import 'package:flutter_rust_bridge/flutter_rust_bridge_for_generated.dart';
import 'package:freezed_annotation/freezed_annotation.dart' hide protected;
part 'model.freezed.dart';
/// An argument when calling [crate::sdk::LiquidSdk::backup].
class BackupRequest {
/// Path to the backup.
///
/// If not set, it defaults to `backup.sql` for mainnet and `backup-testnet.sql` for testnet.
/// The file will be saved in [ConnectRequest]'s `data_dir`.
final String? backupPath;
const BackupRequest({
this.backupPath,
});
@override
int get hashCode => backupPath.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is BackupRequest && runtimeType == other.runtimeType && backupPath == other.backupPath;
}
/// An argument of [PrepareBuyBitcoinRequest] when calling [crate::sdk::LiquidSdk::prepare_buy_bitcoin].
enum BuyBitcoinProvider {
moonpay,
;
}
/// An argument when calling [crate::sdk::LiquidSdk::buy_bitcoin].
class BuyBitcoinRequest {
final PrepareBuyBitcoinResponse prepareResponse;
/// The optional URL to redirect to after completing the buy.
///
/// For Moonpay, see <https://dev.moonpay.com/docs/on-ramp-configure-user-journey-params>
final String? redirectUrl;
const BuyBitcoinRequest({
required this.prepareResponse,
this.redirectUrl,
});
@override
int get hashCode => prepareResponse.hashCode ^ redirectUrl.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is BuyBitcoinRequest &&
runtimeType == other.runtimeType &&
prepareResponse == other.prepareResponse &&
redirectUrl == other.redirectUrl;
}
/// An argument when calling [crate::sdk::LiquidSdk::check_message].
class CheckMessageRequest {
/// The message that was signed.
final String message;
/// The public key of the node that signed the message.
final String pubkey;
/// The zbase encoded signature to verify.
final String signature;
const CheckMessageRequest({
required this.message,
required this.pubkey,
required this.signature,
});
@override
int get hashCode => message.hashCode ^ pubkey.hashCode ^ signature.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is CheckMessageRequest &&
runtimeType == other.runtimeType &&
message == other.message &&
pubkey == other.pubkey &&
signature == other.signature;
}
/// Returned when calling [crate::sdk::LiquidSdk::check_message].
class CheckMessageResponse {
/// Boolean value indicating whether the signature covers the message and
/// was signed by the given pubkey.
final bool isValid;
const CheckMessageResponse({
required this.isValid,
});
@override
int get hashCode => isValid.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is CheckMessageResponse && runtimeType == other.runtimeType && isValid == other.isValid;
}
/// Configuration for the Liquid SDK
class Config {
final String liquidElectrumUrl;
final String bitcoinElectrumUrl;
/// The mempool.space API URL, has to be in the format: `https://mempool.space/api`
final String mempoolspaceUrl;
/// Directory in which all SDK files (DB, log, cache) are stored.
///
/// Prefix can be a relative or absolute path to this directory.
final String workingDir;
final LiquidNetwork network;
/// Send payment timeout. See [crate::sdk::LiquidSdk::send_payment]
final BigInt paymentTimeoutSec;
/// Zero-conf minimum accepted fee-rate in millisatoshis per vbyte
final int zeroConfMinFeeRateMsat;
/// Maximum amount in satoshi to accept zero-conf payments with
/// Defaults to [crate::receive_swap::DEFAULT_ZERO_CONF_MAX_SAT]
final BigInt? zeroConfMaxAmountSat;
/// The Breez API key used for making requests to their mempool service
final String? breezApiKey;
const Config({
required this.liquidElectrumUrl,
required this.bitcoinElectrumUrl,
required this.mempoolspaceUrl,
required this.workingDir,
required this.network,
required this.paymentTimeoutSec,
required this.zeroConfMinFeeRateMsat,
this.zeroConfMaxAmountSat,
this.breezApiKey,
});
@override
int get hashCode =>
liquidElectrumUrl.hashCode ^
bitcoinElectrumUrl.hashCode ^
mempoolspaceUrl.hashCode ^
workingDir.hashCode ^
network.hashCode ^
paymentTimeoutSec.hashCode ^
zeroConfMinFeeRateMsat.hashCode ^
zeroConfMaxAmountSat.hashCode ^
breezApiKey.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is Config &&
runtimeType == other.runtimeType &&
liquidElectrumUrl == other.liquidElectrumUrl &&
bitcoinElectrumUrl == other.bitcoinElectrumUrl &&
mempoolspaceUrl == other.mempoolspaceUrl &&
workingDir == other.workingDir &&
network == other.network &&
paymentTimeoutSec == other.paymentTimeoutSec &&
zeroConfMinFeeRateMsat == other.zeroConfMinFeeRateMsat &&
zeroConfMaxAmountSat == other.zeroConfMaxAmountSat &&
breezApiKey == other.breezApiKey;
}
/// An argument when calling [crate::sdk::LiquidSdk::connect].
class ConnectRequest {
final String mnemonic;
final Config config;
const ConnectRequest({
required this.mnemonic,
required this.config,
});
@override
int get hashCode => mnemonic.hashCode ^ config.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is ConnectRequest &&
runtimeType == other.runtimeType &&
mnemonic == other.mnemonic &&
config == other.config;
}
/// Returned when calling [crate::sdk::LiquidSdk::get_info].
class GetInfoResponse {
/// Usable balance. This is the confirmed onchain balance minus `pending_send_sat`.
final BigInt balanceSat;
/// Amount that is being used for ongoing Send swaps
final BigInt pendingSendSat;
/// Incoming amount that is pending from ongoing Receive swaps
final BigInt pendingReceiveSat;
final String pubkey;
const GetInfoResponse({
required this.balanceSat,
required this.pendingSendSat,
required this.pendingReceiveSat,
required this.pubkey,
});
@override
int get hashCode =>
balanceSat.hashCode ^ pendingSendSat.hashCode ^ pendingReceiveSat.hashCode ^ pubkey.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is GetInfoResponse &&
runtimeType == other.runtimeType &&
balanceSat == other.balanceSat &&
pendingSendSat == other.pendingSendSat &&
pendingReceiveSat == other.pendingReceiveSat &&
pubkey == other.pubkey;
}
@freezed
sealed class GetPaymentRequest with _$GetPaymentRequest {
const GetPaymentRequest._();
/// The Lightning payment hash of the payment
const factory GetPaymentRequest.lightning({
required String paymentHash,
}) = GetPaymentRequest_Lightning;
}
/// Returned when calling [crate::sdk::LiquidSdk::fetch_lightning_limits].
class LightningPaymentLimitsResponse {
/// Amount limits for a Send Payment to be valid
final Limits send;
/// Amount limits for a Receive Payment to be valid
final Limits receive;
const LightningPaymentLimitsResponse({
required this.send,
required this.receive,
});
@override
int get hashCode => send.hashCode ^ receive.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is LightningPaymentLimitsResponse &&
runtimeType == other.runtimeType &&
send == other.send &&
receive == other.receive;
}
/// The minimum and maximum in satoshis of a Lightning or onchain payment.
class Limits {
final BigInt minSat;
final BigInt maxSat;
final BigInt maxZeroConfSat;
const Limits({
required this.minSat,
required this.maxSat,
required this.maxZeroConfSat,
});
@override
int get hashCode => minSat.hashCode ^ maxSat.hashCode ^ maxZeroConfSat.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is Limits &&
runtimeType == other.runtimeType &&
minSat == other.minSat &&
maxSat == other.maxSat &&
maxZeroConfSat == other.maxZeroConfSat;
}
/// Network chosen for this Liquid SDK instance. Note that it represents both the Liquid and the
/// Bitcoin network used.
enum LiquidNetwork {
/// Mainnet Bitcoin and Liquid chains
mainnet,
/// Testnet Bitcoin and Liquid chains
testnet,
;
}
@freezed
sealed class ListPaymentDetails with _$ListPaymentDetails {
const ListPaymentDetails._();
/// The Liquid BIP21 URI or address of the payment
const factory ListPaymentDetails.liquid({
required String destination,
}) = ListPaymentDetails_Liquid;
/// The Bitcoin address of the payment
const factory ListPaymentDetails.bitcoin({
required String address,
}) = ListPaymentDetails_Bitcoin;
}
/// An argument when calling [crate::sdk::LiquidSdk::list_payments].
class ListPaymentsRequest {
final List<PaymentType>? filters;
/// Epoch time, in seconds
final PlatformInt64? fromTimestamp;
/// Epoch time, in seconds
final PlatformInt64? toTimestamp;
final int? offset;
final int? limit;
final ListPaymentDetails? details;
const ListPaymentsRequest({
this.filters,
this.fromTimestamp,
this.toTimestamp,
this.offset,
this.limit,
this.details,
});
@override
int get hashCode =>
filters.hashCode ^
fromTimestamp.hashCode ^
toTimestamp.hashCode ^
offset.hashCode ^
limit.hashCode ^
details.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is ListPaymentsRequest &&
runtimeType == other.runtimeType &&
filters == other.filters &&
fromTimestamp == other.fromTimestamp &&
toTimestamp == other.toTimestamp &&
offset == other.offset &&
limit == other.limit &&
details == other.details;
}
@freezed
sealed class LnUrlPayResult with _$LnUrlPayResult {
const LnUrlPayResult._();
const factory LnUrlPayResult.endpointSuccess({
required LnUrlPaySuccessData data,
}) = LnUrlPayResult_EndpointSuccess;
const factory LnUrlPayResult.endpointError({
required LnUrlErrorData data,
}) = LnUrlPayResult_EndpointError;
const factory LnUrlPayResult.payError({
required LnUrlPayErrorData data,
}) = LnUrlPayResult_PayError;
}
class LnUrlPaySuccessData {
final Payment payment;
final SuccessActionProcessed? successAction;
const LnUrlPaySuccessData({
required this.payment,
this.successAction,
});
@override
int get hashCode => payment.hashCode ^ successAction.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is LnUrlPaySuccessData &&
runtimeType == other.runtimeType &&
payment == other.payment &&
successAction == other.successAction;
}
/// Internal SDK log entry used in the Uniffi and Dart bindings
class LogEntry {
final String line;
final String level;
const LogEntry({
required this.line,
required this.level,
});
@override
int get hashCode => line.hashCode ^ level.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is LogEntry && runtimeType == other.runtimeType && line == other.line && level == other.level;
}
/// Returned when calling [crate::sdk::LiquidSdk::fetch_onchain_limits].
class OnchainPaymentLimitsResponse {
/// Amount limits for a Send Onchain Payment to be valid
final Limits send;
/// Amount limits for a Receive Onchain Payment to be valid
final Limits receive;
const OnchainPaymentLimitsResponse({
required this.send,
required this.receive,
});
@override
int get hashCode => send.hashCode ^ receive.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is OnchainPaymentLimitsResponse &&
runtimeType == other.runtimeType &&
send == other.send &&
receive == other.receive;
}
@freezed
sealed class PayOnchainAmount with _$PayOnchainAmount {
const PayOnchainAmount._();
/// The amount in satoshi that will be received
const factory PayOnchainAmount.receiver({
required BigInt amountSat,
}) = PayOnchainAmount_Receiver;
/// Indicates that all available funds should be sent
const factory PayOnchainAmount.drain() = PayOnchainAmount_Drain;
}
/// An argument when calling [crate::sdk::LiquidSdk::pay_onchain].
class PayOnchainRequest {
final String address;
final PreparePayOnchainResponse prepareResponse;
const PayOnchainRequest({
required this.address,
required this.prepareResponse,
});
@override
int get hashCode => address.hashCode ^ prepareResponse.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is PayOnchainRequest &&
runtimeType == other.runtimeType &&
address == other.address &&
prepareResponse == other.prepareResponse;
}
/// Represents an SDK payment.
///
/// By default, this is an onchain tx. It may represent a swap, if swap metadata is available.
class Payment {
/// The destination associated with the payment, if it was created via our SDK.
/// Can be either a Liquid/Bitcoin address, a Liquid BIP21 URI or an invoice
final String? destination;
final String? txId;
/// Composite timestamp that can be used for sorting or displaying the payment.
///
/// If this payment has an associated swap, it is the swap creation time. Otherwise, the point
/// in time when the underlying tx was included in a block. If there is no associated swap
/// available and the underlying tx is not yet confirmed, the value is `now()`.
final int timestamp;
/// The payment amount, which corresponds to the onchain tx amount.
///
/// In case of an outbound payment (Send), this is the payer amount. Otherwise it's the receiver amount.
final BigInt amountSat;
/// Represents the fees paid by this wallet for this payment.
///
/// ### Swaps
/// If there is an associated Send Swap, these fees represent the total fees paid by this wallet
/// (the sender). It is the difference between the amount that was sent and the amount received.
///
/// If there is an associated Receive Swap, these fees represent the total fees paid by this wallet
/// (the receiver). It is also the difference between the amount that was sent and the amount received.
///
/// ### Pure onchain txs
/// If no swap is associated with this payment:
/// - for Send payments, this is the onchain tx fee
/// - for Receive payments, this is zero
final BigInt feesSat;
/// If it is a `Send` or `Receive` payment
final PaymentType paymentType;
/// Composite status representing the overall status of the payment.
///
/// If the tx has no associated swap, this reflects the onchain tx status (confirmed or not).
///
/// If the tx has an associated swap, this is determined by the swap status (pending or complete).
final PaymentState status;
/// The details of a payment, depending on its [destination](Payment::destination) and
/// [type](Payment::payment_type)
final PaymentDetails details;
const Payment({
this.destination,
this.txId,
required this.timestamp,
required this.amountSat,
required this.feesSat,
required this.paymentType,
required this.status,
required this.details,
});
@override
int get hashCode =>
destination.hashCode ^
txId.hashCode ^
timestamp.hashCode ^
amountSat.hashCode ^
feesSat.hashCode ^
paymentType.hashCode ^
status.hashCode ^
details.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is Payment &&
runtimeType == other.runtimeType &&
destination == other.destination &&
txId == other.txId &&
timestamp == other.timestamp &&
amountSat == other.amountSat &&
feesSat == other.feesSat &&
paymentType == other.paymentType &&
status == other.status &&
details == other.details;
}
@freezed
sealed class PaymentDetails with _$PaymentDetails {
const PaymentDetails._();
/// Swapping to or from Lightning
const factory PaymentDetails.lightning({
required String swapId,
/// Represents the invoice description
required String description,
/// In case of a Send swap, this is the preimage of the paid invoice (proof of payment).
String? preimage,
/// Represents the invoice associated with a payment
/// In the case of a Send payment, this is the invoice paid by the swapper
/// In the case of a Receive payment, this is the invoice paid by the user
String? bolt11,
/// The payment hash of the invoice
String? paymentHash,
/// For a Send swap which was refunded, this is the refund tx id
String? refundTxId,
/// For a Send swap which was refunded, this is the refund amount
BigInt? refundTxAmountSat,
}) = PaymentDetails_Lightning;
/// Direct onchain payment to a Liquid address
const factory PaymentDetails.liquid({
/// Represents either a Liquid BIP21 URI or pure address
required String destination,
/// Represents the BIP21 `message` field
required String description,
}) = PaymentDetails_Liquid;
/// Swapping to or from the Bitcoin chain
const factory PaymentDetails.bitcoin({
required String swapId,
/// Represents the invoice description
required String description,
/// For a Send swap which was refunded, this is the refund tx id
String? refundTxId,
/// For a Send swap which was refunded, this is the refund amount
BigInt? refundTxAmountSat,
}) = PaymentDetails_Bitcoin;
}
/// The send/receive methods supported by the SDK
enum PaymentMethod {
lightning,
bitcoinAddress,
liquidAddress,
;
}
/// The payment state of an individual payment.
enum PaymentState {
created,
/// ## Receive Swaps
///
/// Covers the cases when
/// - the lockup tx is seen in the mempool or
/// - our claim tx is broadcast
///
/// When the claim tx is broadcast, `claim_tx_id` is set in the swap.
///
/// ## Send Swaps
///
/// This is the status when our lockup tx was broadcast
///
/// ## Chain Swaps
///
/// This is the status when the user lockup tx was broadcast
///
/// ## No swap data available
///
/// If no associated swap is found, this indicates the underlying tx is not confirmed yet.
pending,
/// ## Receive Swaps
///
/// Covers the case when the claim tx is confirmed.
///
/// ## Send and Chain Swaps
///
/// This is the status when the claim tx is broadcast and we see it in the mempool.
///
/// ## No swap data available
///
/// If no associated swap is found, this indicates the underlying tx is confirmed.
complete,
/// ## Receive Swaps
///
/// This is the status when the swap failed for any reason and the Receive could not complete.
///
/// ## Send and Chain Swaps
///
/// This is the status when a swap refund was initiated and the refund tx is confirmed.
failed,
/// ## Send and Outgoing Chain Swaps
///
/// This covers the case when the swap state is still Created and the swap fails to reach the
/// Pending state in time. The TimedOut state indicates the lockup tx should never be broadcast.
timedOut,
/// ## Incoming Chain Swaps
///
/// This covers the case when the swap failed for any reason and there is a user lockup tx.
/// The swap in this case has to be manually refunded with a provided Bitcoin address
refundable,
/// ## Send and Chain Swaps
///
/// This is the status when a refund was initiated and/or our refund tx was broadcast
///
/// When the refund tx is broadcast, `refund_tx_id` is set in the swap.
refundPending,
;
}
enum PaymentType {
receive,
send,
;
}
/// An argument when calling [crate::sdk::LiquidSdk::prepare_buy_bitcoin].
class PrepareBuyBitcoinRequest {
final BuyBitcoinProvider provider;
final BigInt amountSat;
const PrepareBuyBitcoinRequest({
required this.provider,
required this.amountSat,
});
@override
int get hashCode => provider.hashCode ^ amountSat.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is PrepareBuyBitcoinRequest &&
runtimeType == other.runtimeType &&
provider == other.provider &&
amountSat == other.amountSat;
}
/// Returned when calling [crate::sdk::LiquidSdk::prepare_buy_bitcoin].
class PrepareBuyBitcoinResponse {
final BuyBitcoinProvider provider;
final BigInt amountSat;
final BigInt feesSat;
const PrepareBuyBitcoinResponse({
required this.provider,
required this.amountSat,
required this.feesSat,
});
@override
int get hashCode => provider.hashCode ^ amountSat.hashCode ^ feesSat.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is PrepareBuyBitcoinResponse &&
runtimeType == other.runtimeType &&
provider == other.provider &&
amountSat == other.amountSat &&
feesSat == other.feesSat;
}
/// An argument when calling [crate::sdk::LiquidSdk::prepare_pay_onchain].
class PreparePayOnchainRequest {
final PayOnchainAmount amount;
/// The optional fee rate of the Bitcoin claim transaction in sat/vB. Defaults to the swapper estimated claim fee.
final int? feeRateSatPerVbyte;
const PreparePayOnchainRequest({
required this.amount,
this.feeRateSatPerVbyte,
});
@override
int get hashCode => amount.hashCode ^ feeRateSatPerVbyte.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is PreparePayOnchainRequest &&
runtimeType == other.runtimeType &&
amount == other.amount &&
feeRateSatPerVbyte == other.feeRateSatPerVbyte;
}
/// Returned when calling [crate::sdk::LiquidSdk::prepare_pay_onchain].
class PreparePayOnchainResponse {
final BigInt receiverAmountSat;
final BigInt claimFeesSat;
final BigInt totalFeesSat;
const PreparePayOnchainResponse({
required this.receiverAmountSat,
required this.claimFeesSat,
required this.totalFeesSat,
});
@override
int get hashCode => receiverAmountSat.hashCode ^ claimFeesSat.hashCode ^ totalFeesSat.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is PreparePayOnchainResponse &&
runtimeType == other.runtimeType &&
receiverAmountSat == other.receiverAmountSat &&
claimFeesSat == other.claimFeesSat &&
totalFeesSat == other.totalFeesSat;
}
/// An argument when calling [crate::sdk::LiquidSdk::prepare_receive_payment].
class PrepareReceiveRequest {
final BigInt? payerAmountSat;
final PaymentMethod paymentMethod;
const PrepareReceiveRequest({
this.payerAmountSat,
required this.paymentMethod,
});
@override
int get hashCode => payerAmountSat.hashCode ^ paymentMethod.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is PrepareReceiveRequest &&
runtimeType == other.runtimeType &&
payerAmountSat == other.payerAmountSat &&
paymentMethod == other.paymentMethod;
}
/// Returned when calling [crate::sdk::LiquidSdk::prepare_receive_payment].
class PrepareReceiveResponse {
final PaymentMethod paymentMethod;
final BigInt? payerAmountSat;
final BigInt feesSat;
const PrepareReceiveResponse({
required this.paymentMethod,
this.payerAmountSat,
required this.feesSat,
});
@override
int get hashCode => paymentMethod.hashCode ^ payerAmountSat.hashCode ^ feesSat.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is PrepareReceiveResponse &&
runtimeType == other.runtimeType &&
paymentMethod == other.paymentMethod &&
payerAmountSat == other.payerAmountSat &&
feesSat == other.feesSat;
}
/// An argument when calling [crate::sdk::LiquidSdk::prepare_refund].
class PrepareRefundRequest {
/// The address where the swap funds are locked up
final String swapAddress;
/// The address to refund the swap funds to
final String refundAddress;
/// The fee rate in sat/vB for the refund transaction
final int feeRateSatPerVbyte;
const PrepareRefundRequest({
required this.swapAddress,
required this.refundAddress,
required this.feeRateSatPerVbyte,
});
@override
int get hashCode => swapAddress.hashCode ^ refundAddress.hashCode ^ feeRateSatPerVbyte.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is PrepareRefundRequest &&
runtimeType == other.runtimeType &&
swapAddress == other.swapAddress &&
refundAddress == other.refundAddress &&
feeRateSatPerVbyte == other.feeRateSatPerVbyte;
}
/// Returned when calling [crate::sdk::LiquidSdk::prepare_refund].
class PrepareRefundResponse {
final int txVsize;
final BigInt txFeeSat;
final String? refundTxId;
const PrepareRefundResponse({
required this.txVsize,
required this.txFeeSat,
this.refundTxId,
});
@override
int get hashCode => txVsize.hashCode ^ txFeeSat.hashCode ^ refundTxId.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is PrepareRefundResponse &&
runtimeType == other.runtimeType &&
txVsize == other.txVsize &&
txFeeSat == other.txFeeSat &&
refundTxId == other.refundTxId;
}
/// An argument when calling [crate::sdk::LiquidSdk::prepare_send_payment].
class PrepareSendRequest {
/// The destination we intend to pay to.
/// Supports BIP21 URIs, BOLT11 invoices and Liquid addresses
final String destination;
/// Should only be set when paying directly onchain or to a BIP21 URI
/// where no amount is specified
final BigInt? amountSat;
const PrepareSendRequest({
required this.destination,
this.amountSat,
});
@override
int get hashCode => destination.hashCode ^ amountSat.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is PrepareSendRequest &&
runtimeType == other.runtimeType &&
destination == other.destination &&
amountSat == other.amountSat;
}
/// Returned when calling [crate::sdk::LiquidSdk::prepare_send_payment].
class PrepareSendResponse {
final SendDestination destination;
final BigInt feesSat;
const PrepareSendResponse({
required this.destination,
required this.feesSat,
});
@override
int get hashCode => destination.hashCode ^ feesSat.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is PrepareSendResponse &&
runtimeType == other.runtimeType &&
destination == other.destination &&
feesSat == other.feesSat;
}
/// An argument when calling [crate::sdk::LiquidSdk::receive_payment].
class ReceivePaymentRequest {
final PrepareReceiveResponse prepareResponse;
/// The description for this payment request.
final String? description;
/// If set to true, then the hash of the description will be used.
final bool? useDescriptionHash;
const ReceivePaymentRequest({
required this.prepareResponse,
this.description,
this.useDescriptionHash,
});
@override
int get hashCode => prepareResponse.hashCode ^ description.hashCode ^ useDescriptionHash.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is ReceivePaymentRequest &&
runtimeType == other.runtimeType &&
prepareResponse == other.prepareResponse &&
description == other.description &&
useDescriptionHash == other.useDescriptionHash;
}
/// Returned when calling [crate::sdk::LiquidSdk::receive_payment].
class ReceivePaymentResponse {
/// Either a BIP21 URI (Liquid or Bitcoin), a Liquid address
/// or an invoice, depending on the [PrepareReceivePaymentResponse] parameters
final String destination;
const ReceivePaymentResponse({
required this.destination,
});
@override
int get hashCode => destination.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is ReceivePaymentResponse && runtimeType == other.runtimeType && destination == other.destination;
}
/// Returned when calling [crate::sdk::LiquidSdk::recommended_fees].
class RecommendedFees {
final BigInt fastestFee;
final BigInt halfHourFee;
final BigInt hourFee;
final BigInt economyFee;
final BigInt minimumFee;
const RecommendedFees({
required this.fastestFee,
required this.halfHourFee,
required this.hourFee,
required this.economyFee,
required this.minimumFee,
});
@override
int get hashCode =>
fastestFee.hashCode ^
halfHourFee.hashCode ^
hourFee.hashCode ^
economyFee.hashCode ^
minimumFee.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is RecommendedFees &&
runtimeType == other.runtimeType &&
fastestFee == other.fastestFee &&
halfHourFee == other.halfHourFee &&
hourFee == other.hourFee &&
economyFee == other.economyFee &&
minimumFee == other.minimumFee;
}
/// An argument when calling [crate::sdk::LiquidSdk::refund].
class RefundRequest {
/// The address where the swap funds are locked up
final String swapAddress;
/// The address to refund the swap funds to
final String refundAddress;
/// The fee rate in sat/vB for the refund transaction
final int feeRateSatPerVbyte;
const RefundRequest({
required this.swapAddress,
required this.refundAddress,
required this.feeRateSatPerVbyte,
});
@override
int get hashCode => swapAddress.hashCode ^ refundAddress.hashCode ^ feeRateSatPerVbyte.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is RefundRequest &&
runtimeType == other.runtimeType &&
swapAddress == other.swapAddress &&
refundAddress == other.refundAddress &&
feeRateSatPerVbyte == other.feeRateSatPerVbyte;
}
/// Returned when calling [crate::sdk::LiquidSdk::refund].
class RefundResponse {
final String refundTxId;
const RefundResponse({
required this.refundTxId,
});
@override
int get hashCode => refundTxId.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is RefundResponse && runtimeType == other.runtimeType && refundTxId == other.refundTxId;
}
/// Returned when calling [crate::sdk::LiquidSdk::list_refundables].
class RefundableSwap {
final String swapAddress;
final int timestamp;
/// Amount that is refundable, from all UTXOs
final BigInt amountSat;
const RefundableSwap({
required this.swapAddress,
required this.timestamp,
required this.amountSat,
});
@override
int get hashCode => swapAddress.hashCode ^ timestamp.hashCode ^ amountSat.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is RefundableSwap &&
runtimeType == other.runtimeType &&
swapAddress == other.swapAddress &&
timestamp == other.timestamp &&
amountSat == other.amountSat;
}
/// An argument when calling [crate::sdk::LiquidSdk::restore].
class RestoreRequest {
final String? backupPath;
const RestoreRequest({
this.backupPath,
});
@override
int get hashCode => backupPath.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is RestoreRequest && runtimeType == other.runtimeType && backupPath == other.backupPath;
}
@freezed
sealed class SdkEvent with _$SdkEvent {
const SdkEvent._();
const factory SdkEvent.paymentFailed({
required Payment details,
}) = SdkEvent_PaymentFailed;
const factory SdkEvent.paymentPending({
required Payment details,
}) = SdkEvent_PaymentPending;
const factory SdkEvent.paymentRefunded({
required Payment details,
}) = SdkEvent_PaymentRefunded;
const factory SdkEvent.paymentRefundPending({
required Payment details,
}) = SdkEvent_PaymentRefundPending;
const factory SdkEvent.paymentSucceeded({
required Payment details,
}) = SdkEvent_PaymentSucceeded;
const factory SdkEvent.paymentWaitingConfirmation({
required Payment details,
}) = SdkEvent_PaymentWaitingConfirmation;
const factory SdkEvent.synced() = SdkEvent_Synced;
}
@freezed
sealed class SendDestination with _$SendDestination {
const SendDestination._();
const factory SendDestination.liquidAddress({
required LiquidAddressData addressData,
}) = SendDestination_LiquidAddress;
const factory SendDestination.bolt11({
required LNInvoice invoice,
}) = SendDestination_Bolt11;
}
/// An argument when calling [crate::sdk::LiquidSdk::send_payment].
class SendPaymentRequest {
final PrepareSendResponse prepareResponse;
const SendPaymentRequest({
required this.prepareResponse,
});
@override
int get hashCode => prepareResponse.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is SendPaymentRequest &&
runtimeType == other.runtimeType &&
prepareResponse == other.prepareResponse;
}
/// Returned when calling [crate::sdk::LiquidSdk::send_payment].
class SendPaymentResponse {
final Payment payment;
const SendPaymentResponse({
required this.payment,
});
@override
int get hashCode => payment.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is SendPaymentResponse && runtimeType == other.runtimeType && payment == other.payment;
}
/// An argument when calling [crate::sdk::LiquidSdk::sign_message].
class SignMessageRequest {
final String message;
const SignMessageRequest({
required this.message,
});
@override
int get hashCode => message.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is SignMessageRequest && runtimeType == other.runtimeType && message == other.message;
}
/// Returned when calling [crate::sdk::LiquidSdk::sign_message].
class SignMessageResponse {
final String signature;
const SignMessageResponse({
required this.signature,
});
@override
int get hashCode => signature.hashCode;
@override
bool operator ==(Object other) =>
identical(this, other) ||
other is SignMessageResponse && runtimeType == other.runtimeType && signature == other.signature;
}