berachain · okjintao · Mar 9, 2026 · Feb 25, 2026 · Feb 25, 2026 · Feb 26, 2026
diff --git a/.githooks/pre-commit b/.githooks/pre-commit
@@ -0,0 +1,5 @@
+#!/usr/bin/env sh
+set -e
+
+echo "pre-commit: checking generated contract docs are up to date..."
+node scripts/contracts/generate-pages.mjs --check
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1,3 @@
+# Generated reconciliation artifacts (intermediate outputs)
+data/contracts-inline-decisions.json
+data/contracts-address-reconciliation.md
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -2,6 +2,8 @@
 
 Thank you for considering contributing. This guide will help you get set up and submit changes.
 
+For environment setup and local tooling commands, use [README.md](README.md). `CONTRIBUTING.md` focuses on contribution workflow and review expectations.
+
 ## Code of Conduct
 
 Berachain has adopted the [Contributor Covenant](https://www.contributor-covenant.org/) as its Code of Conduct. We expect everyone to follow it. Please read [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) before contributing.
@@ -66,43 +68,24 @@ cd docs
 git remote add upstream https://github.com/berachain/docs
 ```
 
-### 2. Prerequisites
-
-- **Node.js** 16 or newer
-- **npm** or **yarn**
+Use the setup and local run instructions in [README.md](README.md).
 
-### 3. Install Mintlify CLI
-
-```bash
-npm i -g mint
-```
-
-### 4. Create a Branch
+### 2. Create a Branch
 
 Work on a branch (do not commit directly to `main`):
 
 ```bash
 git checkout -b fix/your-change   # or feature/your-feature
 ```
 
-### 5. Run the Docs Locally
-
-From the repo root:
-
-```bash
-mint dev
-```
-
-Open [http://localhost:3000](http://localhost:3000). Check that your changes look correct and that existing pages still work.
-
-### 6. Add or Edit Content
+### 3. Add or Edit Content
 
 - **Editing:** Open the relevant `.mdx` file under `general/`, `build/`, or `reference/` and edit.
 - **New page:** Create the `.mdx` file in the right folder, then add it to `docs.json` (see [Adding or moving pages](#adding-or-moving-pages)).
 
 Use existing pages as a style reference. Prefer clear, concise language and short paragraphs. Use MDX components where they add value (see [Content guidelines](#content-guidelines)).
 
-### 7. Adding or Moving Pages
+### 4. Adding or Moving Pages
 
 Navigation is defined in `docs.json` under `navigation.tabs`. Each tab has `groups`; each group has a `group` name and a `pages` array of file paths (without `.mdx`).
 
@@ -120,25 +103,58 @@ To add a new page:
 
 To move or rename a page, update both the file path and every reference in `docs.json` and in other docs (links).
 
-### 8. Content Guidelines
+### 5. Content Guidelines
 
 - Follow the structure and tone of existing docs.
+- Use US English spelling in prose (`color`, `behavior`, `favor`, `labeled`).
 - Use Mintlify/MDX components where appropriate, e.g. `<Card>`, `<Steps>`, `<Note>`, `<Tip>`, `<Warning>`.
 - Use fenced code blocks with a language tag where you show code.
 - Link to related pages when it helps the reader.
-- After editing, run `mint dev` and click through to confirm links and formatting.
+- Validate your changes locally (see [README.md](README.md) for commands).
 
-### 9. Build Check
+### 6. Validation Before PR
 
-Before submitting, run a production build to catch broken links or invalid config:
+Before opening a PR, run:
 
 ```bash
-mint build
+mint validate
+```
+
+Also run:
+
+```bash
+mint broken-links
+mint a11y
 ```
 
 Fix any errors before opening your PR.
 
-### 10. Commit and Push
+### 7. Contract Address Source Of Truth
+
+Contract addresses are managed through a single source of truth:
+
+- `data/contracts.json`
+
+Do not manually edit generated canonical address pages. Instead:
+
+```bash
+node scripts/contracts/generate-pages.mjs
+```
+
+This regenerates:
+
+- snippets in `snippets/contracts/generated/`
+- canonical deployed-contract pages in:
+  - `build/getting-started/deployed-contracts.mdx`
+  - `build/bex/deployed-contracts.mdx`
+  - `build/bend/deployed-contracts.mdx`
+  - `build/bend/deployed-markets.mdx`
+
+Check in generated outputs with your `data/contracts.json` changes in the same PR.
+
+At the moment this generation step is manual (not CI-enforced), so treat regeneration + check-in as required whenever contract data changes.
+
+### 8. Commit and Push
 
 - Commit with a clear message, e.g. `Fix typo in BEX swap guide` or `Add section on pool exits`.
 - Keep the scope of each PR focused (one topic or one section is ideal).
@@ -149,7 +165,7 @@ git commit -m "Your message"
 git push origin fix/your-change
 ```
 
-### 11. Open a Pull Request
+### 9. Open a Pull Request
 
 - Open a PR from your branch to `berachain/docs` **main**.
 - Fill in the PR template (description, checklist).

diff --git a/build/bend/deployed-contracts.mdx b/build/bend/deployed-contracts.mdx
@@ -1,37 +1,14 @@
 ---
 title: "Deployed Contracts"
-description: "Bend smart contract addresses on Berachain mainnet; Morpho, IRM, oracles, URD, and related contracts."
+description: "Bend smart contract addresses on Berachain; Morpho, IRM, oracles, URD, and related contracts."
 ---
 
+import BendContractsTable from "/snippets/contracts/generated/bend-contracts-table.mdx";
+
 Addresses for reading from or writing to Bend contracts. ABIs are in [berachain/doc-abis](https://github.com/berachain/doc-abis).
 
 <Note>
 Deployed contracts have been audited by multiple parties. Reports are on [GitHub](https://github.com/berachain/security-audits).
 </Note>
 
-## Morpho
-
-| Name | Mainnet Address |
-| --- | --- |
-| **Morpho (Vault)** | [0x24147243f9c08d835C218Cda1e135f8dFD0517D0](https://berascan.com/address/0x24147243f9c08d835C218Cda1e135f8dFD0517D0) |
-| **Adaptive Curve IRM** | [0xcf247Df3A2322Dea0D408f011c194906E77a6f62](https://berascan.com/address/0xcf247Df3A2322Dea0D408f011c194906E77a6f62) |
-| **Bundler3** | [0xF920140A65D0f412f2AB3e76C4fEAB5Eef0657ae](https://berascan.com/address/0xF920140A65D0f412f2AB3e76C4fEAB5Eef0657ae) |
-| **General Adapter 1** | [0xd2B9667F5214115E27937C410cAeE83E3a901Df7](https://berascan.com/address/0xd2B9667F5214115E27937C410cAeE83E3a901Df7) |
-| **Meta Morpho V1.1** | N/A |
-| **Meta Morpho Factory V1.1** | [0x5EDd48C6ACBd565Eeb31702FD9fa9Cbc86fbE616](https://berascan.com/address/0x5EDd48C6ACBd565Eeb31702FD9fa9Cbc86fbE616) |
-| **Meta Fee Partitioner** | [0x80108Ee81A92091Db6B8B2326B1875ce9388f461](https://berascan.com/address/0x80108Ee81A92091Db6B8B2326B1875ce9388f461) |
-| **Public Allocator** | [0xB62F34Ab315eaDeAc698e8EaEB6Fc2650951BFe7](https://berascan.com/address/0xB62F34Ab315eaDeAc698e8EaEB6Fc2650951BFe7) |
-| **Morpho Chainlink Oracle V2** | N/A |
-| **Morpho Chainlink Oracle V2 Factory** | [0xAf2FDC54f7bc9d6e8C2D2760E908f4e1beB04d9E](https://berascan.com/address/0xAf2FDC54f7bc9d6e8C2D2760E908f4e1beB04d9E) |
-| **Universal Reward Distributer (URD)** | N/A |
-| **Universal Reward Distributer (URD) Factory** | [0x46fE2bc33b661E01A8946BbC3Bf43F2B8382d802](https://berascan.com/address/0x46fE2bc33b661E01A8946BbC3Bf43F2B8382d802) |
-
-## Vaults
-
-<Note>
-More vaults may be deployed, please check [https://bend.berachain.com/lend](https://bend.berachain.com/lend) for the latest deployed vaults.
-</Note>
-
-| Name | Mainnet Address |
-| --- | --- |
-| **Re7 Honey Vault** | [0x30BbA9CD9Eb8c95824aa42Faa1Bb397b07545bc1](https://berascan.com/address/0x30BbA9CD9Eb8c95824aa42Faa1Bb397b07545bc1) |
+<BendContractsTable />
diff --git a/build/bend/deployed-markets.mdx b/build/bend/deployed-markets.mdx
@@ -1,20 +1,15 @@
 ---
 title: "Deployed Markets"
 description: "Market IDs and parameters for deployed Bend lending markets on Berachain."
 ---
 
+import BendMarketsTable from "/snippets/contracts/generated/bend-markets-table.mdx";
+
 Market IDs deployed on Bend. For the latest whitelisted markets, see [bend.berachain.com/borrow](https://bend.berachain.com/borrow).
 
 ## Market IDs
 
-| Market | ID |
-| --- | --- |
-| **WBTC / HONEY** | `0x950962c1cf2591f15806e938bfde9b5f9fbbfcc5fb640030952c08b536f1f167` |
-| **sUSDe / HONEY** | `0x1ba7904c73d337c39cb88b00180dffb215fc334a6ff47bbe829cd9ee2af00c97` |
-| **wgBERA / HONEY** | `0x63c2a7c20192095c15d1d668ccce6912999b01ea60eeafcac66eca32015674dd` |
-| **WETH / HONEY** | `0x1f05d324f604bd1654ec040311d2ac4f5820ecfd1801a3d19d2c6f09d4f7a614` |
-| **WBERA / HONEY** | `0x147b032db82d765b9d971eac37c8176260dde0fe91f6a542f20cdd9ede1054df` |
-| **iBERA / HONEY** | `0x594de722a090f8d0df41087c23e2187fb69d9cd6b7b425c6dd56ddc1cff545f0` |
+<BendMarketsTable />
 
 To find a market ID, open [bend.berachain.com/borrow](https://bend.berachain.com/borrow) and read the Market ID from the URL.
 

diff --git a/build/bex/deployed-contracts.mdx b/build/bex/deployed-contracts.mdx
@@ -3,6 +3,8 @@
 description: "Registry of deployed BEX contract addresses by network."
 ---
 
+import BexContractsTable from "/snippets/contracts/generated/bex-contracts-table.mdx";
+
 <Warning>
 On January 21st, 2025, Balancer disclosed a long-standing vulnerability in their V2 Vault implementation. BEX incorporates contract logic from Balancer V2 and shares the same vulnerability. Exercise additional caution when creating new pools, particularly when including **untrusted or newly-created tokens**.
 
@@ -13,42 +15,10 @@
 For more information, see the [Balancer disclosure](https://forum.balancer.fi/t/balancer-v2-token-frontrun-vulnerability-disclosure/6309).
 </Warning>

 The following is a list of contract addresses for interacting with Berachain BEX.

 <Tip>
 A full list of contract ABIs can be found at [github.com/berachain/doc-abis](https://github.com/berachain/doc-abis).
 </Tip>
 
-## Mainnet contracts
-
-| Name | Address | ABI |
-| ---- | ------- | --- |
-| Vault | [`0x4Be03f781C497A489E3cB0287833452cA9B9E80B`](https://berascan.com/address/0x4Be03f781C497A489E3cB0287833452cA9B9E80B) | [ABI](https://github.com/berachain/doc-abis/blob/main/bex/IVault.abi.json) |
-| ProtocolFeesCollector | [`0xB8Cf46Cf1b1476E707619913a70B2085d26f1707`](https://berascan.com/address/0xB8Cf46Cf1b1476E707619913a70B2085d26f1707) | [ABI](https://github.com/berachain/doc-abis/blob/main/bex/IProtocolFeesCollector.abi.json) |
-| BalancerHelpers | [`0x5083737EC75a728c265BE578C9d0d5333a2c5951`](https://berascan.com/address/0x5083737EC75a728c265BE578C9d0d5333a2c5951) | [ABI](https://github.com/berachain/doc-abis/blob/main/bex/IBalancerHelpers.abi.json) |
-| PoolCreationHelper | [`0x55dccE8165C88aAd4403a15A9cE3A8E244657dD2`](https://berascan.com/address/0x55dccE8165C88aAd4403a15A9cE3A8E244657dD2) | [ABI](https://github.com/berachain/doc-abis/blob/main/bex/IPoolCreationHelper.abi.json) |
-| ProtocolFeesWithdrawer | [`0x1635F0E1B3e8A6713d03aE155ba79458Ba3240C7`](https://berascan.com/address/0x1635F0E1B3e8A6713d03aE155ba79458Ba3240C7) | [ABI](https://github.com/berachain/doc-abis/blob/main/bex/IProtocolFeesWithdrawer.abi.json) |
-| ComposableStablePoolFactory | [`0xDfA30BDa0375d4763711AB0CC8D91B20bfCC87E1`](https://berascan.com/address/0xDfA30BDa0375d4763711AB0CC8D91B20bfCC87E1) | [ABI](https://github.com/berachain/doc-abis/blob/main/bex/IComposableStablePoolFactory.abi.json) |
-| BatchRelayerLibrary | [`0xCB4AE3030bA06F7EEE54A7B96AfcA7457f9525cf`](https://berascan.com/address/0xCB4AE3030bA06F7EEE54A7B96AfcA7457f9525cf) | |
-| BatchRelayerQueryLibrary | [`0x4151083172b2CEFB83A33fD7FC9F6cBabb3Fd08d`](https://berascan.com/address/0x4151083172b2CEFB83A33fD7FC9F6cBabb3Fd08d) | |
-| BalancerRelayer | [`0x6044f181aB5E9C05A4ed9Ce295f3B178d2492EE7`](https://berascan.com/address/0x6044f181aB5E9C05A4ed9Ce295f3B178d2492EE7) | [ABI](https://github.com/berachain/doc-abis/blob/main/bex/IBalancerRelayer.abi.json) |
-| WeightedPoolFactory | [`0xa966fA8F2d5B087FFFA499C0C1240589371Af409`](https://berascan.com/address/0xa966fA8F2d5B087FFFA499C0C1240589371Af409) | [ABI](https://github.com/berachain/doc-abis/blob/main/bex/IWeightedPoolFactory.abi.json) |
-| ProtocolFeePercentagesProvider | [`0x33C88ffdEe710ed3908C791137Bd1D4421AabBBf`](https://berascan.com/address/0x33C88ffdEe710ed3908C791137Bd1D4421AabBBf) | [ABI](https://github.com/berachain/doc-abis/blob/main/bex/IProtocolFeePercentagesProvider.abi.json) |
-| BalancerQueries | [`0x3C612e132624f4Bd500eE1495F54565F0bcc9b59`](https://berascan.com/address/0x3C612e132624f4Bd500eE1495F54565F0bcc9b59) | [ABI](https://github.com/berachain/doc-abis/blob/main/bex/IBalancerQueries.abi.json) |
-
-## Bepolia testnet contracts
-
-| Name | Address | ABI |
-| ---- | ------- | --- |
-| Vault | [`0x708cA656b68A6b7384a488A36aD33505a77241FE`](https://berascan.com/address/0x708cA656b68A6b7384a488A36aD33505a77241FE) | [ABI](https://github.com/berachain/doc-abis/blob/main/bex/IVault.abi.json) |
-| ProtocolFeesCollector | [`0x05A607aCf3548E84DD1E44c3706F850c849058Da`](https://berascan.com/address/0x05A607aCf3548E84DD1E44c3706F850c849058Da) | [ABI](https://github.com/berachain/doc-abis/blob/main/bex/IProtocolFeesCollector.abi.json) |
-| BalancerHelpers | [`0xC7c981ADcDC5d48fed0CD52807fb2bAB22676C8f`](https://berascan.com/address/0xC7c981ADcDC5d48fed0CD52807fb2bAB22676C8f) | [ABI](https://github.com/berachain/doc-abis/blob/main/bex/IBalancerHelpers.abi.json) |
-| PoolCreationHelper | [`0x0dC9964F6CA33d9EF38DEB4925234766127C6B36`](https://berascan.com/address/0x0dC9964F6CA33d9EF38DEB4925234766127C6B36) | [ABI](https://github.com/berachain/doc-abis/blob/main/bex/IPoolCreationHelper.abi.json) |
-| ProtocolFeesWithdrawer | [`0x8c2D77f0CfcD4Af9cF41494EfE500FE324012c06`](https://berascan.com/address/0x8c2D77f0CfcD4Af9cF41494EfE500FE324012c06) | [ABI](https://github.com/berachain/doc-abis/blob/main/bex/IProtocolFeesWithdrawer.abi.json) |
-| ComposableStablePoolFactory | [`0xB60DbBaCEaeC23486a64d12089F467ef949f1bb1`](https://berascan.com/address/0xB60DbBaCEaeC23486a64d12089F467ef949f1bb1) | [ABI](https://github.com/berachain/doc-abis/blob/main/bex/IComposableStablePoolFactory.abi.json) |
-| BatchRelayerLibrary | [`0xfD772657FC8c4Ed3884AfF151b680883814052FA`](https://berascan.com/address/0xfD772657FC8c4Ed3884AfF151b680883814052FA) | |
-| BatchRelayerQueryLibrary | [`0x263a1C5B2c5851beA2177eb8D6caefdfF2A25601`](https://berascan.com/address/0x263a1C5B2c5851beA2177eb8D6caefdfF2A25601) | |
-| BalancerRelayer | [`0x343215E156Ff586711a5B8C49Fe3099BAF22624C`](https://berascan.com/address/0x343215E156Ff586711a5B8C49Fe3099BAF22624C) | [ABI](https://github.com/berachain/doc-abis/blob/main/bex/IBalancerRelayer.abi.json) |
-| WeightedPoolFactory | [`0xf1d23276C7b271B2aC595C78977b2312E9954D57`](https://berascan.com/address/0xf1d23276C7b271B2aC595C78977b2312E9954D57) | [ABI](https://github.com/berachain/doc-abis/blob/main/bex/IWeightedPoolFactory.abi.json) |
-| ProtocolFeePercentagesProvider | [`0x8119E412E00fe3c857739E95dB147817Bf615dB8`](https://berascan.com/address/0x8119E412E00fe3c857739E95dB147817Bf615dB8) | [ABI](https://github.com/berachain/doc-abis/blob/main/bex/IProtocolFeePercentagesProvider.abi.json) |
-| BalancerQueries | [`0xE3723383a0EA73D5c0dE424BAA97F97f86f6cF92`](https://berascan.com/address/0xE3723383a0EA73D5c0dE424BAA97F97f86f6cF92) | [ABI](https://github.com/berachain/doc-abis/blob/main/bex/IBalancerQueries.abi.json) |
+<BexContractsTable />
diff --git a/build/getting-started/deployed-contracts.mdx b/build/getting-started/deployed-contracts.mdx
@@ -1,59 +1,17 @@
 ---
 title: "Deployed Contract Addresses"
 description: "Berachain core contract addresses by network."
 ---
 
+import CoreContractsTable from "/snippets/contracts/generated/core-contracts-table.mdx";
+
 This is a list of addresses where you can read from or write to these contracts.
 
-> A full list of Contract ABIs can be found at https://github.com/berachain/doc-abis
+> A full list of Contract ABIs can be found at https://github.com/berachain/abis
 
 <Info>
 Various parties have audited the deployed contracts.
 All audit reports are publicly available on [Github](https://github.com/berachain/security-audits).
 </Info>
 
-## Mainnet contracts
-
-### Proof of Liquidity
-
-| Name | Mainnet Address |
-|------|-----------------|
-| BGT Token | `0x656b95E550C07a9ffe548bd4085c72418Ceb1dba` |
-| BeraChef | `0xfb81E39E3970076ab2693fA5C45A07Cc724C93c2` |
-| BlockRewardController | `0x2B6e40f65D82A0cB98795bC7587a71bfa49fBB2B` |
-| Distributor | `0x1b4854DE16279B3d6b37b0a28Abe36A53374A1Cd` |
-| FeeCollector | `0xD435F3e35EEd75C1c21952B8Bc45D0159a2593C9` |
-| RewardVaultFactory | `0x94Ad6Ac84f6C6FbA8b8CCbD71d9f4f101def52a8` |
-| BGTStaker | `0x791fb02A77Ca787EFf6d5e7e83691f76DB55F96F` |
-| Governance | `0x24a4B37F9c40fB0E80ec436Df2e9989FBAFa8bB7` |
-| Timelock | `0x50bfF7b88f97c1cB37d6CfCB518A20b306Aa7355` |
-
-### Tokens
-
-| Name | Mainnet Address |
-|------|-----------------|
-| WBERA | `0x6969696969696969696969696969696969696969` |
-| HONEY | `0xFCBD14DC51f0A4d49d5E53C2E0950e0bC26d0Dce` |
-| HoneyFactory | `0xA81F0019d442f19f66880bcf2698B4E5D5Ec249A` |
-
-### Other
-
-| Name | Mainnet Address |
-|------|-----------------|
-| BeaconDeposit | `0x4242424242424242424242424242424242424242` |
-| Create2 | `0x4e59b44847b379578588920cA78FbF26c0B4956C` |
-| Multicall3 | `0xcA11bde05977b3631167028862bE2a173976CA11` |
-| Permit2 | `0x000000000022D473030F116dDEE9F6B43aC78BA3` |
-
-## NFT contracts
-
-Berachain NFT contract addresses on both Ethereum (via LayerZero adapters) and Berachain.
-
-| Collection | Ethereum Adapter | Berachain Address |
-|------------|------------------|-------------------|
-| Bong Bears | `0x1897C001341F81Ca72154b75b882aE708e06bF48` | `0x141De07E5D4C4759EC9301DA106115D4841f66cD` |
-| Bond Bears | `0x6b1C374105467d1fC1090C989BcbbCC172c8a89c` | `0xA0CF472E6132F6B822a944f6F31aA7b261c7c375` |
-| Boo Bears | `0x7591992F1a98636C6B7207f30382ca4Bec83D9Be` | `0xf49ec5db255854C4a567de5AB3826c9AAbaFc7cF` |
-| Baby Bears | `0xc48C54e92d135B356DD0CbF50F803A8c8d38968b` | `0xDDeAf391c4be2d01ca52aBb8C159a06820ef078C` |
-| Band Bears | `0x392Faa1b0EF108ded69897Ba5382E909C39Fc09e` | `0x7711B2Eb2451259dbF211e30157ceB7CFeb79a19` |
-| Bit Bears | `0x3EB12398753eEd7E8747321c37C85De30d8E2e94` | `0x72D876D9cdf4001b836f8E47254d0551EdA2eebB` |
+<CoreContractsTable />
diff --git a/build/guides/ai-developer.mdx b/build/guides/ai-developer.mdx
@@ -1,13 +1,13 @@
 ---
 title: "AI Developer"
 description: "Use Berachain docs with AI assistants and MCP. Server URL, stack coverage, and how to ask for the right doc."
 ---

 Use Berachain docs inside **AI assistants** and **MCP-compatible clients** (e.g. Cursor, Claude Code) by adding our MCP server. This page gives the server URL, what the docs cover, and how to ask so the AI uses the right content.

 ## MCP server

 Add the Berachain docs MCP server so the AI can read the latest docs instead of relying on training data:

 **URL:** [https://docs.berachain.com/mcp](https://docs.berachain.com/mcp)

@@ -20,21 +20,21 @@
 | Area | What’s covered | Where |
 |------|----------------|-------|
 | **Wallet connections** | Next.js + WalletConnect, ThirdWeb, Particle, RainbowKit, Expo | [Community Developers](/build/guides/community-guides) → Wallet Connections |
 | **Bridging** | ERC20 to Berachain via LayerZero V2 OFT | [Community Developers](/build/guides/community-guides) → Bridging |
 | **Smart contracts** | Deploy (Ethers, Viem, Hardhat, Foundry), verify on Berascan, ERC20, ERC1155, upgradeable (OpenZeppelin) | [Community Developers](/build/guides/community-guides) → Smart Contract Deployment & Verification; [Verifying smart contracts](/build/guides/verifying-smart-contracts) |
 | **Indexing & querying** | Goldsky subgraph, Envio ERC20 indexer (+ The Graph, SubQuery linked) | [Community Developers](/build/guides/community-guides) → Indexing and Querying |
 | **Verifiable randomness** | Gelato VRF, Pyth Entropy (e.g. provably fair NFTs) | [Community Developers](/build/guides/community-guides) → Verifiable Randomness |
 | **Oracles** | Pyth price feeds (on-demand updates) | [Community Developers](/build/guides/community-guides) → Oracles |
 | **Governance** | Reward Vault proposals (BRIP-style) | [Community Developers](/build/guides/community-guides) → Governance |
 | **Storage** | Irys uploads paid with $BERA (Node.js) | [Community Developers](/build/guides/community-guides) → Storage |

 Core references (network, RPC, chain IDs, deployed addresses, ABIs): [Developer tools](/build/getting-started/developer-tools), [Deployed contracts](/build/getting-started/deployed-contracts). Protocol-specific: **Build** tab → BEX, Bend; **Nodes** tab for validators and staking pools.

 ## How to get the right doc

 - **Contract addresses / ABIs / network config** → “Use the Berachain **Deployed contracts** page” or “What’s the RPC and chain ID for Berachain mainnet in the docs?”
 - **Verify a contract** → “Follow the Berachain **Verifying smart contracts** guide” or “How do I verify with Hardhat/Forge on Berascan?”
 - **A specific integration** → Name the stack and, if relevant, the guide: “Using the **Pyth Oracle** guide on Berachain, how do I call `updatePrice`?” or “From the **LayerZero OFT** guide, what’s the exact deploy order?”
-- **Chain and network** → Say “Berachain mainnet” or “Berachain testnet / Artio” so the AI picks the right RPC, faucet, and addresses.
+- **Chain and network** → Say “Berachain mainnet” or “Berachain testnet (Bepolia)” so the AI picks the right RPC, faucet, and addresses.
 
 The **Guides** dropdown (under Community Developers) lists each example; each guide page includes a raw README link so MCP can fetch the full repo README when needed.
diff --git a/build/guides/community-guides.mdx b/build/guides/community-guides.mdx
@@ -1,15 +1,15 @@
 ---
 title: "Community Developers"
 description: "Catalog of ecosystem guides and example projects from the Berachain guides repository."
 ---

 This page lists community developer guides and example projects for Berachain. Each project lives in the [Berachain guides repository](https://github.com/berachain/guides) under `apps/`. Use **GitHub** for the repo and **Guide** for the detailed page: summary, when to use it, requirements, stack, quick start, key files, and a raw README link so MCP or tooling can fetch the full README and help users build (e.g. "use Pyth Entropy" → open the Pyth Entropy guide and follow steps).

 ## Wallet Connections

 | Project | GitHub | Guide |
 | --- | --- | --- |
 | NextJS WalletConnect WAGMI + Viem Frontend Contract Deployment | [Repo](https://github.com/berachain/guides/tree/main/apps/walletconnect-nextjs) | [Guide](/build/guides/community/walletconnect-nextjs) |
 | ThirdWeb ConnectWallet NextJS | [Repo](https://github.com/berachain/guides/tree/main/apps/thirdweb-connectwallet-nextjs) | [Guide](/build/guides/community/thirdweb-connectwallet-nextjs) |
 | Particle Auth Core Vite | [Repo](https://github.com/berachain/guides/tree/main/apps/particle-auth-core-vite) | [Guide](/build/guides/community/particle-auth-core-vite) |
 | RainbowKit Vite | [Repo](https://github.com/berachain/guides/tree/main/apps/rainbowkit-vite) | [Guide](/build/guides/community/rainbowkit-vite) |
@@ -20,15 +20,15 @@

 | Project | GitHub | Guide |
 | --- | --- | --- |
 | Bridging ERC20 Tokens to Berachain with LayerZero V2 | [Repo](https://github.com/berachain/guides/tree/main/apps/layerzero-oft) | [Guide](/build/guides/community/layerzero-oft) |

 ## Smart Contract Deployment & Verification

 | Project | GitHub | Guide |
 | --- | --- | --- |
 | Deploy HelloWorld Contract With Ethers6 & solc | [Repo](https://github.com/berachain/guides/tree/main/apps/ethers6-solc-helloworld) | [Guide](/build/guides/community/ethers6-solc-helloworld) |
 | Deploy HelloWorld Contract With Viem & solc | [Repo](https://github.com/berachain/guides/tree/main/apps/viem-solc-helloworld) | [Guide](/build/guides/community/viem-solc-helloworld) |
 | Create HelloWorld Contract Using Hardhat & Viem | [Repo](https://github.com/berachain/guides/tree/main/apps/hardhat-viem-helloworld) | [Guide](/build/guides/community/hardhat-viem-helloworld) |
 | Hardhat Ethers6 Contract Verification | [Repo](https://github.com/berachain/guides/tree/main/apps/hardhat-contract-verification) | [Guide](/build/guides/community/hardhat-contract-verification) |
 | Hardhat Ethers6 ERC1155 | [Repo](https://github.com/berachain/guides/tree/main/apps/hardhat-ethers6-erc1155) | [Guide](/build/guides/community/hardhat-ethers6-erc1155) |
 | Create ERC20 Contract Using Foundry | [Repo](https://github.com/berachain/guides/tree/main/apps/foundry-erc20) | [Guide](/build/guides/community/foundry-erc20) |
@@ -38,47 +38,45 @@

 | Project | GitHub | Guide |
 | --- | --- | --- |
 | Index & Query Berachain Data with Goldsky | [Repo](https://github.com/berachain/guides/tree/main/apps/goldsky-subgraph) | [Guide](/build/guides/community/goldsky-subgraph) |
 | Index & Query Berachain Data with The Graph | [Guide](https://thegraph.com/docs/en/subgraphs/quick-start/) | — |
 | Envio Indexer ERC20 | [Repo](https://github.com/berachain/guides/tree/main/apps/envio-indexer-erc20) | [Guide](/build/guides/community/envio-indexer-erc20) |
-| Index & Query Berachain Data with SubQuery | [Guide](https://subquery.network/doc/indexer/quickstart/quickstart_chains/berachain-artio-testnet.html#berachain-artio-testnet-quick-start) | — |
-
 ## Verifiable Randomness
 
 | Project | GitHub | Guide |
 | --- | --- | --- |
 | Using Gelato VRF | [Repo](https://github.com/berachain/guides/tree/main/apps/gelato-vrf) | [Guide](/build/guides/community/gelato-vrf) |
 | Provably Fair NFTs with Pyth Entropy | [Repo](https://github.com/berachain/guides/tree/main/apps/pyth-entropy) | [Guide](/build/guides/community/pyth-entropy) |

 ## Oracles

 | Project | GitHub | Guide |
 | --- | --- | --- |
 | Pyth Oracle | [Repo](https://github.com/berachain/guides/tree/main/apps/pyth-oracle) | [Guide](/build/guides/community/pyth-oracle) |

 ## Governance

 | Project | GitHub | Guide |
 | --- | --- | --- |
 | Berachain Governance Proposal For Reward Vaults | [Repo](https://github.com/berachain/guides/tree/main/apps/berachain-governance-proposal) | [Guide](/build/guides/community/berachain-governance-proposal) |

 ## Storage

 | Project | GitHub | Guide |
 | --- | --- | --- |
 | Irys NodeJS Upload Script With $BERA Tokens | [Repo](https://github.com/berachain/guides/tree/main/apps/irys-bera-nodejs) | [Guide](/build/guides/community/irys-bera-nodejs) |

 ## Relayers / Gasless Transactions

 | Project | Source |
 | --- | --- |
 | Using Gelato Relay | [Guide](https://docs.google.com/document/d/1dsSGGYZ4IIE8EAhrMH8SOQFmIygcaibRYHiar2Vj2Kw) |

 ## Automation

 | Project | Source |
 | --- | --- |
 | Using Gelato Web3 Functions | [Guide](https://docs.google.com/document/d/1kUuvYwUH6tyLM4mNJYNu22jS6lPynvSSF_x8NDAZzRg) |

 ## Proof of Liquidity Examples


diff --git a/build/guides/community/ethers6-solc-helloworld.mdx b/build/guides/community/ethers6-solc-helloworld.mdx
@@ -1,9 +1,9 @@
 ---
 title: "HelloWorld with Ethers6 & solc"
 description: "Deploy a HelloWorld-style contract to Berachain using Ethers.js v6 and the solc compiler (no Hardhat/Foundry)."
 ---

 Use this guide when you want to **deploy a simple contract** using **Ethers.js v6** and **solc** only (no Hardhat or Foundry).

 ## Repository

@@ -13,11 +13,11 @@
 ## Requirements
 
 - Node, npm
-- Wallet with testnet $BERA (e.g. [Artio Faucet](https://artio.faucet.berachain.com))
+- Wallet with testnet $BERA (e.g. [Bepolia Faucet](https://bepolia.faucet.berachain.com))
 
 ## Stack
 
 Node.js, Ethers v6, solc, JavaScript/TypeScript.

 ## Quick start

@@ -27,6 +27,6 @@
   npm install
   ```
 2. Set private key and RPC in env (see README).
 3. Compile and deploy using the repo scripts (Ethers v6 + solc); see README for exact commands.

 For full compile/deploy commands, fetch the [raw README](https://raw.githubusercontent.com/berachain/guides/main/apps/ethers6-solc-helloworld/README.md).