From b40ed279e83862bbd3ef081063bf70b4e0d2a1eb Mon Sep 17 00:00:00 2001 From: Ipsa Date: Mon, 13 Oct 2025 10:15:39 +0530 Subject: [PATCH 1/6] chore: submit Milestone 1 for Offline Election Prediction Tool --- deliveries/offline_elction_tool_Milestone1.md | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 deliveries/offline_elction_tool_Milestone1.md diff --git a/deliveries/offline_elction_tool_Milestone1.md b/deliveries/offline_elction_tool_Milestone1.md new file mode 100644 index 0000000000..eea0368e80 --- /dev/null +++ b/deliveries/offline_elction_tool_Milestone1.md @@ -0,0 +1,23 @@ +# Milestone Delivery :mailbox: + +> Only the GitHub account, which is responsible for the pull request of the accepted application is allowed to submit milestones. Don't remove any of the mandatory parts presented in bold letters or as headlines! + + +**The delivery is according to the official [milestone delivery guidelines](https://github.com/w3f/Grants-Program/blob/master/docs/Support%20Docs/milestone-deliverables-guidelines.md).** + +* **PR Link:** https://github.com/w3f/Grants-Program/pull/2623 +* **Milestone Number:** 1 + +**Deliverables** +> Please provide a list of all deliverables of the milestone extracted from the initial application and a link to the deliverable itself. Ideally all links inside the below table should include a commit hash, which will be used for testing. If you don't provide a commit hash, we will work off the default branch of your repository. Thus, if you plan on continuing work after delivery, we suggest you create a separate branch for either the delivery or your continuing work. + + + +| Number | Deliverable | Link | Notes | +| ------------- | ------------- | ------------- |------------- | +| **0a.** | License |https://github.com/antiers-solutions/polkadot-staking-miner/blob/feat/offline-election-prediction-tool/LICENSE |Apache 2.0 / GPLv3 / MIT / Unlicense. | +| **0b.** | Documentation |https://github.com/antiers-solutions/polkadot-staking-miner/blob/feat/offline-election-prediction-tool/offline-election-prediction-staking/README.md |Inline code documentation and a tutorial explaining how to simulate an election with default or custom inputs via CLI. | +| **0c.** | Testing and Testing Guide |https://github.com/antiers-solutions/polkadot-staking-miner/blob/feat/offline-election-prediction-tool/offline-election-prediction-staking/tests/integration_tests.rs | Unit tests for the election logic; guide on how to run and interpret the results. | +| **0d.** | Docker |https://github.com/antiers-solutions/polkadot-staking-miner/blob/feat/offline-election-prediction-tool/offline-election-prediction-staking/README.md | Dockerfile to build and run the CLI simulator locally. | +| 1. | Core Election Engine | https://github.com/antiers-solutions/polkadot-staking-miner/tree/feat/offline-election-prediction-tool/offline-election-prediction-staking| Updated version of the existing election script with support for accurate simulation of on-chain validator election logic using Phragmén and other supported algorithms. | +| 2. | Custom Inputs Support |https://github.com/antiers-solutions/polkadot-staking-miner/tree/feat/offline-election-prediction-tool/offline-election-prediction-staking | Allows passing custom active set size, voters, candidates, and their stakes via JSON input. | From 203200270d9b29c3310d633567a15a451c43d9a7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sebastian=20M=C3=BCller?= Date: Mon, 13 Oct 2025 10:15:16 +0200 Subject: [PATCH 2/6] Apply suggestion from @semuelle Fix link to application --- deliveries/offline_elction_tool_Milestone1.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deliveries/offline_elction_tool_Milestone1.md b/deliveries/offline_elction_tool_Milestone1.md index eea0368e80..7101bba70b 100644 --- a/deliveries/offline_elction_tool_Milestone1.md +++ b/deliveries/offline_elction_tool_Milestone1.md @@ -5,7 +5,7 @@ **The delivery is according to the official [milestone delivery guidelines](https://github.com/w3f/Grants-Program/blob/master/docs/Support%20Docs/milestone-deliverables-guidelines.md).** -* **PR Link:** https://github.com/w3f/Grants-Program/pull/2623 +* **Application Document:** https://github.com/Ipsa11/Grants-Program/blob/master/applications/OfflineElectionTool.md * **Milestone Number:** 1 **Deliverables** From e59d944e9fba96b95d0f92d819f9b0ec2bc301fa Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sebastian=20M=C3=BCller?= Date: Mon, 13 Oct 2025 10:15:48 +0200 Subject: [PATCH 3/6] Apply suggestion from @semuelle --- deliveries/offline_elction_tool_Milestone1.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deliveries/offline_elction_tool_Milestone1.md b/deliveries/offline_elction_tool_Milestone1.md index 7101bba70b..4934f1fe80 100644 --- a/deliveries/offline_elction_tool_Milestone1.md +++ b/deliveries/offline_elction_tool_Milestone1.md @@ -5,7 +5,7 @@ **The delivery is according to the official [milestone delivery guidelines](https://github.com/w3f/Grants-Program/blob/master/docs/Support%20Docs/milestone-deliverables-guidelines.md).** -* **Application Document:** https://github.com/Ipsa11/Grants-Program/blob/master/applications/OfflineElectionTool.md +* **Application Document:** https://github.com/w3f/Grants-Program/blob/master/applications/OfflineElectionTool.md * **Milestone Number:** 1 **Deliverables** From deb3200124aa9a19a4bccae132403ba1ec8d89e8 Mon Sep 17 00:00:00 2001 From: Ipsa Date: Thu, 13 Nov 2025 15:03:42 +0530 Subject: [PATCH 4/6] chore: Updated the link for docker --- deliveries/offline_elction_tool_Milestone1.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deliveries/offline_elction_tool_Milestone1.md b/deliveries/offline_elction_tool_Milestone1.md index eea0368e80..735a856630 100644 --- a/deliveries/offline_elction_tool_Milestone1.md +++ b/deliveries/offline_elction_tool_Milestone1.md @@ -18,6 +18,6 @@ | **0a.** | License |https://github.com/antiers-solutions/polkadot-staking-miner/blob/feat/offline-election-prediction-tool/LICENSE |Apache 2.0 / GPLv3 / MIT / Unlicense. | | **0b.** | Documentation |https://github.com/antiers-solutions/polkadot-staking-miner/blob/feat/offline-election-prediction-tool/offline-election-prediction-staking/README.md |Inline code documentation and a tutorial explaining how to simulate an election with default or custom inputs via CLI. | | **0c.** | Testing and Testing Guide |https://github.com/antiers-solutions/polkadot-staking-miner/blob/feat/offline-election-prediction-tool/offline-election-prediction-staking/tests/integration_tests.rs | Unit tests for the election logic; guide on how to run and interpret the results. | -| **0d.** | Docker |https://github.com/antiers-solutions/polkadot-staking-miner/blob/feat/offline-election-prediction-tool/offline-election-prediction-staking/README.md | Dockerfile to build and run the CLI simulator locally. | +| **0d.** | Docker |https://github.com/antiers-solutions/polkadot-staking-miner/blob/main/Dockerfile.README.md | Dockerfile to build and run the CLI simulator locally. | | 1. | Core Election Engine | https://github.com/antiers-solutions/polkadot-staking-miner/tree/feat/offline-election-prediction-tool/offline-election-prediction-staking| Updated version of the existing election script with support for accurate simulation of on-chain validator election logic using Phragmén and other supported algorithms. | | 2. | Custom Inputs Support |https://github.com/antiers-solutions/polkadot-staking-miner/tree/feat/offline-election-prediction-tool/offline-election-prediction-staking | Allows passing custom active set size, voters, candidates, and their stakes via JSON input. | From b2f73dc9234b9b3f5b66f7c14db9ec9a10774c6f Mon Sep 17 00:00:00 2001 From: Ipsa Date: Thu, 13 Nov 2025 15:18:04 +0530 Subject: [PATCH 5/6] fix: Updated the link for docker --- deliveries/offline_elction_tool_Milestone1.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deliveries/offline_elction_tool_Milestone1.md b/deliveries/offline_elction_tool_Milestone1.md index 8f9f3bdd4f..8350b909c9 100644 --- a/deliveries/offline_elction_tool_Milestone1.md +++ b/deliveries/offline_elction_tool_Milestone1.md @@ -18,6 +18,6 @@ | **0a.** | License |https://github.com/antiers-solutions/polkadot-staking-miner/blob/feat/offline-election-prediction-tool/LICENSE |Apache 2.0 / GPLv3 / MIT / Unlicense. | | **0b.** | Documentation |https://github.com/antiers-solutions/polkadot-staking-miner/blob/feat/offline-election-prediction-tool/offline-election-prediction-staking/README.md |Inline code documentation and a tutorial explaining how to simulate an election with default or custom inputs via CLI. | | **0c.** | Testing and Testing Guide |https://github.com/antiers-solutions/polkadot-staking-miner/blob/feat/offline-election-prediction-tool/offline-election-prediction-staking/tests/integration_tests.rs | Unit tests for the election logic; guide on how to run and interpret the results. | -| **0d.** | Docker |https://github.com/antiers-solutions/polkadot-staking-miner/blob/main/Dockerfile.README.md | Dockerfile to build and run the CLI simulator locally. | +| **0d.** | Docker |https://github.com/antiers-solutions/polkadot-staking-miner/blob/feat/offline-election-prediction-tool/Dockerfile.README.md | Dockerfile to build and run the CLI simulator locally. | | 1. | Core Election Engine | https://github.com/antiers-solutions/polkadot-staking-miner/tree/feat/offline-election-prediction-tool/offline-election-prediction-staking| Updated version of the existing election script with support for accurate simulation of on-chain validator election logic using Phragmén and other supported algorithms. | | 2. | Custom Inputs Support |https://github.com/antiers-solutions/polkadot-staking-miner/tree/feat/offline-election-prediction-tool/offline-election-prediction-staking | Allows passing custom active set size, voters, candidates, and their stakes via JSON input. | From ee4f0ae4a8212e3db0b0065e0ba28647339d4bb5 Mon Sep 17 00:00:00 2001 From: Ipsa Date: Wed, 26 Nov 2025 12:00:38 +0530 Subject: [PATCH 6/6] fix: Updated the links --- deliveries/offline_elction_tool_Milestone1.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/deliveries/offline_elction_tool_Milestone1.md b/deliveries/offline_elction_tool_Milestone1.md index 8350b909c9..97070e54a2 100644 --- a/deliveries/offline_elction_tool_Milestone1.md +++ b/deliveries/offline_elction_tool_Milestone1.md @@ -16,8 +16,8 @@ | Number | Deliverable | Link | Notes | | ------------- | ------------- | ------------- |------------- | | **0a.** | License |https://github.com/antiers-solutions/polkadot-staking-miner/blob/feat/offline-election-prediction-tool/LICENSE |Apache 2.0 / GPLv3 / MIT / Unlicense. | -| **0b.** | Documentation |https://github.com/antiers-solutions/polkadot-staking-miner/blob/feat/offline-election-prediction-tool/offline-election-prediction-staking/README.md |Inline code documentation and a tutorial explaining how to simulate an election with default or custom inputs via CLI. | -| **0c.** | Testing and Testing Guide |https://github.com/antiers-solutions/polkadot-staking-miner/blob/feat/offline-election-prediction-tool/offline-election-prediction-staking/tests/integration_tests.rs | Unit tests for the election logic; guide on how to run and interpret the results. | +| **0b.** | Documentation |https://github.com/antiers-solutions/polkadot-staking-miner/blob/feat/offline-election-prediction-tool/README.md |Inline code documentation and a tutorial explaining how to simulate an election with default or custom inputs via CLI. | +| **0c.** | Testing and Testing Guide |https://github.com/antiers-solutions/polkadot-staking-miner/blob/feat/offline-election-prediction-tool/tests/predict.rs | Unit tests for the election logic; guide on how to run and interpret the results. | | **0d.** | Docker |https://github.com/antiers-solutions/polkadot-staking-miner/blob/feat/offline-election-prediction-tool/Dockerfile.README.md | Dockerfile to build and run the CLI simulator locally. | -| 1. | Core Election Engine | https://github.com/antiers-solutions/polkadot-staking-miner/tree/feat/offline-election-prediction-tool/offline-election-prediction-staking| Updated version of the existing election script with support for accurate simulation of on-chain validator election logic using Phragmén and other supported algorithms. | -| 2. | Custom Inputs Support |https://github.com/antiers-solutions/polkadot-staking-miner/tree/feat/offline-election-prediction-tool/offline-election-prediction-staking | Allows passing custom active set size, voters, candidates, and their stakes via JSON input. | +| 1. | Core Election Engine | https://github.com/antiers-solutions/polkadot-staking-miner/blob/feat/offline-election-prediction-tool/src/commands/predict.rs| Updated version of the existing election script with support for accurate simulation of on-chain validator election logic using Phragmén and other supported algorithms. | +| 2. | Custom Inputs Support |https://github.com/antiers-solutions/polkadot-staking-miner/blob/feat/offline-election-prediction-tool/src/commands/predict.rs | Allows passing custom active set size, voters, candidates, and their stakes via JSON input. |