Repository navigation
Vortexia v0.22.0
1. Security fixes (51)
Ante, throttling and mempool
- Mixed-module transactions no longer escape Structs' per-block protections. Throttles now gate on message content rather than the free-gas flag (
303f26d). - A recovery message sent from the primary address no longer spends the shared per-player quota, so failed messages from a delegated key can't lock the owner out (
48e01de). - The 40-messages-per-player cap is now also enforced at CheckTx, so free transactions guaranteed to fail at delivery are no longer admitted (
e6e0faf). - CheckTx and ReCheckTx rejections now log at DEBUG, closing a disk-exhaustion DoS through the logs (
809e24c). MsgStructTrashis registered as a charge message, so it now gets the charge floor and the duplicate-in-transaction check (c75708f).- Fleet ids must be canonical (
9-N, no leading zeros), so padded aliases can't buy extra per-fleet throttle slots (1148b4c).
Permissions and identity
- Address registration proofs are now domain-separated, bound to the chain id and single-use through a per-address nonce. This stops replayed full-balance sweeps (
0d258e2). It is client-breaking: wallets must produce the new proof bytes. - A full-mask permission overwrite is now authorized against the bits it removes as well as the bits it adds (
33a84b7). - Operational permission holders can no longer overwrite address access controls, and a primary address must keep
PermAll(f131946). - The guild bypass level
memberno longer waives the signing key's own permission ceiling (dd71634). - Kicked members no longer retain direct guild permissions (
eff5ad0). This was later superseded in8905fc0: independent direct grants survive membership changes. - A restricted secondary address can no longer use the proxy join to get around
PermGuildMembership(3169edf). - Joining a guild with
PermGuildMembershipalone can no longer redelegate another address's stake; that now requiresPermTokenMigrate(2a4e52a). PlayerUpdateGuildRankrequiresPermAdminon the signing key before it falls back to rank authority (7e074b1).- Permission handlers reject a target player that doesn't exist, and a permission row that drops to zero is deleted rather than stored (
db7d3f8). - A cross-type permission collision could create a malformed provider. Provider ids are now resolved through
GetExistingProvider(a0725f1). ProviderCreaterequires a real substation id, closing object-id type confusion where a player id passed as a substation (20f7dde).
Tokens and bank
PlayerSendandProviderWithdrawBalancenow enforce blocked recipients and the per-denom send-enabled flags (10fdcc0).StructGeneratorInfuseaccepts exactly one coin, so a key with only infuse rights can no longer burn other denominations (842b929).- Provider deletion drains both of its pools instead of orphaning their balances (
2f3a8bd).
Guilds
- A duplicate infusion id no longer counts twice toward the guild join minimum, and fuel addition is overflow-checked (
3b560fa).
Staking, reactors and infusions
- Delegation rekeying could evade redelegation slashing (
c5a364f). - Per-delegation rounding let sharded stake keep its power after a slash. Fuel now truncates, with the
MigrateInfusionFuelRoundingmigration to repair existing state (1c2eb18). - Validator slashing now reconciles infusions in the EndBlocker, 128 per block from a stored cursor, instead of walking the whole delegator set synchronously (
5a27043). Game rule change. - Repeated defuses in the same block no longer retain power after the stake is unbonded (
2360f9d, test only).
Agreements and providers
- Deleting a substation now disconnects an arriving agreement instead of destroying it, so consumers can't pick the provider's cancellation price (
215da25). Game rule change. - Capacity increases now respect the provider's published maximum (
5111c49, test only). - A resize that rescales an agreement to zero duration is refused, and genesis validation rejects
durationMinimum0 (34877e5). - Genesis import restores each provider's
checkpointBlock(a27d984). - At most 256 agreements may expire at the same height (
c13622e). Game rule change. - Zero-height export rebases agreements and provider checkpoints onto the new chain's clock (
456e9bf). - Agreement end-block overflow is rejected in
AgreementOpenand in both capacity changes (3d4697a).
Grid and allocations
GridCascadenow does a bounded amount of work per block from a FIFO queue, and the queue is imported at genesis (b79953b). Game rule change.- Allocation loading inside the cascade is bounded too (
d45eb0f). - A destroyed allocation is reported as not found, and a second
Destroyis a no-op (63827fb). - An allocation already feeding a substation can't be reused to seed a new one (
b8850c4). - Grid attribute addition saturates at the uint64 maximum instead of wrapping (
4710499).
Combat, planets and structs
- Raid difficulty uses integer arithmetic instead of
math.Log10, which could split consensus across architectures (d3e3025). Game rule change at 13 edge points. - Completed (historical) planets can't be raided or moved to (
bdba951). Game rule change. - A struct can't be its own defender, and the upgrade clears existing self-registrations (
e870d6a). - Finishing a build sets the struct to its type's full health (
32ea6aa).
Genesis, export and block-hook robustness
- Fleets with ids that don't parse are rejected rather than silently dropped (
faa93f0). - The struct destruction queue is imported at genesis (
e82261b). - Pending builds keep their
BuildDrawpower reservation across genesis import (fe36b71). - An imported pending build's proof-of-work clock restarts at the genesis height rather than zero (
69a007e). - Struct materialization during upgrades is bounded (
3bcc0cc). - Permission cleanup is bounded per block and queued, with the queue surviving genesis (
5a2986f). - A malformed destruction-queue key is discarded instead of panicking the EndBlocker (
752d1d6). - Export with
-jail-allowed-addrsremoves excluded validators from the power index, andlog.Fatalis gone (459fb3d). - Uppercase Bech32 allowlist entries are canonicalized (
1119139). - Paginated queries cap
limitat 1000 and refusecount_total(728e2bb). API change:pagination.totalis now always 0, so check GRASS and structs-pg for any use of it.
2. Economy and features (8905fc0)
- Vaults: player and guild vaults,
MsgVaultSend, aVaultquery, and theMigrateVaultAssetsmigration. Native stake, vesting and reward positions stay at their original addresses; only liquid balances move. - Guild rank purchase:
GuildRankPurchase,GuildMembershipJoinByRankPurchaseandGuildUpdateRankPurchase, with new guild fields for base price, step increase, minimum rank and join-by-purchase. - Reactors: flat 1:1 reactor power, owner diversity bonuses (
OwnerReactorDiversityquery), and a stake cap expressed in basis points that activates once there are 10 validators (ReactorStakeSharequery). - Substations: a fixed operating loss, so usable capacity is
floor(incoming × 9/10). Player shares are refreshed when outgoing allocations change. - Bounded substation deletion: at most 8 rows per transaction, with the rest finished by GridCascade.
EventSubstationgainsdeletion_pendinganddeletion_migration_substation_id. - Guild administration:
PermAdminfrom ranks no longer confers admin authority, and a guild has one paid founding path. - ICA hosting is disabled. Normal IBC transfers are unchanged.
- Upgrade handler: a 19-phase v0.22.0 handler in
app/upgrades/v0_22_0. - Supporting material: about 100 new real-app tests, a Python substation modelling toolkit under
tools/substation_model, and roughly 40 design and review documents.
3. Gameplay tuning (c11416e)
- Build charge is set to 1 for all 22 struct types.
- Ore Extractor build difficulty range drops from 700 to 10 blocks, a target of about one minute. This applies in genesis and through an upgrade migration.
4. Dependencies and toolchain (ae08f24, 0139856)
- IAVL moves to v1.2.8. This fixes the fast-node cache race behind the
structs-public-rpcstall at 2586840. - ibc-go moves to v10.7.0, which includes the ASA-2025-004 fix.
- Cosmos SDK moves to v0.53.8 and CometBFT to v0.38.26.
- An empty IBC v2 router is added, and
app/arch_deps_test.goenforces version floors for these four. - Go moves to 1.27.3 for GO-2026-6809, along with x/net v0.61.0, gRPC v1.83.2, go-getter v1.8.6 and xz v0.5.15.
golang.org/x/textstays at v0.28.0 through an explicitreplaceto protect consensus normalization. The Makefile version check and the release workflow are updated to match.- Open item:
govulncheckstill reports 8 findings across 5 modules, including GO-2026-5970 in the pinned x/text. The doc records these as reviewed, not cleared.
5. Tests and tooling (7a5a9ab, 431dbc8)
test_chain.shand the address-proof tool are updated for the new proof format.- The testnet upgrade rehearsal test is adjusted.
Changelog
- 8905fc0 Guild Vaults, Player Vaults, Static Substation Efficiency
- ae08f24 Patching some issues relating to data consistency
- 63827fb Security Issue Deleted allocations are returned as live cache hits (Disclosed by AlatarTheWhite)
- db7d3f8 Security Issue Deleted: Arbitrary player IDs create persistent zero-permission records (Disclosed by AlatarTheWhite)
- e6e0faf Security Issue Deleted: CheckTx admits free transactions guaranteed to exceed the delivery cap (Disclosed by AlatarTheWhite)
- b8850c4 Security Issue Deleted: Connected allocation can be reused for unbounded substation creation (Disclosed by AlatarTheWhite)
- e82261b Security Issue Deleted: Destroyed structs lose their cleanup schedule during genesis import (Disclosed by AlatarTheWhite)
- 459fb3d Security Issue Deleted: Direct jailing leaves validators in the power index and aborts export (Disclosed by AlatarTheWhite)
- faa93f0 Security Issue Deleted: Ignored fleet-ID errors silently drop fleets during genesis import (Disclosed by AlatarTheWhite)
- 32ea6aa Security Issue Deleted: In-progress planetary builds miss the health rebase (Disclosed by AlatarTheWhite)
- 752d1d6 Security Issue Deleted: Malformed destruction-queue key panics EndBlocker (Disclosed by AlatarTheWhite)
- 1148b4c Security Issue Deleted: Non-canonical FleetId aliases defeat per-fleet throttles (Disclosed by AlatarTheWhite)
- fe36b71 Security Issue Deleted: Pending builds lose their reserved power load during genesis reconstruction (Disclosed by AlatarTheWhite)
- 2360f9d Security Issue Deleted: Repeated same-block defuses retain power after stake is unbonded (Disclosed by AlatarTheWhite)
- e870d6a Security Issue Deleted: Self-registration lets a target counter before the incoming volley (Disclosed by AlatarTheWhite)
- c75708f Security Issue Deleted: StructTrash bypasses charge admission throttles (Disclosed by AlatarTheWhite)
- 809e24c Security Issue Deleted: Unbounded CheckTx rejection logging enables disk-exhaustion DoS (Disclosed by AlatarTheWhite)
- 3d4697a Security Issue Deleted: Unbounded duration permits agreement end-block overflow and collateral loss (Disclosed by AlatarTheWhite)
- 728e2bb Security Issue Deleted: Unbounded pagination can exhaust node CPU and memory (Disclosed by AlatarTheWhite)
- 5a2986f Security Issue Deleted: Unbounded permission cleanup can exhaust EndBlocker memory and halt consensus (Disclosed by AlatarTheWhite)
- 3bcc0cc Security Issue Deleted: Unbounded struct materialization can halt consensus-critical upgrades (Disclosed by AlatarTheWhite)
- 4710499 Security Issue Deleted: Unchecked uint64 addition can wrap consensus state (Disclosed by AlatarTheWhite)
- 1119139 Security Issue Deleted: Valid uppercase Bech32 allowlist entries are stored under non-canonical keys (Disclosed by AlatarTheWhite)
- 5a27043 Security Issue Deleted: Validator slashing synchronously processes an unbounded delegator set (Disclosed by AlatarTheWhite)
- 69a007e Security Issue Deleted: Zeroed build start bypasses work difficulty after nonzero-height restart (Disclosed by AlatarTheWhite)
- 5111c49 Security Issue Resolution: Capacity increase bypasses provider-defined maximum (Disclosed by AlatarTheWhite)
- a0725f1 Security Issue Resolution: Cross-type permission collision creates a malformed provider (Disclosed by AlatarTheWhite)
- c5a364f Security Issue Resolution: Delegation rekey permits redelegation slashing evasion (Disclosed by AlatarTheWhite)
- 10fdcc0 Security Issue Resolution: Direct bank transfer bypasses disabled-denom and blocked-recipient controls (Disclosed by AlatarTheWhite)
- 3b560fa Security Issue Resolution: Duplicate infusion IDs bypass the guild join minimum (Disclosed by AlatarTheWhite)
- 48e01de Security Issue Resolution: Failed messages can poison another principal's shared player quota (Disclosed by AlatarTheWhite)
- d3e3025 Security Issue Resolution: Floating-point raid difficulty can split consensus (Disclosed by AlatarTheWhite)
- 33a84b7 Security Issue Resolution: Full-mask overwrite is not authorized against removed permissions (Disclosed by AlatarTheWhite)
- a27d984 Security Issue Resolution: Genesis import loses the height baseline for live agreement accounting (Disclosed by AlatarTheWhite)
- 2a4e52a Security Issue Resolution: Guild-membership permission can redelegate another address's stake (Disclosed by AlatarTheWhite)
- bdba951 Security Issue Resolution: Historical completed planets expose the owner's current ore to stale-clock raids (Disclosed by AlatarTheWhite)
- 842b929 Security Issue Resolution: Infuse-only delegate can burn arbitrary primary-account denominations (Disclosed by AlatarTheWhite)
- eff5ad0 Security Issue Resolution: Kicked members retain direct guild permissions (Disclosed by AlatarTheWhite)
- dd71634 Security Issue Resolution: Member-mode denial bypasses active-address permission (Disclosed by AlatarTheWhite)
- 303f26d Security Issue Resolution: Mixed-module transactions bypass Structs per-block protections (Disclosed by AlatarTheWhite)
- 20f7dde Security Issue Resolution: Object-ID type confusion lets players create providers without a substation (Disclosed by AlatarTheWhite)
- f131946 Security Issue Resolution: Operational permission holders can overwrite address access controls (Disclosed by AlatarTheWhite)
- 1c2eb18 Security Issue Resolution: Per-delegation rounding lets sharded stake bypass slashing (Disclosed by AlatarTheWhite)
- 2f3a8bd Security Issue Resolution: Provider deletion permanently orphans provider pool balances (Disclosed by AlatarTheWhite)
- 7e074b1 Security Issue Resolution: Rank fallback bypasses active-address permissions (Disclosed by AlatarTheWhite)
- 0d258e2 Security Issue Resolution: Replayable proof authorizes repeated full-balance sweeps (Disclosed by AlatarTheWhite)
- 3169edf Security Issue Resolution: Restricted secondary address bypasses guild-membership permission (Disclosed by AlatarTheWhite)
- 215da25 Security Issue Resolution: Substation deletion lets consumers misclassify agreement cancellation and avoid payment (Disclosed by AlatarTheWhite)
- d45eb0f Security Issue Resolution: Unbounded allocation loading can halt EndBlock grid cascades (Disclosed by AlatarTheWhite)
- c13622e Security Issue Resolution: Unbounded end-block expiration bucket can halt block production (Disclosed by AlatarTheWhite)
- b79953b Security Issue Resolution: Unbounded grid cascade permits persistent end-block denial of service (Disclosed by AlatarTheWhite)
- 34877e5 Security Issue Resolution: Zero-duration resize grants undercollateralized same-block capacity (Disclosed by AlatarTheWhite)
- 456e9bf Security Issue Resolution: Zero-height restart preserves absolute agreement heights and creates uncollateralized extensions (Disclosed by AlatarTheWhite)
- c11416e Updating build charge to be minimal and extractor Struct difficulty to be target 1 minute.
- 7a5a9ab Updating tests
- b4ea34f Updating the test chain system
- a240db2 Updating the test chain system
- 0139856 Updating to use a newer version of go due to security issues.
- 431dbc8 Upgrade rehearsal testing