Skip to main content

Sortable, human-safe transaction IDs (12-char V2) for high-throughput distributed systems.

Project description

txidgen

txidgen generates 12-character, human-safe, lexicographically sortable transaction IDs suitable for payment systems.

Properties

  • Length: 12 (<PREFIX><PAYLOAD11>)
  • Prefix: 1 letter A–Z (never starts numeric)
  • Alphabet: removes ambiguous chars 0 O I 1 U V
  • Sortable: string sort == creation time sort
  • Distributed: supports multiple nodes without coordination
  • Throughput: tuned for 10k TPS+ with a few nodes

V2 layout (50-bit payload)

  • ts10 (38 bits): 10ms ticks since custom epoch (default 2026-01-01 UTC)
  • node (4 bits): 0..15
  • currency (4 bits): 0..15
  • seq (4 bits): 0..15 per node per 10ms tick

Install

pip install txidgen

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

txidgen-0.1.0.tar.gz (7.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

txidgen-0.1.0-py3-none-any.whl (7.7 kB view details)

Uploaded Python 3

File details

Details for the file txidgen-0.1.0.tar.gz.

File metadata

  • Download URL: txidgen-0.1.0.tar.gz
  • Upload date:
  • Size: 7.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.3

File hashes

Hashes for txidgen-0.1.0.tar.gz
Algorithm Hash digest
SHA256 dd8bb1e67f15d0453706024342cd2c98973963201878672fc220ce9ec0ec3240
MD5 93c42480df0355535fc3d6935d147194
BLAKE2b-256 2978bff92562b5197be7f7f993a7c37918baf087db0d624fae3b177523f3a6cc

See more details on using hashes here.

File details

Details for the file txidgen-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: txidgen-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 7.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.3

File hashes

Hashes for txidgen-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 da48ff0eff320507504be9aa5ce72d02bf57dabf9be26decfd1a5d0f96a9c832
MD5 bb63574101b41c47fb7fe7eb184687f1
BLAKE2b-256 2fbe5998be689b5411716bee5e1523455f76f7a1985c70a79b1bfafb7aaf6253

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page