# @daohaus/keychain-utils

keychain-utils is a comprehensive reference point for managing chain-specific DAO data. It provides an easy way to retrieve a list of constants for any given chain. These constants include contract addresses, API endpoints, TheGraph endpoints, and block explorers. The keychain-utils are structured as objects, with chain IDs serving as the keys to these objects.

### [View on Github](https://github.com/HausDAO/monorepo/tree/develop/libs/keychain-utils)
- [**Contracts**](https://github.com/HausDAO/monorepo/blob/develop/libs/keychain-utils/src/contractKeychains.ts)
- [**Endpoints**](https://github.com/HausDAO/monorepo/blob/develop/libs/keychain-utils/src/endpoints.ts)
- [**Network Data**](https://github.com/HausDAO/monorepo/blob/develop/libs/keychain-utils/src/networkData.ts), [**Valid Networks**](https://github.com/HausDAO/monorepo/blob/develop/libs/keychain-utils/src/validNetworks.ts)
- [**Network Utils**](https://github.com/HausDAO/monorepo/blob/develop/libs/keychain-utils/src/networkUtils.ts), [**Explorer Utils**](https://github.com/HausDAO/monorepo/blob/develop/libs/keychain-utils/src/explorerUtils.ts), [**Viem Utils**](https://github.com/HausDAO/monorepo/blob/develop/libs/keychain-utils/src/viemUtils.ts)
- [**Types**](https://github.com/HausDAO/monorepo/blob/develop/libs/keychain-utils/src/types.ts)

### [Search All Functions](https://hackmd.io/@bootleggers/Skfd50_w3/https%3A%2F%2Fhackmd.io%2FiESwYZRFTHCwBlNYtG-RjA)

### [View on NPM](https://www.npmjs.com/package/@daohaus/keychain-utils)

## Usage

### Installation

yarn add @daohaus/keychain-utils

### Examples

**How to create a link to the block explorer for an address or transaction**

import { generateExplorerLink } from '@daohaus/keychain-utils';


const contractLink = generateExplorerLink({ chainId: '0x1', address: '0x0address', type: 'address' });

const txLink = generateExplorerLink({ chainId: '0x5', address: '0x0TxHash', type: 'tx' });

**How to get contract addresses for each supported network**

import { CONTRACT_KEYCHAINS } from '@daohaus/keychain-utils';



const vaultSummoner = CONTRACT_KEYCHAINS['VAULT_SUMMONER']["0x1"]

**How to get subgraph endpoints for each supported network**

import { ENDPOINTS } from '@daohaus/keychain-utils';


const arbitrumGraph = ENDPOINTS['V3_SUBGRAPH']["0xa"]

const hydratedEndpoints = addApiKeyToGraphEnpoints({'0x1': 'someGraphApiKey'}, ENDPOINTS);
const mainnetGraph = hydratedEndpoints['V3_SUBGRAPH']['0x1'];

**How to get the name of a network from the id**

import {getNetworkName} from '@daohaus/keychain-utils';


const name = getNetworkName('0x64')