id: PoC: conversion executor — linked transfer pairs, write-ahead intent, recovery scanner

From the conversion-engine design on #2063 (feeds #2043; parent epic #2056).

Build a proof of concept of the conversion executor:

Linked-chain submission against a TigerBeetle test cluster: T1 user→LP (source ledger), optional fee leg, T3 LP→user (dest ledger), all legs stamped user_data_128 = conversion_id, submitted as one linked batch.
Write-ahead intent record persisted (conversion_id + both transfer IDs + amounts + authorisation id) before any TigerBeetle submission.
Recovery scanner: reconciles SUBMITTED-state records by looking up the pre-generated transfer IDs (present ⇒ POSTED; absent ⇒ resubmit same IDs or abandon).
Demonstrate the failure cases from id: design: conversion engine — linked transfer pairs, rate authorisation, liquidity accounts #2063 §4: in-batch leg failure moves nothing; crash between intent and submission recovers without double-posting; insufficient LP inventory fails pre-flight.

Acceptance criteria:

PoC runs against a TigerBeetle test cluster and demonstrates a posted conversion with both legs findable by user_data_128.
Tests demonstrate atomic failure (one leg forced to fail ⇒ no balance moves) and crash-recovery reconciliation.
Results (test output / short report) linked from id: design: conversion engine — linked transfer pairs, rate authorisation, liquidity accounts #2063.

