/*
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 "../amounts";
import {
CoinRecord,
CurrencyRecord,
DenominationRecord,
ExchangeRecord,
PreCoinRecord,
PurchaseRecord,
ReserveRecord,
} from "../dbTypes";
import {
CheckPayResult,
ConfirmPayResult,
QueryPaymentResult,
ReserveCreationInfo,
SenderWireInfos,
TipStatus,
WalletBalance,
} from "../walletTypes";
import {
RefundPermission,
TipPlanchetDetail,
TipResponse,
} from "../talerTypes";
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;
}
async function callBackend(type: T, detail: MessageMap[T]["request"]): Promise {
return new Promise((resolve, reject) => {
chrome.runtime.sendMessage({ type, detail }, (resp) => {
if (resp && resp.error) {
reject(resp);
} 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 currency.
*/
export function getCurrency(name: string): Promise {
return callBackend("currency-info", {name});
}
/**
* 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 precoins withdrawn from the given exchange.
*/
export function getPreCoins(exchangeBaseUrl: string): Promise {
return callBackend("get-precoins", { 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 });
}
/**
* Get a proposal stored in the wallet by its proposal id.
*/
export function getProposal(proposalId: number) {
return callBackend("get-proposal", { proposalId });
}
/**
* Check if payment is possible or already done.
*/
export function checkPay(proposalId: number): Promise {
return callBackend("check-pay", { proposalId });
}
/**
* Pay for a proposal.
*/
export function confirmPay(proposalId: number): Promise {
return callBackend("confirm-pay", { proposalId });
}
/**
* Hash a contract. Throws if its not a valid contract.
*/
export function hashContract(contract: object): Promise {
return callBackend("hash-contract", { contract });
}
/**
* Save a proposal in the wallet. Returns the proposal id that
* the proposal is stored under.
*/
export function saveProposal(proposal: any): Promise {
return callBackend("save-proposal", { proposal });
}
/**
* Mark a reserve as confirmed.
*/
export function confirmReserve(reservePub: string): Promise {
return callBackend("confirm-reserve", { reservePub });
}
/**
* Query for a payment by fulfillment URL.
*/
export function queryPayment(url: string): Promise {
return callBackend("query-payment", { url });
}
/**
* Mark a payment as succeeded.
*/
export function paymentSucceeded(contractTermsHash: string, merchantSig: string): Promise {
return callBackend("payment-succeeded", { contractTermsHash, merchantSig });
}
/**
* Mark a payment as succeeded.
*/
export function paymentFailed(contractTermsHash: string): Promise {
return callBackend("payment-failed", { contractTermsHash });
}
/**
* Get the payment cookie for the current tab, or undefined if no payment
* cookie was set.
*/
export function getTabCookie(): Promise {
return callBackend("get-tab-cookie", { });
}
/**
* Generate a contract nonce (EdDSA key pair), store it in the wallet's
* database and return the public key.
*/
export function generateNonce(): Promise {
return callBackend("generate-nonce", { });
}
/**
* Check upgrade information
*/
export function checkUpgrade(): Promise {
return callBackend("check-upgrade", { });
}
/**
* Create a reserve.
*/
export function createReserve(args: { amount: AmountJson, exchange: string, senderWire?: object }): 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);
}
/**
* Record an error report and display it in a tabl.
*
* If sameTab is set, the error report will be opened in the current tab,
* otherwise in a new tab.
*/
export function logAndDisplayError(args: any): Promise {
return callBackend("log-and-display-error", args);
}
/**
* Get an error report from the logging database for the
* given report UID.
*/
export function getReport(reportUid: string): Promise {
return callBackend("get-report", { reportUid });
}
/**
* Apply a refund that we got from the merchant.
*/
export function acceptRefund(refundData: any): Promise {
return callBackend("accept-refund", refundData);
}
/**
* Look up a purchase in the wallet database from
* the contract terms hash.
*/
export function getPurchase(contractTermsHash: string): Promise {
return callBackend("get-purchase", { contractTermsHash });
}
/**
* Get the refund fees for a refund permission, including
* subsequent refresh and unrefreshable coins.
*/
export function getFullRefundFees(args: { refundPermissions: RefundPermission[] }): Promise {
return callBackend("get-full-refund-fees", { refundPermissions: args.refundPermissions });
}
/**
* Get or generate planchets to give the merchant that wants to tip us.
*/
export function getTipPlanchets(merchantDomain: string,
tipId: string,
amount: AmountJson,
deadline: number,
exchangeUrl: string,
nextUrl: string): Promise {
return callBackend("get-tip-planchets", { merchantDomain, tipId, amount, deadline, exchangeUrl, nextUrl });
}
/**
* Get the status of processing a tip.
*/
export function getTipStatus(merchantDomain: string, tipId: string): Promise {
return callBackend("get-tip-status", { merchantDomain, tipId });
}
/**
* Mark a tip as accepted by the user.
*/
export function acceptTip(merchantDomain: string, tipId: string): Promise {
return callBackend("accept-tip", { merchantDomain, tipId });
}
/**
* Process a response from the merchant for a tip request.
*/
export function processTipResponse(merchantDomain: string, tipId: string, tipResponse: TipResponse): Promise {
return callBackend("process-tip-response", { merchantDomain, tipId, tipResponse });
}
/**
* Clear notifications that the wallet shows to the user.
*/
export function clearNotification(): Promise {
return callBackend("clear-notification", { });
}