@safe-global/safe-deployments 1.37.0 → 1.37.1

package/README.md

@@ -3,29 +3,34 @@
 [![npm version](https://badge.fury.io/js/%40safe-global%2Fsafe-deployments.svg)](https://badge.fury.io/js/%40safe-global%2Fsafe-deployments)
 [![CI](https://github.com/safe-global/safe-deployments/actions/workflows/test.yml/badge.svg)](https://github.com/safe-global/safe-deployments/actions/workflows/test.yml)
 
-This contract contains a collection of deployments of the contract of the [Safe contracts repository](https://github.com/safe-global/safe-contracts). 
+This contract contains a collection of deployments of the contract of the [Safe contracts repository](https://github.com/safe-global/safe-smart-account).
 
-For each deployment the address on the different networks and the abi files are available. To get an overview of the available versions check the available [json assets](./src/assets/).
+The addresses on the different networks and the abi files are available for each deployment. To get an overview of the available versions, check the available [json assets](./src/assets/).
 
-To add additional deployments please follow the [deployment steps in the Safe contract repository](https://github.com/safe-global/safe-contracts#deployments).
+## Adding additional deployments:
+
+1. Follow the [deployment steps in the Safe contract repository](https://github.com/safe-global/safe-smart-contracts#deployments).
+2. Verify that the addresses match the expected address for each contract. You can find them under the "addresses" mapping in the respective JSON file in the [assets folder](./src/assets/).
+3. Create a PR adding the new deployment. Example PR can be found [here](https://github.com/safe-global/safe-deployments/pull/676).
 
 ## Install
+
 - npm - `npm i @safe-global/safe-deployments`
 - yarn - `yarn add @safe-global/safe-deployments`
 
 ## Usage
 
-It is possible to directly use the json files in the [assets folder](./src/assets/) that contain the addresses and abi definitions.
+It is possible to directly use the JSON files in the [assets folder](./src/assets/) that contain the addresses and abi definitions.
 
-An alternative is to use the JavaScript library methods to query the correct deployment. The library supports different methods to get the deployment of a specific contract.
+An alternative is using JavaScript library methods to query the correct deployment. The library supports different methods to get the deployment of a specific contract.
 
-Each of the method takes an optional `DeploymentFilter` as a parameter.
+Each of the methods takes an optional `DeploymentFilter` as a parameter.
 
 ```ts
 interface DeploymentFilter {
-    version?: string,
-    released?: boolean, // Defaults to true if no filter is specified
-    network?: string // Chain id of the network
+  version?: string;
+  released?: boolean; // Defaults to true if no filter is specified
+  network?: string; // Chain id of the network
 }
 ```
 
@@ -33,57 +38,80 @@ The method will return a `SingletonDeployment` object or `undefined` if no deplo
 
 ```ts
 interface SingletonDeployment {
-    defaultAddress: string, // Address the contract was deployed to by the Safe team
-    version: string,
-    abi: any[],
-    networkAddresses: Record<string, string>, // Address of the contract by network
-    contractName: string,
-    released: boolean // A released version was audited and has a running bug bounty
+  // The default address of the deployment.
+  defaultAddress: string;
+
+  // Indicates if the deployment is released.
+  released: boolean;
+
+  // The name of the contract.
+  contractName: string;
+
+  // The version of the deployment.
+  version: string;
+
+  // The hash of the contract code.
+  codeHash: string;
+
+  // A record of addresses, where the key is the address type and the value is the address.
+  addresses: Record<string, string>;
+
+  // A record of network addresses, where the key is the network identifier and the value is the address.
+  networkAddresses: Record<string, string>;
+
+  // The ABI (Application Binary Interface) of the contract.
+  abi: any[];
 }
 ```
 
 - Safe
+
 ```ts
-const safeSingleton = getSafeSingletonDeployment()
+const safeSingleton = getSafeSingletonDeployment();
 
 // Returns latest contract version, even if not finally released yet
-const safeSingletonNightly = getSafeSingletonDeployment({ released: undefined })
+const safeSingletonNightly = getSafeSingletonDeployment({ released: undefined });
 
 // Returns released contract version for specific network
-const safeSingletonGörli = getSafeSingletonDeployment({ network: "5" })
+const safeSingletonGörli = getSafeSingletonDeployment({ network: '5' });
 
 // Returns released contract version for specific version
-const safeSingleton100 = getSafeSingletonDeployment({ version: "1.0.0" })
+const safeSingleton100 = getSafeSingletonDeployment({ version: '1.0.0' });
 
 // Version with additional events used on L2 networks
-const safeL2Singleton = getSafeL2SingletonDeployment()
+const safeL2Singleton = getSafeL2SingletonDeployment();
 ```
 
 - Factories
+
 ```ts
-const proxyFactory = getProxyFactoryDeployment()
+const proxyFactory = getProxyFactoryDeployment();
 ```
 
 - Libraries
+
 ```ts
-const multiSendLib = getMultiSendDeployment()
+const multiSendLib = getMultiSendDeployment();
 
-const multiSendCallOnlyLib = getMultiSendCallOnlyDeployment()
+const multiSendCallOnlyLib = getMultiSendCallOnlyDeployment();
 
-const createCallLib = getCreateCallDeployment()
+const createCallLib = getCreateCallDeployment();
 ```
 
 - Handler
+
 ```ts
 // Returns recommended handler
-const fallbackHandler = getFallbackHandlerDeployment()
+const fallbackHandler = getFallbackHandlerDeployment();
 
-const callbackHandler = getDefaultCallbackHandlerDeployment()
+const callbackHandler = getDefaultCallbackHandlerDeployment();
 
-const compatHandler = getCompatibilityFallbackHandlerDeployment()
+const compatHandler = getCompatibilityFallbackHandlerDeployment();
 ```
+
 ## Release cycle
-`safe-deployments` release cycle is once per month, except urgent issues that require immediate attention. 
+
+`safe-deployments` release cycle is once per month, except for urgent issues that require immediate attention.
 
 ## Notes
 

package/dist/accessors.js

@@ -8,9 +8,7 @@ const simulate_tx_accessor_json_1 = __importDefault(require("./assets/v1.3.0/sim
 const simulate_tx_accessor_json_2 = __importDefault(require("./assets/v1.4.1/simulate_tx_accessor.json"));
 const utils_1 = require("./utils");
 // This is a sorted array (newest to oldest)
-const accessorDeployments = [
-    simulate_tx_accessor_json_2.default, simulate_tx_accessor_json_1.default
-];
+const accessorDeployments = [simulate_tx_accessor_json_2.default, simulate_tx_accessor_json_1.default];
 const getSimulateTxAccessorDeployment = (filter) => {
     return (0, utils_1.findDeployment)(filter, accessorDeployments);
 };