Blnk Core

​

Fixes & Improvements

1. Enhanced PII tokenization: Strengthened PII tokenization functionality to properly handle international characters, emojis, and special symbols without corruption during tokenization and detokenization processes.

​

Fixes & Improvements

1. Fixed telemetry configuration bug: Resolved issue where BLNK_ENABLE_TELEMETRY=false would still default to enabled. Telemetry and observability concerns are now properly separated with independent feature flags.
2. Enhanced transaction concurrency: Introduced robust locking mechanism for inflight transactions to prevent race conditions during commit and void operations, ensuring data consistency in high-concurrency scenarios.
3. Improved transaction reference management: Updated transaction references to use UUID suffixes for unique identification instead of simple “-commit” suffixes, providing better transaction traceability and preventing reference collisions.
4. Enhanced error handling: Improved error handling for “reference already used” errors to provide better transaction flow management.
5. Added TypeSense DNS validation: Enhanced indexing reliability by ensuring TypeSense operations only occur when properly configured, preventing potential indexing failures.
6. Added connection pooling support: Improved database performance and reliability through enhanced connection management.

​

Redis TLS verification control

{
  "redis": {
    "dns": "rediss://<user>:<password>@<host>:<port>",
    "skip_tls_verify": false
  }
}

​

Bulk transaction queue processing

• Bulk transactions default to skip_queue: false.
• Users can add "skip_queue": true to bypass the queue for immediate processing.

​

Other improvements

• Enhanced balance creation to prevent duplicate entries with the same indicator and currency.

​

Fixes & Improvements

1. Security: Added authentication bypass for /health endpoint to enable health checks without authentication.

​

New Features

1. GetBalanceByIndicator functionality
   You can now retrieve balances using custom indicators, providing more flexible balance querying capabilities for your applications.
2. Zero-amount transaction handling
   The system now properly handles zero-amount transactions, ensuring consistent behavior across all transaction types and edge cases.
3. Update balance identity endpoint
   Added new endpoint to update the identity associated with a balance, allowing for better customer data management and account linking.
4. Kubernetes deployment support
   Added comprehensive Kubernetes manifests for streamlined deployment and management in containerized environments.

​

Major Improvements

• Enhanced transaction precision for better handling of large financial values.
• Refunding transactions is now idempotent: you can no longer refund a transaction more than once.
• Improved balance creation reliability to prevent race conditions.
• Enhanced commit functionality using queue system for better transaction flow management.
• Improved webhook processing for better reliability.
• Enhanced webhook delivery consistency.
• Improved webhook error handling and retry mechanisms.
• Added comprehensive health check endpoints for better system monitoring.
• Added queue monitoring port for real-time queue metrics and dashboard monitoring.
• Enhanced system observability with improved logging and status tracking.
• Better configuration handling for transaction lock duration.
• Fixed API key revocation to properly bind to owner ID, preventing unauthorized access bypass.
• Enhanced reconciliation testing framework for better financial accuracy validation.
• Improved bulk transaction cleanup processes.
• Enhanced Docker workflow with multi-platform support for broader deployment compatibility.
• Streamlined deployment processes with better containerization.

​

Bug fixes & improvements

1. General bug fixes and improvements.

​

Granular access controls

{
  "name": "Balance Management",
  "owner": "balance_management",
  "scopes": ["balances:write", "search:write"],
  "expires_at": "2026-03-11T00:00:00Z"
}

​

Overdraft limits

{
  "amount": 400.23,
  "precision": 100,
  "currency": "USD",
  "reference": "ref_abc123",
  "source": "bln_546df224-d7a8-4a20-8e27-399938cb3ead",
  "destination": "bln_8de42141-059f-42ea-9340-00394285620a",
  "description": "Wallet funding",
  "allow_overdraft": true,
  "overdraft_limit": 500
}

​

Use historical balances without balance snapshots

GET https://YOUR_BLNK_INSTANCE_URL/balances/{balance_id}/at?timestamp={timestamp}&from_source=true

​

Apply precision with precise_amount

• Convert the amount to its smallest unit.
• Enter this value directly into the precise_amount field of your request.
• Include the corresponding precision value.

{
  "precise_amount": 189207535698279000,
  "precision": 1000000000000000000,
  "currency": "ETH",
  ...
}

​

Balance reconstruction

{
  "meta_data": {
    "BLNK_RUN_RECONCILIATION": "SOURCE"
  }
}

​

Instant reconciliation

​

Other improvements

1. Added database protections to prevent unauthorized changes to transactions and balance snapshots.
2. Introduced a transaction journal featuring a comprehensive audit log to track all activities within the transactions table.
3. Enabled metadata updates for multiple transactions using the parent_transaction ID,
4. Upgraded Redis connectivity with TLS support.
5. General bug fixes and performance improvements

​

Bug fixes & improvements

1. General bug fixes and improvements.

​

Bulk transactions

​

