modules/applications-economy/hyper-p2p-credit-ledger

hyper-p2p-credit-ledger

Gossip-synchronized credit accounts: open, credit, debit, transfer, and balance queries on a shared Hyperswarm topic.

Category: Applications (economy)

Composes with: hyper-p2p-auction-gossip, hyper-p2p-marketplace-listing

Protocol: credit-ledger/v1

When to use

Soft-currency or reputation balances that should converge across peers without a central server.

When not to use

Strong consistency, double-spend safety, or audit-grade accounting (add consensus or signed operation logs).

Quick start

const { HyperP2PCreditLedger } = require('hyper-p2p-credit-ledger')
const ledger = new HyperP2PCreditLedger({ topic: 'credits-demo' })
await ledger.ready()
ledger.openAccount('alice', 100)
ledger.transfer('alice', 'bob', 25)
console.log(ledger.balance('bob')) // 25
await ledger.close()

Docs

• docs/api.md
• docs/architecture.md
• examples/basic.js

Test

npm install && npm test