Skip to content

Vortexia v0.22.0

Choose a tag to compare

@github-actions github-actions released this 26 Oct 13:31
· 8 commits to master since this release
96cea3a

1. Security fixes (51)

Ante, throttling and mempool

  1. Mixed-module transactions no longer escape Structs' per-block protections. Throttles now gate on message content rather than the free-gas flag (303f26d).
  2. 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).
  3. 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).
  4. CheckTx and ReCheckTx rejections now log at DEBUG, closing a disk-exhaustion DoS through the logs (809e24c).
  5. MsgStructTrash is registered as a charge message, so it now gets the charge floor and the duplicate-in-transaction check (c75708f).
  6. 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

  1. 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.
  2. A full-mask permission overwrite is now authorized against the bits it removes as well as the bits it adds (33a84b7).
  3. Operational permission holders can no longer overwrite address access controls, and a primary address must keep PermAll (f131946).
  4. The guild bypass level member no longer waives the signing key's own permission ceiling (dd71634).
  5. Kicked members no longer retain direct guild permissions (eff5ad0). This was later superseded in 8905fc0: independent direct grants survive membership changes.
  6. A restricted secondary address can no longer use the proxy join to get around PermGuildMembership (3169edf).
  7. Joining a guild with PermGuildMembership alone can no longer redelegate another address's stake; that now requires PermTokenMigrate (2a4e52a).
  8. PlayerUpdateGuildRank requires PermAdmin on the signing key before it falls back to rank authority (7e074b1).
  9. Permission handlers reject a target player that doesn't exist, and a permission row that drops to zero is deleted rather than stored (db7d3f8).
  10. A cross-type permission collision could create a malformed provider. Provider ids are now resolved through GetExistingProvider (a0725f1).
  11. ProviderCreate requires a real substation id, closing object-id type confusion where a player id passed as a substation (20f7dde).

Tokens and bank

  1. PlayerSend and ProviderWithdrawBalance now enforce blocked recipients and the per-denom send-enabled flags (10fdcc0).
  2. StructGeneratorInfuse accepts exactly one coin, so a key with only infuse rights can no longer burn other denominations (842b929).
  3. Provider deletion drains both of its pools instead of orphaning their balances (2f3a8bd).

Guilds

  1. A duplicate infusion id no longer counts twice toward the guild join minimum, and fuel addition is overflow-checked (3b560fa).

Staking, reactors and infusions

  1. Delegation rekeying could evade redelegation slashing (c5a364f).
  2. Per-delegation rounding let sharded stake keep its power after a slash. Fuel now truncates, with the MigrateInfusionFuelRounding migration to repair existing state (1c2eb18).
  3. 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.
  4. Repeated defuses in the same block no longer retain power after the stake is unbonded (2360f9d, test only).

Agreements and providers

  1. 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.
  2. Capacity increases now respect the provider's published maximum (5111c49, test only).
  3. A resize that rescales an agreement to zero duration is refused, and genesis validation rejects durationMinimum 0 (34877e5).
  4. Genesis import restores each provider's checkpointBlock (a27d984).
  5. At most 256 agreements may expire at the same height (c13622e). Game rule change.
  6. Zero-height export rebases agreements and provider checkpoints onto the new chain's clock (456e9bf).
  7. Agreement end-block overflow is rejected in AgreementOpen and in both capacity changes (3d4697a).

Grid and allocations

  1. GridCascade now does a bounded amount of work per block from a FIFO queue, and the queue is imported at genesis (b79953b). Game rule change.
  2. Allocation loading inside the cascade is bounded too (d45eb0f).
  3. A destroyed allocation is reported as not found, and a second Destroy is a no-op (63827fb).
  4. An allocation already feeding a substation can't be reused to seed a new one (b8850c4).
  5. Grid attribute addition saturates at the uint64 maximum instead of wrapping (4710499).

Combat, planets and structs

  1. Raid difficulty uses integer arithmetic instead of math.Log10, which could split consensus across architectures (d3e3025). Game rule change at 13 edge points.
  2. Completed (historical) planets can't be raided or moved to (bdba951). Game rule change.
  3. A struct can't be its own defender, and the upgrade clears existing self-registrations (e870d6a).
  4. Finishing a build sets the struct to its type's full health (32ea6aa).

Genesis, export and block-hook robustness

  1. Fleets with ids that don't parse are rejected rather than silently dropped (faa93f0).
  2. The struct destruction queue is imported at genesis (e82261b).
  3. Pending builds keep their BuildDraw power reservation across genesis import (fe36b71).
  4. An imported pending build's proof-of-work clock restarts at the genesis height rather than zero (69a007e).
  5. Struct materialization during upgrades is bounded (3bcc0cc).
  6. Permission cleanup is bounded per block and queued, with the queue surviving genesis (5a2986f).
  7. A malformed destruction-queue key is discarded instead of panicking the EndBlocker (752d1d6).
  8. Export with -jail-allowed-addrs removes excluded validators from the power index, and log.Fatal is gone (459fb3d).
  9. Uppercase Bech32 allowlist entries are canonicalized (1119139).
  10. Paginated queries cap limit at 1000 and refuse count_total (728e2bb). API change: pagination.total is 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, a Vault query, and the MigrateVaultAssets migration. Native stake, vesting and reward positions stay at their original addresses; only liquid balances move.
  • Guild rank purchase: GuildRankPurchase, GuildMembershipJoinByRankPurchase and GuildUpdateRankPurchase, with new guild fields for base price, step increase, minimum rank and join-by-purchase.
  • Reactors: flat 1:1 reactor power, owner diversity bonuses (OwnerReactorDiversity query), and a stake cap expressed in basis points that activates once there are 10 validators (ReactorStakeShare query).
  • 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. EventSubstation gains deletion_pending and deletion_migration_substation_id.
  • Guild administration: PermAdmin from 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-rpc stall 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.go enforces 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/text stays at v0.28.0 through an explicit replace to protect consensus normalization. The Makefile version check and the release workflow are updated to match.
  • Open item: govulncheck still 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.sh and 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