{"id":50429207,"url":"https://github.com/devwhodevs/hbar-kit","last_synced_at":"2026-05-31T13:00:57.141Z","repository":{"id":361482332,"uuid":"1254611936","full_name":"devwhodevs/hbar-kit","owner":"devwhodevs","description":"viem-like DX for native Hedera apps — verify HBAR \u0026 HTS payments against the Mirror Node in \u003c20 lines. Read-only, typed, tested, non-custodial.","archived":false,"fork":false,"pushed_at":"2026-05-30T21:54:30.000Z","size":185,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-30T22:08:01.112Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/devwhodevs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-30T19:39:55.000Z","updated_at":"2026-05-30T21:54:21.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/devwhodevs/hbar-kit","commit_stats":null,"previous_names":["devwhodevs/hbar-kit"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/devwhodevs/hbar-kit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devwhodevs%2Fhbar-kit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devwhodevs%2Fhbar-kit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devwhodevs%2Fhbar-kit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devwhodevs%2Fhbar-kit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devwhodevs","download_url":"https://codeload.github.com/devwhodevs/hbar-kit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devwhodevs%2Fhbar-kit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33731998,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-31T02:00:06.040Z","response_time":95,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-31T13:00:56.285Z","updated_at":"2026-05-31T13:00:57.132Z","avatar_url":"https://github.com/devwhodevs.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hbar-kit\n\n[![CI](https://github.com/devwhodevs/hbar-kit/actions/workflows/ci.yml/badge.svg)](https://github.com/devwhodevs/hbar-kit/actions/workflows/ci.yml)\n[![npm](https://img.shields.io/npm/v/@hbar-kit/payments.svg)](https://www.npmjs.com/package/@hbar-kit/payments)\n[![license](https://img.shields.io/npm/l/@hbar-kit/payments.svg)](./LICENSE)\n[![docs](https://img.shields.io/badge/docs-hbar--kit-blue)](https://devwhodevs.github.io/hbar-kit/)\n\n**hbar-kit is a TypeScript toolkit for verifying native Hedera payments.** It confirms whether an\nHBAR or HTS-token payment reached a receiver account — by amount, memo, and time window — by reading\nthe public Hedera Mirror Node. Read-only, non-custodial, bigint-safe, and built for real payment\nverification.\n\n\u003e Verify a **native** Hedera payment in under 20 lines. No private keys, no custody.\n\n\u003e **Status: v0.1.x (beta).** Published to npm and tested, usable today for HBAR/HTS payment\n\u003e verification. Pre-1.0 — the public API may still change before 1.0, so pin a version. The\n\u003e wallet/React/Next.js/indexer packages (Phases 2–5) are planned, not yet built.\n\n## Who it's for\n\nDevelopers building **checkout flows, invoices, payment links, or backend payment APIs** on Hedera\nwho need to confirm a payment **server-side** without holding funds or running a node.\n\n## Use it when you need to\n\n- verify an **HBAR payment** by receiver, amount, memo, and time window\n- verify an **HTS token payment**\n- build **Hedera payment links**, invoice flows, checkout flows, or backend payment APIs\n- read **Hedera Mirror Node** data with typed helpers\n\nIt is read-only, non-custodial, bigint-safe, and designed for production payment verification.\n\n## Install\n\n```bash\npnpm add @hbar-kit/payments\n```\n\n## Quick example\n\n```ts\nimport { verifyHbarPayment } from \"@hbar-kit/payments\"\n\nconst result = await verifyHbarPayment({\n  network: \"testnet\",\n  receiver: \"0.0.12345\",\n  amount: \"25\", // 25 HBAR — parsed to tinybars internally, never a float\n  memo: \"order_6471727153206\", // your order / invoice id\n  after: new Date(Date.now() - 30 * 60 * 1000),\n})\n\nif (result.matched) {\n  console.log(\"Paid:\", result.explorerUrl)\n} else {\n  // pending | underpaid | overpaid | duplicate | mismatch | expired\n  console.log(\"Not settled:\", result.status)\n}\n```\n\nNo private keys, no signing, no funds held — `verifyHbarPayment` only **reads** public Mirror Node\ndata and tells you whether the payment you expected actually arrived.\n\n## Use cases\n\n- Hedera payment links\n- HBAR checkout flows\n- HTS token payment verification\n- invoice payment verification\n- backend payment status APIs\n- payment webhooks\n- Mirror Node TypeScript integrations\n- Shopify-style manual crypto payment verification\n\n## What hbar-kit is not\n\nhbar-kit is **not** a wallet, payment processor, custodial service, fiat on-ramp, exchange, or\nEVM/Solidity framework. It does not hold funds or move user money. It verifies public Hedera\ntransactions through the Mirror Node and helps developers build payment links, invoices, checkout\nflows, and payment-verification APIs.\n\n## Packages\n\n| Package              | Status  | Purpose                                                           |\n| -------------------- | ------- | ----------------------------------------------------------------- |\n| `@hbar-kit/core`     | 0.1 (beta) | Primitives: network config, bigint money, ids, timestamps, errors |\n| `@hbar-kit/mirror`   | 0.1 (beta) | Typed Mirror Node REST client                                     |\n| `@hbar-kit/payments` | 0.1 (beta) | HBAR/HTS payment verification                                     |\n| `@hbar-kit/wallet`   | Phase 2 | Native Hedera wallet signing                                      |\n| `@hbar-kit/react`    | Phase 3 | React hooks                                                       |\n| `@hbar-kit/next`     | Phase 4 | Next.js server helpers                                            |\n| `@hbar-kit/indexer`  | Phase 5 | Forward-only Mirror Node indexer                                  |\n\n## Docs\n\nSee [the documentation](https://devwhodevs.github.io/hbar-kit/). Task-focused guides:\n\n- [Build a Hedera payment link](https://devwhodevs.github.io/hbar-kit/guide/build-a-hedera-payment-link) — create a request, show instructions, verify server-side\n- [Verify a Hedera transaction by memo](https://devwhodevs.github.io/hbar-kit/guide/verify-hedera-transaction-by-memo) — match payments to an order id\n- [Accept HBAR payments without custody](https://devwhodevs.github.io/hbar-kit/guide/accept-hbar-payments-without-custody) — the non-custodial model\n- Plus: verify HBAR/HTS, wait for payment, custom Mirror Nodes, partial/duplicate handling, amounts \u0026 decimals, production notes.\n\nFor AI agents and tools, a machine-readable summary lives at\n[`llms.txt`](https://devwhodevs.github.io/hbar-kit/llms.txt) (and\n[`llms-full.txt`](https://devwhodevs.github.io/hbar-kit/llms-full.txt)).\n\n## Contributing\n\nIssues and PRs welcome — see [CONTRIBUTING.md](./CONTRIBUTING.md). By participating you agree to the\n[Code of Conduct](./CODE_OF_CONDUCT.md). To report a vulnerability, see [SECURITY.md](./SECURITY.md).\n\n## License\n\n[MIT](./LICENSE) © Oleksandr Ostrovskyi\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevwhodevs%2Fhbar-kit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevwhodevs%2Fhbar-kit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevwhodevs%2Fhbar-kit/lists"}