/* This file is part of GNU Taler (C) 2021 Taler Systems S.A. GNU Taler is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3, or (at your option) any later version. GNU Taler is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with GNU Taler; see the file COPYING. If not, see */ /** * Selection of coins for payments. * * @author Florian Dold */ /** * Imports. */ import { GlobalIDB } from "@gnu-taler/idb-bridge"; import { AbsoluteTime, AgeCommitmentProof, AgeRestriction, AmountJson, Amounts, AmountString, CoinStatus, DenominationInfo, DenominationPubKey, DenomSelectionState, ForcedCoinSel, ForcedDenomSel, GetPlanForOperationRequest, GetPlanForOperationResponse, j2s, Logger, parsePaytoUri, PayCoinSelection, PayMerchantInsufficientBalanceDetails, strcmp, TransactionType, } from "@gnu-taler/taler-util"; import { AllowedAuditorInfo, AllowedExchangeInfo, DenominationRecord, } from "../db.js"; import { getExchangeDetails, isWithdrawableDenom } from "../index.js"; import { InternalWalletState } from "../internal-wallet-state.js"; import { getMerchantPaymentBalanceDetails } from "../operations/balance.js"; import { checkDbInvariant, checkLogicInvariant } from "./invariants.js"; const logger = new Logger("coinSelection.ts"); /** * Structure to describe a coin that is available to be * used in a payment. */ export interface AvailableCoinInfo { /** * Public key of the coin. */ coinPub: string; /** * Coin's denomination public key. * * FIXME: We should only need the denomPubHash here, if at all. */ denomPub: DenominationPubKey; /** * Full value of the coin. */ value: AmountJson; /** * Amount still remaining (typically the full amount, * as coins are always refreshed after use.) */ availableAmount: AmountJson; /** * Deposit fee for the coin. */ feeDeposit: AmountJson; exchangeBaseUrl: string; maxAge: number; ageCommitmentProof?: AgeCommitmentProof; } export type PreviousPayCoins = { coinPub: string; contribution: AmountJson; feeDeposit: AmountJson; exchangeBaseUrl: string; }[]; export interface CoinCandidateSelection { candidateCoins: AvailableCoinInfo[]; wireFeesPerExchange: Record; } export interface SelectPayCoinRequest { candidates: CoinCandidateSelection; contractTermsAmount: AmountJson; depositFeeLimit: AmountJson; wireFeeLimit: AmountJson; wireFeeAmortization: number; prevPayCoins?: PreviousPayCoins; requiredMinimumAge?: number; } export interface CoinSelectionTally { /** * Amount that still needs to be paid. * May increase during the computation when fees need to be covered. */ amountPayRemaining: AmountJson; /** * Allowance given by the merchant towards wire fees */ amountWireFeeLimitRemaining: AmountJson; /** * Allowance given by the merchant towards deposit fees * (and wire fees after wire fee limit is exhausted) */ amountDepositFeeLimitRemaining: AmountJson; customerDepositFees: AmountJson; customerWireFees: AmountJson; wireFeeCoveredForExchange: Set; lastDepositFee: AmountJson; } /** * Account for the fees of spending a coin. */ function tallyFees( tally: Readonly, wireFeesPerExchange: Record, wireFeeAmortization: number, exchangeBaseUrl: string, feeDeposit: AmountJson, ): CoinSelectionTally { const currency = tally.amountPayRemaining.currency; let amountWireFeeLimitRemaining = tally.amountWireFeeLimitRemaining; let amountDepositFeeLimitRemaining = tally.amountDepositFeeLimitRemaining; let customerDepositFees = tally.customerDepositFees; let customerWireFees = tally.customerWireFees; let amountPayRemaining = tally.amountPayRemaining; const wireFeeCoveredForExchange = new Set(tally.wireFeeCoveredForExchange); if (!tally.wireFeeCoveredForExchange.has(exchangeBaseUrl)) { const wf = wireFeesPerExchange[exchangeBaseUrl] ?? Amounts.zeroOfCurrency(currency); const wfForgiven = Amounts.min(amountWireFeeLimitRemaining, wf); amountWireFeeLimitRemaining = Amounts.sub( amountWireFeeLimitRemaining, wfForgiven, ).amount; // The remaining, amortized amount needs to be paid by the // wallet or covered by the deposit fee allowance. let wfRemaining = Amounts.divide( Amounts.sub(wf, wfForgiven).amount, wireFeeAmortization, ); // This is the amount forgiven via the deposit fee allowance. const wfDepositForgiven = Amounts.min( amountDepositFeeLimitRemaining, wfRemaining, ); amountDepositFeeLimitRemaining = Amounts.sub( amountDepositFeeLimitRemaining, wfDepositForgiven, ).amount; wfRemaining = Amounts.sub(wfRemaining, wfDepositForgiven).amount; customerWireFees = Amounts.add(customerWireFees, wfRemaining).amount; amountPayRemaining = Amounts.add(amountPayRemaining, wfRemaining).amount; wireFeeCoveredForExchange.add(exchangeBaseUrl); } const dfForgiven = Amounts.min(feeDeposit, amountDepositFeeLimitRemaining); amountDepositFeeLimitRemaining = Amounts.sub( amountDepositFeeLimitRemaining, dfForgiven, ).amount; // How much does the user spend on deposit fees for this coin? const dfRemaining = Amounts.sub(feeDeposit, dfForgiven).amount; customerDepositFees = Amounts.add(customerDepositFees, dfRemaining).amount; amountPayRemaining = Amounts.add(amountPayRemaining, dfRemaining).amount; return { amountDepositFeeLimitRemaining, amountPayRemaining, amountWireFeeLimitRemaining, customerDepositFees, customerWireFees, wireFeeCoveredForExchange, lastDepositFee: feeDeposit, }; } export type SelectPayCoinsResult = | { type: "failure"; insufficientBalanceDetails: PayMerchantInsufficientBalanceDetails; } | { type: "success"; coinSel: PayCoinSelection }; /** * Given a list of candidate coins, select coins to spend under the merchant's * constraints. * * The prevPayCoins can be specified to "repair" a coin selection * by adding additional coins, after a broken (e.g. double-spent) coin * has been removed from the selection. * * This function is only exported for the sake of unit tests. */ export async function selectPayCoinsNew( ws: InternalWalletState, req: SelectPayCoinRequestNg, ): Promise { const { contractTermsAmount, depositFeeLimit, wireFeeLimit, wireFeeAmortization, } = req; const [candidateDenoms, wireFeesPerExchange] = await selectCandidates( ws, req, ); const coinPubs: string[] = []; const coinContributions: AmountJson[] = []; const currency = contractTermsAmount.currency; let tally: CoinSelectionTally = { amountPayRemaining: contractTermsAmount, amountWireFeeLimitRemaining: wireFeeLimit, amountDepositFeeLimitRemaining: depositFeeLimit, customerDepositFees: Amounts.zeroOfCurrency(currency), customerWireFees: Amounts.zeroOfCurrency(currency), wireFeeCoveredForExchange: new Set(), lastDepositFee: Amounts.zeroOfCurrency(currency), }; const prevPayCoins = req.prevPayCoins ?? []; // Look at existing pay coin selection and tally up for (const prev of prevPayCoins) { tally = tallyFees( tally, wireFeesPerExchange, wireFeeAmortization, prev.exchangeBaseUrl, prev.feeDeposit, ); tally.amountPayRemaining = Amounts.sub( tally.amountPayRemaining, prev.contribution, ).amount; coinPubs.push(prev.coinPub); coinContributions.push(prev.contribution); } let selectedDenom: SelResult | undefined; if (req.forcedSelection) { selectedDenom = selectForced(req, candidateDenoms); } else { // FIXME: Here, we should select coins in a smarter way. // Instead of always spending the next-largest coin, // we should try to find the smallest coin that covers the // amount. selectedDenom = selectGreedy( req, candidateDenoms, wireFeesPerExchange, tally, ); } if (!selectedDenom) { const details = await getMerchantPaymentBalanceDetails(ws, { acceptedAuditors: req.auditors, acceptedExchanges: req.exchanges, acceptedWireMethods: [req.wireMethod], currency: Amounts.currencyOf(req.contractTermsAmount), minAge: req.requiredMinimumAge ?? 0, }); let feeGapEstimate: AmountJson; if ( Amounts.cmp( details.balanceMerchantDepositable, req.contractTermsAmount, ) >= 0 ) { // FIXME: We can probably give a better estimate. feeGapEstimate = Amounts.add( tally.amountPayRemaining, tally.lastDepositFee, ).amount; } else { feeGapEstimate = Amounts.zeroOfAmount(req.contractTermsAmount); } return { type: "failure", insufficientBalanceDetails: { amountRequested: Amounts.stringify(req.contractTermsAmount), balanceAgeAcceptable: Amounts.stringify(details.balanceAgeAcceptable), balanceAvailable: Amounts.stringify(details.balanceAvailable), balanceMaterial: Amounts.stringify(details.balanceMaterial), balanceMerchantAcceptable: Amounts.stringify( details.balanceMerchantAcceptable, ), balanceMerchantDepositable: Amounts.stringify( details.balanceMerchantDepositable, ), feeGapEstimate: Amounts.stringify(feeGapEstimate), }, }; } const finalSel = selectedDenom; logger.trace(`coin selection request ${j2s(req)}`); logger.trace(`selected coins (via denoms) for payment: ${j2s(finalSel)}`); await ws.db .mktx((x) => [x.coins, x.denominations]) .runReadOnly(async (tx) => { for (const dph of Object.keys(finalSel)) { const selInfo = finalSel[dph]; const numRequested = selInfo.contributions.length; const query = [ selInfo.exchangeBaseUrl, selInfo.denomPubHash, selInfo.maxAge, CoinStatus.Fresh, ]; logger.info(`query: ${j2s(query)}`); const coins = await tx.coins.indexes.byExchangeDenomPubHashAndAgeAndStatus.getAll( query, numRequested, ); if (coins.length != numRequested) { throw Error( `coin selection failed (not available anymore, got only ${coins.length}/${numRequested})`, ); } coinPubs.push(...coins.map((x) => x.coinPub)); coinContributions.push(...selInfo.contributions); } }); return { type: "success", coinSel: { paymentAmount: Amounts.stringify(contractTermsAmount), coinContributions: coinContributions.map((x) => Amounts.stringify(x)), coinPubs, customerDepositFees: Amounts.stringify(tally.customerDepositFees), customerWireFees: Amounts.stringify(tally.customerWireFees), }, }; } function makeAvailabilityKey( exchangeBaseUrl: string, denomPubHash: string, maxAge: number, ): string { return `${denomPubHash};${maxAge};${exchangeBaseUrl}`; } /** * Selection result. */ interface SelResult { /** * Map from an availability key * to an array of contributions. */ [avKey: string]: { exchangeBaseUrl: string; denomPubHash: string; maxAge: number; contributions: AmountJson[]; }; } function selectGreedy( req: SelectPayCoinRequestNg, candidateDenoms: AvailableDenom[], wireFeesPerExchange: Record, tally: CoinSelectionTally, ): SelResult | undefined { const { wireFeeAmortization } = req; const selectedDenom: SelResult = {}; for (const denom of candidateDenoms) { const contributions: AmountJson[] = []; // Don't use this coin if depositing it is more expensive than // the amount it would give the merchant. if (Amounts.cmp(denom.feeDeposit, denom.value) > 0) { tally.lastDepositFee = Amounts.parseOrThrow(denom.feeDeposit); continue; } for ( let i = 0; i < denom.numAvailable && Amounts.isNonZero(tally.amountPayRemaining); i++ ) { tally = tallyFees( tally, wireFeesPerExchange, wireFeeAmortization, denom.exchangeBaseUrl, Amounts.parseOrThrow(denom.feeDeposit), ); const coinSpend = Amounts.max( Amounts.min(tally.amountPayRemaining, denom.value), denom.feeDeposit, ); tally.amountPayRemaining = Amounts.sub( tally.amountPayRemaining, coinSpend, ).amount; contributions.push(coinSpend); } if (contributions.length) { const avKey = makeAvailabilityKey( denom.exchangeBaseUrl, denom.denomPubHash, denom.maxAge, ); let sd = selectedDenom[avKey]; if (!sd) { sd = { contributions: [], denomPubHash: denom.denomPubHash, exchangeBaseUrl: denom.exchangeBaseUrl, maxAge: denom.maxAge, }; } sd.contributions.push(...contributions); selectedDenom[avKey] = sd; } } return Amounts.isZero(tally.amountPayRemaining) ? selectedDenom : undefined; } function selectForced( req: SelectPayCoinRequestNg, candidateDenoms: AvailableDenom[], ): SelResult | undefined { const selectedDenom: SelResult = {}; const forcedSelection = req.forcedSelection; checkLogicInvariant(!!forcedSelection); for (const forcedCoin of forcedSelection.coins) { let found = false; for (const aci of candidateDenoms) { if (aci.numAvailable <= 0) { continue; } if (Amounts.cmp(aci.value, forcedCoin.value) === 0) { aci.numAvailable--; const avKey = makeAvailabilityKey( aci.exchangeBaseUrl, aci.denomPubHash, aci.maxAge, ); let sd = selectedDenom[avKey]; if (!sd) { sd = { contributions: [], denomPubHash: aci.denomPubHash, exchangeBaseUrl: aci.exchangeBaseUrl, maxAge: aci.maxAge, }; } sd.contributions.push(Amounts.parseOrThrow(forcedCoin.value)); selectedDenom[avKey] = sd; found = true; break; } } if (!found) { throw Error("can't find coin for forced coin selection"); } } return selectedDenom; } export interface SelectPayCoinRequestNg { exchanges: AllowedExchangeInfo[]; auditors: AllowedAuditorInfo[]; wireMethod: string; contractTermsAmount: AmountJson; depositFeeLimit: AmountJson; wireFeeLimit: AmountJson; wireFeeAmortization: number; prevPayCoins?: PreviousPayCoins; requiredMinimumAge?: number; forcedSelection?: ForcedCoinSel; } export type AvailableDenom = DenominationInfo & { maxAge: number; numAvailable: number; }; async function selectCandidates( ws: InternalWalletState, req: SelectPayCoinRequestNg, ): Promise<[AvailableDenom[], Record]> { return await ws.db .mktx((x) => [ x.exchanges, x.exchangeDetails, x.denominations, x.coinAvailability, ]) .runReadOnly(async (tx) => { // FIXME: Use the existing helper (from balance.ts) to // get acceptable exchanges. const denoms: AvailableDenom[] = []; const exchanges = await tx.exchanges.iter().toArray(); const wfPerExchange: Record = {}; for (const exchange of exchanges) { const exchangeDetails = await getExchangeDetails(tx, exchange.baseUrl); // 1.- exchange has same currency if (exchangeDetails?.currency !== req.contractTermsAmount.currency) { continue; } let wireMethodFee: string | undefined; // 2.- exchange supports wire method for (const acc of exchangeDetails.wireInfo.accounts) { const pp = parsePaytoUri(acc.payto_uri); checkLogicInvariant(!!pp); if (pp.targetType === req.wireMethod) { // also check that wire method is supported now const wireFeeStr = exchangeDetails.wireInfo.feesForType[ req.wireMethod ]?.find((x) => { return AbsoluteTime.isBetween( AbsoluteTime.now(), AbsoluteTime.fromProtocolTimestamp(x.startStamp), AbsoluteTime.fromProtocolTimestamp(x.endStamp), ); })?.wireFee; if (wireFeeStr) { wireMethodFee = wireFeeStr; } break; } } if (!wireMethodFee) { break; } wfPerExchange[exchange.baseUrl] = Amounts.parseOrThrow(wireMethodFee); // 3.- exchange is trusted in the exchange list or auditor list let accepted = false; for (const allowedExchange of req.exchanges) { if (allowedExchange.exchangePub === exchangeDetails.masterPublicKey) { accepted = true; break; } } for (const allowedAuditor of req.auditors) { for (const providedAuditor of exchangeDetails.auditors) { if (allowedAuditor.auditorPub === providedAuditor.auditor_pub) { accepted = true; break; } } } if (!accepted) { continue; } //4.- filter coins restricted by age let ageLower = 0; let ageUpper = AgeRestriction.AGE_UNRESTRICTED; if (req.requiredMinimumAge) { ageLower = req.requiredMinimumAge; } const myExchangeCoins = await tx.coinAvailability.indexes.byExchangeAgeAvailability.getAll( GlobalIDB.KeyRange.bound( [exchangeDetails.exchangeBaseUrl, ageLower, 1], [ exchangeDetails.exchangeBaseUrl, ageUpper, Number.MAX_SAFE_INTEGER, ], ), ); //5.- save denoms with how many coins are available // FIXME: Check that the individual denomination is audited! // FIXME: Should we exclude denominations that are // not spendable anymore? for (const coinAvail of myExchangeCoins) { const denom = await tx.denominations.get([ coinAvail.exchangeBaseUrl, coinAvail.denomPubHash, ]); checkDbInvariant(!!denom); if (denom.isRevoked || !denom.isOffered) { continue; } denoms.push({ ...DenominationRecord.toDenomInfo(denom), numAvailable: coinAvail.freshCoinCount ?? 0, maxAge: coinAvail.maxAge, }); } } // Sort by available amount (descending), deposit fee (ascending) and // denomPub (ascending) if deposit fee is the same // (to guarantee deterministic results) denoms.sort( (o1, o2) => -Amounts.cmp(o1.value, o2.value) || Amounts.cmp(o1.feeDeposit, o2.feeDeposit) || strcmp(o1.denomPubHash, o2.denomPubHash), ); return [denoms, wfPerExchange]; }); } /** * Get a list of denominations (with repetitions possible) * whose total value is as close as possible to the available * amount, but never larger. */ export function selectWithdrawalDenominations( amountAvailable: AmountJson, denoms: DenominationRecord[], denomselAllowLate: boolean = false, ): DenomSelectionState { let remaining = Amounts.copy(amountAvailable); const selectedDenoms: { count: number; denomPubHash: string; }[] = []; let totalCoinValue = Amounts.zeroOfCurrency(amountAvailable.currency); let totalWithdrawCost = Amounts.zeroOfCurrency(amountAvailable.currency); denoms = denoms.filter((d) => isWithdrawableDenom(d, denomselAllowLate)); denoms.sort((d1, d2) => Amounts.cmp( DenominationRecord.getValue(d2), DenominationRecord.getValue(d1), ), ); for (const d of denoms) { const cost = Amounts.add( DenominationRecord.getValue(d), d.fees.feeWithdraw, ).amount; const res = Amounts.divmod(remaining, cost); const count = res.quotient; remaining = Amounts.sub(remaining, Amounts.mult(cost, count).amount).amount; if (count > 0) { totalCoinValue = Amounts.add( totalCoinValue, Amounts.mult(DenominationRecord.getValue(d), count).amount, ).amount; totalWithdrawCost = Amounts.add( totalWithdrawCost, Amounts.mult(cost, count).amount, ).amount; selectedDenoms.push({ count, denomPubHash: d.denomPubHash, }); } if (Amounts.isZero(remaining)) { break; } } if (logger.shouldLogTrace()) { logger.trace( `selected withdrawal denoms for ${Amounts.stringify(totalCoinValue)}`, ); for (const sd of selectedDenoms) { logger.trace(`denom_pub_hash=${sd.denomPubHash}, count=${sd.count}`); } logger.trace("(end of withdrawal denom list)"); } return { selectedDenoms, totalCoinValue: Amounts.stringify(totalCoinValue), totalWithdrawCost: Amounts.stringify(totalWithdrawCost), }; } export function selectForcedWithdrawalDenominations( amountAvailable: AmountJson, denoms: DenominationRecord[], forcedDenomSel: ForcedDenomSel, denomselAllowLate: boolean, ): DenomSelectionState { const selectedDenoms: { count: number; denomPubHash: string; }[] = []; let totalCoinValue = Amounts.zeroOfCurrency(amountAvailable.currency); let totalWithdrawCost = Amounts.zeroOfCurrency(amountAvailable.currency); denoms = denoms.filter((d) => isWithdrawableDenom(d, denomselAllowLate)); denoms.sort((d1, d2) => Amounts.cmp( DenominationRecord.getValue(d2), DenominationRecord.getValue(d1), ), ); for (const fds of forcedDenomSel.denoms) { const count = fds.count; const denom = denoms.find((x) => { return Amounts.cmp(DenominationRecord.getValue(x), fds.value) == 0; }); if (!denom) { throw Error( `unable to find denom for forced selection (value ${fds.value})`, ); } const cost = Amounts.add( DenominationRecord.getValue(denom), denom.fees.feeWithdraw, ).amount; totalCoinValue = Amounts.add( totalCoinValue, Amounts.mult(DenominationRecord.getValue(denom), count).amount, ).amount; totalWithdrawCost = Amounts.add( totalWithdrawCost, Amounts.mult(cost, count).amount, ).amount; selectedDenoms.push({ count, denomPubHash: denom.denomPubHash, }); } return { selectedDenoms, totalCoinValue: Amounts.stringify(totalCoinValue), totalWithdrawCost: Amounts.stringify(totalWithdrawCost), }; } /** * simulate a coin selection and return the amount * that will effectively change the wallet balance and * the raw amount of the operation * * @param ws * @param br * @returns */ export async function getPlanForOperation( ws: InternalWalletState, req: GetPlanForOperationRequest, ): Promise { const amount = Amounts.parseOrThrow(req.instructedAmount); switch (req.type) { case TransactionType.Withdrawal: { const availableCoins = await getAvailableCoins( ws, "credit", amount.currency, false, false, undefined, undefined, undefined, ); const usableCoins = selectCoinForOperation( "credit", amount, req.mode === "effective" ? "net" : "gross", availableCoins.denoms, ); return getAmountsWithFee( "credit", usableCoins.totalValue, usableCoins.totalContribution, usableCoins, ); } case TransactionType.Deposit: { const payto = parsePaytoUri(req.account)!; const availableCoins = await getAvailableCoins( ws, "debit", amount.currency, true, false, undefined, [payto.targetType], undefined, ); //FIXME: just doing for 1 exchange now //assuming that the wallet has one exchange and all the coins available //are from that exchange const wireFee = Object.entries(availableCoins.wfPerExchange)[0][1][ payto.targetType ]; let usableCoins; if (req.mode === "effective") { usableCoins = selectCoinForOperation( "debit", amount, "gross", availableCoins.denoms, ); usableCoins.totalContribution = Amounts.stringify( Amounts.sub(usableCoins.totalContribution, wireFee).amount, ); } else { const adjustedAmount = Amounts.add(amount, wireFee).amount; usableCoins = selectCoinForOperation( "debit", adjustedAmount, // amount, "net", availableCoins.denoms, ); usableCoins.totalContribution = Amounts.stringify( Amounts.sub(usableCoins.totalContribution, wireFee).amount, ); } return getAmountsWithFee( "debit", usableCoins.totalValue, usableCoins.totalContribution, usableCoins, ); } default: { throw Error("operation not supported"); } } } function getAmountsWithFee( op: "debit" | "credit", value: AmountString, contribution: AmountString, details: any, ): GetPlanForOperationResponse { return { rawAmount: op === "credit" ? value : contribution, effectiveAmount: op === "credit" ? contribution : value, details, }; } /** * * @param op defined which fee are we taking into consideration: deposits or withdraw * @param limit the total amount limit of the operation * @param mode if the total amount is includes the fees or just the contribution * @param denoms list of available denomination for the operation * @returns */ function selectCoinForOperation( op: "debit" | "credit", limit: AmountJson, mode: "net" | "gross", denoms: AvailableDenom[], ): SelectedCoins { const result: SelectedCoins = { totalValue: Amounts.stringify(Amounts.zeroOfCurrency(limit.currency)), totalWithdrawalFee: Amounts.stringify( Amounts.zeroOfCurrency(limit.currency), ), totalDepositFee: Amounts.stringify(Amounts.zeroOfCurrency(limit.currency)), totalContribution: Amounts.stringify( Amounts.zeroOfCurrency(limit.currency), ), coins: [], }; if (!denoms.length) return result; /** * We can make this faster. We should prevent sorting and * keep the information ready for multiple calls since this * function is expected to work on embedded devices and * create a response on key press */ //rank coins denoms.sort( op === "credit" ? denomsByDescendingWithdrawContribution : denomsByDescendingDepositContribution, ); //take coins in order until amount let selectedCoinsAreEnough = false; let denomIdx = 0; iterateDenoms: while (denomIdx < denoms.length) { const cur = denoms[denomIdx]; // for (const cur of denoms) { let total = op === "credit" ? Number.MAX_SAFE_INTEGER : cur.numAvailable; const opFee = op === "credit" ? cur.feeWithdraw : cur.feeDeposit; const contribution = Amounts.sub(cur.value, opFee).amount; if (Amounts.isZero(contribution)) { // 0 contribution denoms should be the last break iterateDenoms; } iterateCoins: while (total > 0) { const nextValue = Amounts.add(result.totalValue, cur.value).amount; const nextContribution = Amounts.add( result.totalContribution, contribution, ).amount; const progress = mode === "gross" ? nextValue : nextContribution; if (Amounts.cmp(progress, limit) === 1) { //the current coin is more than we need, try next denom break iterateCoins; } result.totalValue = Amounts.stringify(nextValue); result.totalContribution = Amounts.stringify(nextContribution); result.totalDepositFee = Amounts.stringify( Amounts.add(result.totalDepositFee, cur.feeDeposit).amount, ); result.totalWithdrawalFee = Amounts.stringify( Amounts.add(result.totalWithdrawalFee, cur.feeWithdraw).amount, ); result.coins.push(cur.denomPubHash); if (Amounts.cmp(progress, limit) === 0) { selectedCoinsAreEnough = true; // we have just enough coins, complete break iterateDenoms; } //go next coin total--; } //go next denom denomIdx++; } if (selectedCoinsAreEnough) { // we made it return result; } if (op === "credit") { //doing withdraw there is no way to cover the gap return result; } //tried all the coins but there is a gap //doing deposit we can try refreshing coins const total = mode === "gross" ? result.totalValue : result.totalContribution; const gap = Amounts.sub(limit, total).amount; //about recursive calls //the only way to get here is by doing a deposit (that will do a refresh) //and now we are calculating fee for credit (which does not need to calculate refresh) let refreshIdx = 0; let choice: RefreshChoice | undefined = undefined; refreshIteration: while (refreshIdx < denoms.length) { const d = denoms[refreshIdx]; const denomContribution = mode === "gross" ? Amounts.sub(d.value, d.feeRefresh).amount : Amounts.sub(d.value, d.feeDeposit, d.feeRefresh).amount; const changeAfterDeposit = Amounts.sub(denomContribution, gap).amount; if (Amounts.isZero(changeAfterDeposit)) { //the rest of the coins are very small break refreshIteration; } const changeCost = selectCoinForOperation( "credit", changeAfterDeposit, mode, denoms, ); const totalFee = Amounts.add( d.feeDeposit, d.feeRefresh, changeCost.totalWithdrawalFee, ).amount; if (!choice || Amounts.cmp(totalFee, choice.totalFee) === -1) { //found cheaper change choice = { gap: Amounts.stringify(gap), totalFee: Amounts.stringify(totalFee), selected: d.denomPubHash, totalValue: d.value, totalRefreshFee: Amounts.stringify(d.feeRefresh), totalDepositFee: d.feeDeposit, totalChangeValue: Amounts.stringify(changeCost.totalValue), totalChangeContribution: Amounts.stringify( changeCost.totalContribution, ), totalChangeWithdrawalFee: Amounts.stringify( changeCost.totalWithdrawalFee, ), change: changeCost.coins, }; } refreshIdx++; } if (choice) { if (mode === "gross") { result.totalValue = Amounts.stringify( Amounts.add(result.totalValue, gap).amount, ); result.totalContribution = Amounts.stringify( Amounts.add(result.totalContribution, gap).amount, ); result.totalContribution = Amounts.stringify( Amounts.sub(result.totalContribution, choice.totalFee).amount, ); } else { result.totalContribution = Amounts.stringify( Amounts.add(result.totalContribution, gap).amount, ); result.totalValue = Amounts.stringify( Amounts.add(result.totalValue, gap, choice.totalFee).amount, ); } } // console.log("gap", Amounts.stringify(limit), Amounts.stringify(gap), choice); result.refresh = choice; return result; } function denomsByDescendingDepositContribution( d1: AvailableDenom, d2: AvailableDenom, ) { const contrib1 = Amounts.sub(d1.value, d1.feeDeposit).amount; const contrib2 = Amounts.sub(d2.value, d2.feeDeposit).amount; return ( Amounts.cmp(contrib2, contrib1) || strcmp(d1.denomPubHash, d2.denomPubHash) ); } function denomsByDescendingWithdrawContribution( d1: AvailableDenom, d2: AvailableDenom, ) { const contrib1 = Amounts.sub(d1.value, d1.feeWithdraw).amount; const contrib2 = Amounts.sub(d2.value, d2.feeWithdraw).amount; return ( Amounts.cmp(contrib2, contrib1) || strcmp(d1.denomPubHash, d2.denomPubHash) ); } interface RefreshChoice { gap: AmountString; totalFee: AmountString; selected: string; totalValue: AmountString; totalDepositFee: AmountString; totalRefreshFee: AmountString; totalChangeValue: AmountString; totalChangeContribution: AmountString; totalChangeWithdrawalFee: AmountString; change: string[]; } interface SelectedCoins { totalValue: AmountString; totalContribution: AmountString; totalWithdrawalFee: AmountString; totalDepositFee: AmountString; coins: string[]; refresh?: RefreshChoice; } /** * Get all the denoms that can be used for a operation that is limited * by the following restrictions. * This function is costly (by the database access) but with high chances * of being cached */ async function getAvailableCoins( ws: InternalWalletState, op: "credit" | "debit", currency: string, shouldCalculateWireFee: boolean, shouldCalculatePurseFee: boolean, exchangeFilter: string[] | undefined, wireMethodFilter: string[] | undefined, ageRestrictedFilter: number | undefined, ) { return await ws.db .mktx((x) => [ x.exchanges, x.exchangeDetails, x.denominations, x.coinAvailability, ]) .runReadOnly(async (tx) => { const denoms: AvailableDenom[] = []; const wfPerExchange: Record> = {}; const pfPerExchange: Record = {}; const databaseExchanges = await tx.exchanges.iter().toArray(); const exchanges = exchangeFilter === undefined ? databaseExchanges.map((e) => e.baseUrl) : exchangeFilter; for (const exchangeBaseUrl of exchanges) { const exchangeDetails = await getExchangeDetails(tx, exchangeBaseUrl); // 1.- exchange has same currency if (exchangeDetails?.currency !== currency) { continue; } const wireMethodFee: Record = {}; // 2.- exchange supports wire method if (shouldCalculateWireFee) { for (const acc of exchangeDetails.wireInfo.accounts) { const pp = parsePaytoUri(acc.payto_uri); checkLogicInvariant(!!pp); // also check that wire method is supported now if (wireMethodFilter !== undefined) { if (wireMethodFilter.indexOf(pp.targetType) === -1) { continue; } } const wireFeeStr = exchangeDetails.wireInfo.feesForType[ pp.targetType ]?.find((x) => { return AbsoluteTime.isBetween( AbsoluteTime.now(), AbsoluteTime.fromProtocolTimestamp(x.startStamp), AbsoluteTime.fromProtocolTimestamp(x.endStamp), ); })?.wireFee; if (wireFeeStr) { wireMethodFee[pp.targetType] = Amounts.parseOrThrow(wireFeeStr); } break; } if (Object.keys(wireMethodFee).length === 0) { throw Error( `exchange ${exchangeBaseUrl} doesn't have wire fee defined for this period`, ); } } wfPerExchange[exchangeBaseUrl] = wireMethodFee; // 3.- exchange supports wire method if (shouldCalculatePurseFee) { const purseFeeFound = exchangeDetails.globalFees.find((x) => { return AbsoluteTime.isBetween( AbsoluteTime.now(), AbsoluteTime.fromProtocolTimestamp(x.startDate), AbsoluteTime.fromProtocolTimestamp(x.endDate), ); })?.purseFee; if (!purseFeeFound) { throw Error( `exchange ${exchangeBaseUrl} doesn't have purse fee defined for this period`, ); } const purseFee = Amounts.parseOrThrow(purseFeeFound); pfPerExchange[exchangeBaseUrl] = purseFee; } //4.- filter coins restricted by age if (op === "credit") { const ds = await tx.denominations.indexes.byExchangeBaseUrl.getAll( exchangeBaseUrl, ); for (const denom of ds) { denoms.push({ ...DenominationRecord.toDenomInfo(denom), numAvailable: Number.MAX_SAFE_INTEGER, maxAge: AgeRestriction.AGE_UNRESTRICTED, }); } } else { const ageLower = !ageRestrictedFilter ? 0 : ageRestrictedFilter; const ageUpper = AgeRestriction.AGE_UNRESTRICTED; const myExchangeCoins = await tx.coinAvailability.indexes.byExchangeAgeAvailability.getAll( GlobalIDB.KeyRange.bound( [exchangeDetails.exchangeBaseUrl, ageLower, 1], [ exchangeDetails.exchangeBaseUrl, ageUpper, Number.MAX_SAFE_INTEGER, ], ), ); //5.- save denoms with how many coins are available // FIXME: Check that the individual denomination is audited! // FIXME: Should we exclude denominations that are // not spendable anymore? for (const coinAvail of myExchangeCoins) { const denom = await tx.denominations.get([ coinAvail.exchangeBaseUrl, coinAvail.denomPubHash, ]); checkDbInvariant(!!denom); if (denom.isRevoked || !denom.isOffered) { continue; } denoms.push({ ...DenominationRecord.toDenomInfo(denom), numAvailable: coinAvail.freshCoinCount ?? 0, maxAge: coinAvail.maxAge, }); } } } return { denoms, wfPerExchange, pfPerExchange, }; }); }