/* 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, PlanchetRecord, ReserveRecord, } from "../dbTypes"; import { BenchmarkResult, ConfirmPayResult, ExchangeWithdrawDetails, SenderWireInfos, TipStatus, WalletBalance, PurchaseDetails, WalletDiagnostics, } from "../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 (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 reserves for which a payback is available. */ export function getPaybackReserves(): Promise { return callBackend("get-payback-reserves", { }); } /** * Withdraw the payback that is available for a reserve. */ export function withdrawPaybackReserve(reservePub: string): Promise { return callBackend("withdraw-payback-reserve", { reservePub }); } /** * 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 }); } /** * Request payback for a coin. Only works for non-refreshed coins. */ export function payback(coinPub: string): Promise { return callBackend("payback-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) { 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) { return callBackend("get-withdraw-details", { talerWithdrawUri, maybeSelectedExchange }); } /** * Get details about a pay operation. */ export function preparePay(talerPayUri: string) { return callBackend("prepare-pay", { talerPayUri }); } /** * Get details about a withdraw operation. */ export function acceptWithdrawal(talerWithdrawUri: string, selectedExchange: string) { return callBackend("accept-withdrawal", { talerWithdrawUri, selectedExchange }); } /** * Get diagnostics information */ export function getDiagnostics(): Promise { return callBackend("get-diagnostics", {}); }