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

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'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 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 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 Devs! 🚀

We’re excited to announce the launch of our Bug Bounty Program for the STON.fi DEX v2 smart contracts, featuring a total prize pool of $500,000!

Help us ensure maximum security by identifying vulnerabilities and get rewarded generously for your efforts. Our bounty will be live on two major platforms:
• Hackenproof
• Certik

🚨 Scope of Vulnerabilities:

Critical ($100,000)
• Direct theft of user funds
• Permanent freezing of funds
• Protocol insolvency

High ($20,000)
• Theft of unclaimed yield
• Ability to freeze other users’ trades
• Temporary freezing of funds

Medium ($5,000)
• Griefing attacks (damage without profit motive)

❌ Out of Scope:
• Liquidity issues, coding style improvements, gas optimization, slippage-related issues, and other non-critical impacts.

📍 Important Rules:
• All testing MUST be performed on the testnet.
• No mainnet testing, denial of service attacks, phishing attempts, or automated high-traffic testing.
• Check full rules and details carefully.

Router Testnet Address:
EQAFpeGFJQA9KqiCxXZ8J4l__vSYAxFSirSOvPHn6SSX44Dt

👉 TONSCAN Testnet Explorer

Rewards:
🎯 $5,000 - $100,000 based on severity

We have open-sourced our v2 contracts on GitHub! Check them out here:
🔗 STON.fi DEX Core v2

Happy hunting and thanks for making STON.fi safer and stronger!

⸻

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

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube

Attention DeFi Builders! 🚀

We’re thrilled to invite you to an exclusive technical deep-dive into Omniston—STON.fi’s groundbreaking liquidity aggregation protocol on the TON blockchain.

🗓️ Event Details
• Date: May 13, 2025 2 PM UTC
• Location: Online

🎙️ Meet the Experts
• Ethan Clime – Head of Developer Relations & Grant Fund
• Dawid Urbas – Developer Relations Manager

🔍 What to Expect

This session is designed for developers at all levels—from curious explorers to seasoned DeFi architects.​

Syllabus:
• Introduction to Omniston
• Overview of the Omniston SDK and its capabilities
• Step-by-step integration of token swap functionality using Omniston
• Testing and debugging your integration
• Leveraging AI to enhance the code
• Q&A session

Omniston simplifies access to decentralized liquidity by connecting various DeFi applications to the TON ecosystem, ensuring users get the best rates when swapping TON-based tokens.

Secure your spot for this insightful session:
🔗 Register for the Omniston Deep-Dive Session

Don’t miss this opportunity to elevate your DeFi development skills and be part of the future of decentralized finance on TON.

Stay tuned for more updates!

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

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube

🚀 Attention Omniston Integrators & Resolvers!

We're excited to announce that the new Omniston API update is scheduled to go live this Wednesday. The update introduces key enhancements designed for greater functionality, flexibility, and efficiency—and it's fully backward compatible with revision 1.

🆕 What's New?

🔧 Key Enhancements:

1️⃣ SettlementMethodParams Introduction

* Configure fees per settlement method with precision.
* Define assets for referrer and protocol fees.
* Set protocol fee amounts clearly in basis points.

2️⃣ Deprecation of `protocol_fee_bps`

* Transition required: Please use SettlementMethodParams moving forward.

3️⃣ Gas Excess Address in Transactions

* Specify an address for receiving unspent gas, optimizing fund management.

4️⃣ Enhanced Trade Status Response

* transfer_timestamp: Exact UTC timestamp for outgoing transfer detection.
* estimated_finish_timestamp: Provides clearer trade progress and completion updates.

5️⃣ Estimated Gas Consumption

* Omniston now provides automated gas consumption estimations, removing the need for manual calculations.

6️⃣ Deprecation of `gas_budget` in SwapRoute

* Simplifies quoting by automatically estimating gas with estimated_gas_consumption.

⚠️ Important Reminder for Resolvers:
Ensure quotes include all applicable fees from SettlementMethodParams and QuoteRequest to maintain accuracy and fairness.

🧪 Sandbox Environment Available Now!

Test these new features immediately:

* Demo Site: omniston-sandbox.ston.fi
* WS API: wss://omni-ws-sandbox.ston.fi
* gRPC API: https://omni-grpc-sandbox.ston.fi

For complete details on these updates, check out the pull request:
🔗 Omniston API Changes

Your feedback helps us continuously improve—thank you for being part of Omniston's journey!

Happy Integrating! 🔥

Omniston Team


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

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube

🚀 Omniston API Update is Now Live on Production! 🚀

We're thrilled to announce that the latest Omniston API update is now live on production, featuring key enhancements for greater functionality, efficiency, and flexibility. This release is fully backward compatible.

🔗 Production Release Commit

🔧 What's Live Now:

* SettlementMethodParams:

* Precisely configure fees per settlement method.
* Define assets for referrer and protocol fees.
* Clearly set protocol fees in basis points.

* Deprecation Notice:

* protocol_fee_bps is deprecated. Please transition to SettlementMethodParams.

* Gas Excess Address:

* Specify an address for unspent gas, optimizing fund management.

* Enhanced Trade Status:

* transferTimestamp for exact detection of outgoing transfers.
* estimatedFinishTimestamp for clearer trade progression.

* Automated Gas Estimation:

* estimatedGasConsumption automatically provided, simplifying the quoting process.

📦 Updated SDKs Available Now:

* Omniston SDK: @ston-fi/omniston-sdk
* Omniston SDK React: @ston-fi/omniston-sdk-react
* Changelog

📝 SDK Updates Include:

* buildTransfer method now supports gasExcessAddress.
* Extended Quote object fields: estimatedGasConsumption, referrerFeeAsset, protocolFeeAsset.
* Extended TradeStatus fields: transferTimestamp, estimatedFinishTimestamp.

Thanks for your continuous feedback and collaboration!

Happy Integrating! 🔥

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

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube

🚀 Attention Developers! 🚀

We're thrilled to unveil a new essential resource in our documentation:

Omniston Referral Fees Guide 🌐✨

Easily implement a unified referral fee mechanism across multiple DEXes (STON.fi V1, V2, and DeDust) through the Omniston liquidity-aggregation protocol. No need for separate integrations—Omniston simplifies it into a single, streamlined approach!

🔥 Highlights:

* Universal Referral Integration: Set your referral parameters once and receive fees seamlessly across all integrated DEXes — STON.fi DEX v1, DEX v2, and DeDust.
* Flexible Fee Configuration: Define your referral fees (0.01% to 1%) for DEX v2 and DeDust; DEX v1 fees are fixed at 0.1%.
* Efficient Fee Collection: Collect your accumulated fees using straightforward SDK calls, UI interactions, or direct contract methods, depending on the specific DEX implementation.
* Clear Documentation: Detailed instructions and explanations tailored to each supported DEX, making implementation straightforward.

💡 Why it Matters:
Omniston uniquely provides a single referral integration that works seamlessly across multiple DEXes. Avoid the complexity and overhead of implementing and managing different referral mechanisms for each exchange.

📚 Dive into the guide here:
👉 Omniston Referral Fees Guide

Your feedback is valuable—help us refine and enhance Omniston together!

---

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

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube