@bitsocial/spam-blocker-challenge 0.1.5 → 0.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +14 -12
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -18,7 +18,9 @@ Then set it on your community with one command:
18
18
  bitsocial community edit your-community.bso '--settings.challenges[0].name' @bitsocial/spam-blocker-challenge
19
19
  ```
20
20
 
21
- That uses the hosted Bitsocial Spam Blocker server and the default thresholds.
21
+ That uses the hosted Bitsocial Spam Blocker server and the default thresholds. This is the strongly recommended configuration because the centralized service can correlate cross-community abuse and signer clusters over time.
22
+
23
+ The hosted service normally allows up to three signer public keys on a confirmed user-origin IP during its rolling window, accommodating users who cannot yet sync a Bitsocial signer across devices. Excessive account switching, rapid signer churn, ban evasion, or interactions between linked signers can trigger stronger verification or a temporary IP-level rejection. This policy is enforced by the hosted server, not by the public challenge package itself.
22
24
 
23
25
  To customize thresholds or IP-based rejection rules, pass options in the same command:
24
26
 
@@ -46,17 +48,17 @@ Then add or edit the `challenges` array in your community settings to include th
46
48
 
47
49
  ## Options
48
50
 
49
- | Option | Default | Description |
50
- | --------------------- | ------------------------------------------ | --------------------------------------------------------------------------- |
51
- | `serverUrl` | `https://spamblocker.bitsocial.net/api/v1` | URL of the Bitsocial spam blocker server |
52
- | `autoAcceptThreshold` | `0.2` | Complete verification after iframe evaluation when risk is below this value |
53
- | `autoRejectThreshold` | `0.8` | Reject after iframe evaluation when risk is above this value |
54
- | `countryBlacklist` | _(empty)_ | Comma-separated ISO 3166-1 alpha-2 country codes to block (e.g. `RU,CN,KP`) |
55
- | `maxIpRisk` | `1.0` | Reject if IP risk score exceeds this threshold (estimation only) |
56
- | `blockVpn` | `false` | Reject publications from VPN IPs (estimation only) |
57
- | `blockProxy` | `false` | Reject publications from proxy IPs (estimation only) |
58
- | `blockTor` | `false` | Reject publications from Tor exit nodes (estimation only) |
59
- | `blockDatacenter` | `false` | Reject publications from datacenter IPs (estimation only) |
51
+ | Option | Default | Description |
52
+ | --------------------- | ------------------------------------------ | ------------------------------------------------------------------------------------ |
53
+ | `serverUrl` | `https://spamblocker.bitsocial.net/api/v1` | URL of a compatible spam blocker service; the official hosted service is recommended |
54
+ | `autoAcceptThreshold` | `0.2` | Complete verification after iframe evaluation when risk is below this value |
55
+ | `autoRejectThreshold` | `0.8` | Reject after iframe evaluation when risk is above this value |
56
+ | `countryBlacklist` | _(empty)_ | Comma-separated ISO 3166-1 alpha-2 country codes to block (e.g. `RU,CN,KP`) |
57
+ | `maxIpRisk` | `1.0` | Reject if IP risk score exceeds this threshold (estimation only) |
58
+ | `blockVpn` | `false` | Reject publications from VPN IPs (estimation only) |
59
+ | `blockProxy` | `false` | Reject publications from proxy IPs (estimation only) |
60
+ | `blockTor` | `false` | Reject publications from Tor exit nodes (estimation only) |
61
+ | `blockDatacenter` | `false` | Reject publications from datacenter IPs (estimation only) |
60
62
 
61
63
  ## How It Works
62
64
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@bitsocial/spam-blocker-challenge",
3
- "version": "0.1.5",
3
+ "version": "0.1.6",
4
4
  "description": "Bitsocial Spam Blocker challenge implementation for PKC",
5
5
  "keywords": [
6
6
  "bitsocial",