add ton center cookbook guides #493

laviniat1996 · 2025-09-26T18:50:21Z

This adds the first two guides for the TON Center Cookbook:

wallet monitor
traces explanation

Kaladin13

More context please

Kaladin13 · 2025-10-02T10:52:00Z

ecosystem/rpc/cookbook/traces.mdx

+Traces expand a single transaction into a tree of all triggered calls, including intermediate contract executions, fees, and message flows.
+
+This recipe is useful for:
+- **Exchanges** validating deposits end-to-end  


+Bridges for indexing trace finality

Kaladin13 · 2025-10-02T10:52:40Z

ecosystem/rpc/cookbook/traces.mdx

+
+---
+
+## 1. Fetching a trace by transaction hash


Let's add more context, how we obtain this hash?

There is existing page about it in new docs, ask @Shvandre

Kaladin13 · 2025-10-02T10:53:33Z

ecosystem/rpc/cookbook/traces.mdx

+---
+
+## 2. Understanding the response
+


Let's comment on what info is inside JSON, e.g. info about all trace txs steps and state changes

Kaladin13 · 2025-10-02T10:54:18Z

ecosystem/rpc/cookbook/traces.mdx

+  import fetch from "node-fetch";
+
+  const endpoint = "https://toncenter.com/api/v3/traces";
+  const txHash = "Vy11B+AiGGrDBcGx3UiUFUJozUQ3U2yHvaATSrS03og=";


Comment about externals

anton-trunov · 2025-10-07T06:17:36Z

@laviniat1996 how is it going with this PR? it's been a while you pushed any fixes. do you need any help?

laviniat1996 · 2025-10-07T08:02:18Z

@anton-trunov I'm still working on it. Traces is quite a big topic, and I am trying to cover it as good as possible. You can expect an update today

github-actions · 2025-10-07T10:36:16Z

To fix the formatting issues:

Install necessary dependencies: npm ci
Then, run this command:

npx remark -o --silent --silently-ignore ecosystem/rpc/cookbook/traces.mdx ecosystem/rpc/cookbook/wallet-monitor.mdx

github-actions · 2025-10-09T03:56:09Z

To fix the formatting issues:

Install necessary dependencies: npm ci
Then, run this command:

npx remark -o --silent --silently-ignore ecosystem/rpc/cookbook/traces.mdx ecosystem/rpc/cookbook/wallet-monitor.mdx

github-actions · 2025-10-09T03:56:55Z

To fix the formatting issues:

Install necessary dependencies: npm ci
Then, run this command:

npx remark -o --silent --silently-ignore ecosystem/rpc/cookbook/traces.mdx ecosystem/rpc/cookbook/wallet-monitor.mdx

github-actions · 2025-10-29T04:37:34Z

To fix the formatting issues:

Install necessary dependencies: npm ci
Then, run this command:

npx remark -o --silent --silently-ignore ecosystem/rpc/cookbook/traces.mdx ecosystem/rpc/cookbook/wallet-monitor.mdx

github-actions

Thanks for the updates—there are several suggestions in ecosystem/rpc/cookbook/traces.mdx and ecosystem/rpc/cookbook/wallet-monitor.mdx. Please apply the inline suggestions to align callouts with the style guide.

github-actions · 2025-10-29T05:02:28Z

ecosystem/rpc/cookbook/traces.mdx

+<Info>
+  The examples use the public Ton Center endpoint:
+
+  ```
+  https://toncenter.com/api/v3/traces
+  ```
+
+  For production, request your own API key and use a dedicated endpoint for higher rate limits and stability.
+</Info>


[HIGH] Callout uses unsupported <Info> component (use <Aside> instead)

This callout uses <Info>…</Info>, which is not the approved admonition component. The style guide requires using <Aside> for callouts to ensure consistent rendering and accessibility. Replace <Info> with <Aside type="note"> and preserve the existing content.

Suggested change

<Info>

The examples use the public Ton Center endpoint:

```

https://toncenter.com/api/v3/traces

```

For production, request your own API key and use a dedicated endpoint for higher rate limits and stability.

</Info>

<Aside type="note" title="Endpoint">

The examples use the public Ton Center endpoint:

https://toncenter.com/api/v3/traces

For production, request your own API key and use a dedicated endpoint for higher rate limits and stability. </Aside>

Please leave a reaction 👍/👎 to this suggestion to improve future reviews for everyone!

github-actions · 2025-10-29T05:02:28Z

ecosystem/rpc/cookbook/traces.mdx

+> **Workflow tip**
+>
+> 1. **Before sending:** emulate to check success, cost, and side effects.
+> 1. **After confirmation:** fetch the on-chain trace to verify final behavior and outcomes.


[HIGH] Blockquote used as callout (use <Aside>; blockquotes not allowed for admonitions)

A Markdown blockquote is used to present a “Workflow tip” callout. The style guide forbids simulating callouts with blockquotes; admonitions must be implemented with <Aside> using an appropriate type. This ensures consistent rendering, accessibility, and tooling.

Suggested change

> **Workflow tip**

>

> 1. **Before sending:** emulate to check success, cost, and side effects.

> 1. **After confirmation:** fetch the on-chain trace to verify final behavior and outcomes.

<Aside type="tip" title="Workflow tip">

1. Before sending: emulate to check success, cost, and side effects.

1. After confirmation: fetch the on-chain trace to verify final behavior and outcomes.

</Aside>

Please leave a reaction 👍/👎 to this suggestion to improve future reviews for everyone!

github-actions · 2025-10-29T05:02:28Z

ecosystem/rpc/cookbook/traces.mdx

+- match the transaction by comparing the normalized input message.
+
+<Aside
+  type="warning"


[HIGH] Unsupported

The <Aside> uses type="warning", which is not a supported value in this codebase. The style guide allows only note, tip, caution, or danger, and explicitly disallows warning. Use type="danger" for true warnings or type="caution" for less severe cautions. See https://github.com/ton-org/docs/blob/main/contribute/style-guide-extended.mdx?plain=1#L525-L528 for the allowed type list and mapping guidance.

Suggested change

type="warning"

type="caution"

Please leave a reaction 👍/👎 to this suggestion to improve future reviews for everyone!

github-actions · 2025-10-29T05:02:28Z

ecosystem/rpc/cookbook/wallet-monitor.mdx

+<Info>
+  The examples use the public Ton Center endpoint:
+
+  ```
+  https://toncenter.com/api/v2/jsonRPC
+  ```
+
+  For production, you should request your own API key and use a dedicated endpoint for higher rate limits and stability.
+</Info>


[HIGH] Callout uses unsupported <Info> component (use <Aside> instead)

This callout also uses <Info>…</Info>. Per the style guide, callouts must use the <Aside> component to maintain consistent styling and accessibility. Convert it to <Aside type="note"> and retain the current content.

Suggested change

<Info>

The examples use the public Ton Center endpoint:

```

https://toncenter.com/api/v2/jsonRPC

```

For production, you should request your own API key and use a dedicated endpoint for higher rate limits and stability.

</Info>

<Aside type="note" title="Endpoint">

The examples use the public Ton Center endpoint:

https://toncenter.com/api/v2/jsonRPC

For production, you should request your own API key and use a dedicated endpoint for higher rate limits and stability. </Aside>

Please leave a reaction 👍/👎 to this suggestion to improve future reviews for everyone!

verytactical · 2025-10-29T09:09:52Z

/review

novusnota · 2025-10-29T11:47:49Z

Re-deployed: View deployment

anton-trunov · 2025-10-29T17:39:05Z

@laviniat1996 please fix the AI review issues

add ton center cookbook guides

1af6ff1

laviniat1996 linked an issue Sep 26, 2025 that may be closed by this pull request

[Ecosystem > RPC > TON Center Cookbook] #430

Open

mintlify bot deployed to staging September 26, 2025 18:51 View deployment

laviniat1996 self-assigned this Sep 26, 2025

laviniat1996 mentioned this pull request Sep 30, 2025

Document TonCenter Trace API #516

Open

Kaladin13 requested changes Oct 2, 2025

View reviewed changes

Merge branch 'main' into cookbook_ton_center

69e5774

mintlify bot deployed to staging October 7, 2025 10:36 View deployment

updates

aa40991

mintlify bot deployed to staging October 9, 2025 03:56 View deployment

mintlify bot deployed to staging October 9, 2025 03:57 View deployment

fix linting

b37dc9b

laviniat1996 force-pushed the cookbook_ton_center branch from a2d653d to b37dc9b Compare October 9, 2025 04:00

mintlify bot deployed to staging October 9, 2025 04:00 View deployment

mintlify bot deployed to staging October 9, 2025 04:01 View deployment

laviniat1996 requested a review from Kaladin13 October 10, 2025 02:43

mintlify bot deployed to staging October 10, 2025 02:44 View deployment

fix

c2c7b2d

laviniat1996 force-pushed the cookbook_ton_center branch from 90cc9ba to c2c7b2d Compare October 10, 2025 03:34

mintlify bot deployed to staging October 10, 2025 03:35 View deployment

remove unncecesary detail

0eedca9

mintlify bot deployed to staging October 10, 2025 03:35 View deployment

verytactical marked this pull request as draft October 10, 2025 15:38

laviniat1996 added 2 commits October 29, 2025 06:14

add exceptions to vale

e57add1

Merge remote-tracking branch 'origin/main' into cookbook_ton_center

10e86e3

laviniat1996 added 2 commits October 29, 2025 06:31

fix broken link

b45a2d7

fix second link

a87b20e

delete empty line

2a9dc4c

laviniat1996 marked this pull request as ready for review October 29, 2025 04:41

github-actions bot reviewed Oct 29, 2025

View reviewed changes

Merge branch 'main' into cookbook_ton_center

9fd4b75

Merge branch 'main' into cookbook_ton_center

54e10dd

anton-trunov marked this pull request as draft October 29, 2025 17:38

-> **Workflow tip**
->
-> 1. **Before sending:** emulate to check success, cost, and side effects.
-> 1. **After confirmation:** fetch the on-chain trace to verify final behavior and outcomes.
+<Aside type="tip" title="Workflow tip">
+. Before sending: emulate to check success, cost, and side effects.
+. After confirmation: fetch the on-chain trace to verify final behavior and outcomes.
+</Aside>

add ton center cookbook guides #493

Are you sure you want to change the base?

add ton center cookbook guides #493

Uh oh!

Conversation

laviniat1996 commented Sep 26, 2025

Uh oh!

Kaladin13 left a comment

Choose a reason for hiding this comment

Uh oh!

Kaladin13 Oct 2, 2025

Choose a reason for hiding this comment

Uh oh!

Kaladin13 Oct 2, 2025

Choose a reason for hiding this comment

Uh oh!

Kaladin13 Oct 2, 2025

Choose a reason for hiding this comment

Uh oh!

Kaladin13 Oct 2, 2025

Choose a reason for hiding this comment

Uh oh!

anton-trunov commented Oct 7, 2025

Uh oh!

laviniat1996 commented Oct 7, 2025

Uh oh!

github-actions bot commented Oct 7, 2025

Uh oh!

github-actions bot commented Oct 9, 2025

Uh oh!

github-actions bot commented Oct 9, 2025

Uh oh!

github-actions bot commented Oct 29, 2025

Uh oh!

github-actions bot left a comment

Choose a reason for hiding this comment

Uh oh!

github-actions bot Oct 29, 2025

Choose a reason for hiding this comment

[HIGH] Callout uses unsupported <Info> component (use <Aside> instead)

Uh oh!

github-actions bot Oct 29, 2025

Choose a reason for hiding this comment

[HIGH] Blockquote used as callout (use <Aside>; blockquotes not allowed for admonitions)

Uh oh!

github-actions bot Oct 29, 2025

Choose a reason for hiding this comment

[HIGH] Unsupported

Uh oh!

github-actions bot Oct 29, 2025

Choose a reason for hiding this comment

[HIGH] Callout uses unsupported <Info> component (use <Aside> instead)

Uh oh!

verytactical commented Oct 29, 2025

Uh oh!

novusnota commented Oct 29, 2025

Uh oh!

anton-trunov commented Oct 29, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

[HIGH] Callout uses unsupported `<Info>` component (use `<Aside>` instead)

[HIGH] Blockquote used as callout (use `<Aside>`; blockquotes not allowed for admonitions)

[HIGH] Callout uses unsupported `<Info>` component (use `<Aside>` instead)