@aeternity/aepp-sdk 11.0.1 → 12.1.1

package/src/tx/builder/constants.js

@@ -1,100 +0,0 @@
-import BigNumber from 'bignumber.js'
-import { mapObject } from '../../utils/other'
-
-// # AENS
-export const NAME_TTL = 180000
-// # max number of block into the future that the name is going to be available
-// # https://github.com/aeternity/protocol/blob/epoch-v0.22.0/AENS.md#update
-// # https://github.com/aeternity/protocol/blob/44a93d3aab957ca820183c3520b9daf6b0fedff4/AENS.md#aens-entry
-export const NAME_MAX_TTL = 36000
-export const NAME_MAX_CLIENT_TTL = 84600
-export const CLIENT_TTL = NAME_MAX_CLIENT_TTL
-// # see https://github.com/aeternity/aeternity/blob/72e440b8731422e335f879a31ecbbee7ac23a1cf/apps/aecore/src/aec_governance.erl#L67
-export const NAME_FEE_MULTIPLIER = 1e14 // 100000000000000
-export const NAME_FEE_BID_INCREMENT = 0.05 // # the increment is in percentage
-// # see https://github.com/aeternity/aeternity/blob/72e440b8731422e335f879a31ecbbee7ac23a1cf/apps/aecore/src/aec_governance.erl#L272
-export const NAME_BID_TIMEOUT_BLOCKS = 480 // # ~1 day
-// # this is the max length for a domain that requires a base fee to be paid
-export const NAME_MAX_LENGTH_FEE = 31
-export const NAME_BID_MAX_LENGTH = 12 // # this is the max length for a domain to be part of a bid
-export const POINTER_KEY_BY_PREFIX = {
-  ak: 'account_pubkey',
-  ok: 'oracle_pubkey',
-  ct: 'contract_pubkey',
-  ch: 'channel'
-}
-// # https://github.com/aeternity/aeternity/blob/72e440b8731422e335f879a31ecbbee7ac23a1cf/apps/aecore/src/aec_governance.erl#L290
-// # https://github.com/aeternity/protocol/blob/master/AENS.md#protocol-fees-and-protection-times
-// # bid ranges:
-export const NAME_BID_RANGES = mapObject({
-  31: 3,
-  30: 5,
-  29: 8,
-  28: 13,
-  27: 21,
-  26: 34,
-  25: 55,
-  24: 89,
-  23: 144,
-  22: 233,
-  21: 377,
-  20: 610,
-  19: 987,
-  18: 1597,
-  17: 2584,
-  16: 4181,
-  15: 6765,
-  14: 10946,
-  13: 17711,
-  12: 28657,
-  11: 46368,
-  10: 75025,
-  9: 121393,
-  8: 196418,
-  7: 317811,
-  6: 514229,
-  5: 832040,
-  4: 1346269,
-  3: 2178309,
-  2: 3524578,
-  1: 5702887
-}, ([key, value]) => [key, new BigNumber(value).times(NAME_FEE_MULTIPLIER)])
-
-// # ref: https://github.com/aeternity/aeternity/blob/72e440b8731422e335f879a31ecbbee7ac23a1cf/apps/aecore/src/aec_governance.erl#L273
-// # name bid timeouts
-export const NAME_BID_TIMEOUTS = {
-  13: BigNumber(0),
-  12: BigNumber(NAME_BID_TIMEOUT_BLOCKS), // # 480 blocks
-  8: BigNumber(31).times(NAME_BID_TIMEOUT_BLOCKS), // # 14880 blocks
-  4: BigNumber(62).times(NAME_BID_TIMEOUT_BLOCKS) // # 29760 blocks
-}
-
-// # Tag constant for ids (type uint8)
-// # see https://github.com/aeternity/protocol/blob/master/serializations.md#the-id-type
-// # <<Tag:1/unsigned-integer-unit:8, Hash:32/binary-unit:8>>
-const ID_TAG_ACCOUNT = 1
-const ID_TAG_NAME = 2
-const ID_TAG_COMMITMENT = 3
-const ID_TAG_ORACLE = 4
-const ID_TAG_CONTRACT = 5
-const ID_TAG_CHANNEL = 6
-
-export const ID_TAG = {
-  account: ID_TAG_ACCOUNT,
-  name: ID_TAG_NAME,
-  commitment: ID_TAG_COMMITMENT,
-  oracle: ID_TAG_ORACLE,
-  contract: ID_TAG_CONTRACT,
-  channel: ID_TAG_CHANNEL
-}
-
-export const PREFIX_ID_TAG = {
-  ak: ID_TAG.account,
-  nm: ID_TAG.name,
-  cm: ID_TAG.commitment,
-  ok: ID_TAG.oracle,
-  ct: ID_TAG.contract,
-  ch: ID_TAG.channel
-}
-
-export const ID_TAG_PREFIX = mapObject(PREFIX_ID_TAG, ([key, value]) => [value, key])

package/src/tx/builder/field-types.js

@@ -1,61 +0,0 @@
-import {
-  writeId, readId, isNameValid, produceNameId, ensureNameValid, getMinimumNameFee, readInt, writeInt
-} from './helpers'
-import { InsufficientNameFeeError, IllegalArgumentError } from '../../utils/errors'
-
-export class Field {
-  static serialize (value) {
-    return value
-  }
-
-  static deserialize (value) {
-    return value
-  }
-}
-
-export class Name extends Field {
-  static serialize (value) {
-    ensureNameValid(value)
-    return Buffer.from(value)
-  }
-
-  static deserialize (value) {
-    return value.toString()
-  }
-}
-
-export class NameId extends Field {
-  static serialize (value) {
-    return writeId(isNameValid(value) ? produceNameId(value) : value)
-  }
-
-  static deserialize (value) {
-    return readId(value)
-  }
-}
-
-export class NameFee extends Field {
-  static serialize (value, { name }) {
-    const minNameFee = getMinimumNameFee(name)
-    value ??= minNameFee
-    if (minNameFee.gt(value)) {
-      throw new InsufficientNameFeeError(value, minNameFee)
-    }
-    return writeInt(value)
-  }
-
-  static deserialize (value) {
-    return readInt(value)
-  }
-}
-
-export class Deposit extends Field {
-  static serialize (value, { name }) {
-    if (+value) throw new IllegalArgumentError(`Contract deposit is not refundable, so it should be equal 0, got ${value} instead`)
-    return writeInt(0)
-  }
-
-  static deserialize (value) {
-    return readInt(value)
-  }
-}

package/src/tx/builder/helpers.js

@@ -1,334 +0,0 @@
-import BigNumber from 'bignumber.js'
-import { encode as bs58Encode, decode as bs58Decode } from 'bs58'
-import { hash, salt } from '../../utils/crypto'
-import { encode, decode } from '../../utils/encoder'
-import { toBytes } from '../../utils/bytes'
-import {
-  ID_TAG_PREFIX,
-  PREFIX_ID_TAG,
-  NAME_BID_RANGES,
-  NAME_FEE_BID_INCREMENT,
-  NAME_BID_TIMEOUTS,
-  NAME_MAX_LENGTH_FEE,
-  POINTER_KEY_BY_PREFIX
-} from './constants'
-import { ceil } from '../../utils/bignumber'
-import {
-  TagNotFoundError,
-  PrefixNotFoundError,
-  InvalidNameError,
-  IllegalBidFeeError,
-  NoDefaultAensPointerError,
-  ArgumentError
-} from '../../utils/errors'
-
-/**
- * JavaScript-based Transaction builder helper function's
- * @module @aeternity/aepp-sdk/es/tx/builder/helpers
- * @export TxBuilderHelper
- * @example import { TxBuilderHelper } from '@aeternity/aepp-sdk'
- */
-
-export const createSalt = salt
-
-export { encode, decode }
-
-/**
- * Build a contract public key
- * @function
- * @alias module:@aeternity/aepp-sdk/es/tx/builder/helpers
- * @param {string} ownerId The public key of the owner account
- * @param {number} nonce the nonce of the transaction
- * @return {string} Contract public key
- */
-export function buildContractId (ownerId, nonce) {
-  const ownerIdAndNonce = Buffer.from([...decode(ownerId, 'ak'), ...toBytes(nonce)])
-  const b2bHash = hash(ownerIdAndNonce)
-  return encode(b2bHash, 'ct')
-}
-
-/**
- * Build a oracle query id
- * @function
- * @function* @alias module:@aeternity/aepp-sdk/es/tx/builder/helpers
- * @param {String} senderId The public key of the sender account
- * @param {Number} nonce the nonce of the transaction
- * @param {Number} oracleId The oracle public key
- * @return {string} Contract public key
- */
-export function oracleQueryId (senderId, nonce, oracleId) {
-  function _int32 (val) {
-    const nonceBE = toBytes(val, true)
-    return Buffer.concat([Buffer.alloc(32 - nonceBE.length), nonceBE])
-  }
-
-  const b2bHash = hash(Buffer.from([...decode(senderId, 'ak'), ..._int32(nonce), ...decode(oracleId, 'ok')]))
-  return encode(b2bHash, 'oq')
-}
-
-/**
- * Format the salt into a 64-byte hex string
- * @function
- * @alias module:@aeternity/aepp-sdk/es/tx/builder/helpers
- * @param {number} salt
- * @return {string} Zero-padded hex string of salt
- */
-export function formatSalt (salt) {
-  return Buffer.from(salt.toString(16).padStart(64, '0'), 'hex')
-}
-
-/**
- * Encode an AENS name
- * @function
- * @alias module:@aeternity/aepp-sdk/es/tx/builder/helpers
- * @param {String} name Name to encode
- * @return {String} `nm_` prefixed encoded AENS name
- */
-export function produceNameId (name) {
-  ensureNameValid(name)
-  return encode(hash(name.toLowerCase()), 'nm')
-}
-
-/**
- * Generate the commitment hash by hashing the formatted salt and
- * name, base 58 encoding the result and prepending 'cm_'
- *
- * @alias module:@aeternity/aepp-sdk/es/tx/builder/helpers
- * @function commitmentHash
- * @category async
- * @rtype (name: String, salt?: String) => hash: Promise[String]
- * @param {String} name - Name to be registered
- * @param {Number} salt Random salt
- * @return {String} Commitment hash
- */
-export function commitmentHash (name, salt = createSalt()) {
-  ensureNameValid(name)
-  return encode(hash(Buffer.concat([Buffer.from(name.toLowerCase()), formatSalt(salt)])), 'cm')
-}
-
-// based on https://github.com/aeternity/protocol/blob/master/node/api/api_encoding.md
-const base64Types = ['ba', 'cb', 'or', 'ov', 'pi', 'ss', 'cs', 'ck', 'cv', 'st', 'tx']
-const base58Types = ['ak', 'bf', 'bs', 'bx', 'ch', 'cm', 'ct', 'kh', 'mh', 'nm', 'ok', 'oq', 'pp', 'sg', 'th']
-// TODO: add all types with a fixed length
-const typesLength = {
-  ak: 32,
-  ct: 32,
-  ok: 32
-}
-
-function ensureValidLength (data, type) {
-  if (!typesLength[type]) return
-  if (data.length === typesLength[type]) return
-  throw new PayloadLengthError(`Payload should be ${typesLength[type]} bytes, got ${data.length} instead`)
-}
-
-const getChecksum = payload => sha256hash(sha256hash(payload)).slice(0, 4)
-
-const addChecksum = (input) => {
-  const payload = Buffer.from(input)
-  return Buffer.concat([payload, getChecksum(payload)])
-}
-
-function getPayload (buffer) {
-  const payload = buffer.slice(0, -4)
-  if (!getChecksum(payload).equals(buffer.slice(-4))) throw new InvalidChecksumError()
-  return payload
-}
-
-const base64 = {
-  encode: buffer => addChecksum(buffer).toString('base64'),
-  decode: string => getPayload(Buffer.from(string, 'base64'))
-}
-
-const base58 = {
-  encode: buffer => bs58.encode(addChecksum(buffer)),
-  decode: string => getPayload(bs58.decode(string))
-}
-
-/**
- * Utility function to create and _id type
- * @function
- * @alias module:@aeternity/aepp-sdk/es/tx/builder/helpers
- * @param {string} hashId Encoded hash
- * @return {Buffer} Buffer Buffer with ID tag and decoded HASh
- */
-export function writeId (hashId) {
-  if (typeof hashId !== 'string') throw new ArgumentError('hashId', 'a string', hashId)
-  const prefix = hashId.slice(0, 2)
-  const idTag = PREFIX_ID_TAG[prefix]
-  if (!idTag) throw new TagNotFoundError(prefix)
-  return Buffer.from([...toBytes(idTag), ...decode(hashId, prefix)])
-}
-
-/**
- * Utility function to read and _id type
- * @function
- * @alias module:@aeternity/aepp-sdk/es/tx/builder/helpers
- * @param {Buffer} buf Data
- * @return {String} Encoided hash string with prefix
- */
-export function readId (buf) {
-  const tag = Buffer.from(buf).readUIntBE(0, 1)
-  const prefix = ID_TAG_PREFIX[tag]
-  if (!prefix) throw new PrefixNotFoundError(tag)
-  return encode(buf.slice(1, buf.length), prefix)
-}
-
-/**
- * Utility function to convert int to bytes
- * @function
- * @alias module:@aeternity/aepp-sdk/es/tx/builder/helpers
- * @param {Number|String|BigNumber} val Value
- * @return {Buffer} Buffer Buffer from number(BigEndian)
- */
-export function writeInt (val) {
-  return toBytes(val, true)
-}
-
-/**
- * Utility function to convert bytes to int
- * @function
- * @alias module:@aeternity/aepp-sdk/es/tx/builder/helpers
- * @param {Buffer} buf Value
- * @return {String} Buffer Buffer from number(BigEndian)
- */
-export function readInt (buf = Buffer.from([])) {
-  return new BigNumber(Buffer.from(buf).toString('hex'), 16).toString(10)
-}
-
-/**
- * Helper function to build pointers for name update TX
- * @function
- * @alias module:@aeternity/aepp-sdk/es/tx/builder/helpers
- * @param {Array} pointers - Array of pointers
- * ([ { key: 'account_pubkey', id: 'ak_32klj5j23k23j5423l434l2j3423'} ])
- * @return {Array} 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
- * @function
- * @alias module:@aeternity/aepp-sdk/es/tx/builder/helpers
- * @param {Array} pointers - Array of pointers
- * ([ { key: 'account_pubkey', id: 'ak_32klj5j23k23j5423l434l2j3423'} ])
- * @return {Array} Deserialize pointer array
- */
-export function readPointers (pointers) {
-  return pointers.map(
-    ([key, id]) => Object.assign({
-      key: key.toString(),
-      id: readId(id)
-    })
-  )
-}
-
-const AENS_SUFFIX = '.chain'
-
-/**
- * Ensure that AENS name is valid
- * @function
- * @alias module:@aeternity/aepp-sdk/es/tx/builder/helpers
- * @param {string} name
- * @return void
- * @throws Error
- */
-export function ensureNameValid (name) {
-  if (!name || typeof name !== 'string') throw new InvalidNameError('Name must be a string')
-  if (!name.endsWith(AENS_SUFFIX)) throw new InvalidNameError(`Name should end with ${AENS_SUFFIX}: ${name}`)
-}
-
-/**
- * Is AENS name valid
- * @function
- * @alias module:@aeternity/aepp-sdk/es/tx/builder/helpers
- * @param {string} name
- * @return Boolean
- */
-export function isNameValid (name) {
-  try {
-    ensureNameValid(name)
-    return true
-  } catch (error) {
-    return false
-  }
-}
-
-/**
- * @param identifier - account/oracle/contract address, or channel
- * @returns {String} default AENS pointer key
- * @throws exception when default key not defined
- */
-export function getDefaultPointerKey (identifier) {
-  decode(identifier)
-  const prefix = identifier.substr(0, 2)
-  return POINTER_KEY_BY_PREFIX[prefix] ||
-    (() => { throw new NoDefaultAensPointerError(prefix) })()
-}
-
-/**
- * Get the minimum AENS name fee
- * @function
- * @alias module:@aeternity/aepp-sdk/es/tx/builder/helpers
- * @param {String} name the AENS name to get the fee for
- * @return {String} the minimum fee for the AENS name auction
- */
-export function getMinimumNameFee (name) {
-  ensureNameValid(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
- * @function
- * @alias module:@aeternity/aepp-sdk/es/tx/builder/helpers
- * @param {String} name the AENS name to get the fee for
- * @param {Number|String} startFee Auction start fee
- * @param {Number} [increment=0.5] Bid multiplier(In percentage, must be between 0 and 1)
- * @return {String} 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}`)
-  return ceil(
-    BigNumber(startFee ?? getMinimumNameFee(name)).times(BigNumber(NAME_FEE_BID_INCREMENT).plus(1))
-  )
-}
-
-/**
- * Compute auction end height
- * @function
- * @alias module:@aeternity/aepp-sdk/es/tx/builder/helpers
- * @param {String} name
- * @param {Number|String} claimHeight Auction starting height
- * @return {String} Auction end height
- */
-export function computeAuctionEndBlock (name, claimHeight) {
-  ensureNameValid(name)
-  const length = name.length - AENS_SUFFIX.length
-  const h = (length <= 4 && NAME_BID_TIMEOUTS[4]) ||
-    (length <= 8 && NAME_BID_TIMEOUTS[8]) ||
-    (length <= 12 && NAME_BID_TIMEOUTS[12]) ||
-    NAME_BID_TIMEOUTS[13]
-  return h.plus(claimHeight).toString(10)
-}
-
-/**
- * Is name accept going to auction
- * @function
- * @alias module:@aeternity/aepp-sdk/es/tx/builder/helpers
- * @param {String} name
- * @return {Boolean}
- */
-export function isAuctionName (name) {
-  ensureNameValid(name)
-  return name.length < 13 + AENS_SUFFIX.length
-}