Financial layer dist build report

Date: 2026-03-06

Package inventory

Subfolders:

• chain/
• iso20022/
• jurisdiction/
• routing/
• settlement/

Direct runtime entrypoints observed today:

• scripts/algorand-dry-run.js
• scripts/algorand-testnet-submit.js
• scripts/kafkajs-producer-consumer-demo.js
• scripts/single-operator-e2e.js
• apps/web/src/lib/governance/topologySnapshot.ts

Current direct .js file-path dependencies:

• ../packages/financial-layer/chain/activation-policy.js
• ../packages/financial-layer/chain/adapters/algorand-adapter.js
• ../packages/financial-layer/chain/algorand-binding-seed.js
• ../packages/financial-layer/chain/anchor-envelope.js
• ../packages/financial-layer/chain/anchor-hashing.js
• ../packages/financial-layer/chain/anchor-plan.js
• ../packages/financial-layer/chain/chain-binding-registry.js
• ../packages/financial-layer/chain/orchestration/kafka-dto.js
• ../packages/financial-layer/chain/orchestration/kafka-kafkajs.js
• ../packages/financial-layer/chain/orchestration/kafka-stubs.js

Package boundary introduced

Added files:

• packages/financial-layer/package.json
• packages/financial-layer/tsconfig.json
• packages/financial-layer/index.ts

Package name:

• @kvary/financial-layer

Resolution fields:

• main -> dist/index.js
• types -> dist/index.d.ts

rootDir rationale

Chosen rootDir:

• "."

Reason:

• packages/financial-layer is not organized under src/
• the package is currently flat/subdir-based
• forcing a src/ migration in this step would be a structural rewrite, not stabilization

Public exports introduced

The new index.ts exposes a conservative surface based on already-observed usage:

• ./chain/activation-policy
• ./chain/adapters/algorand-adapter
• ./chain/algorand-binding-seed
• ./chain/anchor-envelope
• ./chain/anchor-hashing
• ./chain/anchor-namespace
• ./chain/anchor-plan
• ./chain/chain-binding-registry
• ./chain/orchestration/kafka-dto
• ./chain/orchestration/kafka-kafkajs
• ./chain/orchestration/kafka-stubs
• ./jurisdiction/GE/policy
• ./jurisdiction/policy-registry
• ./routing/scheme-map

Build validation

Commands executed:

• npm --prefix packages/financial-layer run build
• npm run build:packages
• npm exec -- node -e "require('./packages/financial-layer/dist/index.js')..."
• npm exec -- node -e "require('./packages/financial-layer/dist/chain/anchor-plan.js')..."
• npm exec -- node -e "require('./packages/financial-layer/dist/chain/orchestration/kafka-dto.js')..."

Results:

• packages/financial-layer/dist created
• packages/financial-layer/dist/index.js present
• packages/financial-layer/dist/index.d.ts present
• root package entrypoint resolved
• representative runtime-consumed modules resolved

Build output count:

• packages/financial-layer/dist: 84 files

Remaining direct file-path dependencies

Still coupled to source file paths:

• scripts/algorand-dry-run.js
• scripts/algorand-testnet-submit.js
• scripts/kafkajs-producer-consumer-demo.js
• scripts/single-operator-e2e.js
• apps/web/src/lib/governance/topologySnapshot.ts

These are intentionally unchanged in this commit.

Modules that could later redirect to package exports

Low-risk candidates because they are already in the conservative public surface:

• chain/activation-policy
• chain/adapters/algorand-adapter
• chain/algorand-binding-seed
• chain/anchor-envelope
• chain/anchor-hashing
• chain/anchor-namespace
• chain/anchor-plan
• chain/chain-binding-registry
• chain/orchestration/kafka-dto
• chain/orchestration/kafka-kafkajs
• chain/orchestration/kafka-stubs
• jurisdiction/GE/policy
• jurisdiction/policy-registry
• routing/scheme-map

Risky or manual-verification areas

Require manual verification before redirecting imports:

• apps/web/src/lib/governance/topologySnapshot.ts
  • uses direct relative file paths into the package tree
• iso20022/**
  • currently built, but not yet exposed from the package entrypoint
• routing/route-resolver.ts
• routing/institution-registry.ts
• settlement/**
  • compiled successfully, but not part of the initial public surface

Future cleanup candidates

Source JS duplicates still present under packages/financial-layer:

• count: 27
• examples:
  • packages/financial-layer/chain/activation-policy.js
  • packages/financial-layer/chain/anchor-plan.js
  • packages/financial-layer/chain/orchestration/kafka-dto.js
  • packages/financial-layer/jurisdiction/policy-registry.js
  • packages/financial-layer/routing/scheme-map.js

These remain in place until runtime coupling is redirected away from direct source file paths.