Welcome to the Cardano Playground Repository
Cardano is a decentralized third-generation proof-of-stake blockchain platform and home to the ada cryptocurrency. It is the first blockchain platform to evolve out of a scientific philosophy and a research-first driven approach.
Things you'll find here:
Documentation
Use the nagivation panel on the left to explore The Cardano Book.
Environments
The official Cardano Environment configuration files.
Environment description and configuration files available are:
Environment: Private Testnet
Usage: Testing Conway era functionality.
The Private chain will be spun up or respun as needed for short term testing.
Epoch length of 2 hours. Development flags allowed in configuration files.
Upgrade Strategy: Deploy all nodes with every upgrade request
Responsible: IOG SRE
Accountable: SRE Director
Consulted: Core Tech Head of Product
Informed: Cardano Core Tribe
Faucet
A faucet for the private testnet is available here
Configuration files
Compatible with cardano-node release 9.1.0
NOTE:
The non-block-producer node config has `PeerSharing` enabled by
default, so should not be used with block-producers.
Additionally, avoid connecting a block-producer not using p2p to a p2p
PeerSharing enabled relay as the block-producer's IP will be leaked.
- Node Config (Non-block-producers -- see note above)
- Node Config (Block-producers)
- DB Sync Config
- Submit API Config
- Node Topology
- Byron Genesis
- Shelley Genesis
- Alonzo Genesis
- Conway Genesis
Environment: Sanchonet Testnet
Usage: Testing Conway era functionality.
The Sanchonet chain will be rolled back with each new node release for testing new features and fixes. When respun on 2024-07-10 the chain will be restored from slot 26006400. Any Sanchonet chain participants, stakepools, integrators, etc, will need to clear their chain state to re-sync from that point forward.
Epoch length of 1 day. Development flags allowed in configuration files.
Upgrade Strategy: Deploy all nodes with every upgrade request
Responsible: IOG SRE
Accountable: SRE Director
Consulted: Core Tech Head of Product
Informed: Cardano Core Tribe
Configuration files
Compatible with cardano-node pre-release 9.1.0
NOTE:
The non-block-producer node config has `PeerSharing` enabled by
default, so should not be used with block-producers.
Additionally, avoid connecting a block-producer not using p2p to a p2p
PeerSharing enabled relay as the block-producer's IP will be leaked.
- Node Config (Non-block-producers -- see note above)
- Node Config (Block-producers)
- DB Sync Config
- Submit API Config
- Node Topology
- Byron Genesis
- Shelley Genesis
- Alonzo Genesis
- Conway Genesis
Environment: Preview Testnet
Usage: Testing release candidates and mainnet releases. Leads mainnet hard forks by at least 4 weeks.
Ideally stays long running. Only if an issue is found after it forks that's breaking should it be respun.
Epoch length of 1 day. Development flags allowed in configuration files.
Upgrade Strategy:
- Release Candidates - 1/3 of nodes
- Official Releases - 2/3 of nodes
- Hard forks - all nodes
- Community requested to only deploy release candidates and official releases
Changes Requested by: Release Squad Lead
Approvals Required: SRE Tribe Lead, Cardano Head of Engineering, Cardano Head of Architecture
Responsible: IOG SRE
Accountable: Head of SRE/Release Squad Lead
Consulted: SPOs
Informed: Cardano Core Tribe, COO, Director of Engineering
Configuration files
Compatible with cardano-node release 9.1.0
NOTE:
The non-block-producer node config has `PeerSharing` enabled by
default, so should not be used with block-producers.
Additionally, avoid connecting a block-producer not using p2p to a p2p
PeerSharing enabled relay as the block-producer's IP will be leaked.
- Node Config (Non-block-producers -- see note above)
- Node Config (Block-producers)
- DB Sync Config
- Submit API Config
- Node Topology
- Byron Genesis
- Shelley Genesis
- Alonzo Genesis
- Conway Genesis
Environment: Pre-Production Testnet
Usage: Testing release candidates and mainnet releases. Forks at approximately same time as mainnet (within an epoch of each other).
Long running. Since this parallels mainnet, if a bug occurs here, it needs fixed properly and can not be respun.
Upgrade Strategy:
- Release Candidates - 1/3 of nodes
- Official Releases - 2/3 of nodes
- Hard forks - all nodes
- Community requested to only deploy release candidates and official releases
Changes Requested by: Release Squad Lead
Approvals Required: SRE Tribe Lead, Cardano Head of Engineering, Cardano Head of Architecture, CF Representative
Responsible: IOG SRE
Accountable: Head of SRE/Release Squad Lead
Consulted: SPOs, IOG Tribes
Informed: Cardano Core Tribe, COO, Director of Engineering, VP Community
Configuration files
Compatible with cardano-node release 9.1.0
NOTE:
The non-block-producer node config has `PeerSharing` enabled by
default, so should not be used with block-producers.
Additionally, avoid connecting a block-producer not using p2p to a p2p
PeerSharing enabled relay as the block-producer's IP will be leaked.
- Node Config (Non-block-producers -- see note above)
- Node Config (Block-producers)
- DB Sync Config
- Submit API Config
- Node Topology
- Byron Genesis
- Shelley Genesis
- Alonzo Genesis
- Conway Genesis
Environment: Production (Mainnet)
Usage: Live Production. Only gets official mainnet releases.
Upgrade Strategy:
- Official Releases - Deploy 1 pool and it's relays every 24 hours
- Community requested to only deploy official releases
Changes Requested by: Release Squad Lead
Approvals Required: SRE Tribe Lead, IOG Executive Team, CF Executive Team
Responsible: IOG SRE Accountable: Head of SRE/Release Squad Lead
Consulted: SPOs, IOG Tribes, IOG Executive Team
Informed: Cardano Core Tribe, COO, IOG Director of Engineering, IOG VP Community
Configuration files
Compatible with cardano-node release 9.1.0
NOTE:
The non-block-producer node config has `PeerSharing` enabled by
default, so should not be used with block-producers.
Additionally, avoid connecting a block-producer not using p2p to a p2p
PeerSharing enabled relay as the block-producer's IP will be leaked.
- Node Config (Non-block-producers -- see note above)
- Node Config (Block-producers)
- DB Sync Config
- Submit API Config
- Node Topology
- Node Topology (Non-bootstrap-peers)
- Node Topology (Legacy non-p2p)
- Byron Genesis
- Shelley Genesis
- Alonzo Genesis
- Conway Genesis
Advanced Configurations
Pre-release configurations for select cardano environments can be found here.
Advanced environment configuration files available are:
Advanced Configuration: Sanchonet Testnet
There is currently no pre-release version available for the sanchonet environment.
The latest version available is cardano-node release 9.1.0.
Configuration files
Compatible with cardano-node release 9.1.0
NOTE:
The non-block-producer node config has `PeerSharing` enabled by
default, so should not be used with block-producers.
Additionally, avoid connecting a block-producer not using p2p to a p2p
PeerSharing enabled relay as the block-producer's IP will be leaked.
- Node Config (Non-block-producers -- see note above)
- Node Config (Block-producers)
- DB Sync Config
- Submit API Config
- Node Topology
- Byron Genesis
- Shelley Genesis
- Alonzo Genesis
- Conway Genesis
Advanced Configuration: Preview Testnet
There is currently no pre-release version available for the preview environment.
The latest version available is cardano-node release 9.1.0.
Configuration files
Compatible with cardano-node release 9.1.0
NOTE:
The non-block-producer node config has `PeerSharing` enabled by
default, so should not be used with block-producers.
Additionally, avoid connecting a block-producer not using p2p to a p2p
PeerSharing enabled relay as the block-producer's IP will be leaked.
- Node Config (Non-block-producers -- see note above)
- Node Config (Block-producers)
- DB Sync Config
- Submit API Config
- Node Topology
- Byron Genesis
- Shelley Genesis
- Alonzo Genesis
- Conway Genesis
Advanced Configuration: Pre-Production Testnet
There is currently no pre-release version available for the pre-production environment.
The latest version available is cardano-node release 9.1.0.
Configuration files
Compatible with cardano-node release 9.1.0
NOTE:
The non-block-producer node config has `PeerSharing` enabled by
default, so should not be used with block-producers.
Additionally, avoid connecting a block-producer not using p2p to a p2p
PeerSharing enabled relay as the block-producer's IP will be leaked.
- Node Config (Non-block-producers -- see note above)
- Node Config (Block-producers)
- DB Sync Config
- Submit API Config
- Node Topology
- Byron Genesis
- Shelley Genesis
- Alonzo Genesis
- Conway Genesis
Plutus Cost Model
Plutus cost model updates available are:
Plutus Cost Model: 2023-02-14
Environments updated:
- Mainnet
- Preprod
- Preview
Configuration: link
Plutus Cost Model: 2022-11-05
Environments updated:
- Preview
Configuration: link
Plutus Cost Model: 2022-07-01
Environments updated:
- Mainnet
- Preprod
Configuration: link