🚀 Attention STON.fi Developers!

We're thrilled to announce the release of STON.fi SDK v2.4.0, packed with critical updates to streamline your development experience.

🆕 What's New?

We've introduced two specialized Router & Pool types:

- WCPI (Weighted CPI)
- WStable (Weighted Stable)

Access them directly in your code:


import { DEX } from "@ston-fi/sdk";

// WCPI Router & Pool
const wcpiRouter = DEX.v2_2.Router.WCPI;
const wcpiPool = DEX.v2_2.Pool.WCPI;

// WStable Router & Pool
const wstableRouter = DEX.v2_2.Router.WStable;
const wstablePool = DEX.v2_2.Pool.WStable;


These new routers will become available through the API starting this Monday.

⚠️ Important Structural Changes & Migration Path

We've deprecated the generic BaseRouter and BasePool classes in favor of explicit router types. This change impacts how you call router methods:


- const swapTxParams = await DEX.Router.getSwapJettonToJettonTxParams();
+ const swapTxParams = await DEX.Router.CPI.getSwapJettonToJettonTxParams();


🚨 Action Required

We highly recommend using the dexFactory approach—it's our preferred and officially supported integration method.

- Using dexFactory? ✅ Great choice! No action required—your integration is already optimized.

- Not using dexFactory? ⚠️ Immediate update required. Generic methods like DEX.Router.build*TxParams might fail on the new pools due to insufficient gas. Please switch to using dexFactory or explicitly call methods on the specific Router types (e.g., DEX.Router.CPI.build*TxParams).

Ensure you upgrade your integration by Monday to avoid possible transaction failures due to gas issues!

Your feedback fuels our ongoing improvements—let's keep building great things together!

Happy coding! 🔥

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

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn �� YouTube

Attention STON.fi Developer Community! 🚀

We’re excited to announce two new packages crafted specifically to enhance your local testing and development workflow on STON.fi DEX:

🌐 @ston-fi/sandbox-utils

Quickly set up a robust sandbox environment to safely and efficiently test your interactions with STON.fi DEX (supports v1 & v2). Built with our community’s needs in mind, it’s now simpler than ever to validate your implementations.

🔗 Check it out on npm

🛠️ @ston-fi/blueprint-utils

Explore the internal toolkit our own team relies on—now open to our developer community! These utilities streamline your local development process and offer essential tools to accelerate your projects.

🔗 Explore it on npm

Wondering how to start? Check out practical examples directly in the GitHub repositories and see the tools in action!

Your input shapes our roadmap, helping us create better tools for everyone. Let’s build amazing things together!

Happy coding! ��

⸻

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

🐣 X 🤖 Discord 🌐 Reddit �� LinkedIn 📹 YouTube

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

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

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

🚀 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.

🚀 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! 🔧⚡

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!

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!

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!