@aeternity/aepp-sdk 13.3.3 → 14.1.0

package/es/tx/builder/field-types/short-u-int-const.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 export default function genShortUIntConstField<Value extends number, Optional extends boolean = false>(constValue: Value, optional?: Optional): {
     serialize: Optional extends true ? (value?: Value) => Buffer : (value: Value) => Buffer;
     deserialize: (value: Buffer) => Value;

package/es/tx/builder/field-types/short-u-int-const.js

@@ -0,0 +1,20 @@
+import { ArgumentError } from '../../../utils/errors.js';
+import shortUInt from './short-u-int.js';
+export default function genShortUIntConstField(constValue, optional) {
+  return {
+    serialize(value) {
+      if ((optional !== true || value != null) && value !== constValue) {
+        throw new ArgumentError('ShortUIntConst', constValue, value);
+      }
+      return shortUInt.serialize(constValue);
+    },
+    deserialize(buf) {
+      const value = shortUInt.deserialize(buf);
+      if (value !== constValue) throw new ArgumentError('ShortUIntConst', constValue, value);
+      return constValue;
+    },
+    constValue,
+    constValueOptional: optional === true
+  };
+}
+//# sourceMappingURL=short-u-int-const.js.map

package/es/tx/builder/field-types/short-u-int-const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"short-u-int-const.js","names":["ArgumentError","shortUInt","genShortUIntConstField","constValue","optional","serialize","value","deserialize","buf","constValueOptional"],"sources":["../../../../src/tx/builder/field-types/short-u-int-const.ts"],"sourcesContent":["import { ArgumentError } from '../../../utils/errors.js';\nimport shortUInt from './short-u-int.js';\n\nexport default function genShortUIntConstField<\n  Value extends number,\n  Optional extends boolean = false,\n>(\n  constValue: Value,\n  optional?: Optional,\n): {\n  serialize: Optional extends true ? (value?: Value) => Buffer : (value: Value) => Buffer;\n  deserialize: (value: Buffer) => Value;\n  constValue: Value;\n  constValueOptional: boolean;\n} {\n  return {\n    serialize(value?: Value) {\n      if ((optional !== true || value != null) && value !== constValue) {\n        throw new ArgumentError('ShortUIntConst', constValue, value);\n      }\n      return shortUInt.serialize(constValue);\n    },\n\n    deserialize(buf) {\n      const value = shortUInt.deserialize(buf);\n      if (value !== constValue) throw new ArgumentError('ShortUIntConst', constValue, value);\n      return constValue;\n    },\n\n    constValue,\n\n    constValueOptional: optional === true,\n  };\n}\n"],"mappings":"AAAA,SAASA,aAAa,QAAQ,0BAA0B;AACxD,OAAOC,SAAS,MAAM,kBAAkB;AAExC,eAAe,SAASC,sBAAsBA,CAI5CC,UAAiB,EACjBC,QAAmB,EAMnB;EACA,OAAO;IACLC,SAASA,CAACC,KAAa,EAAE;MACvB,IAAI,CAACF,QAAQ,KAAK,IAAI,IAAIE,KAAK,IAAI,IAAI,KAAKA,KAAK,KAAKH,UAAU,EAAE;QAChE,MAAM,IAAIH,aAAa,CAAC,gBAAgB,EAAEG,UAAU,EAAEG,KAAK,CAAC;MAC9D;MACA,OAAOL,SAAS,CAACI,SAAS,CAACF,UAAU,CAAC;IACxC,CAAC;IAEDI,WAAWA,CAACC,GAAG,EAAE;MACf,MAAMF,KAAK,GAAGL,SAAS,CAACM,WAAW,CAACC,GAAG,CAAC;MACxC,IAAIF,KAAK,KAAKH,UAAU,EAAE,MAAM,IAAIH,aAAa,CAAC,gBAAgB,EAAEG,UAAU,EAAEG,KAAK,CAAC;MACtF,OAAOH,UAAU;IACnB,CAAC;IAEDA,UAAU;IAEVM,kBAAkB,EAAEL,QAAQ,KAAK;EACnC,CAAC;AACH","ignoreList":[]}

package/es/tx/builder/field-types/short-u-int.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 declare const _default: {
     serialize(value: number): Buffer;
     deserialize(value: Buffer): number;

package/es/tx/builder/field-types/short-u-int.js

@@ -0,0 +1,10 @@
+import uInt from './u-int.js';
+export default {
+  serialize(value) {
+    return uInt.serialize(value);
+  },
+  deserialize(value) {
+    return +uInt.deserialize(value);
+  }
+};
+//# sourceMappingURL=short-u-int.js.map

package/es/tx/builder/field-types/short-u-int.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"short-u-int.js","names":["uInt","serialize","value","deserialize"],"sources":["../../../../src/tx/builder/field-types/short-u-int.ts"],"sourcesContent":["import uInt from './u-int.js';\n\nexport default {\n  serialize(value: number): Buffer {\n    return uInt.serialize(value);\n  },\n\n  deserialize(value: Buffer): number {\n    return +uInt.deserialize(value);\n  },\n};\n"],"mappings":"AAAA,OAAOA,IAAI,MAAM,YAAY;AAE7B,eAAe;EACbC,SAASA,CAACC,KAAa,EAAU;IAC/B,OAAOF,IAAI,CAACC,SAAS,CAACC,KAAK,CAAC;EAC9B,CAAC;EAEDC,WAAWA,CAACD,KAAa,EAAU;IACjC,OAAO,CAACF,IAAI,CAACG,WAAW,CAACD,KAAK,CAAC;EACjC;AACF,CAAC","ignoreList":[]}

