@bananapus/address-registry-v6 0.0.1

package/docs/solidity.min.js

@@ -0,0 +1,74 @@
+hljs.registerLanguage("solidity",(()=>{"use strict";function e(){try{return!0
+}catch(e){return!1}}
+var a=/-?(\b0[xX]([a-fA-F0-9]_?)*[a-fA-F0-9]|(\b[1-9](_?\d)*(\.((\d_?)*\d)?)?|\.\d(_?\d)*)([eE][-+]?\d(_?\d)*)?|\b0)(?!\w|\$)/
+;e()&&(a=a.source.replace(/\\b/g,"(?<!\\$)\\b"));var s={className:"number",
+begin:a,relevance:0},n={
+keyword:"assembly let function if switch case default for leave break continue u256 jump jumpi stop return revert selfdestruct invalid",
+built_in:"add sub mul div sdiv mod smod exp not lt gt slt sgt eq iszero and or xor byte shl shr sar addmod mulmod signextend keccak256 pc pop dup1 dup2 dup3 dup4 dup5 dup6 dup7 dup8 dup9 dup10 dup11 dup12 dup13 dup14 dup15 dup16 swap1 swap2 swap3 swap4 swap5 swap6 swap7 swap8 swap9 swap10 swap11 swap12 swap13 swap14 swap15 swap16 mload mstore mstore8 sload sstore msize gas address balance selfbalance caller callvalue calldataload calldatasize calldatacopy codesize codecopy extcodesize extcodecopy returndatasize returndatacopy extcodehash create create2 call callcode delegatecall staticcall log0 log1 log2 log3 log4 chainid origin gasprice basefee blockhash coinbase timestamp number difficulty gaslimit",
+literal:"true false"},i={className:"string",
+begin:/\bhex'(([0-9a-fA-F]{2}_?)*[0-9a-fA-F]{2})?'/},t={className:"string",
+begin:/\bhex"(([0-9a-fA-F]{2}_?)*[0-9a-fA-F]{2})?"/};function r(e){
+return e.inherit(e.APOS_STRING_MODE,{begin:/(\bunicode)?'/})}function l(e){
+return e.inherit(e.QUOTE_STRING_MODE,{begin:/(\bunicode)?"/})}var o={
+SOL_ASSEMBLY_KEYWORDS:n,baseAssembly:e=>{
+var a=r(e),o=l(e),c=/[A-Za-z_$][A-Za-z_$0-9.]*/,d=e.inherit(e.TITLE_MODE,{
+begin:/[A-Za-z$_][0-9A-Za-z$_]*/,lexemes:c,keywords:n}),u={className:"params",
+begin:/\(/,end:/\)/,excludeBegin:!0,excludeEnd:!0,lexemes:c,keywords:n,
+contains:[e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,a,o,s]},_={
+className:"operator",begin:/:=|->/};return{keywords:n,lexemes:c,
+contains:[a,o,i,t,e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,s,_,{
+className:"function",lexemes:c,beginKeywords:"function",end:"{",excludeEnd:!0,
+contains:[d,u,e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,_]}]}},
+solAposStringMode:r,solQuoteStringMode:l,HEX_APOS_STRING_MODE:i,
+HEX_QUOTE_STRING_MODE:t,SOL_NUMBER:s,isNegativeLookbehindAvailable:e}
+;const{baseAssembly:c,solAposStringMode:d,solQuoteStringMode:u,HEX_APOS_STRING_MODE:_,HEX_QUOTE_STRING_MODE:m,SOL_NUMBER:b,isNegativeLookbehindAvailable:E}=o
+;return e=>{for(var a=d(e),s=u(e),n=[],i=0;i<32;i++)n[i]=i+1
+;var t=n.map((e=>8*e)),r=[];for(i=0;i<=80;i++)r[i]=i
+;var l=n.map((e=>"bytes"+e)).join(" ")+" ",o=t.map((e=>"uint"+e)).join(" ")+" ",g=t.map((e=>"int"+e)).join(" ")+" ",M=[].concat.apply([],t.map((e=>r.map((a=>e+"x"+a))))),p={
+keyword:"var bool string int uint "+g+o+"byte bytes "+l+"fixed ufixed "+M.map((e=>"fixed"+e)).join(" ")+" "+M.map((e=>"ufixed"+e)).join(" ")+" enum struct mapping address new delete if else for while continue break return throw emit try catch revert unchecked _ function modifier event constructor fallback receive error virtual override constant immutable anonymous indexed storage memory calldata external public internal payable pure view private returns import from as using pragma contract interface library is abstract type assembly",
+literal:"true false wei gwei szabo finney ether seconds minutes hours days weeks years",
+built_in:"self this super selfdestruct suicide now msg block tx abi blockhash gasleft assert require Error Panic sha3 sha256 keccak256 ripemd160 ecrecover addmod mulmod log0 log1 log2 log3 log4"
+},O={className:"operator",begin:/[+\-!~*\/%<>&^|=]/
+},C=/[A-Za-z_$][A-Za-z_$0-9]*/,N={className:"params",begin:/\(/,end:/\)/,
+excludeBegin:!0,excludeEnd:!0,lexemes:C,keywords:p,
+contains:[e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,a,s,b,"self"]},f={
+begin:/\.\s*/,end:/[^A-Za-z0-9$_\.]/,excludeBegin:!0,excludeEnd:!0,keywords:{
+built_in:"gas value selector address length push pop send transfer call callcode delegatecall staticcall balance code codehash wrap unwrap name creationCode runtimeCode interfaceId min max"
+},relevance:2},y=e.inherit(e.TITLE_MODE,{begin:/[A-Za-z$_][0-9A-Za-z$_]*/,
+lexemes:C,keywords:p}),w={className:"built_in",
+begin:(E()?"(?<!\\$)\\b":"\\b")+"(gas|value|salt)(?=:)"};function x(e,a){return{
+begin:(E()?"(?<!\\$)\\b":"\\b")+e+"\\.\\s*",end:/[^A-Za-z0-9$_\.]/,
+excludeBegin:!1,excludeEnd:!0,lexemes:C,keywords:{built_in:e+" "+a},
+contains:[f],relevance:10}}var h=c(e),v=e.inherit(h,{
+contains:h.contains.concat([{begin:/\./,end:/[^A-Za-z0-9$.]/,excludeBegin:!0,
+excludeEnd:!0,keywords:{built_in:"slot offset length address selector"},
+relevance:2},{begin:/_/,end:/[^A-Za-z0-9$.]/,excludeBegin:!0,excludeEnd:!0,
+keywords:{built_in:"slot offset"},relevance:2}])});return{aliases:["sol"],
+keywords:p,lexemes:C,
+contains:[a,s,_,m,e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,b,w,O,{
+className:"function",lexemes:C,
+beginKeywords:"function modifier event constructor fallback receive error",
+end:/[{;]/,excludeEnd:!0,
+contains:[y,N,w,e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE],illegal:/%/
+},x("msg","gas value data sender sig"),x("block","blockhash coinbase difficulty gaslimit basefee number timestamp chainid"),x("tx","gasprice origin"),x("abi","decode encode encodePacked encodeWithSelector encodeWithSignature encodeCall"),x("bytes","concat"),f,{
+className:"class",lexemes:C,beginKeywords:"contract interface library",end:"{",
+excludeEnd:!0,illegal:/[:"\[\]]/,contains:[{beginKeywords:"is",lexemes:C
+},y,N,w,e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},{lexemes:C,
+beginKeywords:"struct enum",end:"{",excludeEnd:!0,illegal:/[:"\[\]]/,
+contains:[y,e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},{
+beginKeywords:"import",end:";",lexemes:C,keywords:"import from as",
+contains:[y,a,s,_,m,e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,O]},{
+beginKeywords:"using",end:";",lexemes:C,keywords:"using for",
+contains:[y,e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,O]},{className:"meta",
+beginKeywords:"pragma",end:";",lexemes:C,keywords:{
+keyword:"pragma solidity experimental abicoder",
+built_in:"ABIEncoderV2 SMTChecker v1 v2"},
+contains:[e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,e.inherit(a,{
+className:"meta-string"}),e.inherit(s,{className:"meta-string"})]},{
+beginKeywords:"assembly",end:/\b\B/,
+contains:[e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,e.inherit(v,{begin:"{",
+end:"}",endsParent:!0,contains:v.contains.concat([e.inherit(v,{begin:"{",
+end:"}",contains:v.contains.concat(["self"])})])})]}],illegal:/#/}}})());
+
+// Ugly hack to reload HLJS
+hljs.initHighlightingOnLoad();

package/docs/src/README.md

@@ -0,0 +1,164 @@
+# Bananapus Address Registry
+
+Frontend clients need a way to verify that a Juicebox contract has a deployer they trust. `JBAddressRegistry` allows any contract deployed with `create` or `create2` to publicly register its deployer's address. Whoever deploys a contract is responsible for registering it.
+
+<details>
+  <summary>Table of Contents</summary>
+  <ol>
+    <li><a href="#usage">Usage</a></li>
+  <ul>
+    <li><a href="#install">Install</a></li>
+    <li><a href="#develop">Develop</a></li>
+    <li><a href="#scripts">Scripts</a></li>
+    <li><a href="#deployments">Deployments</a></li>
+    <li><a href="#tips">Tips</a></li>
+    </ul>
+    <li><a href="#repository-layout">Repository Layout</a></li>
+    <li><a href="#description">Description</a></li>
+  <ul>
+    <li><a href="#overview">Overview</a></li>
+    <li><a href="#implementation-details">Implementation Details</a></li>
+    <li><a href="#risks">Risks</a></li>
+    </ul>
+  </ul>
+  </ol>
+</details>
+
+## Usage
+
+### Install
+
+How to install `nana-address-registry` in another project.
+
+For projects using `npm` to manage dependencies (recommended):
+
+```bash
+npm install @bananapus/address-registry
+```
+
+For projects using `forge` to manage dependencies (not recommended):
+
+```bash
+forge install Bananapus/nana-address-registry
+```
+
+If you're using `forge` to manage dependencies, add `@bananapus/address-registry/=lib/nana-address-registry/` to `remappings.txt`.
+
+### Develop
+
+`nana-address-registry` uses the [Foundry](https://github.com/foundry-rs/foundry) development toolchain for builds, tests, and deployments. To get set up, install [Foundry](https://github.com/foundry-rs/foundry):
+
+```bash
+curl -L https://foundry.paradigm.xyz | sh
+```
+
+You can download and install dependencies with:
+
+```bash
+forge install
+```
+
+If you run into trouble with `forge install`, try using `git submodule update --init --recursive` to ensure that nested submodules have been properly initialized.
+
+Some useful commands:
+
+| Command               | Description                                         |
+| --------------------- | --------------------------------------------------- |
+| `forge build`         | Compile the contracts and write artifacts to `out`. |
+| `forge fmt`           | Lint.                                               |
+| `forge test`          | Run the tests.                                      |
+| `forge build --sizes` | Get contract sizes.                                 |
+| `forge coverage`      | Generate a test coverage report.                    |
+| `foundryup`           | Update foundry. Run this periodically.              |
+| `forge clean`         | Remove the build artifacts and cache directories.   |
+
+To learn more, visit the [Foundry Book](https://book.getfoundry.sh/) docs.
+
+### Scripts
+
+For convenience, several utility commands are available in `package.json`.
+
+| Command                           | Description                            |
+| --------------------------------- | -------------------------------------- |
+| `npm test`                        | Run local tests.                       |
+| `npm run test:fork`               | Run fork tests (for use in CI).        |
+| `npm run coverage`           | Generate an LCOV test coverage report. |
+
+### Deployments
+
+To deploy, you'll need to set up a `.env` file based on `.example.env`. Then run one of the following commands:
+
+| Command                           | Description                            |
+| --------------------------------- | -------------------------------------- |
+| `npm run deploy:ethereum-mainnet` | Deploy to Ethereum mainnet             |
+| `npm run deploy:ethereum-sepolia` | Deploy to Ethereum Sepolia testnet     |
+| `npm run deploy:optimism-mainnet` | Deploy to Optimism mainnet             |
+| `npm run deploy:optimism-testnet` | Deploy to Optimism testnet             |
+
+### Tips
+
+To view test coverage, run `npm run coverage` to generate an LCOV test report. You can use an extension like [Coverage Gutters](https://marketplace.visualstudio.com/items?itemName=ryanluker.vscode-coverage-gutters) to view coverage in your editor.
+
+If you're using Nomic Foundation's [Solidity](https://marketplace.visualstudio.com/items?itemName=NomicFoundation.hardhat-solidity) extension in VSCode, you may run into LSP errors because the extension cannot find dependencies outside of `lib`. You can often fix this by running:
+
+```bash
+forge remappings >> remappings.txt
+```
+
+This makes the extension aware of default remappings.
+
+## Repository Layout
+
+The root directory contains this README, an MIT license, and config files.
+
+The important source directories are:
+
+```
+nana-address-registry/
+├── script/
+│   └── Deploy.s.sol - The deployment script.
+├── src/ - The contract source code.
+│   ├── JBAddressRegistry.sol - The main address registry contract.
+│   └── interfaces/
+│       └── IJBAddressRegistry.sol - The address registry interface.
+└── test/
+    ├── JBAddressRegistry.t.sol - Unit tests.
+    └── JBAddressRegistry_Fork.t.sol - Fork tests.
+```
+
+Other directories:
+
+```
+nana-address-registry/
+├── .github/
+│   └── workflows/ - CI/CD workflows.
+└── broadcast/ - Deployment logs.
+```
+
+## Description
+
+### Overview
+
+`JBAddressRegistry` is intended for registering the deployers of Juicebox pay/redeem hooks, but does not enforce adherence to an interface, and can be used for any `create`/`create2` deployer. 
+
+The addresses of the deployed contracts are computed deterministically based on the deployer's address, and a nonce (for `create`) or `create2` salt and deployment bytecode (for `create2`). That address is then used as a key to store the deployer's address. This allows clients to easily and trustlessly check a given hook's deployer, which can be used to help figure out whether a hook is "safe" or not, as determined by the client's developers.
+
+_If you're having trouble understanding this contract, take a look at the [core protocol contracts](https://github.com/Bananapus/nana-core) and the [documentation](https://docs.juicebox.money/) first. If you have questions, reach out on [Discord](https://discord.com/invite/ErQYmth4dS)._
+
+
+### Implementation Details
+
+- After deploying a Juicebox pay/redeem hook, any addresses can call `JBAddressRegistry.registerAddress(address deployer, uint256 nonce)` to add it to the registry. The registry will compute and store the corresponding hook address.
+- Alternatively, `JBAddressRegistry.registerAddress(address deployer, bytes32 salt, bytes calldata bytecode)` will compute and store the hook deployed from a contract using `create2`.
+
+The registry doesn't enforce `IERC165` or the implementation of any hook interfaces, meaning it can be used for any contract deployed with `create`/`create2`.
+
+Clients can retrieve the nonce for the contract and an EOA using `provider.getTransactionCount(address)` from `ethers.js` or `web3.eth.getTransactionCount` from `web3.js` just *before* the hook's deployment. If registering a hook later on, clients may need to manually calculate the nonce.
+
+The `create2` salt is determined by a given deployer's logic. The deployment bytecode can be retrieved offchain (from the deployment transaction) or onchain (with `abi.encodePacked(type(deployedContract).creationCode, abi.encode(constructorArguments))`).
+
+### Risks
+
+Hooks have token minting access, making malicious hooks dangerous. Clients should warn project owners and users about any potential for unintended or adversarial behaviour, especially for unknown hooks.
+
+Deployers can be exploited. Clients should still communicate risk to users.

package/docs/src/SUMMARY.md

@@ -0,0 +1,6 @@
+# Summary
+- [Home](README.md)
+# src
+  - [❱ interfaces](src/interfaces/README.md)
+    - [IJBAddressRegistry](src/interfaces/IJBAddressRegistry.sol/interface.IJBAddressRegistry.md)
+  - [JBAddressRegistry](src/JBAddressRegistry.sol/contract.JBAddressRegistry.md)

package/docs/src/src/JBAddressRegistry.sol/contract.JBAddressRegistry.md

@@ -0,0 +1,106 @@
+# JBAddressRegistry
+[Git Source](https://github.com/Bananapus/nana-address-registry/blob/922b48185d8a792b44854cf6d3257339a9d73eaa/src/JBAddressRegistry.sol)
+
+**Inherits:**
+[IJBAddressRegistry](/src/interfaces/IJBAddressRegistry.sol/interface.IJBAddressRegistry.md)
+
+Frontend clients need a way to verify that a Juicebox contract has a deployer they trust. `JBAddressRegistry`
+allows any contract deployed with `create` or `create2` to publicly register its deployer's address. Whoever deploys
+a contract is reponsible for registering it.
+
+*`JBAddressRegistry` is intended for registering the deployers of Juicebox pay/redeem hooks, but does not
+enforce adherence to an interface, and can be used for any `create`/`create2` deployer.*
+
+*The addresses of the deployed contracts are computed deterministically based on the deployer's address, and a
+nonce (for `create`) or `create2` salt and deployment bytecode (for `create2`).*
+
+
+## State Variables
+### deployerOf
+Returns the deployer of a given contract which has been registered.
+
+*Whoever deploys a contract is responsible for registering it.*
+
+
+```solidity
+mapping(address addr => address deployer) public override deployerOf;
+```
+
+
+## Functions
+### registerAddress
+
+Register a deployed contract's address.
+
+*The contract must be deployed using `create`.*
+
+
+```solidity
+function registerAddress(address deployer, uint256 nonce) external override;
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`deployer`|`address`|The address of the contract's deployer.|
+|`nonce`|`uint256`|The nonce used to deploy the contract.|
+
+
+### registerAddress
+
+Register a deployed contract's address.
+
+*The contract must be deployed using `create2`.*
+
+*The `create2` salt is determined by the deployer's logic. The deployment bytecode can be retrieved offchain
+(from the deployment transaction) or onchain (with `abi.encodePacked(type(deployedContract).creationCode,
+abi.encode(constructorArguments))`).*
+
+
+```solidity
+function registerAddress(address deployer, bytes32 salt, bytes calldata bytecode) external override;
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`deployer`|`address`|The address of the contract's deployer.|
+|`salt`|`bytes32`|The `create2` salt used to deploy the contract.|
+|`bytecode`|`bytes`|The contract's deployment bytecode, including the constructor arguments.|
+
+
+### _addressFrom
+
+Compute the address of a contract deployed using `create` based on the deployer's address and nonce.
+
+*Taken from https://ethereum.stackexchange.com/a/87840/68134 - this won't work for nonces > 2**32. If
+you reach that nonce please: 1) ping us, because wow 2) use another deployer.*
+
+
+```solidity
+function _addressFrom(address origin, uint256 nonce) internal pure returns (address addr);
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`origin`|`address`|The deployer's address.|
+|`nonce`|`uint256`|The nonce used to deploy the contract.|
+
+
+### _registerAddress
+
+Register a contract's deployer in the `deployerOf` mapping.
+
+
+```solidity
+function _registerAddress(address addr, address deployer) internal;
+```
+**Parameters**
+
+|Name|Type|Description|
+|----|----|-----------|
+|`addr`|`address`|The deployed contract's address.|
+|`deployer`|`address`|The deployer's address.|
+
+

package/docs/src/src/README.md

@@ -0,0 +1,5 @@
+
+
+# Contents
+- [interfaces](/src/interfaces)
+- [JBAddressRegistry](JBAddressRegistry.sol/contract.JBAddressRegistry.md)

package/docs/src/src/interfaces/IJBAddressRegistry.sol/interface.IJBAddressRegistry.md

@@ -0,0 +1,33 @@
+# IJBAddressRegistry
+[Git Source](https://github.com/Bananapus/nana-address-registry/blob/922b48185d8a792b44854cf6d3257339a9d73eaa/src/interfaces/IJBAddressRegistry.sol)
+
+
+## Functions
+### deployerOf
+
+
+```solidity
+function deployerOf(address addr) external view returns (address deployer);
+```
+
+### registerAddress
+
+
+```solidity
+function registerAddress(address deployer, uint256 nonce) external;
+```
+
+### registerAddress
+
+
+```solidity
+function registerAddress(address deployer, bytes32 salt, bytes calldata bytecode) external;
+```
+
+## Events
+### AddressRegistered
+
+```solidity
+event AddressRegistered(address indexed addr, address indexed deployer, address caller);
+```
+

package/docs/src/src/interfaces/README.md

@@ -0,0 +1,4 @@
+
+
+# Contents
+- [IJBAddressRegistry](IJBAddressRegistry.sol/interface.IJBAddressRegistry.md)

package/foundry.toml

@@ -0,0 +1,29 @@
+[profile.default]
+solc = '0.8.23'
+evm_version = 'paris'                   # Required for L2s (Optimism, Arbitrum, etc.)
+sizes = true
+verbosity = 3                           # display errors
+optimizer_runs = 10000000
+block_number = 14126430
+block_timestamp = 1643802347
+runs = 4096
+extra_output = ['storageLayout']
+fs_permissions = [{ access = "read-write", path = "./"}]
+
+[rpc_endpoints]
+ethereum ="${RPC_ETHEREUM_MAINNET}"
+optimism = "${RPC_OPTIMISM_MAINNET}"
+polygon = "${RPC_POLYGON_MUMBAI}"
+arbitrum = "${RPC_ARBITRUM_MAINNET}"
+base = "${RPC_BASE_MAINNET}"
+arbitrum_sepolia = "${RPC_ARBITRUM_SEPOLIA}"
+ethereum_sepolia ="${RPC_ETHEREUM_SEPOLIA}"
+optimism_sepolia = "${RPC_OPTIMISM_SEPOLIA}"
+polygon_mumbai = "${RPC_POLYGON_MUMBAI}"
+base_sepolia = "${RPC_BASE_SEPOLIA}"
+
+
+[fmt]
+number_underscore = "thousands"
+multiline_func_header = "all"
+wrap_comments = true

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@bananapus/address-registry-v6",
+  "version": "0.0.1",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Bananapus/nana-address-registry-v6"
+  },
+  "scripts": {
+    "test": "forge test",
+    "test:fork": "FOUNDRY_PROFILE=CI forge test",
+    "coverage": "forge coverage --match-path \"./src/*.sol\" --report lcov --report summary",
+    "deploy:mainnets": "source ./.env && npx sphinx propose ./script/Deploy.s.sol --networks mainnets",
+    "deploy:testnets": "source ./.env && npx sphinx propose ./script/Deploy.s.sol --networks testnets",
+    "artifacts": "source ./.env && npx sphinx artifacts --org-id 'ea165b21-7cdc-4d7b-be59-ecdd4c26bee4' --project-name 'nana-address-registry-v5'"
+  },
+  "dependencies": {
+    "@sphinx-labs/plugins": "^0.33.1"
+  }
+}

package/remappings.txt

@@ -0,0 +1 @@
+@sphinx-labs/contracts/=lib/sphinx/packages/contracts/contracts/foundry

package/script/Deploy.s.sol

@@ -0,0 +1,37 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.23;
+
+import "@sphinx-labs/contracts/SphinxPlugin.sol";
+import {Script, stdJson, VmSafe} from "forge-std/Script.sol";
+
+import "src/JBAddressRegistry.sol";
+
+contract Deploy is Script, Sphinx {
+    bytes32 constant ADDRESS_REGISTRY_SALT = "_JBAddressRegistryV6_";
+
+    function configureSphinx() public override {
+        // TODO: Update to contain JB Emergency Developers
+        sphinxConfig.projectName = "nana-address-registry-v6";
+        sphinxConfig.mainnets = ["ethereum", "optimism", "base", "arbitrum"];
+        sphinxConfig.testnets = ["ethereum_sepolia", "optimism_sepolia", "base_sepolia", "arbitrum_sepolia"];
+    }
+
+    function run() public sphinx {
+        // Only deploy if this bytecode is not already deployed.
+        if (!_isDeployed(ADDRESS_REGISTRY_SALT, type(JBAddressRegistry).creationCode, "")) {
+            new JBAddressRegistry{salt: ADDRESS_REGISTRY_SALT}();
+        }
+    }
+
+    function _isDeployed(bytes32 salt, bytes memory creationCode, bytes memory arguments) internal view returns (bool) {
+        address _deployedTo = vm.computeCreate2Address({
+            salt: salt,
+            initCodeHash: keccak256(abi.encodePacked(creationCode, arguments)),
+            // Arachnid/deterministic-deployment-proxy address.
+            deployer: address(0x4e59b44847b379578588920cA78FbF26c0B4956C)
+        });
+
+        // Return if code is already present at this address.
+        return address(_deployedTo).code.length != 0;
+    }
+}

package/script/helpers/AddressRegistryDeploymentLib.sol

@@ -0,0 +1,68 @@
+// SPDX-License-Identifier: MIT
+pragma solidity 0.8.23;
+
+import {stdJson} from "forge-std/Script.sol";
+import {Vm} from "forge-std/Vm.sol";
+
+import {SphinxConstants, NetworkInfo} from "@sphinx-labs/contracts/SphinxConstants.sol";
+import {IJBAddressRegistry} from "../../src/interfaces/IJBAddressRegistry.sol";
+
+struct AddressRegistryDeployment {
+    IJBAddressRegistry registry;
+}
+
+library AddressRegistryDeploymentLib {
+    // Cheat code address, 0x7109709ECfa91a80626fF3989D68f67F5b1DD12D.
+    address internal constant VM_ADDRESS = address(uint160(uint256(keccak256("hevm cheat code"))));
+    Vm internal constant vm = Vm(VM_ADDRESS);
+
+    function getDeployment(string memory path) internal returns (AddressRegistryDeployment memory deployment) {
+        // get chainId for which we need to get the deployment.
+        uint256 chainId = block.chainid;
+
+        // Deploy to get the constants.
+        // TODO: get constants without deploy.
+        SphinxConstants sphinxConstants = new SphinxConstants();
+        NetworkInfo[] memory networks = sphinxConstants.getNetworkInfoArray();
+
+        for (uint256 _i; _i < networks.length; _i++) {
+            if (networks[_i].chainId == chainId) {
+                return getDeployment(path, networks[_i].name);
+            }
+        }
+
+        revert("ChainID is not (currently) supported by Sphinx.");
+    }
+
+    function getDeployment(
+        string memory path,
+        string memory network_name
+    )
+        internal
+        view
+        returns (AddressRegistryDeployment memory deployment)
+    {
+        deployment.registry =
+            IJBAddressRegistry(_getDeploymentAddress(path, "nana-address-registry", network_name, "JBAddressRegistry"));
+    }
+
+    /// @notice Get the address of a contract that was deployed by the Deploy script.
+    /// @dev Reverts if the contract was not found.
+    /// @param path The path to the deployment file.
+    /// @param contractName The name of the contract to get the address of.
+    /// @return The address of the contract.
+    function _getDeploymentAddress(
+        string memory path,
+        string memory project_name,
+        string memory network_name,
+        string memory contractName
+    )
+        internal
+        view
+        returns (address)
+    {
+        string memory deploymentJson =
+            vm.readFile(string.concat(path, project_name, "/", network_name, "/", contractName, ".json"));
+        return stdJson.readAddress(deploymentJson, ".address");
+    }
+}

package/slither-ci.config.json

@@ -0,0 +1,10 @@
+{
+    "detectors_to_exclude": "timestamp,uninitialized-local,naming-convention,solc-version,shadowing-local",
+    "exclude_informational": true,
+    "exclude_low": false,
+    "exclude_medium": false,
+    "exclude_high": false,
+    "disable_color": false,
+    "filter_paths": "(mocks/|test/|node_modules/)",
+    "legacy_ast": false
+}