Repository navigation
docs: add ATS bond issuance page under Solutions Finance Workflows - #810
Open
web3buidlerz wants to merge 6 commits into
Open
web3buidlerz wants to merge 6 commits into
web3buidlerz wants to merge 6 commits into
Conversation
This was referenced Oct 15, 2026
Contributor
Preview approval requiredThis pull request comes from a fork, so Mintlify won't build a preview until someone with write access approves commit |
web3buidlerz
marked this pull request as ready for review
October 27, 2026 13:32
web3buidlerz
marked this pull request as draft
October 27, 2026 13:41
web3buidlerz
marked this pull request as ready for review
October 27, 2026 14:09
Signed-off-by: web3buidlerz <seba@buidlerlabs.com>
Signed-off-by: web3buidlerz <seba@buidlerlabs.com>
The page taught the approach the template has just stopped using, and the reason it stopped is the part worth teaching. `simulateContract` returns the new bond's address, and keeping it looks free. But a CREATE address is computed against the state at simulation time and this factory is shared by everyone on testnet, so another deployment landing in between changes it — and an app that trusts the prediction then rejects its own successful deployment and abandons a bond it has already paid 7.4 HBAR for. The old text also said the event "only indexes the deployer, so the app takes the address from the simulation", which draws the wrong conclusion from a true fact: not being indexed means you cannot filter logs by it, not that it is unavailable. `bondAddress` is in the event's data, and so is the `bondData` the bond was created with — which is where the page's start date now comes from. Three other additions, each a thing the template now does and a reader would want to know: - what a failed read shows, and why `Not approved` / `0` is the one fallback a compliance desk must never have - that auto-creating a demo investor's account measures 607,858 gas against a plain transfer's 21,000, which is what makes each one cost about 1.1 HBAR - the decoded refusal appears in `#action-error`, not only in the activity log Signed-off-by: web3buidlerz <seba@buidlerlabs.com>
Both were mine, and both had grown into walls. Step 3 had five paragraphs, two of them long enough that the reader loses the thread before the point arrives. - The getters move into a table. A list of eight method names reads better as rows than as a sentence with commas. - The failed-read behaviour becomes a Note of four sentences instead of a paragraph of six. It is a rule, not a discussion, and the callout gives the section a visual break where it previously had none. - Auto-creation and its cost are two short sentences rather than one long one with an "it" that could have meant the account or the creation. - The deployment Warning says the same thing in one paragraph instead of two. 293 words of prose down to 178 in Step 3, 129 to 85 in the Warning; nothing removed but the repetition. Signed-off-by: web3buidlerz <seba@buidlerlabs.com>
The template now lives in the Hedera org repo, with every branch pushed and the name no longer carrying its capital I. The card and the install command point there rather than at a personal fork. Signed-off-by: web3buidlerz <seba@buidlerlabs.com>
Signed-off-by: web3buidlerz <seba@buidlerlabs.com>
web3buidlerz
force-pushed
the
docs/solutions-ats-bond
branch
2 times, most recently
from
October 27, 2026 15:06
0ed6f8c to
a973896
Compare
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this adds
A third Solutions → Finance Workflows page, paired with a scaffold-hbar template that runs on testnet.
Issue a tokenised bond with Asset Tokenization Studio issues an ERC-1400 bond through the ATS v8 testnet factory, approves the investors allowed to hold it with the bond's control list in allowlist mode, and distributes it with
issue. The learner deploys no contracts: one factory call creates the bond as a Diamond proxy over the resolver's shared logic.deployBondstructure with roles and allowlist mode, reading the bond backaddToControlList,issue, and an unapproved investor refused withAccountIsBlockedThe paired template installs with:
Validation
mint broken-links— no broken links.github/scripts/check-mdx-compiles.js— page compiles.github/scripts/check-terminology.sh— no retired termsdocs.jsonparses as valid JSON