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

🚀 Router‑Registry 0.1.0 is Live on TON Mainnet!

https://github.com/ston-fi/router-registry

Contract address: EQD___8zYJ_LeZqMQSvafsyN9VertnCZVJEdDxyhV8MODgxM

We’ve just open‑sourced an on‑chain registry contract that lets anyone verify STON.fi router contracts directly on the blockchain—no external API call required.

⸻

✨ Release Highlights
• Trust‑less router validation – call validateRouter to confirm that a given router is recognised by the ecosystem, right from your smart‑contract or script.
• Curated metadata – every approved router is stored with its version and type, giving integrators a single source of truth.
• Open‑source & MIT‑licensed – clone, audit, and contribute on GitHub.
• Admin safety rails – batched add/remove operations and two‑step admin transfer protect registry governance.
• Developer‑friendly scripts – CLI helpers (getRegistryData, addRouter, getAllRouters, & more) accelerate integration and testing.

⸻

🗣️ We Want Your Feedback
• Spin it up, try the validation flow, and tell us what’s missing.
• Docs coverage will follow; early input will shape what we write first.

Drop issues or PRs on GitHub—or ping us in https://tg-me.sbs/+i61QbicH_VU0ZGRi.
Let’s make router verification seamless for every builder on TON! 🌐🔥

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

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube

🚀 Attention Developers! Two Powerful Updates Just Landed! 🚀

We’re excited to announce two new enhancements that make Omniston swaps safer, more flexible, and more rewarding for integrators.

1️⃣ refund_address in BuildTransferRequest
You can now specify an address where funds should be returned if a transaction fails.

🔥 Highlights:
• Works today for swaps via STON.fi
• Backward-compatible – if not set, refunds go to the sender’s wallet
• Perfect for custodial flows, multi-user platforms, and escrow
• SDK support is live:
– @ston-fi/omniston-sdk v0.7.2
– @ston-fi/omniston-sdk-react v0.7.4

2️⃣ Tonco Referral Fee Support
Omniston now supports referral fees for Tonco swaps.

🔥 Highlights:
• When requesting a swap quote, provide the recipient for referral fees and the desired fee percentage
• Earn a fee on every Tonco swap you facilitate
• Fees accumulate in the Vault contract — same as with DeDust

💡 Why It Matters:
• More control over refund flows
• More revenue opportunities through Tonco referrals
• Same unified Omniston API experience you know and love

📅 Status: Both features are already live – start integrating today!

📚 Learn More:
Check out the updated Omniston API docs and example integrations for full details.


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

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube

🚀 RFQ Acknowledgments + Traceable rfq_id Are Live! 🚀

Omniston now confirms every RFQ instantly and tags all subsequent events with a deterministic ID—making multi-RFQ flows and debugging a breeze.

✨ What’s new
- Immediate QuoteRequestAck → first event in the stream with rfq_id
- Consistent IDs → rfq_id (SHA-256 hex) now included on quoteUpdated and unsubscribed
- Docs & SDKs updated → Node.js & React docs show the new flow
- Resolver guide & gRPC docs reflect the ACK-first sequence


💡 Why it matters
- Reliable tracking across retries & UI states
- Safer concurrent RFQs per user/session
- Faster support with precise correlation IDs

📅 Status: Live now—update your handlers and ship with confidence!


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

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube

🚀 Patch Release: Omniston SDK Updates Now Live! 🚀

If you recently upgraded to TON Connect v2.3.0-beta.3 or v2.3.0 (see TON Tech’s breaking-change note), we’ve released critical patches to keep things flowing smoothly:

Release (09-09-2025):
• @ston-fi/omniston-sdk@0.7.4
• @ston-fi/omniston-sdk-react@0.7.6

Why?
Yesterday’s TON Connect v2.3.0 update introduced strict request validation—empty string for optional fields now breaks integrations.

What to do:
If you're using TON Connect v2.3.0-beta.3 or stable 2.3.0 → please upgrade @ston-fi/omniston-sdk and/or @ston-fi/omniston-sdk-react to the versions above to avoid runtime errors.

Stay smooth—and swap on!

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

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube

🚀 New Public API: Staking Endpoints Are Live!

Swagger (interactive docs): https://api.ston.fi/swagger-ui/#/

New endpoints:
• GET /v1/wallets/{address}/stakes/
• GET /v1/stats/staking

Use these to fetch a wallet’s staking positions and global staking stats via REST—now supported in the JS SDK.

SDK:
• @ston-fi/api → https://www.npmjs.com/package/@ston-fi/api
• Changelog → https://github.com/ston-fi/api/blob/main/CHANGELOG.md#0250


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

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube

you asked, we deliver…

Attention Devs! 🚀

We’re excited to roll out a brand‑new addition to our developer docs:

Omniston Python Guide 🐍✨

This beginner‑friendly, step‑by‑step tutorial shows you how to build a terminal-based token swap client that routes across multiple DEXes via the Omniston protocol (STON.fi V1 & V2, DeDust, and more). Instead of a web UI and TonConnect, you’ll use a local TON wallet (via tonsdk) and submit transactions through Toncenter—all from a single Python file.

Highlights include
• Terminal-first, single-file CLI for maximum clarity (easy to copy, run, and tweak).
• Local wallet flow with tonsdk: generate/load mnemonic, deploy, sign BOCs.
• Real-time quotes over WebSockets using Omniston (RFQ), with slippage & gasless options.
• Transaction building via Omniston’s builder and broadcast with Toncenter.
• Simple config using .env and swap_config.json (endpoints, pair, amount, decimals).
• Cross‑DEX coverage through Omniston (STON.fi V1, STON.fi V2, DeDust, etc.).

⚠️ Not an official Python SDK
This guide is a high‑level reference implementation that demonstrates how to leverage Python to use Omniston. It’s optimized for learning and clarity, not production hardening. For production apps, consider our React, Node sdks or adapt this code with your own engineering standards.

🔑 Heads‑up on broadcasting
For reliable transaction submission, set TONCENTER_API_KEY in your .env. Without it, you will not be able to submit transactions to the network.

🧩 Deliberately minimal
The quickstart uses a single‑file CLI by design. You can modularize or package it later.

What you’ll build
• A Python CLI that:
• Creates or reuses a local TON wallet (tonsdk).
• Loads network/token settings from .env and swap_config.json.
• Requests an RFQ from Omniston via WebSockets.
• Builds the swap transaction and signs it locally.
• Submits the signed BOC to Toncenter.

Jump in:
👉 Omniston Python Guide
👉 Live Demo (Replit)

Your insights and feedback help us sharpen the Python experience and the Omniston protocol. Try the guide, kick the tires, and tell us what you think—let’s build together! 🔥

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

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube

🚀 STON.fi API Update — Redoc, 3 New Endpoints & Smarter Queries

📘 Redoc is live. Explore a fresh, clean, deep‑linkable view of the public API.
➡️ https://api.ston.fi/redoc

🆕 New endpoints
• transaction.action_tree — returns a flattened tree of all STON.fi actions and statuses triggered by an initial tx.
• transaction.query — look up a transaction by (wallet + query_id) or by external message hash.
• wallet.transactions.last — fetch the latest transactions for a wallet.

🔧 Upgrades to existing endpoints
• pool.query — route is now /v1/pools/query (old /v1/pool/query remains for backward compatibility). Adds:
• search_term — search by asset name/ticker/address or pool address
• sort_by — order by tvl, popularity, relevance, or pool/asset tags
• limit — return the top‑N pools
• asset.query — now supports search_term, sort_by, and limit for faster, cleaner discovery (e.g., search by name/ticker/address; sort by popularity/relevance/tags; cap to top‑N).

⚠️ Deprecation note asset.search is now soft‑deprecated — please use asset.query (/v1/assets/query) going forward.

Dive in 👉 https://api.ston.fi/redoc

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

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube

🚀 Omniston Update — Flexible Referrer Fee (opt‑in) for Better Quotes

We’ve added a new flag to help you capture sharper prices without manual tuning.

🆕 What’s new
• flexible_referrer_fee (API) / flexibleReferrerFee (SDK)
Let resolvers lower the effective referrer fee below referrerFeeBps when it improves the swap rate.
Default: false (fully backward‑compatible).

🛠️ Where it’s available
• JS/TS SDK: @ston-fi/omniston-sdk v0.7.5
• React SDK: @ston-fi/omniston-sdk-react v0.7.7

📚 Docs & examples updated
• RFQ/settlement params, request bodies and code samples now include the flag.

✏️ Quick usage

// SDK
settlementParams: {
  flexibleReferrerFee: true
}

Why it matters: more competitive quotes, higher fill rates—while keeping your referrer fee intact unless a better rate is available.

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

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube