🚀 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

🔔 Important Update — Fee-Vault Minter

We’ve deployed a new Fee-Vault Minter at EQD5TIvGT6NxphRDKX9wRUkJOHyE0VTuTGdVSGA5N_b62naH.
All new fees will be directed to this contract.

🧾 Users can claim accrued fees from the previous contracts
EQBCAUfvMMSn-WHP0bKDs4wUVOK1r55OuHJIq25_QnVFCFye and EQAAoyu0C-aMYGPVEoMfuAge2-meJWeO5KLJKrKWJAJAKXGL, as well as from the new one.

Please check updated 📚 docs


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

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube

🎥 New Video Tutorial: AI Agenting Omniston Implementation

We’ve published a step-by-step walkthrough showing how to use an AI coding agent (Gemini CLI example) to implement the Omniston React quickstart end-to-end.

▶️ Watch: here
📘 Docs: here

What’s inside:
🧰 Project scaffold → deps install → Tailwind + Vite setup
🔌 TonConnect wiring (connect button & manifest)
🔁 RFQ flow: request quote → build/send tx → track trade
🧠 Agent workflow with Gemini CLI (works similarly with Claude, Copilot, Cursor)
⚡ Tips & best practices to move from zero → swap in minutes

Try it, remix it, and tell us what you want next! 🚀

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

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube

🔔 Important Update — Fee-Vault Minter

We’ve deployed a new Fee-Vault Minter at EQCcJf2KFlH9xIx3dztytxxRFk3KQZKEYBr-f0nFIO1h3dvv.
All new fees will be directed to this contract.

🧾 Users can claim accrued fees from the previous contracts
EQBCAUfvMMSn-WHP0bKDs4wUVOK1r55OuHJIq25_QnVFCFye and EQAAoyu0C-aMYGPVEoMfuAge2-meJWeO5KLJKrKWJAJAKXGL, EQD5TIvGT6NxphRDKX9wRUkJOHyE0VTuTGdVSGA5N_b62naH, as well as from the new one.

Please check updated 📚 docs

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

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube

🚀 Omniston Widget — Plug-and-Play Swaps + Referral Fees

Drop a full Omniston-powered swap UI into any site or dApp using the @ston-fi/omniston-widget-loader npm loader or a lightweight CDN bundle. Your users get best-rate swaps, you get fees — no low-level DeFi wiring.

💼 Why it matters:

• 💸 Monetize traffic – earn 0.01%–1% referral fees on every swap.
• 🧩 Zero DEX UI to maintain – Omniston handles routing & execution.
• 🎨 On-brand – theme via CSS variables so it looks native to your app.

🧪 How to integrate:

• 📘 Docs: Start with the Omniston Widget overview and the Full Guide & Reference for CDN, npm loader, TON Connect modes, and theming.
• 🧱 Examples: Clone and remix the open-source omniston-widget-loader repo with ready-made integrations.
• 🤖 AI build (no manual coding): Use “Try it with Lovable” in the docs to auto-generate a live page with the widget already wired in.

Drop the widget in, point it at your TON Connect manifest, set your referrer, and you’ve just added a revenue-generating swap surface to your app with almost zero engineering overhead.

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

🐣 X 🤖 Discord 🌐 Reddit 🌐 LinkedIn 📹 YouTube