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

package/es/tx/builder/helpers.mjs

@@ -10,11 +10,9 @@ import { concatBuffers } from "../../utils/other.mjs";
 import { NAME_BID_RANGES, NAME_BID_TIMEOUT_BLOCKS, NAME_FEE_BID_INCREMENT, NAME_MAX_LENGTH_FEE } from "./constants.mjs";
 import { ceil } from "../../utils/bignumber.mjs";
 import { ArgumentError, IllegalBidFeeError } from "../../utils/errors.mjs";
-import { readId, writeId } from "./address.mjs";
 /**
  * JavaScript-based Transaction builder helper function's
  */
-
 /**
  * Build a contract public key
  * @category contract
@@ -22,13 +20,12 @@ import { readId, writeId } from "./address.mjs";
  * @param nonce - the nonce of the transaction
  * @returns Contract public key
  */
-
 export function buildContractId(ownerId, nonce) {
   const ownerIdAndNonce = _Buffer.from([...decode(ownerId), ...toBytes(nonce)]);
-
   const b2bHash = hash(ownerIdAndNonce);
   return encode(b2bHash, Encoding.ContractAddress);
 }
+
 /**
  * Build a oracle query id
  * @category oracle
@@ -37,141 +34,92 @@ export function buildContractId(ownerId, nonce) {
  * @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);
 }
-/**
- * Format the salt into a 64-byte hex string
- * @category transaction builder
- * @param salt - Random number
- * @returns Zero-padded hex string of salt
- */
 
-export function formatSalt(salt) {
-  return _Buffer.from(salt.toString(16).padStart(64, '0'), 'hex');
-}
 /**
  * Encode an AENS name
  * @category AENS
  * @param name - Name to encode
  * @returns `nm_` prefixed encoded AENS name
  */
-
 export function produceNameId(name) {
   return encode(hash(name.toLowerCase()), Encoding.Name);
 }
+
 /**
- * Generate the commitment hash by hashing the formatted salt and
+ * 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 salt
+ * @param salt - Random number
  * @returns Commitment hash
  */
-
 export function commitmentHash(name) {
   let salt = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : genSalt();
-  return encode(hash(concatBuffers([_Buffer.from(name.toLowerCase()), formatSalt(salt)])), Encoding.Commitment);
+  return encode(hash(concatBuffers([_Buffer.from(name.toLowerCase()), _Buffer.from(salt.toString(16).padStart(64, '0'), 'hex')])), Encoding.Commitment);
 }
-/**
- * Utility function to convert int to bytes
- * @category transaction builder
- * @param val - Value
- * @returns Buffer Buffer from number(BigEndian)
- */
 
-export function writeInt(val) {
-  return toBytes(val, true);
-}
 /**
  * Utility function to convert bytes to int
  * @category transaction builder
  * @param buf - Value
  * @returns Buffer Buffer from number(BigEndian)
  */
-
 export function readInt() {
   let buf = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : _Buffer.from([]);
   return new BigNumber(_Buffer.from(buf).toString('hex'), 16).toString(10);
 }
-/**
- * Helper function to build pointers for name update TX
- * @category transaction builder
- * @param pointers - Array of pointers
- * `([ { key: 'account_pubkey', id: 'ak_32klj5j23k23j5423l434l2j3423'} ])`
- * @returns Serialized pointers array
- */
-
-export function buildPointers(pointers) {
-  return pointers.map(p => [toBytes(p.key), writeId(p.id)]);
-}
-/**
- * Helper function to read pointers from name update TX
- * @category transaction builder
- * @param pointers - Array of pointers
- * @returns Deserialize pointer array
- */
-
-export function readPointers(pointers) {
-  return pointers.map(_ref => {
-    let [key, id] = _ref;
-    return {
-      key: key.toString(),
-      id: readId(id)
-    };
-  });
-}
 const AENS_SUFFIX = '.chain';
+
 /**
  * Is AENS name valid
  * @category AENS
  * @param name - AENS name
  */
