Skip to content

chore(mcp): rebrand native asset to "GRAM (ex. TON)"#488

Merged
Alejandbel merged 2 commits into
mainfrom
mcp-rename-ton-to-gram
Jul 8, 2026
Merged

chore(mcp): rebrand native asset to "GRAM (ex. TON)"#488
Alejandbel merged 2 commits into
mainfrom
mcp-rename-ton-to-gram

Conversation

@ArkadiyStena

@ArkadiyStena ArkadiyStena commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

What & why

Toncoin (ticker TON) was renamed to GRAM. This aligns packages/mcp with the rename by annotating every user-facing reference to the coin as "GRAM (ex. TON)", while leaving all TON Blockchain / network / protocol references untouched.

Scope

Renamed → "GRAM (ex. TON)" (the asset): balances, amounts, transfers, sends, swaps, deposits, gas, swap-pair routes, 1.5 TON1.5 GRAM.

Kept as "TON" (ecosystem / identifiers):

  • Blockchain/protocol: TON blockchain, TON network, TON DNS, TonProof / TonConnect, TON wallet/address, "In TON, a transaction is complete when…".
  • Config & providers: ~/.config/ton/config.json, TON_CONFIG_PATH, Toncenter.
  • Code identifiers / API contract (unchanged for backward compat): tool names (build_ton_transfer), types (TonTransfer), params (amountTon, tonDeposit), units (nanoTon), TON_DECIMALS, @ton/walletkit, and the literal "TON" swap selector.

First coin mention per string is annotated with (ex. TON); immediate in-sentence repeats stay GRAM for readability. Runtime value labels (e.g. `${amount} GRAM`) unchanged.

Files

  • Tool descriptions & service JSDoc/comments: src/tools/*.ts, src/services/McpWalletService.ts
  • Docs: llms.txt, README.md, USAGE_EXAMPLES.md
  • Skills: ton-balance, ton-send, ton-swap, ton-cli, ton-create-wallet, ton-xstocks

Versioning

  • Bumped @ton/mcp 0.1.15-alpha.220.1.15-alpha.23.
  • Refreshed the existing shared .changeset/rename-ton-to-gram.md (@ton/mcp patch) to reflect the "GRAM (ex. TON)" wording — no new changeset added, to avoid a double mcp bump on the next changeset version.

Verification

  • tsc --noEmit — passes
  • vitest run78/78 pass
  • No logic changed; edits are string/comment/doc text plus the version bump.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation
    • Updated wallet, transfer, swap, and onboarding guidance to consistently use GRAM (ex. TON) for the native coin.
    • Clarified balance and transaction examples, including human-readable amounts and native-unit wording.
    • Added a note that only the coin name changed; blockchain/network references remain unchanged.

Toncoin (TON) was renamed to GRAM. Annotate every user-facing coin
reference in @ton/mcp as "GRAM (ex. TON)" across tool descriptions,
README, llms.txt, USAGE_EXAMPLES, and skills.

TON Blockchain / network / DNS / TonProof / config paths, code
identifiers (tool names, TonTransfer, nanoTon, amountTon, TON_DECIMALS),
and the literal "TON" swap selector are intentionally unchanged.

Bump @ton/mcp to 0.1.15-alpha.23 and refresh the rename-ton-to-gram
changeset wording.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Jul 6, 2026

Copy link
Copy Markdown

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: f4d0cd8c-385d-43ef-98c8-b20320322ffc

📥 Commits

Reviewing files that changed from the base of the PR and between b2686a6 and 2f55ea5.

📒 Files selected for processing (18)
  • .changeset/rename-ton-to-gram.md
  • packages/mcp/README.md
  • packages/mcp/USAGE_EXAMPLES.md
  • packages/mcp/llms.txt
  • packages/mcp/package.json
  • packages/mcp/skills/ton-balance/SKILL.md
  • packages/mcp/skills/ton-cli/SKILL.md
  • packages/mcp/skills/ton-create-wallet/SKILL.md
  • packages/mcp/skills/ton-send/SKILL.md
  • packages/mcp/skills/ton-swap/SKILL.md
  • packages/mcp/skills/ton-xstocks/SKILL.md
  • packages/mcp/src/services/McpWalletService.ts
  • packages/mcp/src/tools/address-tools.ts
  • packages/mcp/src/tools/agentic-onboarding-tools.ts
  • packages/mcp/src/tools/agentic-tools.ts
  • packages/mcp/src/tools/balance-tools.ts
  • packages/mcp/src/tools/swap-tools.ts
  • packages/mcp/src/tools/transfer-tools.ts

📝 Walkthrough

Walkthrough

This PR updates terminology across the @ton/mcp package, replacing plain "TON" references with "GRAM (ex. TON)" in documentation, README, usage examples, skill files, and tool/schema descriptions and comments. No functional logic, APIs, or schema validation behavior changed. The package version was bumped.

Changes

GRAM (ex. TON) terminology update

Layer / File(s) Summary
Changeset and version bump
.changeset/rename-ton-to-gram.md, packages/mcp/package.json
Adds a changeset documenting the coin rename clarification and bumps the package version from 0.1.15-alpha.22 to 0.1.15-alpha.23.
README and llms.txt documentation
packages/mcp/README.md, packages/mcp/llms.txt
Updates tool descriptions (balance, transactions, transfers, swaps, agentic onboarding) to use "GRAM (ex. TON)" wording instead of "TON".
Usage example narratives
packages/mcp/USAGE_EXAMPLES.md
Updates example user prompts and agent responses for balance, transfer, and swap flows to reference "GRAM (ex. TON)".
Skill documentation
packages/mcp/skills/ton-balance/SKILL.md, packages/mcp/skills/ton-cli/SKILL.md, packages/mcp/skills/ton-create-wallet/SKILL.md, packages/mcp/skills/ton-send/SKILL.md, packages/mcp/skills/ton-swap/SKILL.md, packages/mcp/skills/ton-xstocks/SKILL.md
Updates skill descriptions, headings, and workflow instructions to reference "GRAM (ex. TON)" consistently.
Source code tool descriptions and comments
packages/mcp/src/services/McpWalletService.ts, packages/mcp/src/tools/*.ts
Updates JSDoc comments, Zod schema field descriptions, tool description strings, and one validation error message to use "GRAM (ex. TON)" wording, with no logic changes.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related issues

Possibly related PRs

  • ton-org/kit#463: Overlaps with the same GRAM rebranding workstream across MCP tool descriptions and comments.
  • ton-org/kit#465: Builds on the same transfer-tools schema/description strings introduced by the earlier transfer-tool refactor.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch mcp-rename-ton-to-gram

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.

@vercel

vercel Bot commented Jul 6, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
appkit-minter Ready Ready Preview, Comment Jul 8, 2026 8:03am
appkit-template Ready Ready Preview, Comment Jul 8, 2026 8:03am
kit-demo-wallet Ready Ready Preview, Comment Jul 8, 2026 8:03am

Request Review

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.

2 participants