@bosonprotocol/core-sdk 1.16.0-alpha.13 → 1.16.0-alpha.15

package/dist/esm/meta-tx/handler.js

@@ -1,5 +1,7 @@
+import { BigNumber } from "@ethersproject/bignumber";
 import { bosonExchangeHandlerIface } from "../exchanges/interface";
 import { prepareDataSignatureParameters } from "../utils/signature";
+import { Biconomy } from "./biconomy";
 export async function signExecuteMetaTx(args) {
     const metaTransactionType = [
         { name: "nonce", type: "uint256" },
@@ -237,4 +239,58 @@ function makeExchangeMetaTxSigner(functionName) {
         };
     };
 }
+export async function relayMetaTransaction(args) {
+    const { chainId, contractAddress, metaTx } = args;
+    const biconomy = new Biconomy(metaTx.config.relayerUrl, metaTx.config.apiKey, metaTx.config.apiId);
+    const relayTxResponse = await biconomy.relayTransaction({
+        to: contractAddress,
+        params: [
+            metaTx.params.userAddress,
+            metaTx.params.functionName,
+            metaTx.params.functionSignature,
+            metaTx.params.nonce,
+            metaTx.params.sigR,
+            metaTx.params.sigS,
+            metaTx.params.sigV
+        ],
+        from: metaTx.params.userAddress
+    });
+    return {
+        wait: async () => {
+            const waitResponse = await biconomy.wait({
+                networkId: chainId,
+                transactionHash: relayTxResponse.txHash
+            });
+            // TODO: add `getTransaction(hash)` to `Web3LibAdapter` and respective implementations
+            // in ethers and eth-connect flavors. This way we can populate the correct transaction
+            // data below.
+            return {
+                to: contractAddress,
+                from: metaTx.params.userAddress,
+                contractAddress: contractAddress,
+                transactionIndex: 0,
+                gasUsed: BigNumber.from(0),
+                logsBloom: "",
+                blockHash: "string",
+                transactionHash: waitResponse.data.newHash,
+                logs: [],
+                blockNumber: 0,
+                confirmations: 0,
+                cumulativeGasUsed: BigNumber.from(0),
+                effectiveGasPrice: BigNumber.from(waitResponse.data.newGasPrice),
+                byzantium: true,
+                type: 0,
+                events: waitResponse.events?.map((event) => JSON.parse(event))
+            };
+        },
+        hash: relayTxResponse.txHash,
+        confirmations: 0,
+        from: metaTx.params.userAddress,
+        nonce: 0,
+        gasLimit: BigNumber.from(0),
+        data: "",
+        value: BigNumber.from(0),
+        chainId: chainId
+    };
+}
 //# sourceMappingURL=handler.js.map

package/dist/esm/meta-tx/handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../src/meta-tx/handler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../src/meta-tx/handler.ts"],"names":[],"mappings":"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"}

package/dist/esm/utils/errors.d.ts

@@ -0,0 +1,5 @@
+export declare class ApiError extends Error {
+    status: number;
+    constructor(status: number, message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/esm/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAS,SAAQ,KAAK;IACd,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAGnD"}

package/dist/esm/utils/errors.js

@@ -0,0 +1,8 @@
+export class ApiError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/esm/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,QAAS,SAAQ,KAAK;IACd;IAAnB,YAAmB,MAAc,EAAE,OAAe;QAChD,KAAK,CAAC,OAAO,CAAC,CAAC;QADE,WAAM,GAAN,MAAM,CAAQ;IAEjC,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bosonprotocol/core-sdk",
-  "version": "1.16.0-alpha.13",
+  "version": "1.16.0-alpha.15",
   "description": "> TODO: description",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
@@ -33,7 +33,7 @@
     "access": "restricted"
   },
   "dependencies": {
-    "@bosonprotocol/common": "^1.12.0-alpha.15",
+    "@bosonprotocol/common": "^1.12.0-alpha.17",
     "@ethersproject/abi": "^5.5.0",
     "@ethersproject/address": "^5.5.0",
     "@ethersproject/bignumber": "^5.5.0",
@@ -54,5 +54,5 @@
     "ts-jest": "^27.1.3",
     "typescript": "^4.5.5"
   },
-  "gitHead": "539ce4c82609b41461d4eb69055e4c5da2ce15b0"
+  "gitHead": "0d546da714a7bbf9641cb8444967669e6dff4d8b"
 }

package/src/core-sdk.ts

@@ -5,12 +5,14 @@ import {
   getDefaultConfig,
   MetadataStorage,
   AnyMetadata,
-  Log
+  Log,
+  MetaTxConfig
 } from "@bosonprotocol/common";
 import { BigNumberish } from "@ethersproject/bignumber";
 import { AddressZero } from "@ethersproject/constants";
 import { BytesLike } from "@ethersproject/bytes";
 import { EnvironmentType } from "@bosonprotocol/common/src/types";
+import { ContractTransaction } from "ethers";
 
 import * as accounts from "./accounts";
 import * as disputes from "./disputes";
@@ -35,6 +37,8 @@ export class CoreSDK {
   private _chainId: number;
   private _tokenInfoManager: TokenInfoManager;
 
+  private _metaTxConfig?: Partial<MetaTxConfig>;
+
   /**
    * Creates an instance of `CoreSDK`
    * @param args - Constructor args
@@ -46,6 +50,7 @@ export class CoreSDK {
     metadataStorage?: MetadataStorage;
     theGraphStorage?: MetadataStorage;
     chainId: number;
+    metaTx?: Partial<MetaTxConfig>;
   }) {
     this._web3Lib = opts.web3Lib;
     this._subgraphUrl = opts.subgraphUrl;
@@ -53,6 +58,7 @@ export class CoreSDK {
     this._metadataStorage = opts.metadataStorage;
     this._theGraphStorage = opts.theGraphStorage;
     this._chainId = opts.chainId;
+    this._metaTxConfig = opts.metaTx;
   }
 
   /**
@@ -76,6 +82,7 @@ export class CoreSDK {
     envName: EnvironmentType;
     metadataStorage?: MetadataStorage;
     theGraphStorage?: MetadataStorage;
+    metaTx?: Partial<MetaTxConfig>;
   }) {
     const defaultConfig = getDefaultConfig(args.envName);
 
@@ -85,10 +92,27 @@ export class CoreSDK {
       theGraphStorage: args.theGraphStorage,
       subgraphUrl: defaultConfig.subgraphUrl,
       protocolDiamond: defaultConfig.contracts.protocolDiamond,
-      chainId: defaultConfig.chainId
+      chainId: defaultConfig.chainId,
+      metaTx: {
+        ...defaultConfig.metaTx,
+        ...args.metaTx
+      }
     });
   }
 
+  public get metaTxConfig() {
+    return this._metaTxConfig;
+  }
+
+  public get isMetaTxConfigSet() {
+    return (
+      !!this._metaTxConfig &&
+      !!this._metaTxConfig.apiId &&
+      !!this._metaTxConfig.apiKey &&
+      !!this._metaTxConfig.relayerUrl
+    );
+  }
+
   /* -------------------------------------------------------------------------- */
   /*                          Metadata related methods                          */
   /* -------------------------------------------------------------------------- */
@@ -1405,4 +1429,62 @@ export class CoreSDK {
       ...args
     });
   }
+
+  /**
+   * Relay a meta transaction,
+   * @param metaTxParams - Required params for meta transaction.
+   * @param overrides - Optional overrides.
+   * @returns Transaction response.
+   */
+  public async relayMetaTransaction(
+    metaTxParams: {
+      functionName: string;
+      functionSignature: BytesLike;
+      nonce: BigNumberish;
+      sigR: BytesLike;
+      sigS: BytesLike;
+      sigV: BigNumberish;
+    },
+    overrides: Partial<{
+      userAddress: string;
+      contractAddress: string;
+      metaTxConfig: Partial<MetaTxConfig>;
+    }> = {}
+  ): Promise<ContractTransaction> {
+    const metaTxRelayerUrl =
+      this._metaTxConfig?.relayerUrl || overrides.metaTxConfig?.relayerUrl;
+    const metaTxApiKey =
+      this._metaTxConfig?.apiKey || overrides.metaTxConfig?.apiKey;
+    const metaTxApiId =
+      this._metaTxConfig?.apiId || overrides.metaTxConfig?.apiId;
+
+    if (!this.isMetaTxConfigSet) {
+      throw new Error(
+        "CoreSDK not configured to relay meta transactions. Either pass in 'relayerUrl', 'apiKey' and 'apiId' during initialization OR as overrides arguments."
+      );
+    }
+
+    return metaTx.handler.relayMetaTransaction({
+      web3LibAdapter: this._web3Lib,
+      contractAddress: overrides.contractAddress || this._protocolDiamond,
+      chainId: this._chainId,
+      metaTx: {
+        config: {
+          relayerUrl: metaTxRelayerUrl,
+          apiId: metaTxApiId,
+          apiKey: metaTxApiKey
+        },
+        params: {
+          userAddress:
+            overrides.userAddress || (await this._web3Lib.getSignerAddress()),
+          functionName: metaTxParams.functionName,
+          functionSignature: metaTxParams.functionSignature,
+          nonce: metaTxParams.nonce,
+          sigR: metaTxParams.sigR,
+          sigS: metaTxParams.sigS,
+          sigV: metaTxParams.sigV
+        }
+      }
+    });
+  }
 }

