@fleet-sdk/blockchain-providers 0.3.0

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# @fleet-sdk/blockchain-providers
+
+## 0.3.0
+
+### Minor Changes
+
+- feb2109: Introduce `@fleet-sdk/blockchain-providers` package with `ErgoGraphQLProvider`
+
+### Patch Changes
+
+- Updated dependencies [d05b74d]
+- Updated dependencies [c42ca0d]
+- Updated dependencies [d08255c]
+  - @fleet-sdk/common@0.3.0
+  - @fleet-sdk/core@0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Nautilus Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,15 @@
+# @fleet-sdk/blockchain-providers [![License](https://badgen.net/github/license/fleet-sdk/fleet/)](https://github.com/fleet-sdk/fleet/blob/master/LICENSE) [![npm](https://badgen.net/npm/v/@fleet-sdk/blockchain-providers)](https://www.npmjs.com/package/@fleet-sdk/blockchain-providers)
+
+Ergo Blockchain data providers.
+
+## Build
+
+```sh
+pnpm --filter blockchain-providers build
+```
+
+## Test
+
+```sh
+pnpm test:unit blockchain-providers
+```

package/dist/index.cjs.js

@@ -0,0 +1,215 @@
+'use strict';
+
+var common = require('@fleet-sdk/common');
+var core = require('@fleet-sdk/core');
+
+// src/ergo-graphql/ergoGraphQLProvider.ts
+var OP_NAME_REGEX = /(query|mutation)\s?([\w\-_]+)?/;
+var DEFAULT_HEADERS = {
+  "content-type": "application/json; charset=utf-8",
+  accept: "application/graphql-response+json, application/json"
+};
+function createGqlOperation(query, options) {
+  return async (variables) => {
+    const response = await (options.fetcher ?? fetch)(options.url, {
+      method: "POST",
+      headers: common.ensureDefaults(options.headers, DEFAULT_HEADERS),
+      credentials: options.credentials,
+      body: (options.parser ?? JSON).stringify({
+        operationName: getOpName(query),
+        query,
+        variables: variables ? common.clearUndefined(variables) : void 0
+      })
+    });
+    const rawData = await response.text();
+    const parsedData = (options.parser ?? JSON).parse(rawData);
+    if (options.throwOnNonNetworkErrors && common.some(parsedData.errors) && common.isEmpty(parsedData.data)) {
+      throw new common.BlockchainProviderError(parsedData.errors[0].message, { cause: parsedData.errors });
+    }
+    return parsedData;
+  };
+}
+function getOpName(query) {
+  return OP_NAME_REGEX.exec(query)?.at(2);
+}
+function isRequestParam(obj) {
+  return typeof obj === "object" && obj.url !== void 0;
+}
+
+// src/ergo-graphql/queries.ts
+var B = [
+  `query boxes($spent: Boolean! $boxIds: [String!] $ergoTrees: [String!] $ergoTreeTemplateHash: String $tokenId: String $skip: Int $take: Int)`,
+  `boxIds: $boxIds ergoTrees: $ergoTrees ergoTreeTemplateHash: $ergoTreeTemplateHash tokenId: $tokenId skip: $skip take: $take`,
+  `boxId transactionId index value creationHeight ergoTree assets { tokenId amount } additionalRegisters beingSpent`
+];
+var CONF_BOXES_QUERY = `${B[0]} { boxes(spent: $spent ${B[1]}) { ${B[2]} } }`;
+var UNCONF_BOXES_QUERY = `${B[0]} { mempool { boxes(${B[1]}) { ${B[2]} } } }`;
+var ALL_BOXES_QUERY = `${B[0]} { boxes(spent: $spent ${B[1]}) { ${B[2]} } mempool { boxes(${B[1]}) { ${B[2]} } } }`;
+var HEADERS_QUERY = `query blockHeaders($take: Int) { blockHeaders(take: $take) {headerId timestamp version adProofsRoot stateRoot transactionsRoot nBits extensionHash powSolutions height difficulty parentId votes } }`;
+var CHECK_TX_MUTATION = `mutation checkTransaction($signedTransaction: SignedTransaction!) { checkTransaction(signedTransaction: $signedTransaction) }`;
+var SEND_TX_MUTATION = `mutation submitTransaction($signedTransaction: SignedTransaction!) { submitTransaction(signedTransaction: $signedTransaction) }`;
+
+// src/ergo-graphql/ergoGraphQLProvider.ts
+var PAGE_SIZE = 50;
+var ErgoGraphQLProvider = class {
+  #options;
+  #getConfBoxes;
+  #getUnconfBoxes;
+  #getAllBoxes;
+  #getHeaders;
+  #checkTx;
+  #sendTx;
+  constructor(optOrUrl) {
+    this.#options = {
+      ...isRequestParam(optOrUrl) ? optOrUrl : { url: optOrUrl },
+      throwOnNonNetworkErrors: true
+    };
+    this.#getConfBoxes = this.createOperation(CONF_BOXES_QUERY);
+    this.#getUnconfBoxes = this.createOperation(UNCONF_BOXES_QUERY);
+    this.#getAllBoxes = this.createOperation(ALL_BOXES_QUERY);
+    this.#getHeaders = this.createOperation(HEADERS_QUERY);
+    this.#checkTx = this.createOperation(CHECK_TX_MUTATION);
+    this.#sendTx = this.createOperation(SEND_TX_MUTATION);
+  }
+  #fetchBoxes(args, inclConf, inclUnconf) {
+    if (inclConf && inclUnconf) {
+      return this.#getAllBoxes(args);
+    } else if (inclUnconf) {
+      return this.#getUnconfBoxes(args);
+    } else {
+      return this.#getConfBoxes(args);
+    }
+  }
+  async *streamBoxes(query) {
+    if (common.isEmpty(query.where)) {
+      throw new Error("Cannot fetch unspent boxes without a where clause.");
+    }
+    const notBeingSpent = (box) => !box.beingSpent;
+    const returnedBoxIds = /* @__PURE__ */ new Set();
+    const { where, from } = query;
+    const args = buildGqlBoxQueryArgs(where);
+    let fetchFromChain = from !== "mempool";
+    let fetchFromMempool = from !== "blockchain";
+    const isMempoolAware = fetchFromMempool;
+    do {
+      const response = await this.#fetchBoxes(args, fetchFromChain, fetchFromMempool);
+      const { data } = response;
+      let boxes = [];
+      if (fetchFromChain && hasConfirmed(data)) {
+        if (common.some(data.boxes)) {
+          const confirmedBoxes = (isMempoolAware ? data.boxes.filter(notBeingSpent) : data.boxes).map(asConfirmed(true));
+          boxes = boxes.concat(confirmedBoxes);
+        }
+        fetchFromChain = data.boxes.length === PAGE_SIZE;
+      }
+      if (isMempoolAware && hasMempool(data)) {
+        if (common.some(data.mempool.boxes)) {
+          const mempoolBoxes = data.mempool.boxes.filter(notBeingSpent).map(asConfirmed(false));
+          boxes = boxes.concat(mempoolBoxes);
+        }
+        fetchFromMempool = data.mempool.boxes.length === PAGE_SIZE;
+      }
+      if (common.some(boxes)) {
+        if (boxes.some((box) => returnedBoxIds.has(box.boxId))) {
+          boxes = boxes.filter((b) => !returnedBoxIds.has(b.boxId));
+        }
+        if (common.some(boxes)) {
+          boxes = common.uniqBy(boxes, (box) => box.boxId);
+          boxes.forEach((box) => returnedBoxIds.add(box.boxId));
+          yield boxes;
+        }
+      }
+      if (fetchFromChain || fetchFromMempool)
+        args.skip += PAGE_SIZE;
+    } while (fetchFromChain || fetchFromMempool);
+  }
+  async getBoxes(query) {
+    let boxes = [];
+    for await (const chunk of this.streamBoxes(query)) {
+      boxes = boxes.concat(chunk);
+    }
+    return common.orderBy(boxes, (box) => box.creationHeight);
+  }
+  async getHeaders(query) {
+    const response = await this.#getHeaders(query);
+    return response.data?.blockHeaders.map((header) => ({
+      ...header,
+      id: header.headerId,
+      timestamp: Number(header.timestamp),
+      nBits: Number(header.nBits),
+      votes: header.votes.join("")
+    })) ?? [];
+  }
+  createOperation(query, options) {
+    const opt = common.ensureDefaults(options, this.#options);
+    opt.throwOnNonNetworkErrors = true;
+    return createGqlOperation(query, opt);
+  }
+  async checkTransaction(signedTransaction) {
+    try {
+      const response = await this.#checkTx({ signedTransaction });
+      return { success: true, transactionId: response.data.checkTransaction };
+    } catch (e) {
+      return { success: false, message: e.message };
+    }
+  }
+  async submitTransaction(signedTransaction) {
+    try {
+      const response = await this.#sendTx({ signedTransaction });
+      return { success: true, transactionId: response.data.submitTransaction };
+    } catch (e) {
+      return { success: false, message: e.message };
+    }
+  }
+  reduceTransaction() {
+    throw new common.NotSupportedError("Transaction reducing is not supported by ergo-graphql.");
+  }
+};
+function buildGqlBoxQueryArgs(where) {
+  const args = {
+    spent: false,
+    boxIds: merge(where.boxIds, where.boxId),
+    ergoTrees: merge(where.ergoTrees, where.ergoTree),
+    ergoTreeTemplateHash: where.templateHash,
+    tokenId: where.tokenId,
+    skip: 0,
+    take: PAGE_SIZE
+  };
+  const addresses = merge(where.addresses, where.address);
+  if (common.some(addresses)) {
+    const trees = addresses.map(
+      (address) => typeof address === "string" ? core.ErgoAddress.fromBase58(address).ergoTree : address.ergoTree
+    );
+    args.ergoTrees = common.uniq(common.some(args.ergoTrees) ? args.ergoTrees.concat(trees) : trees);
+  }
+  return args;
+}
+function merge(array, el) {
+  if (common.isEmpty(array) && common.isUndefined(el))
+    return;
+  const set = new Set(array ?? []);
+  if (!common.isUndefined(el))
+    set.add(el);
+  return Array.from(set.values());
+}
+function hasMempool(data) {
+  return !!data?.mempool?.boxes;
+}
+function hasConfirmed(data) {
+  return !!data?.boxes;
+}
+function asConfirmed(confirmed) {
+  return (box) => ({
+    ...box,
+    value: BigInt(box.value),
+    assets: box.assets.map((asset) => ({
+      tokenId: asset.tokenId,
+      amount: BigInt(asset.amount)
+    })),
+    confirmed
+  });
+}
+
+exports.ErgoGraphQLProvider = ErgoGraphQLProvider;
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ergo-graphql/ergoGraphQLProvider.ts","../src/utils/graphql.ts","../src/ergo-graphql/queries.ts"],"names":["ensureDefaults","isEmpty","some"],"mappings":";AAMA;AAAA,EAGE,kBAAAA;AAAA,EAEA,WAAAC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA,QAAAC;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,mBAAmB;;;ACpB5B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,IAAM,gBAAgB;AACf,IAAM,kBAA2B;AAAA,EACtC,gBAAgB;AAAA,EAChB,QAAQ;AACV;AA4DO,SAAS,mBACd,OACA,SACyC;AACzC,SAAO,OAAO,cAA+C;AAC3D,UAAM,WAAW,OAAO,QAAQ,WAAW,OAAO,QAAQ,KAAK;AAAA,MAC7D,QAAQ;AAAA,MACR,SAAS,eAAe,QAAQ,SAAS,eAAe;AAAA,MACxD,aAAa,QAAQ;AAAA,MACrB,OAAO,QAAQ,UAAU,MAAM,UAAU;AAAA,QACvC,eAAe,UAAU,KAAK;AAAA,QAC9B;AAAA,QACA,WAAW,YAAY,eAAe,SAAS,IAAI;AAAA,MACrD,CAAkB;AAAA,IACpB,CAAC;AAED,UAAM,UAAU,MAAM,SAAS,KAAK;AACpC,UAAM,cAAc,QAAQ,UAAU,MAAM,MAAM,OAAO;AAEzD,QAAI,QAAQ,2BAA2B,KAAK,WAAW,MAAM,KAAK,QAAQ,WAAW,IAAI,GAAG;AAC1F,YAAM,IAAI,wBAAwB,WAAW,OAAO,CAAC,EAAE,SAAS,EAAE,OAAO,WAAW,OAAO,CAAC;AAAA,IAC9F;AAEA,WAAO;AAAA,EACT;AACF;AAMO,SAAS,UAAU,OAAmC;AAC3D,SAAO,cAAc,KAAK,KAAK,GAAG,GAAG,CAAC;AACxC;AAEO,SAAS,eAAe,KAA4C;AACzE,SAAO,OAAO,QAAQ,YAAa,IAA8B,QAAQ;AAC3E;;;AC7GA,IAAM,IAAI;AAAA,EACR;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,mBAAmB,GAAG,EAAE,CAAC,CAAC,0BAA0B,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AACzE,IAAM,qBAAqB,GAAG,EAAE,CAAC,CAAC,sBAAsB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AACvE,IAAM,kBAAkB,GAAG,EAAE,CAAC,CAAC,0BAA0B,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,sBAAsB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AAC7G,IAAM,gBAAgB;AACtB,IAAM,oBAAoB;AAC1B,IAAM,mBAAmB;;;AF2DhC,IAAM,YAAY;AAEX,IAAM,sBAAN,MAAmE;AAAA,EACxE;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAIA,YAAY,UAAoD;AAC9D,SAAK,WAAW;AAAA,MACd,GAAI,eAAe,QAAQ,IAAI,WAAW,EAAE,KAAK,SAAS;AAAA,MAC1D,yBAAyB;AAAA,IAC3B;AAEA,SAAK,gBAAgB,KAAK,gBAA0C,gBAAgB;AACpF,SAAK,kBAAkB,KAAK,gBAA4C,kBAAkB;AAC1F,SAAK,eAAe,KAAK,gBAAyC,eAAe;AACjF,SAAK,cAAc,KAAK,gBAA0C,aAAa;AAC/E,SAAK,WAAW,KAAK,gBAA+C,iBAAiB;AACrF,SAAK,UAAU,KAAK,gBAA8C,gBAAgB;AAAA,EACpF;AAAA,EAEA,YAAY,MAAiB,UAAmB,YAAqB;AACnE,QAAI,YAAY,YAAY;AAC1B,aAAO,KAAK,aAAa,IAAI;AAAA,IAC/B,WAAW,YAAY;AACrB,aAAO,KAAK,gBAAgB,IAAI;AAAA,IAClC,OAAO;AACL,aAAO,KAAK,cAAc,IAAI;AAAA,IAChC;AAAA,EACF;AAAA,EAEA,OAAO,YAAY,OAA4D;AAC7E,QAAID,SAAQ,MAAM,KAAK,GAAG;AACxB,YAAM,IAAI,MAAM,oDAAoD;AAAA,IACtE;AAEA,UAAM,gBAAgB,CAAC,QAAa,CAAC,IAAI;AACzC,UAAM,iBAAiB,oBAAI,IAAY;AACvC,UAAM,EAAE,OAAO,KAAK,IAAI;AACxB,UAAM,OAAO,qBAAqB,KAAK;AAEvC,QAAI,iBAAiB,SAAS;AAC9B,QAAI,mBAAmB,SAAS;AAChC,UAAM,iBAAiB;AAEvB,OAAG;AACD,YAAM,WAAW,MAAM,KAAK,YAAY,MAAM,gBAAgB,gBAAgB;AAE9E,YAAM,EAAE,KAAK,IAAI;AACjB,UAAI,QAA4B,CAAC;AAEjC,UAAI,kBAAkB,aAAa,IAAI,GAAG;AACxC,YAAIC,MAAK,KAAK,KAAK,GAAG;AACpB,gBAAM,kBACJ,iBAAiB,KAAK,MAAM,OAAO,aAAa,IAAI,KAAK,OACzD,IAAI,YAAY,IAAI,CAAC;AAEvB,kBAAQ,MAAM,OAAO,cAAc;AAAA,QACrC;AAEA,yBAAiB,KAAK,MAAM,WAAW;AAAA,MACzC;AAEA,UAAI,kBAAkB,WAAW,IAAI,GAAG;AACtC,YAAIA,MAAK,KAAK,QAAQ,KAAK,GAAG;AAC5B,gBAAM,eAAe,KAAK,QAAQ,MAAM,OAAO,aAAa,EAAE,IAAI,YAAY,KAAK,CAAC;AACpF,kBAAQ,MAAM,OAAO,YAAY;AAAA,QACnC;AAEA,2BAAmB,KAAK,QAAQ,MAAM,WAAW;AAAA,MACnD;AAEA,UAAIA,MAAK,KAAK,GAAG;AAGf,YAAI,MAAM,KAAK,CAAC,QAAQ,eAAe,IAAI,IAAI,KAAK,CAAC,GAAG;AACtD,kBAAQ,MAAM,OAAO,CAAC,MAAM,CAAC,eAAe,IAAI,EAAE,KAAK,CAAC;AAAA,QAC1D;AAEA,YAAIA,MAAK,KAAK,GAAG;AACf,kBAAQ,OAAO,OAAO,CAAC,QAAQ,IAAI,KAAK;AACxC,gBAAM,QAAQ,CAAC,QAAQ,eAAe,IAAI,IAAI,KAAK,CAAC;AAEpD,gBAAM;AAAA,QACR;AAAA,MACF;AAEA,UAAI,kBAAkB;AAAkB,aAAK,QAAQ;AAAA,IACvD,SAAS,kBAAkB;AAAA,EAC7B;AAAA,EAEA,MAAM,SAAS,OAAqD;AAClE,QAAI,QAA4B,CAAC;AACjC,qBAAiB,SAAS,KAAK,YAAY,KAAK,GAAG;AACjD,cAAQ,MAAM,OAAO,KAAK;AAAA,IAC5B;AAEA,WAAO,QAAQ,OAAO,CAAC,QAAQ,IAAI,cAAc;AAAA,EACnD;AAAA,EAEA,MAAM,WAAW,OAA4C;AAC3D,UAAM,WAAW,MAAM,KAAK,YAAY,KAAK;AAE7C,WACE,SAAS,MAAM,aAAa,IAAI,CAAC,YAAY;AAAA,MAC3C,GAAG;AAAA,MACH,IAAI,OAAO;AAAA,MACX,WAAW,OAAO,OAAO,SAAS;AAAA,MAClC,OAAO,OAAO,OAAO,KAAK;AAAA,MAC1B,OAAO,OAAO,MAAM,KAAK,EAAE;AAAA,IAC7B,EAAE,KAAK,CAAC;AAAA,EAEZ;AAAA,EAEA,gBACE,OACA,SACgD;AAChD,UAAM,MAAMF,gBAAe,SAAS,KAAK,QAAQ;AACjD,QAAI,0BAA0B;AAE9B,WAAO,mBAAmB,OAAO,GAAG;AAAA,EACtC;AAAA,EAEA,MAAM,iBACJ,mBACsC;AACtC,QAAI;AACF,YAAM,WAAW,MAAM,KAAK,SAAS,EAAE,kBAAkB,CAAC;AAE1D,aAAO,EAAE,SAAS,MAAM,eAAe,SAAS,KAAK,iBAAiB;AAAA,IACxE,SAAS,GAAG;AACV,aAAO,EAAE,SAAS,OAAO,SAAU,EAAY,QAAQ;AAAA,IACzD;AAAA,EACF;AAAA,EAEA,MAAM,kBACJ,mBACsC;AACtC,QAAI;AACF,YAAM,WAAW,MAAM,KAAK,QAAQ,EAAE,kBAAkB,CAAC;AAEzD,aAAO,EAAE,SAAS,MAAM,eAAe,SAAS,KAAK,kBAAkB;AAAA,IACzE,SAAS,GAAG;AACV,aAAO,EAAE,SAAS,OAAO,SAAU,EAAY,QAAQ;AAAA,IACzD;AAAA,EACF;AAAA,EAEA,oBAAyD;AACvD,UAAM,IAAI,kBAAkB,wDAAwD;AAAA,EACtF;AACF;AAEA,SAAS,qBAAqB,OAAwB;AACpD,QAAM,OAAO;AAAA,IACX,OAAO;AAAA,IACP,QAAQ,MAAM,MAAM,QAAQ,MAAM,KAAK;AAAA,IACvC,WAAW,MAAM,MAAM,WAAW,MAAM,QAAQ;AAAA,IAChD,sBAAsB,MAAM;AAAA,IAC5B,SAAS,MAAM;AAAA,IACf,MAAM;AAAA,IACN,MAAM;AAAA,EACR;AAEA,QAAM,YAAY,MAAM,MAAM,WAAW,MAAM,OAAO;AACtD,MAAIE,MAAK,SAAS,GAAG;AACnB,UAAM,QAAQ,UAAU;AAAA,MAAI,CAAC,YAC3B,OAAO,YAAY,WAAW,YAAY,WAAW,OAAO,EAAE,WAAW,QAAQ;AAAA,IACnF;AAEA,SAAK,YAAY,KAAKA,MAAK,KAAK,SAAS,IAAI,KAAK,UAAU,OAAO,KAAK,IAAI,KAAK;AAAA,EACnF;AAEA,SAAO;AACT;AAEA,SAAS,MAAS,OAAa,IAAQ;AACrC,MAAID,SAAQ,KAAK,KAAK,YAAY,EAAE;AAAG;AAEvC,QAAM,MAAM,IAAI,IAAO,SAAS,CAAC,CAAC;AAClC,MAAI,CAAC,YAAY,EAAE;AAAG,QAAI,IAAI,EAAE;AAChC,SAAO,MAAM,KAAK,IAAI,OAAO,CAAC;AAChC;AAEA,SAAS,WAAW,MAA+E;AACjG,SAAO,CAAC,CAAE,MAA0B,SAAS;AAC/C;AAEA,SAAS,aAAa,MAA6E;AACjG,SAAO,CAAC,CAAE,MAAwB;AACpC;AAEA,SAAS,YAAY,WAAoB;AACvC,SAAO,CAAC,SAAgC;AAAA,IACtC,GAAG;AAAA,IACH,OAAO,OAAO,IAAI,KAAK;AAAA,IACvB,QAAQ,IAAI,OAAO,IAAI,CAAC,WAAW;AAAA,MACjC,SAAS,MAAM;AAAA,MACf,QAAQ,OAAO,MAAM,MAAM;AAAA,IAC7B,EAAE;AAAA,IACF;AAAA,EACF;AACF","sourcesContent":["import {\n  Box,\n  QueryBoxesArgs as BoxesArgs,\n  Header,\n  QueryBlockHeadersArgs as HeadersArgs\n} from \"@ergo-graphql/types\";\nimport {\n  Base58String,\n  BlockHeader,\n  ensureDefaults,\n  HexString,\n  isEmpty,\n  isUndefined,\n  NotSupportedError,\n  orderBy,\n  SignedTransaction,\n  some,\n  uniq,\n  uniqBy\n} from \"@fleet-sdk/common\";\nimport { ErgoAddress } from \"@fleet-sdk/core\";\nimport {\n  BoxQuery,\n  BoxWhere,\n  ChainProviderBox,\n  HeaderQuery,\n  IBlockchainProvider,\n  TransactionEvaluationResult,\n  TransactionReductionResult\n} from \"../types\";\nimport {\n  createGqlOperation,\n  GraphQLOperation,\n  GraphQLRequestOptions,\n  GraphQLSuccessResponse,\n  GraphQLThrowableOptions,\n  GraphQLVariables,\n  isRequestParam\n} from \"../utils\";\nimport {\n  ALL_BOXES_QUERY,\n  CHECK_TX_MUTATION,\n  CONF_BOXES_QUERY,\n  HEADERS_QUERY,\n  SEND_TX_MUTATION,\n  UNCONF_BOXES_QUERY\n} from \"./queries\";\n\nexport type GraphQLBoxWhere = BoxWhere & {\n  /** Base16-encoded BoxIds */\n  boxIds?: HexString[];\n\n  /** Base16-encoded ErgoTrees */\n  ergoTrees?: HexString[];\n\n  /** Base58-encoded addresses or `ErgoAddress` objects */\n  addresses?: (Base58String | ErgoAddress)[];\n};\n\nexport type GraphQLBoxQuery = BoxQuery<GraphQLBoxWhere>;\nexport type ErgoGraphQLRequestOptions = Omit<GraphQLRequestOptions, \"throwOnNonNetworkError\">;\n\ntype ConfBoxesResp = { boxes: Box[] };\ntype UnconfBoxesResp = { mempool: { boxes: Box[] } };\ntype AllBoxesResp = ConfBoxesResp & UnconfBoxesResp;\ntype HeadersResp = { blockHeaders: Header[] };\ntype CheckTxResp = { checkTransaction: string };\ntype SendTxResp = { submitTransaction: string };\ntype SignedTxArgsResp = { signedTransaction: SignedTransaction };\n\nconst PAGE_SIZE = 50;\n\nexport class ErgoGraphQLProvider implements IBlockchainProvider<BoxWhere> {\n  #options: GraphQLThrowableOptions;\n\n  #getConfBoxes;\n  #getUnconfBoxes;\n  #getAllBoxes;\n  #getHeaders;\n  #checkTx;\n  #sendTx;\n\n  constructor(url: string | URL);\n  constructor(url: ErgoGraphQLRequestOptions);\n  constructor(optOrUrl: ErgoGraphQLRequestOptions | string | URL) {\n    this.#options = {\n      ...(isRequestParam(optOrUrl) ? optOrUrl : { url: optOrUrl }),\n      throwOnNonNetworkErrors: true\n    };\n\n    this.#getConfBoxes = this.createOperation<ConfBoxesResp, BoxesArgs>(CONF_BOXES_QUERY);\n    this.#getUnconfBoxes = this.createOperation<UnconfBoxesResp, BoxesArgs>(UNCONF_BOXES_QUERY);\n    this.#getAllBoxes = this.createOperation<AllBoxesResp, BoxesArgs>(ALL_BOXES_QUERY);\n    this.#getHeaders = this.createOperation<HeadersResp, HeadersArgs>(HEADERS_QUERY);\n    this.#checkTx = this.createOperation<CheckTxResp, SignedTxArgsResp>(CHECK_TX_MUTATION);\n    this.#sendTx = this.createOperation<SendTxResp, SignedTxArgsResp>(SEND_TX_MUTATION);\n  }\n\n  #fetchBoxes(args: BoxesArgs, inclConf: boolean, inclUnconf: boolean) {\n    if (inclConf && inclUnconf) {\n      return this.#getAllBoxes(args);\n    } else if (inclUnconf) {\n      return this.#getUnconfBoxes(args);\n    } else {\n      return this.#getConfBoxes(args);\n    }\n  }\n\n  async *streamBoxes(query: GraphQLBoxQuery): AsyncGenerator<ChainProviderBox[]> {\n    if (isEmpty(query.where)) {\n      throw new Error(\"Cannot fetch unspent boxes without a where clause.\");\n    }\n\n    const notBeingSpent = (box: Box) => !box.beingSpent;\n    const returnedBoxIds = new Set<string>();\n    const { where, from } = query;\n    const args = buildGqlBoxQueryArgs(where);\n\n    let fetchFromChain = from !== \"mempool\";\n    let fetchFromMempool = from !== \"blockchain\";\n    const isMempoolAware = fetchFromMempool;\n\n    do {\n      const response = await this.#fetchBoxes(args, fetchFromChain, fetchFromMempool);\n\n      const { data } = response;\n      let boxes: ChainProviderBox[] = [];\n\n      if (fetchFromChain && hasConfirmed(data)) {\n        if (some(data.boxes)) {\n          const confirmedBoxes = (\n            isMempoolAware ? data.boxes.filter(notBeingSpent) : data.boxes\n          ).map(asConfirmed(true));\n\n          boxes = boxes.concat(confirmedBoxes);\n        }\n\n        fetchFromChain = data.boxes.length === PAGE_SIZE;\n      }\n\n      if (isMempoolAware && hasMempool(data)) {\n        if (some(data.mempool.boxes)) {\n          const mempoolBoxes = data.mempool.boxes.filter(notBeingSpent).map(asConfirmed(false));\n          boxes = boxes.concat(mempoolBoxes);\n        }\n\n        fetchFromMempool = data.mempool.boxes.length === PAGE_SIZE;\n      }\n\n      if (some(boxes)) {\n        // boxes can be moved from the mempool to the blockchain while streaming,\n        // so we need to filter out boxes that have already been returned.\n        if (boxes.some((box) => returnedBoxIds.has(box.boxId))) {\n          boxes = boxes.filter((b) => !returnedBoxIds.has(b.boxId));\n        }\n\n        if (some(boxes)) {\n          boxes = uniqBy(boxes, (box) => box.boxId);\n          boxes.forEach((box) => returnedBoxIds.add(box.boxId));\n\n          yield boxes;\n        }\n      }\n\n      if (fetchFromChain || fetchFromMempool) args.skip += PAGE_SIZE;\n    } while (fetchFromChain || fetchFromMempool);\n  }\n\n  async getBoxes(query: GraphQLBoxQuery): Promise<ChainProviderBox[]> {\n    let boxes: ChainProviderBox[] = [];\n    for await (const chunk of this.streamBoxes(query)) {\n      boxes = boxes.concat(chunk);\n    }\n\n    return orderBy(boxes, (box) => box.creationHeight);\n  }\n\n  async getHeaders(query: HeaderQuery): Promise<BlockHeader[]> {\n    const response = await this.#getHeaders(query);\n\n    return (\n      response.data?.blockHeaders.map((header) => ({\n        ...header,\n        id: header.headerId,\n        timestamp: Number(header.timestamp),\n        nBits: Number(header.nBits),\n        votes: header.votes.join(\"\")\n      })) ?? []\n    );\n  }\n\n  createOperation<R, V extends GraphQLVariables = GraphQLVariables>(\n    query: string,\n    options?: Partial<ErgoGraphQLRequestOptions>\n  ): GraphQLOperation<GraphQLSuccessResponse<R>, V> {\n    const opt = ensureDefaults(options, this.#options);\n    opt.throwOnNonNetworkErrors = true;\n\n    return createGqlOperation(query, opt);\n  }\n\n  async checkTransaction(\n    signedTransaction: SignedTransaction\n  ): Promise<TransactionEvaluationResult> {\n    try {\n      const response = await this.#checkTx({ signedTransaction });\n\n      return { success: true, transactionId: response.data.checkTransaction };\n    } catch (e) {\n      return { success: false, message: (e as Error).message };\n    }\n  }\n\n  async submitTransaction(\n    signedTransaction: SignedTransaction\n  ): Promise<TransactionEvaluationResult> {\n    try {\n      const response = await this.#sendTx({ signedTransaction });\n\n      return { success: true, transactionId: response.data.submitTransaction };\n    } catch (e) {\n      return { success: false, message: (e as Error).message };\n    }\n  }\n\n  reduceTransaction(): Promise<TransactionReductionResult> {\n    throw new NotSupportedError(\"Transaction reducing is not supported by ergo-graphql.\");\n  }\n}\n\nfunction buildGqlBoxQueryArgs(where: GraphQLBoxWhere) {\n  const args = {\n    spent: false,\n    boxIds: merge(where.boxIds, where.boxId),\n    ergoTrees: merge(where.ergoTrees, where.ergoTree),\n    ergoTreeTemplateHash: where.templateHash,\n    tokenId: where.tokenId,\n    skip: 0,\n    take: PAGE_SIZE\n  } satisfies BoxesArgs;\n\n  const addresses = merge(where.addresses, where.address);\n  if (some(addresses)) {\n    const trees = addresses.map((address) =>\n      typeof address === \"string\" ? ErgoAddress.fromBase58(address).ergoTree : address.ergoTree\n    );\n\n    args.ergoTrees = uniq(some(args.ergoTrees) ? args.ergoTrees.concat(trees) : trees);\n  }\n\n  return args;\n}\n\nfunction merge<T>(array?: T[], el?: T) {\n  if (isEmpty(array) && isUndefined(el)) return;\n\n  const set = new Set<T>(array ?? []);\n  if (!isUndefined(el)) set.add(el);\n  return Array.from(set.values());\n}\n\nfunction hasMempool(data: AllBoxesResp | ConfBoxesResp | UnconfBoxesResp): data is UnconfBoxesResp {\n  return !!(data as UnconfBoxesResp)?.mempool?.boxes;\n}\n\nfunction hasConfirmed(data: AllBoxesResp | ConfBoxesResp | UnconfBoxesResp): data is ConfBoxesResp {\n  return !!(data as ConfBoxesResp)?.boxes;\n}\n\nfunction asConfirmed(confirmed: boolean) {\n  return (box: Box): ChainProviderBox => ({\n    ...box,\n    value: BigInt(box.value),\n    assets: box.assets.map((asset) => ({\n      tokenId: asset.tokenId,\n      amount: BigInt(asset.amount)\n    })),\n    confirmed\n  });\n}\n","import {\n  BlockchainProviderError,\n  clearUndefined,\n  ensureDefaults,\n  isEmpty,\n  some\n} from \"@fleet-sdk/common\";\n\nconst OP_NAME_REGEX = /(query|mutation)\\s?([\\w\\-_]+)?/;\nexport const DEFAULT_HEADERS: Headers = {\n  \"content-type\": \"application/json; charset=utf-8\",\n  accept: \"application/graphql-response+json, application/json\"\n};\n\ntype Credentials = RequestCredentials;\ntype Headers = HeadersInit;\ntype Fetcher = typeof fetch;\n\nexport type GraphQLVariables = Record<string, unknown> | null;\n\nexport interface GraphQLError {\n  message: string;\n}\n\nexport interface GraphQLSuccessResponse<T = unknown> {\n  data: T;\n  errors: null;\n}\n\nexport interface GraphQLErrorResponse {\n  data: null;\n  errors: GraphQLError[];\n}\n\nexport type GraphQLResponse<T = unknown> = GraphQLSuccessResponse<T> | GraphQLErrorResponse;\n\nexport type GraphQLOperation<R extends GraphQLResponse, V extends GraphQLVariables> = (\n  variables?: V\n) => Promise<R>;\n\nexport interface ResponseParser {\n  parse<T>(text: string): T;\n  stringify<T>(value: T): string;\n}\n\nexport interface RequestParams {\n  operationName?: string | null;\n  query: string;\n  variables?: Record<string, unknown> | null;\n}\n\nexport interface GraphQLRequestOptions {\n  url: URL | string;\n  headers?: Headers;\n  parser?: ResponseParser;\n  fetcher?: Fetcher;\n  credentials?: Credentials;\n  throwOnNonNetworkErrors?: boolean;\n}\n\nexport interface GraphQLThrowableOptions extends GraphQLRequestOptions {\n  throwOnNonNetworkErrors: true;\n}\n\nexport function createGqlOperation<R, V extends GraphQLVariables = GraphQLVariables>(\n  query: string,\n  options: GraphQLThrowableOptions\n): GraphQLOperation<GraphQLSuccessResponse<R>, V>;\nexport function createGqlOperation<R, V extends GraphQLVariables = GraphQLVariables>(\n  query: string,\n  options: GraphQLRequestOptions\n): GraphQLOperation<GraphQLResponse<R>, V>;\nexport function createGqlOperation<R, V extends GraphQLVariables = GraphQLVariables>(\n  query: string,\n  options: GraphQLRequestOptions\n): GraphQLOperation<GraphQLResponse<R>, V> {\n  return async (variables?: V): Promise<GraphQLResponse<R>> => {\n    const response = await (options.fetcher ?? fetch)(options.url, {\n      method: \"POST\",\n      headers: ensureDefaults(options.headers, DEFAULT_HEADERS),\n      credentials: options.credentials,\n      body: (options.parser ?? JSON).stringify({\n        operationName: getOpName(query),\n        query,\n        variables: variables ? clearUndefined(variables) : undefined\n      } as RequestParams)\n    });\n\n    const rawData = await response.text();\n    const parsedData = (options.parser ?? JSON).parse(rawData) as GraphQLResponse<R>;\n\n    if (options.throwOnNonNetworkErrors && some(parsedData.errors) && isEmpty(parsedData.data)) {\n      throw new BlockchainProviderError(parsedData.errors[0].message, { cause: parsedData.errors });\n    }\n\n    return parsedData;\n  };\n}\n\nexport function gql(query: TemplateStringsArray): string {\n  return query[0];\n}\n\nexport function getOpName(query: string): string | undefined {\n  return OP_NAME_REGEX.exec(query)?.at(2);\n}\n\nexport function isRequestParam(obj: unknown): obj is GraphQLRequestOptions {\n  return typeof obj === \"object\" && (obj as GraphQLRequestOptions).url !== undefined;\n}\n","const B = [\n  `query boxes($spent: Boolean! $boxIds: [String!] $ergoTrees: [String!] $ergoTreeTemplateHash: String $tokenId: String $skip: Int $take: Int)`,\n  `boxIds: $boxIds ergoTrees: $ergoTrees ergoTreeTemplateHash: $ergoTreeTemplateHash tokenId: $tokenId skip: $skip take: $take`,\n  `boxId transactionId index value creationHeight ergoTree assets { tokenId amount } additionalRegisters beingSpent`\n];\n\nexport const CONF_BOXES_QUERY = `${B[0]} { boxes(spent: $spent ${B[1]}) { ${B[2]} } }`;\nexport const UNCONF_BOXES_QUERY = `${B[0]} { mempool { boxes(${B[1]}) { ${B[2]} } } }`;\nexport const ALL_BOXES_QUERY = `${B[0]} { boxes(spent: $spent ${B[1]}) { ${B[2]} } mempool { boxes(${B[1]}) { ${B[2]} } } }`;\nexport const HEADERS_QUERY = `query blockHeaders($take: Int) { blockHeaders(take: $take) {headerId timestamp version adProofsRoot stateRoot transactionsRoot nBits extensionHash powSolutions height difficulty parentId votes } }`;\nexport const CHECK_TX_MUTATION = `mutation checkTransaction($signedTransaction: SignedTransaction!) { checkTransaction(signedTransaction: $signedTransaction) }`;\nexport const SEND_TX_MUTATION = `mutation submitTransaction($signedTransaction: SignedTransaction!) { submitTransaction(signedTransaction: $signedTransaction) }`;\n"]}

