thor-devkit
Version:
Typescript library to aid DApp development on VeChain Thor
317 lines • 25.9 kB
JavaScript
"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
exports.Transaction = void 0;
const address_1 = require("./address");
const blake2b_1 = require("./blake2b");
const rlp_1 = require("./rlp");
const secp256k1_1 = require("./secp256k1");
const buffer_1 = require("buffer");
/** Transaction class defines VeChainThor's multi-clause transaction */
class Transaction {
/**
* construct a transaction object with given body
* @param body body of tx
*/
constructor(body) {
this.body = Object.assign({}, body);
}
/** decode from Buffer to transaction
* @param raw encoded buffer
* @param unsigned to indicator if the encoded buffer contains signature
*/
static decode(raw, unsigned) {
let type;
if (raw.length > 0 && raw[0] > 0x7f) {
type = Transaction.Type.Legacy;
}
else {
if (raw.length === 0) {
throw new Error('typed transaction too short');
}
if (raw[0] === Transaction.Type.DynamicFee) {
type = Transaction.Type.DynamicFee;
// remove type identifier for subsequent decoding
raw = raw.slice(1);
}
else {
throw new Error('transaction type not supported: ' + raw[0]);
}
}
let body;
let signature;
if (unsigned) {
body = type === Transaction.Type.DynamicFee ?
unsignedDynamicFeeTxRLP.decode(raw) :
unsignedLegacyTxRLP.decode(raw);
body.type = type;
}
else {
const decoded = type === Transaction.Type.DynamicFee ?
dynamicFeeTxRLP.decode(raw) :
legacyTxRLP.decode(raw);
signature = decoded.signature;
delete decoded.signature;
body = decoded;
body.type = type;
}
const reserved = body.reserved;
if (reserved.length > 0) {
if (reserved[reserved.length - 1].length === 0) {
throw new Error('invalid reserved fields: not trimmed');
}
const features = featuresKind.buffer(reserved[0], 'reserved.features').decode();
body.reserved = {
features
};
if (reserved.length > 1) {
body.reserved.unused = reserved.slice(1);
}
}
else {
delete body.reserved;
}
const tx = new Transaction(body);
if (signature) {
tx.signature = signature;
}
return tx;
}
/**
* returns transaction ID
* null returned if something wrong (e.g. invalid signature)
*/
get id() {
if (!this._signatureValid) {
return null;
}
try {
const signingHash = this.signingHash();
const pubKey = secp256k1_1.secp256k1.recover(signingHash, this.signature.slice(0, 65));
const origin = address_1.address.fromPublicKey(pubKey);
return '0x' + blake2b_1.blake2b256(signingHash, buffer_1.Buffer.from(origin.slice(2), 'hex')).toString('hex');
}
catch (_a) {
return null;
}
}
/** returns transaction type, type legacy will return if type is not set */
get type() {
if (this.body.hasOwnProperty('type') && this.body.type !== undefined) {
return this.body.type;
}
return Transaction.Type.Legacy;
}
/**
* compute signing hashes.
* It returns tx hash for origin or delegator depends on param `delegateFor`.
* @param delegateFor address of intended tx origin. If set, the returned hash is for delegator to sign.
*/
signingHash(delegateFor) {
this.checkType();
const reserved = this._encodeReserved();
let buf;
if (this.type === Transaction.Type.DynamicFee) {
const raw = unsignedDynamicFeeTxRLP.encode(Object.assign(Object.assign({}, this.body), { reserved }));
buf = buffer_1.Buffer.concat([buffer_1.Buffer.from([Transaction.Type.DynamicFee]), raw]);
}
else {
buf = unsignedLegacyTxRLP.encode(Object.assign(Object.assign({}, this.body), { reserved }));
}
const hash = blake2b_1.blake2b256(buf);
if (delegateFor) {
if (!/^0x[0-9a-f]{40}$/i.test(delegateFor)) {
throw new Error('delegateFor expected address');
}
return blake2b_1.blake2b256(hash, buffer_1.Buffer.from(delegateFor.slice(2), 'hex'));
}
return hash;
}
/** returns tx origin. null returned if no signature or not incorrectly signed */
get origin() {
if (!this._signatureValid) {
return null;
}
try {
const signingHash = this.signingHash();
const pubKey = secp256k1_1.secp256k1.recover(signingHash, this.signature.slice(0, 65));
return address_1.address.fromPublicKey(pubKey);
}
catch (_a) {
return null;
}
}
/** returns tx delegator. null returned if no signature or not incorrectly signed */
get delegator() {
if (!this.delegated) {
return null;
}
if (!this._signatureValid) {
return null;
}
const origin = this.origin;
if (!origin) {
return null;
}
try {
const signingHash = this.signingHash(origin);
const pubKey = secp256k1_1.secp256k1.recover(signingHash, this.signature.slice(65));
return address_1.address.fromPublicKey(pubKey);
}
catch (_a) {
return null;
}
}
/** returns whether delegated. see https://github.com/vechain/VIPs/blob/master/vips/VIP-191.md */
get delegated() {
var _a, _b;
// tslint:disable-next-line:no-bitwise
return (((_b = ((_a = this.body.reserved) !== null && _a !== void 0 ? _a : {}).features) !== null && _b !== void 0 ? _b : 0) & Transaction.DELEGATED_MASK) === Transaction.DELEGATED_MASK;
}
/** returns intrinsic gas it takes */
get intrinsicGas() {
return Transaction.intrinsicGas(this.body.clauses);
}
/** encode into Buffer */
encode() {
this.checkType();
const reserved = this._encodeReserved();
if (this.type === Transaction.Type.DynamicFee) {
const raw = this.signature ?
dynamicFeeTxRLP.encode(Object.assign(Object.assign({}, this.body), { reserved, signature: this.signature })) :
unsignedDynamicFeeTxRLP.encode(Object.assign(Object.assign({}, this.body), { reserved }));
return buffer_1.Buffer.concat([buffer_1.Buffer.from([Transaction.Type.DynamicFee]), raw]);
}
return this.signature ?
legacyTxRLP.encode(Object.assign(Object.assign({}, this.body), { reserved, signature: this.signature })) :
unsignedLegacyTxRLP.encode(Object.assign(Object.assign({}, this.body), { reserved }));
}
_encodeReserved() {
var _a, _b, _c;
const reserved = (_a = this.body.reserved) !== null && _a !== void 0 ? _a : {};
const list = [featuresKind.data((_b = reserved.features) !== null && _b !== void 0 ? _b : 0, 'reserved.features').encode(),
...((_c = reserved.unused) !== null && _c !== void 0 ? _c : [])];
// trim
while (list.length > 0) {
if (list[list.length - 1].length === 0) {
list.pop();
}
else {
break;
}
}
return list;
}
get _signatureValid() {
const expectedSigLen = this.delegated ? 65 * 2 : 65;
return this.signature ? this.signature.length === expectedSigLen : false;
}
checkType() {
// allow type to be undefined to be compatible with older spec
if (this.body.hasOwnProperty('type') && this.body.type !== undefined &&
this.body.type !== Transaction.Type.Legacy && this.body.type !== Transaction.Type.DynamicFee) {
throw new Error('unsupported transaction type: ' + this.body.type);
}
}
}
exports.Transaction = Transaction;
Transaction.DELEGATED_MASK = 1;
(function (Transaction) {
let Type;
(function (Type) {
Type[Type["Legacy"] = 0] = "Legacy";
Type[Type["DynamicFee"] = 81] = "DynamicFee";
})(Type = Transaction.Type || (Transaction.Type = {}));
/**
* calculates intrinsic gas that a tx costs with the given clauses.
* @param clauses
*/
function intrinsicGas(clauses) {
const txGas = 5000;
const clauseGas = 16000;
const clauseGasContractCreation = 48000;
if (clauses.length === 0) {
return txGas + clauseGas;
}
return clauses.reduce((sum, c) => {
if (c.to) {
sum += clauseGas;
}
else {
sum += clauseGasContractCreation;
}
sum += dataGas(c.data);
return sum;
}, txGas);
}
Transaction.intrinsicGas = intrinsicGas;
function dataGas(data) {
const zgas = 4;
const nzgas = 68;
let sum = 0;
for (let i = 2; i < data.length; i += 2) {
if (data.substring(i, i + 2) === '00') {
sum += zgas;
}
else {
sum += nzgas;
}
}
return sum;
}
})(Transaction = exports.Transaction || (exports.Transaction = {}));
const unsignedLegacyTxRLP = new rlp_1.RLP({
name: 'unsigned legacy tx',
kind: [
{ name: 'chainTag', kind: new rlp_1.RLP.NumericKind(1) },
{ name: 'blockRef', kind: new rlp_1.RLP.CompactFixedBlobKind(8) },
{ name: 'expiration', kind: new rlp_1.RLP.NumericKind(4) },
{
name: 'clauses', kind: {
item: [
{ name: 'to', kind: new rlp_1.RLP.NullableFixedBlobKind(20) },
{ name: 'value', kind: new rlp_1.RLP.NumericKind(32) },
{ name: 'data', kind: new rlp_1.RLP.BlobKind() },
],
},
},
{ name: 'gasPriceCoef', kind: new rlp_1.RLP.NumericKind(1) },
{ name: 'gas', kind: new rlp_1.RLP.NumericKind(8) },
{ name: 'dependsOn', kind: new rlp_1.RLP.NullableFixedBlobKind(32) },
{ name: 'nonce', kind: new rlp_1.RLP.NumericKind(8) },
{ name: 'reserved', kind: { item: new rlp_1.RLP.BufferKind() } },
],
});
const legacyTxRLP = new rlp_1.RLP({
name: 'legacy tx',
kind: [...unsignedLegacyTxRLP.profile.kind, { name: 'signature', kind: new rlp_1.RLP.BufferKind() }],
});
const unsignedDynamicFeeTxRLP = new rlp_1.RLP({
name: 'unsigned dynamic fee tx',
kind: [
{ name: 'chainTag', kind: new rlp_1.RLP.NumericKind(1) },
{ name: 'blockRef', kind: new rlp_1.RLP.CompactFixedBlobKind(8) },
{ name: 'expiration', kind: new rlp_1.RLP.NumericKind(4) },
{
name: 'clauses', kind: {
item: [
{ name: 'to', kind: new rlp_1.RLP.NullableFixedBlobKind(20) },
{ name: 'value', kind: new rlp_1.RLP.NumericKind(32) },
{ name: 'data', kind: new rlp_1.RLP.BlobKind() },
],
},
},
{ name: 'maxPriorityFeePerGas', kind: new rlp_1.RLP.NumericKind(32) },
{ name: 'maxFeePerGas', kind: new rlp_1.RLP.NumericKind(32) },
{ name: 'gas', kind: new rlp_1.RLP.NumericKind(8) },
{ name: 'dependsOn', kind: new rlp_1.RLP.NullableFixedBlobKind(32) },
{ name: 'nonce', kind: new rlp_1.RLP.NumericKind(8) },
{ name: 'reserved', kind: { item: new rlp_1.RLP.BufferKind() } },
],
});
const dynamicFeeTxRLP = new rlp_1.RLP({
name: 'dynamic fee tx',
// tslint:disable-next-line:max-line-length
kind: [...unsignedDynamicFeeTxRLP.profile.kind, { name: 'signature', kind: new rlp_1.RLP.BufferKind() }],
});
const featuresKind = new rlp_1.RLP.NumericKind(4);
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHJhbnNhY3Rpb24uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvdHJhbnNhY3Rpb24udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUEsdUNBQW1DO0FBQ25DLHVDQUFzQztBQUN0QywrQkFBMkI7QUFDM0IsMkNBQXVDO0FBQ3ZDLG1DQUErQjtBQUUvQix1RUFBdUU7QUFDdkUsTUFBYSxXQUFXO0lBdUVwQjs7O09BR0c7SUFDSCxZQUFZLElBQU87UUFDZixJQUFJLENBQUMsSUFBSSxxQkFBUSxJQUFJLENBQUUsQ0FBQTtJQUMzQixDQUFDO0lBMUVEOzs7T0FHRztJQUNJLE1BQU0sQ0FBQyxNQUFNLENBQUMsR0FBVyxFQUFFLFFBQWtCO1FBQ2hELElBQUksSUFBc0IsQ0FBQTtRQUMxQixJQUFJLEdBQUcsQ0FBQyxNQUFNLEdBQUcsQ0FBQyxJQUFJLEdBQUcsQ0FBQyxDQUFDLENBQUMsR0FBRyxJQUFJLEVBQUU7WUFDakMsSUFBSSxHQUFHLFdBQVcsQ0FBQyxJQUFJLENBQUMsTUFBTSxDQUFBO1NBQ2pDO2FBQU07WUFDSCxJQUFJLEdBQUcsQ0FBQyxNQUFNLEtBQUssQ0FBQyxFQUFFO2dCQUNsQixNQUFNLElBQUksS0FBSyxDQUFDLDZCQUE2QixDQUFDLENBQUE7YUFDakQ7WUFDRCxJQUFJLEdBQUcsQ0FBQyxDQUFDLENBQUMsS0FBSyxXQUFXLENBQUMsSUFBSSxDQUFDLFVBQVUsRUFBRTtnQkFDeEMsSUFBSSxHQUFHLFdBQVcsQ0FBQyxJQUFJLENBQUMsVUFBVSxDQUFBO2dCQUNsQyxpREFBaUQ7Z0JBQ2pELEdBQUcsR0FBRyxHQUFHLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFBO2FBQ3JCO2lCQUFNO2dCQUNILE1BQU0sSUFBSSxLQUFLLENBQUMsa0NBQWtDLEdBQUcsR0FBRyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUE7YUFDL0Q7U0FDSjtRQUVELElBQUksSUFBeUQsQ0FBQTtRQUM3RCxJQUFJLFNBQTZCLENBQUE7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