This is a PoC, not the permanent feature — do not build production conversion on top of it without a review round (program rule, #2056). Account/LP representation comes from #2062; stub accounts are acceptable for the PoC.

CODE-1147

🤖 Agent note · handed off

Agent: queue worker (repo-worker-code), lane E
Session / ID: queue task 3455 (triage of id: PoC: conversion executor — linked transfer pairs, write-ahead intent, recovery scanner #2289)
Found via: queue claim
Task: Triage verdict — CONFIRMED + RESCOPED, routed to implementation task 5239.
Expectation: The PoC itself is unbuilt and nobody else owns it: fresh checks 2026-11-01 show no PR for 2289, no branch naming it, and this issue still open. The material correction this triage adds: no TigerBeetle client or test-cluster code exists anywhere in the repo — a code search for "tigerbeetle" returns only the investigation/design docs (the id: investigate: TigerBeetle — multi-currency ledgers, conversions, per-coin vs balance model, 3-node cluster topology #2040 investigation PR docs(id): 2026-10-28 program investigations — TigerBeetle + Cloudflare Workers fit #2067 was docs-only), so the original packet's "test suite against a TigerBeetle test cluster" presupposed infrastructure that was never built. Task 5239 therefore starts with step 0, the harness: a throwaway single-replica dev cluster the pkgs/id suite can start/stop with a pinned reproducible binary (sanctioned by doc/2026-10-29T11-57-00Z_investigation_tigerbeetle_cluster_topology), client choice per the id: investigate: TigerBeetle — multi-currency ledgers, conversions, per-coin vs balance model, 3-node cluster topology #2040 backend investigation. id: design: currency control plane — registry, account factory, gateway #2062 is closed and id: PoC: conversion executor — linked transfer pairs, write-ahead intent, recovery scanner #2289 allows stub accounts, so nothing else gates it.
Links: follow-up task 5239 (packet: hidden_files/packets/task3455-2289-conversion-poc-impl.json) · design id: design: conversion engine — linked transfer pairs, rate authorisation, liquidity accounts #2063 · epic epic: ID platform expansion — apps, comms, currency, hosting, boards (2026-10-28 directive, LIST 6–15) #2056

🤖 Agent note · picked up

Agent: OpenChamber scheduled lane (repo-worker-code)
Task: 5239, assess the conversion executor PoC.

🤖 Agent note · picked up

Agent: queue worker (repo-worker-code), lane code-j
Session / ID: task 8190
Found via: queue claim
Task: Resuming task 8190 at stage targeted_tests_passed: revalidating PR feat(id/currency_poc): bind LedgerBackend to the official TigerBeetle Rust client (#2289) #5072 checks and the Codex re-review of head 13cb9d2; merging when green under the standing criteria, then completing task 8190 as fixed_merged.
Expectation: PR feat(id/currency_poc): bind LedgerBackend to the official TigerBeetle Rust client (#2289) #5072 merged and issue id: PoC: conversion executor — linked transfer pairs, write-ahead intent, recovery scanner #2289 updated, or task 8190 parked with the exact blocker.
Links: PR feat(id/currency_poc): bind LedgerBackend to the official TigerBeetle Rust client (#2289) #5072; branch queue/8190-2289-tigerbeetle-client-binding

🤖 Agent note · parked

Agent: queue worker (repo-worker-code), lane code-j
Session / ID: task 8190
Found via: queue claim
Task: Task 8190 parked for 20 minutes: PR feat(id/currency_poc): bind LedgerBackend to the official TigerBeetle Rust client (#2289) #5072's line-limit check (Actions run 41720959358) has been pending since 2026-11-03T21:20:49Z and stayed pending through a 5-minute poll this shift; the Codex re-review of head 13cb9d2 has not arrived yet. The Codex P2 finding on the previous head was fixed in 13cb9d2 and dispositioned on its thread (comment 4460579136); targeted tests were recorded passed at the prior stage (in-memory 44/44, live 8/8).
Expectation: on resume, recheck the check + Codex review of head 13cb9d2; merge PR feat(id/currency_poc): bind LedgerBackend to the official TigerBeetle Rust client (#2289) #5072 when green and complete task 8190 as fixed_merged.
Links: PR feat(id/currency_poc): bind LedgerBackend to the official TigerBeetle Rust client (#2289) #5072; branch queue/8190-2289-tigerbeetle-client-binding

Merge pull request #5072 from developing-today/queue/8190-2289-tigerb…

🤖 Agent note · done

Agent: queue worker (repo-worker-code), lane code-f
Session / ID: task 8190
Found via: queue claim (resume)
Task: task 8190 complete — PR feat(id/currency_poc): bind LedgerBackend to the official TigerBeetle Rust client (#2289) #5072 merged; results below; issue id: PoC: conversion executor — linked transfer pairs, write-ahead intent, recovery scanner #2289 closes on its acceptance
Expectation: done
Links: PR feat(id/currency_poc): bind LedgerBackend to the official TigerBeetle Rust client (#2289) #5072 (merge d99399c), issue id: design: conversion engine — linked transfer pairs, rate authorisation, liquidity accounts #2063

Results — LedgerBackend over the official TigerBeetle Rust client (task 8190)

PR #5072 merged (d99399c): LedgerBackend is bound to the official TigerBeetle Rust client and the currency_poc scenario suite runs against the live single-replica harness cluster (binary pinned 0.17.9), not only the in-memory backend.

Tests (laptop, prior claims of task 8190): live suite 8/8 serial — including live_same_request_twice_posts_once — and in-memory suite 44/44. Posted conversion legs are findable by user_data_128 on the live cluster; atomic-failure and crash-recovery scenarios pass.
Codex gate: all findings dispositioned — four P2s on the first head fixed in ecf15d3, the P1 design-record finding fixed in 082158d (dated design record added), the final P2 (linked-chain retry) fixed in 13cb9d2; Codex's review of head 13cb9d2 completed with no findings.
CI note: the basic line-limit check sat queued from 21:20Z without starting (infra queue stall, not a failure); the merge proceeded under the standing merge authority (verified tests + Codex clean + diff matches intent; PRs do not wait for CI in this repo's current regime).

Acceptance of issue #2289 is now fully met: (1) posted conversion against a real TigerBeetle test cluster with legs findable by user_data_128; (2) atomic-failure and crash-recovery tests; (3) results linked from issue #2063 (note posted there in the same pass). Closing issue #2289.

Navigation Menu

Repository navigation

id: PoC: conversion executor — linked transfer pairs, write-ahead intent, recovery scanner #2289

125 remaining items

Results — LedgerBackend over the official TigerBeetle Rust client (task 8190)

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

id: PoC: conversion executor — linked transfer pairs, write-ahead intent, recovery scanner #2289

Description

Activity

developing-today commented on Oct 29, 2026

dezren39 commented on Nov 1, 2026

dezren39 commented on Nov 1, 2026

125 remaining items

dezren39 commented on Nov 3, 2026

dezren39 commented on Nov 3, 2026

dezren39 commented on Nov 3, 2026

Results — LedgerBackend over the official TigerBeetle Rust client (task 8190)

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions