@aeternity/aepp-sdk 9.0.1 → 11.0.0

package/es/ae/index.mjs

@@ -0,0 +1,207 @@
+/*
+ * ISC License (ISC)
+ * Copyright (c) 2018 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.
+ */
+
+/**
+ * Ae module
+ * @module @aeternity/aepp-sdk/es/ae
+ * @export Ae
+ * @example import { Ae } from '@aeternity/aepp-sdk'
+ */
+import stampit from '@stamp/it';
+import Tx from "../tx/index.mjs";
+import Chain from "../chain/index.mjs";
+import AccountBase from "../account/base.mjs";
+import TxBuilder from "../tx/builder/index.mjs";
+import BigNumber from 'bignumber.js';
+import { AE_AMOUNT_FORMATS } from "../utils/amount-formatter.mjs";
+import { ArgumentError } from "../utils/errors.mjs";
+/**
+ * Sign and post a transaction to the chain
+ * @instance
+ * @category async
+ * @rtype (tx: String, options: Object) => Promise[String]
+ * @param {String} tx - Transaction
+ * @param {Object} [options={}] options - Options
+ * @param {Object} [options.verify=true] - Verify transaction before broadcast, throw error if not
+ * valid
+ * @return {Object} Transaction
+ */
+
+async function send(tx) {
+  let options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  const opt = { ...this.Ae.defaults,
+    ...options
+  };
+  const {
+    contractId,
+    authFun
+  } = options.innerTx ? {
+    contractId: false
+  } : await this.getAccount(await this.address(opt));
+  const signed = contractId ? await this.signUsingGA(tx, { ...opt,
+    authFun
+  }) : await this.signTransaction(tx, opt);
+  return opt.innerTx ? {
+    hash: TxBuilder.buildTxHash(signed),
+    rawTx: signed
+  } : this.sendTransaction(signed, opt);
+}
+
+async function signUsingGA(tx) {
+  let {
+    authData,
+    authFun,
+    ...options
+  } = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  return this.createMetaTx(tx, authData, authFun, options);
+}
+/**
+ * Send tokens to another account
+ * @instance
+ * @category async
+ * @rtype (amount: Number|String, recipientIdOrName: String, options?: Object) => Promise[String]
+ * @param {Number|String} amount - Amount to spend
+ * @param {String} recipientIdOrName - Address or name of recipient account
+ * @param {Object} [options] - Options
+ * @return {Object} Transaction
+ */
+
+
+async function spend(amount, recipientIdOrName, options) {
+  const opt = { ...this.Ae.defaults,
+    ...options
+  };
+  return this.send(await this.spendTx({ ...opt,
+    senderId: await this.address(opt),
+    recipientId: await this.resolveName(recipientIdOrName, 'account_pubkey', opt),
+    amount
+  }), opt);
+} // TODO: Rename to spendFraction
+
+/**
+ * Send a fraction of token balance to another account
+ * @instance
+ * @category async
+ * @rtype (fraction: Number|String, recipientIdOrName: String, options?: Object) => Promise[String]
+ * @param {Number|String} fraction - Fraction of balance to spend (between 0 and 1)
+ * @param {String} recipientIdOrName - Address or name of recipient account
+ * @param {Object} [options] - Options
+ * @return {Object} Transaction
+ */
+
+
+async function transferFunds(fraction, recipientIdOrName, options) {
+  if (fraction < 0 || fraction > 1) {
+    throw new ArgumentError('fraction', 'a number between 0 and 1', fraction);
+  }
+
+  const opt = { ...this.Ae.defaults,
+    ...options
+  };
+  const recipientId = await this.resolveName(recipientIdOrName, 'account_pubkey', opt);
+  const senderId = await this.address(opt);
+  const balance = new BigNumber(await this.balance(senderId));
+  const desiredAmount = balance.times(fraction).integerValue(BigNumber.ROUND_HALF_UP);
+  const {
+    tx: {
+      fee
+    }
+  } = TxBuilder.unpackTx(await this.spendTx({ ...opt,
+    senderId,
+    recipientId,
+    amount: desiredAmount
+  })); // Reducing of the amount may reduce transaction fee, so this is not completely accurate
+
+  const amount = desiredAmount.plus(fee).gt(balance) ? balance.minus(fee) : desiredAmount;
+  return this.send(await this.spendTx({ ...opt,
+    senderId,
+    recipientId,
+    amount
+  }), opt);
+}
+/**
+ * Submit transaction of another account paying for it (fee and gas)
+ * @instance
+ * @category async
+ * @rtype (transaction: String, options?: Object) => Promise[String]
+ * @param {String} transaction - tx_<base64>-encoded transaction
+ * @param {Object} [options]
+ * @return {Object} Transaction
+ */
+
+
+async function payForTransaction(transaction, options) {
+  const opt = { ...this.Ae.defaults,
+    ...options
+  };
+  return this.send(await this.payingForTx({ ...opt,
+    payerId: await this.address(opt),
+    tx: transaction
+  }), opt);
+}
+/**
+ * Remove all listeners for RPC
+ * @instance
+ * @return {void}
+ */
+
+
+function destroyInstance() {
+  const destroyMethods = ['destroyClient', 'destroyServer']; // Array with destroy function's
+
+  destroyMethods.forEach(m => this[m] && typeof this[m] === 'function' && this[m]());
+}
+/**
+ * Basic Ae Stamp
+ *
+ * Attempting to create instances from the Stamp without overwriting all
+ * abstract methods using composition will result in an exception.
+ *
+ * Ae objects are the composition of three basic building blocks:
+ * * {@link module:@aeternity/aepp-sdk/es/tx--Tx}
+ * * {@link module:@aeternity/aepp-sdk/es/account--Account}
+ * * {@link module:@aeternity/aepp-sdk/es/chain--Chain}
+ * Only by providing the joint functionality of those three, most more advanced
+ * operations, i.e. the ones with actual use value on the chain, become
+ * available.
+ * @function
+ * @alias module:@aeternity/aepp-sdk/es/ae
+ * @rtype Stamp
+ * @param {Object} [options={}] - Initializer object
+ * @return {Object} Ae instance
+ */
+
+
+const Ae = stampit(Tx, AccountBase, Chain, {
+  methods: {
+    send,
+    spend,
+    transferFunds,
+    payForTransaction,
+    destroyInstance,
+    signUsingGA
+  },
+  deepProps: {
+    Ae: {
+      defaults: {
+        denomination: AE_AMOUNT_FORMATS.AETTOS
+      }
+    }
+  }
+});
+export default Ae;
+//# sourceMappingURL=index.mjs.map

package/es/ae/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/ae/index.js"],"names":["stampit","Tx","Chain","AccountBase","TxBuilder","BigNumber","AE_AMOUNT_FORMATS","ArgumentError","send","tx","options","opt","Ae","defaults","contractId","authFun","innerTx","getAccount","address","signed","signUsingGA","signTransaction","hash","buildTxHash","rawTx","sendTransaction","authData","createMetaTx","spend","amount","recipientIdOrName","spendTx","senderId","recipientId","resolveName","transferFunds","fraction","balance","desiredAmount","times","integerValue","ROUND_HALF_UP","fee","unpackTx","plus","gt","minus","payForTransaction","transaction","payingForTx","payerId","destroyInstance","destroyMethods","forEach","m","methods","deepProps","denomination","AETTOS"],"mappings":"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","sourcesContent":["/*\n * ISC License (ISC)\n * Copyright (c) 2018 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 * Ae module\n * @module @aeternity/aepp-sdk/es/ae\n * @export Ae\n * @example import { Ae } from '@aeternity/aepp-sdk'\n */\n\nimport stampit from '@stamp/it'\nimport Tx from '../tx'\nimport Chain from '../chain'\nimport AccountBase from '../account/base'\nimport TxBuilder from '../tx/builder'\nimport BigNumber from 'bignumber.js'\nimport { AE_AMOUNT_FORMATS } from '../utils/amount-formatter'\nimport { ArgumentError } from '../utils/errors'\n\n/**\n * Sign and post a transaction to the chain\n * @instance\n * @category async\n * @rtype (tx: String, options: Object) => Promise[String]\n * @param {String} tx - Transaction\n * @param {Object} [options={}] options - Options\n * @param {Object} [options.verify=true] - Verify transaction before broadcast, throw error if not\n * valid\n * @return {Object} Transaction\n */\nasync function send (tx, options = {}) {\n  const opt = { ...this.Ae.defaults, ...options }\n  const { contractId, authFun } = options.innerTx\n    ? { contractId: false }\n    : await this.getAccount(await this.address(opt))\n  const signed = contractId\n    ? await this.signUsingGA(tx, { ...opt, authFun })\n    : await this.signTransaction(tx, opt)\n  return opt.innerTx\n    ? { hash: TxBuilder.buildTxHash(signed), rawTx: signed }\n    : this.sendTransaction(signed, opt)\n}\n\nasync function signUsingGA (tx, { authData, authFun, ...options } = {}) {\n  return this.createMetaTx(tx, authData, authFun, options)\n}\n\n/**\n * Send tokens to another account\n * @instance\n * @category async\n * @rtype (amount: Number|String, recipientIdOrName: String, options?: Object) => Promise[String]\n * @param {Number|String} amount - Amount to spend\n * @param {String} recipientIdOrName - Address or name of recipient account\n * @param {Object} [options] - Options\n * @return {Object} Transaction\n */\nasync function spend (amount, recipientIdOrName, options) {\n  const opt = { ...this.Ae.defaults, ...options }\n  return this.send(\n    await this.spendTx({\n      ...opt,\n      senderId: await this.address(opt),\n      recipientId: await this.resolveName(recipientIdOrName, 'account_pubkey', opt),\n      amount\n    }),\n    opt\n  )\n}\n\n// TODO: Rename to spendFraction\n/**\n * Send a fraction of token balance to another account\n * @instance\n * @category async\n * @rtype (fraction: Number|String, recipientIdOrName: String, options?: Object) => Promise[String]\n * @param {Number|String} fraction - Fraction of balance to spend (between 0 and 1)\n * @param {String} recipientIdOrName - Address or name of recipient account\n * @param {Object} [options] - Options\n * @return {Object} Transaction\n */\nasync function transferFunds (fraction, recipientIdOrName, options) {\n  if (fraction < 0 || fraction > 1) {\n    throw new ArgumentError('fraction', 'a number between 0 and 1', fraction)\n  }\n  const opt = { ...this.Ae.defaults, ...options }\n  const recipientId = await this.resolveName(recipientIdOrName, 'account_pubkey', opt)\n  const senderId = await this.address(opt)\n  const balance = new BigNumber(await this.balance(senderId))\n  const desiredAmount = balance.times(fraction).integerValue(BigNumber.ROUND_HALF_UP)\n  const { tx: { fee } } = TxBuilder.unpackTx(\n    await this.spendTx({ ...opt, senderId, recipientId, amount: desiredAmount })\n  )\n  // Reducing of the amount may reduce transaction fee, so this is not completely accurate\n  const amount = desiredAmount.plus(fee).gt(balance) ? balance.minus(fee) : desiredAmount\n  return this.send(await this.spendTx({ ...opt, senderId, recipientId, amount }), opt)\n}\n\n/**\n * Submit transaction of another account paying for it (fee and gas)\n * @instance\n * @category async\n * @rtype (transaction: String, options?: Object) => Promise[String]\n * @param {String} transaction - tx_<base64>-encoded transaction\n * @param {Object} [options]\n * @return {Object} Transaction\n */\nasync function payForTransaction (transaction, options) {\n  const opt = { ...this.Ae.defaults, ...options }\n  return this.send(\n    await this.payingForTx({\n      ...opt,\n      payerId: await this.address(opt),\n      tx: transaction\n    }),\n    opt\n  )\n}\n\n/**\n * Remove all listeners for RPC\n * @instance\n * @return {void}\n */\nfunction destroyInstance () {\n  const destroyMethods = ['destroyClient', 'destroyServer'] // Array with destroy function's\n  destroyMethods.forEach(m => this[m] && typeof this[m] === 'function' && this[m]())\n}\n\n/**\n * Basic Ae Stamp\n *\n * Attempting to create instances from the Stamp without overwriting all\n * abstract methods using composition will result in an exception.\n *\n * Ae objects are the composition of three basic building blocks:\n * * {@link module:@aeternity/aepp-sdk/es/tx--Tx}\n * * {@link module:@aeternity/aepp-sdk/es/account--Account}\n * * {@link module:@aeternity/aepp-sdk/es/chain--Chain}\n * Only by providing the joint functionality of those three, most more advanced\n * operations, i.e. the ones with actual use value on the chain, become\n * available.\n * @function\n * @alias module:@aeternity/aepp-sdk/es/ae\n * @rtype Stamp\n * @param {Object} [options={}] - Initializer object\n * @return {Object} Ae instance\n */\nconst Ae = stampit(Tx, AccountBase, Chain, {\n  methods: { send, spend, transferFunds, payForTransaction, destroyInstance, signUsingGA },\n  deepProps: { Ae: { defaults: { denomination: AE_AMOUNT_FORMATS.AETTOS } } }\n})\n\nexport default Ae\n"],"file":"index.mjs"}

