@aeternity/aepp-sdk 13.0.0-alpha.0 → 13.0.0-alpha.1

package/es/tx/builder/index.d.ts

@@ -1,23 +1,12 @@
 import { Encoded, Encoding } from '../../utils/encoder';
 import { AE_AMOUNT_FORMATS } from '../../utils/amount-formatter';
-import { RawTxObject, TxSchema, TxTypeSchemas } from './schema';
+import { RawTxObject, TxTypeSchemas } from './schema';
 import { Tag } from './constants';
-/**
- * @category transaction builder
- */
-export interface BuiltTx<Tx extends TxSchema, Prefix extends Encoding> {
-    tx: Encoded.Generic<Prefix>;
-    rlpEncoded: Uint8Array;
-    binary: Uint8Array;
-    txObject: RawTxObject<Tx>;
-}
 /**
  * Build transaction hash
  * @category transaction builder
- * @param _params - Object with tx params
- * @param type - Transaction type
+ * @param params - Object with tx params
  * @param options - options
- * @param options.excludeKeys - Array of keys to exclude for validation and build
  * @param options.denomination - Denomination of amounts
  * @param options.prefix - Prefix of transaction
  * @throws {@link InvalidTxParamsError}
@@ -26,22 +15,15 @@ export interface BuiltTx<Tx extends TxSchema, Prefix extends Encoding> {
  * @returns object.rlpEncoded rlp encoded transaction
  * @returns object.binary binary transaction
  */
-export declare function buildTx<TxType extends Tag, Prefix>(_params: Omit<TxTypeSchemas[TxType], 'tag' | 'VSN'> & {
-    VSN?: number;
-}, type: TxType, { excludeKeys, prefix, vsn, denomination, }?: {
-    excludeKeys?: string[];
-    prefix?: Encoding;
-    vsn?: number;
+export declare function buildTx<TxType extends Tag, E extends Encoding = Encoding.Transaction>(params: {
+    tag: TxType;
+    version?: number;
+} & Omit<TxTypeSchemas[TxType], 'tag' | 'version'> & (TxType extends Tag.ContractCreateTx | Tag.ContractCallTx | Tag.ChannelOffChainUpdateCallContract | Tag.GaAttachTx | Tag.GaMetaTx ? {
+    gasMax?: number;
+} : {}), { prefix, denomination, }?: {
+    prefix?: E;
     denomination?: AE_AMOUNT_FORMATS;
-}): BuiltTx<TxSchema, Prefix extends Encoding ? Prefix : Encoding.Transaction>;
-/**
- * @category transaction builder
- */
-export interface TxUnpacked<Tx extends TxSchema> {
-    txType: Tag;
-    tx: RawTxObject<Tx>;
-    rlpEncoded: Uint8Array;
-}
+}): Encoded.Generic<E>;
 /**
  * Unpack transaction hash
  * @category transaction builder
@@ -51,7 +33,7 @@ export interface TxUnpacked<Tx extends TxSchema> {
  * @returns object.tx Object with transaction param's
  * @returns object.txType Transaction type
  */
-export declare function unpackTx<TxType extends Tag>(encodedTx: Encoded.Transaction | Encoded.Poi, txType?: TxType): TxUnpacked<TxTypeSchemas[TxType]>;
+export declare function unpackTx<TxType extends Tag>(encodedTx: Encoded.Transaction | Encoded.Poi, txType?: TxType): RawTxObject<TxTypeSchemas[TxType]>;
 /**
  * Build a transaction hash
  * @category transaction builder

package/es/tx/builder/index.mjs

@@ -1,7 +1,3 @@
-import _buffer from "buffer";
-const {
-  Buffer: _Buffer
-} = _buffer;
 import _rlp from 'rlp';
 const {
   decode: rlpDecode,
@@ -10,144 +6,14 @@ const {
 import { decode, encode, Encoding } from "../../utils/encoder.mjs";
 import { AE_AMOUNT_FORMATS } from "../../utils/amount-formatter.mjs";
 import { hash } from "../../utils/crypto.mjs";
-import { FIELD_TYPES, TX_SCHEMA } from "./schema.mjs";
+import { TX_SCHEMA } from "./schema.mjs";
 import { Tag } from "./constants.mjs";
 import { buildContractId, readInt } from "./helpers.mjs";
-import { toBytes } from "../../utils/bytes.mjs";
-import MPTree from "../../utils/mptree.mjs";
-import { ArgumentError, DecodeError, InvalidTxParamsError, SchemaNotFoundError } from "../../utils/errors.mjs";
+import { ArgumentError, DecodeError, SchemaNotFoundError } from "../../utils/errors.mjs";
 import { isKeyOfObject } from "../../utils/other.mjs";
 /**
  * JavaScript-based Transaction builder
  */
-// SERIALIZE AND DESERIALIZE PART
-function deserializeField(value, type, prefix) {
-  if (value == null) return '';
-  switch (type) {
-    case FIELD_TYPES.ctVersion:
-      {
-        const [vm,, abi] = value;
-        return {
-          vmVersion: readInt(_Buffer.from([vm])),
-          abiVersion: readInt(_Buffer.from([abi]))
-        };
-      }
-    case FIELD_TYPES.bool:
-      return value[0] === 1;
-    case FIELD_TYPES.binary:
-      return encode(value, prefix);
-    case FIELD_TYPES.stateTree:
-      return encode(value, Encoding.StateTrees);
-    case FIELD_TYPES.string:
-      return value.toString();
-    case FIELD_TYPES.payload:
-      return encode(value, Encoding.Bytearray);
-    case FIELD_TYPES.rlpBinary:
-      // eslint-disable-next-line @typescript-eslint/no-use-before-define
-      return unpackTx(encode(value, Encoding.Transaction));
-    case FIELD_TYPES.rlpBinaries:
-      // eslint-disable-next-line @typescript-eslint/no-use-before-define
-      return value.map(v => unpackTx(encode(v, Encoding.Transaction)));
-    case FIELD_TYPES.rawBinary:
-      return value;
-    case FIELD_TYPES.hex:
-      return value.toString('hex');
-    case FIELD_TYPES.offChainUpdates:
-      // eslint-disable-next-line @typescript-eslint/no-use-before-define
-      return value.map(v => unpackTx(encode(v, Encoding.Transaction)));
-    case FIELD_TYPES.callStack:
-      // TODO: fix this
-      return [readInt(value)];
-    case FIELD_TYPES.mptrees:
-      return value.map(t => new MPTree(t));
-    case FIELD_TYPES.sophiaCodeTypeInfo:
-      return value.reduce((acc, _ref) => {
-        let [funHash, fnName, argType, outType] = _ref;
-        return {
-          ...acc,
-          [fnName.toString()]: {
-            funHash,
-            argType,
-            outType
-          }
-        };
-      }, {});
-    default:
-      if (typeof type === 'number') return value;
-      return type.deserialize(value);
-  }
-}
-function serializeField(value, type, params) {
-  var _value$rlpEncoded;
-  switch (type) {
-    case FIELD_TYPES.bool:
-      return _Buffer.from([value === true ? 1 : 0]);
-    case FIELD_TYPES.binary:
-      return decode(value);
-    case FIELD_TYPES.stateTree:
-      return decode(value);
-    case FIELD_TYPES.hex:
-      return _Buffer.from(value, 'hex');
-    case FIELD_TYPES.signatures:
-      return value.map(_Buffer.from);
-    case FIELD_TYPES.payload:
-      return typeof value === 'string' && value.split('_')[0] === 'ba' ? decode(value) : toBytes(value);
-    case FIELD_TYPES.string:
-      return toBytes(value);
-    case FIELD_TYPES.rlpBinary:
-      return (_value$rlpEncoded = value.rlpEncoded) !== null && _value$rlpEncoded !== void 0 ? _value$rlpEncoded : value;
-    case FIELD_TYPES.mptrees:
-      return value.map(t => t.serialize());
-    case FIELD_TYPES.ctVersion:
-      return _Buffer.from([...toBytes(value.vmVersion), 0, ...toBytes(value.abiVersion)]);
-    default:
-      if (typeof type === 'number') return value;
-      return type.serialize(value, params);
-  }
-}
-function validateField(value, type) {
-  // All fields are required
-  if (value == null) return 'Field is required';
-
-  // Validate type of value
-  switch (type) {
-    case FIELD_TYPES.ctVersion:
-      if (!(Boolean(value.abiVersion) && Boolean(value.vmVersion))) {
-        return 'Value must be an object with "vmVersion" and "abiVersion" fields';
-      }
-      return undefined;
-    default:
-      return undefined;
-  }
-}
-
-/**
- * Validate transaction params
- * @category transaction builder
- * @param params - Object with tx params
- * @param schema - Transaction schema
- * @param excludeKeys - Array of keys to exclude for validation
- * @returns Object with validation errors
- */
-function validateParams(params, schema, _ref2) {
-  let {
-    excludeKeys = []
-  } = _ref2;
-  const optionalFields = ['payload', 'nameFee', 'deposit', 'gasPrice', 'fee', 'gasLimit', 'amount'];
-  return Object.fromEntries(schema
-  // TODO: allow optional keys in schema
-  .filter(_ref3 => {
-    let [key] = _ref3;
-    return !excludeKeys.includes(key) && !optionalFields.includes(key);
-  }).map(_ref4 => {
-    let [key, type] = _ref4;
-    return [key, validateField(params[key], type)];
-  }).filter(_ref5 => {
-    let [, message] = _ref5;
-    return message;
-  }));
-}
-
 /**
  * Unpack binary transaction
  * @category transaction builder
@@ -156,25 +22,27 @@ function validateParams(params, schema, _ref2) {
  * @returns Object with transaction field's
  */
 function unpackRawTx(binary, schema) {
-  return schema.reduce((acc, _ref6, index) => {
-    let [key, fieldType, prefix] = _ref6;
-    return Object.assign(acc, {
-      [key]: deserializeField(binary[index], fieldType, prefix)
+  if (binary.length !== schema.length) {
+    throw new ArgumentError('Transaction RLP length', schema.length, binary.length);
+  }
+  return schema.reduce((acc, _ref, index) => {
+    let [name, field] = _ref;
+    // eslint-disable-next-line @typescript-eslint/no-use-before-define
+    const deserialized = field.deserialize(binary[index], {
+      unpackTx
     });
+    return {
+      ...acc,
+      [name]: deserialized
+    };
   }, {});
 }
 
-/**
- * @category transaction builder
- */
-
 /**
  * Build transaction hash
  * @category transaction builder
- * @param _params - Object with tx params
- * @param type - Transaction type
+ * @param params - Object with tx params
  * @param options - options
- * @param options.excludeKeys - Array of keys to exclude for validation and build
  * @param options.denomination - Denomination of amounts
  * @param options.prefix - Prefix of transaction
  * @throws {@link InvalidTxParamsError}
@@ -183,63 +51,38 @@ function unpackRawTx(binary, schema) {
  * @returns object.rlpEncoded rlp encoded transaction
  * @returns object.binary binary transaction
  */
-export function buildTx(_params, type) {
-  var _vsn;
+export function buildTx(params) {
+  var _params$version;
   let {
-    excludeKeys = [],
-    prefix = Encoding.Transaction,
-    vsn,
+    prefix,
     denomination = AE_AMOUNT_FORMATS.AETTOS
-  } = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
-  const schemas = TX_SCHEMA[type];
-  (_vsn = vsn) !== null && _vsn !== void 0 ? _vsn : vsn = Math.max(...Object.keys(schemas).map(a => +a));
-  if (!isKeyOfObject(vsn, schemas)) throw new SchemaNotFoundError('serialization', Tag[type], vsn);
-  const schema = schemas[vsn];
-  const params = _params;
-  params.VSN = vsn;
-  params.tag = type;
-  params.denomination = denomination;
-  const filteredSchema = schema.filter(_ref7 => {
-    let [key] = _ref7;
-    return !excludeKeys.includes(key);
-  });
-
-  // Validation
-  const valid = validateParams(params, schema, {
-    excludeKeys
-  });
-  if (Object.keys(valid).length > 0) {
-    throw new InvalidTxParamsError(`Transaction build error. ${JSON.stringify(valid)}`);
+  } = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  const schemas = TX_SCHEMA[params.tag];
+  (_params$version = params.version) !== null && _params$version !== void 0 ? _params$version : params.version = Math.max(...Object.keys(schemas).map(a => +a));
+  if (!isKeyOfObject(params.version, schemas)) {
+    throw new SchemaNotFoundError('serialization', Tag[params.tag], params.version);
   }
-  const binary = filteredSchema.map(_ref8 => {
-    let [key, fieldType] = _ref8;
-    return serializeField(params[key], fieldType, {
+  const schema = schemas[params.version];
+  const binary = schema.map(_ref2 => {
+    let [key, field] = _ref2;
+    return field.serialize(params[key], {
       ...params,
-      txType: type,
+      // eslint-disable-next-line @typescript-eslint/no-use-before-define
+      unpackTx,
+      buildTx,
+      denomination,
       rebuildTx: overrideParams => buildTx({
         ...params,
         ...overrideParams
-      }, type, {
-        excludeKeys,
-        prefix: Encoding.Transaction,
-        vsn,
+      }, {
         denomination
       })
     });
-  }).filter(e => e !== undefined);
-  const rlpEncoded = rlpEncode(binary);
-  const tx = encode(rlpEncoded, prefix);
-  return {
-    tx,
-    rlpEncoded,
-    binary,
-    txObject: unpackRawTx(binary, schema)
-  };
-}
+  });
 
-/**
- * @category transaction builder
- */
+  // @ts-expect-error looks like a TypeScript edge case
+  return encode(rlpEncode(binary), prefix !== null && prefix !== void 0 ? prefix : Encoding.Transaction);
+}
 
 /**
  * Unpack transaction hash
@@ -251,19 +94,14 @@ export function buildTx(_params, type) {
  * @returns object.txType Transaction type
  */
 export function unpackTx(encodedTx, txType) {
-  const rlpEncoded = decode(encodedTx);
-  const binary = rlpDecode(rlpEncoded);
-  const objId = +readInt(binary[0]);
-  if (!isKeyOfObject(objId, TX_SCHEMA)) throw new DecodeError(`Unknown transaction tag: ${objId}`);
-  if (txType != null && txType !== objId) throw new DecodeError(`Expected transaction to have ${Tag[txType]} tag, got ${Tag[objId]} instead`);
-  const vsn = +readInt(binary[1]);
-  if (!isKeyOfObject(vsn, TX_SCHEMA[objId])) throw new SchemaNotFoundError('deserialization', `tag ${objId}`, vsn);
-  const schema = TX_SCHEMA[objId][vsn];
-  return {
-    txType: objId,
-    tx: unpackRawTx(binary, schema),
-    rlpEncoded
-  };
+  const binary = rlpDecode(decode(encodedTx));
+  const tag = +readInt(binary[0]);
+  if (!isKeyOfObject(tag, TX_SCHEMA)) throw new DecodeError(`Unknown transaction tag: ${tag}`);
+  if (txType != null && txType !== tag) throw new DecodeError(`Expected transaction to have ${Tag[txType]} tag, got ${Tag[tag]} instead`);
+  const version = +readInt(binary[1]);
+  if (!isKeyOfObject(version, TX_SCHEMA[tag])) throw new SchemaNotFoundError('deserialization', `tag ${tag}`, version);
+  const schema = TX_SCHEMA[tag][version];
+  return unpackRawTx(binary, schema);
 }
 
 /**
@@ -285,12 +123,13 @@ export function buildTxHash(rawTx) {
  */
 export function buildContractIdByContractTx(contractTx) {
   const {
-    txType,
-    tx
+    tag,
+    ownerId,
+    nonce
   } = unpackTx(contractTx);
-  if (![Tag.ContractCreateTx, Tag.GaAttachTx].includes(txType)) {
-    throw new ArgumentError('contractCreateTx', 'a contractCreateTx or gaAttach', txType);
+  if (![Tag.ContractCreateTx, Tag.GaAttachTx].includes(tag)) {
+    throw new ArgumentError('contractCreateTx', 'a contractCreateTx or gaAttach', tag);
   }
-  return buildContractId(tx.ownerId, +tx.nonce);
+  return buildContractId(ownerId, +nonce);
 }
 //# sourceMappingURL=index.mjs.map

package/es/tx/builder/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["decode","encode","Encoding","AE_AMOUNT_FORMATS","hash","FIELD_TYPES","TX_SCHEMA","Tag","buildContractId","readInt","toBytes","MPTree","ArgumentError","DecodeError","InvalidTxParamsError","SchemaNotFoundError","isKeyOfObject","deserializeField","value","type","prefix","ctVersion","vm","abi","vmVersion","from","abiVersion","bool","binary","stateTree","StateTrees","string","toString","payload","Bytearray","rlpBinary","unpackTx","Transaction","rlpBinaries","map","v","rawBinary","hex","offChainUpdates","callStack","mptrees","t","sophiaCodeTypeInfo","reduce","acc","funHash","fnName","argType","outType","deserialize","serializeField","params","signatures","split","rlpEncoded","serialize","validateField","Boolean","undefined","validateParams","schema","excludeKeys","optionalFields","Object","fromEntries","filter","key","includes","message","unpackRawTx","index","fieldType","assign","buildTx","_params","vsn","denomination","AETTOS","schemas","Math","max","keys","a","VSN","tag","filteredSchema","valid","length","JSON","stringify","txType","rebuildTx","overrideParams","e","rlpEncode","tx","txObject","encodedTx","rlpDecode","objId","buildTxHash","rawTx","data","startsWith","TxHash","buildContractIdByContractTx","contractTx","ContractCreateTx","GaAttachTx","ownerId","nonce"],"sources":["../../../src/tx/builder/index.ts"],"sourcesContent":["import { decode as rlpDecode, encode as rlpEncode, NestedUint8Array } from 'rlp';\nimport {\n  decode, encode, Encoded, Encoding,\n} from '../../utils/encoder';\nimport { AE_AMOUNT_FORMATS } from '../../utils/amount-formatter';\nimport { hash } from '../../utils/crypto';\nimport { Field } from './field-types';\nimport {\n  FIELD_TYPES,\n  RawTxObject,\n  TX_SCHEMA,\n  TxField,\n  TxParamsCommon,\n  TxSchema,\n  TxTypeSchemas,\n} from './schema';\nimport { Tag } from './constants';\nimport { buildContractId, readInt } from './helpers';\nimport { toBytes } from '../../utils/bytes';\nimport MPTree, { MPTreeBinary } from '../../utils/mptree';\nimport {\n  ArgumentError,\n  DecodeError,\n  InvalidTxParamsError,\n  SchemaNotFoundError,\n} from '../../utils/errors';\nimport { isKeyOfObject } from '../../utils/other';\n\n/**\n * JavaScript-based Transaction builder\n */\n\n// SERIALIZE AND DESERIALIZE PART\nfunction deserializeField(\n  value: any,\n  type: FIELD_TYPES | Field,\n  prefix?: Encoding | Encoding[],\n): any {\n  if (value == null) return '';\n  switch (type) {\n    case FIELD_TYPES.ctVersion: {\n      const [vm, , abi] = value;\n      return {\n        vmVersion: readInt(Buffer.from([vm])),\n        abiVersion: readInt(Buffer.from([abi])),\n      };\n    }\n    case FIELD_TYPES.bool:\n      return value[0] === 1;\n    case FIELD_TYPES.binary:\n      return encode(value, prefix as Encoding);\n    case FIELD_TYPES.stateTree:\n      return encode(value, Encoding.StateTrees);\n    case FIELD_TYPES.string:\n      return value.toString();\n    case FIELD_TYPES.payload:\n      return encode(value, Encoding.Bytearray);\n    case FIELD_TYPES.rlpBinary:\n      // eslint-disable-next-line @typescript-eslint/no-use-before-define\n      return unpackTx(encode(value, Encoding.Transaction));\n    case FIELD_TYPES.rlpBinaries:\n      // eslint-disable-next-line @typescript-eslint/no-use-before-define\n      return value.map((v: Buffer) => unpackTx(encode(v, Encoding.Transaction)));\n    case FIELD_TYPES.rawBinary:\n      return value;\n    case FIELD_TYPES.hex:\n      return value.toString('hex');\n    case FIELD_TYPES.offChainUpdates:\n      // eslint-disable-next-line @typescript-eslint/no-use-before-define\n      return value.map((v: Buffer) => unpackTx(encode(v, Encoding.Transaction)));\n    case FIELD_TYPES.callStack:\n      // TODO: fix this\n      return [readInt(value)];\n    case FIELD_TYPES.mptrees:\n      return value.map((t: MPTreeBinary) => new MPTree(t));\n    case FIELD_TYPES.sophiaCodeTypeInfo:\n      return value.reduce(\n        (acc: object, [funHash, fnName, argType, outType]: [\n          funHash: Buffer,\n          fnName: string,\n          argType: string,\n          outType: string,\n        ]) => ({\n          ...acc,\n          [fnName.toString()]: { funHash, argType, outType },\n        }),\n        {},\n      );\n    default:\n      if (typeof type === 'number') return value;\n      return type.deserialize(value);\n  }\n}\n\nfunction serializeField(value: any, type: FIELD_TYPES | Field, params: any): any {\n  switch (type) {\n    case FIELD_TYPES.bool:\n      return Buffer.from([(value === true) ? 1 : 0]);\n    case FIELD_TYPES.binary:\n      return decode(value);\n    case FIELD_TYPES.stateTree:\n      return decode(value);\n    case FIELD_TYPES.hex:\n      return Buffer.from(value, 'hex');\n    case FIELD_TYPES.signatures:\n      return value.map(Buffer.from);\n    case FIELD_TYPES.payload:\n      return typeof value === 'string' && value.split('_')[0] === 'ba'\n        ? decode(value as Encoded.Bytearray)\n        : toBytes(value);\n    case FIELD_TYPES.string:\n      return toBytes(value);\n    case FIELD_TYPES.rlpBinary:\n      return value.rlpEncoded ?? value;\n    case FIELD_TYPES.mptrees:\n      return value.map((t: MPTree) => t.serialize());\n    case FIELD_TYPES.ctVersion:\n      return Buffer.from([...toBytes(value.vmVersion), 0, ...toBytes(value.abiVersion)]);\n    default:\n      if (typeof type === 'number') return value;\n      return type.serialize(value, params);\n  }\n}\n\nfunction validateField(\n  value: any,\n  type: FIELD_TYPES | Field,\n): string | undefined {\n  // All fields are required\n  if (value == null) return 'Field is required';\n\n  // Validate type of value\n  switch (type) {\n    case FIELD_TYPES.ctVersion:\n      if (!(Boolean(value.abiVersion) && Boolean(value.vmVersion))) {\n        return 'Value must be an object with \"vmVersion\" and \"abiVersion\" fields';\n      }\n      return undefined;\n    default:\n      return undefined;\n  }\n}\n\n/**\n * Validate transaction params\n * @category transaction builder\n * @param params - Object with tx params\n * @param schema - Transaction schema\n * @param excludeKeys - Array of keys to exclude for validation\n * @returns Object with validation errors\n */\nfunction validateParams(\n  params: any,\n  schema: TxField[],\n  { excludeKeys = [] }: { excludeKeys: string[] },\n): object {\n  const optionalFields = ['payload', 'nameFee', 'deposit', 'gasPrice', 'fee', 'gasLimit', 'amount'];\n  return Object.fromEntries(\n    schema\n      // TODO: allow optional keys in schema\n      .filter(([key]) => !excludeKeys.includes(key) && !optionalFields.includes(key))\n      .map(([key, type]) => [key, validateField(params[key], type)])\n      .filter(([, message]) => message),\n  );\n}\n\n/**\n * Unpack binary transaction\n * @category transaction builder\n * @param binary - Array with binary transaction field's\n * @param schema - Transaction schema\n * @returns Object with transaction field's\n */\nfunction unpackRawTx<Tx extends TxSchema>(\n  binary: Uint8Array | NestedUint8Array,\n  schema: TxField[],\n): RawTxObject<Tx> {\n  return schema\n    .reduce<any>(\n    (\n      acc,\n      [key, fieldType, prefix],\n      index,\n    ) => Object.assign(acc, { [key]: deserializeField(binary[index], fieldType, prefix) }),\n    {},\n  );\n}\n\n/**\n * @category transaction builder\n */\nexport interface BuiltTx<Tx extends TxSchema, Prefix extends Encoding> {\n  tx: Encoded.Generic<Prefix>;\n  rlpEncoded: Uint8Array;\n  binary: Uint8Array;\n  txObject: RawTxObject<Tx>;\n}\n\n/**\n * Build transaction hash\n * @category transaction builder\n * @param _params - Object with tx params\n * @param type - Transaction type\n * @param options - options\n * @param options.excludeKeys - Array of keys to exclude for validation and build\n * @param options.denomination - Denomination of amounts\n * @param options.prefix - Prefix of transaction\n * @throws {@link InvalidTxParamsError}\n * @returns object\n * @returns object.tx Base64Check transaction hash with 'tx_' prefix\n * @returns object.rlpEncoded rlp encoded transaction\n * @returns object.binary binary transaction\n */\nexport function buildTx<TxType extends Tag, Prefix>(\n  _params: Omit<TxTypeSchemas[TxType], 'tag' | 'VSN'> & { VSN?: number },\n  type: TxType,\n  {\n    excludeKeys = [],\n    prefix = Encoding.Transaction,\n    vsn,\n    denomination = AE_AMOUNT_FORMATS.AETTOS,\n  }: {\n    excludeKeys?: string[];\n    prefix?: Encoding;\n    vsn?: number;\n    denomination?: AE_AMOUNT_FORMATS;\n  } = {},\n): BuiltTx<TxSchema, Prefix extends Encoding ? Prefix : Encoding.Transaction> {\n  const schemas = TX_SCHEMA[type];\n\n  vsn ??= Math.max(...Object.keys(schemas).map((a) => +a));\n  if (!isKeyOfObject(vsn, schemas)) throw new SchemaNotFoundError('serialization', Tag[type], vsn);\n\n  const schema = schemas[vsn] as unknown as TxField[];\n\n  const params = _params as TxParamsCommon & { onNode: Node; denomination?: AE_AMOUNT_FORMATS };\n  params.VSN = vsn;\n  params.tag = type;\n  params.denomination = denomination;\n  const filteredSchema = schema.filter(([key]) => !excludeKeys.includes(key));\n\n  // Validation\n  const valid = validateParams(params, schema, { excludeKeys });\n  if (Object.keys(valid).length > 0) {\n    throw new InvalidTxParamsError(`Transaction build error. ${JSON.stringify(valid)}`);\n  }\n\n  const binary = filteredSchema\n    .map(([key, fieldType]: [keyof TxSchema, FIELD_TYPES, Encoding]) => (\n      serializeField(\n        params[key],\n        fieldType,\n        {\n          ...params,\n          txType: type,\n          rebuildTx: (overrideParams: any) => buildTx(\n            { ...params, ...overrideParams },\n            type,\n            {\n              excludeKeys, prefix: Encoding.Transaction, vsn, denomination,\n            },\n          ),\n        },\n      )\n    ))\n    .filter((e) => e !== undefined);\n\n  const rlpEncoded = rlpEncode(binary);\n  const tx = encode(rlpEncoded, prefix);\n  return {\n    tx,\n    rlpEncoded,\n    binary,\n    txObject: unpackRawTx<TxTypeSchemas[Tag]>(binary, schema),\n  } as any;\n}\n\n/**\n * @category transaction builder\n */\nexport interface TxUnpacked<Tx extends TxSchema> {\n  txType: Tag;\n  tx: RawTxObject<Tx>;\n  rlpEncoded: Uint8Array;\n}\n/**\n * Unpack transaction hash\n * @category transaction builder\n * @param encodedTx - Transaction to unpack\n * @param txType - Expected transaction type\n * @returns object\n * @returns object.tx Object with transaction param's\n * @returns object.txType Transaction type\n */\nexport function unpackTx<TxType extends Tag>(\n  encodedTx: Encoded.Transaction | Encoded.Poi,\n  txType?: TxType,\n): TxUnpacked<TxTypeSchemas[TxType]> {\n  const rlpEncoded = decode(encodedTx);\n  const binary = rlpDecode(rlpEncoded);\n  const objId = +readInt(binary[0] as Buffer);\n  if (!isKeyOfObject(objId, TX_SCHEMA)) throw new DecodeError(`Unknown transaction tag: ${objId}`);\n  if (txType != null && txType !== objId) throw new DecodeError(`Expected transaction to have ${Tag[txType]} tag, got ${Tag[objId]} instead`);\n  const vsn = +readInt(binary[1] as Buffer);\n  if (!isKeyOfObject(vsn, TX_SCHEMA[objId])) throw new SchemaNotFoundError('deserialization', `tag ${objId}`, vsn);\n  const schema = TX_SCHEMA[objId][vsn];\n  return {\n    txType: objId,\n    tx: unpackRawTx<TxTypeSchemas[TxType]>(binary, schema),\n    rlpEncoded,\n  };\n}\n\n/**\n * Build a transaction hash\n * @category transaction builder\n * @param rawTx - base64 or rlp encoded transaction\n * @returns Transaction hash\n */\nexport function buildTxHash(rawTx: Encoded.Transaction | Uint8Array): Encoded.TxHash {\n  const data = typeof rawTx === 'string' && rawTx.startsWith('tx_')\n    ? decode(rawTx)\n    : rawTx;\n  return encode(hash(data), Encoding.TxHash);\n}\n\n/**\n * Build a contract public key by contractCreateTx or gaAttach\n * @category contract\n * @param contractTx - Transaction\n * @returns Contract public key\n */\nexport function buildContractIdByContractTx(\n  contractTx: Encoded.Transaction,\n): Encoded.ContractAddress {\n  const { txType, tx } = unpackTx<Tag.ContractCreateTx | Tag.GaAttachTx>(contractTx);\n  if (![Tag.ContractCreateTx, Tag.GaAttachTx].includes(txType)) {\n    throw new ArgumentError('contractCreateTx', 'a contractCreateTx or gaAttach', txType);\n  }\n  return buildContractId(tx.ownerId, +tx.nonce);\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["decode","encode","Encoding","AE_AMOUNT_FORMATS","hash","TX_SCHEMA","Tag","buildContractId","readInt","ArgumentError","DecodeError","SchemaNotFoundError","isKeyOfObject","unpackRawTx","binary","schema","length","reduce","acc","index","name","field","deserialized","deserialize","unpackTx","buildTx","params","prefix","denomination","AETTOS","schemas","tag","version","Math","max","Object","keys","map","a","key","serialize","rebuildTx","overrideParams","rlpEncode","Transaction","encodedTx","txType","rlpDecode","buildTxHash","rawTx","data","startsWith","TxHash","buildContractIdByContractTx","contractTx","ownerId","nonce","ContractCreateTx","GaAttachTx","includes"],"sources":["../../../src/tx/builder/index.ts"],"sourcesContent":["import { decode as rlpDecode, encode as rlpEncode, NestedUint8Array } from 'rlp';\nimport {\n  decode, encode, Encoded, Encoding,\n} from '../../utils/encoder';\nimport { AE_AMOUNT_FORMATS } from '../../utils/amount-formatter';\nimport { hash } from '../../utils/crypto';\nimport { BinaryData, Field } from './field-types';\nimport {\n  RawTxObject, TX_SCHEMA, TxField, TxSchema, TxTypeSchemas,\n} from './schema';\nimport { Tag } from './constants';\nimport { buildContractId, readInt } from './helpers';\nimport { ArgumentError, DecodeError, SchemaNotFoundError } from '../../utils/errors';\nimport { isKeyOfObject } from '../../utils/other';\n\n/**\n * JavaScript-based Transaction builder\n */\n\n/**\n * Unpack binary transaction\n * @category transaction builder\n * @param binary - Array with binary transaction field's\n * @param schema - Transaction schema\n * @returns Object with transaction field's\n */\nfunction unpackRawTx<Tx extends TxSchema>(\n  binary: Uint8Array | NestedUint8Array,\n  schema: TxField[],\n): RawTxObject<Tx> {\n  if (binary.length !== schema.length) {\n    throw new ArgumentError('Transaction RLP length', schema.length, binary.length);\n  }\n  return schema\n    .reduce<any>(\n    (\n      acc,\n      [name, field],\n      index,\n    ) => {\n      // eslint-disable-next-line @typescript-eslint/no-use-before-define\n      const deserialized = field.deserialize(binary[index] as BinaryData, { unpackTx });\n      return { ...acc, [name]: deserialized };\n    },\n    {},\n  );\n}\n\n/**\n * Build transaction hash\n * @category transaction builder\n * @param params - Object with tx params\n * @param options - options\n * @param options.denomination - Denomination of amounts\n * @param options.prefix - Prefix of transaction\n * @throws {@link InvalidTxParamsError}\n * @returns object\n * @returns object.tx Base64Check transaction hash with 'tx_' prefix\n * @returns object.rlpEncoded rlp encoded transaction\n * @returns object.binary binary transaction\n */\nexport function buildTx<\n  TxType extends Tag,\n  E extends Encoding = Encoding.Transaction,\n>(\n  params: { tag: TxType; version?: number } & Omit<TxTypeSchemas[TxType], 'tag' | 'version'>\n  // TODO: get it from gas-limit.ts somehow\n  & (TxType extends Tag.ContractCreateTx | Tag.ContractCallTx\n  | Tag.ChannelOffChainUpdateCallContract | Tag.GaAttachTx | Tag.GaMetaTx\n    ? { gasMax?: number } : {}),\n  {\n    prefix,\n    denomination = AE_AMOUNT_FORMATS.AETTOS,\n  }: {\n    prefix?: E;\n    denomination?: AE_AMOUNT_FORMATS;\n  } = {},\n): Encoded.Generic<E> {\n  const schemas = TX_SCHEMA[params.tag];\n  params.version ??= Math.max(...Object.keys(schemas).map((a) => +a));\n  if (!isKeyOfObject(params.version, schemas)) {\n    throw new SchemaNotFoundError('serialization', Tag[params.tag], params.version);\n  }\n  const schema = schemas[params.version] as unknown as TxField[];\n\n  const binary = schema.map(([key, field]: [keyof TxSchema, Field]) => (\n    field.serialize(\n      params[key],\n      {\n        ...params,\n        // eslint-disable-next-line @typescript-eslint/no-use-before-define\n        unpackTx,\n        buildTx,\n        denomination,\n        rebuildTx: (overrideParams: any) => buildTx(\n          { ...params, ...overrideParams },\n          { denomination },\n        ),\n      },\n    )\n  ));\n\n  // @ts-expect-error looks like a TypeScript edge case\n  return encode(rlpEncode(binary), prefix ?? Encoding.Transaction);\n}\n\n/**\n * Unpack transaction hash\n * @category transaction builder\n * @param encodedTx - Transaction to unpack\n * @param txType - Expected transaction type\n * @returns object\n * @returns object.tx Object with transaction param's\n * @returns object.txType Transaction type\n */\nexport function unpackTx<TxType extends Tag>(\n  encodedTx: Encoded.Transaction | Encoded.Poi,\n  txType?: TxType,\n): RawTxObject<TxTypeSchemas[TxType]> {\n  const binary = rlpDecode(decode(encodedTx));\n  const tag = +readInt(binary[0] as Buffer);\n  if (!isKeyOfObject(tag, TX_SCHEMA)) throw new DecodeError(`Unknown transaction tag: ${tag}`);\n  if (txType != null && txType !== tag) throw new DecodeError(`Expected transaction to have ${Tag[txType]} tag, got ${Tag[tag]} instead`);\n  const version = +readInt(binary[1] as Buffer);\n  if (!isKeyOfObject(version, TX_SCHEMA[tag])) throw new SchemaNotFoundError('deserialization', `tag ${tag}`, version);\n  const schema = TX_SCHEMA[tag][version];\n  return unpackRawTx<TxTypeSchemas[TxType]>(binary, schema);\n}\n\n/**\n * Build a transaction hash\n * @category transaction builder\n * @param rawTx - base64 or rlp encoded transaction\n * @returns Transaction hash\n */\nexport function buildTxHash(rawTx: Encoded.Transaction | Uint8Array): Encoded.TxHash {\n  const data = typeof rawTx === 'string' && rawTx.startsWith('tx_')\n    ? decode(rawTx)\n    : rawTx;\n  return encode(hash(data), Encoding.TxHash);\n}\n\n/**\n * Build a contract public key by contractCreateTx or gaAttach\n * @category contract\n * @param contractTx - Transaction\n * @returns Contract public key\n */\nexport function buildContractIdByContractTx(\n  contractTx: Encoded.Transaction,\n): Encoded.ContractAddress {\n  const { tag, ownerId, nonce } = unpackTx<Tag.ContractCreateTx | Tag.GaAttachTx>(contractTx);\n  if (![Tag.ContractCreateTx, Tag.GaAttachTx].includes(tag)) {\n    throw new ArgumentError('contractCreateTx', 'a contractCreateTx or gaAttach', tag);\n  }\n  return buildContractId(ownerId, +nonce);\n}\n"],"mappings":"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"}