Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
20 commits
Select commit Hold shift + click to select a range
50b3185
Rewrite staking pool installation for the operator CLI.
camembera Aug 28, 2026
f49368a
Add a worked example session and full command reference for the opera…
camembera Aug 28, 2026
4386c45
Reflect the wider activate proof-pin cushion and add an --execute cal…
camembera Aug 28, 2026
97f009f
Rewrite installation.mdx for the hands-off, two-mode installer
camembera Aug 29, 2026
c6def41
Simplify installation.mdx: drop reference tables and troubleshooting
camembera Aug 31, 2026
c5f53af
Note that cold-signing mode never asks for a signing preference
camembera Aug 31, 2026
66c7d3d
Document finalize-all as unstake --finalize's no-id default
camembera Aug 31, 2026
ff7da10
Document the scenario-file identity fallback for standalone commands
camembera Aug 31, 2026
90bbaef
Document the four-command zero-flag staking-pool operator CLI.
camembera Sep 1, 2026
c4ae702
Rewrite staking pool installation for Plan A/B/C operator UX.
camembera Sep 1, 2026
2897852
Document remote install.sh staking pool landing flow.
camembera Sep 2, 2026
be14295
Update staking pool docs for install-helpers and env prompt defaults.
camembera Sep 2, 2026
d85a770
Rewrite staking pool installation as a single install.sh how-to.
camembera Sep 2, 2026
8a29fbc
Apply the writing handbook to staking-pools pages and the contracts g…
camembera Sep 2, 2026
684b50b
Keep published BUSD naming when regenerating contract pages.
camembera Sep 2, 2026
da60309
Fold delegators guide into installation and retire the page.
camembera Sep 2, 2026
0344415
Drop handler formation from public installation docs.
camembera Sep 2, 2026
1a8e0b2
Fix README link-rot by dropping unpublished STRUCTURE.md link.
camembera Sep 2, 2026
0c191fd
Clarify install.sh env defaults and operator flow in installation.mdx.
camembera Sep 2, 2026
2833643
Move contract generation fixes to a separate PR.
camembera Sep 2, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ We welcome contributions from the community. Whether you're fixing a typo, clari
- **Build**: developer guides, integrations, and contract reference
- **Nodes**: node architecture, setup, operations, staking pools, and Beacon Kit reference

Content is in MDX. `docs.json` defines navigation and branding. [STRUCTURE.md](STRUCTURE.md) defines content placement.
Content is in MDX. `docs.json` defines navigation and branding. `STRUCTURE.md` defines content placement.

---

Expand Down
12 changes: 8 additions & 4 deletions docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -298,7 +298,6 @@
"pages": [
"nodes/staking-pools/installation",
"nodes/staking-pools/operators",
"nodes/staking-pools/delegators",
"nodes/staking-pools/contracts"
]
}
Expand Down Expand Up @@ -440,7 +439,7 @@
},
{
"source": "/cn/validators/staking-pools/delegators",
"destination": "/validators/staking-pools/delegators"
"destination": "/validators/staking-pools/installation"
},
{
"source": "/cn/validators/staking-pools/contracts",
Expand All @@ -464,7 +463,7 @@
},
{
"source": "/ko/validators/staking-pools/delegators",
"destination": "/validators/staking-pools/delegators"
"destination": "/validators/staking-pools/installation"
},
{
"source": "/ko/validators/staking-pools/contracts",
Expand All @@ -488,12 +487,17 @@
},
{
"source": "/vi/validators/staking-pools/delegators",
"destination": "/validators/staking-pools/delegators"
"destination": "/validators/staking-pools/installation"
},
{
"source": "/vi/validators/staking-pools/contracts",
"destination": "/validators/staking-pools/contracts"
},
{
"source": "/nodes/staking-pools/delegators",
"destination": "/nodes/staking-pools/installation",
"permanent": true
},
{
"source": "/validators/:slug*",
"destination": "/nodes/:slug*",
Expand Down
32 changes: 15 additions & 17 deletions nodes/staking-pools/contracts.mdx
Original file line number Diff line number Diff line change
@@ -1,32 +1,30 @@
---
title: "Staking Pool Contracts"
description: "Addresses and ABIs for StakingPoolContractsFactory, DelegationHandlerFactory, WithdrawalVault, and per-pool proxies (StakingPool, SmartOperator, etc.)."
title: "Look up staking pool contract addresses"
description: "Singleton addresses and ABIs, plus the per-pool proxies StakingPoolContractsFactory deploys."
---

import StakingPoolSingletonsTable from "/snippets/contracts/generated/staking-pools-singletons-table.mdx";

This reference provides contract addresses and links to detailed documentation for each contract in the staking pools system. For an overview of how the contracts work together, see the [Staking Pools Overview](/nodes/staking-pools/overview).
This page lists staking-pool contract addresses and ABI links. The [Staking pools overview](/nodes/staking-pools/overview) explains how the contracts fit together.

## Contract addresses
## Singleton contracts

### Singleton contracts

Singleton contracts are deployed once and shared across all staking pools. The **StakingPoolContractsFactory** is the entry point for deploying a staking pool: you call it to create and register your pool's contracts. The **DelegationHandlerFactory** deploys per-validator delegation handler proxies when using foundation delegation. The other singletons below are shared infrastructure.
These contracts are deployed once and shared by every pool:

<StakingPoolSingletonsTable />

### Deployed contracts (per pool)
Call `StakingPoolContractsFactory` to create and register a pool. Call `DelegationHandlerFactory` to deploy a per-validator handler proxy for Foundation delegation. The other rows are shared infrastructure.

When you deploy a staking pool through the StakingPoolContractsFactory, the factory creates proxy contracts for your validator. These proxy contracts are what you and your stakers interact with directly. Each validator receives unique proxy addresses for these contracts when deploying their staking pool.
## Per-pool proxy contracts

The factory returns these proxy addresses when you call `deployStakingPoolContracts`. Store these addresses for your operations and provide the StakingPool address to your stakers for deposits.
`deployStakingPoolContracts` returns proxy addresses for your validator. You and your stakers call those proxies. Store the addresses. Give stakers the StakingPool address for deposits.

**Proxy contracts deployed with your pool:**
Proxy contracts for each pool:

- **StakingPool**: Main staking functionality and staker interactions. This is the contract address your stakers use to deposit BERA and receive stBERA shares.
- **SmartOperator**: Validator operations and Proof of Liquidity integration.
- **IncentiveCollector**: Incentive token collection and conversion. Handles the incentive auction mechanism where accumulated tokens can be claimed.
- **StakingRewardsVault**: Reward collection and automatic reinvestment. Automatically compounds rewards from the consensus layer.
- **DelegationHandler**: Delegation handling for capital providers. Only deployed if you're using delegated funds from the Berachain Foundation.
- **StakingPool**: deposits, shares, and staker interactions. Stakers deposit BERA here and receive stBERA.
- **SmartOperator**: validator operations and Proof of Liquidity integration.
- **IncentiveCollector**: incentive token collection, conversion, and the incentive auction.
- **StakingRewardsVault**: consensus-layer reward collection and compounding.
- **DelegationHandler**: Foundation-delegated capital. Deployed only on the delegated path.

For detailed technical documentation of each contract's functions and behavior, see the [Berachain guides repository](https://github.com/berachain/guides/tree/main/apps/staking-pools) and the [install-helpers README](https://github.com/berachain/guides/blob/main/apps/staking-pools/install-helpers/README.md).
ABI JSON for each singleton is in the table above. For install and operator flows, see [Install a staking pool](/nodes/staking-pools/installation) and the [Operator guide](/nodes/staking-pools/operators).
99 changes: 0 additions & 99 deletions nodes/staking-pools/delegators.mdx

This file was deleted.

Loading