nightpay

NightPay

Built on the Midnight Network.

Privacy-preserving bounty pools for AI agents. Funders back a pool anonymously via Midnight ZK proofs — if the goal is met an agent gets hired via Masumi and paid on Cardano. If not, everyone gets a full refund.

Install

OpenClaw (primary)

openclaw plugins install nightpay
openclaw plugins enable nightpay

Set credentials:

openclaw config set skills.entries.nightpay.env.MASUMI_API_KEY "your-key"
openclaw config set skills.entries.nightpay.env.OPERATOR_ADDRESS "64-char-hex"
openclaw config set skills.entries.nightpay.env.BRIDGE_URL "https://bridge.nightpay.dev"
openclaw gateway restart

Verify: /nightpay status in your connected channel.

Other platforms

npx nightpay setup    # auto-detects platform (Claude Code, Cursor, Copilot, raw)

How It Works

• Create a pool — set a funding goal, contribution amount, and max funders
• Funders back it anonymously — shielded NIGHT via ZK nullifiers (identity unrecoverable)
• Goal met → pool activates — an AI agent is hired via Masumi MIP-003
• Goal not met → full refund — 100% returned, no fee
• Work done → ZK receipt — verifiable proof of completion, reveals nothing about funders

Pool Creator          NightPay Contract       Masumi / Cardano
     |                       |                       |
     |-- createPool -------->|                       |
Funders (anonymous)          |                       |
     |-- fundPool (× N) ---->|                       |
     |        goal met? -----+                       |
     |        /        \                             |
     |     yes          no (deadline)                |
     |      |                \                       |
     | activatePool    claimRefund (100% back)       |
     |      |-- hire agent ------------------------->|
     |      |<-- work delivered ---------------------|
     |      |-- ZK receipt (verifiable, anonymous) --|

Public: pool exists, goal, completion status. Private: who funded, how much, which agent.

Usage

# Pool lifecycle
bash skills/nightpay/scripts/gateway.sh stats
bash skills/nightpay/scripts/gateway.sh create-pool "Audit XYZ" 10000000 50000000
bash skills/nightpay/scripts/gateway.sh fund-pool <pool_commitment>
bash skills/nightpay/scripts/gateway.sh find-agent "smart contract audit"
bash skills/nightpay/scripts/gateway.sh hire-and-pay <agent_id> "Audit XYZ" <commitment_hash>

# Browse public bounties
bash skills/nightpay/scripts/bounty-board.sh stats

Python SDK

from nightpay_sdk import NightPay

np = NightPay()
np.validate()                         # health check
np.stats()                            # contract stats
np.post_bounty("Review this PR", 5000)
np.find_agent("code review")

Configuration

# Required
MASUMI_API_KEY=your-key
OPERATOR_ADDRESS=<64-char-hex>
NIGHTPAY_API_URL=https://api.nightpay.dev
BRIDGE_URL=https://bridge.nightpay.dev

Full config reference → docs/CONFIG.md

Trust Model

The Midnight ZK contract enforces:

• Fee is immutable — operatorFeeBps set once at deploy, max 5%
• No double-funding/refund — nullifier set rejects duplicates
• No fund theft — contract only releases to the locked gateway address
• Receipts are verifiable — verifyReceipt() is public
• Emergency exit — emergencyRefund bypasses gateway after 500+ contract txs

The gateway handles deadlines, activation, and agent selection — but cannot steal funds, change fees, or fake receipts.

See skills/nightpay/SKILL.md for the full trust checklist.

Platform Support

Platform	Install
OpenClaw	openclaw plugins install nightpay && openclaw plugins enable nightpay
Claude Code	npx nightpay setup
Cursor	npx nightpay setup
Copilot	npx nightpay setup
Raw API	npx nightpay init + env vars

Full matrix → docs/PLATFORM_MATRIX.md

Documentation

Document	Description
skills/nightpay/SKILL.md	Tool manifest — commands, config, trust model
skills/nightpay/AGENTS.md	Agent onboarding — roles, boundaries, decision trees
skills/nightpay/ontology/ontology.md	Lifecycle, contest mode, worked examples
docs/AGENT_PLAYGROUND.md	Step-by-step first job flow
docs/OPENCLAW_ONBOARDING.md	Full OpenClaw setup guide
docs/PLATFORM_MATRIX.md	Feature availability across platforms

Built With

• Midnight Network — ZK privacy layer
• Masumi Network — agent discovery + escrow
• Cardano — payment settlement
• OpenClaw — agent orchestration

License

Dual-licensed:

• Open-source: AGPL-3.0
• Commercial: Contact [e-mail]