@aeternity/aepp-sdk 10.0.0 → 11.0.0

package/es/contract/ga/helpers.mjs

@@ -0,0 +1,30 @@
+import BigNumber from 'bignumber.js';
+import { MAX_AUTH_FUN_GAS } from "../../tx/builder/schema.mjs";
+import { InvalidAuthDataError } from "../../utils/errors.mjs";
+export const prepareGaParams = ins => async (authData, authFnName) => {
+  if (typeof authData !== 'object') throw new InvalidAuthDataError('AuthData must be an object');
+
+  if (authData.gas && BigNumber(authData.gas).gt(MAX_AUTH_FUN_GAS)) {
+    throw new InvalidAuthDataError(`the maximum gas value for ga authFun is ${MAX_AUTH_FUN_GAS}, got ${authData.gas}`);
+  }
+
+  const gas = authData.gas || MAX_AUTH_FUN_GAS;
+
+  if (authData.callData) {
+    if (authData.callData.split('_')[0] !== 'cb') throw new InvalidAuthDataError('Auth data must be a string with "cb" prefix.');
+    return {
+      authCallData: authData.callData,
+      gas
+    };
+  }
+
+  if (!authData.source || !authData.args) throw new InvalidAuthDataError('Auth data must contain source code and arguments.');
+  const contract = await ins.getContractInstance({
+    source: authData.source
+  });
+  return {
+    authCallData: contract.calldata.encode(contract._name, authFnName, authData.args),
+    gas
+  };
+};
+//# sourceMappingURL=helpers.mjs.map

package/es/contract/ga/helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/contract/ga/helpers.js"],"names":["BigNumber","MAX_AUTH_FUN_GAS","InvalidAuthDataError","prepareGaParams","ins","authData","authFnName","gas","gt","callData","split","authCallData","source","args","contract","getContractInstance","calldata","encode","_name"],"mappings":"AAAA,OAAOA,SAAP,MAAsB,cAAtB;SACSC,gB;SACAC,oB;AAET,OAAO,MAAMC,eAAe,GAAIC,GAAD,IAAS,OAAOC,QAAP,EAAiBC,UAAjB,KAAgC;AACtE,MAAI,OAAOD,QAAP,KAAoB,QAAxB,EAAkC,MAAM,IAAIH,oBAAJ,CAAyB,4BAAzB,CAAN;;AAClC,MAAIG,QAAQ,CAACE,GAAT,IAAgBP,SAAS,CAACK,QAAQ,CAACE,GAAV,CAAT,CAAwBC,EAAxB,CAA2BP,gBAA3B,CAApB,EAAkE;AAAE,UAAM,IAAIC,oBAAJ,CAA0B,2CAA0CD,gBAAiB,SAAQI,QAAQ,CAACE,GAAI,EAA1G,CAAN;AAAoH;;AACxL,QAAMA,GAAG,GAAGF,QAAQ,CAACE,GAAT,IAAgBN,gBAA5B;;AACA,MAAII,QAAQ,CAACI,QAAb,EAAuB;AACrB,QAAIJ,QAAQ,CAACI,QAAT,CAAkBC,KAAlB,CAAwB,GAAxB,EAA6B,CAA7B,MAAoC,IAAxC,EAA8C,MAAM,IAAIR,oBAAJ,CAAyB,8CAAzB,CAAN;AAC9C,WAAO;AAAES,MAAAA,YAAY,EAAEN,QAAQ,CAACI,QAAzB;AAAmCF,MAAAA;AAAnC,KAAP;AACD;;AACD,MAAI,CAACF,QAAQ,CAACO,MAAV,IAAoB,CAACP,QAAQ,CAACQ,IAAlC,EAAwC,MAAM,IAAIX,oBAAJ,CAAyB,mDAAzB,CAAN;AACxC,QAAMY,QAAQ,GAAG,MAAMV,GAAG,CAACW,mBAAJ,CAAwB;AAAEH,IAAAA,MAAM,EAAEP,QAAQ,CAACO;AAAnB,GAAxB,CAAvB;AACA,SAAO;AACLD,IAAAA,YAAY,EAAEG,QAAQ,CAACE,QAAT,CAAkBC,MAAlB,CAAyBH,QAAQ,CAACI,KAAlC,EAAyCZ,UAAzC,EAAqDD,QAAQ,CAACQ,IAA9D,CADT;AAELN,IAAAA;AAFK,GAAP;AAID,CAdM","sourcesContent":["import BigNumber from 'bignumber.js'\nimport { MAX_AUTH_FUN_GAS } from '../../tx/builder/schema'\nimport { InvalidAuthDataError } from '../../utils/errors'\n\nexport const prepareGaParams = (ins) => async (authData, authFnName) => {\n  if (typeof authData !== 'object') throw new InvalidAuthDataError('AuthData must be an object')\n  if (authData.gas && BigNumber(authData.gas).gt(MAX_AUTH_FUN_GAS)) { throw new InvalidAuthDataError(`the maximum gas value for ga authFun is ${MAX_AUTH_FUN_GAS}, got ${authData.gas}`) }\n  const gas = authData.gas || MAX_AUTH_FUN_GAS\n  if (authData.callData) {\n    if (authData.callData.split('_')[0] !== 'cb') throw new InvalidAuthDataError('Auth data must be a string with \"cb\" prefix.')\n    return { authCallData: authData.callData, gas }\n  }\n  if (!authData.source || !authData.args) throw new InvalidAuthDataError('Auth data must contain source code and arguments.')\n  const contract = await ins.getContractInstance({ source: authData.source })\n  return {\n    authCallData: contract.calldata.encode(contract._name, authFnName, authData.args),\n    gas\n  }\n}\n"],"file":"helpers.mjs"}

package/es/contract/ga/{index.js → index.mjs}

@@ -1,6 +1,6 @@
 /*
  * ISC License (ISC)
- * Copyright (c) 2018 aeternity developers
+ * Copyright (c) 2021 aeternity developers
  *
  *  Permission to use, copy, modify, and/or distribute this software for any
  *  purpose with or without fee is hereby granted, provided that the above
@@ -16,51 +16,52 @@
  */
 
 /**
- * Generalize Account module - routines to use generalize account
+ * Generalized Account module - routines to use generalized account
  *
  * @module @aeternity/aepp-sdk/es/contract/ga
- * @export GeneralizeAccount
- * @example import { GeneralizeAccount } from '@aeternity/aepp-sdk'
+ * @export GeneralizedAccount
+ * @example import { GeneralizedAccount } from '@aeternity/aepp-sdk'
  */
-import { ContractAPI } from '../../ae/contract';
-import { TX_TYPE } from '../../tx/builder/schema';
-import { buildTx, unpackTx } from '../../tx/builder';
-import { prepareGaParams } from './helpers';
-import { hash } from '../../utils/crypto';
+import Contract from "../../ae/contract.mjs";
+import { TX_TYPE } from "../../tx/builder/schema.mjs";
+import { buildTx, unpackTx } from "../../tx/builder/index.mjs";
+import { prepareGaParams } from "./helpers.mjs";
+import { hash } from "../../utils/crypto.mjs";
+import { IllegalArgumentError, MissingParamError } from "../../utils/errors.mjs";
 /**
- * GeneralizeAccount Stamp
+ * GeneralizedAccount Stamp
  *
- * Provide Generalize Account implementation
+ * Provide Generalized Account implementation
  * {@link module:@aeternity/aepp-sdk/es/contract/ga} clients.
  * @function
  * @alias module:@aeternity/aepp-sdk/es/contract/ga
  * @rtype Stamp
  * @param {Object} [options={}] - Initializer object
- * @return {Object} GeneralizeAccount instance
+ * @return {Object} GeneralizedAccount instance
  * @example
  * const authContract = ``
- * await client.createGeneralizeAccount(authFnName, authContract, [...authFnArguments]
+ * await aeSdk.createGeneralizedAccount(authFnName, authContract, [...authFnArguments]
  * // Make spend using GA
  * const callData = 'cb_...' // encoded call data for auth contract
- * await client.spend(10000, receiverPub, { authData: { callData } })
+ * await aeSdk.spend(10000, receiverPub, { authData: { callData } })
  * // or
- * await client.spend(10000, receiverPub, {
+ * await aeSdk.spend(10000, receiverPub, {
  *   authData: { source: authContract, args: [...authContractArgs] }
  * }) // sdk will prepare callData itself
  */
 
-export const GeneralizeAccount = ContractAPI.compose({
+export const GeneralizedAccount = Contract.compose({
   methods: {
-    createGeneralizeAccount,
+    createGeneralizedAccount,
     createMetaTx,
     isGA
   }
 });
-export default GeneralizeAccount;
+export default GeneralizedAccount;
 /**
  * @alias module:@aeternity/aepp-sdk/es/contract/ga
  * @function
- * Check if account is GA account
+ * Check if account is GA
  * @param {String} address - Account address
  * @return {Boolean}
  */
@@ -72,7 +73,7 @@ async function isGA(address) {
   return !!contractId;
 }
 /**
- * Convert current account to GA account
+ * Convert current account to GA
  * @alias module:@aeternity/aepp-sdk/es/contract/ga
  * @function
  * @param {String} authFnName - Authorization function name
@@ -80,26 +81,33 @@ async function isGA(address) {
  * @param {Array} [args] - init arguments
  * @param {Object} [options] - Options
  * @return {Promise<Readonly<{
- *   result: *, owner: *, createdAt: Date, address, rawTx: *, transaction: *
+ *   result: *, owner: *, address, rawTx: *, transaction: *
  * }>>}
  */
 
 
-async function createGeneralizeAccount(authFnName, source) {
+async function createGeneralizedAccount(authFnName, source) {
+  var _opt$gas;
+
   let args = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : [];
   let options = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {};
   const opt = { ...this.Ae.defaults,
     ...options
   };
   const ownerId = await this.address(opt);
-  if (await this.isGA(ownerId)) throw new Error(`Account ${ownerId} is already GA`);
+  if (await this.isGA(ownerId)) throw new IllegalArgumentError(`Account ${ownerId} is already GA`);
+  const contract = await this.getContractInstance({
+    source
+  });
+  await contract.compile();
   const {
     tx,
     contractId
   } = await this.gaAttachTx({ ...opt,
+    gas: (_opt$gas = opt.gas) !== null && _opt$gas !== void 0 ? _opt$gas : await contract._estimateGas('init', args, opt),
     ownerId,
-    code: (await this.contractCompile(source)).bytecode,
-    callData: await this.contractEncodeCallDataAPI(source, 'init', args),
+    code: contract.bytecode,
+    callData: contract.calldata.encode(contract._name, 'init', args),
     authFun: hash(authFnName)
   });
   const {
@@ -132,7 +140,7 @@ const wrapInEmptySignedTx = tx => buildTx({
 
 async function createMetaTx(rawTransaction, authData, authFnName) {
   let options = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {};
-  if (!authData) throw new Error('authData is required'); // Check if authData is callData or if it's an object prepare a callData from source and args
+  if (!authData) throw new MissingParamError('authData is required'); // Check if authData is callData or if it's an object prepare a callData from source and args
 
   const {
     authCallData,
@@ -150,7 +158,7 @@ async function createMetaTx(rawTransaction, authData, authFnName) {
       tx: wrappedTx.txObject
     },
     gaId: await this.address(opt),
-    abiVersion: abiVersion,
+    abiVersion,
     authData: authCallData,
     gas,
     vsn: 2
@@ -167,4 +175,4 @@ async function createMetaTx(rawTransaction, authData, authFnName) {
   });
   return wrapInEmptySignedTx(metaTxRlp).tx;
 }
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.mjs.map

package/es/contract/ga/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/contract/ga/index.js"],"names":["Contract","TX_TYPE","buildTx","unpackTx","prepareGaParams","hash","IllegalArgumentError","MissingParamError","GeneralizedAccount","compose","methods","createGeneralizedAccount","createMetaTx","isGA","address","contractId","getAccount","authFnName","source","args","options","opt","Ae","defaults","ownerId","contract","getContractInstance","compile","tx","gaAttachTx","gas","_estimateGas","code","bytecode","callData","calldata","encode","_name","authFun","transaction","rawTx","send","Object","freeze","owner","gaContractId","wrapInEmptySignedTx","encodedTx","signatures","signed","rawTransaction","authData","authCallData","abiVersion","getVmVersion","contractCall","wrappedTx","params","txObject","gaId","vsn","fee","prepareTxParams","gaMeta","rlpEncoded","metaTxRlp"],"mappings":"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","sourcesContent":["/*\n * ISC License (ISC)\n * Copyright (c) 2021 aeternity developers\n *\n *  Permission to use, copy, modify, and/or distribute this software for any\n *  purpose with or without fee is hereby granted, provided that the above\n *  copyright notice and this permission notice appear in all copies.\n *\n *  THE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH\n *  REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY\n *  AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,\n *  INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM\n *  LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR\n *  OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR\n *  PERFORMANCE OF THIS SOFTWARE.\n */\n\n/**\n * Generalized Account module - routines to use generalized account\n *\n * @module @aeternity/aepp-sdk/es/contract/ga\n * @export GeneralizedAccount\n * @example import { GeneralizedAccount } from '@aeternity/aepp-sdk'\n */\nimport Contract from '../../ae/contract'\nimport { TX_TYPE } from '../../tx/builder/schema'\nimport { buildTx, unpackTx } from '../../tx/builder'\nimport { prepareGaParams } from './helpers'\nimport { hash } from '../../utils/crypto'\nimport { IllegalArgumentError, MissingParamError } from '../../utils/errors'\n\n/**\n * GeneralizedAccount Stamp\n *\n * Provide Generalized Account implementation\n * {@link module:@aeternity/aepp-sdk/es/contract/ga} clients.\n * @function\n * @alias module:@aeternity/aepp-sdk/es/contract/ga\n * @rtype Stamp\n * @param {Object} [options={}] - Initializer object\n * @return {Object} GeneralizedAccount instance\n * @example\n * const authContract = ``\n * await aeSdk.createGeneralizedAccount(authFnName, authContract, [...authFnArguments]\n * // Make spend using GA\n * const callData = 'cb_...' // encoded call data for auth contract\n * await aeSdk.spend(10000, receiverPub, { authData: { callData } })\n * // or\n * await aeSdk.spend(10000, receiverPub, {\n *   authData: { source: authContract, args: [...authContractArgs] }\n * }) // sdk will prepare callData itself\n */\nexport const GeneralizedAccount = Contract.compose({\n  methods: {\n    createGeneralizedAccount,\n    createMetaTx,\n    isGA\n  }\n})\nexport default GeneralizedAccount\n\n/**\n * @alias module:@aeternity/aepp-sdk/es/contract/ga\n * @function\n * Check if account is GA\n * @param {String} address - Account address\n * @return {Boolean}\n */\nasync function isGA (address) {\n  const { contractId } = await this.getAccount(address)\n  return !!contractId\n}\n\n/**\n * Convert current account to GA\n * @alias module:@aeternity/aepp-sdk/es/contract/ga\n * @function\n * @param {String} authFnName - Authorization function name\n * @param {String} source - Auth contract source code\n * @param {Array} [args] - init arguments\n * @param {Object} [options] - Options\n * @return {Promise<Readonly<{\n *   result: *, owner: *, address, rawTx: *, transaction: *\n * }>>}\n */\nasync function createGeneralizedAccount (authFnName, source, args = [], options = {}) {\n  const opt = { ...this.Ae.defaults, ...options }\n  const ownerId = await this.address(opt)\n  if (await this.isGA(ownerId)) throw new IllegalArgumentError(`Account ${ownerId} is already GA`)\n\n  const contract = await this.getContractInstance({ source })\n  await contract.compile()\n  const { tx, contractId } = await this.gaAttachTx({\n    ...opt,\n    gas: opt.gas ?? await contract._estimateGas('init', args, opt),\n    ownerId,\n    code: contract.bytecode,\n    callData: contract.calldata.encode(contract._name, 'init', args),\n    authFun: hash(authFnName)\n  })\n\n  const { hash: transaction, rawTx } = await this.send(tx, opt)\n\n  return Object.freeze({\n    owner: ownerId,\n    transaction,\n    rawTx,\n    gaContractId: contractId\n  })\n}\n\nconst wrapInEmptySignedTx = (tx) => buildTx({ encodedTx: tx, signatures: [] }, TX_TYPE.signed)\n\n/**\n * Create a metaTx transaction\n * @alias module:@aeternity/aepp-sdk/es/contract/ga\n * @function\n * @param {String} rawTransaction Inner transaction\n * @param {Object} authData Object with gaMeta params\n * @param {String} authFnName - Authorization function name\n * @param {Object} options - Options\n * @return {String}\n */\nasync function createMetaTx (rawTransaction, authData, authFnName, options = {}) {\n  if (!authData) throw new MissingParamError('authData is required')\n  // Check if authData is callData or if it's an object prepare a callData from source and args\n  const { authCallData, gas } = await prepareGaParams(this)(authData, authFnName)\n  const opt = { ...this.Ae.defaults, ...options }\n  const { abiVersion } = await this.getVmVersion(TX_TYPE.contractCall)\n  const wrappedTx = wrapInEmptySignedTx(unpackTx(rawTransaction))\n  const params = {\n    ...opt,\n    tx: {\n      ...wrappedTx,\n      tx: wrappedTx.txObject\n    },\n    gaId: await this.address(opt),\n    abiVersion,\n    authData: authCallData,\n    gas,\n    vsn: 2\n  }\n  const { fee } = await this.prepareTxParams(TX_TYPE.gaMeta, params)\n  const { rlpEncoded: metaTxRlp } = buildTx(\n    { ...params, fee: `${fee}` },\n    TX_TYPE.gaMeta,\n    { vsn: 2 }\n  )\n  return wrapInEmptySignedTx(metaTxRlp).tx\n}\n"],"file":"index.mjs"}

package/es/errors.d.ts

@@ -0,0 +1,284 @@
+/**
+ * Error module
+ * @module @aeternity/aepp-sdk/es/utils/errors
+ * @example import { BytecodeMismatchError } from '@aeternity/aepp-sdk'
+ */
+/**
+ * aepp-sdk originated error
+ */
+export declare abstract class BaseError extends Error {
+    constructor(message: string);
+}
+export declare class AccountError extends BaseError {
+    constructor(message: string);
+}
+export declare class AensError extends BaseError {
+    constructor(message: string);
+}
+export declare class AeppError extends BaseError {
+    constructor(message: string);
+}
+export declare class ChannelError extends BaseError {
+    constructor(message: string);
+}
+export declare class CompilerError extends BaseError {
+    constructor(message: string);
+}
+export declare class ContractError extends BaseError {
+    constructor(message: string);
+}
+export declare class CryptographyError extends BaseError {
+    constructor(message: string);
+}
+export declare class NodeError extends BaseError {
+    constructor(message: string);
+}
+export declare class TransactionError extends BaseError {
+    constructor(message: string);
+}
+export declare class WalletError extends BaseError {
+    constructor(message: string);
+}
+export declare class ArgumentError extends BaseError {
+    constructor(argumentName: string, requirement: string, argumentValue: any);
+}
+export declare class IllegalArgumentError extends CryptographyError {
+    constructor(message: string);
+}
+export declare class ArgumentCountMismatchError extends BaseError {
+    constructor(functionName: string, requiredCount: number, providedCount: number);
+}
+export declare class InsufficientBalanceError extends BaseError {
+    constructor(message: string);
+}
+export declare class InvalidDenominationError extends BaseError {
+    constructor(message: string);
+}
+export declare class InvalidNameError extends BaseError {
+    constructor(message: string);
+}
+export declare class MissingParamError extends BaseError {
+    constructor(message: string);
+}
+export declare class NoBrowserFoundError extends BaseError {
+    constructor();
+}
+export declare class NoSerializerFoundError extends BaseError {
+    constructor();
+}
+export declare class RequestTimedOutError extends BaseError {
+    constructor(requestTime: number);
+}
+export declare class TxTimedOutError extends BaseError {
+    constructor(blocks: number, th: string, status?: string);
+}
+export declare class TypeError extends BaseError {
+    constructor(message: string);
+}
+export declare class UnsupportedPlatformError extends BaseError {
+    constructor(message: string);
+}
+export declare class UnsupportedProtocolError extends BaseError {
+    constructor(message: string);
+}
+export declare class NotImplementedError extends BaseError {
+    constructor(message: string);
+}
+export declare class UnsupportedVersionError extends BaseError {
+    constructor(dependency: string, version: string, geVersion: string, ltVersion: string);
+}
+export declare class InternalError extends BaseError {
+    constructor(message: string);
+}
+export declare class InvalidKeypairError extends AccountError {
+    constructor(message: string);
+}
+export declare class UnavailableAccountError extends AccountError {
+    constructor(address: string);
+}
+export declare class AensPointerContextError extends AensError {
+    constructor(nameOrId: string, prefix: string);
+}
+export declare class InsufficientNameFeeError extends AensError {
+    constructor(nameFee: number, minNameFee: number);
+}
+export declare class InvalidAensNameError extends AensError {
+    constructor(message: string);
+}
+export declare class DuplicateCallbackError extends AeppError {
+    constructor();
+}
+export declare class InvalidRpcMessageError extends AeppError {
+    constructor(message: string);
+}
+export declare class MissingCallbackError extends AeppError {
+    constructor(id: string);
+}
+export declare class UnAuthorizedAccountError extends AeppError {
+    constructor(onAccount: string);
+}
+export declare class UnknownRpcClientError extends AeppError {
+    constructor(id: string);
+}
+export declare class UnsubscribedAccountError extends AeppError {
+    constructor();
+}
+export declare class ChannelCallError extends ChannelError {
+    constructor(message: string);
+}
+export declare class ChannelConnectionError extends ChannelError {
+    constructor(message: string);
+}
+export declare class ChannelPingTimedOutError extends ChannelError {
+    constructor();
+}
+export declare class UnexpectedChannelMessageError extends ChannelError {
+    constructor(message: string);
+}
+export declare class UnknownChannelStateError extends ChannelError {
+    constructor();
+}
+export declare class InvalidAuthDataError extends CompilerError {
+    constructor(message: string);
+}
+export declare class BytecodeMismatchError extends ContractError {
+    constructor(source: string);
+}
+export declare class DuplicateContractError extends ContractError {
+    constructor();
+}
+export declare class InactiveContractError extends ContractError {
+    constructor(contractAddress: string);
+}
+export declare class InvalidMethodInvocationError extends ContractError {
+    constructor(message: string);
+}
+export declare class MissingContractAddressError extends ContractError {
+    constructor(message: string);
+}
+export declare class MissingContractDefError extends ContractError {
+    constructor();
+}
+export declare class MissingFunctionNameError extends ContractError {
+    constructor();
+}
+export declare class NodeInvocationError extends ContractError {
+    constructor(message?: string);
+}
+export declare class NoSuchContractFunctionError extends ContractError {
+    constructor(name: string);
+}
+export declare class NotPayableFunctionError extends ContractError {
+    constructor(amount: string, fn: string);
+}
+export declare class MissingEventDefinitionError extends ContractError {
+    constructor(eventNameHash: string, eventAddress: string);
+}
+export declare class AmbiguousEventDefinitionError extends ContractError {
+    constructor(eventAddress: string, matchedEvents: [string, string][]);
+}
+export declare class InvalidChecksumError extends CryptographyError {
+    constructor();
+}
+export declare class InvalidDerivationPathError extends CryptographyError {
+    constructor();
+}
+export declare class InvalidKeyError extends CryptographyError {
+    constructor(message: string);
+}
+export declare class InvalidPasswordError extends CryptographyError {
+    constructor(message: string);
+}
+export declare class MerkleTreeHashMismatchError extends CryptographyError {
+    constructor();
+}
+export declare class MissingNodeInTreeError extends CryptographyError {
+    constructor(message: string);
+}
+export declare class UnsupportedAlgorithmError extends CryptographyError {
+    constructor(algo: string);
+}
+export declare class NotHardenedSegmentError extends CryptographyError {
+    constructor(message: string);
+}
+export declare class UnknownNodeLengthError extends CryptographyError {
+    constructor(nodeLength: number);
+}
+export declare class UnknownPathNibbleError extends CryptographyError {
+    constructor(nibble: number);
+}
+export declare class UnsupportedChildIndexError extends CryptographyError {
+    constructor(index: string);
+}
+export declare class DisconnectedError extends NodeError {
+    constructor();
+}
+export declare class DuplicateNodeError extends NodeError {
+    constructor(name: string);
+}
+export declare class NodeNotFoundError extends NodeError {
+    constructor(message: string);
+}
+export declare class DecodeError extends TransactionError {
+    constructor(message: string);
+}
+export declare class EncodeError extends TransactionError {
+    constructor(message: string);
+}
+export declare class PayloadLengthError extends TransactionError {
+    constructor(message: string);
+}
+export declare class DryRunError extends TransactionError {
+    constructor(message: string);
+}
+export declare class IllegalBidFeeError extends TransactionError {
+    constructor(message: string);
+}
+export declare class InvalidSignatureError extends TransactionError {
+    constructor(message: string);
+}
+export declare class InvalidTxError extends TransactionError {
+    constructor(message: string);
+}
+export declare class InvalidTxParamsError extends TransactionError {
+    constructor(message: string);
+}
+export declare class NoDefaultAensPointerError extends TransactionError {
+    constructor(prefix: string);
+}
+export declare class PrefixMismatchError extends TransactionError {
+    constructor(prefix: string, requiredPrefix: string);
+}
+export declare class PrefixNotFoundError extends TransactionError {
+    constructor(tag: string);
+}
+export declare class SchemaNotFoundError extends TransactionError {
+    constructor(message: string);
+}
+export declare class TagNotFoundError extends TransactionError {
+    constructor(prefix: string);
+}
+export declare class TxNotInChainError extends TransactionError {
+    constructor(txHash: string);
+}
+export declare class UnknownTxError extends TransactionError {
+    constructor(message: string);
+}
+export declare class UnsupportedABIversionError extends TransactionError {
+    constructor(message: string);
+}
+export declare class UnsupportedVMversionError extends TransactionError {
+    constructor(message: string);
+}
+export declare class AlreadyConnectedError extends WalletError {
+    constructor(message: string);
+}
+export declare class MessageDirectionError extends WalletError {
+    constructor(message: string);
+}
+export declare class NoWalletConnectedError extends WalletError {
+    constructor(message: string);
+}
+export declare class RpcConnectionError extends WalletError {
+    constructor(message: string);
+}

package/es/index.mjs

@@ -0,0 +1,57 @@
+/*
+ * ISC License (ISC)
+ * Copyright (c) 2021 aeternity developers
+ *
+ *  Permission to use, copy, modify, and/or distribute this software for any
+ *  purpose with or without fee is hereby granted, provided that the above
+ *  copyright notice and this permission notice appear in all copies.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+ *  REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+ *  AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+ *  INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+ *  LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+ *  OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+ *  PERFORMANCE OF THIS SOFTWARE.
+ */
+import * as Crypto from "./utils/crypto.mjs";
+import * as Keystore from "./utils/keystore.mjs";
+import * as Bytes from "./utils/bytes.mjs";
+import * as TxBuilder from "./tx/builder/index.mjs";
+import * as TxBuilderHelper from "./tx/builder/helpers.mjs";
+import * as SCHEMA from "./tx/builder/schema.mjs";
+import * as AmountFormatter from "./utils/amount-formatter.mjs";
+import * as HdWallet from "./utils/hd-wallet.mjs";
+import Ae from "./ae/index.mjs";
+import Chain from "./chain/index.mjs";
+import ChainNode from "./chain/node.mjs";
+import Node from "./node.mjs";
+import NodePool from "./node-pool/index.mjs";
+import Tx from "./tx/index.mjs";
+import Transaction from "./tx/tx.mjs";
+import verifyTransaction from "./tx/validator.mjs";
+import AccountBase from "./account/base.mjs";
+import AccountMultiple from "./account/multiple.mjs";
+import MemoryAccount from "./account/memory.mjs";
+import Aens from "./ae/aens.mjs";
+import Contract from "./ae/contract.mjs";
+import GeneralizedAccount from "./contract/ga/index.mjs";
+import ContractCompilerHttp from "./contract/compiler.mjs";
+import RpcAepp from "./ae/aepp.mjs";
+import RpcWallet from "./ae/wallet.mjs";
+import Oracle from "./ae/oracle.mjs";
+import genSwaggerClient from "./utils/swagger.mjs";
+import Channel from "./channel/index.mjs";
+import Universal from "./ae/universal.mjs";
+export { default as ContentScriptBridge } from "./utils/aepp-wallet-communication/content-script-bridge.mjs";
+import * as _AeppWalletHelpers from "./utils/aepp-wallet-communication/helpers.mjs";
+export { _AeppWalletHelpers as AeppWalletHelpers };
+import * as _AeppWalletSchema from "./utils/aepp-wallet-communication/schema.mjs";
+export { _AeppWalletSchema as AeppWalletSchema };
+export { default as WalletDetector } from "./utils/aepp-wallet-communication/wallet-detector.mjs";
+export { default as BrowserRuntimeConnection } from "./utils/aepp-wallet-communication/connection/browser-runtime.mjs";
+export { default as BrowserWindowMessageConnection } from "./utils/aepp-wallet-communication/connection/browser-window-message.mjs";
+export * from "./utils/errors.mjs";
+export const getDefaultPointerKey = TxBuilderHelper.getDefaultPointerKey;
+export { AmountFormatter, AccountBase, AccountMultiple, Ae, Aens, Bytes, Contract, ContractCompilerHttp, ChainNode, RpcAepp, RpcWallet, Channel, Crypto, Keystore, Chain, GeneralizedAccount, HdWallet, MemoryAccount, Node, NodePool, Oracle, genSwaggerClient, Transaction, verifyTransaction, Tx, TxBuilder, TxBuilderHelper, Universal, SCHEMA };
+//# sourceMappingURL=index.mjs.map

package/es/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.js"],"names":["Crypto","Keystore","Bytes","TxBuilder","TxBuilderHelper","SCHEMA","AmountFormatter","HdWallet","Ae","Chain","ChainNode","Node","NodePool","Tx","Transaction","verifyTransaction","AccountBase","AccountMultiple","MemoryAccount","Aens","Contract","GeneralizedAccount","ContractCompilerHttp","RpcAepp","RpcWallet","Oracle","genSwaggerClient","Channel","Universal","default","ContentScriptBridge","AeppWalletHelpers","AeppWalletSchema","WalletDetector","BrowserRuntimeConnection","BrowserWindowMessageConnection","getDefaultPointerKey"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;OAEO,KAAKA,M;OACL,KAAKC,Q;OACL,KAAKC,K;OACL,KAAKC,S;OACL,KAAKC,e;OACL,KAAKC,M;OACL,KAAKC,e;OACL,KAAKC,Q;OAELC,E;OACAC,K;OACAC,S;OACAC,I;OACAC,Q;OACAC,E;OACAC,W;OACAC,iB;OACAC,W;OACAC,e;OACAC,a;OACAC,I;OACAC,Q;OACAC,kB;OACAC,oB;OACAC,O;OACAC,S;OACAC,M;OACAC,gB;OACAC,O;OACAC,S;SAEEC,OAAO,IAAIC,mB;;+BACRC,iB;;8BACAC,gB;SACHH,OAAO,IAAII,c;SACXJ,OAAO,IAAIK,wB;SACXL,OAAO,IAAIM,8B;;AAGpB,OAAO,MAAMC,oBAAoB,GAAGhC,eAAe,CAACgC,oBAA7C;AAEP,SACE9B,eADF,EAEEU,WAFF,EAGEC,eAHF,EAIET,EAJF,EAKEW,IALF,EAMEjB,KANF,EAOEkB,QAPF,EAQEE,oBARF,EASEZ,SATF,EAUEa,OAVF,EAWEC,SAXF,EAYEG,OAZF,EAaE3B,MAbF,EAcEC,QAdF,EAeEQ,KAfF,EAgBEY,kBAhBF,EAiBEd,QAjBF,EAkBEW,aAlBF,EAmBEP,IAnBF,EAoBEC,QApBF,EAqBEa,MArBF,EAsBEC,gBAtBF,EAuBEZ,WAvBF,EAwBEC,iBAxBF,EAyBEF,EAzBF,EA0BEV,SA1BF,EA2BEC,eA3BF,EA4BEwB,SA5BF,EA6BEvB,MA7BF","sourcesContent":["/*\n * ISC License (ISC)\n * Copyright (c) 2021 aeternity developers\n *\n *  Permission to use, copy, modify, and/or distribute this software for any\n *  purpose with or without fee is hereby granted, provided that the above\n *  copyright notice and this permission notice appear in all copies.\n *\n *  THE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH\n *  REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY\n *  AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,\n *  INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM\n *  LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR\n *  OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR\n *  PERFORMANCE OF THIS SOFTWARE.\n */\n\nimport * as Crypto from './utils/crypto'\nimport * as Keystore from './utils/keystore'\nimport * as Bytes from './utils/bytes'\nimport * as TxBuilder from './tx/builder'\nimport * as TxBuilderHelper from './tx/builder/helpers'\nimport * as SCHEMA from './tx/builder/schema'\nimport * as AmountFormatter from './utils/amount-formatter'\nimport * as HdWallet from './utils/hd-wallet'\n\nimport Ae from './ae'\nimport Chain from './chain'\nimport ChainNode from './chain/node'\nimport Node from './node'\nimport NodePool from './node-pool'\nimport Tx from './tx'\nimport Transaction from './tx/tx'\nimport verifyTransaction from './tx/validator'\nimport AccountBase from './account/base'\nimport AccountMultiple from './account/multiple'\nimport MemoryAccount from './account/memory'\nimport Aens from './ae/aens'\nimport Contract from './ae/contract'\nimport GeneralizedAccount from './contract/ga'\nimport ContractCompilerHttp from './contract/compiler'\nimport RpcAepp from './ae/aepp'\nimport RpcWallet from './ae/wallet'\nimport Oracle from './ae/oracle'\nimport genSwaggerClient from './utils/swagger'\nimport Channel from './channel'\nimport Universal from './ae/universal'\n\nexport { default as ContentScriptBridge } from './utils/aepp-wallet-communication/content-script-bridge'\nexport * as AeppWalletHelpers from './utils/aepp-wallet-communication/helpers'\nexport * as AeppWalletSchema from './utils/aepp-wallet-communication/schema'\nexport { default as WalletDetector } from './utils/aepp-wallet-communication/wallet-detector'\nexport { default as BrowserRuntimeConnection } from './utils/aepp-wallet-communication/connection/browser-runtime'\nexport { default as BrowserWindowMessageConnection } from './utils/aepp-wallet-communication/connection/browser-window-message'\nexport * from './utils/errors'\n\nexport const getDefaultPointerKey = TxBuilderHelper.getDefaultPointerKey\n\nexport {\n  AmountFormatter,\n  AccountBase,\n  AccountMultiple,\n  Ae,\n  Aens,\n  Bytes,\n  Contract,\n  ContractCompilerHttp,\n  ChainNode,\n  RpcAepp,\n  RpcWallet,\n  Channel,\n  Crypto,\n  Keystore,\n  Chain,\n  GeneralizedAccount,\n  HdWallet,\n  MemoryAccount,\n  Node,\n  NodePool,\n  Oracle,\n  genSwaggerClient,\n  Transaction,\n  verifyTransaction,\n  Tx,\n  TxBuilder,\n  TxBuilderHelper,\n  Universal,\n  SCHEMA\n}\n"],"file":"index.mjs"}

package/es/node-pool/{index.js → index.mjs}

@@ -5,7 +5,8 @@
  * @example import { NodePool } from '@aeternity/aepp-sdk'
  */
 import stampit from '@stamp/it';
-import { getNetworkId } from '../node';
+import { getNetworkId } from "../node.mjs";
+import { DisconnectedError, DuplicateNodeError, NodeNotFoundError, TypeError } from "../utils/errors.mjs";
 /**
  * Node Pool Stamp
  * This stamp allow you to make basic manipulation(add, remove, select) on list of nodes
@@ -41,7 +42,7 @@ export default stampit({
 
       get() {
         if (!this.selectedNode || !this.selectedNode.instance) {
-          throw new Error('You can\'t use Node API. Node is not connected or not defined!');
+          throw new NodeNotFoundError('You can\'t use Node API. Node is not connected or not defined!');
         }
 
         return this.selectedNode.instance.api;
@@ -65,7 +66,7 @@ export default stampit({
      */
     addNode(name, node) {
       let select = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
-      if (this.pool.has(name)) throw new Error(`Node with name ${name} already exist`);
+      if (this.pool.has(name)) throw new DuplicateNodeError(name);
       this.validateNodes([{
         name,
         instance: node
@@ -96,7 +97,7 @@ export default stampit({
      * nodePool.selectNode('testNode')
      */
     selectNode(name) {
-      if (!this.pool.has(name)) throw new Error(`Node with name ${name} not in pool`);
+      if (!this.pool.has(name)) throw new NodeNotFoundError(`Node with name ${name} not in pool`);
       this.selectedNode = this.pool.get(name);
     },
 
@@ -134,7 +135,7 @@ export default stampit({
      * nodePool.getNodeInfo() // { name, version, networkId, protocol, ... }
      */
     getNodeInfo() {
-      if (!this.isNodeConnected()) throw new Error('Can not get node info. Node is not connected');
+      if (!this.isNodeConnected()) throw new DisconnectedError();
       return {
         name: this.selectedNode.name,
         ...this.selectedNode.instance.getNodeInfo()
@@ -163,19 +164,19 @@ export default stampit({
     validateNodes(nodes) {
       // TODO: validate it on TypeScript level instead
       // (to speedup development, save runtime resources)
-      if (!Array.isArray(nodes)) throw new Error('"nodes" should be an array');
+      if (!Array.isArray(nodes)) throw new TypeError('"nodes" should be an array');
       const notObject = nodes.map(n => typeof n).find(t => t !== 'object');
-      if (notObject) throw new Error(`Each node should be an object, got ${notObject} instead`);
+      if (notObject) throw new TypeError(`Each node should be an object, got ${notObject} instead`);
       const wrongFields = nodes.find(n => typeof n.name !== 'string' || typeof n.instance !== 'object');
 
       if (notObject) {
-        throw new Error('Each node should have name (string), instance (object) ' + `fields, got ${JSON.stringify(wrongFields)} instead`);
+        throw new TypeError('Each node should have name (string), instance (object) ' + `fields, got ${JSON.stringify(wrongFields)} instead`);
       }
 
       const wrongInstanceFields = nodes.map(n => n.instance).find(i => typeof i.api !== 'object' || typeof i.genesisHash !== 'string' || typeof i.consensusProtocolVersion !== 'number');
 
       if (wrongInstanceFields) {
-        throw new Error('Each node instance should have api (object), consensusProtocolVersion (number), ' + `genesisHash (string) fields, got ${JSON.stringify(wrongInstanceFields)} instead`);
+        throw new TypeError('Each node instance should have api (object), consensusProtocolVersion (number), ' + `genesisHash (string) fields, got ${JSON.stringify(wrongInstanceFields)} instead`);
       }
     }
 
@@ -184,4 +185,4 @@ export default stampit({
     selectedNode: {}
   }
 });
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.mjs.map