package/es/ae/oracle.mjs

@@ -0,0 +1,339 @@
+/*
+ * ISC License (ISC)
+ * Copyright (c) 2018 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.
+ */
+
+/**
+ * Oracle module - routines to interact with the æternity oracle system
+ *
+ * The high-level description of the oracle system is
+ * https://github.com/aeternity/protocol/blob/master/ORACLE.md in the protocol
+ * repository.
+ * @module @aeternity/aepp-sdk/es/ae/oracle
+ * @export Oracle
+ * @example import { Oracle } from '@aeternity/aepp-sdk'
+ */
+import Ae from "./index.mjs";
+import { pause } from "../utils/other.mjs";
+import { oracleQueryId, decode } from "../tx/builder/helpers.mjs";
+import { unpackTx } from "../tx/builder/index.mjs";
+import { ORACLE_TTL, QUERY_FEE, QUERY_TTL, RESPONSE_TTL } from "../tx/builder/schema.mjs";
+import { RequestTimedOutError } from "../utils/errors.mjs";
+/**
+ * Constructor for Oracle Object (helper object for using Oracle)
+ * @alias module:@aeternity/aepp-sdk/es/ae/oracle
+ * @instance
+ * @function
+ * @category async
+ * @param {String} oracleId Oracle public key
+ * @return {Promise<Object>} Oracle object
+ */
+
+async function getOracleObject(oracleId) {
+  const oracle = await this.api.getOracleByPubkey(oracleId);
+  const {
+    oracleQueries: queries
+  } = await this.api.getOracleQueriesByPubkey(oracleId);
+  return { ...oracle,
+    queries,
+    pollQueries: this.pollForQueries.bind(this, oracleId),
+    postQuery: this.postQueryToOracle.bind(this, oracleId),
+    respondToQuery: this.respondToQuery.bind(this, oracleId),
+    extendOracle: this.extendOracleTtl.bind(this, oracleId),
+    getQuery: this.getQueryObject.bind(this, oracleId)
+  };
+}
+/**
+ * Poll for oracle queries
+ * @alias module:@aeternity/aepp-sdk/es/ae/oracle
+ * @instance
+ * @function
+ * @param {String} oracleId Oracle public key
+ * @param {Function} onQuery OnQuery callback
+ * @param {Object} [options] Options object
+ * @param {Number} [options.interval] Poll interval(default: 5000)
+ * @return {Function} stopPolling - Stop polling function
+ */
+
+
+function pollForQueries(oracleId, onQuery) {
+  let {
+    interval = this._getPollInterval('microblock')
+  } = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+  const knownQueryIds = new Set();
+
+  const checkNewQueries = async () => {
+    const queries = ((await this.api.getOracleQueriesByPubkey(oracleId)).oracleQueries || []).filter(_ref => {
+      let {
+        id
+      } = _ref;
+      return !knownQueryIds.has(id);
+    });
+    queries.forEach(_ref2 => {
+      let {
+        id
+      } = _ref2;
+      return knownQueryIds.add(id);
+    });
+    if (queries.length) onQuery(queries);
+  };
+
+  let stopped;
+
+  (async () => {
+    while (!stopped) {
+      // eslint-disable-line no-unmodified-loop-condition
+      // TODO: allow to handle this error somehow
+      await checkNewQueries().catch(console.error);
+      await pause(interval);
+    }
+  })();
+
+  return () => {
+    stopped = true;
+  };
+}
+/**
+ * Constructor for OracleQuery Object (helper object for using OracleQuery)
+ * @alias module:@aeternity/aepp-sdk/es/ae/oracle
+ * @instance
+ * @function
+ * @category async
+ * @param {String} oracleId Oracle public key
+ * @param {String} queryId Oracle Query id
+ * @return {Promise<Object>} OracleQuery object
+ */
+
+
+async function getQueryObject(oracleId, queryId) {
+  const q = await this.api.getOracleQueryByPubkeyAndQueryId(oracleId, queryId);
+  return { ...q,
+    decodedQuery: decode(q.query).toString(),
+    decodedResponse: decode(q.response).toString(),
+    respond: this.respondToQuery.bind(this, oracleId, queryId),
+    pollForResponse: this.pollForQueryResponse.bind(this, oracleId, queryId),
+
+    /**
+     * @deprecated use TxBuilderHelper.decode instead
+     * @param data
+     * @returns {Buffer}
+     */
+    decode: data => decode(data)
+  };
+}
+/**
+ * Poll for oracle query response
+ * @alias module:@aeternity/aepp-sdk/es/ae/oracle
+ * @instance
+ * @function
+ * @category async
+ * @param {String} oracleId Oracle public key
+ * @param {String} queryId Oracle Query id
+ * @param {Object} [options] Options object
+ * @param {Object} [options.attempts] Poll attempt's(default: 20)
+ * @param {Object} [options.interval] Poll interval(default: 5000)
+ * @return {Promise<Object>} OracleQuery object
+ */
+
+
+export async function pollForQueryResponse(oracleId, queryId) {
+  let {
+    attempts = 20,
+    interval = this._getPollInterval('microblock')
+  } = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+
+  for (let i = 0; i < attempts; i++) {
+    if (i) await pause(interval);
+    const {
+      response
+    } = await this.api.getOracleQueryByPubkeyAndQueryId(oracleId, queryId);
+    const responseBuffer = decode(response, 'or');
+
+    if (responseBuffer.length) {
+      return String(responseBuffer);
+    }
+  }
+
+  throw new RequestTimedOutError((attempts - 1) * interval);
+}
+/**
+ * Register oracle
+ * @alias module:@aeternity/aepp-sdk/es/ae/oracle
+ * @instance
+ * @function
+ * @category async
+ * @param {String} queryFormat Format of query
+ * @param {String} responseFormat Format of query response
+ * @param {Object} [options={}] Options
+ * @param {String|Number} [options.queryFee] Oracle query Fee
+ * @param {Object} [options.oracleTtl] OracleTtl object {type: 'delta|block', value: 'number'}
+ * @param {Number} [options.abiVersion] Always 0 (do not use virtual machine)
+ * @param {Number|String} [options.fee] Transaction fee
+ * @param {Number|String} [options.ttl] Transaction time to leave
+ * @return {Promise<Object>} Oracle object
+ */
+
+async function registerOracle(queryFormat, responseFormat) {
+  let options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+  const opt = { ...this.Ae.defaults,
+    ...options
+  }; // Preset VmVersion for oracle
+
+  const accountId = await this.address(opt);
+  const oracleRegisterTx = await this.oracleRegisterTx({ ...opt,
+    accountId,
+    queryFormat,
+    responseFormat
+  });
+  return { ...(await this.send(oracleRegisterTx, opt)),
+    ...(await this.getOracleObject(`ok_${accountId.slice(3)}`))
+  };
+}
+/**
+ * Post query to oracle
+ * @alias module:@aeternity/aepp-sdk/es/ae/oracle
+ * @instance
+ * @function
+ * @category async
+ * @param {String} oracleId Oracle public key
+ * @param {String} query Oracle query object
+ * @param {Object} [options={}]
+ * @param {String|Number} [options.queryTtl] queryTtl Oracle query time to leave
+ * @param {String|Number} [options.responseTtl] queryFee Oracle query response time to leave
+ * @param {String|Number} [options.queryFee] queryFee Oracle query fee
+ * @param {Number} [options.fee] fee Transaction fee
+ * @param {Number} [options.ttl] Transaction time to leave
+ * @return {Promise<Object>} Query object
+ */
+
+
+async function postQueryToOracle(oracleId, query) {
+  let options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+  const queryFee = options.queryFee || (await this.api.getOracleByPubkey(oracleId)).queryFee;
+  const opt = { ...this.Ae.defaults,
+    queryFee,
+    ...options
+  };
+  const senderId = await this.address(opt);
+  const oracleRegisterTx = await this.oraclePostQueryTx({ ...opt,
+    oracleId,
+    senderId,
+    query
+  });
+  const queryId = oracleQueryId(senderId, unpackTx(oracleRegisterTx).tx.nonce, oracleId);
+  return { ...(await this.send(oracleRegisterTx, opt)),
+    ...(await this.getQueryObject(oracleId, queryId))
+  };
+}
+/**
+ * Extend oracle ttl
+ * @alias module:@aeternity/aepp-sdk/es/ae/oracle
+ * @instance
+ * @function
+ * @category async
+ * @param {String} oracleId Oracle public key
+ * @param {String} oracleTtl Oracle time to leave for extend
+ * @param {Object} [options={}]
+ * @param {Number} [options.fee] fee Transaction fee
+ * @param {Number} [options.ttl] Transaction time to leave
+ * @return {Promise<Object>} Oracle object
+ */
+
+
+async function extendOracleTtl(oracleId, oracleTtl) {
+  let options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+  const opt = { ...this.Ae.defaults,
+    ...options
+  };
+  const callerId = await this.address(opt);
+  const oracleExtendTx = await this.oracleExtendTx({ ...opt,
+    oracleId,
+    callerId,
+    oracleTtl
+  });
+  return { ...(await this.send(oracleExtendTx, opt)),
+    ...(await this.getOracleObject(oracleId))
+  };
+}
+/**
+ * Extend oracle ttl
+ * @alias module:@aeternity/aepp-sdk/es/ae/oracle
+ * @instance
+ * @function
+ * @category async
+ * @param {String} oracleId Oracle public key
+ * @param {String} queryId Oracle query id
+ * @param {String} response Oracle query response
+ * @param {Object} [options={}]
+ * @param {Number} [options.responseTtl] responseTtl Query response time to leave
+ * @param {Number} [options.fee] Transaction fee
+ * @param {Number} [options.ttl] Transaction time to leave
+ * @return {Promise<Object>} Oracle object
+ */
+
+
+async function respondToQuery(oracleId, queryId, response) {
+  let options = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {};
+  const opt = { ...this.Ae.defaults,
+    ...options
+  };
+  const callerId = await this.address(opt);
+  const oracleRespondTx = await this.oracleRespondTx({ ...opt,
+    oracleId,
+    queryId,
+    callerId,
+    response
+  });
+  return { ...(await this.send(oracleRespondTx, opt)),
+    ...(await this.getOracleObject(oracleId))
+  };
+}
+/**
+ * Oracle Stamp
+ *
+ * Oracle provides oracle-system related methods atop
+ * {@link module:@aeternity/aepp-sdk/es/ae--Ae} clients.
+ * @function
+ * @alias module:@aeternity/aepp-sdk/es/ae/oracle
+ * @rtype Stamp
+ * @param {Object} [options={}] - Initializer object
+ * @return {Object} Oracle instance
+ */
+
+
+const Oracle = Ae.compose({
+  methods: {
+    registerOracle,
+    respondToQuery,
+    extendOracleTtl,
+    postQueryToOracle,
+    pollForQueryResponse,
+    pollForQueries,
+    getOracleObject,
+    getQueryObject
+  },
+  deepProps: {
+    Ae: {
+      defaults: {
+        queryFee: QUERY_FEE,
+        oracleTtl: ORACLE_TTL,
+        queryTtl: QUERY_TTL,
+        responseTtl: RESPONSE_TTL
+      }
+    }
+  }
+});
+export default Oracle;
+//# sourceMappingURL=oracle.mjs.map

package/es/ae/oracle.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/ae/oracle.js"],"names":["Ae","pause","oracleQueryId","decode","unpackTx","ORACLE_TTL","QUERY_FEE","QUERY_TTL","RESPONSE_TTL","RequestTimedOutError","getOracleObject","oracleId","oracle","api","getOracleByPubkey","oracleQueries","queries","getOracleQueriesByPubkey","pollQueries","pollForQueries","bind","postQuery","postQueryToOracle","respondToQuery","extendOracle","extendOracleTtl","getQuery","getQueryObject","onQuery","interval","_getPollInterval","knownQueryIds","Set","checkNewQueries","filter","id","has","forEach","add","length","stopped","catch","console","error","queryId","q","getOracleQueryByPubkeyAndQueryId","decodedQuery","query","toString","decodedResponse","response","respond","pollForResponse","pollForQueryResponse","data","attempts","i","responseBuffer","String","registerOracle","queryFormat","responseFormat","options","opt","defaults","accountId","address","oracleRegisterTx","send","slice","queryFee","senderId","oraclePostQueryTx","tx","nonce","oracleTtl","callerId","oracleExtendTx","oracleRespondTx","Oracle","compose","methods","deepProps","queryTtl","responseTtl"],"mappings":"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","sourcesContent":["/*\n * ISC License (ISC)\n * Copyright (c) 2018 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 * Oracle module - routines to interact with the æternity oracle system\n *\n * The high-level description of the oracle system is\n * https://github.com/aeternity/protocol/blob/master/ORACLE.md in the protocol\n * repository.\n * @module @aeternity/aepp-sdk/es/ae/oracle\n * @export Oracle\n * @example import { Oracle } from '@aeternity/aepp-sdk'\n */\n\nimport Ae from './'\nimport { pause } from '../utils/other'\nimport { oracleQueryId, decode } from '../tx/builder/helpers'\nimport { unpackTx } from '../tx/builder'\nimport { ORACLE_TTL, QUERY_FEE, QUERY_TTL, RESPONSE_TTL } from '../tx/builder/schema'\nimport { RequestTimedOutError } from '../utils/errors'\n\n/**\n * Constructor for Oracle Object (helper object for using Oracle)\n * @alias module:@aeternity/aepp-sdk/es/ae/oracle\n * @instance\n * @function\n * @category async\n * @param {String} oracleId Oracle public key\n * @return {Promise<Object>} Oracle object\n */\nasync function getOracleObject (oracleId) {\n  const oracle = await this.api.getOracleByPubkey(oracleId)\n  const { oracleQueries: queries } = await this.api.getOracleQueriesByPubkey(oracleId)\n  return {\n    ...oracle,\n    queries,\n    pollQueries: this.pollForQueries.bind(this, oracleId),\n    postQuery: this.postQueryToOracle.bind(this, oracleId),\n    respondToQuery: this.respondToQuery.bind(this, oracleId),\n    extendOracle: this.extendOracleTtl.bind(this, oracleId),\n    getQuery: this.getQueryObject.bind(this, oracleId)\n  }\n}\n\n/**\n * Poll for oracle queries\n * @alias module:@aeternity/aepp-sdk/es/ae/oracle\n * @instance\n * @function\n * @param {String} oracleId Oracle public key\n * @param {Function} onQuery OnQuery callback\n * @param {Object} [options] Options object\n * @param {Number} [options.interval] Poll interval(default: 5000)\n * @return {Function} stopPolling - Stop polling function\n */\nfunction pollForQueries (\n  oracleId,\n  onQuery,\n  { interval = this._getPollInterval('microblock') } = {}\n) {\n  const knownQueryIds = new Set()\n  const checkNewQueries = async () => {\n    const queries = ((await this.api.getOracleQueriesByPubkey(oracleId)).oracleQueries || [])\n      .filter(({ id }) => !knownQueryIds.has(id))\n    queries.forEach(({ id }) => knownQueryIds.add(id))\n    if (queries.length) onQuery(queries)\n  }\n\n  let stopped\n  (async () => {\n    while (!stopped) { // eslint-disable-line no-unmodified-loop-condition\n      // TODO: allow to handle this error somehow\n      await checkNewQueries().catch(console.error)\n      await pause(interval)\n    }\n  })()\n  return () => { stopped = true }\n}\n\n/**\n * Constructor for OracleQuery Object (helper object for using OracleQuery)\n * @alias module:@aeternity/aepp-sdk/es/ae/oracle\n * @instance\n * @function\n * @category async\n * @param {String} oracleId Oracle public key\n * @param {String} queryId Oracle Query id\n * @return {Promise<Object>} OracleQuery object\n */\nasync function getQueryObject (oracleId, queryId) {\n  const q = await this.api.getOracleQueryByPubkeyAndQueryId(oracleId, queryId)\n  return {\n    ...q,\n    decodedQuery: decode(q.query).toString(),\n    decodedResponse: decode(q.response).toString(),\n    respond: this.respondToQuery.bind(this, oracleId, queryId),\n    pollForResponse: this.pollForQueryResponse.bind(this, oracleId, queryId),\n    /**\n     * @deprecated use TxBuilderHelper.decode instead\n     * @param data\n     * @returns {Buffer}\n     */\n    decode: (data) => decode(data)\n  }\n}\n\n/**\n * Poll for oracle query response\n * @alias module:@aeternity/aepp-sdk/es/ae/oracle\n * @instance\n * @function\n * @category async\n * @param {String} oracleId Oracle public key\n * @param {String} queryId Oracle Query id\n * @param {Object} [options] Options object\n * @param {Object} [options.attempts] Poll attempt's(default: 20)\n * @param {Object} [options.interval] Poll interval(default: 5000)\n * @return {Promise<Object>} OracleQuery object\n */\nexport async function pollForQueryResponse (\n  oracleId,\n  queryId,\n  { attempts = 20, interval = this._getPollInterval('microblock') } = {}\n) {\n  for (let i = 0; i < attempts; i++) {\n    if (i) await pause(interval)\n    const { response } = await this.api.getOracleQueryByPubkeyAndQueryId(oracleId, queryId)\n    const responseBuffer = decode(response, 'or')\n    if (responseBuffer.length) {\n      return String(responseBuffer)\n    }\n  }\n  throw new RequestTimedOutError((attempts - 1) * interval)\n}\n\n/**\n * Register oracle\n * @alias module:@aeternity/aepp-sdk/es/ae/oracle\n * @instance\n * @function\n * @category async\n * @param {String} queryFormat Format of query\n * @param {String} responseFormat Format of query response\n * @param {Object} [options={}] Options\n * @param {String|Number} [options.queryFee] Oracle query Fee\n * @param {Object} [options.oracleTtl] OracleTtl object {type: 'delta|block', value: 'number'}\n * @param {Number} [options.abiVersion] Always 0 (do not use virtual machine)\n * @param {Number|String} [options.fee] Transaction fee\n * @param {Number|String} [options.ttl] Transaction time to leave\n * @return {Promise<Object>} Oracle object\n */\nasync function registerOracle (queryFormat, responseFormat, options = {}) {\n  const opt = { ...this.Ae.defaults, ...options } // Preset VmVersion for oracle\n  const accountId = await this.address(opt)\n\n  const oracleRegisterTx = await this.oracleRegisterTx({\n    ...opt,\n    accountId,\n    queryFormat,\n    responseFormat\n  })\n  return {\n    ...await this.send(oracleRegisterTx, opt),\n    ...await this.getOracleObject(`ok_${accountId.slice(3)}`)\n  }\n}\n\n/**\n * Post query to oracle\n * @alias module:@aeternity/aepp-sdk/es/ae/oracle\n * @instance\n * @function\n * @category async\n * @param {String} oracleId Oracle public key\n * @param {String} query Oracle query object\n * @param {Object} [options={}]\n * @param {String|Number} [options.queryTtl] queryTtl Oracle query time to leave\n * @param {String|Number} [options.responseTtl] queryFee Oracle query response time to leave\n * @param {String|Number} [options.queryFee] queryFee Oracle query fee\n * @param {Number} [options.fee] fee Transaction fee\n * @param {Number} [options.ttl] Transaction time to leave\n * @return {Promise<Object>} Query object\n */\nasync function postQueryToOracle (oracleId, query, options = {}) {\n  const queryFee = options.queryFee || (await this.api.getOracleByPubkey(oracleId)).queryFee\n  const opt = { ...this.Ae.defaults, queryFee, ...options }\n  const senderId = await this.address(opt)\n\n  const oracleRegisterTx = await this.oraclePostQueryTx({\n    ...opt,\n    oracleId,\n    senderId,\n    query\n  })\n  const queryId = oracleQueryId(senderId, unpackTx(oracleRegisterTx).tx.nonce, oracleId)\n  return {\n    ...await this.send(oracleRegisterTx, opt),\n    ...await this.getQueryObject(oracleId, queryId)\n  }\n}\n\n/**\n * Extend oracle ttl\n * @alias module:@aeternity/aepp-sdk/es/ae/oracle\n * @instance\n * @function\n * @category async\n * @param {String} oracleId Oracle public key\n * @param {String} oracleTtl Oracle time to leave for extend\n * @param {Object} [options={}]\n * @param {Number} [options.fee] fee Transaction fee\n * @param {Number} [options.ttl] Transaction time to leave\n * @return {Promise<Object>} Oracle object\n */\nasync function extendOracleTtl (oracleId, oracleTtl, options = {}) {\n  const opt = { ...this.Ae.defaults, ...options }\n  const callerId = await this.address(opt)\n\n  const oracleExtendTx = await this.oracleExtendTx({\n    ...opt,\n    oracleId,\n    callerId,\n    oracleTtl\n  })\n  return {\n    ...await this.send(oracleExtendTx, opt),\n    ...await this.getOracleObject(oracleId)\n  }\n}\n\n/**\n * Extend oracle ttl\n * @alias module:@aeternity/aepp-sdk/es/ae/oracle\n * @instance\n * @function\n * @category async\n * @param {String} oracleId Oracle public key\n * @param {String} queryId Oracle query id\n * @param {String} response Oracle query response\n * @param {Object} [options={}]\n * @param {Number} [options.responseTtl] responseTtl Query response time to leave\n * @param {Number} [options.fee] Transaction fee\n * @param {Number} [options.ttl] Transaction time to leave\n * @return {Promise<Object>} Oracle object\n */\nasync function respondToQuery (oracleId, queryId, response, options = {}) {\n  const opt = { ...this.Ae.defaults, ...options }\n  const callerId = await this.address(opt)\n\n  const oracleRespondTx = await this.oracleRespondTx({\n    ...opt,\n    oracleId,\n    queryId,\n    callerId,\n    response\n  })\n  return {\n    ...await this.send(oracleRespondTx, opt),\n    ...await this.getOracleObject(oracleId)\n  }\n}\n\n/**\n * Oracle Stamp\n *\n * Oracle provides oracle-system related methods atop\n * {@link module:@aeternity/aepp-sdk/es/ae--Ae} clients.\n * @function\n * @alias module:@aeternity/aepp-sdk/es/ae/oracle\n * @rtype Stamp\n * @param {Object} [options={}] - Initializer object\n * @return {Object} Oracle instance\n */\nconst Oracle = Ae.compose({\n  methods: {\n    registerOracle,\n    respondToQuery,\n    extendOracleTtl,\n    postQueryToOracle,\n    pollForQueryResponse,\n    pollForQueries,\n    getOracleObject,\n    getQueryObject\n  },\n  deepProps: {\n    Ae: {\n      defaults: {\n        queryFee: QUERY_FEE,\n        oracleTtl: ORACLE_TTL,\n        queryTtl: QUERY_TTL,\n        responseTtl: RESPONSE_TTL\n      }\n    }\n  }\n})\n\nexport default Oracle\n"],"file":"oracle.mjs"}

package/es/ae/{universal.js → universal.mjs}

@@ -21,14 +21,14 @@
  * @export Universal
  * @example import { Universal } from '@aeternity/aepp-sdk'
  */
-import Ae from './';
-import Chain from '../chain/node';
-import Aens from './aens';
-import Transaction from '../tx/tx';
-import Oracle from './oracle';
-import GeneralizeAccount from '../contract/ga';
-import AccountMultiple from '../account/multiple';
-import Contract from './contract';
+import Ae from "./index.mjs";
+import Chain from "../chain/node.mjs";
+import Aens from "./aens.mjs";
+import Transaction from "../tx/tx.mjs";
+import Oracle from "./oracle.mjs";
+import GeneralizedAccount from "../contract/ga/index.mjs";
+import AccountMultiple from "../account/multiple.mjs";
+import Contract from "./contract.mjs";
 /**
  * Universal Stamp
  *
@@ -41,5 +41,5 @@ import Contract from './contract';
  * @return {Object} Universal instance
  */
 
-export default Ae.compose(AccountMultiple, Chain, Transaction, Aens, Contract, Oracle, GeneralizeAccount);
-//# sourceMappingURL=universal.js.map
+export default Ae.compose(AccountMultiple, Chain, Transaction, Aens, Contract, Oracle, GeneralizedAccount);
+//# sourceMappingURL=universal.mjs.map

package/es/ae/universal.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/ae/universal.js"],"names":["Ae","Chain","Aens","Transaction","Oracle","GeneralizedAccount","AccountMultiple","Contract","compose"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;OAEOA,E;OACAC,K;OACAC,I;OACAC,W;OACAC,M;OACAC,kB;OACAC,e;OACAC,Q;AAEP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AACA,eAAeP,EAAE,CAACQ,OAAH,CACbF,eADa,EACIL,KADJ,EACWE,WADX,EACwBD,IADxB,EAC8BK,QAD9B,EACwCH,MADxC,EACgDC,kBADhD,CAAf","sourcesContent":["/*\n * ISC License (ISC)\n * Copyright (c) 2018 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 * Universal module\n * @module @aeternity/aepp-sdk/es/ae/universal\n * @export Universal\n * @example import { Universal } from '@aeternity/aepp-sdk'\n */\n\nimport Ae from './'\nimport Chain from '../chain/node'\nimport Aens from './aens'\nimport Transaction from '../tx/tx'\nimport Oracle from './oracle'\nimport GeneralizedAccount from '../contract/ga'\nimport AccountMultiple from '../account/multiple'\nimport Contract from './contract'\n\n/**\n * Universal Stamp\n *\n * Universal provides Ae base functionality with Contract and Aens\n * {@link module:@aeternity/aepp-sdk/es/ae--Ae} clients.\n * @function\n * @alias module:@aeternity/aepp-sdk/es/ae/universal\n * @rtype Stamp\n * @param {Object} [options={}] - Initializer object\n * @return {Object} Universal instance\n */\nexport default Ae.compose(\n  AccountMultiple, Chain, Transaction, Aens, Contract, Oracle, GeneralizedAccount\n)\n"],"file":"universal.mjs"}