[web3buidlerz]

What this adds

The first page of a new Solutions → Finance Workflows section: one finance workflow per page, each paired with a scaffold-hbar template that runs on testnet.

Settle a trade delivery-versus-payment in one atomic transfer shows how a security leg and a stablecoin leg settle in a single native TransferTransaction, wrapped in a scheduled transaction so seller and buyer sign at different times. Both legs move together or neither does, KYC on the security is enforced by the network on both legs, and there is no escrow contract.

Section	Covers
Overview	What DvP is, why Hedera needs no escrow, actors, lifecycle diagram, stack
Set up the market	A KYC-gated security, a stablecoin, association, KYC, funding, and the audit topic
Settle a trade	Proposing the two-leg schedule with an admin key and a deadline, signing as buyer, verifying on HashScan and the mirror node
Settle at a set time	waitForExpiry: both parties sign now, the network settles at the set time by itself
Cancel or let a trade expire	ScheduleDelete by the seller; deadlines; why an unsigned set-time trade fails with INVALID_SIGNATURE and is shown as expired
What happens when a leg fails	A buyer without KYC: the schedule executes, the network rejects it, nothing moves
The audit log	Every trade event published to an HCS topic as a hash-chained entry
Trade with HashPack	One wallet against a demo counterparty, or two wallets in two browsers with live updates
Going to production	What changes for mainnet

The paired template installs with:

npx create-scaffold-hbar@latest --template web3buidlerz/hedera-finance-templates#templates/dvp-settlement

Notes for review

• Draft: the template is in review. Code snippets come from it; the page was rewritten after the template gained set-time settlement, cancellation, expiry, two-wallet trading and the HCS audit log, all tested on testnet.
• The settlement flow, the KYC rejection and repeat trades were run on testnet; the page states behaviour we observed, including the IDENTICAL_SCHEDULE_ALREADY_CREATED pitfall and the real cost of setting up a market.
• The T+1 section (waitForExpiry) is described from the scheduled-transaction docs and is not part of the template.
• "Finance Workflows" is a working name for the nav group; happy to rename or shelve it elsewhere under Solutions.

Validation

• mint broken-links — no broken links
• .github/scripts/check-mdx-compiles.js — page compiles
• .github/scripts/check-terminology.sh — no retired terms
• docs.json parses as valid JSON

[mintlify]

Preview approval required

This pull request comes from a fork, so Mintlify won't build a preview until someone with write access approves commit 944d56c.

Approve preview