Skip to content

Add Hive scheme specification for x402#1330

Open
feruzm wants to merge 6 commits intox402-foundation:mainfrom
feruzm:main
Open

Add Hive scheme specification for x402#1330
feruzm wants to merge 6 commits intox402-foundation:mainfrom
feruzm:main

Conversation

@feruzm
Copy link
Copy Markdown

@feruzm feruzm commented Feb 25, 2026

Description

Add Hive blockchain support to the x402 exact scheme specification, including the current v1 flow and the implemented v2 wire format.

Hive is a delegated-proof-of-stake blockchain with zero-fee transactions and a native stablecoin (HBD, pegged to $1 USD). This makes it well suited for x402 micropayments: no gas costs, ~3 second finality, and no token approval steps.

This PR adds:

  • specs/schemes/exact/scheme_exact_hive.md - full Hive exact scheme specification covering payload structure, verification logic (secp256k1 signature recovery against on-chain active key authorities), settlement logic (direct transaction broadcast), and v2 wire-format documentation
  • Updates to the generic upto scheme text to clarify versioned payment amount field semantics
  • A Hive upto spec draft, scoped as v1 only and explicitly not claiming current implementation support

A TypeScript reference implementation for Hive exact is available at @hiveio/x402 (source), and a public facilitator is live at https://x402.ecency.com.

Tests

This PR is specification-only (no code changes to the x402 codebase).

Hive exact behavior is exercised in the reference implementation at ecency/hive-x402, including:

  • End-to-end 402 payment flow
  • Signature verification
  • Replay rejection / nonce handling
  • Error handling
  • Express, Next.js, and Hono middleware flows

Checklist

  • I have formatted and linted my code
  • All new and existing tests pass
  • My commits are signed (required for merge)
  • Changelog fragment for user-facing changes (docs-only changes can skip)

@cb-heimdall
Copy link
Copy Markdown

cb-heimdall commented Feb 25, 2026

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
Sum 1

@vercel
Copy link
Copy Markdown

vercel bot commented Feb 25, 2026

@feruzm is attempting to deploy a commit to the Coinbase Team on Vercel.

A member of the Team first needs to authorize it.

@github-actions github-actions bot added the specs Spec changes or additions label Feb 25, 2026
@feruzm
Copy link
Copy Markdown
Author

feruzm commented Mar 5, 2026

Hi @Must-be-Ash! Could you guide me on what are the next steps to get this reviewed, please?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

specs Spec changes or additions

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants