@tangany/waas
Version:
node.js SDK for Tangany Wallet as a Service API
269 lines • 13.5 kB
JavaScript
"use strict";
var __extends = (this && this.__extends) || (function () {
var extendStatics = function (d, b) {
extendStatics = Object.setPrototypeOf ||
({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
return extendStatics(d, b);
};
return function (d, b) {
if (typeof b !== "function" && b !== null)
throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
extendStatics(d, b);
function __() { this.constructor = d; }
d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
};
})();
var __assign = (this && this.__assign) || function () {
__assign = Object.assign || function(t) {
for (var s, i = 1, n = arguments.length; i < n; i++) {
s = arguments[i];
for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
t[p] = s[p];
}
return t;
};
return __assign.apply(this, arguments);
};
var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
return new (P || (P = Promise))(function (resolve, reject) {
function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
step((generator = generator.apply(thisArg, _arguments || [])).next());
});
};
var __generator = (this && this.__generator) || function (thisArg, body) {
var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
function verb(n) { return function (v) { return step([n, v]); }; }
function step(op) {
if (f) throw new TypeError("Generator is already executing.");
while (_) try {
if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
if (y = 0, t) op = [op[0] & 2, t.value];
switch (op[0]) {
case 0: case 1: t = op; break;
case 4: _.label++; return { value: op[1], done: false };
case 5: _.label++; y = op[1]; op = [0]; continue;
case 7: op = _.ops.pop(); _.trys.pop(); continue;
default:
if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
if (t[2]) _.ops.pop();
_.trys.pop(); continue;
}
op = body.call(thisArg, _);
} catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
}
};
Object.defineProperty(exports, "__esModule", { value: true });
exports.EthWallet = void 0;
var t = require("typeforce");
var blockchain_wallet_1 = require("./blockchain-wallet");
var eth_contract_wallet_1 = require("./eth-contract-wallet");
var eth_erc20_wallet_1 = require("./eth-erc20-wallet");
var eth_transaction_1 = require("./eth-transaction");
var eth_transaction_request_1 = require("./eth-transaction-request");
var eth_transaction_iterable_1 = require("./iterables/auto-pagination/eth-transaction-iterable");
var eth_transaction_page_iterable_1 = require("./iterables/pagewise/eth-transaction-page-iterable");
var monitor_1 = require("./monitor");
var waas_1 = require("./waas");
/**
* Instantiates a new Ethereum wallet interface
* @param instance - axios instance created by {@link Waas}
* @param limiter - Bottleneck limiter instance
* @param walletInstance - instance of Wallet class
*/
var EthWallet = /** @class */ (function (_super) {
__extends(EthWallet, _super);
function EthWallet(waas, walletInstance) {
var _this = _super.call(this, waas, walletInstance) || this;
/**
* @deprecated Do not use this outside unit testing
*/
// tslint:disable-next-line:variable-name
_this.__test_validateRecipient = function () {
var args = [];
for (var _i = 0; _i < arguments.length; _i++) {
args[_i] = arguments[_i];
}
return _this.validateRecipient.apply(_this, args);
};
/**
* @deprecated Do not use this outside unit testing
*/
// tslint:disable-next-line:variable-name
_this.__test_validateRecipientNoData = function () {
var args = [];
for (var _i = 0; _i < arguments.length; _i++) {
args[_i] = arguments[_i];
}
return _this.validateRecipientNoData.apply(_this, args);
};
return _this;
}
/**
* Returns wallet metrics for the Ethereum blockchain like ether balance and the address
* @see [docs]{@link https://docs.tangany.com/#0d926cca-e0bd-4045-864d-18845425adfe}
*/
EthWallet.prototype.get = function () {
return __awaiter(this, void 0, void 0, function () {
var _this = this;
return __generator(this, function (_a) {
return [2 /*return*/, this.waas.wrap(function () { return _this.waas.instance
.get("eth/wallet/".concat(_this.wallet)); })];
});
});
};
/**
* Sends Ether to address from given wallet
* @param recipient - {@link IEthereumRecipient}
* @see [docs]{@link https://docs.tangany.com/#1d76974c-579a-47aa-9912-c7cfddf55889}
* @deprecated Use {@link sendAsync} instead
*/
EthWallet.prototype.send = function (recipient) {
return __awaiter(this, void 0, void 0, function () {
var hash;
var _this = this;
return __generator(this, function (_a) {
switch (_a.label) {
case 0:
this.validateRecipient(recipient);
return [4 /*yield*/, this.waas.wrap(function () { return _this.waas.instance
.post("eth/wallet/".concat(_this.wallet, "/send"), __assign({}, recipient)); })];
case 1:
hash = (_a.sent()).hash;
return [2 /*return*/, new eth_transaction_1.EthTransaction(this.waas, hash)];
}
});
});
};
/**
* Sends Ether to address from given wallet *asynchronously*
* @param recipient - {@link IEthereumRecipientNoData}
* @see [docs]{@link https://docs.tangany.com/#29e9ed85-f4a1-42bc-88fa-8e1f96fb426f}
*/
EthWallet.prototype.sendAsync = function (recipient) {
return __awaiter(this, void 0, void 0, function () {
var rawResponse, id;
var _this = this;
return __generator(this, function (_a) {
switch (_a.label) {
case 0:
this.validateRecipientNoData(recipient);
return [4 /*yield*/, this.waas.wrap(function () { return _this.waas.instance
.post("eth/wallet/".concat(_this.wallet, "/send-async"), __assign({}, recipient)); })];
case 1:
rawResponse = _a.sent();
id = this.extractRequestId(rawResponse);
return [2 /*return*/, new eth_transaction_request_1.EthTransactionRequest(this.waas, id)];
}
});
});
};
/**
* Creates an RLP encoded transaction that is already signed and can be manually transmitted
* to compatible blockchain networks at a later stage.
* @param recipient - {@link IEthereumRecipient}
* @see [docs]{@link https://docs.tangany.com/#925fd26a-daff-4321-9595-8509dd2ed6b3}
* @deprecated This synchronous version is deprecated, but in the future there will be an asynchronous version
*/
EthWallet.prototype.sign = function (recipient) {
return __awaiter(this, void 0, void 0, function () {
var _this = this;
return __generator(this, function (_a) {
this.validateRecipient(recipient);
return [2 /*return*/, this.waas.wrap(function () { return _this.waas.instance
.post("eth/wallet/".concat(_this.wallet, "/sign"), __assign({}, recipient)); })];
});
});
};
/**
* Returns the fee estimation for a transaction with the given parameters
* The fee estimation is based on the current ethereum network utilization and can fluctuate in random fashion.
* Thus the estimation cannot guarantee to match the actual transaction fee.
* @param recipient - {@link IEthereumRecipient}
*/
EthWallet.prototype.estimateFee = function (recipient) {
return __awaiter(this, void 0, void 0, function () {
var _this = this;
return __generator(this, function (_a) {
this.validateRecipient(recipient);
return [2 /*return*/, this.waas.wrap(function () { return _this.waas.instance
.post("eth/wallet/".concat(_this.wallet, "/estimate-fee"), recipient); })];
});
});
};
/**
* Returns the signature of the given string payload
* The payload formatted in the following way: `"\x19Ethereum Signed Message:\n" + message.length + message`.
* It is then hashed using keccak256 and finally signed using the wallet`s private key.
* @param payload - the string to be signed
*/
EthWallet.prototype.personalSign = function (payload) {
return __awaiter(this, void 0, void 0, function () {
var _this = this;
return __generator(this, function (_a) {
return [2 /*return*/, this.waas.wrap(function () { return _this.waas.instance.post("eth/wallet/".concat(_this.wallet, "/sign"), { payload: payload }); })];
});
});
};
EthWallet.prototype.getTransactions = function (params, options) {
var initialRequest = { url: "eth/wallet/".concat(this.wallet, "/transactions"), params: params };
if (options === null || options === void 0 ? void 0 : options.autoPagination) {
return new eth_transaction_iterable_1.EthTransactionIterable(this.waas, initialRequest);
}
else {
return new eth_transaction_page_iterable_1.EthTransactionPageIterable(this.waas, initialRequest);
}
};
/**
* Returns wallet calls for the Ethereum ERC20 token
* @param tokenAddress - Ethereum ERC20 token address for given eth network
*/
EthWallet.prototype.erc20 = function (tokenAddress) {
return new eth_erc20_wallet_1.EthErc20Wallet(this.waas, this.walletInstance, tokenAddress);
};
/**
* Returns wallet calls for universal Smart Contract method calling
*/
EthWallet.prototype.contract = function (address) {
return new eth_contract_wallet_1.EthContractWallet(this.waas, this.walletInstance, address);
};
/**
* Returns an object to interact with monitors related to the current wallet.
* @param [id] - Monitor id that must be passed if a specific monitor is to be addressed
*/
EthWallet.prototype.monitor = function (id) {
return new monitor_1.Monitor(this.waas, id, this.wallet);
};
/**
* Throws an exception if the passed recipient is invalid or otherwise ends successfully without a return value.
* @param recipient - Recipient to be validated ({@link IEthereumRecipient})
*/
EthWallet.prototype.validateRecipient = function (recipient) {
if (!(recipient.to || recipient.wallet)) {
throw new Error("At least one of the properties 'to' or 'wallet' must be set");
}
t(waas_1.ethereumRecipientType, recipient, true);
};
/**
* Throws an exception if the passed recipient is invalid or otherwise ends successfully without a return value
* Special case for sendAsync method: recipient must not contain property data
* @param recipient - Recipient to be validated ({@link IEthereumRecipientNoData})
*/
EthWallet.prototype.validateRecipientNoData = function (recipient) {
if (!(recipient.to || recipient.wallet)) {
throw new Error("At least one of the properties 'to' or 'wallet' must be set");
}
t(waas_1.ethereumRecipientTypeSendAsync, recipient, true);
};
return EthWallet;
}(blockchain_wallet_1.BlockchainWallet));
exports.EthWallet = EthWallet;
//# sourceMappingURL=eth-wallet.js.map