add pyth patterns info in the pyth-connector example #828

masterjedy · 2025-09-01T23:12:04Z

Description

Provides short description of pyth data flow patterns used in pyth connector example and EVAA code.

Type of Change

documentation

Areas Affected

price_feeds / use-real-time-data / ton.mdx

Checklist

I ran pre-commit run --all-files to check for linting errors
I have reviewed my changes for clarity and accuracy
All links are valid and working
Images (if any) are properly formatted and include alt text
Code examples (if any) are complete and functional
Content follows the established style guide
Changes are properly formatted in Markdown
Preview renders correctly in development environment

Related Issues

Closes #

Additional Notes

Contributor Information

Evaa protocol employee

Name: Yura Zarudniy
Email: yura.zarudny@gmail.com

Screenshots

Signed-off-by: master_jedy <yura.zarudny@gmail.com>

vercel · 2025-09-01T23:12:08Z

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

Project	Deployment	Preview	Comments	Updated (UTC)
docs	Ready	Preview	Comment	Sep 6, 2025 0:46am
documentation	Error			Sep 6, 2025 0:46am

vercel · 2025-09-01T23:12:10Z

@masterjedy is attempting to deploy a commit to the Pyth Network Team on Vercel.

A member of the Team first needs to authorize it.

Signed-off-by: master_jedy <yura.zarudny@gmail.com>

nidhi-singh02 · 2025-09-03T09:38:20Z

pages/price-feeds/use-real-time-data/ton.mdx

@@ -124,6 +124,28 @@ This code snippet does the following:
 4. Prepares the update data and calculates the update fee.
 5. Updates the price feeds on the TON contract.

