feat: add bootstrapPeriod to EthersLiquityConnection

It is the length of time in seconds after deployment during which redemptions are
disabled.

Author: danielattilasimon

docs/sdk/lib-ethers.ethersliquityconnection.bootstrapperiod.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@liquity/lib-ethers](./lib-ethers.md) &gt; [EthersLiquityConnection](./lib-ethers.ethersliquityconnection.md) &gt; [bootstrapPeriod](./lib-ethers.ethersliquityconnection.bootstrapperiod.md)
+
+## EthersLiquityConnection.bootstrapPeriod property
+
+Time period (in seconds) after `deploymentDate` during which redemptions are disabled.
+
+<b>Signature:</b>
+
+```typescript
+readonly bootstrapPeriod: number;
+```

docs/sdk/lib-ethers.ethersliquityconnection.md

@@ -24,6 +24,7 @@ Exposed through [ReadableEthersLiquity.connection](./lib-ethers.readableethersli
 |  Property | Type | Description |
 |  --- | --- | --- |
 |  [addresses](./lib-ethers.ethersliquityconnection.addresses.md) | Record<string, string> | A mapping of Liquity contracts' names to their addresses. |
+|  [bootstrapPeriod](./lib-ethers.ethersliquityconnection.bootstrapperiod.md) | number | Time period (in seconds) after <code>deploymentDate</code> during which redemptions are disabled. |
 |  [chainId](./lib-ethers.ethersliquityconnection.chainid.md) | number | Chain ID of the connected network. |
 |  [deploymentDate](./lib-ethers.ethersliquityconnection.deploymentdate.md) | Date | Date when the Liquity contracts were deployed. |
 |  [provider](./lib-ethers.ethersliquityconnection.provider.md) | [EthersProvider](./lib-ethers.ethersprovider.md) | Ethers <code>Provider</code> used for connecting to the network. |

packages/lib-ethers/deployments/default/goerli.json

@@ -1,7 +1,8 @@
 {
   "chainId": 5,
   "version": "6201cfd8c83fc3828483e17f5f05ca4168f56c0c",
-  "deploymentDate": 1616754713895,
+  "deploymentDate": 1616755061000,
+  "bootstrapPeriod": 1209600,
   "_priceFeedIsTestnet": true,
   "_uniTokenIsMock": false,
   "_isDev": false,
@@ -25,4 +26,4 @@
     "multiTroveGetter": "0x09A7c9E2b0a0A474b4b16819461C3d93a8272397",
     "uniToken": "0x6D9FD2eA57A1E566e3A942f1c7d90257Ce5c8d44"
   }
-}
+}

packages/lib-ethers/deployments/default/kovan.json

@@ -1,7 +1,8 @@
 {
   "chainId": 42,
   "version": "6201cfd8c83fc3828483e17f5f05ca4168f56c0c",
-  "deploymentDate": 1616753475477,
+  "deploymentDate": 1616753759000,
+  "bootstrapPeriod": 1209600,
   "_priceFeedIsTestnet": false,
   "_uniTokenIsMock": false,
   "_isDev": false,

packages/lib-ethers/deployments/default/rinkeby.json

@@ -1,7 +1,8 @@
 {
   "chainId": 4,
   "version": "6201cfd8c83fc3828483e17f5f05ca4168f56c0c",
-  "deploymentDate": 1616758093339,
+  "deploymentDate": 1616758339000,
+  "bootstrapPeriod": 1209600,
   "_priceFeedIsTestnet": true,
   "_uniTokenIsMock": false,
   "_isDev": false,
@@ -25,4 +26,4 @@
     "multiTroveGetter": "0x1B93fb4379cAEFD7ccfd454524550Ac67Af5a1B8",
     "uniToken": "0x4B38E7B07a505A02722f3b7C6F167c058c4fCe6D"
   }
-}
+}

packages/lib-ethers/deployments/default/ropsten.json

@@ -1,7 +1,8 @@
 {
   "chainId": 3,
   "version": "6201cfd8c83fc3828483e17f5f05ca4168f56c0c",
-  "deploymentDate": 1616754661551,
+  "deploymentDate": 1616754932000,
+  "bootstrapPeriod": 1209600,
   "_priceFeedIsTestnet": true,
   "_uniTokenIsMock": false,
   "_isDev": false,
@@ -25,4 +26,4 @@
     "multiTroveGetter": "0xE247cE9E107F90d2230236B0C4c31D3601889460",
     "uniToken": "0xC780A57F071E38d85eF88074109ce77Aa5b36FD9"
   }
-}
+}

packages/lib-ethers/etc/lib-ethers.api.md

@@ -218,6 +218,7 @@ export interface EthersLiquityConnection extends EthersLiquityConnectionOptional
     // @internal (undocumented)
     readonly [brand]: unique symbol;
     readonly addresses: Record<string, string>;
+    readonly bootstrapPeriod: number;
     readonly chainId: number;
     readonly deploymentDate: Date;
     // @internal (undocumented)

packages/lib-ethers/src/EthersLiquityConnection.ts

@@ -62,6 +62,9 @@ export interface EthersLiquityConnection extends EthersLiquityConnectionOptional
   /** Date when the Liquity contracts were deployed. */
   readonly deploymentDate: Date;
 
+  /** Time period (in seconds) after `deploymentDate` during which redemptions are disabled. */
+  readonly bootstrapPeriod: number;
+
   /** A mapping of Liquity contracts' names to their addresses. */
   readonly addresses: Record<string, string>;
 

packages/lib-ethers/src/contracts.ts

@@ -224,6 +224,7 @@ export interface _LiquityDeploymentJSON {
   readonly addresses: _LiquityContractAddresses;
   readonly version: string;
   readonly deploymentDate: number;
+  readonly bootstrapPeriod: number;
   readonly _priceFeedIsTestnet: boolean;
   readonly _uniTokenIsMock: boolean;
   readonly _isDev: boolean;

packages/lib-ethers/utils/deploy.ts

@@ -314,6 +314,7 @@ export const deployAndSetupContracts = async (
     chainId: await deployer.getChainId(),
     version: "unknown",
     deploymentDate: new Date().getTime(),
+    bootstrapPeriod: 0,
     _priceFeedIsTestnet,
     _uniTokenIsMock: !wethAddress,
     _isDev,
@@ -333,10 +334,16 @@ export const deployAndSetupContracts = async (
   };
 
   const contracts = _connectToContracts(deployer, deployment);
+  const lqtyTokenDeploymentTime = await contracts.lqtyToken.getDeploymentStartTime();
+  const bootstrapPeriod = await contracts.troveManager.BOOTSTRAP_PERIOD();
 
   log("Connecting contracts...");
 
   await connectContracts(contracts, deployer, overrides);
 
-  return deployment;
+  return {
+    ...deployment,
+    deploymentDate: lqtyTokenDeploymentTime.toNumber(),
+    bootstrapPeriod: bootstrapPeriod.toNumber()
+  };
 };