STON.fi Dev Announcements

Attention Devs! 🚀

We're excited to announce a brand-new addition to our developer docs:

Omniston Quickstart Guide 🌐✨

This beginner-friendly, step-by-step tutorial walks you through building a token swap app leveraging the powerful Omniston protocol. Effortlessly integrate wallet connectivity with TonConnect, fetch real-time swap quotes across multiple DEXes (STON.fi V1 & V2, DeDust, and more), and execute token swaps seamlessly in your React app.

Highlights include:
- Easy wallet integration using @tonconnect/ui-react
- Quick setup using React + Vite and Tailwind CSS
- Real-time quote fetching and trade tracking with @ston-fi/omniston-sdk-react
- Clear instructions and practical code snippets for minimal setup effort

⚠️ Note: Omniston is currently in beta and enforces a swap limit of up to $1k to reduce potential risks during this phase.

Jump into the guide, get hands-on experience, and unlock cross-DEX swaps today:

👉 Omniston Quickstart Guide

Your feedback is essential as we refine Omniston—happy coding! 🔥

And if you're looking for a more advanced approach with robust state management, error handling, and additional features, check out our comprehensive Next.js example app:

👉 Omniston Next.js Demo App

Your feedback shapes the future of Omniston. Let's build together!

---


DEX | Dev docs | AI docs assistant | Guide | Blog | All Links

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube

STON.fi Dev Announcements pinned «Attention Devs! 🚀 We’ve just deployed the Omniston Sandbox—a dedicated testing environment for those interested or currently developing to be Resolvers. This sandbox provides you with a safe, easy-to-use playground to explore Omniston features and integrations.…»

Attention Devs! 🚀

We’ve just deployed the Omniston Sandbox—a dedicated testing environment for those interested or currently developing to be Resolvers. This sandbox provides you with a safe, easy-to-use playground to explore Omniston features and integrations.

🔗 Demo site:
👉 omniston-sandbox.ston.fi

🛠 WS API:
wss://omni-ws-sandbox.ston.fi

🛠 gRPC API:
omni-grpc-sandbox.ston.fi

📚 Documentation:
👉Omniston Integration Docs

We're also actively working on a Quickstart Guide for Omniston integrators—coming soon! It will offer a straightforward, step-by-step approach to quickly get you up

---

Your insights help us continually improve. Happy testing!

DEX | Dev docs | AI docs assistant | Guide | Blog | All Links

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube

STON.fi Dev Announcements pinned «Attention Devs! 🚀 We’ve just added two new pages to the STON.fi docs: 1. Quickstart Guides – A new section packed with beginner-friendly, step-by-step tutorials to help you integrate STON.fi features effortlessly. 2. Swap Guide – A hands-on guide to building…»

Attention Devs! 🚀

We’ve just added two new pages to the STON.fi docs:

1. Quickstart Guides – A new section packed with beginner-friendly, step-by-step tutorials to help you integrate STON.fi features effortlessly.
2. Swap Guide – A hands-on guide to building a simple token swap interface using React, TonConnect, and the STON.fi SDK + API.

These tutorials are dedicated to devs who have never integrated STON.fi before or have some issues with integration. Each one includes clear instructions and code snippets to help you get your hands dirty.

Check out the new guides and let us know what you think:
👉 Quickstart Guides
👉 Swap Guide

---

For those seeking a feature-rich, more advanced approach, we also have a Next.js Demo App that:
- Uses Next.js for a scalable framework
- Utilizes hooks and providers for an elegant architecture
- Demonstrates better error handling, robust state management, and additional STON.fi features

Explore the repo or see the live demo:
👉 STON.fi SDK Next.js Example App Repo
👉 SDK Demo App

As always, your feedback helps us improve. Happy coding!

DEX | Dev docs | AI docs assistant | Guide | Blog | All Links

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube

STON.fi Dev Announcements pinned «🚀 Introducing AI-Powered Tools for STON.fi Developers! 🚀 We are introducing two AI-powered tools designed to assist developers integrating STON.fi: 1️⃣ STON.fi Docs Assistant: A custom GPT model accessible at https://chatgpt.com/g/g-67496f0e310c8191…»

🚀 Introducing AI-Powered Tools for STON.fi Developers! 🚀

We are introducing two AI-powered tools designed to assist developers integrating STON.fi:

1️⃣ STON.fi Docs Assistant:
A custom GPT model accessible at
https://chatgpt.com/g/g-67496f0e310c81919f72c3ea4c120b6f-ston-fi-docs-assistant
This assistant can help answer general questions, such as
“How to integrate STON.fi with my smart contract.”

2️⃣ AI Search Feature in Documentation:
Available on our docs page. Use the search bar at the top right to enter specific queries, like
“What is the exit code for swap OK?”
Then, click “Find the answer with AI” to receive an answer along with a reference to the relevant section in the documentation.

⚠️ Please note: These tools are in early beta stages and may occasionally provide inaccurate information. We recommend verifying the answers by consulting the official documentation directly. While these AI helpers are not guaranteed to be 100% accurate, they can offer guidance and potential solutions to issues you may encounter during development.

STON.fi Dev Announcements pinned «🚀 Announcement: Omni API v1beta6 Deployed 🚀 Hello, Builders! We’re excited to share that Omni API v1beta6 was deployed to production last night (19.02). Please review the latest protocol changes (detailed in our previous posts) and update your integrations…»

🚀 Announcement: Omni API v1beta6 Deployed 🚀

Hello, Builders!

We’re excited to share that Omni API v1beta6 was deployed to production last night (19.02).
Please review the latest protocol changes (detailed in our previous posts) and update your integrations to ensure a smooth transition.

If you have any questions or run into issues, feel free to reach out.

Happy building! 🔧⚡

STON.fi Dev Announcements pinned «Omniston Proto Update: New SDK Released & API Launch on 19.02 Hello, Builders! We're excited to announce that our updated Omniston SDK—featuring the latest enhancements to our proto definitions—is now available! These improvements enhance our protocol’s…»

Omniston Proto Update: New SDK Released & API Launch on 19.02

Hello, Builders!

We're excited to announce that our updated Omniston SDK—featuring the latest enhancements to our proto definitions—is now available! These improvements enhance our protocol’s consistency and streamline transaction building. If you haven't already, be sure to review our refreshed documentation and the newly updated changelog to get up to speed:

- SDK Changelog: https://github.com/ston-fi/omniston-sdk/blob/main/CHANGELOG.md#12-02-2025

---

What’s New?

1. New Omniston SDK (v0.4.0)
- omniston-sdk 0.4.0 https://www.npmjs.com/package/@ston-fi/omniston-sdk/v/0.4.0
- Supports the v1beta6 Omniston API.
- See examples of the updated SDK usage in our docs.
- omniston-sdk-react 0.4.0 https://www.npmjs.com/package/@ston-fi/omniston-sdk-react/v/0.4.0
- Also supports the v1beta6 Omniston API.
- Docs have been refreshed with usage examples.

2. Updated SDK Documentation
- Our docs have been fully refreshed to align with the proto-level changes.
- Visit the developer section for the latest guidance:
https://docs.ston.fi/docs/developer-section/omniston

3. API Launch Date Confirmed: 19.02
- We’re thrilled to confirm the new Omniston API will officially launch on 19.02 (next Wednesday).
- This release will allow you to integrate the updated functionality with the v1beta6 API.

---

Important
- API Breaking Changes: The Omniston SDK v0.4 packages only work with the v1beta6 API.
- v1beta5 to v1beta6 changes are not backward compatible.
- The overview of these changes can be found in our announcement posts and in the Omniston API repo.

Warning
- The current wss://omni-ws.ston.fi API still uses v1beta5.
- The v1beta6 API release is scheduled for 19.02.
- Please follow our announcements to stay updated and avoid integration issues.

---

Action Items

- Review the Docs & Changelog: Familiarize yourself with the updated SDK documentation and the new proto changes.
- Update Your Integrations: Migrate your projects to omniston-sdk@0.4.0 or omniston-sdk-react@0.4.0 to ensure compatibility with the upcoming v1beta6 API.
- Stay Tuned: We’ll post another announcement as soon as the v1beta6 API is fully live on 19.02.

If you have any questions or need further assistance, please reach out to our team.

Happy Building!

STON.fi Dev Announcements pinned «Omniston Proto Update: SDK Docs and Upcoming Release Hello, Builders! We recently announced important updates to our Omnistone proto definitions—these changes enhance our protocol's consistency and reduce complexities in transaction building. If you haven't…»

Omniston Proto Update: SDK Docs and Upcoming Release

Hello, Builders!

We recently announced important updates to our Omnistone proto definitions—these changes enhance our protocol's consistency and reduce complexities in transaction building. If you haven't already, be sure to review the details in our previous announcement to understand which fields, messages, and files have been modified or removed.

---

What's New?

1. Updated SDK Documentation
- We've just refreshed our documentation to help you integrate these proto-level changes.
- Visit the developer section for the latest guidance: https://docs.ston.fi/docs/developer-section/omniston

2. Next Steps: SDK Release
- We'll soon bump the SDK version to officially include these proto updates.
- Once published, you'll be able to pull down the new release and seamlessly integrate the updated code.

---

Action Items

- Check the Docs: Make sure to review our updated SDK documentation for a complete overview of all the changes.
- Prepare Your Integrations: Even though these are proto-level changes, start updating your references to align with the new fields and removed functionality to avoid issues when the updated SDK goes live.
- Stay Tuned: We'll provide another announcement once the new SDK version is available.

If you have any questions or need further assistance, please reach out to our team.

Happy Building!

STON.fi Dev Announcements pinned «Omniston Proto Changes Note Hello, Builders! We're excited to announce several important updates to our Omnistone protocol definitions. Please note that these are only proto changes at this time and will be integrated into the SDK soon. In the meantime,…»

Omniston Proto Changes Note

Hello, Builders!

We're excited to announce several important updates to our Omnistone protocol definitions. Please note that these are only proto changes at this time and will be integrated into the SDK soon. In the meantime, review the details below to ensure your integration logic remains compatible.

---

1. Identifier and Field Updates

• Both quote_id and rfq_id are now defined as 32-byte values.

• Quote and Trade Request Updates:
- Removed the field resolver_amount from QuoteRequestedEvent.
- Added gas_budget to Quote.
- Added outgoing_tx_hash to TrackTradeRequest.

---

2. ChunkStatus and Trade Status Modifications

• Added the field protocol.
• Removed the field result_details_json.
• Added the field tx_hash.

• Trade Status Adjustments:
- Renamed FillingTrade to Swapping.
- Removed outgoing_tx_hash from both Transferring and Swapping.
- Introduced a new status called AwaitingFill.

• BuildTransferRequest Update:
- Dropped the field max_slippage_bps.

---

3. Types and Schema Alterations

• Dropped the file condition.proto.
• Added a new message called RequestSettlementParams.

• QuoteRequest Enhancements:
- Added the field settlement_params.

• Swap Entities Adjustments:
- Removed the field extra_data_json from SwapRoute, SwapStep, and SwapChunk.
- Added new fields extra_version and extra to SwapChunk.

---

4. Resolver API Modifications

• Dropped the message TransferBodyRequestedEvent and removed its corresponding field transfer_body_requested from ResolverEvent.
• Dropped the message UpdateTransferBodyRequest and removed its corresponding field update_transfer_body from ResolverRequest.

• Transaction Building:
- Part of the API related to transaction building has been removed from the resolver.

---

5. Trader API Updates

• Dropped the file asset.proto, thereby completely removing the API for working with assets.
• Transaction Schema Revision:
- Renamed TransactionResponse to Transaction and moved it to transaction.proto.

---

Why This Matters

These changes enhance our platform's consistency, reduce complexities in transaction building, and align with our long-term API roadmap. Since these updates are only at the proto level for now, they won't immediately affect the SDK, but you should update your projects accordingly to avoid any future integration issues.

What You Need To Do

- Review your current integrations to ensure your logic reflects these updated fields and removed functionalities.
- Adjust any references to fields that have been added, removed, or renamed.

For more details and to review the updated proto definitions, please visit our GitHub repository:
https://github.com/ston-fi/omniston-api/tree/main/proto/omni/v1beta6

If you have any questions or run into any issues, please reach out to our team.

Happy building!

STON.fi Dev Announcements pinned Deleted message

STON.fi Dev Announcements pinned «New API Method We have a new API SDK method available v0.17.0 This update introduces the getPoolsByAssetPair method, allowing you to retrieve a list of pools for a given pair of assets. This was requested by the dev community and is now available in our…»

New API Method

We have a new API SDK method available v0.17.0

This update introduces the getPoolsByAssetPair method, allowing you to retrieve a list of pools for a given pair of assets.

This was requested by the dev community and is now available in our API (Docs).

Happy building.

STON.fi Dev Announcements pinned «SDK Demo App Update – Referral System Integration We have an update to our SDK demo app! In addition to showcasing swap functionality, the app fully supports the STON.fi referral system – supporting developers to manage and claim referral fees directly. …»

SDK Demo App Update – Referral System Integration

We have an update to our SDK demo app! In addition to showcasing swap functionality, the app fully supports the STON.fi referral system – supporting developers to manage and claim referral fees directly.

What’s New:

Referral Integration on Swap Page:
Define referral addresses and set referral fee percentages for swaps.

Vault Page for Fee Claims:
Switch to the Vault page, paste a pool address which the swap was made, and claim referral fees from 1 or 2 vaults.

Note: The vault function is only for v2 contracts. For v1 contracts the referral fee goes directly to the wallet as part of the swap operation.

Read more about the vault contract - link
Use deep links to claim from specific pools effortlessly. Example - link

Try it out:

Swap Demo: sdk-demo-app.ston.fi/swap
Vault Demo: sdk-demo-app.ston.fi/vault

This update streamlines referral fee management and vault interactions – enhancing developer flexibility.

We hope this improves your workflow. Any questions, feel free to reach out.