@aeternity/aepp-sdk 10.0.0 → 12.0.0

package/es/oracle.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Oracle methods - 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.
+ */
+import { send, SendOptions } from './spend';
+import { ORACLE_TTL_TYPES, TX_TYPE } from './tx/builder/schema';
+import { EncodedData } from './utils/encoder';
+import { _getPollInterval } from './chain';
+import { BuildTxOptions } from './tx';
+import Node from './Node';
+import BigNumber from 'bignumber.js';
+import AccountBase from './account/Base';
+declare type OracleQueries = Awaited<ReturnType<Node['getOracleQueriesByPubkey']>>['oracleQueries'];
+/**
+ * Constructor for Oracle Object (helper object for using Oracle)
+ * @param oracleId - Oracle public key
+ * @param options - Options
+ * @returns Oracle object
+ */
+export declare function getOracleObject(oracleId: EncodedData<'ok'>, options: {
+    onNode: Node;
+    onAccount: AccountBase;
+}): Promise<GetOracleObjectReturnType>;
+interface GetOracleObjectReturnType extends Awaited<ReturnType<Node['getOracleByPubkey']>> {
+    id: EncodedData<'ok'>;
+    queries: OracleQueries;
+    pollQueries: (cb: Parameters<typeof pollForQueries>[1]) => ReturnType<typeof pollForQueries>;
+    postQuery: Function;
+    respondToQuery: Function;
+    extendOracle: Function;
+    getQuery: Function;
+}
+/**
+ * Poll for oracle queries
+ * @param oracleId - Oracle public key
+ * @param onQuery - OnQuery callback
+ * @param options - Options object
+ * @param options.interval - Poll interval(default: 5000)
+ * @param options.onNode - Node to use
+ * @returns Callback to stop polling function
+ */
+export declare function pollForQueries(oracleId: EncodedData<'ok'>, onQuery: (queries: OracleQueries) => void, { interval, onNode, ...options }: {
+    interval?: number;
+    onNode: Node;
+} & Parameters<typeof _getPollInterval>[1]): () => void;
+/**
+ * Constructor for OracleQuery Object (helper object for using OracleQuery)
+ * @param oracleId - Oracle public key
+ * @param queryId - Oracle Query id
+ * @param options - Options
+ * @returns OracleQuery object
+ */
+export declare function getQueryObject(oracleId: EncodedData<'ok'>, queryId: EncodedData<'oq'>, options: RespondToQueryOptions & Parameters<typeof pollForQueryResponse>[2]): Promise<GetQueryObjectReturnType>;
+interface GetQueryObjectReturnType extends Awaited<ReturnType<Node['getOracleQueryByPubkeyAndQueryId']>> {
+    decodedQuery: string;
+    decodedResponse: string;
+    respond: (response: string, options?: Parameters<typeof respondToQuery>[3]) => ReturnType<typeof respondToQuery>;
+    pollForResponse: (options?: Parameters<typeof pollForQueryResponse>[2]) => ReturnType<typeof pollForQueryResponse>;
+}
+/**
+ * Poll for oracle query response
+ * @param oracleId - Oracle public key
+ * @param queryId - Oracle Query id
+ * @param options - Options object
+ * @param options.attempts - Poll attempts
+ * @param options.interval - Poll interval
+ * @param options.onNode - Node to use
+ * @returns OracleQuery object
+ */
+export declare function pollForQueryResponse(oracleId: EncodedData<'ok'>, queryId: EncodedData<'oq'>, { attempts, interval, onNode, ...options }: {
+    attempts?: number;
+    interval?: number;
+    onNode: Node;
+} & Parameters<typeof _getPollInterval>[1]): Promise<string>;
+/**
+ * Register oracle
+ * @param queryFormat - Format of query
+ * @param responseFormat - Format of query response
+ * @param options - Options
+ * @param options.queryFee - Oracle query Fee
+ * @param options - Options object
+ * @param options.abiVersion - Always 0 (do not use virtual machine)
+ * @param options.fee - Transaction fee
+ * @param options.ttl - Transaction time to leave
+ * @returns Oracle object
+ */
+export declare function registerOracle(queryFormat: string, responseFormat: string, options: RegisterOracleOptions): Promise<Awaited<ReturnType<typeof send>> & Awaited<ReturnType<typeof getOracleObject>>>;
+declare type RegisterOracleOptionsType = SendOptions & Parameters<typeof getOracleObject>[1] & BuildTxOptions<TX_TYPE.oracleRegister, 'accountId' | 'queryFormat' | 'responseFormat' | 'queryFee' | 'oracleTtlType' | 'oracleTtlValue'> & {
+    queryFee?: number | string | BigNumber;
+    oracleTtlType?: ORACLE_TTL_TYPES;
+    oracleTtlValue?: number;
+};
+interface RegisterOracleOptions extends RegisterOracleOptionsType {
+}
+/**
+ * Post query to oracle
+ * @param oracleId - Oracle public key
+ * @param query - Oracle query object
+ * @param options - Options object
+ * @param options.queryTtl - queryTtl Oracle query time to leave
+ * @param options.responseTtl - queryFee Oracle query response time to leave
+ * @param options.queryFee - queryFee Oracle query fee
+ * @param options.fee - fee Transaction fee
+ * @param options.ttl - Transaction time to leave
+ * @returns Query object
+ */
+export declare function postQueryToOracle(oracleId: EncodedData<'ok'>, query: string, options: PostQueryToOracleOptions): Promise<Awaited<ReturnType<typeof send>> & Awaited<ReturnType<typeof getQueryObject>>>;
+declare type PostQueryToOracleOptionsType = Parameters<typeof send>[1] & Parameters<typeof getQueryObject>[2] & BuildTxOptions<TX_TYPE.oracleQuery, 'oracleId' | 'senderId' | 'query' | 'queryTtlType' | 'queryTtlValue' | 'responseTtlType' | 'responseTtlValue'> & {
+    queryTtlType?: ORACLE_TTL_TYPES;
+    queryTtlValue?: number;
+    responseTtlType?: ORACLE_TTL_TYPES;
+    responseTtlValue?: number;
+};
+interface PostQueryToOracleOptions extends PostQueryToOracleOptionsType {
+}
+/**
+ * Extend oracle ttl
+ * @param oracleId - Oracle public key
+ * @param options - Options object
+ * @param options.fee - fee Transaction fee
+ * @param options.ttl - Transaction time to leave
+ * @param options.oracleTtlType - Oracle time to leave for extend
+ * @param options.oracleTtlValue - Oracle time to leave for extend
+ * @returns Oracle object
+ */
+export declare function extendOracleTtl(oracleId: EncodedData<'ok'>, options: ExtendOracleTtlOptions): Promise<Awaited<ReturnType<typeof send>> & Awaited<ReturnType<typeof getOracleObject>>>;
+declare type ExtendOracleTtlOptionsType = SendOptions & Parameters<typeof getOracleObject>[1] & BuildTxOptions<TX_TYPE.oracleExtend, 'oracleTtlType' | 'oracleTtlValue' | 'callerId' | 'oracleId'> & {
+    oracleTtlType?: ORACLE_TTL_TYPES;
+    oracleTtlValue?: number;
+};
+interface ExtendOracleTtlOptions extends ExtendOracleTtlOptionsType {
+}
+/**
+ * Extend oracle ttl
+ * @param oracleId - Oracle public key
+ * @param queryId - Oracle query id
+ * @param response - Oracle query response
+ * @param options - Options object
+ * @param options.responseTtl - responseTtl Query response time to leave
+ * @param options.fee - Transaction fee
+ * @param options.ttl - Transaction time to leave
+ * @returns Oracle object
+ */
+export declare function respondToQuery(oracleId: EncodedData<'ok'>, queryId: EncodedData<'oq'>, response: string, options: RespondToQueryOptions): Promise<Awaited<ReturnType<typeof send>> & Awaited<ReturnType<typeof getOracleObject>>>;
+declare type RespondToQueryOptionsType = SendOptions & Parameters<typeof getOracleObject>[1] & BuildTxOptions<TX_TYPE.oracleResponse, 'callerId' | 'oracleId' | 'queryId' | 'response' | 'responseTtlType' | 'responseTtlValue'> & {
+    responseTtlType?: ORACLE_TTL_TYPES;
+    responseTtlValue?: number;
+};
+interface RespondToQueryOptions extends RespondToQueryOptionsType {
+}
+export {};

package/es/oracle.mjs

@@ -0,0 +1,288 @@
+/*
+ * ISC License (ISC)
+ * Copyright (c) 2022 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 methods - 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.
+ */
+import { send } from "./spend.mjs";
+import { mapObject, pause } from "./utils/other.mjs";
+import { oracleQueryId, decode, encode } from "./tx/builder/helpers.mjs";
+import { unpackTx } from "./tx/builder/index.mjs";
+import { ORACLE_TTL, QUERY_FEE, QUERY_TTL, RESPONSE_TTL, TX_TYPE } from "./tx/builder/schema.mjs";
+import { RequestTimedOutError } from "./utils/errors.mjs";
+import { _getPollInterval } from "./chain.mjs";
+import { _buildTx } from "./tx/index.mjs";
+
+/**
+ * Constructor for Oracle Object (helper object for using Oracle)
+ * @param oracleId - Oracle public key
+ * @param options - Options
+ * @returns Oracle object
+ */
+export async function getOracleObject(oracleId, options) {
+  return { ...(await options.onNode.getOracleByPubkey(oracleId)),
+    queries: (await options.onNode.getOracleQueriesByPubkey(oracleId)).oracleQueries,
+    ...mapObject({
+      pollQueries: pollForQueries,
+      postQuery: postQueryToOracle,
+      respondToQuery,
+      extendOracle: extendOracleTtl,
+      getQuery: getQueryObject
+    }, _ref => {
+      let [name, handler] = _ref;
+      return [name, function () {
+        for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+          args[_key] = arguments[_key];
+        }
+
+        const lastArg = args[args.length - 1];
+
+        if (lastArg != null && typeof lastArg === 'object' && lastArg.constructor === Object) {
+          Object.assign(lastArg, { ...options,
+            ...lastArg
+          });
+        } else args.push(options);
+
+        return handler(oracleId, ...args);
+      }];
+    })
+  };
+}
+
+/**
+ * Poll for oracle queries
+ * @param oracleId - Oracle public key
+ * @param onQuery - OnQuery callback
+ * @param options - Options object
+ * @param options.interval - Poll interval(default: 5000)
+ * @param options.onNode - Node to use
+ * @returns Callback to stop polling function
+ */
+export function pollForQueries(oracleId, onQuery, _ref2) {
+  var _interval;
+
+  let {
+    interval,
+    onNode,
+    ...options
+  } = _ref2;
+  (_interval = interval) !== null && _interval !== void 0 ? _interval : interval = _getPollInterval('microblock', options);
+  const knownQueryIds = new Set();
+
+  const checkNewQueries = async () => {
+    var _await$onNode$getOrac;
+
+    const queries = ((_await$onNode$getOrac = (await onNode.getOracleQueriesByPubkey(oracleId)).oracleQueries) !== null && _await$onNode$getOrac !== void 0 ? _await$onNode$getOrac : []).filter(_ref3 => {
+      let {
+        id
+      } = _ref3;
+      return !knownQueryIds.has(id);
+    });
+    queries.forEach(_ref4 => {
+      let {
+        id
+      } = _ref4;
+      return knownQueryIds.add(id);
+    });
+    if (queries.length > 0) onQuery(queries);
+  };
+
+  let stopped = false; // eslint-disable-next-line @typescript-eslint/no-floating-promises
+
+  (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)
+ * @param oracleId - Oracle public key
+ * @param queryId - Oracle Query id
+ * @param options - Options
+ * @returns OracleQuery object
+ */
+
+export async function getQueryObject(oracleId, queryId, options) {
+  const record = await options.onNode.getOracleQueryByPubkeyAndQueryId(oracleId, queryId);
+  return { ...record,
+    decodedQuery: decode(record.query).toString(),
+    decodedResponse: decode(record.response).toString(),
+    respond: async (response, opt) => await respondToQuery(oracleId, queryId, response, { ...options,
+      ...opt
+    }),
+    pollForResponse: async opt => await pollForQueryResponse(oracleId, queryId, { ...options,
+      ...opt
+    })
+  };
+}
+
+/**
+ * Poll for oracle query response
+ * @param oracleId - Oracle public key
+ * @param queryId - Oracle Query id
+ * @param options - Options object
+ * @param options.attempts - Poll attempts
+ * @param options.interval - Poll interval
+ * @param options.onNode - Node to use
+ * @returns OracleQuery object
+ */
+export async function pollForQueryResponse(oracleId, queryId, _ref5) {
+  var _interval2;
+
+  let {
+    attempts = 20,
+    interval,
+    onNode,
+    ...options
+  } = _ref5;
+  (_interval2 = interval) !== null && _interval2 !== void 0 ? _interval2 : interval = _getPollInterval('microblock', options);
+
+  for (let i = 0; i < attempts; i++) {
+    if (i > 0) await pause(interval);
+    const {
+      response
+    } = await onNode.getOracleQueryByPubkeyAndQueryId(oracleId, queryId);
+    const responseBuffer = decode(response);
+    if (responseBuffer.length > 0) return responseBuffer.toString();
+  }
+
+  throw new RequestTimedOutError((attempts - 1) * interval);
+}
+/**
+ * Register oracle
+ * @param queryFormat - Format of query
+ * @param responseFormat - Format of query response
+ * @param options - Options
+ * @param options.queryFee - Oracle query Fee
+ * @param options - Options object
+ * @param options.abiVersion - Always 0 (do not use virtual machine)
+ * @param options.fee - Transaction fee
+ * @param options.ttl - Transaction time to leave
+ * @returns Oracle object
+ */
+
+export async function registerOracle(queryFormat, responseFormat, options) {
+  const accountId = await options.onAccount.address(options);
+  const oracleRegisterTx = await _buildTx(TX_TYPE.oracleRegister, {
+    queryFee: QUERY_FEE,
+    oracleTtlValue: ORACLE_TTL.value,
+    oracleTtlType: ORACLE_TTL.type,
+    ...options,
+    accountId,
+    queryFormat,
+    responseFormat
+  });
+  return { ...(await send(oracleRegisterTx, options)),
+    ...(await getOracleObject(encode(decode(accountId), 'ok'), options))
+  };
+}
+
+/**
+ * Post query to oracle
+ * @param oracleId - Oracle public key
+ * @param query - Oracle query object
+ * @param options - Options object
+ * @param options.queryTtl - queryTtl Oracle query time to leave
+ * @param options.responseTtl - queryFee Oracle query response time to leave
+ * @param options.queryFee - queryFee Oracle query fee
+ * @param options.fee - fee Transaction fee
+ * @param options.ttl - Transaction time to leave
+ * @returns Query object
+ */
+export async function postQueryToOracle(oracleId, query, options) {
+  var _options$queryFee;
+
+  (_options$queryFee = options.queryFee) !== null && _options$queryFee !== void 0 ? _options$queryFee : options.queryFee = (await options.onNode.getOracleByPubkey(oracleId)).queryFee.toString();
+  const senderId = await options.onAccount.address(options);
+  const oracleQueryTx = await _buildTx(TX_TYPE.oracleQuery, {
+    queryTtlType: QUERY_TTL.type,
+    queryTtlValue: QUERY_TTL.value,
+    responseTtlType: RESPONSE_TTL.type,
+    responseTtlValue: RESPONSE_TTL.value,
+    ...options,
+    oracleId,
+    senderId,
+    query
+  });
+  const nonce = unpackTx(oracleQueryTx, TX_TYPE.oracleQuery).tx.nonce;
+  const queryId = oracleQueryId(senderId, nonce, oracleId);
+  return { ...(await send(oracleQueryTx, options)),
+    ...(await getQueryObject(oracleId, queryId, options))
+  };
+}
+
+/**
+ * Extend oracle ttl
+ * @param oracleId - Oracle public key
+ * @param options - Options object
+ * @param options.fee - fee Transaction fee
+ * @param options.ttl - Transaction time to leave
+ * @param options.oracleTtlType - Oracle time to leave for extend
+ * @param options.oracleTtlValue - Oracle time to leave for extend
+ * @returns Oracle object
+ */
+export async function extendOracleTtl(oracleId, options) {
+  const oracleExtendTx = await _buildTx(TX_TYPE.oracleExtend, {
+    oracleTtlType: ORACLE_TTL.type,
+    oracleTtlValue: ORACLE_TTL.value,
+    ...options,
+    callerId: await options.onAccount.address(options),
+    oracleId
+  });
+  return { ...(await send(oracleExtendTx, options)),
+    ...(await getOracleObject(oracleId, options))
+  };
+}
+
+/**
+ * Extend oracle ttl
+ * @param oracleId - Oracle public key
+ * @param queryId - Oracle query id
+ * @param response - Oracle query response
+ * @param options - Options object
+ * @param options.responseTtl - responseTtl Query response time to leave
+ * @param options.fee - Transaction fee
+ * @param options.ttl - Transaction time to leave
+ * @returns Oracle object
+ */
+export async function respondToQuery(oracleId, queryId, response, options) {
+  const oracleRespondTx = await _buildTx(TX_TYPE.oracleResponse, {
+    responseTtlType: RESPONSE_TTL.type,
+    responseTtlValue: RESPONSE_TTL.value,
+    ...options,
+    callerId: await options.onAccount.address(options),
+    oracleId,
+    queryId,
+    response
+  });
+  return { ...(await send(oracleRespondTx, options)),
+    ...(await getOracleObject(oracleId, options))
+  };
+}
+//# sourceMappingURL=oracle.mjs.map

package/es/oracle.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle.mjs","names":["send","mapObject","pause","oracleQueryId","decode","encode","unpackTx","ORACLE_TTL","QUERY_FEE","QUERY_TTL","RESPONSE_TTL","TX_TYPE","RequestTimedOutError","_getPollInterval","_buildTx","getOracleObject","oracleId","options","onNode","getOracleByPubkey","queries","getOracleQueriesByPubkey","oracleQueries","pollQueries","pollForQueries","postQuery","postQueryToOracle","respondToQuery","extendOracle","extendOracleTtl","getQuery","getQueryObject","name","handler","args","lastArg","length","constructor","Object","assign","push","onQuery","interval","knownQueryIds","Set","checkNewQueries","filter","id","has","forEach","add","stopped","catch","console","error","queryId","record","getOracleQueryByPubkeyAndQueryId","decodedQuery","query","toString","decodedResponse","response","respond","opt","pollForResponse","pollForQueryResponse","attempts","i","responseBuffer","registerOracle","queryFormat","responseFormat","accountId","onAccount","address","oracleRegisterTx","oracleRegister","queryFee","oracleTtlValue","value","oracleTtlType","type","senderId","oracleQueryTx","oracleQuery","queryTtlType","queryTtlValue","responseTtlType","responseTtlValue","nonce","tx","oracleExtendTx","oracleExtend","callerId","oracleRespondTx","oracleResponse"],"sources":["../src/oracle.ts"],"sourcesContent":["/*\n * ISC License (ISC)\n * Copyright (c) 2022 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 methods - 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 */\n\nimport { send, SendOptions } from './spend'\nimport { mapObject, pause } from './utils/other'\nimport { oracleQueryId, decode, encode } from './tx/builder/helpers'\nimport { unpackTx } from './tx/builder'\nimport {\n  ORACLE_TTL,\n  ORACLE_TTL_TYPES,\n  QUERY_FEE,\n  QUERY_TTL,\n  RESPONSE_TTL,\n  TX_TYPE\n} from './tx/builder/schema'\nimport { RequestTimedOutError } from './utils/errors'\nimport { EncodedData } from './utils/encoder'\nimport { _getPollInterval } from './chain'\nimport { _buildTx, BuildTxOptions } from './tx'\nimport Node from './Node'\nimport BigNumber from 'bignumber.js'\nimport AccountBase from './account/Base'\n\ntype OracleQueries = Awaited<ReturnType<Node['getOracleQueriesByPubkey']>>['oracleQueries']\n\n/**\n * Constructor for Oracle Object (helper object for using Oracle)\n * @param oracleId - Oracle public key\n * @param options - Options\n * @returns Oracle object\n */\nexport async function getOracleObject (\n  oracleId: EncodedData<'ok'>, options: { onNode: Node, onAccount: AccountBase }\n): Promise<GetOracleObjectReturnType> {\n  return {\n    ...await options.onNode.getOracleByPubkey(oracleId),\n    queries: (await options.onNode.getOracleQueriesByPubkey(oracleId)).oracleQueries,\n    ...mapObject<Function, Function>(\n      {\n        pollQueries: pollForQueries,\n        postQuery: postQueryToOracle,\n        respondToQuery,\n        extendOracle: extendOracleTtl,\n        getQuery: getQueryObject\n      },\n      ([name, handler]) => [\n        name,\n        function (...args: any) {\n          const lastArg = args[args.length - 1]\n          if (lastArg != null && typeof lastArg === 'object' && lastArg.constructor === Object) {\n            Object.assign(lastArg, { ...options, ...lastArg })\n          } else args.push(options)\n          return handler(oracleId, ...args)\n        }\n      ])\n  } as any\n}\n\ninterface GetOracleObjectReturnType extends Awaited<ReturnType<Node['getOracleByPubkey']>> {\n  id: EncodedData<'ok'>\n  queries: OracleQueries\n  // TODO: replace getOracleObject with a class\n  pollQueries: (cb: Parameters<typeof pollForQueries>[1]) => ReturnType<typeof pollForQueries>\n  postQuery: Function\n  respondToQuery: Function\n  extendOracle: Function\n  getQuery: Function\n}\n\n/**\n * Poll for oracle queries\n * @param oracleId - Oracle public key\n * @param onQuery - OnQuery callback\n * @param options - Options object\n * @param options.interval - Poll interval(default: 5000)\n * @param options.onNode - Node to use\n * @returns Callback to stop polling function\n */\nexport function pollForQueries (\n  oracleId: EncodedData<'ok'>,\n  onQuery: (queries: OracleQueries) => void,\n  { interval, onNode, ...options }: { interval?: number, onNode: Node }\n  & Parameters<typeof _getPollInterval>[1]\n): () => void {\n  interval ??= _getPollInterval('microblock', options)\n  const knownQueryIds = new Set()\n  const checkNewQueries = async (): Promise<void> => {\n    const queries = ((await onNode.getOracleQueriesByPubkey(oracleId)).oracleQueries ?? [])\n      .filter(({ id }) => !knownQueryIds.has(id))\n    queries.forEach(({ id }) => knownQueryIds.add(id))\n    if (queries.length > 0) onQuery(queries)\n  }\n\n  let stopped = false;\n\n  // eslint-disable-next-line @typescript-eslint/no-floating-promises\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 * @param oracleId - Oracle public key\n * @param queryId - Oracle Query id\n * @param options - Options\n * @returns OracleQuery object\n */\nexport async function getQueryObject (\n  oracleId: EncodedData<'ok'>,\n  queryId: EncodedData<'oq'>,\n  options: RespondToQueryOptions & Parameters<typeof pollForQueryResponse>[2]\n): Promise<GetQueryObjectReturnType> {\n  const record = await options.onNode.getOracleQueryByPubkeyAndQueryId(oracleId, queryId)\n  return {\n    ...record,\n    decodedQuery: decode(record.query as EncodedData<'oq'>).toString(),\n    decodedResponse: decode(record.response as EncodedData<'or'>).toString(),\n    respond: async (response, opt) =>\n      await respondToQuery(oracleId, queryId, response, { ...options, ...opt }),\n    pollForResponse: async (opt) =>\n      await pollForQueryResponse(oracleId, queryId, { ...options, ...opt })\n  }\n}\n\ninterface GetQueryObjectReturnType extends Awaited<ReturnType<Node['getOracleQueryByPubkeyAndQueryId']>> {\n  decodedQuery: string\n  decodedResponse: string\n  respond: (response: string, options?: Parameters<typeof respondToQuery>[3]) =>\n  ReturnType<typeof respondToQuery>\n  pollForResponse: (options?: Parameters<typeof pollForQueryResponse>[2]) =>\n  ReturnType<typeof pollForQueryResponse>\n}\n\n/**\n * Poll for oracle query response\n * @param oracleId - Oracle public key\n * @param queryId - Oracle Query id\n * @param options - Options object\n * @param options.attempts - Poll attempts\n * @param options.interval - Poll interval\n * @param options.onNode - Node to use\n * @returns OracleQuery object\n */\nexport async function pollForQueryResponse (\n  oracleId: EncodedData<'ok'>,\n  queryId: EncodedData<'oq'>,\n  { attempts = 20, interval, onNode, ...options }:\n  { attempts?: number, interval?: number, onNode: Node } & Parameters<typeof _getPollInterval>[1]\n): Promise<string> {\n  interval ??= _getPollInterval('microblock', options)\n  for (let i = 0; i < attempts; i++) {\n    if (i > 0) await pause(interval)\n    const { response } = await onNode.getOracleQueryByPubkeyAndQueryId(oracleId, queryId)\n    const responseBuffer = decode(response as EncodedData<'or'>)\n    if (responseBuffer.length > 0) return responseBuffer.toString()\n  }\n  throw new RequestTimedOutError((attempts - 1) * interval)\n}\n\n/**\n * Register oracle\n * @param queryFormat - Format of query\n * @param responseFormat - Format of query response\n * @param options - Options\n * @param options.queryFee - Oracle query Fee\n * @param options - Options object\n * @param options.abiVersion - Always 0 (do not use virtual machine)\n * @param options.fee - Transaction fee\n * @param options.ttl - Transaction time to leave\n * @returns Oracle object\n */\nexport async function registerOracle (\n  queryFormat: string, responseFormat: string, options: RegisterOracleOptions\n): Promise<Awaited<ReturnType<typeof send>> & Awaited<ReturnType<typeof getOracleObject>>> {\n  const accountId = await options.onAccount.address(options)\n  const oracleRegisterTx = await _buildTx(TX_TYPE.oracleRegister, {\n    queryFee: QUERY_FEE,\n    oracleTtlValue: ORACLE_TTL.value,\n    oracleTtlType: ORACLE_TTL.type,\n    ...options,\n    accountId,\n    queryFormat,\n    responseFormat\n  })\n  return {\n    ...await send(oracleRegisterTx, options),\n    ...await getOracleObject(encode(decode(accountId), 'ok'), options)\n  }\n}\n\ntype RegisterOracleOptionsType = SendOptions & Parameters<typeof getOracleObject>[1]\n& BuildTxOptions<TX_TYPE.oracleRegister, 'accountId' | 'queryFormat' | 'responseFormat' | 'queryFee' | 'oracleTtlType' | 'oracleTtlValue'>\n& {\n  queryFee?: number | string | BigNumber\n  oracleTtlType?: ORACLE_TTL_TYPES\n  oracleTtlValue?: number\n}\ninterface RegisterOracleOptions extends RegisterOracleOptionsType {}\n\n/**\n * Post query to oracle\n * @param oracleId - Oracle public key\n * @param query - Oracle query object\n * @param options - Options object\n * @param options.queryTtl - queryTtl Oracle query time to leave\n * @param options.responseTtl - queryFee Oracle query response time to leave\n * @param options.queryFee - queryFee Oracle query fee\n * @param options.fee - fee Transaction fee\n * @param options.ttl - Transaction time to leave\n * @returns Query object\n */\nexport async function postQueryToOracle (oracleId: EncodedData<'ok'>,\n  query: string, options: PostQueryToOracleOptions\n): Promise<Awaited<ReturnType<typeof send>> & Awaited<ReturnType<typeof getQueryObject>>> {\n  options.queryFee ??= (await options.onNode.getOracleByPubkey(oracleId)).queryFee.toString()\n  const senderId = await options.onAccount.address(options)\n\n  const oracleQueryTx = await _buildTx(TX_TYPE.oracleQuery, {\n    queryTtlType: QUERY_TTL.type,\n    queryTtlValue: QUERY_TTL.value,\n    responseTtlType: RESPONSE_TTL.type,\n    responseTtlValue: RESPONSE_TTL.value,\n    ...options,\n    oracleId,\n    senderId,\n    query\n  })\n  const nonce = unpackTx(oracleQueryTx, TX_TYPE.oracleQuery).tx.nonce\n  const queryId = oracleQueryId(senderId, nonce, oracleId)\n  return {\n    ...await send(oracleQueryTx, options),\n    ...await getQueryObject(oracleId, queryId, options)\n  }\n}\n\ntype PostQueryToOracleOptionsType = Parameters<typeof send>[1]\n& Parameters<typeof getQueryObject>[2]\n& BuildTxOptions<TX_TYPE.oracleQuery, 'oracleId' | 'senderId' | 'query' | 'queryTtlType' | 'queryTtlValue' | 'responseTtlType' | 'responseTtlValue'>\n& {\n  queryTtlType?: ORACLE_TTL_TYPES\n  queryTtlValue?: number\n  responseTtlType?: ORACLE_TTL_TYPES\n  responseTtlValue?: number\n}\ninterface PostQueryToOracleOptions extends PostQueryToOracleOptionsType {}\n\n/**\n * Extend oracle ttl\n * @param oracleId - Oracle public key\n * @param options - Options object\n * @param options.fee - fee Transaction fee\n * @param options.ttl - Transaction time to leave\n * @param options.oracleTtlType - Oracle time to leave for extend\n * @param options.oracleTtlValue - Oracle time to leave for extend\n * @returns Oracle object\n */\nexport async function extendOracleTtl (\n  oracleId: EncodedData<'ok'>,\n  options: ExtendOracleTtlOptions\n): Promise<Awaited<ReturnType<typeof send>> & Awaited<ReturnType<typeof getOracleObject>>> {\n  const oracleExtendTx = await _buildTx(TX_TYPE.oracleExtend, {\n    oracleTtlType: ORACLE_TTL.type,\n    oracleTtlValue: ORACLE_TTL.value,\n    ...options,\n    callerId: await options.onAccount.address(options),\n    oracleId\n  })\n  return {\n    ...await send(oracleExtendTx, options),\n    ...await getOracleObject(oracleId, options)\n  }\n}\n\ntype ExtendOracleTtlOptionsType = SendOptions & Parameters<typeof getOracleObject>[1]\n& BuildTxOptions<TX_TYPE.oracleExtend, 'oracleTtlType' | 'oracleTtlValue' | 'callerId' | 'oracleId'>\n& { oracleTtlType?: ORACLE_TTL_TYPES, oracleTtlValue?: number }\ninterface ExtendOracleTtlOptions extends ExtendOracleTtlOptionsType {}\n\n/**\n * Extend oracle ttl\n * @param oracleId - Oracle public key\n * @param queryId - Oracle query id\n * @param response - Oracle query response\n * @param options - Options object\n * @param options.responseTtl - responseTtl Query response time to leave\n * @param options.fee - Transaction fee\n * @param options.ttl - Transaction time to leave\n * @returns Oracle object\n */\nexport async function respondToQuery (\n  oracleId: EncodedData<'ok'>,\n  queryId: EncodedData<'oq'>,\n  response: string,\n  options: RespondToQueryOptions\n): Promise<Awaited<ReturnType<typeof send>> & Awaited<ReturnType<typeof getOracleObject>>> {\n  const oracleRespondTx = await _buildTx(TX_TYPE.oracleResponse, {\n    responseTtlType: RESPONSE_TTL.type,\n    responseTtlValue: RESPONSE_TTL.value,\n    ...options,\n    callerId: await options.onAccount.address(options),\n    oracleId,\n    queryId,\n    response\n  })\n  return {\n    ...await send(oracleRespondTx, options),\n    ...await getOracleObject(oracleId, options)\n  }\n}\n\ntype RespondToQueryOptionsType = SendOptions & Parameters<typeof getOracleObject>[1]\n& BuildTxOptions<TX_TYPE.oracleResponse, 'callerId' | 'oracleId' | 'queryId' | 'response' | 'responseTtlType' | 'responseTtlValue'>\n& { responseTtlType?: ORACLE_TTL_TYPES, responseTtlValue?: number }\ninterface RespondToQueryOptions extends RespondToQueryOptionsType {}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;SAESA,I;SACAC,S,EAAWC,K;SACXC,a,EAAeC,M,EAAQC,M;SACvBC,Q;SAEPC,U,EAEAC,S,EACAC,S,EACAC,Y,EACAC,O;SAEOC,oB;SAEAC,gB;SACAC,Q;;AAOT;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeC,eAAf,CACLC,QADK,EACwBC,OADxB,EAE+B;EACpC,OAAO,EACL,IAAG,MAAMA,OAAO,CAACC,MAAR,CAAeC,iBAAf,CAAiCH,QAAjC,CAAT,CADK;IAELI,OAAO,EAAE,CAAC,MAAMH,OAAO,CAACC,MAAR,CAAeG,wBAAf,CAAwCL,QAAxC,CAAP,EAA0DM,aAF9D;IAGL,GAAGrB,SAAS,CACV;MACEsB,WAAW,EAAEC,cADf;MAEEC,SAAS,EAAEC,iBAFb;MAGEC,cAHF;MAIEC,YAAY,EAAEC,eAJhB;MAKEC,QAAQ,EAAEC;IALZ,CADU,EAQV;MAAA,IAAC,CAACC,IAAD,EAAOC,OAAP,CAAD;MAAA,OAAqB,CACnBD,IADmB,EAEnB,YAAwB;QAAA,kCAAXE,IAAW;UAAXA,IAAW;QAAA;;QACtB,MAAMC,OAAO,GAAGD,IAAI,CAACA,IAAI,CAACE,MAAL,GAAc,CAAf,CAApB;;QACA,IAAID,OAAO,IAAI,IAAX,IAAmB,OAAOA,OAAP,KAAmB,QAAtC,IAAkDA,OAAO,CAACE,WAAR,KAAwBC,MAA9E,EAAsF;UACpFA,MAAM,CAACC,MAAP,CAAcJ,OAAd,EAAuB,EAAE,GAAGlB,OAAL;YAAc,GAAGkB;UAAjB,CAAvB;QACD,CAFD,MAEOD,IAAI,CAACM,IAAL,CAAUvB,OAAV;;QACP,OAAOgB,OAAO,CAACjB,QAAD,EAAW,GAAGkB,IAAd,CAAd;MACD,CARkB,CAArB;IAAA,CARU;EAHP,CAAP;AAsBD;;AAaD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASV,cAAT,CACLR,QADK,EAELyB,OAFK,SAKO;EAAA;;EAAA,IAFZ;IAAEC,QAAF;IAAYxB,MAAZ;IAAoB,GAAGD;EAAvB,CAEY;EACZ,aAAAyB,QAAQ,UAAR,uCAAAA,QAAQ,GAAK7B,gBAAgB,CAAC,YAAD,EAAeI,OAAf,CAA7B;EACA,MAAM0B,aAAa,GAAG,IAAIC,GAAJ,EAAtB;;EACA,MAAMC,eAAe,GAAG,YAA2B;IAAA;;IACjD,MAAMzB,OAAO,GAAG,0BAAC,CAAC,MAAMF,MAAM,CAACG,wBAAP,CAAgCL,QAAhC,CAAP,EAAkDM,aAAnD,yEAAoE,EAApE,EACbwB,MADa,CACN;MAAA,IAAC;QAAEC;MAAF,CAAD;MAAA,OAAY,CAACJ,aAAa,CAACK,GAAd,CAAkBD,EAAlB,CAAb;IAAA,CADM,CAAhB;IAEA3B,OAAO,CAAC6B,OAAR,CAAgB;MAAA,IAAC;QAAEF;MAAF,CAAD;MAAA,OAAYJ,aAAa,CAACO,GAAd,CAAkBH,EAAlB,CAAZ;IAAA,CAAhB;IACA,IAAI3B,OAAO,CAACgB,MAAR,GAAiB,CAArB,EAAwBK,OAAO,CAACrB,OAAD,CAAP;EACzB,CALD;;EAOA,IAAI+B,OAAO,GAAG,KAAd,CAVY,CAYZ;;EACA,CAAC,YAAY;IACX,OAAO,CAACA,OAAR,EAAiB;MAAE;MACjB;MACA,MAAMN,eAAe,GAAGO,KAAlB,CAAwBC,OAAO,CAACC,KAAhC,CAAN;MACA,MAAMpD,KAAK,CAACwC,QAAD,CAAX;IACD;EACF,CAND;;EAOA,OAAO,MAAM;IAAES,OAAO,GAAG,IAAV;EAAgB,CAA/B;AACD;AAED;AACA;AACA;AACA;AACA;AACA;AACA;;AACA,OAAO,eAAepB,cAAf,CACLf,QADK,EAELuC,OAFK,EAGLtC,OAHK,EAI8B;EACnC,MAAMuC,MAAM,GAAG,MAAMvC,OAAO,CAACC,MAAR,CAAeuC,gCAAf,CAAgDzC,QAAhD,EAA0DuC,OAA1D,CAArB;EACA,OAAO,EACL,GAAGC,MADE;IAELE,YAAY,EAAEtD,MAAM,CAACoD,MAAM,CAACG,KAAR,CAAN,CAA0CC,QAA1C,EAFT;IAGLC,eAAe,EAAEzD,MAAM,CAACoD,MAAM,CAACM,QAAR,CAAN,CAA6CF,QAA7C,EAHZ;IAILG,OAAO,EAAE,OAAOD,QAAP,EAAiBE,GAAjB,KACP,MAAMrC,cAAc,CAACX,QAAD,EAAWuC,OAAX,EAAoBO,QAApB,EAA8B,EAAE,GAAG7C,OAAL;MAAc,GAAG+C;IAAjB,CAA9B,CALjB;IAMLC,eAAe,EAAE,MAAOD,GAAP,IACf,MAAME,oBAAoB,CAAClD,QAAD,EAAWuC,OAAX,EAAoB,EAAE,GAAGtC,OAAL;MAAc,GAAG+C;IAAjB,CAApB;EAPvB,CAAP;AASD;;AAWD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeE,oBAAf,CACLlD,QADK,EAELuC,OAFK,SAKY;EAAA;;EAAA,IAFjB;IAAEY,QAAQ,GAAG,EAAb;IAAiBzB,QAAjB;IAA2BxB,MAA3B;IAAmC,GAAGD;EAAtC,CAEiB;EACjB,cAAAyB,QAAQ,UAAR,yCAAAA,QAAQ,GAAK7B,gBAAgB,CAAC,YAAD,EAAeI,OAAf,CAA7B;;EACA,KAAK,IAAImD,CAAC,GAAG,CAAb,EAAgBA,CAAC,GAAGD,QAApB,EAA8BC,CAAC,EAA/B,EAAmC;IACjC,IAAIA,CAAC,GAAG,CAAR,EAAW,MAAMlE,KAAK,CAACwC,QAAD,CAAX;IACX,MAAM;MAAEoB;IAAF,IAAe,MAAM5C,MAAM,CAACuC,gCAAP,CAAwCzC,QAAxC,EAAkDuC,OAAlD,CAA3B;IACA,MAAMc,cAAc,GAAGjE,MAAM,CAAC0D,QAAD,CAA7B;IACA,IAAIO,cAAc,CAACjC,MAAf,GAAwB,CAA5B,EAA+B,OAAOiC,cAAc,CAACT,QAAf,EAAP;EAChC;;EACD,MAAM,IAAIhD,oBAAJ,CAAyB,CAACuD,QAAQ,GAAG,CAAZ,IAAiBzB,QAA1C,CAAN;AACD;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AACA,OAAO,eAAe4B,cAAf,CACLC,WADK,EACgBC,cADhB,EACwCvD,OADxC,EAEoF;EACzF,MAAMwD,SAAS,GAAG,MAAMxD,OAAO,CAACyD,SAAR,CAAkBC,OAAlB,CAA0B1D,OAA1B,CAAxB;EACA,MAAM2D,gBAAgB,GAAG,MAAM9D,QAAQ,CAACH,OAAO,CAACkE,cAAT,EAAyB;IAC9DC,QAAQ,EAAEtE,SADoD;IAE9DuE,cAAc,EAAExE,UAAU,CAACyE,KAFmC;IAG9DC,aAAa,EAAE1E,UAAU,CAAC2E,IAHoC;IAI9D,GAAGjE,OAJ2D;IAK9DwD,SAL8D;IAM9DF,WAN8D;IAO9DC;EAP8D,CAAzB,CAAvC;EASA,OAAO,EACL,IAAG,MAAMxE,IAAI,CAAC4E,gBAAD,EAAmB3D,OAAnB,CAAb,CADK;IAEL,IAAG,MAAMF,eAAe,CAACV,MAAM,CAACD,MAAM,CAACqE,SAAD,CAAP,EAAoB,IAApB,CAAP,EAAkCxD,OAAlC,CAAxB;EAFK,CAAP;AAID;;AAWD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeS,iBAAf,CAAkCV,QAAlC,EACL2C,KADK,EACU1C,OADV,EAEmF;EAAA;;EACxF,qBAAAA,OAAO,CAAC6D,QAAR,iEAAA7D,OAAO,CAAC6D,QAAR,GAAqB,CAAC,MAAM7D,OAAO,CAACC,MAAR,CAAeC,iBAAf,CAAiCH,QAAjC,CAAP,EAAmD8D,QAAnD,CAA4DlB,QAA5D,EAArB;EACA,MAAMuB,QAAQ,GAAG,MAAMlE,OAAO,CAACyD,SAAR,CAAkBC,OAAlB,CAA0B1D,OAA1B,CAAvB;EAEA,MAAMmE,aAAa,GAAG,MAAMtE,QAAQ,CAACH,OAAO,CAAC0E,WAAT,EAAsB;IACxDC,YAAY,EAAE7E,SAAS,CAACyE,IADgC;IAExDK,aAAa,EAAE9E,SAAS,CAACuE,KAF+B;IAGxDQ,eAAe,EAAE9E,YAAY,CAACwE,IAH0B;IAIxDO,gBAAgB,EAAE/E,YAAY,CAACsE,KAJyB;IAKxD,GAAG/D,OALqD;IAMxDD,QANwD;IAOxDmE,QAPwD;IAQxDxB;EARwD,CAAtB,CAApC;EAUA,MAAM+B,KAAK,GAAGpF,QAAQ,CAAC8E,aAAD,EAAgBzE,OAAO,CAAC0E,WAAxB,CAAR,CAA6CM,EAA7C,CAAgDD,KAA9D;EACA,MAAMnC,OAAO,GAAGpD,aAAa,CAACgF,QAAD,EAAWO,KAAX,EAAkB1E,QAAlB,CAA7B;EACA,OAAO,EACL,IAAG,MAAMhB,IAAI,CAACoF,aAAD,EAAgBnE,OAAhB,CAAb,CADK;IAEL,IAAG,MAAMc,cAAc,CAACf,QAAD,EAAWuC,OAAX,EAAoBtC,OAApB,CAAvB;EAFK,CAAP;AAID;;AAaD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeY,eAAf,CACLb,QADK,EAELC,OAFK,EAGoF;EACzF,MAAM2E,cAAc,GAAG,MAAM9E,QAAQ,CAACH,OAAO,CAACkF,YAAT,EAAuB;IAC1DZ,aAAa,EAAE1E,UAAU,CAAC2E,IADgC;IAE1DH,cAAc,EAAExE,UAAU,CAACyE,KAF+B;IAG1D,GAAG/D,OAHuD;IAI1D6E,QAAQ,EAAE,MAAM7E,OAAO,CAACyD,SAAR,CAAkBC,OAAlB,CAA0B1D,OAA1B,CAJ0C;IAK1DD;EAL0D,CAAvB,CAArC;EAOA,OAAO,EACL,IAAG,MAAMhB,IAAI,CAAC4F,cAAD,EAAiB3E,OAAjB,CAAb,CADK;IAEL,IAAG,MAAMF,eAAe,CAACC,QAAD,EAAWC,OAAX,CAAxB;EAFK,CAAP;AAID;;AAOD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeU,cAAf,CACLX,QADK,EAELuC,OAFK,EAGLO,QAHK,EAIL7C,OAJK,EAKoF;EACzF,MAAM8E,eAAe,GAAG,MAAMjF,QAAQ,CAACH,OAAO,CAACqF,cAAT,EAAyB;IAC7DR,eAAe,EAAE9E,YAAY,CAACwE,IAD+B;IAE7DO,gBAAgB,EAAE/E,YAAY,CAACsE,KAF8B;IAG7D,GAAG/D,OAH0D;IAI7D6E,QAAQ,EAAE,MAAM7E,OAAO,CAACyD,SAAR,CAAkBC,OAAlB,CAA0B1D,OAA1B,CAJ6C;IAK7DD,QAL6D;IAM7DuC,OAN6D;IAO7DO;EAP6D,CAAzB,CAAtC;EASA,OAAO,EACL,IAAG,MAAM9D,IAAI,CAAC+F,eAAD,EAAkB9E,OAAlB,CAAb,CADK;IAEL,IAAG,MAAMF,eAAe,CAACC,QAAD,EAAWC,OAAX,CAAxB;EAFK,CAAP;AAID"}

package/es/spend.d.ts

@@ -0,0 +1,61 @@
+import { sendTransaction, resolveName } from './chain';
+import { BuildTxOptions } from './tx';
+import { EncodedData } from './utils/encoder';
+import { createMetaTx } from './contract/ga';
+import { TX_TYPE, AensName } from './tx/builder/schema';
+import AccountBase from './account/Base';
+/**
+ * Sign and post a transaction to the chain
+ * @param tx - Transaction
+ * @param options - Options
+ * @param options.verify - Verify transaction before broadcast, throw error if not
+ * valid
+ * @returns Transaction
+ */
+export declare function send(tx: EncodedData<'tx'>, options: SendOptions): Promise<SendReturnType>;
+declare type SendOptionsType = Parameters<AccountBase['signTransaction']>[1] & Parameters<typeof sendTransaction>[1] & Partial<Omit<Parameters<typeof signUsingGA>[1], 'onAccount' | 'onCompiler'>> & Pick<Parameters<typeof signUsingGA>[1], 'onAccount' | 'onCompiler'>;
+export interface SendOptions extends SendOptionsType {
+}
+interface SendReturnType extends Awaited<ReturnType<typeof sendTransaction>> {
+}
+export declare function signUsingGA(tx: EncodedData<'tx'>, { authData, authFun, ...options }: {
+    authData: Parameters<typeof createMetaTx>[1];
+    authFun: Parameters<typeof createMetaTx>[2];
+} & Parameters<typeof createMetaTx>[3]): Promise<EncodedData<'tx'>>;
+/**
+ * Send coins to another account
+ * @param amount - Amount to spend
+ * @param recipientIdOrName - Address or name of recipient account
+ * @param options - Options
+ * @returns Transaction
+ */
+export declare function spend(amount: number | string, recipientIdOrName: EncodedData<'ak'> | AensName, options: SpendOptions): ReturnType<typeof send>;
+declare type SpendOptionsType = BuildTxOptions<TX_TYPE.spend, 'senderId' | 'recipientId' | 'amount'> & Parameters<typeof resolveName>[2] & {
+    onAccount: AccountBase;
+} & SendOptions;
+interface SpendOptions extends SpendOptionsType {
+}
+/**
+ * Send a fraction of coin balance to another account
+ * @param fraction - Fraction of balance to spend (between 0 and 1)
+ * @param recipientIdOrName - Address or name of recipient account
+ * @param options - Options
+ * @returns Transaction
+ */
+export declare function transferFunds(fraction: number | string, recipientIdOrName: AensName | EncodedData<'ak'>, options: TransferFundsOptions): ReturnType<typeof send>;
+declare type TransferFundsOptionsType = BuildTxOptions<TX_TYPE.spend, 'senderId' | 'recipientId' | 'amount'> & Parameters<typeof resolveName>[2] & {
+    onAccount: AccountBase;
+} & SendOptions;
+interface TransferFundsOptions extends TransferFundsOptionsType {
+}
+/**
+ * Submit transaction of another account paying for it (fee and gas)
+ * @param transaction - tx_<base64>-encoded transaction
+ * @param options - Options
+ * @returns Object Transaction
+ */
+export declare function payForTransaction(transaction: EncodedData<'tx'>, options: PayForTransactionOptions): ReturnType<typeof send>;
+interface PayForTransactionOptions extends BuildTxOptions<TX_TYPE.payingFor, 'payerId' | 'tx'>, SendOptions {
+    onAccount: AccountBase;
+}
+export {};

package/es/spend.mjs

@@ -0,0 +1,122 @@
+/*
+ * ISC License (ISC)
+ * Copyright (c) 2022 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 { sendTransaction, getAccount, getBalance, resolveName } from "./chain.mjs";
+import { _buildTx } from "./tx/index.mjs";
+import { buildTxHash, unpackTx } from "./tx/builder/index.mjs";
+import BigNumber from 'bignumber.js';
+import { ArgumentError } from "./utils/errors.mjs";
+import { createMetaTx } from "./contract/ga.mjs";
+import { TX_TYPE } from "./tx/builder/schema.mjs";
+
+/**
+ * Sign and post a transaction to the chain
+ * @param tx - Transaction
+ * @param options - Options
+ * @param options.verify - Verify transaction before broadcast, throw error if not
+ * valid
+ * @returns Transaction
+ */
+export async function send(tx, options) {
+  const {
+    contractId,
+    authFun = undefined
+  } = options.innerTx === true ? {
+    contractId: null
+  } : await getAccount(await options.onAccount.address(options), options);
+  const signed = contractId != null // TODO: not required arguments become required depending on account type, can ga be extracted?
+  ? await signUsingGA(tx, {
+    authData: {},
+    ...options,
+    authFun: authFun
+  }) : await options.onAccount.signTransaction(tx, options);
+  return options.innerTx === true ? {
+    hash: buildTxHash(signed),
+    rawTx: signed
+  } : await sendTransaction(signed, options);
+}
+export async function signUsingGA(tx, _ref) {
+  let {
+    authData,
+    authFun,
+    ...options
+  } = _ref;
+  return await createMetaTx(tx, authData, authFun, options);
+}
+/**
+ * Send coins to another account
+ * @param amount - Amount to spend
+ * @param recipientIdOrName - Address or name of recipient account
+ * @param options - Options
+ * @returns Transaction
+ */
+
+export async function spend(amount, recipientIdOrName, options) {
+  return await send(await _buildTx(TX_TYPE.spend, { ...options,
+    senderId: await options.onAccount.address(options),
+    recipientId: await resolveName(recipientIdOrName, 'account_pubkey', options),
+    amount
+  }), options);
+}
+// TODO: Rename to spendFraction
+
+/**
+ * Send a fraction of coin balance to another account
+ * @param fraction - Fraction of balance to spend (between 0 and 1)
+ * @param recipientIdOrName - Address or name of recipient account
+ * @param options - Options
+ * @returns Transaction
+ */
+export async function transferFunds(fraction, recipientIdOrName, options) {
+  if (fraction < 0 || fraction > 1) {
+    throw new ArgumentError('fraction', 'a number between 0 and 1', fraction);
+  }
+
+  const recipientId = await resolveName(recipientIdOrName, 'account_pubkey', options);
+  const senderId = await options.onAccount.address(options);
+  const balance = new BigNumber(await getBalance.bind(options.onAccount)(senderId, options));
+  const desiredAmount = balance.times(fraction).integerValue(BigNumber.ROUND_HALF_UP);
+  const {
+    tx: {
+      fee
+    }
+  } = unpackTx(await _buildTx(TX_TYPE.spend, { ...options,
+    senderId,
+    recipientId,
+    amount: desiredAmount
+  }), TX_TYPE.spend); // 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 await send(await _buildTx(TX_TYPE.spend, { ...options,
+    senderId,
+    recipientId,
+    amount
+  }), options);
+}
+
+/**
+ * Submit transaction of another account paying for it (fee and gas)
+ * @param transaction - tx_<base64>-encoded transaction
+ * @param options - Options
+ * @returns Object Transaction
+ */
+export async function payForTransaction(transaction, options) {
+  return await send(await _buildTx(TX_TYPE.payingFor, { ...options,
+    payerId: await options.onAccount.address(options),
+    tx: transaction
+  }), options);
+}
+//# sourceMappingURL=spend.mjs.map