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

🚀 Attention Developers! 🚀

We’re excited to announce a powerful new addition to our API documentation:

🌟 Stats & Vaults API Endpoints 🌟

Now, effortlessly manage and track referral fees through our intuitive REST API endpoints available for both STON.fi DEX v1 and v2.

🔥 Highlights:
• Unified Fee Visibility: Easily view accrued referral fees and withdrawals without complex on-chain interactions.
• Comprehensive Tracking: API endpoints offer detailed fee accrual history, withdrawal records, and aggregated fee metrics in USD.

🔗 Key Endpoints:
• GET /v1/wallets/{addr_str}/fee_vaults (DEX v2 only; vault listings not applicable for v1) – Lists all known vaults per referrer.
• GET /v1/stats/fee_accruals – Retrieves fee accrual operations, filterable by time.
• GET /v1/stats/fee_withdrawals – Provides withdrawal records from referrer vaults, filterable by time.
• GET /v1/stats/fees – Summarizes aggregated referral fee metrics by chosen periods.

📚 Explore these new endpoints:
• STON.fi DEX v2 Documentation
• STON.fi DEX v1 Documentation
• API Reference v1
• API Reference v2

✨ For an all-in-one resource, check out our comprehensive Omniston Referral Fees Guide.

Your insights matter—share your feedback and let’s keep enhancing our platform together!

⸻

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

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube

Attention Devs! 🚀

We’re thrilled to announce another exciting addition to our developer docs:

STON.fi Liquidity Provision Quickstart Guide 🌊✨

This beginner-friendly, step-by-step tutorial guides you through creating a React-based app for providing liquidity using the powerful STON.fi SDK and API. Effortlessly integrate wallet connectivity with TonConnect, fetch available tokens, simulate liquidity provisions, and execute on-chain transactions smoothly.

Highlights include:
• Seamless wallet integration with @tonconnect/ui-react
• Quick project setup with React, Vite, and Tailwind CSS
• Token fetching and liquidity simulation using @ston-fi/api
• Easy transaction building and execution with @ston-fi/sdk
• Clear instructions and practical code snippets for minimal setup effort

⚠️ Note: This quickstart is optimized for ease and clarity—perfect for beginners diving into liquidity provision on TON.

Dive into the guide, gain practical skills, and master liquidity provisioning today:

👉 STON.fi Liquidity Provision Quickstart Guide

Your insights and feedback help us shape the future of STON.fi. Let’s build together!

⸻

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

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube

🗿 Free Developer Workshop: From Zero to LP on STON.fi

Stonfiers! Join us for a hands-on coding workshop designed for developers ready to dive into DeFi liquidity provision.

When: Thursday, June 19 | 2:00 PM — 3:00 PM UTC

💻 What you'll learn:
• Set up and initialize the STONfi SDK for LP operations
• Add liquidity and mint LP tokens with real code examples
• Live debugging and testing strategies
• Modern AI-assisted coding techniques for DeFi


This workshop is perfect for junior developers or anyone new to DeFi who wants practical experience earning trading fees through liquidity provision on our protocol.

📚 Pre-workshop prep: Review our Liquidity Providing Guide to get familiar with the basics.

We'll walk through everything step-by-step, from SDK setup to implementation, with live guidance and Q&A throughout the session.

🔗 Register for the workshop 🔗

Stay tuned!

⸻

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

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube

🚀 Next.js SDK Demo App enhanced with Liquidity Provision

In addition to our recent Liquidity Provision Quickstart Guide, we’ve updated our example SDK Next.js app! 🚀

For those seeking a feature-rich, advanced approach, check out our enhanced Next.js demo app that:
• Uses Next.js as a scalable, production-ready framework.
• Implements hooks and providers for elegant, maintainable architecture.
• Showcases robust error handling, advanced state management, and expanded STON.fi features.

Dive into the code on GitHub:
👉 STON.fi SDK Next.js Demo App

Or see it live in action:
🌐 SDK Demo App

Explore, experiment, and elevate your liquidity provisioning experience today! ✨

Your feedback helps us continually improve. Let’s build the future of DeFi together!


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

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube

🚀 Attention Developers! Omniston v1beta7 is Now Live! 🚀

We’re excited to announce that Omniston API v1beta7 is officially released to production, bringing significant enhancements and new capabilities to elevate your integrations.

✨ Release Highlights:
• Full backward compatibility with v1beta6
• Seamless support for mintless token swaps
• Swap transaction emulation for testing and verification
• Advanced Sandwich attack protection
• Complete support for TonCo swaps
• Powerful cross-DEX swaps: Integrate effortlessly across StonFi V1, StonFi V2, DeDust, and TonCo providers
• Improved responsiveness with automatic NoQuote event triggered after 15 seconds
• Robust stability improvements and bug fixes

💡 Why it Matters:
Omniston continues to simplify liquidity aggregation by expanding swap capabilities, security, and interoperability across multiple decentralized exchanges—all accessible through one unified API.

🔗 Dive into the latest API details here:
👉 Omniston API Documentation

Your feedback shapes our future—let’s keep building together! 🔥


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

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube