feat: make use of Ethers' transaction replacement detection

liquity · Jun 18, 2021 · a56f9b6 · a56f9b6
1 parent 8d7948d
commit a56f9b6
Show file tree

Hide file tree

Showing 38 changed files with 250 additions and 39 deletions.
diff --git a/docs/sdk/lib-ethers.ethersliquity.adjusttrove.md b/docs/sdk/lib-ethers.ethersliquity.adjusttrove.md
@@ -26,7 +26,7 @@ Promise&lt;[TroveAdjustmentDetails](./lib-base.troveadjustmentdetails.md)<!-- --
 
 ## Exceptions
 
-Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
+Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
 
 ## Remarks
 

diff --git a/docs/sdk/lib-ethers.ethersliquity.approveunitokens.md b/docs/sdk/lib-ethers.ethersliquity.approveunitokens.md
@@ -25,7 +25,7 @@ Promise&lt;void&gt;
 
 ## Exceptions
 
-Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
+Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
 
 ## Remarks
 

diff --git a/docs/sdk/lib-ethers.ethersliquity.borrowlusd.md b/docs/sdk/lib-ethers.ethersliquity.borrowlusd.md
@@ -26,7 +26,7 @@ Promise&lt;[TroveAdjustmentDetails](./lib-base.troveadjustmentdetails.md)<!-- --
 
 ## Exceptions
 
-Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
+Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
 
 ## Remarks
 

diff --git a/docs/sdk/lib-ethers.ethersliquity.claimcollateralsurplus.md b/docs/sdk/lib-ethers.ethersliquity.claimcollateralsurplus.md
@@ -24,7 +24,7 @@ Promise&lt;void&gt;
 
 ## Exceptions
 
-Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
+Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
 
 ## Remarks
 

diff --git a/docs/sdk/lib-ethers.ethersliquity.closetrove.md b/docs/sdk/lib-ethers.ethersliquity.closetrove.md
@@ -24,5 +24,5 @@ Promise&lt;[TroveClosureDetails](./lib-base.troveclosuredetails.md)<!-- -->&gt;
 
 ## Exceptions
 
-Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
+Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
 
diff --git a/docs/sdk/lib-ethers.ethersliquity.depositcollateral.md b/docs/sdk/lib-ethers.ethersliquity.depositcollateral.md
@@ -25,7 +25,7 @@ Promise&lt;[TroveAdjustmentDetails](./lib-base.troveadjustmentdetails.md)<!-- --
 
 ## Exceptions
 
-Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
+Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
 
 ## Remarks
 

diff --git a/docs/sdk/lib-ethers.ethersliquity.depositlusdinstabilitypool.md b/docs/sdk/lib-ethers.ethersliquity.depositlusdinstabilitypool.md
@@ -26,7 +26,7 @@ Promise&lt;[StabilityDepositChangeDetails](./lib-base.stabilitydepositchangedeta
 
 ## Exceptions
 
-Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
+Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
 
 ## Remarks
 

diff --git a/docs/sdk/lib-ethers.ethersliquity.exitliquiditymining.md b/docs/sdk/lib-ethers.ethersliquity.exitliquiditymining.md
@@ -24,5 +24,5 @@ Promise&lt;void&gt;
 
 ## Exceptions
 
-Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
+Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
 
diff --git a/docs/sdk/lib-ethers.ethersliquity.liquidate.md b/docs/sdk/lib-ethers.ethersliquity.liquidate.md
@@ -25,5 +25,5 @@ Promise&lt;[LiquidationDetails](./lib-base.liquidationdetails.md)<!-- -->&gt;
 
 ## Exceptions
 
-Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
+Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
 
diff --git a/docs/sdk/lib-ethers.ethersliquity.liquidateupto.md b/docs/sdk/lib-ethers.ethersliquity.liquidateupto.md
@@ -25,5 +25,5 @@ Promise&lt;[LiquidationDetails](./lib-base.liquidationdetails.md)<!-- -->&gt;
 
 ## Exceptions
 
-Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
+Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
 
diff --git a/docs/sdk/lib-ethers.ethersliquity.opentrove.md b/docs/sdk/lib-ethers.ethersliquity.opentrove.md
@@ -26,7 +26,7 @@ Promise&lt;[TroveCreationDetails](./lib-base.trovecreationdetails.md)<!-- -->&gt
 
 ## Exceptions
 
-Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
+Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
 
 ## Remarks
 

diff --git a/docs/sdk/lib-ethers.ethersliquity.redeemlusd.md b/docs/sdk/lib-ethers.ethersliquity.redeemlusd.md
@@ -26,7 +26,7 @@ Promise&lt;[RedemptionDetails](./lib-base.redemptiondetails.md)<!-- -->&gt;
 
 ## Exceptions
 
-Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
+Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
 
 ## Remarks
 

diff --git a/docs/sdk/lib-ethers.ethersliquity.registerfrontend.md b/docs/sdk/lib-ethers.ethersliquity.registerfrontend.md
@@ -25,5 +25,5 @@ Promise&lt;void&gt;
 
 ## Exceptions
 
-Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
+Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
 
diff --git a/docs/sdk/lib-ethers.ethersliquity.repaylusd.md b/docs/sdk/lib-ethers.ethersliquity.repaylusd.md
@@ -25,7 +25,7 @@ Promise&lt;[TroveAdjustmentDetails](./lib-base.troveadjustmentdetails.md)<!-- --
 
 ## Exceptions
 
-Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
+Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
 
 ## Remarks
 

diff --git a/docs/sdk/lib-ethers.ethersliquity.sendlqty.md b/docs/sdk/lib-ethers.ethersliquity.sendlqty.md
@@ -26,5 +26,5 @@ Promise&lt;void&gt;
 
 ## Exceptions
 
-Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
+Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
 
diff --git a/docs/sdk/lib-ethers.ethersliquity.sendlusd.md b/docs/sdk/lib-ethers.ethersliquity.sendlusd.md
@@ -26,5 +26,5 @@ Promise&lt;void&gt;
 
 ## Exceptions
 
-Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
+Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
 
diff --git a/docs/sdk/lib-ethers.ethersliquity.stakelqty.md b/docs/sdk/lib-ethers.ethersliquity.stakelqty.md
@@ -25,7 +25,7 @@ Promise&lt;void&gt;
 
 ## Exceptions
 
-Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
+Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
 
 ## Remarks
 

diff --git a/docs/sdk/lib-ethers.ethersliquity.stakeunitokens.md b/docs/sdk/lib-ethers.ethersliquity.stakeunitokens.md
@@ -25,5 +25,5 @@ Promise&lt;void&gt;
 
 ## Exceptions
 
-Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
+Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
 
diff --git a/docs/sdk/lib-ethers.ethersliquity.transfercollateralgaintotrove.md b/docs/sdk/lib-ethers.ethersliquity.transfercollateralgaintotrove.md
@@ -24,7 +24,7 @@ Promise&lt;[CollateralGainTransferDetails](./lib-base.collateralgaintransferdeta
 
 ## Exceptions
 
-Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
+Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
 
 ## Remarks
 

diff --git a/docs/sdk/lib-ethers.ethersliquity.unstakelqty.md b/docs/sdk/lib-ethers.ethersliquity.unstakelqty.md
@@ -25,7 +25,7 @@ Promise&lt;void&gt;
 
 ## Exceptions
 
-Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
+Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
 
 ## Remarks
 

diff --git a/docs/sdk/lib-ethers.ethersliquity.unstakeunitokens.md b/docs/sdk/lib-ethers.ethersliquity.unstakeunitokens.md
@@ -25,5 +25,5 @@ Promise&lt;void&gt;
 
 ## Exceptions
 
-Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
+Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
 
diff --git a/docs/sdk/lib-ethers.ethersliquity.withdrawcollateral.md b/docs/sdk/lib-ethers.ethersliquity.withdrawcollateral.md
@@ -25,7 +25,7 @@ Promise&lt;[TroveAdjustmentDetails](./lib-base.troveadjustmentdetails.md)<!-- --
 
 ## Exceptions
 
-Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
+Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
 
 ## Remarks
 

diff --git a/docs/sdk/lib-ethers.ethersliquity.withdrawgainsfromstabilitypool.md b/docs/sdk/lib-ethers.ethersliquity.withdrawgainsfromstabilitypool.md
@@ -24,5 +24,5 @@ Promise&lt;[StabilityPoolGainsWithdrawalDetails](./lib-base.stabilitypoolgainswi
 
 ## Exceptions
 
-Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
+Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
 
diff --git a/docs/sdk/lib-ethers.ethersliquity.withdrawgainsfromstaking.md b/docs/sdk/lib-ethers.ethersliquity.withdrawgainsfromstaking.md
@@ -24,5 +24,5 @@ Promise&lt;void&gt;
 
 ## Exceptions
 
-Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
+Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
 
diff --git a/docs/sdk/lib-ethers.ethersliquity.withdrawlqtyrewardfromliquiditymining.md b/docs/sdk/lib-ethers.ethersliquity.withdrawlqtyrewardfromliquiditymining.md
@@ -24,5 +24,5 @@ Promise&lt;void&gt;
 
 ## Exceptions
 
-Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
+Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
 
diff --git a/docs/sdk/lib-ethers.ethersliquity.withdrawlusdfromstabilitypool.md b/docs/sdk/lib-ethers.ethersliquity.withdrawlusdfromstabilitypool.md
@@ -25,7 +25,7 @@ Promise&lt;[StabilityDepositChangeDetails](./lib-base.stabilitydepositchangedeta
 
 ## Exceptions
 
-Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
+Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
 
 ## Remarks
 

diff --git a/docs/sdk/lib-ethers.etherstransactioncancellederror.md b/docs/sdk/lib-ethers.etherstransactioncancellederror.md
@@ -0,0 +1,26 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@liquity/lib-ethers](./lib-ethers.md) &gt; [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md)
+
+## EthersTransactionCancelledError class
+
+Thrown when a transaction is cancelled or replaced by a different transaction.
+
+<b>Signature:</b>
+
+```typescript
+export declare class EthersTransactionCancelledError extends Error 
+```
+<b>Extends:</b> Error
+
+## Remarks
+
+The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `EthersTransactionCancelledError` class.
+
+## Properties
+
+|  Property | Modifiers | Type | Description |
+|  --- | --- | --- | --- |
+|  [rawError](./lib-ethers.etherstransactioncancellederror.rawerror.md) |  | Error |  |
+|  [rawReplacementReceipt](./lib-ethers.etherstransactioncancellederror.rawreplacementreceipt.md) |  | [EthersTransactionReceipt](./lib-ethers.etherstransactionreceipt.md) |  |
+
diff --git a/docs/sdk/lib-ethers.etherstransactioncancellederror.rawerror.md b/docs/sdk/lib-ethers.etherstransactioncancellederror.rawerror.md
@@ -0,0 +1,11 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@liquity/lib-ethers](./lib-ethers.md) &gt; [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) &gt; [rawError](./lib-ethers.etherstransactioncancellederror.rawerror.md)
+
+## EthersTransactionCancelledError.rawError property
+
+<b>Signature:</b>
+
+```typescript
+readonly rawError: Error;
+```
diff --git a/docs/sdk/lib-ethers.etherstransactioncancellederror.rawreplacementreceipt.md b/docs/sdk/lib-ethers.etherstransactioncancellederror.rawreplacementreceipt.md
@@ -0,0 +1,11 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@liquity/lib-ethers](./lib-ethers.md) &gt; [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) &gt; [rawReplacementReceipt](./lib-ethers.etherstransactioncancellederror.rawreplacementreceipt.md)
+
+## EthersTransactionCancelledError.rawReplacementReceipt property
+
+<b>Signature:</b>
+
+```typescript
+readonly rawReplacementReceipt: EthersTransactionReceipt;
+```
diff --git a/docs/sdk/lib-ethers.md b/docs/sdk/lib-ethers.md
@@ -10,6 +10,7 @@
 |  --- | --- |
 |  [BlockPolledLiquityStore](./lib-ethers.blockpolledliquitystore.md) | Ethers-based [LiquityStore](./lib-base.liquitystore.md) that updates state whenever there's a new block. |
 |  [EthersLiquity](./lib-ethers.ethersliquity.md) | Convenience class that combines multiple interfaces of the library in one object. |
+|  [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) | Thrown when a transaction is cancelled or replaced by a different transaction. |
 |  [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) | Thrown by [EthersLiquity](./lib-ethers.ethersliquity.md) in case of transaction failure. |
 |  [PopulatableEthersLiquity](./lib-ethers.populatableethersliquity.md) | Ethers-based implementation of [PopulatableLiquity](./lib-base.populatableliquity.md)<!-- -->. |
 |  [PopulatedEthersLiquityTransaction](./lib-ethers.populatedethersliquitytransaction.md) | A transaction that has been prepared for sending. |

diff --git a/docs/sdk/lib-ethers.sentethersliquitytransaction.waitforreceipt.md b/docs/sdk/lib-ethers.sentethersliquitytransaction.waitforreceipt.md
@@ -17,3 +17,7 @@ Promise&lt;[MinedReceipt](./lib-base.minedreceipt.md)<!-- -->&lt;[EthersTransact
 
 Either a [FailedReceipt](./lib-base.failedreceipt.md) or a [SuccessfulReceipt](./lib-base.successfulreceipt.md)<!-- -->.
 
+## Exceptions
+
+Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
+
diff --git a/packages/examples/package.json b/packages/examples/package.json
@@ -4,7 +4,7 @@
   "private": true,
   "devDependencies": {
     "chalk": "^4.1.0",
-    "ethers": "^5.0.0"
+    "ethers": "^5.3.0"
   },
   "scripts": {
     "liqbot": "node src/liqbot.js"

diff --git a/packages/fuzzer/package.json b/packages/fuzzer/package.json
@@ -9,7 +9,7 @@
     "@types/yargs": "^16.0.0",
     "colors": "^1.4.0",
     "dotenv": "^8.2.0",
-    "ethers": "^5.0.0",
+    "ethers": "^5.3.0",
     "ts-node": "^9.0.0",
     "typescript": "~4.1.0",
     "yargs": "^16.0.3"

diff --git a/packages/lib-ethers/etc/lib-ethers.api.md b/packages/lib-ethers/etc/lib-ethers.api.md
@@ -9,6 +9,7 @@ import { BlockTag } from '@ethersproject/abstract-provider';
 import { CollateralGainTransferDetails } from '@liquity/lib-base';
 import { Decimal } from '@liquity/lib-base';
 import { Decimalish } from '@liquity/lib-base';
+import { ErrorCode } from '@ethersproject/logger';
 import { FailedReceipt } from '@liquity/lib-base';
 import { Fees } from '@liquity/lib-base';
 import { FrontendStatus } from '@liquity/lib-base';
@@ -262,6 +263,16 @@ export type EthersProvider = Provider;
 // @public
 export type EthersSigner = Signer;
 
+// @public
+export class EthersTransactionCancelledError extends Error {
+    // @internal
+    constructor(rawError: _RawTransactionReplacedError);
+    // (undocumented)
+    readonly rawError: Error;
+    // (undocumented)
+    readonly rawReplacementReceipt: EthersTransactionReceipt;
+}
+
 // @public
 export class EthersTransactionFailedError extends TransactionFailedError<FailedReceipt<EthersTransactionReceipt>> {
     constructor(message: string, failedReceipt: FailedReceipt<EthersTransactionReceipt>);
@@ -390,6 +401,34 @@ export class PopulatedEthersRedemption extends PopulatedEthersLiquityTransaction
     readonly redeemableLUSDAmount: Decimal;
 }
 
+// @internal (undocumented)
+export enum _RawErrorReason {
+    // (undocumented)
+    TRANSACTION_CANCELLED = "cancelled",
+    // (undocumented)
+    TRANSACTION_FAILED = "transaction failed",
+    // (undocumented)
+    TRANSACTION_REPLACED = "replaced",
+    // (undocumented)
+    TRANSACTION_REPRICED = "repriced"
+}
+
+// @internal (undocumented)
+export interface _RawTransactionReplacedError extends Error {
+    // (undocumented)
+    cancelled: boolean;
+    // (undocumented)
+    code: ErrorCode.TRANSACTION_REPLACED;
+    // (undocumented)
+    hash: string;
+    // (undocumented)
+    reason: _RawErrorReason.TRANSACTION_CANCELLED | _RawErrorReason.TRANSACTION_REPLACED | _RawErrorReason.TRANSACTION_REPRICED;
+    // (undocumented)
+    receipt: EthersTransactionReceipt;
+    // (undocumented)
+    replacement: EthersTransactionResponse;
+}
+
 // @public
 export class ReadableEthersLiquity implements ReadableLiquity {
     // @internal

diff --git a/packages/lib-ethers/package.json b/packages/lib-ethers/package.json
@@ -35,7 +35,7 @@
   },
   "peerDependencies": {
     "@liquity/lib-base": "^3.0.0",
-    "ethers": "^5.0.0"
+    "ethers": "^5.3.0"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "7.13.2",
Original file line number	Diff line number	Diff line change
Expand Up		@@ -24,5 +24,5 @@ Promise<[TroveClosureDetails](./lib-base.troveclosuredetails.md)<!-- -->>

		## Exceptions

		Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
		Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
Original file line number	Diff line number	Diff line change
Expand Up		@@ -24,5 +24,5 @@ Promise<void>

		## Exceptions

		Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
		Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
Original file line number	Diff line number	Diff line change
Expand Up		@@ -25,5 +25,5 @@ Promise<[LiquidationDetails](./lib-base.liquidationdetails.md)<!-- -->>

		## Exceptions

		Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
		Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
Original file line number	Diff line number	Diff line change
Expand Up		@@ -25,5 +25,5 @@ Promise<void>

		## Exceptions

		Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
		Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
Original file line number	Diff line number	Diff line change
Expand Up		@@ -26,5 +26,5 @@ Promise<void>

		## Exceptions

		Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
		Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
Original file line number	Diff line number	Diff line change
Expand Up		@@ -24,5 +24,5 @@ Promise<[StabilityPoolGainsWithdrawalDetails](./lib-base.stabilitypoolgainswi

		## Exceptions

		Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure.
		Throws [EthersTransactionFailedError](./lib-ethers.etherstransactionfailederror.md) in case of transaction failure. Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.
Original file line number	Diff line number	Diff line change
Expand Up		@@ -17,3 +17,7 @@ Promise<[MinedReceipt](./lib-base.minedreceipt.md)<!-- --><[EthersTransact

		Either a [FailedReceipt](./lib-base.failedreceipt.md) or a [SuccessfulReceipt](./lib-base.successfulreceipt.md)<!-- -->.

		## Exceptions

		Throws [EthersTransactionCancelledError](./lib-ethers.etherstransactioncancellederror.md) if the transaction is cancelled or replaced.