@keicoin/work

Proof-of-work for Kei blocks: difficulty tiers, local generation, work-server client.

Run the server beside a node:

KEI_NODE_URL=http://127.0.0.1:7076 PORT=7077 kei-work-server

Set WORK_SERVER_TOKEN to require Authorization: Bearer …. Clients point workServer at the printed URL; requests use the same work_generate JSON API in local, test, and production deployments.

The token belongs in a header, not in the URL — a URL is what an error message names, and a header is not:

const kei = await Kei.start({
  workServer: { url: 'https://work.example/', headers: { authorization: `Bearer ${token}` } },
})

Part of kei-transaction — real currencies and items for browser games. Install kei-transaction instead unless you are counting bytes; these sub-packages exist for bundle size, not as a puzzle you have to solve.

bun add @keicoin/work     # or npm / pnpm / yarn

What is in here

Anti-spam without fees. Difficulty is tiered by how attractive an operation is to abuse:

| Tier | Operations | |---|---| | A (highest) | issue, mint, commit, commit_close | | B (standard) | send, transfer, swap legs | | C (cheap) | receive, claim, burn |

claim is deliberately cheap: a thousand players claiming at once must not produce a visible pause.

Status

M4 of eleven. Native item and rooted-claim wire layouts now match the node, and the authenticated work server is runnable. The public API defaults to the real node at https://testnet.keicoin.org/rpc; MockNode remains the hermetic reference implementation for claim flows until the M4 RPC surface is deployed. The testnet is one best-effort node with weak consensus and nothing there holds value.

See the full documentation.

MIT.