package/es/tx/builder/field-types/string.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 declare const _default: {
     serialize(string: string): Buffer;
     deserialize(buffer: Buffer): string;

package/es/tx/builder/field-types/string.js

@@ -0,0 +1,10 @@
+import { toBytes } from '../../../utils/bytes.js';
+export default {
+  serialize(string) {
+    return toBytes(string);
+  },
+  deserialize(buffer) {
+    return buffer.toString();
+  }
+};
+//# sourceMappingURL=string.js.map

package/es/tx/builder/field-types/string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.js","names":["toBytes","serialize","string","deserialize","buffer","toString"],"sources":["../../../../src/tx/builder/field-types/string.ts"],"sourcesContent":["import { toBytes } from '../../../utils/bytes.js';\n\nexport default {\n  serialize(string: string): Buffer {\n    return toBytes(string);\n  },\n\n  deserialize(buffer: Buffer): string {\n    return buffer.toString();\n  },\n};\n"],"mappings":"AAAA,SAASA,OAAO,QAAQ,yBAAyB;AAEjD,eAAe;EACbC,SAASA,CAACC,MAAc,EAAU;IAChC,OAAOF,OAAO,CAACE,MAAM,CAAC;EACxB,CAAC;EAEDC,WAAWA,CAACC,MAAc,EAAU;IAClC,OAAOA,MAAM,CAACC,QAAQ,CAAC,CAAC;EAC1B;AACF,CAAC","ignoreList":[]}

package/es/tx/builder/field-types/transaction.d.ts

@@ -0,0 +1,10 @@
+import { Tag } from '../constants.js';
+import type { unpackTx as unpackTxType, buildTx as buildTxType } from '../index.js';
+export default function genTransactionField<T extends Tag = Tag>(tag?: T): {
+    serialize: (value: any, options: {
+        buildTx: typeof buildTxType;
+    }) => Buffer;
+    deserialize: (value: Buffer, options: {
+        unpackTx: typeof unpackTxType;
+    }) => any;
+};

package/es/tx/builder/field-types/transaction.js

@@ -0,0 +1,26 @@
+import { Buffer as _Buffer } from "buffer";
+import { decode, encode, Encoding } from '../../../utils/encoder.js';
+export default function genTransactionField(tag) {
+  return {
+    serialize(txParams, {
+      buildTx
+    }) {
+      if (ArrayBuffer.isView(txParams)) return _Buffer.from(txParams);
+      if (typeof txParams === 'string' && txParams.startsWith('tx_')) {
+        return decode(txParams);
+      }
+      return decode(buildTx({
+        ...txParams,
+        ...(tag != null && {
+          tag
+        })
+      }));
+    },
+    deserialize(buf, {
+      unpackTx
+    }) {
+      return unpackTx(encode(buf, Encoding.Transaction), tag);
+    }
+  };
+}
+//# sourceMappingURL=transaction.js.map

package/es/tx/builder/field-types/transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.js","names":["decode","encode","Encoding","genTransactionField","tag","serialize","txParams","buildTx","ArrayBuffer","isView","_Buffer","from","startsWith","deserialize","buf","unpackTx","Transaction"],"sources":["../../../../src/tx/builder/field-types/transaction.ts"],"sourcesContent":["import { decode, encode, Encoded, Encoding } from '../../../utils/encoder.js';\nimport { Tag } from '../constants.js';\nimport type { unpackTx as unpackTxType, buildTx as buildTxType } from '../index.js';\n\nexport default function genTransactionField<T extends Tag = Tag>(\n  tag?: T,\n): {\n  serialize: (\n    // TODO: replace with `TxParams & { tag: T }`,\n    //  but fix TS2502 value is referenced directly or indirectly in its own type annotation\n    value: any,\n    options: { buildTx: typeof buildTxType },\n  ) => Buffer;\n  deserialize: (\n    value: Buffer,\n    options: { unpackTx: typeof unpackTxType },\n    // TODO: replace with `TxUnpacked & { tag: T }`,\n    //  TS2577 Return type annotation circularly references itself\n  ) => any;\n} {\n  return {\n    serialize(txParams, { buildTx }) {\n      if (ArrayBuffer.isView(txParams)) return Buffer.from(txParams as any);\n      if (typeof txParams === 'string' && txParams.startsWith('tx_')) {\n        return decode(txParams as Encoded.Transaction);\n      }\n      return decode(buildTx({ ...txParams, ...(tag != null && { tag }) }));\n    },\n\n    deserialize(buf, { unpackTx }) {\n      return unpackTx(encode(buf, Encoding.Transaction), tag);\n    },\n  };\n}\n"],"mappings":";AAAA,SAASA,MAAM,EAAEC,MAAM,EAAWC,QAAQ,QAAQ,2BAA2B;AAI7E,eAAe,SAASC,mBAAmBA,CACzCC,GAAO,EAcP;EACA,OAAO;IACLC,SAASA,CAACC,QAAQ,EAAE;MAAEC;IAAQ,CAAC,EAAE;MAC/B,IAAIC,WAAW,CAACC,MAAM,CAACH,QAAQ,CAAC,EAAE,OAAOI,OAAA,CAAOC,IAAI,CAACL,QAAe,CAAC;MACrE,IAAI,OAAOA,QAAQ,KAAK,QAAQ,IAAIA,QAAQ,CAACM,UAAU,CAAC,KAAK,CAAC,EAAE;QAC9D,OAAOZ,MAAM,CAACM,QAA+B,CAAC;MAChD;MACA,OAAON,MAAM,CAACO,OAAO,CAAC;QAAE,GAAGD,QAAQ;QAAE,IAAIF,GAAG,IAAI,IAAI,IAAI;UAAEA;QAAI,CAAC;MAAE,CAAC,CAAC,CAAC;IACtE,CAAC;IAEDS,WAAWA,CAACC,GAAG,EAAE;MAAEC;IAAS,CAAC,EAAE;MAC7B,OAAOA,QAAQ,CAACd,MAAM,CAACa,GAAG,EAAEZ,QAAQ,CAACc,WAAW,CAAC,EAAEZ,GAAG,CAAC;IACzD;EACF,CAAC;AACH","ignoreList":[]}

package/es/tx/builder/field-types/ttl.d.ts

@@ -1,20 +1,15 @@
-/// <reference types="node" />
-import Node from '../../../Node';
-import { _getPollInterval } from '../../../chain';
+import Node from '../../../Node.js';
+import { _getPollInterval } from '../../../chain.js';
 /**
  * Time to leave
  */
 declare const _default: {
     serialize(value: number | undefined): Buffer;
     prepare(value: number | undefined, params: {}, { onNode, absoluteTtl, _isInternalBuild, ...options }: {
-        onNode?: Node | undefined;
-        absoluteTtl?: boolean | undefined;
-        _isInternalBuild?: boolean | undefined;
-    } & Omit<{
-        _expectedMineRate?: number | undefined;
-        _microBlockCycle?: number | undefined;
-        onNode: Node;
-    }, "onNode">): Promise<number | undefined>;
+        onNode?: Node;
+        absoluteTtl?: boolean;
+        _isInternalBuild?: boolean;
+    } & Omit<Parameters<typeof _getPollInterval>[1], "onNode">): Promise<number | undefined>;
     deserialize(value: Buffer): number;
 };
 export default _default;

package/es/tx/builder/field-types/ttl.js

@@ -0,0 +1,32 @@
+import shortUInt from './short-u-int.js';
+import { ArgumentError } from '../../../utils/errors.js';
+import { getHeight } from '../../../chain.js';
+
+/**
+ * Time to leave
+ */
+export default {
+  ...shortUInt,
+  serialize(value) {
+    return shortUInt.serialize(value !== null && value !== void 0 ? value : 0);
+  },
+  async prepare(value, params,
+  // TODO: { absoluteTtl: true } | { absoluteTtl: false, onNode: Node }
+  {
+    onNode,
+    absoluteTtl,
+    _isInternalBuild,
+    ...options
+  }) {
+    if (absoluteTtl !== true && value !== 0 && (value != null || _isInternalBuild === true)) {
+      if (onNode == null) throw new ArgumentError('onNode', 'provided', onNode);
+      value = (value !== null && value !== void 0 ? value : 3) + (await getHeight({
+        ...options,
+        onNode,
+        cached: true
+      }));
+    }
+    return value;
+  }
+};
+//# sourceMappingURL=ttl.js.map

package/es/tx/builder/field-types/ttl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ttl.js","names":["shortUInt","ArgumentError","getHeight","serialize","value","prepare","params","onNode","absoluteTtl","_isInternalBuild","options","cached"],"sources":["../../../../src/tx/builder/field-types/ttl.ts"],"sourcesContent":["import shortUInt from './short-u-int.js';\nimport Node from '../../../Node.js';\nimport { ArgumentError } from '../../../utils/errors.js';\nimport { _getPollInterval, getHeight } from '../../../chain.js';\n\n/**\n * Time to leave\n */\nexport default {\n  ...shortUInt,\n\n  serialize(value: number | undefined): Buffer {\n    return shortUInt.serialize(value ?? 0);\n  },\n\n  async prepare(\n    value: number | undefined,\n    params: {},\n    // TODO: { absoluteTtl: true } | { absoluteTtl: false, onNode: Node }\n    {\n      onNode,\n      absoluteTtl,\n      _isInternalBuild,\n      ...options\n    }: {\n      onNode?: Node;\n      absoluteTtl?: boolean;\n      _isInternalBuild?: boolean;\n    } & Omit<Parameters<typeof _getPollInterval>[1], 'onNode'>,\n  ) {\n    if (absoluteTtl !== true && value !== 0 && (value != null || _isInternalBuild === true)) {\n      if (onNode == null) throw new ArgumentError('onNode', 'provided', onNode);\n      value = (value ?? 3) + (await getHeight({ ...options, onNode, cached: true }));\n    }\n    return value;\n  },\n};\n"],"mappings":"AAAA,OAAOA,SAAS,MAAM,kBAAkB;AAExC,SAASC,aAAa,QAAQ,0BAA0B;AACxD,SAA2BC,SAAS,QAAQ,mBAAmB;;AAE/D;AACA;AACA;AACA,eAAe;EACb,GAAGF,SAAS;EAEZG,SAASA,CAACC,KAAyB,EAAU;IAC3C,OAAOJ,SAAS,CAACG,SAAS,CAACC,KAAK,aAALA,KAAK,cAALA,KAAK,GAAI,CAAC,CAAC;EACxC,CAAC;EAED,MAAMC,OAAOA,CACXD,KAAyB,EACzBE,MAAU;EACV;EACA;IACEC,MAAM;IACNC,WAAW;IACXC,gBAAgB;IAChB,GAAGC;EAKoD,CAAC,EAC1D;IACA,IAAIF,WAAW,KAAK,IAAI,IAAIJ,KAAK,KAAK,CAAC,KAAKA,KAAK,IAAI,IAAI,IAAIK,gBAAgB,KAAK,IAAI,CAAC,EAAE;MACvF,IAAIF,MAAM,IAAI,IAAI,EAAE,MAAM,IAAIN,aAAa,CAAC,QAAQ,EAAE,UAAU,EAAEM,MAAM,CAAC;MACzEH,KAAK,GAAG,CAACA,KAAK,aAALA,KAAK,cAALA,KAAK,GAAI,CAAC,KAAK,MAAMF,SAAS,CAAC;QAAE,GAAGQ,OAAO;QAAEH,MAAM;QAAEI,MAAM,EAAE;MAAK,CAAC,CAAC,CAAC;IAChF;IACA,OAAOP,KAAK;EACd;AACF,CAAC","ignoreList":[]}

package/es/tx/builder/field-types/u-int.d.ts

@@ -1,5 +1,4 @@
-/// <reference types="node" />
-import { Int } from '../constants';
+import { Int } from '../constants.js';
 declare const _default: {
     serialize(value: Int): Buffer;
     deserialize(value: Buffer): string;

package/es/tx/builder/field-types/u-int.js

@@ -0,0 +1,13 @@
+import { readInt } from '../helpers.js';
+import { ArgumentError } from '../../../utils/errors.js';
+import { toBytes } from '../../../utils/bytes.js';
+export default {
+  serialize(value) {
+    if (Number(value) < 0) throw new ArgumentError('value', 'greater or equal to 0', value);
+    return toBytes(value, true);
+  },
+  deserialize(value) {
+    return readInt(value);
+  }
+};
+//# sourceMappingURL=u-int.js.map

package/es/tx/builder/field-types/u-int.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"u-int.js","names":["readInt","ArgumentError","toBytes","serialize","value","Number","deserialize"],"sources":["../../../../src/tx/builder/field-types/u-int.ts"],"sourcesContent":["import { readInt } from '../helpers.js';\nimport { Int } from '../constants.js';\nimport { ArgumentError } from '../../../utils/errors.js';\nimport { toBytes } from '../../../utils/bytes.js';\n\nexport default {\n  serialize(value: Int): Buffer {\n    if (Number(value) < 0) throw new ArgumentError('value', 'greater or equal to 0', value);\n    return toBytes(value, true);\n  },\n\n  deserialize(value: Buffer): string {\n    return readInt(value);\n  },\n};\n"],"mappings":"AAAA,SAASA,OAAO,QAAQ,eAAe;AAEvC,SAASC,aAAa,QAAQ,0BAA0B;AACxD,SAASC,OAAO,QAAQ,yBAAyB;AAEjD,eAAe;EACbC,SAASA,CAACC,KAAU,EAAU;IAC5B,IAAIC,MAAM,CAACD,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,IAAIH,aAAa,CAAC,OAAO,EAAE,uBAAuB,EAAEG,KAAK,CAAC;IACvF,OAAOF,OAAO,CAACE,KAAK,EAAE,IAAI,CAAC;EAC7B,CAAC;EAEDE,WAAWA,CAACF,KAAa,EAAU;IACjC,OAAOJ,OAAO,CAACI,KAAK,CAAC;EACvB;AACF,CAAC","ignoreList":[]}

package/es/tx/builder/field-types/with-default.js

@@ -0,0 +1,9 @@
+export default function withDefault(defaultValue, field) {
+  return {
+    ...field,
+    serialize(value, params) {
+      return field.serialize(value !== null && value !== void 0 ? value : defaultValue, params);
+    }
+  };
+}
+//# sourceMappingURL=with-default.js.map

package/es/tx/builder/field-types/with-default.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-default.js","names":["withDefault","defaultValue","field","serialize","value","params"],"sources":["../../../../src/tx/builder/field-types/with-default.ts"],"sourcesContent":["export default function withDefault<Input, Output, Binary>(\n  defaultValue: Input,\n  field: {\n    serialize: (value: Input, params: unknown) => Binary;\n    deserialize: (value: Binary, params: unknown) => Output;\n  },\n): {\n  serialize: (value: Input | undefined, params: unknown) => Binary;\n  deserialize: (value: Binary, params: unknown) => Output;\n} {\n  return {\n    ...field,\n\n    serialize(value, params) {\n      return field.serialize(value ?? defaultValue, params);\n    },\n  };\n}\n"],"mappings":"AAAA,eAAe,SAASA,WAAWA,CACjCC,YAAmB,EACnBC,KAGC,EAID;EACA,OAAO;IACL,GAAGA,KAAK;IAERC,SAASA,CAACC,KAAK,EAAEC,MAAM,EAAE;MACvB,OAAOH,KAAK,CAACC,SAAS,CAACC,KAAK,aAALA,KAAK,cAALA,KAAK,GAAIH,YAAY,EAAEI,MAAM,CAAC;IACvD;EACF,CAAC;AACH","ignoreList":[]}

package/es/tx/builder/field-types/with-formatting.js

@@ -0,0 +1,9 @@
+export default function withFormatting(format, field) {
+  return {
+    ...field,
+    serialize(value, params, options) {
+      return field.serialize(format(value), params, options);
+    }
+  };
+}
+//# sourceMappingURL=with-formatting.js.map

package/es/tx/builder/field-types/with-formatting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-formatting.js","names":["withFormatting","format","field","serialize","value","params","options"],"sources":["../../../../src/tx/builder/field-types/with-formatting.ts"],"sourcesContent":["export default function withFormatting<Input, Output, Binary, Params, Options>(\n  format: (v: Input | undefined) => Input,\n  field: {\n    serialize: (value: Input, params: Params, options: Options) => Binary;\n    deserialize: (value: Binary) => Output;\n  },\n): {\n  serialize: (value: Input | undefined, params: Params, options: Options) => Binary;\n  deserialize: (value: Binary) => Output;\n} {\n  return {\n    ...field,\n\n    serialize(value, params, options) {\n      return field.serialize(format(value), params, options);\n    },\n  };\n}\n"],"mappings":"AAAA,eAAe,SAASA,cAAcA,CACpCC,MAAuC,EACvCC,KAGC,EAID;EACA,OAAO;IACL,GAAGA,KAAK;IAERC,SAASA,CAACC,KAAK,EAAEC,MAAM,EAAEC,OAAO,EAAE;MAChC,OAAOJ,KAAK,CAACC,SAAS,CAACF,MAAM,CAACG,KAAK,CAAC,EAAEC,MAAM,EAAEC,OAAO,CAAC;IACxD;EACF,CAAC;AACH","ignoreList":[]}

package/es/tx/builder/field-types/wrapped.d.ts

@@ -1,13 +1,12 @@
-/// <reference types="node" />
-import { Tag } from '../constants';
-import type { unpackTx as unpackTxType, buildTx as buildTxType } from '../index';
-type TagWrapping = Tag.AccountsMtree | Tag.CallsMtree | Tag.ChannelsMtree | Tag.ContractsMtree | Tag.NameserviceMtree | Tag.OraclesMtree;
+import { EntryTag } from '../entry/constants.js';
+import type { unpackEntry as unpackEntryType, packEntry as packEntryType } from '../entry/index.js';
+type TagWrapping = EntryTag.AccountsMtree | EntryTag.CallsMtree | EntryTag.ChannelsMtree | EntryTag.ContractsMtree | EntryTag.NameserviceMtree | EntryTag.OraclesMtree;
 export default function genWrappedField<T extends TagWrapping>(tag: T): {
     serialize: (value: any, options: {
-        buildTx: typeof buildTxType;
+        packEntry: typeof packEntryType;
     }) => Buffer;
     deserialize: (value: Buffer, options: {
-        unpackTx: typeof unpackTxType;
+        unpackEntry: typeof unpackEntryType;
     }) => any;
     recursiveType: true;
 };

package/es/tx/builder/field-types/wrapped.js

@@ -0,0 +1,20 @@
+import { encode, Encoding, decode } from '../../../utils/encoder.js';
+export default function genWrappedField(tag) {
+  return {
+    serialize(payload, {
+      packEntry
+    }) {
+      return decode(packEntry({
+        tag,
+        payload
+      }));
+    },
+    deserialize(buffer, {
+      unpackEntry
+    }) {
+      return unpackEntry(encode(buffer, Encoding.Bytearray), tag).payload;
+    },
+    recursiveType: true
+  };
+}
+//# sourceMappingURL=wrapped.js.map

package/es/tx/builder/field-types/wrapped.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapped.js","names":["encode","Encoding","decode","genWrappedField","tag","serialize","payload","packEntry","deserialize","buffer","unpackEntry","Bytearray","recursiveType"],"sources":["../../../../src/tx/builder/field-types/wrapped.ts"],"sourcesContent":["import { EntryTag } from '../entry/constants.js';\nimport { encode, Encoding, decode } from '../../../utils/encoder.js';\nimport type { unpackEntry as unpackEntryType, packEntry as packEntryType } from '../entry/index.js';\n\ntype TagWrapping =\n  | EntryTag.AccountsMtree\n  | EntryTag.CallsMtree\n  | EntryTag.ChannelsMtree\n  | EntryTag.ContractsMtree\n  | EntryTag.NameserviceMtree\n  | EntryTag.OraclesMtree;\n\nexport default function genWrappedField<T extends TagWrapping>(\n  tag: T,\n): {\n  serialize: (\n    // TODO: replace with `(EntParams & { tag: T })['payload']`,\n    //  but fix TS2502 value is referenced directly or indirectly in its own type annotation\n    value: any,\n    options: { packEntry: typeof packEntryType },\n  ) => Buffer;\n  deserialize: (\n    value: Buffer,\n    options: { unpackEntry: typeof unpackEntryType },\n    // TODO: replace with `(EntUnpacked & { tag: T })['payload']`,\n    //  TS2577 Return type annotation circularly references itself\n  ) => any;\n  recursiveType: true;\n} {\n  return {\n    serialize(payload, { packEntry }) {\n      return decode(packEntry({ tag, payload }));\n    },\n\n    deserialize(buffer, { unpackEntry }) {\n      return unpackEntry<TagWrapping>(encode(buffer, Encoding.Bytearray), tag).payload;\n    },\n\n    recursiveType: true,\n  };\n}\n"],"mappings":"AACA,SAASA,MAAM,EAAEC,QAAQ,EAAEC,MAAM,QAAQ,2BAA2B;AAWpE,eAAe,SAASC,eAAeA,CACrCC,GAAM,EAeN;EACA,OAAO;IACLC,SAASA,CAACC,OAAO,EAAE;MAAEC;IAAU,CAAC,EAAE;MAChC,OAAOL,MAAM,CAACK,SAAS,CAAC;QAAEH,GAAG;QAAEE;MAAQ,CAAC,CAAC,CAAC;IAC5C,CAAC;IAEDE,WAAWA,CAACC,MAAM,EAAE;MAAEC;IAAY,CAAC,EAAE;MACnC,OAAOA,WAAW,CAAcV,MAAM,CAACS,MAAM,EAAER,QAAQ,CAACU,SAAS,CAAC,EAAEP,GAAG,CAAC,CAACE,OAAO;IAClF,CAAC;IAEDM,aAAa,EAAE;EACjB,CAAC;AACH","ignoreList":[]}

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

@@ -1,18 +1,17 @@
-/// <reference types="node" />
 import BigNumber from 'bignumber.js';
-import { Encoded } from '../../utils/encoder';
-import { AensName } from './constants';
+import { Encoded } from '../../utils/encoder.js';
+import { AensName } from './constants.js';
 /**
  * JavaScript-based Transaction builder helper function's
  */
 /**
- * Build a contract public key
+ * Build a contract address
  * @category contract
- * @param ownerId - The public key of the owner account
- * @param nonce - the nonce of the transaction
- * @returns Contract public key
+ * @param owner - Address of contract owner
+ * @param nonce - Nonce of ContractCreateTx or state channel round when contract was created
+ * @returns Contract address
  */
-export declare function buildContractId(ownerId: Encoded.AccountAddress, nonce: number | BigNumber): Encoded.ContractAddress;
+export declare function buildContractId(owner: Encoded.AccountAddress, nonce: number | BigNumber): Encoded.ContractAddress;
 /**
  * Build a oracle query id
  * @category oracle
@@ -41,11 +40,12 @@ export declare function produceNameId(name: AensName): Encoded.Name;
 export declare function commitmentHash(name: AensName, salt?: number): Encoded.Commitment;
 /**
  * Utility function to convert bytes to int
- * @category transaction builder
- * @param buf - Value
+ * @category utils
+ * @param buffer - Value
  * @returns Buffer Buffer from number(BigEndian)
+ * @deprecated use `BigInt('0x' + <buffer>.toString('hex')).toString()` instead
  */
-export declare function readInt(buf?: Buffer): string;
+export declare function readInt(buffer?: Uint8Array): string;
 /**
  * Ensure that name is valid AENS name, would throw an exception otherwise
  * @category AENS
@@ -57,14 +57,14 @@ export declare function ensureName(maybeName: string): asserts maybeName is Aens
  * @category AENS
  * @param maybeName - AENS name
  */
-export declare function isNameValid(maybeName: string): maybeName is AensName;
+export declare function isName(maybeName: string): maybeName is AensName;
 declare const encodingToPointerKey: readonly [readonly [Encoded.Encoding.AccountAddress, "account_pubkey"], readonly [Encoded.Encoding.OracleAddress, "oracle_pubkey"], readonly [Encoded.Encoding.ContractAddress, "contract_pubkey"], readonly [Encoded.Encoding.Channel, "channel"]];
 /**
  * @category AENS
  * @param identifier - account/oracle/contract address, or channel
  * @returns default AENS pointer key
  */
-export declare function getDefaultPointerKey(identifier: Encoded.Generic<typeof encodingToPointerKey[number][0]>): typeof encodingToPointerKey[number][1];
+export declare function getDefaultPointerKey(identifier: Encoded.Generic<(typeof encodingToPointerKey)[number][0]>): (typeof encodingToPointerKey)[number][1];
 /**
  * Get the minimum AENS name fee
  * @category AENS
@@ -81,16 +81,21 @@ export declare function getMinimumNameFee(name: AensName): BigNumber;
  * @param options.increment - Bid multiplier(In percentage, must be between 0 and 1)
  * @returns Bid fee
  */
-export declare function computeBidFee(name: AensName, { startFee, increment }?: {
+export declare function computeBidFee(name: AensName, { startFee, increment, }?: {
     startFee?: number | string | BigNumber;
     increment?: number;
 }): BigNumber;
 /**
- * Compute auction end height
+ * Compute approximate auction end height.
+ *
+ * From Ceres, each time a new (successful!) bid is made for a name the auction is extended for up
+ * to 120 key-blocks/generations. I.e. after the bid there is always at least 120 generations to
+ * make a higher bid.
+ *
  * @category AENS
  * @param name - Name to compute auction end for
  * @param claimHeight - Auction starting height
- * @see {@link https://github.com/aeternity/aeternity/blob/72e440b8731422e335f879a31ecbbee7ac23a1cf/apps/aecore/src/aec_governance.erl#L273}
+ * @see {@link https://github.com/aeternity/protocol/blob/cfb19ce/AENS.md#from-ceres-protocol-upgrade}
  * @returns Auction end height
  */
 export declare function computeAuctionEndBlock(name: AensName, claimHeight: number): number;

package/es/tx/builder/helpers.js

@@ -0,0 +1,215 @@
+import { Buffer as _Buffer } from "buffer";
+import BigNumber from 'bignumber.js';
+import { genSalt, hash } from '../../utils/crypto.js';
+import { decode, encode, Encoding } from '../../utils/encoder.js';
+import { toBytes } from '../../utils/bytes.js';
+import { concatBuffers } from '../../utils/other.js';
+import { NAME_BID_RANGES, NAME_FEE_BID_INCREMENT, NAME_MAX_LENGTH_FEE } from './constants.js';
+import { ceil } from '../../utils/bignumber.js';
+import { ArgumentError, IllegalBidFeeError } from '../../utils/errors.js';
+
+/**
+ * JavaScript-based Transaction builder helper function's
+ */
+
+/**
+ * Build a contract address
+ * @category contract
+ * @param owner - Address of contract owner
+ * @param nonce - Nonce of ContractCreateTx or state channel round when contract was created
+ * @returns Contract address
+ */
+export function buildContractId(owner, nonce) {
+  const ownerIdAndNonce = _Buffer.from([...decode(owner), ...toBytes(nonce)]);
+  const b2bHash = hash(ownerIdAndNonce);
+  return encode(b2bHash, Encoding.ContractAddress);
+}
+
+// TODO: add `build` prefix the same as others
+/**
+ * Build a oracle query id
+ * @category oracle
+ * @param senderId - The public key of the sender account
+ * @param nonce - the nonce of the transaction
+ * @param oracleId - The oracle public key
+ * @returns Contract public key
+ */
+export function oracleQueryId(senderId, nonce, oracleId) {
+  function _int32(val) {
+    const nonceBE = toBytes(val, true);
+    return concatBuffers([_Buffer.alloc(32 - nonceBE.length), nonceBE]);
+  }
+  const b2bHash = hash(_Buffer.from([...decode(senderId), ..._int32(nonce), ...decode(oracleId)]));
+  return encode(b2bHash, Encoding.OracleQueryId);
+}
+const AENS_SUFFIX = '.chain';
+export function nameToPunycode(maybeName) {
+  const [name, suffix, ...other] = maybeName.split('.');
+  if (other.length !== 0) throw new ArgumentError('aens name', 'including only one dot', maybeName);
+  if (suffix !== AENS_SUFFIX.slice(1)) {
+    throw new ArgumentError('aens name', `suffixed with ${AENS_SUFFIX}`, maybeName);
+  }
+  if (/\p{Emoji_Presentation}/u.test(name)) {
+    throw new ArgumentError('aens name', 'not containing emoji', maybeName);
+  }
+  if (name[2] === '-' && name[3] === '-') {
+    throw new ArgumentError('aens name', 'without "-" char in both the third and fourth positions', maybeName);
+  }
+  if (name[0] === '-') {
+    throw new ArgumentError('aens name', 'starting with no "-" char', maybeName);
+  }
+  if (name.at(-1) === '-') {
+    throw new ArgumentError('aens name', 'ending with no "-" char', maybeName);
+  }
+  let punycode;
+  try {
+    const u = new URL(`http://${name}.${suffix}`);
+    if (u.username + u.password + u.port + u.search + u.hash !== '' || u.pathname !== '/') {
+      throw new ArgumentError('aens name', 'valid', maybeName);
+    }
+    punycode = u.host;
+  } catch (error) {
+    if (error instanceof TypeError && error.message.includes('Invalid URL')) {
+      throw new ArgumentError('aens name', 'valid', maybeName);
+    }
+    throw error;
+  }
+  if (!/^[a-z0-9.-]+$/i.test(punycode)) {
+    throw new ArgumentError('aens name', 'without illegal chars', maybeName);
+  }
+  if (punycode.length > 63 + AENS_SUFFIX.length) {
+    throw new ArgumentError('aens name', 'not too long', maybeName);
+  }
+  return punycode;
+}
+
+// TODO: replace `produce` with `build` the same as others
+/**
+ * Encode an AENS name
+ * @category AENS
+ * @param name - Name to encode
+ * @returns `nm_` prefixed encoded AENS name
+ */
+export function produceNameId(name) {
+  return encode(hash(nameToPunycode(name)), Encoding.Name);
+}
+
+// TODO: add `build` the same as others
+/**
+ * Generate the commitment hash by hashing the salt and
+ * name, base 58 encoding the result and prepending 'cm_'
+ * @category transaction builder
+ * @param name - Name to be registered
+ * @param salt - Random number
+ * @returns Commitment hash
+ */
+export function commitmentHash(name, salt = genSalt()) {
+  return encode(hash(concatBuffers([_Buffer.from(nameToPunycode(name)), _Buffer.from(salt.toString(16).padStart(64, '0'), 'hex')])), Encoding.Commitment);
+}
+
+/**
+ * Utility function to convert bytes to int
+ * @category utils
+ * @param buffer - Value
+ * @returns Buffer Buffer from number(BigEndian)
+ * @deprecated use `BigInt('0x' + <buffer>.toString('hex')).toString()` instead
+ */
+export function readInt(buffer = _Buffer.from([])) {
+  return BigInt('0x' + _Buffer.from(buffer).toString('hex')).toString();
+}
+
+/**
+ * Ensure that name is valid AENS name, would throw an exception otherwise
+ * @category AENS
+ * @param maybeName - AENS name
+ */
+export function ensureName(maybeName) {
+  nameToPunycode(maybeName);
+}
+
+/**
+ * Is AENS name valid
+ * @category AENS
+ * @param maybeName - AENS name
+ */
+export function isName(maybeName) {
+  try {
+    ensureName(maybeName);
+    return true;
+  } catch (error) {
+    return false;
+  }
+}
+const encodingToPointerKey = [[Encoding.AccountAddress, 'account_pubkey'], [Encoding.OracleAddress, 'oracle_pubkey'], [Encoding.ContractAddress, 'contract_pubkey'], [Encoding.Channel, 'channel']];
+
+/**
+ * @category AENS
+ * @param identifier - account/oracle/contract address, or channel
+ * @returns default AENS pointer key
+ */
+export function getDefaultPointerKey(identifier) {
+  decode(identifier);
+  const encoding = identifier.substring(0, 2);
+  const result = encodingToPointerKey.find(([e]) => e === encoding)?.[1];
+  if (result != null) return result;
+  throw new ArgumentError('identifier', `prefixed with one of ${encodingToPointerKey.map(([e]) => `${e}_`).join(', ')}`, identifier);
+}
+
+/**
+ * Get the minimum AENS name fee
+ * @category AENS
+ * @param name - the AENS name to get the fee for
+ * @returns the minimum fee for the AENS name auction
+ */
+export function getMinimumNameFee(name) {
+  const nameLength = nameToPunycode(name).length - AENS_SUFFIX.length;
+  return NAME_BID_RANGES[Math.min(nameLength, NAME_MAX_LENGTH_FEE)];
+}
+
+/**
+ * Compute bid fee for AENS auction
+ * @category AENS
+ * @param name - the AENS name to get the fee for
+ * @param options - Options
+ * @param options.startFee - Auction start fee
+ * @param options.increment - Bid multiplier(In percentage, must be between 0 and 1)
+ * @returns Bid fee
+ */
+export function computeBidFee(name, {
+  startFee,
+  increment = NAME_FEE_BID_INCREMENT
+} = {}) {
+  if (!(Number(increment) === increment && increment % 1 !== 0)) throw new IllegalBidFeeError(`Increment must be float. Current increment ${increment}`);
+  if (increment < NAME_FEE_BID_INCREMENT) throw new IllegalBidFeeError(`minimum increment percentage is ${NAME_FEE_BID_INCREMENT}`);
+  // FIXME: increment should be used somehow here
+  return ceil(new BigNumber(startFee !== null && startFee !== void 0 ? startFee : getMinimumNameFee(name)).times(new BigNumber(NAME_FEE_BID_INCREMENT).plus(1)));
+}
+
+/**
+ * Compute approximate auction end height.
+ *
+ * From Ceres, each time a new (successful!) bid is made for a name the auction is extended for up
+ * to 120 key-blocks/generations. I.e. after the bid there is always at least 120 generations to
+ * make a higher bid.
+ *
+ * @category AENS
+ * @param name - Name to compute auction end for
+ * @param claimHeight - Auction starting height
+ * @see {@link https://github.com/aeternity/protocol/blob/cfb19ce/AENS.md#from-ceres-protocol-upgrade}
+ * @returns Auction end height
+ */
+export function computeAuctionEndBlock(name, claimHeight) {
+  var _ref, _ref2, _ref3;
+  const length = nameToPunycode(name).length - AENS_SUFFIX.length;
+  const h = (_ref = (_ref2 = (_ref3 = length <= 4 ? 2400 : null) !== null && _ref3 !== void 0 ? _ref3 : length <= 8 ? 960 : null) !== null && _ref2 !== void 0 ? _ref2 : length <= 12 ? 480 : null) !== null && _ref !== void 0 ? _ref : 0;
+  return h + claimHeight;
+}
+
+/**
+ * Is name accept going to auction
+ * @category AENS
+ */
+export function isAuctionName(name) {
+  return nameToPunycode(name).length < 13 + AENS_SUFFIX.length;
+}
+//# sourceMappingURL=helpers.js.map