UNPKG

@ellcrys/spell

Version:

The official JavaScript library for Ellcrys

327 lines 18.7 kB
"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 (b.hasOwnProperty(p)) d[p] = b[p]; }; return extendStatics(d, b); }; return function (d, b) { extendStatics(d, b); function __() { this.constructor = d; } d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __()); }; })(); var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) { 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) : new P(function (resolve) { resolve(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 }; } }; var __importDefault = (this && this.__importDefault) || function (mod) { return (mod && mod.__esModule) ? mod : { "default": mod }; }; Object.defineProperty(exports, "__esModule", { value: true }); /** * @module TransactionBuilder */ var decimal_js_1 = __importDefault(require("decimal.js")); var moment = require("moment"); var errors_1 = __importDefault(require("../errors")); var key_1 = require("../key"); var tx_util_1 = __importDefault(require("./tx_util")); var b58 = require("bs58check"); exports.NumDecimals = 18; exports.TxPayloadVersion = Buffer.from([95]); /** * Transaction builder provides * transaction creation and execution * capabilities. * * @class TxBuilder */ var TxBuilder = /** @class */ (function () { function TxBuilder(client) { this.balance = new TxBalanceBuilder(client); } return TxBuilder; }()); exports.default = TxBuilder; /** * TxBalanceBuilder provides the ability to * build and execute a balance transaction * * @class TxBalanceBuilder */ var TxBalanceBuilder = /** @class */ (function (_super) { __extends(TxBalanceBuilder, _super); /** * Creates an instance of TxBalanceBuilder. * * @param {RPCClient} [client] The RPC client * @memberof TxBalanceBuilder */ function TxBalanceBuilder(client) { var _this = _super.call(this) || this; _this.client = client; _this.data = { type: 0x1, }; return _this; } /** * Set the sender address * * @param {string|Address} address The address * @returns {TxBalanceBuilder} * @memberof TxBalanceBuilder */ TxBalanceBuilder.prototype.from = function (address) { if (address instanceof key_1.Address) { this.data.from = address.toString(); } else { this.data.from = address; } return this; }; /** * Set the recipient address * * @param {string|Address} address The address * @returns {TxBalanceBuilder} * @memberof TxBalanceBuilder */ TxBalanceBuilder.prototype.to = function (address) { if (address instanceof key_1.Address) { this.data.to = address.toString(); } else { this.data.to = address; } return this; }; /** * The next nonce of the sending account * * @param {number} n The next nonce of the sender * @returns {TxBalanceBuilder} * @memberof TxBalanceBuilder */ TxBalanceBuilder.prototype.nonce = function (num) { this.data.nonce = num; return this; }; /** * Set the amount to send from the * sender to the recipient * * @param {string} value The amount to send * @returns {TxBalanceBuilder} * @memberof TxBalanceBuilder */ TxBalanceBuilder.prototype.value = function (value) { if (value instanceof decimal_js_1.default) { this.data.value = value.toFixed(exports.NumDecimals); } else { this.data.value = value; } return this; }; /** * Set the fee to be paid for this * transaction * * @param {string} value The amount to pay as fee * @returns {TxBalanceBuilder} * @memberof TxBalanceBuilder */ TxBalanceBuilder.prototype.fee = function (fee) { if (fee instanceof decimal_js_1.default) { this.data.fee = fee.toFixed(exports.NumDecimals); } else { this.data.fee = fee; } return this; }; /** * Reset the transaction builder * * @memberof TxBalanceBuilder */ TxBalanceBuilder.prototype.reset = function () { this.data = {}; }; /** * Returns the transaction data without sending * it to the network. It will finalize the transaction * if the sender's private key is provided. * * @param {PrivateKey} [sk] The senders private key * @memberof TxBalanceBuilder */ TxBalanceBuilder.prototype.payload = function (sk) { return __awaiter(this, void 0, void 0, function () { return __generator(this, function (_a) { switch (_a.label) { case 0: // Set timestamp this.data.timestamp = moment().unix(); if (!sk) return [3 /*break*/, 2]; return [4 /*yield*/, this.finalize(sk)]; case 1: _a.sent(); _a.label = 2; case 2: return [2 /*return*/, this.data]; } }); }); }; /** * Send the transaction to the network * * @param {PrivateKey} sk The sender's private key * @returns {Promise<TxResult>} * @memberof TxBalanceBuilder */ TxBalanceBuilder.prototype.send = function (sk) { return __awaiter(this, void 0, void 0, function () { var _this = this; return __generator(this, function (_a) { return [2 /*return*/, new Promise(function (resolve, reject) { return __awaiter(_this, void 0, void 0, function () { return __generator(this, function (_a) { switch (_a.label) { case 0: this.data.timestamp = moment().unix(); return [4 /*yield*/, this.finalize(sk)]; case 1: _a.sent(); if (!this.client) { return [2 /*return*/, reject(errors_1.default.ClientNotInitialized)]; } this.client .call("ell_send", this.data) .then(function (hash) { return resolve(hash); }) .catch(function (err) { return reject(err); }); return [2 /*return*/]; } }); }); })]; }); }); }; /** * Returns a base58 serialized version of the * transaction. * * @param {PrivateKey} sk The sender's private key * @returns {string} * @memberof TxBalanceBuilder */ TxBalanceBuilder.prototype.packed = function (sk) { return __awaiter(this, void 0, void 0, function () { var txBytes; return __generator(this, function (_a) { switch (_a.label) { case 0: this.data.timestamp = moment().unix(); return [4 /*yield*/, this.finalize(sk)]; case 1: _a.sent(); txBytes = Buffer.from(JSON.stringify(this.data)); return [2 /*return*/, Promise.resolve(b58.encode(Buffer.concat([exports.TxPayloadVersion, txBytes])))]; } }); }); }; /** * Performs final operations such computing and * setting the transaction hash and signature as * well as setting the sender public key and time. * * @protected * @param {PrivateKey} sk The sender's private key * @returns {Promise<string>} Returns the transaction hash * @memberof TxBalanceBuilder */ TxBalanceBuilder.prototype.finalize = function (sk) { var _this = this; return new Promise(function (resolve, reject) { return __awaiter(_this, void 0, void 0, function () { var nonce, e_1; return __generator(this, function (_a) { switch (_a.label) { case 0: if (!sk) { return [2 /*return*/, reject(errors_1.default.RequirePrivateKey)]; } this.data.senderPubKey = sk.publicKey().toBase58(); if (!!this.data.nonce) return [3 /*break*/, 4]; if (!this.client) { return [2 /*return*/, reject(errors_1.default.ClientNotInitialized)]; } _a.label = 1; case 1: _a.trys.push([1, 3, , 4]); return [4 /*yield*/, this.client.call("state_suggestNonce", this.data.from)]; case 2: nonce = _a.sent(); this.data.nonce = nonce; return [3 /*break*/, 4]; case 3: e_1 = _a.sent(); if (e_1.statusCode === 400) { e_1.data = JSON.parse(e_1.data); if (e_1.data.error.code === 30001) { return [2 /*return*/, reject(errors_1.default.UnknownSenderAccount)]; } } return [2 /*return*/, reject(e_1)]; case 4: // Compute and set hash this.data.hash = this.hash(this.data, ""); // Compute and set signature this.data.sig = this.sign(this.data, sk, ""); return [2 /*return*/, resolve(this.data.hash)]; } }); }); }); }; return TxBalanceBuilder; }(tx_util_1.default)); exports.TxBalanceBuilder = TxBalanceBuilder; //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHJhbnNhY3Rpb25fYnVpbGRlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9saWIvYnVpbGRlcnMvdHJhbnNhY3Rpb25fYnVpbGRlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBOztHQUVHO0FBQ0gsMERBQWlDO0FBQ2pDLCtCQUFrQztBQUdsQyxxREFBK0I7QUFDL0IsOEJBQWlDO0FBRWpDLHNEQUFrQztBQUNsQyxJQUFNLEdBQUcsR0FBRyxPQUFPLENBQUMsV0FBVyxDQUFDLENBQUM7QUFFcEIsUUFBQSxXQUFXLEdBQUcsRUFBRSxDQUFDO0FBQ2pCLFFBQUEsZ0JBQWdCLEdBQUcsTUFBTSxDQUFDLElBQUksQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUM7QUFFbEQ7Ozs7OztHQU1HO0FBQ0g7SUFFQyxtQkFBWSxNQUFpQjtRQUM1QixJQUFJLENBQUMsT0FBTyxHQUFHLElBQUksZ0JBQWdCLENBQUMsTUFBTSxDQUFDLENBQUM7SUFDN0MsQ0FBQztJQUNGLGdCQUFDO0FBQUQsQ0FBQyxBQUxELElBS0M7QUFFRCxrQkFBZSxTQUFTLENBQUM7QUFFekI7Ozs7O0dBS0c7QUFDSDtJQUFzQyxvQ0FBUztJQW1COUM7Ozs7O09BS0c7SUFDSCwwQkFBWSxNQUFrQjtRQUE5QixZQUNDLGlCQUFPLFNBS1A7UUFKQSxLQUFJLENBQUMsTUFBTSxHQUFHLE1BQU0sQ0FBQztRQUNyQixLQUFJLENBQUMsSUFBSSxHQUFHO1lBQ1gsSUFBSSxFQUFFLEdBQUc7U0FDVCxDQUFDOztJQUNILENBQUM7SUFFRDs7Ozs7O09BTUc7SUFDSSwrQkFBSSxHQUFYLFVBQVksT0FBeUI7UUFDcEMsSUFBSSxPQUFPLFlBQVksYUFBTyxFQUFFO1lBQy9CLElBQUksQ0FBQyxJQUFJLENBQUMsSUFBSSxHQUFHLE9BQU8sQ0FBQyxRQUFRLEVBQUUsQ0FBQztT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