Skip to content

docs(tutorials): add token lifecycle tutorials#154

Merged
thephez merged 3 commits into
developfrom
feat/token-tutorials-1
Jun 23, 2026
Merged

docs(tutorials): add token lifecycle tutorials#154
thephez merged 3 commits into
developfrom
feat/token-tutorials-1

Conversation

@thephez

@thephez thephez commented Jun 23, 2026

Copy link
Copy Markdown
Collaborator

Summary

Adds a new Tokens tutorial section covering the basic issuer-managed token lifecycle, following the style and tone of the existing tutorials. Code is sourced from the new 3-Tokens/ scripts in platform-tutorials and wired into the tutorial code-sync system so the embedded examples stay in sync.

New pages

Under docs/tutorials/tokens/, in lifecycle order:

  • Register a token contract — registers a contract carrying an issuer-managed token (base/max supply, owner-controlled mint and burn, history). The deeper TokenConfiguration breakdown is tucked into a collapsible dropdown so the basics stay front and center.
  • Retrieve token info — contract info, total supply, status, and identity balances.
  • Mint tokens — issues new tokens to the owner, increasing total supply.
  • Burn tokens — permanently destroys tokens, decreasing total supply.
  • Transfer tokens to an identity — moves tokens to a recipient using the transfer key.

The register, retrieve-info, and transfer pages cross-link to the matching DashMint Lab example-app sections, matching the existing contract/document tutorial pattern.

Wiring

  • New docs/tutorials/tokens.md section index (toctree + scope note); the note flags that advanced features are out of scope for this initial series.
  • tutorials/tokens added to the Tutorials toctree in docs/index.md, after Contracts and documents.
  • Five 3-Tokens/*.mjs source mappings added to scripts/tutorial-sync/tutorial-code-map.yml.
  • Regenerated _templates/sidebar-main.html.

Verification

  • sync_tutorial_code.py --check reports all five token pages MATCH their source.
  • The dropdown config descriptions were checked against the platform Rust source (TokenDistributionRules, ChangeControlRules, TokenTradeMode) for accuracy.

🤖 Generated with Claude Code

Preview build: https://dash-docs-platform--154.org.readthedocs.build/en/154/

thephez and others added 2 commits June 18, 2026 16:27
Add a Tokens tutorial section covering the issuer-managed token lifecycle on Evo SDK 4.0.0-rc.2: register a token contract, retrieve token info, mint, burn, and transfer tokens.

Wire the new pages into the tutorials toctree and sidebar, and add their source mappings to the tutorial code-sync map so the embedded examples stay in sync with platform-tutorials.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Add 'See this in an example app' tips on the register, retrieve-info, and transfer token tutorials pointing to the matching DashMint Lab sections, matching the cross-link pattern used by the contract and document tutorials.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Jun 23, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 9ec6e084-a842-4d90-81f6-0cc24ed633c6

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/token-tutorials-1

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

…dance

Note that the recipient defaults to a demo testnet identity and explain when to set RECIPIENT_ID to a second identity you control. On the register page, clarify that TOKEN_CONTRACT_ID is the published contract ID, not the token ID printed at the end.

@thephez thephez left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@coderabbitai review

@thephez thephez merged commit 07d9895 into develop Jun 23, 2026
2 checks passed
@thephez thephez deleted the feat/token-tutorials-1 branch June 23, 2026 16:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant