Skip to content

v1.3.7 — Developer Experience (SDKs, devnet, typed errors)

Choose a tag to compare

View all tags
@twobitapps twobitapps released this 09 Apr 23:26
· 28 commits to main since this release
chain-v1.3.7
327a9a1

v1.3.7 — Developer Experience

Biggest DX release since genesis. No consensus changes; drop-in upgrade
from v1.3.6 with no chain data wipe required.

New: typed HSPACE-xxx error taxonomy

Every hspace_* RPC error now returns a structured error.data.code
field with a stable HSPACE-xxx code, not just a loose message string.
Clients can branch on the code instead of substring-matching — this
fixes the exact pain point that turned the 2026-04-09 fork recovery
into a multi-hour debugging session.

{
  "jsonrpc": "2.0", "id": 1,
  "error": {
    "code": -32000,
    "message": "HSPACE-101: channel expired",
    "data": {
      "code": "HSPACE-101",
      "detail": "channel abc123... expired at wall-clock 1775749200"
    }
  }
}

Codes:

  • HSPACE-100..106 — payment channel lifecycle errors
  • HSPACE-200..203 — proof-carrying transaction errors
  • HSPACE-300..301 — agent registry errors
  • HSPACE-900..999 — invalid params / unsupported / internal

New: hyperspace devnet subcommand

One command to spin up a local multi-validator chain — the Hyperspace
equivalent of anvil / hardhat node.

hyperspace devnet
# 4 validators start on 127.0.0.1 ports 8545-8548
# chain ID 31337, deterministic keys, Ctrl-C to stop

Flags: --validators N, --datadir PATH, --chain-id N, --http-port N,
--p2p-port N, --reset. Deterministic keys mean every run produces the
same validator addresses — convenient for integration tests that want
to reference a known validator.

New: enhanced hyperspace status subcommand

Rich operator-facing node health report:

Hyperspace node status — 2026-04-09T23:08:33Z

Local node:
  http://64.227.23.54:8545   block=4189  peers=16  chain=808080
    head hash: 0xa4d7ec0bf69eec98...
    consensus: NarwhalTusk (4 validators)

Drift:
  range:     0 blocks  (min 4189, max 4189)

Consensus health:
  block:     4189
  status:    CONSISTENT

Supports --json for machine parsing, --peer URL to compare arbitrary
validators, and HSPACE_STATUS_PEERS env var for scripting. The
cross-validator hash consistency check is the same one that would have
caught the 2026-04-09 four-way fork on day one.

New: official SDKs

First-class TypeScript and Python SDKs in sdk/hyperspace-js/ and sdk/hyperspace-py/:

// TypeScript
import { HyperspaceClient, PaymentChannel } from '@hyperspace/sdk'
const client = new HyperspaceClient({ network: 'testnet' })
const channel = await PaymentChannel.open(client, { sender, recipient, deposit: 50_000_000 })
for (let i = 0; i < 1000; i++) await channel.pay(100)
await channel.close()
# Python
from hyperspace import HyperspaceClient, PaymentChannel
client = HyperspaceClient(network="testnet")
channel = PaymentChannel.open(client, sender=sender, recipient=recipient, deposit=50_000_000)
for i in range(1000):
    channel.pay(100)
channel.close()

Both SDKs:

  • Wrap every hspace_* method
  • Parse typed HSPACE-xxx errors
  • Auto-reopen channels on HSPACE-100 / 101 / 104
  • Expose client.consensusHealth() for cross-validator fork detection
  • Include MetaMask integration helpers (JS only)

New: example contracts

Three opinionated reference contracts at contracts/:

  • SkillRegistry.sol — discoverable catalog of skills an agent offers
  • TaskEscrow2.sol — post/claim/deliver escrow with 2% protocol fee
  • ReputationOracle.sol — composite score + tier gating for TaskEscrow2

All three follow the existing Governable pattern and ship with a
scripts/deploy-examples.js deploy script.

New: Docker image + Grafana stack

docker/fullnode/Dockerfile — multi-stage production build for
hyperspaceai/node:latest. docker/monitoring/ brings up Prometheus

  • Grafana with a 9-panel dashboard including a cross-validator
    hash-consistency widget. Full docs at docker/README.md.

New: developer docs

Upgrade notes

Drop-in upgrade. No chain data wipe required. Auto-updater will
pick this up automatically; operators manually upgrading can swap the
binary in place and restart:

curl -L https://github.com/hyperspaceai/agi/releases/download/chain-v1.3.7/hyperspace-agentic-blockchain-linux-amd64.tar.gz -o hs.tar.gz
tar xzf hs.tar.gz
sudo cp hyperspace-agentic-blockchain-linux-amd64/hyperspace-agentic-blockchain /usr/local/bin/
sudo cp hyperspace-agentic-blockchain-linux-amd64/lib/* /usr/local/bin/lib/
sudo systemctl restart hyperspace-agentic-blockchain

Existing clients that substring-match error messages will keep working
(the SDKs' parseRpcError has a legacy fallback branch), but should
migrate to HyperspaceErrorCode comparisons over the next release.

Assets 6
Loading