package/dist/index.d.mts

@@ -0,0 +1,281 @@
+import { BoxId, HexString, Base58String, TokenId, Box, BlockHeader, SignedTransaction, UnsignedTransaction, TransactionId } from '@fleet-sdk/common';
+import { ErgoAddress } from '@fleet-sdk/core';
+
+declare global {
+	// eslint-disable-next-line @typescript-eslint/consistent-type-definitions -- It has to be an `interface` so that it can be merged.
+	interface SymbolConstructor {
+		readonly observable: symbol;
+	}
+}
+
+/**
+Returns a boolean for whether the two given types are equal.
+
+@link https://github.com/microsoft/TypeScript/issues/27024#issuecomment-421529650
+@link https://stackoverflow.com/questions/68961864/how-does-the-equals-work-in-typescript/68963796#68963796
+
+Use-cases:
+- If you want to make a conditional branch based on the result of a comparison of two types.
+
+@example
+```
+import type {IsEqual} from 'type-fest';
+
+// This type returns a boolean for whether the given array includes the given item.
+// `IsEqual` is used to compare the given array at position 0 and the given item and then return true if they are equal.
+type Includes<Value extends readonly any[], Item> =
+	Value extends readonly [Value[0], ...infer rest]
+		? IsEqual<Value[0], Item> extends true
+			? true
+			: Includes<rest, Item>
+		: false;
+```
+
+@category Type Guard
+@category Utilities
+*/
+type IsEqual<A, B> =
+	(<G>() => G extends A ? 1 : 2) extends
+	(<G>() => G extends B ? 1 : 2)
+		? true
+		: false;
+
+/**
+Filter out keys from an object.
+
+Returns `never` if `Exclude` is strictly equal to `Key`.
+Returns `never` if `Key` extends `Exclude`.
+Returns `Key` otherwise.
+
+@example
+```
+type Filtered = Filter<'foo', 'foo'>;
+//=> never
+```
+
+@example
+```
+type Filtered = Filter<'bar', string>;
+//=> never
+```
+
+@example
+```
+type Filtered = Filter<'bar', 'foo'>;
+//=> 'bar'
+```
+
+@see {Except}
+*/
+type Filter<KeyType, ExcludeType> = IsEqual<KeyType, ExcludeType> extends true ? never : (KeyType extends ExcludeType ? never : KeyType);
+
+type ExceptOptions = {
+	/**
+	Disallow assigning non-specified properties.
+
+	Note that any omitted properties in the resulting type will be present in autocomplete as `undefined`.
+
+	@default false
+	*/
+	requireExactProps?: boolean;
+};
+
+/**
+Create a type from an object type without certain keys.
+
+We recommend setting the `requireExactProps` option to `true`.
+
+This type is a stricter version of [`Omit`](https://www.typescriptlang.org/docs/handbook/release-notes/typescript-3-5.html#the-omit-helper-type). The `Omit` type does not restrict the omitted keys to be keys present on the given type, while `Except` does. The benefits of a stricter type are avoiding typos and allowing the compiler to pick up on rename refactors automatically.
+
+This type was proposed to the TypeScript team, which declined it, saying they prefer that libraries implement stricter versions of the built-in types ([microsoft/TypeScript#30825](https://github.com/microsoft/TypeScript/issues/30825#issuecomment-523668235)).
+
+@example
+```
+import type {Except} from 'type-fest';
+
+type Foo = {
+	a: number;
+	b: string;
+};
+
+type FooWithoutA = Except<Foo, 'a'>;
+//=> {b: string}
+
+const fooWithoutA: FooWithoutA = {a: 1, b: '2'};
+//=> errors: 'a' does not exist in type '{ b: string; }'
+
+type FooWithoutB = Except<Foo, 'b', {requireExactProps: true}>;
+//=> {a: number} & Partial<Record<"b", never>>
+
+const fooWithoutB: FooWithoutB = {a: 1, b: '2'};
+//=> errors at 'b': Type 'string' is not assignable to type 'undefined'.
+```
+
+@category Object
+*/
+type Except<ObjectType, KeysType extends keyof ObjectType, Options extends ExceptOptions = {requireExactProps: false}> = {
+	[KeyType in keyof ObjectType as Filter<KeyType, KeysType>]: ObjectType[KeyType];
+} & (Options['requireExactProps'] extends true
+	? Partial<Record<KeysType, never>>
+	: {});
+
+/**
+Create a type that requires at least one of the given keys. The remaining keys are kept as is.
+
+@example
+```
+import type {RequireAtLeastOne} from 'type-fest';
+
+type Responder = {
+	text?: () => string;
+	json?: () => string;
+	secure?: boolean;
+};
+
+const responder: RequireAtLeastOne<Responder, 'text' | 'json'> = {
+	json: () => '{"message": "ok"}',
+	secure: true
+};
+```
+
+@category Object
+*/
+type RequireAtLeastOne<
+	ObjectType,
+	KeysType extends keyof ObjectType = keyof ObjectType,
+> = {
+	// For each `Key` in `KeysType` make a mapped type:
+	[Key in KeysType]-?: Required<Pick<ObjectType, Key>> & // 1. Make `Key`'s type required
+	// 2. Make all other keys in `KeysType` optional
+	Partial<Pick<ObjectType, Exclude<KeysType, Key>>>;
+}[KeysType] &
+// 3. Add the remaining keys not in `KeysType`
+Except<ObjectType, KeysType>;
+
+type BoxSource = "blockchain" | "mempool" | "blockchain+mempool";
+type BoxQuery<W extends BoxWhere> = {
+    /** The query to filter boxes. */
+    where: RequireAtLeastOne<W>;
+    /**
+     * The source of boxes to query.
+     * @default "blockchain+mempool"
+     */
+    from?: BoxSource;
+};
+type HeaderQuery = {
+    take: number;
+};
+type BoxWhere = {
+    /** Base16-encoded BoxId */
+    boxId?: BoxId;
+    /** Base16-encoded ErgoTree */
+    ergoTree?: HexString;
+    /** Base58-encoded address */
+    address?: ErgoAddress | Base58String;
+    /** Base16-encoded contract template hash */
+    templateHash?: HexString;
+    /**  Base16-encoded TokenId */
+    tokenId?: TokenId;
+};
+type ChainProviderBox = Box<bigint> & {
+    confirmed: boolean;
+};
+type TransactionEvaluationError = {
+    success: false;
+    message: string;
+};
+type TransactionEvaluationSuccess = {
+    success: true;
+    transactionId: TransactionId;
+};
+type TransactionReductionSuccess = {
+    success: true;
+    reducedTransaction: HexString;
+};
+type TransactionEvaluationResult = TransactionEvaluationError | TransactionEvaluationSuccess;
+type TransactionReductionResult = TransactionEvaluationError | TransactionReductionSuccess;
+/**
+ * Represents a blockchain provider that can interact with the blockchain.
+ * @template B The type of the box query used by the provider.
+ */
+interface IBlockchainProvider<B extends BoxWhere> {
+    /**
+     * Get boxes.
+     */
+    getBoxes(query: BoxQuery<B>): Promise<ChainProviderBox[]>;
+    /**
+     * Stream boxes.
+     */
+    streamBoxes(query: BoxQuery<B>): AsyncIterable<ChainProviderBox[]>;
+    /**
+     * Get headers.
+     */
+    getHeaders(query: HeaderQuery): Promise<BlockHeader[]>;
+    /**
+     * Check for transaction validity without broadcasting it to the network.
+     */
+    checkTransaction(transaction: SignedTransaction): Promise<TransactionEvaluationResult>;
+    /**
+     * Broadcast a transaction to the network.
+     */
+    submitTransaction(transaction: SignedTransaction): Promise<TransactionEvaluationResult>;
+    /**
+     * Evaluate a transaction and return Base16-encoded evaluation result.
+     */
+    reduceTransaction(transaction: UnsignedTransaction): Promise<TransactionReductionResult>;
+}
+
+type Credentials = RequestCredentials;
+type Headers = HeadersInit;
+type Fetcher = typeof fetch;
+type GraphQLVariables = Record<string, unknown> | null;
+interface GraphQLError {
+    message: string;
+}
+interface GraphQLSuccessResponse<T = unknown> {
+    data: T;
+    errors: null;
+}
+interface GraphQLErrorResponse {
+    data: null;
+    errors: GraphQLError[];
+}
+type GraphQLResponse<T = unknown> = GraphQLSuccessResponse<T> | GraphQLErrorResponse;
+type GraphQLOperation<R extends GraphQLResponse, V extends GraphQLVariables> = (variables?: V) => Promise<R>;
+interface ResponseParser {
+    parse<T>(text: string): T;
+    stringify<T>(value: T): string;
+}
+interface GraphQLRequestOptions {
+    url: URL | string;
+    headers?: Headers;
+    parser?: ResponseParser;
+    fetcher?: Fetcher;
+    credentials?: Credentials;
+    throwOnNonNetworkErrors?: boolean;
+}
+
+type GraphQLBoxWhere = BoxWhere & {
+    /** Base16-encoded BoxIds */
+    boxIds?: HexString[];
+    /** Base16-encoded ErgoTrees */
+    ergoTrees?: HexString[];
+    /** Base58-encoded addresses or `ErgoAddress` objects */
+    addresses?: (Base58String | ErgoAddress)[];
+};
+type GraphQLBoxQuery = BoxQuery<GraphQLBoxWhere>;
+type ErgoGraphQLRequestOptions = Omit<GraphQLRequestOptions, "throwOnNonNetworkError">;
+declare class ErgoGraphQLProvider implements IBlockchainProvider<BoxWhere> {
+    #private;
+    constructor(url: string | URL);
+    constructor(url: ErgoGraphQLRequestOptions);
+    streamBoxes(query: GraphQLBoxQuery): AsyncGenerator<ChainProviderBox[]>;
+    getBoxes(query: GraphQLBoxQuery): Promise<ChainProviderBox[]>;
+    getHeaders(query: HeaderQuery): Promise<BlockHeader[]>;
+    createOperation<R, V extends GraphQLVariables = GraphQLVariables>(query: string, options?: Partial<ErgoGraphQLRequestOptions>): GraphQLOperation<GraphQLSuccessResponse<R>, V>;
+    checkTransaction(signedTransaction: SignedTransaction): Promise<TransactionEvaluationResult>;
+    submitTransaction(signedTransaction: SignedTransaction): Promise<TransactionEvaluationResult>;
+    reduceTransaction(): Promise<TransactionReductionResult>;
+}
+
+export { ErgoGraphQLProvider, ErgoGraphQLRequestOptions, GraphQLBoxQuery, GraphQLBoxWhere };