@0xsequence/relayer 0.40.5 → 0.41.0

package/dist/0xsequence-relayer.cjs.dev.js

@@ -237,50 +237,95 @@ class ProviderRelayer extends BaseRelayer {
     return transactions.encodeNonce(space, nonce);
   }
 
-  async wait(metaTxnId, timeout) {
+  async wait(metaTxnId, timeout, delay = this.waitPollRate, maxFails = 5) {
+    var _this2 = this;
+
     if (typeof metaTxnId !== 'string') {
-      utils.logger.info("computing id", metaTxnId.config, metaTxnId.context, metaTxnId.chainId, ...metaTxnId.transactions);
-      return this.wait(transactions.computeMetaTxnHash(config.addressOf(metaTxnId.config, metaTxnId.context), metaTxnId.chainId, ...metaTxnId.transactions), timeout);
-    } // Transactions can only get executed on nonce change
-    // get all nonce changes and look for metaTxnIds in between logs
+      utils.logger.info('computing id', metaTxnId.config, metaTxnId.context, metaTxnId.chainId, ...metaTxnId.transactions);
+      metaTxnId = transactions.computeMetaTxnHash(config.addressOf(metaTxnId.config, metaTxnId.context), metaTxnId.chainId, ...metaTxnId.transactions);
+    }
 
+    let timedOut = false;
 
-    const timeoutTime = new Date().getTime() + timeout;
-    let lastBlock = this.fromBlockLog;
+    const retry = async function retry(f, errorMessage) {
+      let fails = 0;
 
-    if (lastBlock < 0) {
-      const block = await this.provider.getBlockNumber();
-      lastBlock = block + lastBlock;
-    }
+      while (!timedOut) {
+        try {
+          return await f();
+        } catch (error) {
+          fails++;
 
-    const normalMetaTxnId = metaTxnId.replace('0x', '');
+          if (maxFails !== undefined && fails >= maxFails) {
+            utils.logger.error(`giving up after ${fails} failed attempts${errorMessage ? `: ${errorMessage}` : ''}`, error);
+            throw error;
+          } else {
+            utils.logger.warn(`attempt #${fails} failed${errorMessage ? `: ${errorMessage}` : ''}`, error);
+          }
+        }
 
-    while (new Date().getTime() < timeoutTime) {
-      const block = await this.provider.getBlockNumber();
-      const logs = await this.provider.getLogs({
-        fromBlock: Math.max(0, lastBlock - this.deltaBlocksLog),
-        toBlock: block,
-        // Nonce change event topic
-        topics: ['0x1f180c27086c7a39ea2a7b25239d1ab92348f07ca7bb59d1438fcf527568f881']
-      });
-      lastBlock = block; // Get receipts of all transactions
+        if (delay > 0) {
+          await new Promise(resolve => setTimeout(resolve, delay));
+        }
+      }
 
-      const txs = await Promise.all(logs.map(l => this.provider.getTransactionReceipt(l.transactionHash))); // Find a transaction with a TxExecuted log
+      throw new Error(`timed out after ${fails} failed attempts${errorMessage ? `: ${errorMessage}` : ''}`);
+    };
 
-      const found = txs.find(tx => tx.logs.find(l => l.topics.length === 0 && l.data.replace('0x', '') === normalMetaTxnId || l.topics.length === 1 && // TxFailed event topic
-      l.topics[0] === "0x3dbd1590ea96dd3253a91f24e64e3a502e1225d602a5731357bc12643070ccd7" && l.data.length >= 64 && l.data.replace('0x', '').startsWith(normalMetaTxnId))); // If found return that
+    const waitReceipt = async function waitReceipt() {
+      // Transactions can only get executed on nonce change
+      // get all nonce changes and look for metaTxnIds in between logs
+      let lastBlock = _this2.fromBlockLog;
 
-      if (found) {
-        return _extends({
-          receipt: found
-        }, await this.provider.getTransaction(found.transactionHash));
-      } // Otherwise wait and try again
+      if (lastBlock < 0) {
+        const block = await retry(() => _this2.provider.getBlockNumber(), 'unable to get latest block number');
+        lastBlock = block + lastBlock;
+      }
+
+      if (typeof metaTxnId !== 'string') {
+        throw new Error('impossible');
+      }
 
+      const normalMetaTxnId = metaTxnId.replace('0x', '');
 
-      await new Promise(r => setTimeout(r, this.waitPollRate));
-    }
+      while (!timedOut) {
+        const block = await retry(() => _this2.provider.getBlockNumber(), 'unable to get latest block number');
+        const logs = await retry(() => _this2.provider.getLogs({
+          fromBlock: Math.max(0, lastBlock - _this2.deltaBlocksLog),
+          toBlock: block,
+          // Nonce change event topic
+          topics: ['0x1f180c27086c7a39ea2a7b25239d1ab92348f07ca7bb59d1438fcf527568f881']
+        }), `unable to get NonceChange logs for blocks ${Math.max(0, lastBlock - _this2.deltaBlocksLog)} to ${block}`);
+        lastBlock = block; // Get receipts of all transactions
+
+        const txs = await Promise.all(logs.map(l => retry(() => _this2.provider.getTransactionReceipt(l.transactionHash), `unable to get receipt for transaction ${l.transactionHash}`))); // Find a transaction with a TxExecuted log
+
+        const found = txs.find(tx => tx.logs.find(l => l.topics.length === 0 && l.data.replace('0x', '') === normalMetaTxnId || l.topics.length === 1 && // TxFailed event topic
+        l.topics[0] === '0x3dbd1590ea96dd3253a91f24e64e3a502e1225d602a5731357bc12643070ccd7' && l.data.length >= 64 && l.data.replace('0x', '').startsWith(normalMetaTxnId))); // If found return that
+
+        if (found) {
+          return _extends({
+            receipt: found
+          }, await retry(() => _this2.provider.getTransaction(found.transactionHash), `unable to get transaction ${found.transactionHash}`));
+        } // Otherwise wait and try again
 
-    throw new Error(`Timeout waiting for transaction receipt ${metaTxnId}`);
+
+        if (!timedOut) {
+          await new Promise(r => setTimeout(r, delay));
+        }
+      }
+
+      throw new Error(`Timeout waiting for transaction receipt ${metaTxnId}`);
+    };
+
+    if (timeout !== undefined) {
+      return Promise.race([waitReceipt(), new Promise((_, reject) => setTimeout(() => {
+        timedOut = true;
+        reject(`Timeout waiting for transaction receipt ${metaTxnId}`);
+      }, timeout))]);
+    } else {
+      return waitReceipt();
+    }
   }
 
 }
@@ -329,7 +374,7 @@ class LocalRelayer extends ProviderRelayer {
     this.txnOptions = transactionRequest;
   }
 
-  async relay(signedTxs, quote) {
+  async relay(signedTxs, quote, waitForReceipt = true) {
     if (quote !== undefined) {
       utils.logger.warn(`LocalRelayer doesn't accept fee quotes`);
     }
@@ -348,10 +393,18 @@ class LocalRelayer extends ProviderRelayer {
     // const gasLimit = signedTxs.transactions.reduce((sum, tx) => sum.add(tx.gasLimit), ethers.BigNumber.from(0))
     // txRequest.gasLimit = gasLimit
 
-    return this.signer.sendTransaction(_extends({
+    const responsePromise = this.signer.sendTransaction(_extends({
       to,
       data
     }, this.txnOptions));
+
+    if (waitForReceipt) {
+      const response = await responsePromise;
+      response.receipt = await response.wait();
+      return response;
+    } else {
+      return responsePromise;
+    }
   }
 
 }
@@ -626,7 +679,8 @@ var relayer_gen = /*#__PURE__*/Object.freeze({
   Relayer: Relayer
 });
 
-const FAILED_STATUSES = [ETHTxnStatus.FAILED, ETHTxnStatus.PARTIALLY_FAILED, ETHTxnStatus.DROPPED];
+const FINAL_STATUSES = [ETHTxnStatus.DROPPED, ETHTxnStatus.SUCCEEDED, ETHTxnStatus.PARTIALLY_FAILED, ETHTxnStatus.FAILED];
+const FAILED_STATUSES = [ETHTxnStatus.DROPPED, ETHTxnStatus.PARTIALLY_FAILED, ETHTxnStatus.FAILED];
 function isRpcRelayerOptions(obj) {
   return obj.url !== undefined && typeof obj.url === 'string';
 }
@@ -637,26 +691,50 @@ class RpcRelayer extends BaseRelayer {
     this.service = new Relayer(options.url, fetchPonyfill__default["default"]().fetch);
   }
 
-  async waitReceipt(metaTxnHash, wait = 1000) {
-    if (typeof metaTxnHash !== 'string') {
-      utils.logger.info('computing id', metaTxnHash.config, metaTxnHash.context, metaTxnHash.chainId, ...metaTxnHash.transactions);
-      return this.waitReceipt(transactions.computeMetaTxnHash(config.addressOf(metaTxnHash.config, metaTxnHash.context), metaTxnHash.chainId, ...metaTxnHash.transactions));
+  async waitReceipt(metaTxnId, delay = 1000, maxFails = 5, isCancelled) {
+    if (typeof metaTxnId !== 'string') {
+      utils.logger.info('computing id', metaTxnId.config, metaTxnId.context, metaTxnId.chainId, ...metaTxnId.transactions);
+      metaTxnId = transactions.computeMetaTxnHash(config.addressOf(metaTxnId.config, metaTxnId.context), metaTxnId.chainId, ...metaTxnId.transactions);
     }
 
-    utils.logger.info(`[rpc-relayer/waitReceipt] waiting for ${metaTxnHash}`);
-    let result = await this.service.getMetaTxnReceipt({
-      metaTxID: metaTxnHash
-    }); // TODO: remove check for 'UNKNOWN' status when 'QUEUED' status is supported
-    // TODO: fix backend to not return literal 'null' txnReceipt
+    utils.logger.info(`[rpc-relayer/waitReceipt] waiting for ${metaTxnId}`);
+    let fails = 0;
 
-    while (!result.receipt || !result.receipt.txnReceipt || result.receipt.txnReceipt === 'null' || result.receipt.status === 'UNKNOWN' || result.receipt.status === 'QUEUED' || result.receipt.status === 'SENT') {
-      await new Promise(r => setTimeout(r, wait));
-      result = await this.service.getMetaTxnReceipt({
-        metaTxID: metaTxnHash
-      });
+    while (isCancelled === undefined || !isCancelled()) {
+      try {
+        const {
+          receipt
+        } = await this.service.getMetaTxnReceipt({
+          metaTxID: metaTxnId
+        });
+
+        if (!receipt) {
+          throw new Error('missing expected receipt');
+        }
+
+        if (!receipt.txnReceipt) {
+          throw new Error('missing expected transaction receipt');
+        }
+
+        if (FINAL_STATUSES.includes(receipt.status)) {
+          return {
+            receipt
+          };
+        }
+      } catch (e) {
+        fails++;
+
+        if (fails === maxFails) {
+          throw e;
+        }
+      }
+
+      if (isCancelled === undefined || !isCancelled()) {
+        await new Promise(resolve => setTimeout(resolve, delay));
+      }
     }
 
-    return result;
+    throw new Error(`Cancelled waiting for transaction receipt ${metaTxnId}`);
   }
 
   async simulate(wallet, ...transactions$1) {
@@ -781,7 +859,9 @@ class RpcRelayer extends BaseRelayer {
     return nonce;
   }
 
-  async relay(signedTxs, quote) {
+  async relay(signedTxs, quote, waitForReceipt = true) {
+    var _this = this;
+
     utils.logger.info(`[rpc-relayer/relay] relaying signed meta-transactions ${JSON.stringify(signedTxs)} with quote ${JSON.stringify(quote)}`);
     let typecheckedQuote;
 
@@ -814,15 +894,50 @@ class RpcRelayer extends BaseRelayer {
       quote: typecheckedQuote
     });
     utils.logger.info(`[rpc-relayer/relay] got relay result ${JSON.stringify(metaTxn)}`);
-    return this.wait(metaTxn.txnHash);
+
+    if (waitForReceipt) {
+      return this.wait(metaTxn.txnHash);
+    } else {
+      const response = {
+        hash: metaTxn.txnHash,
+        confirmations: 0,
+        from: walletAddress,
+        wait: _confirmations => Promise.reject(new Error('impossible'))
+      };
+
+      const wait = async function wait(confirmations) {
+        var _waitResponse$receipt;
+
+        if (!_this.provider) {
+          throw new Error('cannot wait for receipt, relayer has no provider set');
+        }
+
+        const waitResponse = await _this.wait(metaTxn.txnHash);
+        const transactionHash = (_waitResponse$receipt = waitResponse.receipt) == null ? void 0 : _waitResponse$receipt.transactionHash;
+
+        if (!transactionHash) {
+          throw new Error('cannot wait for receipt, unknown native transaction hash');
+        }
+
+        Object.assign(response, waitResponse);
+        return _this.provider.waitForTransaction(transactionHash, confirmations);
+      };
+
+      response.wait = wait;
+      return response;
+    }
   }
 
-  async wait(metaTxnHash, wait = 1000) {
-    var _this = this;
+  async wait(metaTxnId, timeout, delay = 1000, maxFails = 5) {
+    var _this2 = this;
 
+    let timedOut = false;
     const {
       receipt
-    } = await this.waitReceipt(metaTxnHash, wait);
+    } = await (timeout !== undefined ? Promise.race([this.waitReceipt(metaTxnId, delay, maxFails, () => timedOut), new Promise((_, reject) => setTimeout(() => {
+      timedOut = true;
+      reject(`Timeout waiting for transaction receipt ${metaTxnId}`);
+    }, timeout))]) : this.waitReceipt(metaTxnId, delay, maxFails));
 
     if (!receipt.txnReceipt || FAILED_STATUSES.includes(receipt.status)) {
       throw new MetaTransactionResponseException(receipt);
@@ -833,13 +948,13 @@ class RpcRelayer extends BaseRelayer {
       blockHash: txReceipt.blockHash,
       blockNumber: ethers.ethers.BigNumber.from(txReceipt.blockNumber).toNumber(),
       confirmations: 1,
-      from: typeof metaTxnHash === 'string' ? undefined : config.addressOf(metaTxnHash.config, metaTxnHash.context),
+      from: typeof metaTxnId === 'string' ? undefined : config.addressOf(metaTxnId.config, metaTxnId.context),
       hash: txReceipt.transactionHash,
       raw: receipt.txnReceipt,
       receipt: txReceipt,
       // extended type which is Sequence-specific. Contains the decoded metaTxReceipt
       wait: async function (confirmations) {
-        return _this.provider.waitForTransaction(txReceipt.transactionHash, confirmations);
+        return _this2.provider.waitForTransaction(txReceipt.transactionHash, confirmations);
       }
     };
   }

package/dist/0xsequence-relayer.cjs.prod.js

@@ -237,50 +237,95 @@ class ProviderRelayer extends BaseRelayer {
     return transactions.encodeNonce(space, nonce);
   }
 
-  async wait(metaTxnId, timeout) {
+  async wait(metaTxnId, timeout, delay = this.waitPollRate, maxFails = 5) {
+    var _this2 = this;
+
     if (typeof metaTxnId !== 'string') {
-      utils.logger.info("computing id", metaTxnId.config, metaTxnId.context, metaTxnId.chainId, ...metaTxnId.transactions);
-      return this.wait(transactions.computeMetaTxnHash(config.addressOf(metaTxnId.config, metaTxnId.context), metaTxnId.chainId, ...metaTxnId.transactions), timeout);
-    } // Transactions can only get executed on nonce change
-    // get all nonce changes and look for metaTxnIds in between logs
+      utils.logger.info('computing id', metaTxnId.config, metaTxnId.context, metaTxnId.chainId, ...metaTxnId.transactions);
+      metaTxnId = transactions.computeMetaTxnHash(config.addressOf(metaTxnId.config, metaTxnId.context), metaTxnId.chainId, ...metaTxnId.transactions);
+    }
 
+    let timedOut = false;
 
-    const timeoutTime = new Date().getTime() + timeout;
-    let lastBlock = this.fromBlockLog;
+    const retry = async function retry(f, errorMessage) {
+      let fails = 0;
 
-    if (lastBlock < 0) {
-      const block = await this.provider.getBlockNumber();
-      lastBlock = block + lastBlock;
-    }
+      while (!timedOut) {
+        try {
+          return await f();
+        } catch (error) {
+          fails++;
 
-    const normalMetaTxnId = metaTxnId.replace('0x', '');
+          if (maxFails !== undefined && fails >= maxFails) {
+            utils.logger.error(`giving up after ${fails} failed attempts${errorMessage ? `: ${errorMessage}` : ''}`, error);
+            throw error;
+          } else {
+            utils.logger.warn(`attempt #${fails} failed${errorMessage ? `: ${errorMessage}` : ''}`, error);
+          }
+        }
 
-    while (new Date().getTime() < timeoutTime) {
-      const block = await this.provider.getBlockNumber();
-      const logs = await this.provider.getLogs({
-        fromBlock: Math.max(0, lastBlock - this.deltaBlocksLog),
-        toBlock: block,
-        // Nonce change event topic
-        topics: ['0x1f180c27086c7a39ea2a7b25239d1ab92348f07ca7bb59d1438fcf527568f881']
-      });
-      lastBlock = block; // Get receipts of all transactions
+        if (delay > 0) {
+          await new Promise(resolve => setTimeout(resolve, delay));
+        }
+      }
 
-      const txs = await Promise.all(logs.map(l => this.provider.getTransactionReceipt(l.transactionHash))); // Find a transaction with a TxExecuted log
+      throw new Error(`timed out after ${fails} failed attempts${errorMessage ? `: ${errorMessage}` : ''}`);
+    };
 
-      const found = txs.find(tx => tx.logs.find(l => l.topics.length === 0 && l.data.replace('0x', '') === normalMetaTxnId || l.topics.length === 1 && // TxFailed event topic
-      l.topics[0] === "0x3dbd1590ea96dd3253a91f24e64e3a502e1225d602a5731357bc12643070ccd7" && l.data.length >= 64 && l.data.replace('0x', '').startsWith(normalMetaTxnId))); // If found return that
+    const waitReceipt = async function waitReceipt() {
+      // Transactions can only get executed on nonce change
+      // get all nonce changes and look for metaTxnIds in between logs
+      let lastBlock = _this2.fromBlockLog;
 
-      if (found) {
-        return _extends({
-          receipt: found
-        }, await this.provider.getTransaction(found.transactionHash));
-      } // Otherwise wait and try again
+      if (lastBlock < 0) {
+        const block = await retry(() => _this2.provider.getBlockNumber(), 'unable to get latest block number');
+        lastBlock = block + lastBlock;
+      }
+
+      if (typeof metaTxnId !== 'string') {
+        throw new Error('impossible');
+      }
 
+      const normalMetaTxnId = metaTxnId.replace('0x', '');
 
-      await new Promise(r => setTimeout(r, this.waitPollRate));
-    }
+      while (!timedOut) {
+        const block = await retry(() => _this2.provider.getBlockNumber(), 'unable to get latest block number');
+        const logs = await retry(() => _this2.provider.getLogs({
+          fromBlock: Math.max(0, lastBlock - _this2.deltaBlocksLog),
+          toBlock: block,
+          // Nonce change event topic
+          topics: ['0x1f180c27086c7a39ea2a7b25239d1ab92348f07ca7bb59d1438fcf527568f881']
+        }), `unable to get NonceChange logs for blocks ${Math.max(0, lastBlock - _this2.deltaBlocksLog)} to ${block}`);
+        lastBlock = block; // Get receipts of all transactions
+
+        const txs = await Promise.all(logs.map(l => retry(() => _this2.provider.getTransactionReceipt(l.transactionHash), `unable to get receipt for transaction ${l.transactionHash}`))); // Find a transaction with a TxExecuted log
+
+        const found = txs.find(tx => tx.logs.find(l => l.topics.length === 0 && l.data.replace('0x', '') === normalMetaTxnId || l.topics.length === 1 && // TxFailed event topic
+        l.topics[0] === '0x3dbd1590ea96dd3253a91f24e64e3a502e1225d602a5731357bc12643070ccd7' && l.data.length >= 64 && l.data.replace('0x', '').startsWith(normalMetaTxnId))); // If found return that
+
+        if (found) {
+          return _extends({
+            receipt: found
+          }, await retry(() => _this2.provider.getTransaction(found.transactionHash), `unable to get transaction ${found.transactionHash}`));
+        } // Otherwise wait and try again
 
-    throw new Error(`Timeout waiting for transaction receipt ${metaTxnId}`);
+
+        if (!timedOut) {
+          await new Promise(r => setTimeout(r, delay));
+        }
+      }
+
+      throw new Error(`Timeout waiting for transaction receipt ${metaTxnId}`);
+    };
+
+    if (timeout !== undefined) {
+      return Promise.race([waitReceipt(), new Promise((_, reject) => setTimeout(() => {
+        timedOut = true;
+        reject(`Timeout waiting for transaction receipt ${metaTxnId}`);
+      }, timeout))]);
+    } else {
+      return waitReceipt();
+    }
   }
 
 }
@@ -329,7 +374,7 @@ class LocalRelayer extends ProviderRelayer {
     this.txnOptions = transactionRequest;
   }
 
-  async relay(signedTxs, quote) {
+  async relay(signedTxs, quote, waitForReceipt = true) {
     if (quote !== undefined) {
       utils.logger.warn(`LocalRelayer doesn't accept fee quotes`);
     }
@@ -348,10 +393,18 @@ class LocalRelayer extends ProviderRelayer {
     // const gasLimit = signedTxs.transactions.reduce((sum, tx) => sum.add(tx.gasLimit), ethers.BigNumber.from(0))
     // txRequest.gasLimit = gasLimit
 
-    return this.signer.sendTransaction(_extends({
+    const responsePromise = this.signer.sendTransaction(_extends({
       to,
       data
     }, this.txnOptions));
+
+    if (waitForReceipt) {
+      const response = await responsePromise;
+      response.receipt = await response.wait();
+      return response;
+    } else {
+      return responsePromise;
+    }
   }
 
 }
@@ -626,7 +679,8 @@ var relayer_gen = /*#__PURE__*/Object.freeze({
   Relayer: Relayer
 });
 
-const FAILED_STATUSES = [ETHTxnStatus.FAILED, ETHTxnStatus.PARTIALLY_FAILED, ETHTxnStatus.DROPPED];
+const FINAL_STATUSES = [ETHTxnStatus.DROPPED, ETHTxnStatus.SUCCEEDED, ETHTxnStatus.PARTIALLY_FAILED, ETHTxnStatus.FAILED];
+const FAILED_STATUSES = [ETHTxnStatus.DROPPED, ETHTxnStatus.PARTIALLY_FAILED, ETHTxnStatus.FAILED];
 function isRpcRelayerOptions(obj) {
   return obj.url !== undefined && typeof obj.url === 'string';
 }
@@ -637,26 +691,50 @@ class RpcRelayer extends BaseRelayer {
     this.service = new Relayer(options.url, fetchPonyfill__default["default"]().fetch);
   }
 
-  async waitReceipt(metaTxnHash, wait = 1000) {
-    if (typeof metaTxnHash !== 'string') {
-      utils.logger.info('computing id', metaTxnHash.config, metaTxnHash.context, metaTxnHash.chainId, ...metaTxnHash.transactions);
-      return this.waitReceipt(transactions.computeMetaTxnHash(config.addressOf(metaTxnHash.config, metaTxnHash.context), metaTxnHash.chainId, ...metaTxnHash.transactions));
+  async waitReceipt(metaTxnId, delay = 1000, maxFails = 5, isCancelled) {
+    if (typeof metaTxnId !== 'string') {
+      utils.logger.info('computing id', metaTxnId.config, metaTxnId.context, metaTxnId.chainId, ...metaTxnId.transactions);
+      metaTxnId = transactions.computeMetaTxnHash(config.addressOf(metaTxnId.config, metaTxnId.context), metaTxnId.chainId, ...metaTxnId.transactions);
     }
 
-    utils.logger.info(`[rpc-relayer/waitReceipt] waiting for ${metaTxnHash}`);
-    let result = await this.service.getMetaTxnReceipt({
-      metaTxID: metaTxnHash
-    }); // TODO: remove check for 'UNKNOWN' status when 'QUEUED' status is supported
-    // TODO: fix backend to not return literal 'null' txnReceipt
+    utils.logger.info(`[rpc-relayer/waitReceipt] waiting for ${metaTxnId}`);
+    let fails = 0;
 
-    while (!result.receipt || !result.receipt.txnReceipt || result.receipt.txnReceipt === 'null' || result.receipt.status === 'UNKNOWN' || result.receipt.status === 'QUEUED' || result.receipt.status === 'SENT') {
-      await new Promise(r => setTimeout(r, wait));
-      result = await this.service.getMetaTxnReceipt({
-        metaTxID: metaTxnHash
-      });
+    while (isCancelled === undefined || !isCancelled()) {
+      try {
+        const {
+          receipt
+        } = await this.service.getMetaTxnReceipt({
+          metaTxID: metaTxnId
+        });
+
+        if (!receipt) {
+          throw new Error('missing expected receipt');
+        }
+
+        if (!receipt.txnReceipt) {
+          throw new Error('missing expected transaction receipt');
+        }
+
+        if (FINAL_STATUSES.includes(receipt.status)) {
+          return {
+            receipt
+          };
+        }
+      } catch (e) {
+        fails++;
+
+        if (fails === maxFails) {
+          throw e;
+        }
+      }
+
+      if (isCancelled === undefined || !isCancelled()) {
+        await new Promise(resolve => setTimeout(resolve, delay));
+      }
     }
 
-    return result;
+    throw new Error(`Cancelled waiting for transaction receipt ${metaTxnId}`);
   }
 
   async simulate(wallet, ...transactions$1) {
@@ -781,7 +859,9 @@ class RpcRelayer extends BaseRelayer {
     return nonce;
   }
 
-  async relay(signedTxs, quote) {
+  async relay(signedTxs, quote, waitForReceipt = true) {
+    var _this = this;
+
     utils.logger.info(`[rpc-relayer/relay] relaying signed meta-transactions ${JSON.stringify(signedTxs)} with quote ${JSON.stringify(quote)}`);
     let typecheckedQuote;
 
@@ -814,15 +894,50 @@ class RpcRelayer extends BaseRelayer {
       quote: typecheckedQuote
     });
     utils.logger.info(`[rpc-relayer/relay] got relay result ${JSON.stringify(metaTxn)}`);
-    return this.wait(metaTxn.txnHash);
+
+    if (waitForReceipt) {
+      return this.wait(metaTxn.txnHash);
+    } else {
+      const response = {
+        hash: metaTxn.txnHash,
+        confirmations: 0,
+        from: walletAddress,
+        wait: _confirmations => Promise.reject(new Error('impossible'))
+      };
+
+      const wait = async function wait(confirmations) {
+        var _waitResponse$receipt;
+
+        if (!_this.provider) {
+          throw new Error('cannot wait for receipt, relayer has no provider set');
+        }
+
+        const waitResponse = await _this.wait(metaTxn.txnHash);
+        const transactionHash = (_waitResponse$receipt = waitResponse.receipt) == null ? void 0 : _waitResponse$receipt.transactionHash;
+
+        if (!transactionHash) {
+          throw new Error('cannot wait for receipt, unknown native transaction hash');
+        }
+
+        Object.assign(response, waitResponse);
+        return _this.provider.waitForTransaction(transactionHash, confirmations);
+      };
+
+      response.wait = wait;
+      return response;
+    }
   }
 
-  async wait(metaTxnHash, wait = 1000) {
-    var _this = this;
+  async wait(metaTxnId, timeout, delay = 1000, maxFails = 5) {
+    var _this2 = this;
 
+    let timedOut = false;
     const {
       receipt
-    } = await this.waitReceipt(metaTxnHash, wait);
+    } = await (timeout !== undefined ? Promise.race([this.waitReceipt(metaTxnId, delay, maxFails, () => timedOut), new Promise((_, reject) => setTimeout(() => {
+      timedOut = true;
+      reject(`Timeout waiting for transaction receipt ${metaTxnId}`);
+    }, timeout))]) : this.waitReceipt(metaTxnId, delay, maxFails));
 
     if (!receipt.txnReceipt || FAILED_STATUSES.includes(receipt.status)) {
       throw new MetaTransactionResponseException(receipt);
@@ -833,13 +948,13 @@ class RpcRelayer extends BaseRelayer {
       blockHash: txReceipt.blockHash,
       blockNumber: ethers.ethers.BigNumber.from(txReceipt.blockNumber).toNumber(),
       confirmations: 1,
-      from: typeof metaTxnHash === 'string' ? undefined : config.addressOf(metaTxnHash.config, metaTxnHash.context),
+      from: typeof metaTxnId === 'string' ? undefined : config.addressOf(metaTxnId.config, metaTxnId.context),
       hash: txReceipt.transactionHash,
       raw: receipt.txnReceipt,
       receipt: txReceipt,
       // extended type which is Sequence-specific. Contains the decoded metaTxReceipt
       wait: async function (confirmations) {
-        return _this.provider.waitForTransaction(txReceipt.transactionHash, confirmations);
+        return _this2.provider.waitForTransaction(txReceipt.transactionHash, confirmations);
       }
     };
   }