# @huma-shan/payment-detection > Payment detection using ethers. Latest version **0.40.0** (published 2023-02-12) · MIT license · 0 weekly downloads ## Install ```sh npm install @huma-shan/payment-detection pnpm add @huma-shan/payment-detection yarn add @huma-shan/payment-detection bun add @huma-shan/payment-detection ``` ## Health **Score 40/100 (D)** — status: abandoned. Positive: has types; no vulnerabilities; high maintenance score; high quality score. Warnings: low downloads; no esm support; pre 1.0. Negative: abandoned. ## Facts | | | |---|---| | Version | 0.40.0 | | Published | 2023-02-12 | | First published | 2022-11-18 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | CommonJS | | Node | >=16.0.0 | | Dependencies | 12 | | Unpacked size | 1.8 MB | | Known vulnerabilities | 0 (+26 in 2 direct dependencies) | | Install scripts | no | | GitHub stars | 385 | | Maintainers | huma-shan | | Keywords | requestnetwork | ## Links - npm: https://www.npmjs.com/package/@huma-shan/payment-detection - Repository: https://github.com/RequestNetwork/requestNetwork - Homepage: https://github.com/RequestNetwork/requestNetwork/tree/master/packages/payment-detection#readme - Issues: https://github.com/RequestNetwork/requestNetwork/issues - npm.io page: https://npm.io/package/@huma-shan/payment-detection ## Dependencies (12) - [axios](https://npm.io/package/axios.md) 0.27.2 - [tslib](https://npm.io/package/tslib.md) 2.5.0 - [ethers](https://npm.io/package/ethers.md) 5.5.1 - [lodash](https://npm.io/package/lodash.md) 4.17.21 - [graphql](https://npm.io/package/graphql.md) 15.5.1 - [graphql-tag](https://npm.io/package/graphql-tag.md) 2.12.4 - [graphql-request](https://npm.io/package/graphql-request.md) 3.4.0 - [satoshi-bitcoin](https://npm.io/package/satoshi-bitcoin.md) 1.0.4 - [@huma-shan/types](https://npm.io/package/@huma-shan/types.md) 0.40.0 - [@huma-shan/utils](https://npm.io/package/@huma-shan/utils.md) 0.40.0 - [@huma-shan/currency](https://npm.io/package/@huma-shan/currency.md) 0.13.0 - [@huma-shan/smart-contracts](https://npm.io/package/@huma-shan/smart-contracts.md) 0.33.0 ## Recent versions - 0.40.0 (latest) — 2023-02-12 - 0.39.0 — 2023-02-09 - 0.38.0 — 2023-02-07 - 0.37.8 — 2023-02-07 - 0.37.7 — 2023-02-07 - 0.37.6 — 2023-02-06 - 0.37.5 — 2023-02-03 - 0.37.4 — 2022-12-14 - 0.37.3 — 2022-12-08 - 0.37.2 — 2022-11-18 - 0.37.1 — 2022-11-18 - 0.37.0 — 2022-11-18 ## README # @huma-shan/payment-detection `@huma-shan/payment-detection` is a typescript library part of the [Request Network protocol](https://github.com/RequestNetwork/requestNetwork). It contains the implementation of request-related events interpretations, typically onchain payments of requests. The interpretation of events is specified by the payment extension added to the request. [Cf. advanced-logic specifications](../advanced-logic/specs/). # Balance and events If a payment network has been given to the request, the payment detection can be done. Based on information found in the payment network state, and included manual payment declarations, the library will perform queries and feed the property `balance` of the request with: - `balance`: the detected amount paid on the request, in request currency - `events`: all the payments, payment declarations, refunds, and other balance-related events with the amount, timestamp etc... # Retrievers and detectors This library relies on two concepts: - **Retrievers** perform RPC or TheGraph calls and fetch relevant events. Balance-impacting events are fetched with `InfoRetrievers`, implementing the `getTransferEvents()` method (cf. [IPaymentRetriever](./src/types.ts)) - **Payment detectors** implement the interface **PaymentTypes.IPaymentNetwork**, with the method `getBalance()`, which calls retrievers and interpret events according to the payment network (cf. [Abstract PaymentDetectorBase](./src/payment-detector-base.ts)). `getBalance()` returns the balance as well as events: payments, refunds, and possibly other events (declarations, escrow events...) ## PaymentDetectorBase A good part of the logic is implemented in the abstract class `PaymentDetectorBase`: ```typescript export abstract class PaymentDetectorBase< TExtension extends ExtensionTypes.IExtension, TPaymentEventParameters, > implements PaymentTypes.IPaymentNetwork { public async getBalance( request: RequestLogicTypes.IRequest, ): Promise> { // ... // getEvents() should be implemented by children payment detectors, and use appropriate retrievers // For example: RPC or The Graph based retriever const rawEvents = await this.getEvents(request); // ... // computeBalance() sums up all payment events and deduces all refunds. const balance = this.computeBalance(events).toString(); return { balance, events, }; } } ``` [cf. full implementation](./src/payment-detector-base.ts) ## Subgraph-based payment retrievers For TheGraph-based information retrieval, a client can be retrieved using `getTheGraphClient()` in `./src/thegraph/index.ts`. It provides a strongly typed interface, generated based on the queries in `/src/thegraph/queries`. The automated type generation is configured within files `./codegen.yml` (for EVM chains) and `./codegen-near.yml` (for Near) and output in `./src/thegraph/generated`. It depends on the deployed subgraphes schema and on the queries. The code generation is included in the pre-build script and can be run manually: ``` yarn codegen ``` # Test The ETH `InfoRetriever` tests require explorer API keys. Before running the payment-detection tests, define `DISABLE_API_TESTS` or define all required explorer API keys. ```bash export DISABLE_API_TESTS=1 # OR export EXPLORER_API_KEY_MAINNET= export EXPLORER_API_KEY_RINKEBY= export EXPLORER_API_KEY_FUSE= export EXPLORER_API_KEY_MATIC= export EXPLORER_API_KEY_FANTOM= yarn run test ``` --- _Source: https://npm.io/package/@huma-shan/payment-detection · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._