-
 export function isNameValid(name) {
   // TODO: probably there are stronger requirements
   return name.endsWith(AENS_SUFFIX);
 }
 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) {
   var _encodingToPointerKey;
-
   decode(identifier);
   const encoding = identifier.substring(0, 2);
-  const result = (_encodingToPointerKey = encodingToPointerKey.find(_ref2 => {
-    let [e] = _ref2;
+  const result = (_encodingToPointerKey = encodingToPointerKey.find(_ref => {
+    let [e] = _ref;
     return e === encoding;
   })) === null || _encodingToPointerKey === void 0 ? void 0 : _encodingToPointerKey[1];
   if (result != null) return result;
-  throw new ArgumentError('identifier', `prefixed with one of ${encodingToPointerKey.map(_ref3 => {
-    let [e] = _ref3;
+  throw new ArgumentError('identifier', `prefixed with one of ${encodingToPointerKey.map(_ref2 => {
+    let [e] = _ref2;
     return `${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 = name.length - AENS_SUFFIX.length;
   return NAME_BID_RANGES[Math.min(nameLength, NAME_MAX_LENGTH_FEE)];
 }
+
 /**
  * Compute bid fee for AENS auction
  * @category AENS
@@ -181,17 +129,17 @@ export function getMinimumNameFee(name) {
  * @param options.increment - Bid multiplier(In percentage, must be between 0 and 1)
  * @returns Bid fee
  */
-
 export function computeBidFee(name) {
   let {
     startFee,
     increment = NAME_FEE_BID_INCREMENT
   } = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
   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
-
+  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 auction end height
  * @category AENS
@@ -200,17 +148,17 @@ export function computeBidFee(name) {
  * @see {@link https://github.com/aeternity/aeternity/blob/72e440b8731422e335f879a31ecbbee7ac23a1cf/apps/aecore/src/aec_governance.erl#L273}
  * @returns Auction end height
  */
-
 export function computeAuctionEndBlock(name, claimHeight) {
+  var _ref3, _ref4, _ref5;
   const length = name.length - AENS_SUFFIX.length;
-  const h = length <= 4 && 62 * NAME_BID_TIMEOUT_BLOCKS || length <= 8 && 31 * NAME_BID_TIMEOUT_BLOCKS || length <= 12 && NAME_BID_TIMEOUT_BLOCKS || 0;
+  const h = (_ref3 = (_ref4 = (_ref5 = length <= 4 ? 62 * NAME_BID_TIMEOUT_BLOCKS : null) !== null && _ref5 !== void 0 ? _ref5 : length <= 8 ? 31 * NAME_BID_TIMEOUT_BLOCKS : null) !== null && _ref4 !== void 0 ? _ref4 : length <= 12 ? NAME_BID_TIMEOUT_BLOCKS : null) !== null && _ref3 !== void 0 ? _ref3 : 0;
   return h + claimHeight;
 }
+
 /**
  * Is name accept going to auction
  * @category AENS
  */
-
 export function isAuctionName(name) {
   return name.length < 13 + AENS_SUFFIX.length;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.mjs","names":["BigNumber","genSalt","hash","decode","encode","Encoding","toBytes","concatBuffers","NAME_BID_RANGES","NAME_BID_TIMEOUT_BLOCKS","NAME_FEE_BID_INCREMENT","NAME_MAX_LENGTH_FEE","ceil","ArgumentError","IllegalBidFeeError","readId","writeId","buildContractId","ownerId","nonce","ownerIdAndNonce","from","b2bHash","ContractAddress","oracleQueryId","senderId","oracleId","_int32","val","nonceBE","alloc","length","OracleQueryId","formatSalt","salt","toString","padStart","produceNameId","name","toLowerCase","Name","commitmentHash","Commitment","writeInt","readInt","buf","buildPointers","pointers","map","p","key","id","readPointers","AENS_SUFFIX","isNameValid","endsWith","encodingToPointerKey","AccountAddress","OracleAddress","Channel","getDefaultPointerKey","identifier","encoding","substring","result","find","e","join","getMinimumNameFee","nameLength","Math","min","computeBidFee","startFee","increment","Number","times","plus","computeAuctionEndBlock","claimHeight","h","isAuctionName"],"sources":["../../../src/tx/builder/helpers.ts"],"sourcesContent":["import BigNumber from 'bignumber.js';\nimport { genSalt, hash } from '../../utils/crypto';\nimport {\n  decode, encode, Encoded, Encoding,\n} from '../../utils/encoder';\nimport { toBytes } from '../../utils/bytes';\nimport { concatBuffers } from '../../utils/other';\nimport {\n  AensName,\n  NAME_BID_RANGES,\n  NAME_BID_TIMEOUT_BLOCKS,\n  NAME_FEE_BID_INCREMENT,\n  NAME_MAX_LENGTH_FEE,\n} from './constants';\nimport { ceil } from '../../utils/bignumber';\nimport { ArgumentError, IllegalBidFeeError } from '../../utils/errors';\nimport { NamePointer } from '../../apis/node';\nimport { readId, writeId } from './address';\n\n/**\n * JavaScript-based Transaction builder helper function's\n */\n\n/**\n * Build a contract public key\n * @category contract\n * @param ownerId - The public key of the owner account\n * @param nonce - the nonce of the transaction\n * @returns Contract public key\n */\nexport function buildContractId(\n  ownerId: Encoded.AccountAddress,\n  nonce: number | BigNumber,\n): Encoded.ContractAddress {\n  const ownerIdAndNonce = Buffer.from([...decode(ownerId), ...toBytes(nonce)]);\n  const b2bHash = hash(ownerIdAndNonce);\n  return encode(b2bHash, Encoding.ContractAddress);\n}\n\n/**\n * Build a oracle query id\n * @category oracle\n * @param senderId - The public key of the sender account\n * @param nonce - the nonce of the transaction\n * @param oracleId - The oracle public key\n * @returns Contract public key\n */\nexport function oracleQueryId(\n  senderId: Encoded.AccountAddress,\n  nonce: number | BigNumber | string,\n  oracleId: Encoded.OracleAddress,\n): Encoded.OracleQueryId {\n  function _int32(val: number | string | BigNumber): Buffer {\n    const nonceBE = toBytes(val, true);\n    return concatBuffers([Buffer.alloc(32 - nonceBE.length), nonceBE]);\n  }\n\n  const b2bHash = hash(\n    Buffer.from([...decode(senderId), ..._int32(nonce), ...decode(oracleId)]),\n  );\n  return encode(b2bHash, Encoding.OracleQueryId);\n}\n\n/**\n * Format the salt into a 64-byte hex string\n * @category transaction builder\n * @param salt - Random number\n * @returns Zero-padded hex string of salt\n */\nexport function formatSalt(salt: number): Buffer {\n  return Buffer.from(salt.toString(16).padStart(64, '0'), 'hex');\n}\n\n/**\n * Encode an AENS name\n * @category AENS\n * @param name - Name to encode\n * @returns `nm_` prefixed encoded AENS name\n */\nexport function produceNameId(name: AensName): Encoded.Name {\n  return encode(hash(name.toLowerCase()), Encoding.Name);\n}\n\n/**\n * Generate the commitment hash by hashing the formatted salt and\n * name, base 58 encoding the result and prepending 'cm_'\n * @category transaction builder\n * @param name - Name to be registered\n * @param salt - Random salt\n * @returns Commitment hash\n */\nexport function commitmentHash(\n  name: AensName,\n  salt: number = genSalt(),\n): Encoded.Commitment {\n  return encode(\n    hash(concatBuffers([Buffer.from(name.toLowerCase()), formatSalt(salt)])),\n    Encoding.Commitment,\n  );\n}\n\n/**\n * Utility function to convert int to bytes\n * @category transaction builder\n * @param val - Value\n * @returns Buffer Buffer from number(BigEndian)\n */\nexport function writeInt(val: number | string | BigNumber): Buffer {\n  return toBytes(val, true);\n}\n\n/**\n * Utility function to convert bytes to int\n * @category transaction builder\n * @param buf - Value\n * @returns Buffer Buffer from number(BigEndian)\n */\nexport function readInt(buf: Buffer = Buffer.from([])): string {\n  return new BigNumber(Buffer.from(buf).toString('hex'), 16).toString(10);\n}\n\n/**\n * Helper function to build pointers for name update TX\n * @category transaction builder\n * @param pointers - Array of pointers\n * `([ { key: 'account_pubkey', id: 'ak_32klj5j23k23j5423l434l2j3423'} ])`\n * @returns Serialized pointers array\n */\nexport function buildPointers(pointers: NamePointer[]): Buffer[][] {\n  return pointers.map(\n    (p) => [\n      toBytes(p.key),\n      writeId(p.id as Parameters<typeof writeId>[0]),\n    ],\n  );\n}\n\n/**\n * Helper function to read pointers from name update TX\n * @category transaction builder\n * @param pointers - Array of pointers\n * @returns Deserialize pointer array\n */\nexport function readPointers(pointers: Array<[key: string, id: Buffer]>): NamePointer[] {\n  return pointers.map(\n    ([key, id]) => ({\n      key: key.toString(),\n      id: readId(id),\n    }),\n  );\n}\n\nconst AENS_SUFFIX = '.chain';\n\n/**\n * Is AENS name valid\n * @category AENS\n * @param name - AENS name\n */\nexport function isNameValid(name: string): name is AensName {\n  // TODO: probably there are stronger requirements\n  return name.endsWith(AENS_SUFFIX);\n}\n\nconst encodingToPointerKey = [\n  [Encoding.AccountAddress, 'account_pubkey'],\n  [Encoding.OracleAddress, 'oracle_pubkey'],\n  [Encoding.ContractAddress, 'contract_pubkey'],\n  [Encoding.Channel, 'channel'],\n] as const;\n\n/**\n * @category AENS\n * @param identifier - account/oracle/contract address, or channel\n * @returns default AENS pointer key\n */\nexport function getDefaultPointerKey(\n  identifier: Encoded.Generic<typeof encodingToPointerKey[number][0]>,\n): typeof encodingToPointerKey[number][1] {\n  decode(identifier);\n  const encoding = identifier.substring(0, 2);\n  const result = encodingToPointerKey.find(([e]) => e === encoding)?.[1];\n  if (result != null) return result;\n  throw new ArgumentError(\n    'identifier',\n    `prefixed with one of ${encodingToPointerKey.map(([e]) => `${e}_`).join(', ')}`,\n    identifier,\n  );\n}\n\n/**\n * Get the minimum AENS name fee\n * @category AENS\n * @param name - the AENS name to get the fee for\n * @returns the minimum fee for the AENS name auction\n */\nexport function getMinimumNameFee(name: AensName): BigNumber {\n  const nameLength = name.length - AENS_SUFFIX.length;\n  return NAME_BID_RANGES[Math.min(nameLength, NAME_MAX_LENGTH_FEE)];\n}\n\n/**\n * Compute bid fee for AENS auction\n * @category AENS\n * @param name - the AENS name to get the fee for\n * @param options - Options\n * @param options.startFee - Auction start fee\n * @param options.increment - Bid multiplier(In percentage, must be between 0 and 1)\n * @returns Bid fee\n */\nexport function computeBidFee(\n  name: AensName,\n  { startFee, increment = NAME_FEE_BID_INCREMENT }:\n  { startFee?: number | string | BigNumber; increment?: number } = {},\n): BigNumber {\n  if (!(Number(increment) === increment && increment % 1 !== 0)) throw new IllegalBidFeeError(`Increment must be float. Current increment ${increment}`);\n  if (increment < NAME_FEE_BID_INCREMENT) throw new IllegalBidFeeError(`minimum increment percentage is ${NAME_FEE_BID_INCREMENT}`);\n  // FIXME: increment should be used somehow here\n  return ceil(\n    new BigNumber(startFee ?? getMinimumNameFee(name))\n      .times(new BigNumber(NAME_FEE_BID_INCREMENT).plus(1)),\n  );\n}\n\n/**\n * Compute auction end height\n * @category AENS\n * @param name - Name to compute auction end for\n * @param claimHeight - Auction starting height\n * @see {@link https://github.com/aeternity/aeternity/blob/72e440b8731422e335f879a31ecbbee7ac23a1cf/apps/aecore/src/aec_governance.erl#L273}\n * @returns Auction end height\n */\nexport function computeAuctionEndBlock(name: AensName, claimHeight: number): number {\n  const length = name.length - AENS_SUFFIX.length;\n  const h = (length <= 4 && 62 * NAME_BID_TIMEOUT_BLOCKS)\n    || (length <= 8 && 31 * NAME_BID_TIMEOUT_BLOCKS)\n    || (length <= 12 && NAME_BID_TIMEOUT_BLOCKS)\n    || 0;\n  return h + claimHeight;\n}\n\n/**\n * Is name accept going to auction\n * @category AENS\n */\nexport function isAuctionName(name: AensName): boolean {\n  return name.length < 13 + AENS_SUFFIX.length;\n}\n"],"mappings":"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"}
+{"version":3,"file":"helpers.mjs","names":["BigNumber","genSalt","hash","decode","encode","Encoding","toBytes","concatBuffers","NAME_BID_RANGES","NAME_BID_TIMEOUT_BLOCKS","NAME_FEE_BID_INCREMENT","NAME_MAX_LENGTH_FEE","ceil","ArgumentError","IllegalBidFeeError","buildContractId","ownerId","nonce","ownerIdAndNonce","from","b2bHash","ContractAddress","oracleQueryId","senderId","oracleId","_int32","val","nonceBE","alloc","length","OracleQueryId","produceNameId","name","toLowerCase","Name","commitmentHash","salt","toString","padStart","Commitment","readInt","buf","AENS_SUFFIX","isNameValid","endsWith","encodingToPointerKey","AccountAddress","OracleAddress","Channel","getDefaultPointerKey","identifier","encoding","substring","result","find","e","map","join","getMinimumNameFee","nameLength","Math","min","computeBidFee","startFee","increment","Number","times","plus","computeAuctionEndBlock","claimHeight","h","isAuctionName"],"sources":["../../../src/tx/builder/helpers.ts"],"sourcesContent":["import BigNumber from 'bignumber.js';\nimport { genSalt, hash } from '../../utils/crypto';\nimport {\n  decode, encode, Encoded, Encoding,\n} from '../../utils/encoder';\nimport { toBytes } from '../../utils/bytes';\nimport { concatBuffers } from '../../utils/other';\nimport {\n  AensName,\n  NAME_BID_RANGES,\n  NAME_BID_TIMEOUT_BLOCKS,\n  NAME_FEE_BID_INCREMENT,\n  NAME_MAX_LENGTH_FEE,\n} from './constants';\nimport { ceil } from '../../utils/bignumber';\nimport { ArgumentError, IllegalBidFeeError } from '../../utils/errors';\n\n/**\n * JavaScript-based Transaction builder helper function's\n */\n\n/**\n * Build a contract public key\n * @category contract\n * @param ownerId - The public key of the owner account\n * @param nonce - the nonce of the transaction\n * @returns Contract public key\n */\nexport function buildContractId(\n  ownerId: Encoded.AccountAddress,\n  nonce: number | BigNumber,\n): Encoded.ContractAddress {\n  const ownerIdAndNonce = Buffer.from([...decode(ownerId), ...toBytes(nonce)]);\n  const b2bHash = hash(ownerIdAndNonce);\n  return encode(b2bHash, Encoding.ContractAddress);\n}\n\n/**\n * Build a oracle query id\n * @category oracle\n * @param senderId - The public key of the sender account\n * @param nonce - the nonce of the transaction\n * @param oracleId - The oracle public key\n * @returns Contract public key\n */\nexport function oracleQueryId(\n  senderId: Encoded.AccountAddress,\n  nonce: number | BigNumber | string,\n  oracleId: Encoded.OracleAddress,\n): Encoded.OracleQueryId {\n  function _int32(val: number | string | BigNumber): Buffer {\n    const nonceBE = toBytes(val, true);\n    return concatBuffers([Buffer.alloc(32 - nonceBE.length), nonceBE]);\n  }\n\n  const b2bHash = hash(\n    Buffer.from([...decode(senderId), ..._int32(nonce), ...decode(oracleId)]),\n  );\n  return encode(b2bHash, Encoding.OracleQueryId);\n}\n\n/**\n * Encode an AENS name\n * @category AENS\n * @param name - Name to encode\n * @returns `nm_` prefixed encoded AENS name\n */\nexport function produceNameId(name: AensName): Encoded.Name {\n  return encode(hash(name.toLowerCase()), Encoding.Name);\n}\n\n/**\n * Generate the commitment hash by hashing the salt and\n * name, base 58 encoding the result and prepending 'cm_'\n * @category transaction builder\n * @param name - Name to be registered\n * @param salt - Random number\n * @returns Commitment hash\n */\nexport function commitmentHash(\n  name: AensName,\n  salt: number = genSalt(),\n): Encoded.Commitment {\n  return encode(\n    hash(concatBuffers([\n      Buffer.from(name.toLowerCase()),\n      Buffer.from(salt.toString(16).padStart(64, '0'), 'hex'),\n    ])),\n    Encoding.Commitment,\n  );\n}\n\n/**\n * Utility function to convert bytes to int\n * @category transaction builder\n * @param buf - Value\n * @returns Buffer Buffer from number(BigEndian)\n */\nexport function readInt(buf: Buffer = Buffer.from([])): string {\n  return new BigNumber(Buffer.from(buf).toString('hex'), 16).toString(10);\n}\n\nconst AENS_SUFFIX = '.chain';\n\n/**\n * Is AENS name valid\n * @category AENS\n * @param name - AENS name\n */\nexport function isNameValid(name: string): name is AensName {\n  // TODO: probably there are stronger requirements\n  return name.endsWith(AENS_SUFFIX);\n}\n\nconst encodingToPointerKey = [\n  [Encoding.AccountAddress, 'account_pubkey'],\n  [Encoding.OracleAddress, 'oracle_pubkey'],\n  [Encoding.ContractAddress, 'contract_pubkey'],\n  [Encoding.Channel, 'channel'],\n] as const;\n\n/**\n * @category AENS\n * @param identifier - account/oracle/contract address, or channel\n * @returns default AENS pointer key\n */\nexport function getDefaultPointerKey(\n  identifier: Encoded.Generic<typeof encodingToPointerKey[number][0]>,\n): typeof encodingToPointerKey[number][1] {\n  decode(identifier);\n  const encoding = identifier.substring(0, 2);\n  const result = encodingToPointerKey.find(([e]) => e === encoding)?.[1];\n  if (result != null) return result;\n  throw new ArgumentError(\n    'identifier',\n    `prefixed with one of ${encodingToPointerKey.map(([e]) => `${e}_`).join(', ')}`,\n    identifier,\n  );\n}\n\n/**\n * Get the minimum AENS name fee\n * @category AENS\n * @param name - the AENS name to get the fee for\n * @returns the minimum fee for the AENS name auction\n */\nexport function getMinimumNameFee(name: AensName): BigNumber {\n  const nameLength = name.length - AENS_SUFFIX.length;\n  return NAME_BID_RANGES[Math.min(nameLength, NAME_MAX_LENGTH_FEE)];\n}\n\n/**\n * Compute bid fee for AENS auction\n * @category AENS\n * @param name - the AENS name to get the fee for\n * @param options - Options\n * @param options.startFee - Auction start fee\n * @param options.increment - Bid multiplier(In percentage, must be between 0 and 1)\n * @returns Bid fee\n */\nexport function computeBidFee(\n  name: AensName,\n  { startFee, increment = NAME_FEE_BID_INCREMENT }:\n  { startFee?: number | string | BigNumber; increment?: number } = {},\n): BigNumber {\n  if (!(Number(increment) === increment && increment % 1 !== 0)) throw new IllegalBidFeeError(`Increment must be float. Current increment ${increment}`);\n  if (increment < NAME_FEE_BID_INCREMENT) throw new IllegalBidFeeError(`minimum increment percentage is ${NAME_FEE_BID_INCREMENT}`);\n  // FIXME: increment should be used somehow here\n  return ceil(\n    new BigNumber(startFee ?? getMinimumNameFee(name))\n      .times(new BigNumber(NAME_FEE_BID_INCREMENT).plus(1)),\n  );\n}\n\n/**\n * Compute auction end height\n * @category AENS\n * @param name - Name to compute auction end for\n * @param claimHeight - Auction starting height\n * @see {@link https://github.com/aeternity/aeternity/blob/72e440b8731422e335f879a31ecbbee7ac23a1cf/apps/aecore/src/aec_governance.erl#L273}\n * @returns Auction end height\n */\nexport function computeAuctionEndBlock(name: AensName, claimHeight: number): number {\n  const length = name.length - AENS_SUFFIX.length;\n  const h = (length <= 4 ? 62 * NAME_BID_TIMEOUT_BLOCKS : null)\n    ?? (length <= 8 ? 31 * NAME_BID_TIMEOUT_BLOCKS : null)\n    ?? (length <= 12 ? NAME_BID_TIMEOUT_BLOCKS : null)\n    ?? 0;\n  return h + claimHeight;\n}\n\n/**\n * Is name accept going to auction\n * @category AENS\n */\nexport function isAuctionName(name: AensName): boolean {\n  return name.length < 13 + AENS_SUFFIX.length;\n}\n"],"mappings":"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"}

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

@@ -1,27 +1,7 @@
-import { NestedUint8Array } from 'rlp';
 import { Encoded, Encoding } from '../../utils/encoder';
 import { AE_AMOUNT_FORMATS } from '../../utils/amount-formatter';
-import { RawTxObject, TxField, TxSchema, TxTypeSchemas } from './schema';
+import { RawTxObject, TxSchema, TxTypeSchemas } from './schema';
 import { Tag } from './constants';
-/**
- * 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
- */
-export declare function validateParams(params: any, schema: TxField[], { excludeKeys }: {
-    excludeKeys: string[];
-}): object;
-/**
- * Unpack binary transaction
- * @category transaction builder
- * @param binary - Array with binary transaction field's
- * @param schema - Transaction schema
- * @returns Object with transaction field's
- */
-export declare function unpackRawTx<Tx extends TxSchema>(binary: Uint8Array | NestedUint8Array, schema: TxField[]): RawTxObject<Tx>;
 /**
  * @category transaction builder
  */