> For the complete documentation index, see [llms.txt](https://lunes-labs.gitbook.io/dao-lunes-labs-pt/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://lunes-labs.gitbook.io/dao-lunes-labs-pt/developers/para-desenvolvedores/smart-contract-ink-4.x/frontend-development/useink-chains/getting-started.md).

# Getting Started

`useink/chains` is an extension of **useink** that provides hundreds of chain configurations. Configurations are necessary to set up core **useink** React hooks and display user-facing content. They contain RPC urls, links to block explorers, official websites, and metadata QR codes, and contain native token information, and more.

It is important to note that most of these chains do not implement [pallet-contracts](https://paritytech.github.io/substrate/master/pallet_contracts/pallet/struct.Pallet.html), and therefore do not support ink! contracts, but many of the features in **useink** are compatible with all of these chains. We have added them here for convenience. In addition, many chains are in the process of adding pallet-contracts as they adopt the [hybrid chain design](https://www.rob.tech/blog/hybrid-chains/), so we expect more and more compatibility with the **useink** library in the near future.

### Installation[​](https://use.ink/frontend/chains#installation) <a href="#installation" id="installation"></a>

You must first [install useink](https://use.ink/frontend/getting-started#installation).

### Configure tsconfig.json[​](https://use.ink/frontend/chains#configure-tsconfigjson) <a href="#configure-tsconfigjson" id="configure-tsconfigjson"></a>

Set `moduleResolution` to `nodenext` or `bundler` inside of your `tsconfig.json`. This feature allows your application to discover the `useink/chains` import paths defined in the **useink** `package.json`.

```javascript
{
  "compilerOptions": {
    "moduleResolution": "nodenext", // or `bundler`
  }
}
```

You can now import any of the chain configurations in `useink/chains`.

```javascript
// Example
import { RococoContractsTestnet, ShibuyaTestnet } from 'useink/chains';
```

* [See useink Configuration](https://use.ink/frontend/getting-started#configuration) to learn how these are used in a React app built with **useink**.
* [See Chain Configurations](https://use.ink/frontend/chains/configurations) for a list of all available configurations.

### Chain Type Definition[​](https://use.ink/frontend/chains#chain-type-definition) <a href="#chain-type-definition" id="chain-type-definition"></a>

```javascript
interface Chain {
  id: ChainId; // See https://use.ink/frontend/chains/chain-id for a list of all possible values.
  name: string;
  account: '*25519' | 'secp256k1' | 'Sr25519';
  subscanUrl?: string;
  overrideNativeTokenId?: string;
  chainspecQrUrl?: string;
  latestMetadataQrUrl?: string;
  rpcs: readonly `ws://${string}` | `wss://${string}`[];
  coingeckoId?: string | null;
  paraId?: number;
  relay?: {
    id: string;
  };
  balanceModuleConfigs?: {
    [k: string]: {
      disable?: boolean;
      tokens?: readonly (Token | TokenAsset)[];
    };
  };
}

interface Token {
  symbol: string;
  decimals: number;
  // existentialDeposit is the minimum amount an account must hold to stay alive.
  // Balances held below this amount will be removed from storage
  existentialDeposit: string;
  // onChainId is the ID for a token in the pallet
  onChainId: string | number;
  coingeckoId?: string;
}

interface TokenAsset {
  assetId: string | number;
  symbol: string;
  coingeckoId?: string;
}
```

#### Example: RococoContractsTestnet[​](https://use.ink/frontend/chains#example-rocococontractstestnet) <a href="#example-rocococontractstestnet" id="example-rocococontractstestnet"></a>

```javascript
const RococoContractsTestnet: Chain = {
  id: 'rococo-contracts-testnet',
  name: 'Contracts',
  account: '*25519',
  rpcs: ['wss://rococo-contracts-rpc.polkadot.io'],
  paraId: 1002,
  relay: { id: 'rococo-testnet' },
};
```

#### Example: Astar[​](https://use.ink/frontend/chains#example-astar) <a href="#example-astar" id="example-astar"></a>

```javascript
export const Astar: Chain = {
  id: 'astar',
  name: 'Astar',
  account: '*25519',
  subscanUrl: 'https://astar.subscan.io/',
  chainspecQrUrl: 'https://metadata.novasama.io/qr/astar_specs.png',
  latestMetadataQrUrl:
    'https://metadata.novasama.io/qr/astar_metadata_latest.apng',
  rpcs: [
    'wss://rpc.astar.network',
    'wss://astar.public.blastapi.io',
    'wss://astar-rpc.dwellir.com',
    'wss://astar.api.onfinality.io/public-ws',
    'wss://astar.public.curie.radiumblock.co/ws',
    'wss://public-rpc.pinknode.io/astar',
    'wss://1rpc.io/astr',
  ],
  paraId: 2006,
  relay: { id: 'polkadot' },
  balanceModuleConfigs: {
    'substrate-assets': {
      tokens: [
        { assetId: '4294969280', symbol: 'USDT', coingeckoId: 'tether' },
        {
          assetId: '18446744073709551616',
          symbol: 'ACA',
          coingeckoId: 'acala',
        },
        {
          assetId: '18446744073709551617',
          symbol: 'AUSD',
          coingeckoId: 'acala-dollar',
        },
        {
          assetId: '18446744073709551618',
          symbol: 'LDOT',
          coingeckoId: 'liquid-staking-dot',
        },
        {
          assetId: '18446744073709551619',
          symbol: 'GLMR',
          coingeckoId: 'moonbeam',
        },
        {
          assetId: '18446744073709551620',
          symbol: 'IBTC',
          coingeckoId: 'interbtc',
        },
        {
          assetId: '18446744073709551621',
          symbol: 'INTR',
          coingeckoId: 'interlay',
        },
        { assetId: '18446744073709551622', symbol: 'PHA', coingeckoId: 'pha' },
        {
          assetId: '18446744073709551623',
          symbol: 'BNC',
          coingeckoId: 'bifrost-native-coin',
        },
        { assetId: '18446744073709551624', symbol: 'VDOT' },
        { assetId: '18446744073709551625', symbol: 'CLV' },
        { assetId: '18446744073709551626', symbol: 'VSDOT' },
        {
          assetId: '18446744073709551627',
          symbol: 'RING',
          coingeckoId: 'darwinia-network-native-token',
        },
        {
          assetId: '18446744073709551628',
          symbol: 'EQ',
          coingeckoId: 'equilibrium-token',
        },
        { assetId: '18446744073709551629', symbol: 'EQD' },
        {
          assetId: '340282366920938463463374607431768211455',
          symbol: 'DOT',
          coingeckoId: 'polkadot',
        },
      ],
    },
  },
}
```