package/src/index.ts

@@ -12,7 +12,8 @@ export * as subgraph from "./subgraph";
 export {
   defaultConfigs,
   getDefaultConfig,
-  EnvironmentType
+  EnvironmentType,
+  MetaTxConfig
 } from "@bosonprotocol/common";
 
 export { MetadataType, AnyMetadata } from "@bosonprotocol/metadata";

package/src/meta-tx/biconomy.ts

@@ -0,0 +1,129 @@
+import fetch from "cross-fetch";
+
+import { ApiError } from "../utils/errors";
+
+export type RelayTransactionResponse = {
+  txHash: string;
+  log: string;
+  retryDuration: number;
+  flag: number;
+};
+
+export type RelayTransactionArgs = {
+  to: string;
+  params: unknown[];
+  from: string;
+};
+
+export type RelayOverrides = {
+  relayerUrl: string;
+  apiKey: string;
+  apiId: string;
+};
+
+export type GetRetriedHashesResponse = {
+  code: number;
+  message: string;
+  data: {
+    oldHash: string;
+    newHash: string;
+    oldGasPrice: string;
+    newGasPrice: string;
+    timestamp: number;
+    retryCount: number;
+    relayerAddress: string;
+    newStatus: string;
+  };
+  events?: unknown[];
+};
+
+export type GetRetriedHashesArgs = {
+  networkId: number;
+  transactionHash: string;
+};
+
+export class Biconomy {
+  public constructor(
+    private _relayerUrl: string,
+    private _apiKey: string,
+    private _apiId: string
+  ) {}
+
+  public async relayTransaction(
+    args: RelayTransactionArgs,
+    overrides: Partial<RelayOverrides> = {}
+  ): Promise<RelayTransactionResponse> {
+    const url = `${
+      overrides.relayerUrl || this._relayerUrl
+    }/api/v2/meta-tx/native`;
+    const response = await fetch(url, {
+      method: "POST",
+      headers: {
+        "x-api-key": overrides.apiKey || this._apiKey,
+        "content-type": "application/json;charset=UTF-8",
+        "Access-Control-Allow-Origin": "*"
+      },
+      body: JSON.stringify({
+        ...args,
+        apiId: overrides.apiId || this._apiId
+      })
+    });
+
+    if (!response.ok) {
+      throw new ApiError(
+        response.status,
+        `Failed to relay tx: ${response.statusText}`
+      );
+    }
+
+    return response.json() as Promise<RelayTransactionResponse>;
+  }
+
+  public async getResubmitted(
+    args: GetRetriedHashesArgs,
+    overrides: Partial<RelayOverrides> = {}
+  ): Promise<GetRetriedHashesResponse> {
+    const url = `${
+      overrides.relayerUrl || this._relayerUrl
+    }/api/v1/meta-tx/resubmitted?networkId=${args.networkId}&transactionHash=${
+      args.transactionHash
+    }`;
+    const response = await fetch(url, {
+      method: "GET",
+      headers: {
+        "content-type": "application/json;charset=UTF-8",
+        "Access-Control-Allow-Origin": "*"
+      }
+    });
+
+    if (!response.ok) {
+      throw new ApiError(
+        response.status,
+        `Failed to get resubmitted tx: ${response.statusText}`
+      );
+    }
+
+    return response.json() as Promise<GetRetriedHashesResponse>;
+  }
+
+  public async wait(
+    args: GetRetriedHashesArgs,
+    overrides: Partial<RelayOverrides> = {}
+  ): Promise<GetRetriedHashesResponse> {
+    let pending = true;
+    let resubmittedResponse: GetRetriedHashesResponse;
+
+    while (pending) {
+      resubmittedResponse = await this.getResubmitted(args, overrides);
+
+      pending = resubmittedResponse.data.newStatus === "PENDING";
+      if (pending) {
+        await new Promise((resolve) => {
+          setTimeout(resolve, 1000);
+        });
+      }
+    }
+
+    return resubmittedResponse;
+  }
+}