+When providing Pyth data to your contract, there are typically two main scenarios: either you call a method supplying TON, or you transfer jettons.
+
+They both are demonstrated in the [Pyth Connector example](https://github.com/pyth-network/pyth-examples/tree/main/price_feeds/ton/pyth-connector). 


This url is giving me 404, will have to wait for this to get merged. Else we will have broken url.

Yes, it's not merged yet.

since the example is not merged yet I can't add links to the code, so I only described the same patterns using EVAA code samples and diagrams

I feel we should add links to Pyth-connector as well, that would be useful.

nidhi-singh02 · 2025-09-03T09:39:54Z

pages/price-feeds/use-real-time-data/ton.mdx

@@ -124,6 +124,28 @@ This code snippet does the following:
 4. Prepares the update data and calculates the update fee.
 5. Updates the price feeds on the TON contract.

+When providing Pyth data to your contract, there are typically two main scenarios: either you call a method supplying TON, or you transfer jettons.


Can we refer to the exact connector code block that shows these two scenarios ? That would help folks in better understanding.

connector is not merged yet, I used EVAA code for describing, pls take a look if it's ok.

pages/price-feeds/use-real-time-data/ton.mdx

Signed-off-by: master_jedy <yura.zarudny@gmail.com>

nidhi-singh02 · 2025-09-06T10:50:08Z

pages/price-feeds/use-real-time-data/ton.mdx

+  participant "U" as "User"
+  participant "P" as "Pyth Contract"
+


The double quotes can be removed from here. Else these are coming in the diagram.

nidhi-singh02 · 2025-09-06T10:50:28Z

pages/price-feeds/use-real-time-data/ton.mdx

+  participant "U" as "User"
+  participant "JW" as "Jetton Wallet"
+  participant "M" as "EVAA Master"
+  participant "P" as "Pyth Contract"


remove double quotes

nidhi-singh02

pre-commit is failing, please fix it.

nidhi-singh02 · 2025-09-06T10:51:02Z

pages/price-feeds/use-real-time-data/ton.mdx

+  participant "U" as "User"
+  participant "JW" as "Jetton Wallet"
+  participant "M" as "EVAA Master"
+  participant "P" as "Pyth Contract"


remove double quotes

nidhi-singh02 · 2025-09-06T10:53:47Z

pages/price-feeds/use-real-time-data/ton.mdx

+- **Jetton on-chain getter**: `User → Jetton Wallet → EVAA Master → Pyth → EVAA Master → ... (further processing)`  
+In this pattern, your contract first receives the Pyth data, then forwards it to the Pyth contract for validation, and finally gets the validated prices back. 
+This approach is useful when you want to transfer jettons to your contract while also providing price data.
+  *Note: This diagram is simplified. In reality, the "Jetton Wallet" step consists of a sequence of transactions: User's jetton wallet → EVAA jetton wallet → EVAA master. These internal details are omitted here to highlight the main flow and the interaction with Pyth.*


nit: Can say the data flow instead of diagram

ok, replaced

nidhi-singh02 · 2025-09-06T10:56:01Z

pages/price-feeds/use-real-time-data/ton.mdx

+This approach is useful when you want to transfer jettons to your contract while also providing price data.
+  *Note: This diagram is simplified. In reality, the "Jetton Wallet" step consists of a sequence of transactions: User's jetton wallet → EVAA jetton wallet → EVAA master. These internal details are omitted here to highlight the main flow and the interaction with Pyth.*


Note not coming properly, pls use
import { Callout } from "nextra/components"; <Callout type="info" emoji="ℹ️"> </Callout>

ok, will try it

replaced with Callout, it looks better.

nidhi-singh02 · 2025-09-06T10:59:03Z

pages/price-feeds/use-real-time-data/ton.mdx

@@ -124,6 +124,112 @@ This code snippet does the following:
 4. Prepares the update data and calculates the update fee.
 5. Updates the price feeds on the TON contract.

+
+# Patterns for Providing Pyth Data to Your Contract


make it ## as it one level below How to Use Real-Time Data in TON Contracts

nidhi-singh02 · 2025-09-06T10:59:45Z

pages/price-feeds/use-real-time-data/ton.mdx

+
+Each operation described above can result in either a successful outcome or an error. It is important to consider and handle both scenarios for every pattern.
+
+## Pyth proxy: Success


make it ### as all these are coming in the navigation bar.

nidhi-singh02 · 2025-09-06T10:59:51Z

pages/price-feeds/use-real-time-data/ton.mdx

+  - [Pyth proxy: liquidate (TON) in master.fc](https://github.com/evaafi/contracts/blob/d9138cb24f03b53522774351aceb38c51a047eee/contracts/master.fc#L171-L190)
+
+
+## Pyth proxy: Error handling


make it ### as all these are coming in the navigation bar.

nidhi-singh02 · 2025-09-06T10:59:58Z

pages/price-feeds/use-real-time-data/ton.mdx

+```
+
+
+## Pyth onchain-getter: Success


make it ### as all these are coming in the navigation bar.

nidhi-singh02 · 2025-09-06T11:00:06Z

pages/price-feeds/use-real-time-data/ton.mdx

+  - [Request to Pyth (liquidate jetton)](https://github.com/evaafi/contracts/blob/d9138cb24f03b53522774351aceb38c51a047eee/contracts/core/master-liquidate.fc#L728-L742)
+  - [Request to Pyth (supply_withdraw jetton)](https://github.com/evaafi/contracts/blob/d9138cb24f03b53522774351aceb38c51a047eee/contracts/core/master-supply-withdrawal.fc#L446-L461)
+
+## Pyth onchain-getter: Pyth error


make it ### as all these are coming in the navigation bar.

nidhi-singh02 · 2025-09-06T11:05:33Z

Thanks @masterjedy for these diagrams. they look great!

Signed-off-by: master_jedy <yura.zarudny@gmail.com>

add pyth patterns info

eff9a2d

Signed-off-by: master_jedy <yura.zarudny@gmail.com>

vercel bot had a problem deploying to Preview – documentation September 1, 2025 23:12 Failure

fix minor issues

5e32248

Signed-off-by: master_jedy <yura.zarudny@gmail.com>

vercel bot had a problem deploying to Preview – documentation September 2, 2025 12:32 Failure

nidhi-singh02 self-requested a review September 2, 2025 12:39

nidhi-singh02 reviewed Sep 3, 2025

View reviewed changes

nidhi-singh02 requested changes Sep 3, 2025

View reviewed changes

pages/price-feeds/use-real-time-data/ton.mdx Outdated Show resolved Hide resolved

add more info about patterns

16ed2bf

Signed-off-by: master_jedy <yura.zarudny@gmail.com>

vercel bot had a problem deploying to Preview – documentation September 4, 2025 14:29 Failure

minor fix

ce855c0

Signed-off-by: master_jedy <yura.zarudny@gmail.com>

vercel bot had a problem deploying to Preview – documentation September 4, 2025 14:38 Failure

masterjedy requested a review from nidhi-singh02 September 4, 2025 19:09

vercel bot deployed to Preview – docs September 6, 2025 10:38 View deployment

nidhi-singh02 reviewed Sep 6, 2025

View reviewed changes

nidhi-singh02 requested changes Sep 6, 2025

View reviewed changes

fix review issues

41c0c96

Signed-off-by: master_jedy <yura.zarudny@gmail.com>

vercel bot had a problem deploying to Preview – documentation September 6, 2025 12:34 Failure

remove trailing whitespaces

d254752

Signed-off-by: master_jedy <yura.zarudny@gmail.com>

vercel bot had a problem deploying to Preview – documentation September 6, 2025 12:46 Failure

masterjedy requested a review from nidhi-singh02 September 6, 2025 12:47

		This approach is useful when you want to transfer jettons to your contract while also providing price data.
		Note: This diagram is simplified. In reality, the "Jetton Wallet" step consists of a sequence of transactions: User's jetton wallet → EVAA jetton wallet → EVAA master. These internal details are omitted here to highlight the main flow and the interaction with Pyth.


		Each operation described above can result in either a successful outcome or an error. It is important to consider and handle both scenarios for every pattern.

		## Pyth proxy: Success

		- [Pyth proxy: liquidate (TON) in master.fc](https://github.com/evaafi/contracts/blob/d9138cb24f03b53522774351aceb38c51a047eee/contracts/master.fc#L171-L190)


		## Pyth proxy: Error handling

add pyth patterns info in the pyth-connector example #828

Are you sure you want to change the base?

add pyth patterns info in the pyth-connector example #828

Uh oh!

Conversation

masterjedy commented Sep 1, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Type of Change

Areas Affected

Checklist

Related Issues

Additional Notes

Contributor Information

Screenshots

Uh oh!

vercel bot commented Sep 1, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

vercel bot commented Sep 1, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

nidhi-singh02 left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

masterjedy commented Sep 1, 2025 •

edited

Loading

vercel bot commented Sep 1, 2025 •

edited

Loading