Configuration reference

  1. Environment variables
  2. Laravel - config/counterparty.php
  3. Symfony - config/packages/counterparty.yaml
  4. PSR dependencies you must provide

Environment variables

Used by the example scripts and mirrored by the bridge config keys.

Variable Effect
COUNTERPARTY_STRATEGY rule_based (default) or ai
COUNTERPARTY_SANCTIONS sanctions_network (default) or opensanctions
ANTHROPIC_API_KEY advisory AI via Anthropic (live)
OPENAI_API_KEY advisory AI via OpenAI (used if no Anthropic key)
OPENSANCTIONS_API_KEY OpenSanctions hosted (commercial licence)
OPENSANCTIONS_BASE_URI OpenSanctions / self-hosted yente base URL
CEIDG_TOKEN enable the CEIDG registry (bearer token; embeds a PESEL - keep secret)
REGON_TOKEN enable the REGON registry

Laravel - config/counterparty.php

return [
    'strategy' => env('COUNTERPARTY_STRATEGY', 'rule_based'),
    'review_threshold' => 0.5,
    'sanctions' => [
        'provider' => env('COUNTERPARTY_SANCTIONS', 'sanctions_network'),
        'threshold' => 0.7,
        'opensanctions' => [
            'api_key'  => env('OPENSANCTIONS_API_KEY'),
            'base_uri' => env('OPENSANCTIONS_BASE_URI', 'https://api.opensanctions.org'),
            'dataset'  => env('OPENSANCTIONS_DATASET', 'sanctions'),
        ],
    ],
    'registries' => [
        'pl_white_list' => ['enabled' => true],
        'vies'  => ['enabled' => true],
        'krs'   => ['enabled' => true],
        'ceidg' => ['enabled' => false, 'token' => env('CEIDG_TOKEN')],
        'regon' => ['enabled' => false, 'token' => env('REGON_TOKEN')],
        'crbr'  => ['enabled' => true],
    ],
    'ai' => ['review_threshold' => 0.6, 'cache_ttl' => 86400],
];

Symfony - config/packages/counterparty.yaml

counterparty:
    strategy: rule_based            # rule_based | ai
    review_threshold: 0.5
    sanctions:
        provider: sanctions_network # sanctions_network | opensanctions
        threshold: 0.7
        opensanctions:
            api_key: '%env(OPENSANCTIONS_API_KEY)%'
            base_uri: '%env(OPENSANCTIONS_BASE_URI)%'
            dataset: 'sanctions'
    registries:
        krs: true
        crbr: true
        ceidg_token: '%env(CEIDG_TOKEN)%'
        regon_token: '%env(REGON_TOKEN)%'
    ai:
        review_threshold: 0.6

PSR dependencies you must provide

PSR Used for Common implementation
PSR-18 + PSR-17 HTTP symfony/http-client (Psr18Client) + nyholm/psr7, or a Guzzle PSR-18 adapter
PSR-16 AI result cache any (Symfony Cache, Laravel cache store, …)
PSR-3 logging optional; Monolog, Symfony/Laravel logger
PSR-20 clock SystemClock ships in core

Counterparty Verification - a due-diligence aid, not a compliance product. MIT licensed.

This site uses Just the Docs, a documentation theme for Jekyll.