Backdated transactions

​

PII Tokenization

​

Bug fixes & improvements

1. General bug fixes and improvements.
2. Added environment variables for Blnk configuration parameters.

​

Bug fixes & improvements

1. General bug fixes and improvements.

​

Balance snapshots & historical balances

​

New configuration for handling insufficient funds

1. insufficient_fund_retries: Determines whether the ledger should automatically retry transactions that fail due to insufficient funds.
2. max_retry_attempts: Specifies the maximum number of retry attempts before the transaction is rejected.

​

Added queued balances

GET http://YOUR_BLNK_INSTANCE_URL/balances/{balance_id}?with_queued=true

{
    "balance": 0,
    "version": 0,
    "inflight_balance": 0,
    "credit_balance": 0,
    "inflight_credit_balance": 0,
    "debit_balance": 0,
    "inflight_debit_balance": 0,
    "queued_credit_balance": 0,
    "queued_debit_balance": 0,
    "precision": 0,
    "ledger_id": "ldg_073f7ffe-9dfd-42ce-aa50-d1dca1788adc",
    "identity_id": "",
    "balance_id": "bln_e39a239a-a6ca-4509-b0d9-29dcc5630f8a",
    "indicator": "",
    "currency": "USD",
    "created_at": "2024-07-05T08:13:18.882616461Z",
    "meta_data": {
        "customer_internal_id": "1234",
        "customer_name": "Jerry"
    }
}

​

Direct transaction processing (skip queue)

• Transactions act directly on balances without entering the queued state
• System maintains data consistency through Redis distributed locks
• Optimistic locking at database level ensures transaction integrity

{
  ...
  "inflight": true,
  "skip_queue": true
}

​

Updates to Transactions

• Each queued transaction maintains two connections to its parent:
  1. Direct link via parent_transaction field
  2. Modified reference with _q suffix

• Clear audit trail of transaction flow
• Easy tracking of transaction history
• Prevention of reference collisions
• Ability to trace complete transaction lifecycle

​

Configuration file

​

Metadata update

​

Bug fixes & improvements

1. Enhanced distribution calculations with rounding support
2. Improved transaction processing and metadata handling
3. Enhanced configuration options for transaction and queue management
4. General bug fixes and improvements

​

Bug fixes & improvements

1. General bug fixes and improvements.

​

Bug fixes & improvements

1. Improved URL parsing for managed and Docker Redis connections.

​

Bug fixes & improvements

1. indicator not returning for internal balances on the GET /balances endpoint is now fixed.

​

Bug fixes & improvements

1. General bug fixes and improvements.

​

Bug fixes & improvements

1. General bug fixes and improvements.

​

Bug fixes & improvements

1. Improved transaction processing speed through optimized reference checking.

​

Reconciliation

​

Parent transactions

1. Added pagination support for fetching transactions by parent_transaction.

​

Bug fixes & improvements

1. Add identity and reconciliation collections to Search.
2. Added new tools for system monitoring to provide better visibility and faster detection of performance issues.
3. Added rate-limiting to ensure fair usage and maintain system reliability during high traffic periods.
4. Resolved issues with backups to Amazon S3.
5. Improved error handling to deliver clearer feedback and make debugging more efficient.

​

Bug fixes & improvements

1. Fixed dates not being returned correctly.
2. Improved Search
3. created_at is now set before queuing transactions.

​

Bug fixes & improvements

1. Added precision to balance monitor.
2. Added restart policy to migration.
3. Directus service and .env parameters added in docker-compose by vebera.

​

Rates

{
  ...
  "source": "bal_usd",
  "destination": "bal_gbp",
  "rate": 0.92
}

​

Bug fixes & improvements

1. Added inflight_expiry_date for specifying when an inflight transaction should expire and be automatically voided.
2. Added new balance fields and operator field to balance monitors.
3. You can now only commit up to the total amount of the original inflight transaction.

​

Added Search

​

Transaction precision

​

Partial commits for inflight transactions

​

Bug fixes & improvements

1. Fixed typos in the payloads for inflight and allow_overdraft.
2. General bug and performance improvements.

​

Multiple sources & destinations

​

Inflight transactions

{
  "amount": 12992.12,
  "reference": "ref_1234",
  "source": "bln_28edb3e5-c168-4127-a1c4-16274e7a28d3",
  "destination": "@World",
  "description": "Card payment",
  "inflight": true
}

​

Overdrafts

{
  "allow_overdraft": true
}

​

Enhanced concurrency control

​

Bug fixes & improvements

1. The precision value for a ledger balance is now automatically applied to the amounts of all transactions that the balance is part of. This ensures that your balance is correctly computed and no amount is lost to approximation.
2. General bug and performance improvement.

​

Welcome to our first release

​

Ledgers and ledger balances

​

Transactions

​

Identities

​

Advanced

1. Added https configuration for running your Blnk server in secure mode.
2. Added k6 for load testing.