Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update integrators guide #90

Merged
merged 6 commits into from
Jan 13, 2025
Merged

Update integrators guide #90

merged 6 commits into from
Jan 13, 2025

Conversation

ines-toupeira
Copy link
Member

  • Removed migration and PoW references to focus entirely on PoS
  • Added a placeholder for legacy data access to inform future updates

TODO: Move the integrators doc to the Build section, archive all the migration docs, and set up redirects for old links

Copy link

netlify bot commented Dec 13, 2024

Deploy Preview for developer-center ready!

Name Link
🔨 Latest commit dfeeeca
🔍 Latest deploy log https://app.netlify.com/sites/developer-center/deploys/678502bc9c40c500085f907b
😎 Deploy Preview https://deploy-preview-90--developer-center.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

migration/migration-integrators.md Outdated Show resolved Hide resolved
migration/migration-integrators.md Outdated Show resolved Hide resolved
migration/migration-integrators.md Outdated Show resolved Hide resolved
migration/migration-integrators.md Outdated Show resolved Hide resolved
migration/migration-integrators.md Outdated Show resolved Hide resolved
migration/migration-integrators.md Outdated Show resolved Hide resolved
@ines-toupeira ines-toupeira requested a review from Eligioo January 7, 2025 14:48
Copy link
Member

@Eligioo Eligioo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

The PoS Mainnet activation is scheduled on **November 19th, 2024**, starting at the PoW block height **3’456’000**. However, this does not necessarily mean the PoS chain will continue at that block height. The activation is a window of the next ~24 hours (1440 PoW blocks) where at least 80% of the registered validators’ stake must signal readiness on-chain. If the activation does not occur in the first window, additional windows allow the activation in subsequent attempts until the PoS chain starts. Once the minimal readiness threshold to bootstrap the PoS chain is reached, the final PoW block number will become the genesis block number of the PoS chain. To summarise, the start of the activation phase with the first window on November 19th, 2024, as outlined in the [migration technical details](https://www.nimiq.com/developers/migration/migration-technical-details), **should not** be considered a fixed date but rather a potential moment for the PoS chain to begin. This is important when temporarily disabling on-chain deposits and withdrawals is relevant.

As we approach the first activation window on November 19, and since the validator registration window has already closed, the current community sentiment suggests that the actual start of the PoS chain will likely happen within the first 7 windows.
This guide outlines the key steps and requirements for integrators, such as exchanges, who want to set up and operate a Proof-of-Stake (PoS) node for the Nimiq blockchain. It provides detailed information on node types, hardware requirements and configuration options to facilitate an efficient integration.

### General Considerations for Different Node Options
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### General Considerations for Different Node Options
### General Considerations for different Node types


Once the PoS chain has started, PoW nodes are no longer needed and can be shut down. This also acts as a commitment to leave the PoW chain behind. Make sure that accessing transactions on the PoW chain is no longer necessary once the PoS Mainnet chain is live. **If you need to access transaction history from before the transition, you will need to complete the migration process as described in the [Migration Tool Guide](node-operators.md).**
Pre-genesis transactions use a different format compared to PoS transactions. Instructions on how to handle and query these pre-genesis transactions will be provided in a future update.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Pre-genesis transactions use a different format compared to PoS transactions. Instructions on how to handle and query these pre-genesis transactions will be provided in a future update.
PoW transactions use a different data serialization format compared to PoS transactions. Instructions on how to handle and query these PoW transactions will be provided in a future update.

@ines-toupeira ines-toupeira merged commit 9e6ec26 into main Jan 13, 2025
4 checks passed
@onmax onmax deleted the integrators-update branch January 14, 2025 05:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants