Skip to content

Commit 6fa2876

Browse files
committed
Set share_allow_version_mask_mismatch default to false
1 parent 9f994d9 commit 6fa2876

File tree

6 files changed

+7
-7
lines changed

6 files changed

+7
-7
lines changed

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ Counts above were collected on March 1, 2026.
4747
- `data/config/services.toml` for service/integration settings (`auth`, `backblaze_backup`, `discord`, `status` links).
4848
- `data/config/policy.toml` for submit-policy/version/bans/timeouts.
4949
- `data/config/tuning.toml` for rate limits, vardiff, EMA tuning, and peer-cleaning controls.
50-
- `data/config/version_bits.toml` for explicit per-bit block-version overrides (read-only; never rewritten by goPool). `data/config/policy.toml` `[version].bip110_enabled` toggles BIP-110 signaling (bit 4), `[version].share_allow_version_mask_mismatch` allows out-of-mask miner submit versions for compatibility (default `true`), and `version_bits.toml` can still force bit-level overrides afterward. BIP-110 reference: https://github.com/bitcoin/bips/blob/master/bip-0110.mediawiki
50+
- `data/config/version_bits.toml` for explicit per-bit block-version overrides (read-only; never rewritten by goPool). `data/config/policy.toml` `[version].bip110_enabled` toggles BIP-110 signaling (bit 4), `[version].share_allow_version_mask_mismatch` allows out-of-mask miner submit versions for compatibility (default `false`), and `version_bits.toml` can still force bit-level overrides afterward. BIP-110 reference: https://github.com/bitcoin/bips/blob/master/bip-0110.mediawiki
5151
- `data/config/secrets.toml` for sensitive credentials (RPC user/pass, Discord/Clerk secrets, Backblaze keys).
5252
- `data/config/admin.toml` controls the optional admin UI at `/admin`. The file is auto-generated on first run with `enabled = false` and a random password (read the file to see the generated secret). Update it to enable the panel, pick fresh credentials, and keep the file private. goPool writes `password_sha256` on startup and clears the plaintext password after the first successful login; subsequent logins use the hash. The admin UI provides a field-based editor for the in-memory config, can force-write `config.toml` + split override files, and includes a reboot control; reboot requests require typing `REBOOT` and resubmitting the admin password.
5353
- `[logging]` uses boolean toggles: `debug` enables verbose runtime logs, and `net_debug` enables raw network tracing (`net-debug.log`). You can also force these at startup with `-debug` and `-net-debug`.

data/config/examples/policy.toml.example

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -66,4 +66,4 @@
6666
bip110_enabled = false
6767
min_version_bits = 1
6868
share_allow_degraded_version_bits = true
69-
share_allow_version_mask_mismatch = true
69+
share_allow_version_mask_mismatch = false

defaults.go

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -64,7 +64,7 @@ func defaultConfig() Config {
6464
ConnectionTimeout: defaultConnectionTimeout,
6565
VersionMask: defaultVersionMask,
6666
MinVersionBits: defaultMinVersionBits,
67-
ShareAllowVersionMaskMismatch: true,
67+
ShareAllowVersionMaskMismatch: false,
6868
ShareAllowDegradedVersionBits: true,
6969
BIP110Enabled: false,
7070
VersionBitOverrides: nil,

documentation/stratum-v1.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ Code pointers:
2626
- Alias for `mining.authorize` (CKPool compatibility).
2727
- `mining.submit`
2828
- Standard 5 params plus an optional 6th `version` field (used for version-rolling support).
29-
- Version policy can be relaxed with `policy.toml [version].share_allow_version_mask_mismatch = true` (default), which allows out-of-mask version bits for compatibility (for example BIP-110 bit 4 signaling).
29+
- Version policy can be relaxed with `policy.toml [version].share_allow_version_mask_mismatch = true`, which allows out-of-mask version bits for compatibility (for example BIP-110 bit 4 signaling). Default is `false`.
3030
- `mining.ping` (and `client.ping`)
3131
- Replies with `"pong"`.
3232
- `client.get_version`

documentation/version-bits.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -61,9 +61,9 @@ goPool applies version changes in this order:
6161
goPool rejects miner-submitted version changes outside the negotiated
6262
version-rolling mask:
6363

64-
- `true` (default): allow out-of-mask submits for compatibility (for example
64+
- `true`: allow out-of-mask submits for compatibility (for example
6565
miners signaling BIP-110 bit 4).
66-
- `false`: strict mask enforcement (`invalid version mask` policy reject on
66+
- `false` (default): strict mask enforcement (`invalid version mask` policy reject on
6767
non-block shares).
6868

6969
## Bitcoin version bits reference

miner_submit_modes_test.go

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -581,7 +581,7 @@ func TestPrepareSubmissionTask_VersionRollingPolicyBoundaries(t *testing.T) {
581581
}
582582
})
583583

584-
t.Run("version outside mask allowed by default compatibility mode", func(t *testing.T) {
584+
t.Run("version outside mask allowed when compatibility mode enabled", func(t *testing.T) {
585585
mc, req := newVersionReq("00000010")
586586
mc.minVerBits = 0
587587
mc.cfg.ShareAllowVersionMaskMismatch = true

0 commit comments

Comments
 (0)