#92 – Upgrade Proposal: v0.2.15

Passed

Proposal ID: 92

Type: Software Upgrade

Submit: 2026-07-28 07:08 UTC

Voting: 2026-07-28 07:08 UTC → 2026-07-30 07:08 UTC

Proposer: gonka18lluv53n4h9z34qu20vxcvypgdkhsg6nn2cl2d

Metadata: https://github.com/gonka-ai/gonka/blob/4d687ed6782bcea3931d2d9135bf322f84e190ab/proposals/governance-artifacts/update-v0.2.15/README.md

Bounty Reward из Community Pool: $39,825 USDT · Community Sale · PR #1503

View on gonka.gg

Upgrade Proposal: v0.2.15

Full Proposal

Full proposal — click to expand · Open in separate page →

Upgrade Proposal: v0.2.15

This PR prepares the v0.2.15 release.

The mainnet chain/API work completes the classic inference API removal started in v0.2.14, rejects invalid bridge exchange transactions before they enter the mempool, fixes PoC voting on validator-side failures, and makes chain queries resilient to gRPC outages.

The release introduces services for high-availability deployments. Read-only chain API traffic can run through the independently scalable edge-api service. Devshard v4 can run multiple versiond/devshardd replicas behind versiond-router on shared Postgres.

Upgrade Plan

The node binary is upgraded through an on-chain software upgrade proposal.

Devshard v4 is registered by the same proposal. The upgrade plan provides the v4 binary URL and sha256 hash. After the upgrade, versiond verifies and starts the binary under /devshard/v4. Earlier devshard versions remain available during the transition.

Proposed Process

Active hosts review this proposal on GitHub.
Before merge, the default deploy/join configuration is updated with the release image tags and the new edge-api and devshard routing topology.
If the on-chain proposal is approved, the chain upgrade executes at the proposed height and registers devshard v4.
This PR is merged immediately after the upgrade is executed on-chain.

Changes

inference-chain / decentralized-api

Remove the deprecated classic inference transaction types and the remaining classic completions paths from decentralized-api a35a3f6 by @gmorgachev, @DimaOrekhovPS.
Validate bridge exchange transactions in the ante handler at CheckTx so invalid transactions are rejected before entering the mempool #1498 by @GLiberman.
Abstain instead of voting -1 when PoC validation fails on the validator side, so a validator's own failures do not penalize honest participants #1504 by @gmorgachev.
Add edge-api and optional edge-api-router services so read-only chain endpoints can scale independently from decentralized-api. The decentralized-api handlers remain available during the deployment transition #1482 by @akup.
Fall back to CometBFT RPC when chain gRPC is unavailable for queries from edge-api, devshardd, and the devshard gateway. Transactions and streams remain on gRPC #1505 by @gmorgachev, @akup.

devshard

Add multiple versiond/devshardd replicas behind versiond-router, sticky session routing, shared Postgres storage, and exclusive validation leases #1366 by @akup, incorporating #1126, #1144, #1152, #1154 by @pixelplex.
Add blue/green rolling updates for binaries published with a new sha256 under the same version name. New traffic moves to the updated child after its readiness checks pass, while accepted requests finish on the old child #1490 by @snevolin, @akup.
Prevent observability requests from binding an escrow to a devshard version before the owner's first inference request #1453 by @akup.
Move the devshard gateway from LCD REST to chain gRPC and confirm settlement transactions through DeliverTx #1482 by @akup.
Add recovery for stale HA replicas and make diff persistence idempotent and persist-first #1496 by @akup.
At settlement, credit the reserved cost of started inferences to the executor and refund pending inferences #1368 by @akup.
Check signed accounting fields against the actual prompt workload and authorize execution from applied session state rather than an uncommitted request diff #1444, #1461 by @akup.
Verify fetched host signatures before storing them and align devshard validation response checks with the mainnet policy #1485, #1487 by @0xMayoor, @akup.
Return logprobs to clients that request them while continuing to remove internal validation fields #1486 by @redstartechno, @akup.
Rebuild the Postgres session index asynchronously so a slow or stale escrow does not block all new sessions after restart #1492 by @akup.
Add a Docker-backed devshard E2E test suite and expand versioned E2E coverage #1484, #1295, #1332 by @aikuznetsov, @akup.

Testing

The devshard v4 runtime was tested on a pre-release testnet with multiple versiond replicas behind versiond-router on shared Postgres. Testing covered session routing, replica failover, validation leases, observability bind safety, edge-api routing, and same-name binary rolling updates.

The upgrade from v0.2.14 to v0.2.15 was rehearsed on a testnet using the alpha builds. The software upgrade proposal was submitted and executed at the proposed height, and the network came out healthy, with devshard inference traffic continuing through the upgrade window.

Contributors (sorted alphabetically)

@0xMayoor
@aikuznetsov
@akup
@DimaOrekhovPS
@GLiberman
@gmorgachev
@mtvnastya
@pixelplex
@redstartechno
@Ryanchen911 (upgrade review)
@snevolin

Final Tally

Yes 100.0% (229,105) No 0.0% (0) Veto 0.0% (0) Abstain 0.0% (0) Total 229,105 votes ✓ Turnout 55.8% (229,105 / 410,505) · Quorum 25% (102,626)

Voters

Voter	Vote
gonka1qwfrtz…33xdkl	Yes 100.0%
gonka1p2lhgn…k6h26m	Yes 100.0%
gonka1ym3np7…0e4a2p	Yes 100.0%
gonka1d7p03c…v9h82p	Yes 100.0%
gonka10mmdja…vqgz09	Yes 100.0%
gonka15p7s7w…jk00aq	Yes 100.0%
gonka1kvmerz…lzldum	Yes 100.0%
gonka16dgkvx…6j0skk	Yes 100.0%
gonka1m58jds…cqqppf	Yes 100.0%
gonka1l6emtg…8xwa3d	Yes 100.0%

Messages

#	Type
1	`/cosmos.upgrade.v1beta1.MsgSoftwareUpgrade`

Contract Details

[
  {
    "@type": "/cosmos.upgrade.v1beta1.MsgSoftwareUpgrade",
    "authority": "gonka10d07y265gmmuvt4z0w9aw880jnsr700j2h5m33",
    "plan": {
      "name": "v0.2.15",
      "time": "0001-01-01T00:00:00Z",
      "height": "5316315",
      "info": "{\n        \"binaries\": {\n            \"linux/amd64\": \"https://github.com/gonka-ai/gonka/releases/download/release%2Fv0.2.15/inferenced-amd64.zip?checksum=sha256:91af67df9ef5c576a1695e5e85c8ee344f9f1a69d941bfc28fb339d9fd33617e\"\n        },\n        \"api_binaries\": {\n            \"linux/amd64\": \"https://github.com/gonka-ai/gonka/releases/download/release%2Fv0.2.15/decentralized-api-amd64.zip?checksum=sha256:c9cf1bfa2c994beca8a528d0ee3ad7197a582144769711600ec9df41faf4c9f7\"\n        },\n        \"approved_versions\": [\n            {\n                \"name\": \"v4\",\n                \"binary\": \"https://github.com/gonka-ai/gonka/releases/download/release%2Fv0.2.15/devshardd.zip\",\n                \"sha256\": \"bdc7ee5d08f0090711c60950c7f3ffdd0c7aef5a5badf6f19c2b075b08264ddf\"\n            }\n        ]\n    }",
      "upgraded_client_state": null
    }
  }
]