Blnk Core

​

Fixes & Improvements

1. Enhanced UTF-8 tokenization: Improved generateTokenWithFormat function to handle UTF-8 characters correctly while preserving their format, ensuring proper tokenization of international characters and special symbols.
2. 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 in processTransaction to prevent unnecessary error propagation and provide better transaction flow management.
5. Added TypeSense DNS validation: Implemented proper TypeSense DNS validation in queueIndexData and indexData functions to ensure indexing only occurs when TypeSense is properly configured, preventing potential indexing failures.
6. Added connection pooling support: Updated connection logic in migrate, db, and test files to support new configuration parameters for connection pooling, improving database performance and reliability.
7. Added default configuration values: Implemented comprehensive default values for database settings in the configuration module, reducing setup complexity and ensuring consistent behavior across deployments.

​

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

• Refactored transaction handling to use big.Int for amounts, providing better precision and handling of large financial values.
• Refunding transactions is now idempotent: you can no longer refund a transaction more than once.
• Implemented improved locking mechanisms for balance creation to prevent race conditions.
• Added commit functionality using queue system for better transaction flow management.
• Refactored webhook processing and HTTP client initialization for better reliability.
• Fixed webhook client issues to ensure consistent delivery.
• 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.
• Updated dependencies including golang.org/x/net from 0.37.0 to 0.38.0.
• 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. Extended configuration file to include transaction and queue configurations
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. Added comments to the source code and API.

​

Bug fixes & improvements

1. Added more tests.

​

Bug fixes & improvements

1. Improved queuing time by moving reference check to the working layer.

​

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. Implemented 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
}

​

Optimistic locking

​

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.