package/src/meta-tx/handler.ts

@@ -1,8 +1,11 @@
-import { Web3LibAdapter } from "@bosonprotocol/common";
-import { BigNumberish } from "@ethersproject/bignumber";
+import { MetaTxConfig, Web3LibAdapter } from "@bosonprotocol/common";
+import { BigNumber, BigNumberish } from "@ethersproject/bignumber";
+import { BytesLike } from "@ethersproject/bytes";
+import { ContractTransaction } from "@ethersproject/contracts";
 
 import { bosonExchangeHandlerIface } from "../exchanges/interface";
 import { prepareDataSignatureParameters } from "../utils/signature";
+import { Biconomy } from "./biconomy";
 
 type BaseMetaTxArgs = {
   web3Lib: Web3LibAdapter;
@@ -357,3 +360,82 @@ function makeExchangeMetaTxSigner(
     };
   };
 }
+
+export async function relayMetaTransaction(args: {
+  web3LibAdapter: Web3LibAdapter;
+  chainId: number;
+  contractAddress: string;
+  metaTx: {
+    config: MetaTxConfig;
+    params: {
+      userAddress: string;
+      functionName: string;
+      functionSignature: BytesLike;
+      nonce: BigNumberish;
+      sigR: BytesLike;
+      sigS: BytesLike;
+      sigV: BigNumberish;
+    };
+  };
+}): Promise<ContractTransaction> {
+  const { chainId, contractAddress, metaTx } = args;
+
+  const biconomy = new Biconomy(
+    metaTx.config.relayerUrl,
+    metaTx.config.apiKey,
+    metaTx.config.apiId
+  );
+
+  const relayTxResponse = await biconomy.relayTransaction({
+    to: contractAddress,
+    params: [
+      metaTx.params.userAddress,
+      metaTx.params.functionName,
+      metaTx.params.functionSignature,
+      metaTx.params.nonce,
+      metaTx.params.sigR,
+      metaTx.params.sigS,
+      metaTx.params.sigV
+    ],
+    from: metaTx.params.userAddress
+  });
+
+  return {
+    wait: async () => {
+      const waitResponse = await biconomy.wait({
+        networkId: chainId,
+        transactionHash: relayTxResponse.txHash
+      });
+
+      // TODO: add `getTransaction(hash)` to `Web3LibAdapter` and respective implementations
+      // in ethers and eth-connect flavors. This way we can populate the correct transaction
+      // data below.
+      return {
+        to: contractAddress,
+        from: metaTx.params.userAddress,
+        contractAddress: contractAddress,
+        transactionIndex: 0,
+        gasUsed: BigNumber.from(0),
+        logsBloom: "",
+        blockHash: "string",
+        transactionHash: waitResponse.data.newHash,
+        logs: [],
+        blockNumber: 0,
+        confirmations: 0,
+        cumulativeGasUsed: BigNumber.from(0),
+        effectiveGasPrice: BigNumber.from(waitResponse.data.newGasPrice),
+        byzantium: true,
+        type: 0,
+        events: waitResponse.events?.map((event) => JSON.parse(event as string))
+      };
+    },
+    hash: relayTxResponse.txHash,
+    confirmations: 0,
+    from: metaTx.params.userAddress,
+    nonce: 0,
+    gasLimit: BigNumber.from(0),
+    data: "",
+    value: BigNumber.from(0),
+    chainId: chainId
+  };
+}

package/src/utils/errors.ts

@@ -0,0 +1,5 @@
+export class ApiError extends Error {
+  constructor(public status: number, message: string) {
+    super(message);
+  }
+}