Skip to content

docs(plugins): add hak-github-pay-plugin v2.3.0 — pay GitHub contributors in HBAR on merge#876

Open
jmgomezl wants to merge 1 commit into
hashgraph:mainfrom
jmgomezl:docs/add-hak-github-pay-plugin
Open

docs(plugins): add hak-github-pay-plugin v2.3.0 — pay GitHub contributors in HBAR on merge#876
jmgomezl wants to merge 1 commit into
hashgraph:mainfrom
jmgomezl:docs/add-hak-github-pay-plugin

Conversation

@jmgomezl

Copy link
Copy Markdown
Contributor

Adds hak-github-pay-plugin to the third-party plugins list in docs/PLUGINS.md and README.md.

What it does

A HAK v4 plugin that turns the GitHub merge button into a payment rail: when a pull request is merged, an AI agent pays the contributor in HBAR. There is no database — payment policy, the GitHub→Hedera identity registry, every receipt, and software-release provenance all live immutably on four Hedera Consensus Service topics, verifiable on Hashscan.

Tools (7)

  • github_pay_register_contributor — map a GitHub handle → Hedera account on a public IDENTITIES topic (a reusable public good)
  • github_pay_set_payment_policylabel → HBAR payout rules
  • github_pay_set_payment_cap — monthly + per-contributor spending ceilings
  • github_pay_pay_on_merge — HMAC-validated, idempotent, cap-enforced payout + sealed receipt
  • github_pay_query_contributor_payments — payment history as CSV
  • github_pay_seal_release_provenance — SHA-256 release-asset provenance (NIST SSDF)
  • github_pay_query_team_summary — per-contributor aggregate CSV

Links

Built on Hedera Agent Kit v4 (BaseTool + plain-object plugin pattern, config resolved from the HAK Context). Commits are DCO signed-off.

Adds hak-github-pay-plugin to the third-party plugins list in docs/PLUGINS.md
and README.md.

The plugin turns the GitHub merge button into a payment rail: when a pull
request is merged, an AI agent pays the contributor in HBAR. Payment policy,
the GitHub-to-Hedera identity registry, every receipt, and software-release
provenance live immutably on four Hedera Consensus Service topics. It exposes:
- github_pay_register_contributor: map a GitHub handle to a Hedera account (public IDENTITIES topic)
- github_pay_set_payment_policy: set label -> HBAR payout rules
- github_pay_set_payment_cap: set monthly + per-contributor spending ceilings
- github_pay_pay_on_merge: HMAC-validated, idempotent, cap-enforced payout + sealed receipt
- github_pay_query_contributor_payments: payment history as CSV
- github_pay_seal_release_provenance: SHA-256 release-asset provenance (NIST SSDF)
- github_pay_query_team_summary: per-contributor aggregate CSV

Signed-off-by: Juan Gomez <jmgomezl@unal.edu.co>
@jmgomezl jmgomezl requested review from a team as code owners May 30, 2026 05:13
@jmgomezl jmgomezl requested a review from rbarker-dev May 30, 2026 05:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant