From 5b160491f65037cc9c6c0afdd3ede5b575c274d5 Mon Sep 17 00:00:00 2001 From: Juan Gomez Date: Sat, 30 May 2026 00:13:33 -0500 Subject: [PATCH] docs(plugins): add hak-github-pay-plugin v2.3.0 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 --- README.md | 2 ++ docs/PLUGINS.md | 12 ++++++++++++ 2 files changed, 14 insertions(+) diff --git a/README.md b/README.md index 2cc34d3a..d889fa71 100644 --- a/README.md +++ b/README.md @@ -47,6 +47,8 @@ Want to add more functionality from Hedera Services? [Open an issue](https://git ### Third Party Plugins The Hedera Agent Kit is extensible with third-party plugins developed by other projects. See how you can build and submit your own plugin to be listed as a Hedera Agent Kit plugin in [Hedera Docs](https://docs.hedera.com/hedera/open-source-solutions/ai-studio-on-hedera/hedera-ai-agent-kit/plugins#plugins) and in [docs/PLUGINS.md](https://github.com/hashgraph/hedera-agent-kit-js/blob/main/docs/PLUGINS.md). +- **[hak-github-pay-plugin](https://www.npmjs.com/package/hak-github-pay-plugin)** — Pays open-source contributors in HBAR when their GitHub PR is merged; payment policy, identity, receipts, and release provenance live immutably on Hedera Consensus Service. Tools: `github_pay_register_contributor`, `github_pay_set_payment_policy`, `github_pay_set_payment_cap`, `github_pay_pay_on_merge`, `github_pay_query_contributor_payments`, `github_pay_seal_release_provenance`, `github_pay_query_team_summary`. [GitHub](https://github.com/jmgomezl/hak-plugin-github-pay) + _[Contribute your own plugin](https://github.com/hashgraph/hedera-agent-kit-js/blob/main/docs/PLUGINS.md)_ ### Hooks and Policies diff --git a/docs/PLUGINS.md b/docs/PLUGINS.md index 248c3641..2cbfe279 100644 --- a/docs/PLUGINS.md +++ b/docs/PLUGINS.md @@ -107,6 +107,18 @@ See this list of available third party plugins for the Hedera Agent Kit in the [ Status: Validated by HAK team, v4-compatible release + +- [HAK GitHub Pay Plugin](https://www.npmjs.com/package/hak-github-pay-plugin) pays open-source contributors in HBAR when their GitHub pull request is merged, with payment policy, the GitHub-to-Hedera identity registry, receipts, and software-release provenance all sealed immutably on Hedera Consensus Service. It exposes the core actions (`github_pay_register_contributor`, `github_pay_set_payment_policy`, `github_pay_set_payment_cap`, `github_pay_pay_on_merge`, `github_pay_query_contributor_payments`, `github_pay_seal_release_provenance`, `github_pay_query_team_summary`) for registering contributors, setting label-to-HBAR policies and spending caps, paying on merge (HMAC-validated webhook, idempotent, cap-enforced), querying payment history as CSV, and sealing SHA-256 release provenance: + + NPM: https://www.npmjs.com/package/hak-github-pay-plugin + + Github repository: https://github.com/jmgomezl/hak-plugin-github-pay + + Version: hak-github-pay-plugin@2.3.0 + + Status: Not validated by HAK team, v4-compatible release + + ## Plugin Architecture The tools are now organized into plugins, each containing a set functionality related to the Hedera service or project they are created for.