Developers

Build on HyperCluster

Our own blockchain (chain 838838), sign-in with Passport, and the HyperAI API: what each one is, where it is, and short examples.

The blockchain

Chain 838838

HyperCluster runs its own EVM blockchain on Hyperledger Besu. It records payments in HYPEC, HyperCV seals and the work each machine does. What works on Ethereum (wallets, Solidity, Hardhat, Foundry, ethers.js) works here.

Network nameHyperCluster
Chain ID838838 (0xcccb6)
CoinHYPEC, 18 decimals
RPChttps://rpc.hypercluster.org
Explorerhttps://explorer.hypercluster.org
SoftwareHyperledger Besu
Agreement on blocksQBFT, with four validators, all run by HyperCluster; at least three sign each block
BlocksAbout every 5 seconds when there are transactions, otherwise an empty one about every 30 seconds. Final as soon as they are added.
Gas limit60,000,000 a block
Gas priceAt least 1 gwei: a plain transfer costs about 0.000021 HYPEC

The public RPC

  • Send JSON-RPC requests by POST to https://rpc.hypercluster.org. The eth_, net_ and web3_ methods are open, in batches of up to 50 calls.
  • Sign transactions yourself and send them with eth_sendRawTransaction. Methods that would sign on the node (eth_sign, eth_sendTransaction, eth_accounts) are turned off.
  • Gas is paid in HYPEC. Add HYPEC with USDT in your Passport wallet, then send some to the address you deploy from.
curl https://rpc.hypercluster.org \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'

Add it to a wallet

In MetaMask or any EVM wallet, add a network with these settings:

Network name: HyperCluster
RPC URL: https://rpc.hypercluster.org
Chain ID: 838838
Currency symbol: HYPEC
Block explorer: https://explorer.hypercluster.org
Smart contracts

Deploy and verify a contract

Compile for the Cancun EVM. Our own contracts use Solidity 0.8.33 with the optimizer on. The explorer (Blockscout) verifies Solidity source, with no API key.

Hardhat

// hardhat.config.js
module.exports = {
  solidity: { version: '0.8.33', settings: { evmVersion: 'cancun', optimizer: { enabled: true, runs: 200 } } },
  networks: {
    hypercluster: { url: 'https://rpc.hypercluster.org', chainId: 838838, accounts: [process.env.PRIVATE_KEY] },
  },
  etherscan: {
    apiKey: { hypercluster: 'none' },
    customChains: [{
      network: 'hypercluster', chainId: 838838,
      urls: { apiURL: 'https://explorer.hypercluster.org/api', browserURL: 'https://explorer.hypercluster.org' },
    }],
  },
  sourcify: { enabled: false },
};
npx hardhat run scripts/deploy.js --network hypercluster
npx hardhat verify --network hypercluster 0xYourContract arg1 arg2

Foundry

forge create src/MyContract.sol:MyContract \
  --rpc-url https://rpc.hypercluster.org \
  --private-key $PRIVATE_KEY \
  --evm-version cancun --broadcast

ethers.js

import { ethers } from 'ethers';

const provider = new ethers.JsonRpcProvider('https://rpc.hypercluster.org', 838838);
console.log(await provider.getBlockNumber());
console.log(ethers.formatEther(await provider.getBalance('0xYourAddress')), 'HYPEC');

The explorer also answers Etherscan-style API calls at https://explorer.hypercluster.org/api, and has its own at /api/v2.

Our contracts

Contracts you can read

HYPEC is the chain’s own coin, like ETH on Ethereum: it has no token contract. These are the contracts behind our apps, on chain 838838.

HYPECStakingLocking HYPEC: lower prices at the checkout, and a reward
0x308eD943ca34cC0fBaf16FefEEF809eA771634fa
NotaryRegistryHyperCV seals: a document’s fingerprint and when it was sealed
0x469E04BCE3C897964E6457003c6b9471e69b0432
CredentialRegistryHyperCV credentials: certificates issued to people
0x27194074A23dcC50E62e2e74CEB555D1D57a49e8
WorkLedgerEach machine’s checked work, every day, with its proof
0xB210e0Cf7752d7e9aFc4436Fc7089219102adf28
IdentityRegistryMembers’ identities on the blockchain, from Passport
0x9B94F6AB52110D5abc0373b622C411173455E65B
Sign in with Passport

One account for your app too

Passport is the one HyperCluster account. Apps sign members in with OAuth 2 and OpenID Connect: the authorization code flow, with PKCE.

Issuerhttps://passport.hypercluster.org
Discovery/.well-known/openid-configuration
Sign-in pageGET /authorize
TokensPOST /token
The memberGET /userinfo
Signing keys/.well-known/jwks.json (RS256)
Revoke a tokenPOST /revoke
Scopes, and what each one gives
ScopeClaims
openidsub
profilename
emailemail, email_verified
walletwallet_address, wallet_type
referralreferral_code, referred_by, referral_count

referral_count comes from /userinfo only, not in the ID token.

The rules

  • Only response_type=code. Send a state, and a PKCE code_challenge with code_challenge_method=S256 (plain is refused); send the code_verifier to /token.
  • The redirect_uri must be exactly one of those registered for your app.
  • If your app has a client secret, send it in the body (client_secret_post).
  • A code lasts 10 minutes and works once. Access and ID tokens are RS256 JWTs and last an hour. A refresh token lasts 30 days and works once: using it gives you a new one.
  • Call /token and /userinfo from your server: Passport doesn’t answer them from other sites’ web pages. Check the ID token’s signature with the signing keys, and that its aud is your client ID.
  • At most 100 requests a minute from one address.

Getting a client ID

Apps are registered by HyperCluster for now; there is no self-service sign-up for developers yet. Write to [email protected] with your app’s name and its redirect addresses.

1. Send the member to sign in
https://passport.hypercluster.org/authorize?response_type=code
  &client_id=YOUR_CLIENT_ID
  &redirect_uri=https%3A%2F%2Fyour.app%2Fcallback
  &scope=openid%20profile%20email%20wallet
  &state=RANDOM_STATE
  &code_challenge=BASE64URL_SHA256_OF_VERIFIER
  &code_challenge_method=S256
2. Swap the code for tokens, on your server
curl https://passport.hypercluster.org/token \
  -d grant_type=authorization_code \
  -d code=THE_CODE \
  -d redirect_uri=https://your.app/callback \
  -d client_id=YOUR_CLIENT_ID \
  -d code_verifier=THE_VERIFIER
Paying in HYPEC

How members pay

Every HyperCluster product is priced in US dollars and paid in HYPEC from the member’s Passport wallet, at the Passport checkout: at that day’s HYPEC price, less the member’s discount for locked HYPEC.

  1. 1

    Add HYPEC

    In Passport, under Wallet, send USDT on BNB Smart Chain (BEP-20) or TRON (TRC-20) to the address shown. The HYPEC arrives in the Passport wallet at that day’s price.

  2. 2

    Pay

    The checkout shows the amount in HYPEC and the balance. Passport signs the payment for wallets it made; a MetaMask wallet approves it in MetaMask, on chain 838838.

  3. 3

    Back to the app

    The member comes back with the order paid, and the app gets a signed receipt it can check.

The checkout is for HyperCluster’s own apps (HyperCloud, HyperCV, HyperAI and this site’s store). It isn’t open to other apps yet.
Send only USDT, and only on BNB Smart Chain or TRON. Cards are not accepted.
HyperAI

The HyperAI API

Your website, app, script or AI agent sends a picture and gets back what is in it: from HyperCluster’s AI chips, or from a model you trained. It can also chat with a chat model you fine-tuned. Paid from your HyperAI credit.

Addresshttps://ai.hypercluster.org/v1
API keyMake one at ai.hypercluster.org/developers after signing in
Sending itAuthorization: Bearer hc_… or X-API-Key
PicturesJPEG, PNG or WebP, up to 10 MB (8 MB as base64 in JSON), or a public https link to one
AI agentsThe MCP server ai.hypercluster.org/mcp, with the same key
DescribedOpenAPI 3.1
Limits60 calls a minute per key, 4 at once; a monthly HYPEC limit per key if you set one
POST /v1/vision/analyzeA picture on our AI chips: things in it, each with a box, what it shows, its text, and faces. tasks: objects, labels, text, faces (all four if left out). 0.45 HYPEC ($0.0045) a picture, only when it works.
POST /v1/models/{id}/predictA picture through a YOLO model you keep in HyperAI, on a member’s graphics card. By the second, at that card’s price an hour (prices per graphics card), at most 30 seconds.
POST /v1/models/{id}/chatA message to a chat model you fine-tuned (its LoRA adapter), answered on a member’s graphics card. By the second, at the training rate for that card. The first chat on a PC can take a few minutes: then ask again at the address it gives (GET /v1/chat-runs/{id}).
GET /v1/modelsThe models you keep, with their IDs, where each stands, and whether it can run
POST /v1/modelsAdd a model: from a public https link, or uploaded in pieces. Needs a key you allowed to change models.
PATCH /v1/models/{id} · DELETE /v1/models/{id}Rename a model or change its labels; delete it (same key).
GET /v1/balanceYour HyperAI credit, in HYPEC and US dollars
curl https://ai.hypercluster.org/v1/vision/analyze \
  -H "Authorization: Bearer $HYPERAI_KEY" \
  -F [email protected] \
  -F tasks=objects,text
  • Errors come back as { "error": { "code", "message" } }. A call that fails costs nothing.
  • Calls through the API don’t use the free allowance members get each day.
  • AI agents such as Claude Code, Cursor and VS Code connect to the MCP server with your key, and can list your models, run one on a picture, read a picture on our AI chips, chat with a chat model you fine-tuned and add a model from a link. Agents that only sign in with OAuth (claude.ai and ChatGPT connectors) can’t use it yet.
  • Training is in the HyperAI app, not in the API. The API runs your models, reads pictures on our AI chips and chats with a chat model you fine-tuned.
  • Prices are set in our catalog and can change: the developers page always shows today’s.
The full API reference
HyperCV

Check a HyperCV seal

Anyone can check whether a file was sealed with HyperCV, without an account: work out the SHA-256 fingerprint of the file and ask. The answer is read from the blockchain. People can also open the check page in a browser, at notary.hypercluster.org/v/ and the fingerprint.

HASH=0x$(shasum -a 256 diploma.pdf | cut -d' ' -f1)
curl https://notary.hypercluster.org/api/v/$HASH
Public data

Ask without signing in

GET https://hypercluster.org/api/siteToday’s HYPEC price, the products on sale with their prices and invite rates, and the discount levels for locked HYPEC.
GET https://hypercluster.org/api/hypec/priceToday’s HYPEC price, in US dollars.
GET https://hypercluster.org/api/staking/infoThe lock periods with their yearly rates, and the staking contract.
GET https://hypercluster.org/api/healthWhether this site is up.
GET https://ai.hypercluster.org/network/mapThe network map’s numbers: machines by city, and what they share.
GET https://notary.hypercluster.org/api/v/{0x…}A HyperCV seal, by the file’s fingerprint.
Security

Keep it safe

  • Keep private keys and API keys on your server, never in a web page or an app people download.
  • Check a contract’s address on the explorer before you send it HYPEC.
  • Use a hardware wallet for large amounts.
  • Found a security problem? Write to [email protected].

HYPEC is the coin used to pay on HyperCluster. Nothing on this page is investment advice.