PHPackages                             gawrys/counterparty-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. gawrys/counterparty-bundle

ActiveSymfony-bundle[Utility & Helpers](/categories/utility)

gawrys/counterparty-bundle
==========================

Symfony bundle for counterparty-verification: DI extension, tagged drivers and research tools, validator constraint and Messenger integration.

v0.1.1(today)00MITPHPPHP >=8.2CI passing

Since Jun 23Pushed todayCompare

[ Source](https://github.com/igorgawrys1/counterparty-bundle)[ Packagist](https://packagist.org/packages/gawrys/counterparty-bundle)[ RSS](/packages/gawrys-counterparty-bundle/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (18)Versions (3)Used By (0)

Counterparty Bundle (Symfony)
=============================

[](#counterparty-bundle-symfony)

[![Packagist Version](https://camo.githubusercontent.com/d7b5d335114eb7605aa498c6152fa6221812bb2d1dca7dd4b24757fd06cd3f0a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6761777279732f636f756e74657270617274792d62756e646c652e737667)](https://packagist.org/packages/gawrys/counterparty-bundle)[![Total Downloads](https://camo.githubusercontent.com/95c5aaca39cc3eb85db360e12764aa233ee325d0ebf72dac0b2c40100a96d9d2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6761777279732f636f756e74657270617274792d62756e646c652e737667)](https://packagist.org/packages/gawrys/counterparty-bundle)[![CI](https://github.com/igorgawrys1/counterparty-bundle/actions/workflows/ci.yml/badge.svg)](https://github.com/igorgawrys1/counterparty-bundle/actions/workflows/ci.yml)[![PHP](https://camo.githubusercontent.com/dad72c42359ce03cc1cd9d1b3251dcc5769e6f45e218d6149e19bd7bcb1bfac0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d382e32253230253743253230382e33253230253743253230382e342d3737376262342e737667)](https://www.php.net/)[![Symfony](https://camo.githubusercontent.com/29bf78244175ac7b2e8b71c66a56862ea743b427518ae6fa6c7621178734e13b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f73796d666f6e792d362e34253230253743253230372d3030303030302e737667)](https://symfony.com/)[![PHPStan](https://camo.githubusercontent.com/745eb989b9e4903dc598fe2cc63ed4226198be55b7c729001cbd1ece7676fef6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d6d61782d627269676874677265656e2e737667)](https://phpstan.org/)[![Psalm](https://camo.githubusercontent.com/1516496318aec6e2baf9f8ed7888070c8c0c279848ee94165206d1fa8796d864/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5073616c6d2d6c6576656c253230312d627269676874677265656e2e737667)](https://psalm.dev/)[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](LICENSE)

The Symfony bundle for the [Counterparty Verification](https://github.com/igorgawrys1/counterparty-core) toolkit: a DI extension, tagged drivers and research tools, a validator constraint and Messenger integration.

> ⚠️ A **due-diligence aid**, not a guarantee of AML compliance. Risk output is advisory.

Features
--------

[](#features)

- **Auto-wired** - PSR contracts mapped onto Symfony (`Psr18Client`, logger, clock); the `Verifier` is a first-class service.
- **Tagged drivers** - tag a service `counterparty.registry_driver` and a compiler pass collects it into the shared manager (research tools via `counterparty.research_tool`).
- **Validator** - a `NotSanctioned` constraint + validator for the Validator component.
- **Messenger** - a message + handler for asynchronous verification.
- **Config-driven** - strategy (`rule_based` | `ai`), sanctions provider, registry tokens; conditional AI wiring.

Installation
------------

[](#installation)

```
composer require gawrys/counterparty-bundle
```

```
# config/packages/counterparty.yaml
counterparty:
    strategy: rule_based      # or "ai" (requires gawrys/counterparty-ai + an AiResearchProvider)
    sanctions:
        provider: sanctions_network   # or "opensanctions"
    registries:
        ceidg_token: '%env(CEIDG_TOKEN)%'
```

Usage
-----

[](#usage)

```
public function __construct(private \Gawrys\Counterparty\Verifier $verifier) {}

$outcome = $this->verifier->verify(new \Gawrys\Counterparty\Counterparty('Acme', 'PL', nip: '1234567890'));
```

Add a registry by tagging a service:

```
services:
    App\Registry\GermanRegistryDriver:
        tags:
            - { name: counterparty.registry_driver, alias: de }
```

Validate a property:

```
use Gawrys\Counterparty\Symfony\Validator\NotSanctioned;

#[NotSanctioned(country: 'PL')]
private string $counterpartyName;
```

Async via Messenger: dispatch `VerifyCounterpartyMessage`; `VerifyCounterpartyHandler` handles it.

Full guide: **[documentation](https://igorgawrys1.github.io/counterparty-verification/symfony/)**.

Testing
-------

[](#testing)

```
composer check   # php-cs-fixer + PHPStan max (phpstan-symfony) + Psalm level 1 + PHPUnit
```

Changelog
---------

[](#changelog)

See [CHANGELOG.md](CHANGELOG.md).

Contributing & Security
---------------------------

[](#contributing--security)

Pull requests welcome. Report security issues privately - see [SECURITY.md](SECURITY.md).

Credits
-------

[](#credits)

- [Igor Gawrys](https://github.com/igorgawrys1)

License
-------

[](#license)

The MIT License (MIT). See [LICENSE](LICENSE).

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance100

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity37

Early-stage or recently created project

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~3 days

Total

2

Last Release

0d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b7e3d761ee1d0092d6f4400cf56467f93fa413fbc1cb7bc2e9776903cb52f5f7?d=identicon)[gawrys](/maintainers/gawrys)

---

Tags

symfonybundlevatkycsanctionsdue-diligence

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Psalm

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/gawrys-counterparty-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/gawrys-counterparty-bundle/health.svg)](https://phpackages.com/packages/gawrys-counterparty-bundle)
```

###  Alternatives

[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.4M196](/packages/sulu-sulu)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)