/*
This file is part of TALER
(C) 2016 GNUnet e.V.
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.
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
TALER; see the file COPYING. If not, see
*/
/**
* Interface to the wallet through WebExtension messaging.
*/
/**
* Imports.
*/
import { AmountJson } from "../util/amounts";
import {
CoinRecord,
CurrencyRecord,
DenominationRecord,
ExchangeRecord,
ReserveRecord,
} from "../types/dbTypes";
import {
BenchmarkResult,
ConfirmPayResult,
ExchangeWithdrawDetails,
SenderWireInfos,
TipStatus,
WalletBalance,
PurchaseDetails,
WalletDiagnostics,
WithdrawDetails,
PreparePayResult,
AcceptWithdrawalResponse,
} from "../types/walletTypes";
import { MessageMap, MessageType } from "./messages";
/**
* Response with information about available version upgrades.
*/
export interface UpgradeResponse {
/**
* Is a reset required because of a new DB version
* that can't be atomatically upgraded?
*/
dbResetRequired: boolean;
/**
* Current database version.
*/
currentDbVersion: string;
/**
* Old db version (if applicable).
*/
oldDbVersion: string;
}
/**
* Error thrown when the function from the backend (via RPC) threw an error.
*/
export class WalletApiError extends Error {
constructor(message: string, public detail: any) {
super(message);
// restore prototype chain
Object.setPrototypeOf(this, new.target.prototype);
}
}
async function callBackend(
type: T,
detail: MessageMap[T]["request"],
): Promise {
return new Promise((resolve, reject) => {
chrome.runtime.sendMessage({ type, detail }, (resp) => {
if (chrome.runtime.lastError) {
console.log("Error calling backend");
reject(
new Error(
`Error contacting backend: chrome.runtime.lastError.message`,
),
);
}
if (typeof resp === "object" && resp && resp.error) {
console.warn("response error:", resp);
const e = new WalletApiError(resp.error.message, resp.error);
reject(e);
} else {
resolve(resp);
}
});
});
}
/**
* Query the wallet for the coins that would be used to withdraw
* from a given reserve.
*/
export function getReserveCreationInfo(
baseUrl: string,
amount: AmountJson,
): Promise {
return callBackend("reserve-creation-info", { baseUrl, amount });
}
/**
* Get all exchanges the wallet knows about.
*/
export function getExchanges(): Promise {
return callBackend("get-exchanges", {});
}
/**
* Get all currencies the exchange knows about.
*/
export function getCurrencies(): Promise {
return callBackend("get-currencies", {});
}
/**
* Get information about a specific exchange.
*/
export function getExchangeInfo(baseUrl: string): Promise {
return callBackend("exchange-info", { baseUrl });
}
/**
* Replace an existing currency record with the one given. The currency to
* replace is specified inside the currency record.
*/
export function updateCurrency(currencyRecord: CurrencyRecord): Promise {
return callBackend("update-currency", { currencyRecord });
}
/**
* Get all reserves the wallet has at an exchange.
*/
export function getReserves(exchangeBaseUrl: string): Promise {
return callBackend("get-reserves", { exchangeBaseUrl });
}
/**
* Get all coins withdrawn from the given exchange.
*/
export function getCoins(exchangeBaseUrl: string): Promise {
return callBackend("get-coins", { exchangeBaseUrl });
}
/**
* Get all denoms offered by the given exchange.
*/
export function getDenoms(
exchangeBaseUrl: string,
): Promise {
return callBackend("get-denoms", { exchangeBaseUrl });
}
/**
* Start refreshing a coin.
*/
export function refresh(coinPub: string): Promise {
return callBackend("refresh-coin", { coinPub });
}
/**
* Pay for a proposal.
*/
export function confirmPay(
proposalId: string,
sessionId: string | undefined,
): Promise {
return callBackend("confirm-pay", { proposalId, sessionId });
}
/**
* Mark a reserve as confirmed.
*/
export function confirmReserve(reservePub: string): Promise {
return callBackend("confirm-reserve", { reservePub });
}
/**
* Check upgrade information
*/
export function checkUpgrade(): Promise {
return callBackend("check-upgrade", {});
}
/**
* Create a reserve.
*/
export function createReserve(args: {
amount: AmountJson;
exchange: string;
senderWire?: string;
}): Promise {
return callBackend("create-reserve", args);
}
/**
* Reset database
*/
export function resetDb(): Promise {
return callBackend("reset-db", {});
}
/**
* Get balances for all currencies/exchanges.
*/
export function getBalance(): Promise {
return callBackend("balances", {});
}
/**
* Get possible sender wire infos for getting money
* wired from an exchange.
*/
export function getSenderWireInfos(): Promise {
return callBackend("get-sender-wire-infos", {});
}
/**
* Return coins to a bank account.
*/
export function returnCoins(args: {
amount: AmountJson;
exchange: string;
senderWire: object;
}): Promise {
return callBackend("return-coins", args);
}
/**
* Look up a purchase in the wallet database from
* the contract terms hash.
*/
export function getPurchaseDetails(
contractTermsHash: string,
): Promise {
return callBackend("get-purchase-details", { contractTermsHash });
}
/**
* Get the status of processing a tip.
*/
export function getTipStatus(talerTipUri: string): Promise {
return callBackend("get-tip-status", { talerTipUri });
}
/**
* Mark a tip as accepted by the user.
*/
export function acceptTip(talerTipUri: string): Promise {
return callBackend("accept-tip", { talerTipUri });
}
/**
* Download a refund and accept it.
*/
export function applyRefund(refundUrl: string): Promise {
return callBackend("accept-refund", { refundUrl });
}
/**
* Abort a failed payment and try to get a refund.
*/
export function abortFailedPayment(contractTermsHash: string): Promise {
return callBackend("abort-failed-payment", { contractTermsHash });
}
/**
* Abort a failed payment and try to get a refund.
*/
export function benchmarkCrypto(repetitions: number): Promise {
return callBackend("benchmark-crypto", { repetitions });
}
/**
* Get details about a withdraw operation.
*/
export function getWithdrawDetails(
talerWithdrawUri: string,
maybeSelectedExchange: string | undefined,
): Promise {
return callBackend("get-withdraw-details", {
talerWithdrawUri,
maybeSelectedExchange,
});
}
/**
* Get details about a pay operation.
*/
export function preparePay(talerPayUri: string): Promise {
return callBackend("prepare-pay", { talerPayUri });
}
/**
* Get details about a withdraw operation.
*/
export function acceptWithdrawal(
talerWithdrawUri: string,
selectedExchange: string,
): Promise {
return callBackend("accept-withdrawal", {
talerWithdrawUri,
selectedExchange,
});
}
/**
* Get diagnostics information
*/
export function getDiagnostics(): Promise {
return callBackend("get-diagnostics", {});
}