# Shio Historical documentation for Shio, the MEV Protocol on Sui {% hint style="danger" %} Shio wound down and permanently shut down on 12 May 2026. Proud to have led MEV infra on Sui. Until we meet again. {% endhint %} ### Overview In the rapidly evolving world of DeFi, every trade that users execute can be influenced by hidden forces like Maximal Extractable Value (MEV), which can quietly divert value from transactions. Shio was designed to protect users and protocols from losing value to MEV strategies, such as Loss-versus-Rebalancing and Sandwich attacks, while ensuring that market efficiencies benefit users directly. Prior to Shio's launch, MEV searchers were active on Sui, capturing significant value away from the ecosystem. Data from October'24 showed that MEV arbitrage profits averaged around $18,000 per day, amounting to over $6 million per year extracted from the Sui community.
As the first MEV protection solution in the Sui ecosystem, Shio was dedicated to capturing this value and redirecting it back to the community. In pursuit of this mission, Shio [partnered with leading DeFi projects](/introduction/defi-integrations) on the Sui blockchain to enhance the DeFi experience for all users. ### What is MEV? Maximal Extractable Value (MEV) refers to the profit that can be captured by strategically ordering, censoring, or inserting transactions within a blockchain. Common MEV strategies include arbitrage, sandwiching, and liquidation. ### About Shio Our focus was to: * **Protect against MEV within the Sui ecosystem.** * **Illuminate the MEV "dark forest" on Sui,** democratizing access for a broader set of searchers. * **Expose dishonest behaviors in the ecosystem** **and improve transparency**. ### Historical Benefits of Shio * **Boosted DeFi Market Efficiency:** Shio protected traders and liquidity providers by redistributing value back to the Sui ecosystem. * **Fair and Transparent MEV Access:** Shio democratized MEV, providing opportunities for a broader pool of searchers, rather than concentrating profits among searchers with infrastructure advantages (where winners are not always the ones that produce the best rebate to the ecosystem). * **Cheating Prevention:** Shio added [visibility to prevent dishonest activities](https://www.google.com/url?q=https://github.com/MystenLabs/sui/pull/18807\&sa=D\&source=docs\&ust=1730454741810127\&usg=AOvVaw2Phnx-up6m1WGobFLBMVnV), such as validators or RPC providers sandwiching user transactions. ### Sui Protocol Change ([SIP-19](https://www.google.com/url?q=https://github.com/sui-foundation/sips/pull/19\&sa=D\&source=docs\&ust=1730454799657355\&usg=AOvVaw0D3-q5IScUKuvYMzYMYQyn)) The Shio team proposed and implemented [SIP-19](https://www.google.com/url?q=https://github.com/sui-foundation/sips/pull/19\&sa=D\&source=docs\&ust=1730454799657355\&usg=AOvVaw0D3-q5IScUKuvYMzYMYQyn), which introduces "soft bundle primitives". These primitives allow transactions to be grouped and ordered without directly interfering with the Sui consensus mechanism. [SIP-19](https://www.google.com/url?q=https://github.com/sui-foundation/sips/pull/19\&sa=D\&source=docs\&ust=1730454799657355\&usg=AOvVaw0D3-q5IScUKuvYMzYMYQyn) has now been deployed across the Sui ecosystem. ### Sui Protocol Change ([SIP-45](https://github.com/sui-foundation/sips/pull/45/commits/878234a14fc710976ab37f825e104528ba063583)) The Shio team proposed and implemented [SIP-45](https://github.com/sui-foundation/sips/pull/45/commits/878234a14fc710976ab37f825e104528ba063583), which enables effective 'prioritized transaction submission' based on gas price. This allows users to land a transaction earlier by setting a higher gas, while normal transaction gas price stays untouched. This unlocks opportunities for users while generating more gas revenue to benefit the ecosystem. [SIP-45](https://github.com/sui-foundation/sips/pull/45/commits/878234a14fc710976ab37f825e104528ba063583) has now been approved and merged. # DeFi Integrations Historical list of Shio DeFi integrations before shutdown. {% hint style="danger" %} Shio permanently shut down on 12 May 2026. This page is kept as a historical reference only. {% endhint %} | Category | Protocol | Status | | ------------------------- | ----------------------------------------- | ------------------------- | | Dex, Aggregator | [Cetus](https://www.cetus.zone/) | Former integration | | Dex | [Turbos Finance](https://turbos.finance/) | Former integration | | Dex | [Kriya Finance](https://kriya.finance/) | Former integration | | Aggregator, Launchpad | [7K Aggregator](https://7k.ag) | Former integration | | Lending, Aggregator | [Navi Protocol](https://naviprotocol.io/) | Former integration | | Dex, Aggregator | [FlowX Finance](https://flowx.finance/) | Former integration | | Aggregator | [Bolt.ag](https://bolt.ag/) | Former integration | | Lending | [Suilend](https://suilend.fi/) | Former integration (Swap) | | Lending | [Scallop](https://scallop.io/) | Former integration (Swap) | | TG Trading App, Launchpad | [RaidenX](https://raidenx.io/) | Former integration | | TG Trading App | [InsiDex](https://www.insidex.trade/) | Former integration | | Perpetuals | [Sudo Finance](https://www.sudo.finance/) | Former integration (Swap) | | Wallet | [OneKey](https://onekey.so/) | Former integration | # Shio Endpoint Archived documentation for the Shio Endpoint, which is no longer active. {% hint style="danger" %} Shio wound down and permanently shut down on 12 May 2026. The Shio Endpoint is no longer active, and the URLs below are kept only for historical reference. {% endhint %} ## 💧Default Mode Before shutdown, Default Mode was a neutral and permissionless solution for users and developers to **capture MEV value from their orderflow transactions**. It enabled orderflow originators (including wallets, dApps and others) to participate in the MEV supply chain. By integrating the Shio Endpoint, selective transaction details were shared with searchers, who competed to include these transactions in a soft bundle through an auction process. RPC URL: `https://rpc.getshio.com/boost` {% hint style="danger" %} **No longer in use:** this RPC URL is inactive. Shio permanently shut down on 12 May 2026. {% endhint %} ## ⚡Fast Mode Before shutdown, Fast Mode was designed for speed-critical scenarios, allowing users to set a higher gas fee to land their transaction earlier. Fast Mode **maximized the transaction landing speed** and **supported soft bundle submission**. Shio optimized infrastructure and network quality and minimized processing overhead to ensure transactions reached validators as quickly as possible. To prioritize speed, transactions submitted through Fast Mode were not auctioned. RPC URL: `https://rpc.getshio.com/fast` {% hint style="danger" %} **No longer in use:** this RPC URL is inactive. Shio permanently shut down on 12 May 2026. {% endhint %} Learn more: [Fast Mode Integration Guide](#fast-mode-integration-guide) ## Historical Capabilities The Shio Endpoint provided users and developers with the following features and benefits while the service was live: **Protect Against Frontrunning:** Shio supported backruns only, helping safeguard users from harmful frontrunning attacks. **Low Latency:** Shio Endpoint was engineered for ultra-low latency. Using advanced routing, multi-region deployment, and optimized networking techniques, Shio aimed to ensure that soft bundles or transactions reached validators as quickly as possible. Default Mode used an auction window of just 100ms. **Earn MEV Rewards:** Developers could earn MEV kickbacks, with rewards credited to the specified address. By default, this was the sender's address unless otherwise specified. **Configurability**: Tailored to support a variety of use cases. **Resilience:** Built with fail-safe mechanisms, Shio aimed to ensure that transactions were always submitted, even during service downtimes, providing reliability under all conditions. ## Historical Usage Shio Endpoint supported diverse use cases before shutdown: ### 👨Users **For wallet users:** While Shio was live, users could switch their default endpoint to the Shio Endpoint Default Mode URL. Using the Shio Endpoint helped protect in-wallet swaps. Typically, this option appeared under **Settings>Network>Custom** or **Setting>Custom RPC**. **For dApps users**: While Shio was live, users could switch their default endpoint to the Shio Endpoint Default Mode URL above. Some DeFi apps automatically enabled Shio MEV protection. You can view the historical list of supported apps [here](/introduction/defi-integrations). For apps that **did not** enable Shio by default, users could navigate to the app's **Settings > Network > Custom RPC Endpoint** to manually update the endpoint. ### 👨‍💻Developers Developers could earn MEV rebates for their app and users through Default Mode.
Advanced: Developers could submit in-app bundles to enable more complex workflows. For instance, they could combine a user's add liquidity and swap transaction into a single bundle to prevent sniping. Note: this was only supported in Fast Mode. ### 📱Trading Bots/Apps Fast Mode gave users an edge during peak demand. It helped avoid congestion controls on hot objects, enabling users to ape into trending tokens without delays.\ \ Apps could earn MEV rebates and prevent MEV sandwiching for normal transactions through Default Mode.
### 💱Market Makers Fast Mode helped transactions land earlier by setting a higher gas fee while the Shio SDK optimized delivery.
## Historical Pricing & Rate Limit Default Mode: * Free to use, with MEV kickbacks * 10 TPS per IP/Sender Fast Mode: * No base subscription fee, with a 5% charge on the gas budget for each submitted transaction or bundle * 20 TPS per IP/Sender ## ⚡Fast Mode Integration Guide {% hint style="danger" %} Fast Mode is no longer operational. This guide is kept for historical reference only. {% endhint %} When Fast Mode was live, a **tip had to be included**, proportional to the transaction's gas budget (**5%**). For Shio to accept the transaction, users had to add a tip that was >=5% gas budget. An example transaction can be seen [here](https://suivision.xyz/txblock/6ioMJMm4fg9nciAS3FTkpg7oo44xQmmMeftRHkmSnFHa). ### Fast Mode SDK Historical setup: * Add `shio-fast-sdk@0.0.5`to your npm/yarn project. * Set `https://rpc.getshio.com/fast`as your RPC endpoint. This URL is no longer active. A full example: ```typescript import { SuiClient } from '@mysten/sui/client'; import { EstimateFee, ExecuteTransactionBlock, ExecuteBundle, AppendCoinToTip, ShioFastRpcUrl } from "shio-fast-sdk"; import { Transaction } from '@mysten/sui/transactions'; import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519'; // Initialize SUI client with Fast Mode endpoint. // Using other endpoints will result in failure. const client = new SuiClient({ url: ShioFastRpcUrl }); const keypair = Ed25519Keypair.fromSecretKey(process.env.SUI_PRIVATE_KEY as string); const address = keypair.getPublicKey().toSuiAddress(); const tx = new Transaction(); // Build your transaction as usual. // ... tx.setSender(address); // You are encouraged to set a higher gasPrice if competitions are foreseen. tx.setGasPrice(5000); // Before finishing, call EstimateFee to determine a reasonable gas_budget. // In order to use this, gasPrice MUST have already been set in the `tx`. // This is optional - you can also manually set a gas budget then add a tip that is 5% of that budget. let estimatedFee = await EstimateFee({ transaction: tx, client: client, }); tx.setGasBudget(estimatedFee.gasBudget); console.log(estimatedFee); // Add tip by using help function `AppendCoinToTip`. // Alternatively, you can also use `AppendBalanceToTip`. let tipCoins = tx.splitCoins(tx.gas, [estimatedFee.tipAmount]); AppendCoinToTip(tx, tipCoins[0], estimatedFee.tipAmount); // Build and sign the transaction. // We current do not support the use of Executor. let builtTx = await tx.build({ client: client, }); let signed = await keypair.signTransaction(builtTx); // Execute the transaction with Fast Mode. let result = await ExecuteTransactionBlock(client, signed, { showEffects: true, }); console.log(result); // Alternatively, you can submit a Soft Bundle. // Any transaction may contain a tip call. // The total tip amount must >= SUM(gas_budget)*0.05. // The function returns nothing on success so there is no execution result returned. await ExecuteBundle(client, [signed]); ``` ### JSON-RPC Methods #### shio\_tipPercentage Returned the tip percentage (in 0-100). ### Limitations When submitting more than one transaction with ExecuteBundle, Shio internally assembled a [SIP-19](https://github.com/sui-foundation/sips/blob/main/sips/sip-19.md) Soft Bundle, then submitted it to validators. Certain limitations applied: * Transactions must NOT conflict with each other when locking owned objects. Owned object locks are exclusive, which means if an owned object (such as a gas object) is shared across more than one transaction, the bundle would be rejected. * All transactions must not have been already submitted or executed by any validator. * All transactions must have the same gas price. * All transactions must write to a shared object (use a shared object as input with mutable=true). * At most 5 transactions could be submitted in a bundle. # Getting Started as a Searcher {% hint style="danger" %} Shio permanently shut down on 12 May 2026. This page is kept as a historical reference only; the Shio feed, bidding APIs, explorer, and RPC endpoints are no longer active. {% endhint %} To onboard as a searcher, you need the following modifications: * Instead of listening for new checkpoints, listen to Shio Feed (refer to [Connect to Shio Feed](/archived-searcher-guides/connect-to-shio-feed)). When an opportunity transaction triggers an auction, relevant information will be broadcasted to the Feed, which is permissionless. * Instead of submitting transaction to validators, submit Bid to Shio (refer to [Submit Bid](/archived-searcher-guides/submit-bid)), to bid against being included at desired backrun position. * In the PTB, add a MoveCall to Shio to pay exact your bid amount (refer to [Interact with Shio Contract](/archived-searcher-guides/interact-with-shio-contract)). On success, the winning Bids will be included in the same checkpoint, and most of the times right next to the opportunity. # Connect to Shio Feed {% hint style="danger" %} Shio permanently shut down on 12 May 2026. This page is kept as a historical reference only; the Shio feed, bidding APIs, explorer, and RPC endpoints are no longer active. {% endhint %} Shio Feed offered auction events in real-time. The Feed was similar to a public transaction pool but not necessarily the same. In order to prevent front-running, only execution results (Side Effects) were revealed, instead of transaction content. Historical connection steps: * Establish a WebSocket connection to the Feed URL: `wss://rpc.getshio.com/feed` (no longer active) * Once connected, searchers would receive `auctionStarted` events, example: ```json { "auctionStarted": { "txDigest": "E72mG9GCroPgaw9uoeGiKLzAfd9CZq82iGDjypKdzYG7", "gasPrice": 1000, "deadlineTimestampMs": 1724407712127, "sideEffects": { "createdObjects": [], "mutatedObjects": [ { "id": "0x5eb2dfcdd1b15d2021328258f6d5ec081e9a0cdcfa9e13a0eaeb9b5f7505ca78", "objectType": "0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1::pool::Pool<0x2::sui::SUI, 0x5d4b302506645c37ff133b98c4b50a5ae14841659738d6d733d59d0d217a93bf::coin::COIN, 0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1::fee3000bps::FEE3000BPS>", "owner": { "Shared": { "initial_shared_version": 1731023 } }, "content": { "dataType": "moveObject", "type": "0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1::pool::Pool<0x2::sui::SUI, 0x5d4b302506645c37ff133b98c4b50a5ae14841659738d6d733d59d0d217a93bf::coin::COIN, 0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1::fee3000bps::FEE3000BPS>", "hasPublicTransfer": true, "fields": { "coin_a": "2346002989765222", "coin_b": "817618609593", "deploy_time_ms": "1683216776913", "fee": 3000, "fee_growth_global_a": "62310876755876845895", "fee_growth_global_b": "54918657491646434", "fee_protocol": 300000, "id": { "id": "0x5eb2dfcdd1b15d2021328258f6d5ec081e9a0cdcfa9e13a0eaeb9b5f7505ca78" }, "liquidity": "2260963199258975", "max_liquidity_per_tick": "23012265295255187899058267899625901", "protocol_fees_a": "43074990201088", "protocol_fees_b": "36455103885", "reward_infos": [ { "type": "0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1::pool::PoolRewardInfo", "fields": { "emissions_per_second": "0", "growth_global": "7236466772288572909907", "id": { "id": "0x3002004301f7e490b3bb8501444bf732a8a05174c673840d87e1651669a6944c" }, "manager": "0x0a475e3bd09b7e38ef8e200dcf81b55630f7f8c93f4465005316002184051ea2", "vault": "0x40610ed06fb4a1c327eb2e393d6bc9105067b47d6ba3ce521b685fa2caf81cd6", "vault_coin_type": "5d1f47ea69bb0de31c313d7acf89b890dbb8991ea8e03c6c355171f84bb1ba4a::turbos::TURBOS" } }, { "type": "0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1::pool::PoolRewardInfo", "fields": { "emissions_per_second": "566470899603562006612803584", "growth_global": "73856427630746155393", "id": { "id": "0xe663f51dfb74a6594da5e4958dd1c2a2c52bb916f319b329f2730cc4e3d86071" }, "manager": "0x0a475e3bd09b7e38ef8e200dcf81b55630f7f8c93f4465005316002184051ea2", "vault": "0x197289658606f39bc61f1ce1c61d56c237bc9eb392538afb6f95272e197f0c41", "vault_coin_type": "0000000000000000000000000000000000000000000000000000000000000002::sui::SUI" } }, { "type": "0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1::pool::PoolRewardInfo", "fields": { "emissions_per_second": "0", "growth_global": "371156063495608078676", "id": { "id": "0x2a0d34f24d7b685b4b7f68724fb759e467a2563f356f7869677f1b0dc3085af9" }, "manager": "0x0a475e3bd09b7e38ef8e200dcf81b55630f7f8c93f4465005316002184051ea2", "vault": "0x8e18933f656dbec6482593025c110430f102e1fa54db06b04059ccaf0fcceca9", "vault_coin_type": "5d1f47ea69bb0de31c313d7acf89b890dbb8991ea8e03c6c355171f84bb1ba4a::turbos::TURBOS" } } ], "reward_last_updated_time_ms": "1724043071740", "sqrt_price": "537247640199413000", "tick_current_index": { "type": "0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1::i32::I32", "fields": { "bits": 4294896568 } }, "tick_map": { "type": "0x2::table::Table<0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1::i32::I32, u256>", "fields": { "id": { "id": "0xd836ea2a159743a568fe29e8f42672a1b88414ab21be5411f8f6331e66b218d3" }, "size": "16" } }, "tick_spacing": 60, "unlocked": true } }, "rawContent": "XrLfzdGxXSAhMoJY9tXsCB6aDNz6nhOg6uubX3UFynhm0thirVUIALnl3V2+AAAAAFl9LS0nAACNveR8CAAAAAi9gN7hr3QHAAAAAAAAAAC46/7/PAAAAK0B9ejQ34Ckdil3n5duBAC4CwAA4JMEAAFHGS+1RbS8YAMAAAAAAAAA4rdUXzocwwAAAAAAAAAAAF+RV4RVCAgAAAAAAAAAAADYNuoqFZdDpWj+Kej0JnKhuIQUqyG+VBH49jMeZrIY0xAAAAAAAAAA0b6J54cBAAADMAIAQwH35JCzu4UBREv3MqigUXTGc4QNh+FlFmmmlExAYQ7Qb7ShwyfrLjk9a8kQUGe0fWujzlIbaF+iyvgc1lA1ZDFmNDdlYTY5YmIwZGUzMWMzMTNkN2FjZjg5Yjg5MGRiYjg5OTFlYThlMDNjNmMzNTUxNzFmODRiYjFiYTRhOjp0dXJib3M6OlRVUkJPUwAAAAAAAAAAAAAAAAAAAABTafLJ83wmSogBAAAAAAAACkdeO9CbfjjvjiANz4G1VjD3+Mk/RGUAUxYAIYQFHqLmY/Ud+3SmWU2l5JWN0cKixSu5FvMZsynycwzE49hgcRlyiWWGBvObxh8c4cYdVsI3vJ6zklOK+2+VJy4ZfwxBSjAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDI6OnN1aTo6U1VJAAAAAAAAAADhktQBAAAAAIE5+D2fvfYABAAAAAAAAAAKR1470Jt+OO+OIA3PgbVWMPf4yT9EZQBTFgAhhAUeoioNNPJNe2hbS39ock+3WeRnolY/NW94aWd/Gw3DCFr5jhiTP2VtvsZIJZMCXBEEMPEC4fpU2wawQFnMrw/M7KlQNWQxZjQ3ZWE2OWJiMGRlMzFjMzEzZDdhY2Y4OWI4OTBkYmI4OTkxZWE4ZTAzYzZjMzU1MTcxZjg0YmIxYmE0YTo6dHVyYm9zOjpUVVJCT1MAAAAAAAAAAAAAAAAAAAAAVBEMuEc50x4UAAAAAAAAAApHXjvQm344744gDc+BtVYw9/jJP0RlAFMWACGEBR6i/JD5aJEBAAA=" } ], "gasUsage": 14523600 } } } ``` * You **MUST** respond to PingMessage with a PongMessage. Failure to do so will result in disconnection. * Searchers were not allowed to maintain more than one connection from the same IP address. Once there was one active connection, subsequent connection attempts from the same IP address would be rejected. # auctionStarted Event {% hint style="danger" %} Shio permanently shut down on 12 May 2026. This page is kept as a historical reference only; the Shio feed, bidding APIs, explorer, and RPC endpoints are no longer active. {% endhint %} Shio partnered with order flow originators to conduct auctions on incoming transactions before they were seen by others or included. An opportunity transaction was qualified when: * The transaction contains at least one shared object as input. * The transaction mutated at least one shared object. * The transaction passes dry-run against the current world state. Upon such opportunity transaction, an auction would start, with an `auctionStarted` event emitted and broadcasted. Shio did not reveal the content of the transaction, only its side effects from execution, including events and objects that had been created or mutated. Full content of all mutated or created objects was provided so that a searcher could know how the world state would change by executing that opportunity transaction. An example event: ```json { "auctionStarted": { "txDigest": "E72mG9GCroPgaw9uoeGiKLzAfd9CZq82iGDjypKdzYG7", "gasPrice": 1000, "deadlineTimestampMs": 1724407712127, "sideEffects": { "events": [ { "id": { "txDigest": "Fwk579gVYwgFzzatLoMArrcsUDUC1MfZY3KKDiu8kgYv", "eventSeq": "0" }, "packageId": "0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1", "transactionModule": "swap_router", "sender": "0x95467064654beef88fe614c64fde3442e9ea1fe588f5dc6a34ded901f912a521", "type": "0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1::pool::SwapEvent", "parsedJson": { "a_to_b": true, "amount_a": "100000000", "amount_b": "84567", "fee_amount": "300000", "is_exact_in": true, "liquidity": "2260963199258975", "pool": "0x5eb2dfcdd1b15d2021328258f6d5ec081e9a0cdcfa9e13a0eaeb9b5f7505ca78", "protocol_fee": "90000", "recipient": "0x95467064654beef88fe614c64fde3442e9ea1fe588f5dc6a34ded901f912a521", "sqrt_price": "537247640199413000", "tick_current_index": { "bits": 4294896568 }, "tick_pre_index": { "bits": 4294896568 } }, "bcs": "3QNkC7BY24vRTkQLNuStgph6rJoueLph5XBahSy5PAjZfJGPd8qcGAFA1dqaFW5CfeH12kX9bK2fBVGjhdRXqS65YDzRtonmwmFvFUpgT34uZn5iSwpQMGLhEx7wVAwDs3bg5hVEPKFbdSjDnxhxYK8M82rVuQ24GA6XV3ermPYWBdS5B8Qobv5scyFV2" } ], "createdObjects": [], "mutatedObjects": [ { "id": "0x5eb2dfcdd1b15d2021328258f6d5ec081e9a0cdcfa9e13a0eaeb9b5f7505ca78", "objectType": "0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1::pool::Pool<0x2::sui::SUI, 0x5d4b302506645c37ff133b98c4b50a5ae14841659738d6d733d59d0d217a93bf::coin::COIN, 0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1::fee3000bps::FEE3000BPS>", "owner": { "Shared": { "initial_shared_version": 1731023 } }, "content": { "dataType": "moveObject", "type": "0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1::pool::Pool<0x2::sui::SUI, 0x5d4b302506645c37ff133b98c4b50a5ae14841659738d6d733d59d0d217a93bf::coin::COIN, 0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1::fee3000bps::FEE3000BPS>", "hasPublicTransfer": true, "fields": { "coin_a": "2346002989765222", "coin_b": "817618609593", "deploy_time_ms": "1683216776913", "fee": 3000, "fee_growth_global_a": "62310876755876845895", "fee_growth_global_b": "54918657491646434", "fee_protocol": 300000, "id": { "id": "0x5eb2dfcdd1b15d2021328258f6d5ec081e9a0cdcfa9e13a0eaeb9b5f7505ca78" }, "liquidity": "2260963199258975", "max_liquidity_per_tick": "23012265295255187899058267899625901", "protocol_fees_a": "43074990201088", "protocol_fees_b": "36455103885", "reward_infos": [ { "type": "0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1::pool::PoolRewardInfo", "fields": { "emissions_per_second": "0", "growth_global": "7236466772288572909907", "id": { "id": "0x3002004301f7e490b3bb8501444bf732a8a05174c673840d87e1651669a6944c" }, "manager": "0x0a475e3bd09b7e38ef8e200dcf81b55630f7f8c93f4465005316002184051ea2", "vault": "0x40610ed06fb4a1c327eb2e393d6bc9105067b47d6ba3ce521b685fa2caf81cd6", "vault_coin_type": "5d1f47ea69bb0de31c313d7acf89b890dbb8991ea8e03c6c355171f84bb1ba4a::turbos::TURBOS" } }, { "type": "0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1::pool::PoolRewardInfo", "fields": { "emissions_per_second": "566470899603562006612803584", "growth_global": "73856427630746155393", "id": { "id": "0xe663f51dfb74a6594da5e4958dd1c2a2c52bb916f319b329f2730cc4e3d86071" }, "manager": "0x0a475e3bd09b7e38ef8e200dcf81b55630f7f8c93f4465005316002184051ea2", "vault": "0x197289658606f39bc61f1ce1c61d56c237bc9eb392538afb6f95272e197f0c41", "vault_coin_type": "0000000000000000000000000000000000000000000000000000000000000002::sui::SUI" } }, { "type": "0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1::pool::PoolRewardInfo", "fields": { "emissions_per_second": "0", "growth_global": "371156063495608078676", "id": { "id": "0x2a0d34f24d7b685b4b7f68724fb759e467a2563f356f7869677f1b0dc3085af9" }, "manager": "0x0a475e3bd09b7e38ef8e200dcf81b55630f7f8c93f4465005316002184051ea2", "vault": "0x8e18933f656dbec6482593025c110430f102e1fa54db06b04059ccaf0fcceca9", "vault_coin_type": "5d1f47ea69bb0de31c313d7acf89b890dbb8991ea8e03c6c355171f84bb1ba4a::turbos::TURBOS" } } ], "reward_last_updated_time_ms": "1724043071740", "sqrt_price": "537247640199413000", "tick_current_index": { "type": "0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1::i32::I32", "fields": { "bits": 4294896568 } }, "tick_map": { "type": "0x2::table::Table<0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1::i32::I32, u256>", "fields": { "id": { "id": "0xd836ea2a159743a568fe29e8f42672a1b88414ab21be5411f8f6331e66b218d3" }, "size": "16" } }, "tick_spacing": 60, "unlocked": true } }, "rawContent": "XrLfzdGxXSAhMoJY9tXsCB6aDNz6nhOg6uubX3UFynhm0thirVUIALnl3V2+AAAAAFl9LS0nAACNveR8CAAAAAi9gN7hr3QHAAAAAAAAAAC46/7/PAAAAK0B9ejQ34Ckdil3n5duBAC4CwAA4JMEAAFHGS+1RbS8YAMAAAAAAAAA4rdUXzocwwAAAAAAAAAAAF+RV4RVCAgAAAAAAAAAAADYNuoqFZdDpWj+Kej0JnKhuIQUqyG+VBH49jMeZrIY0xAAAAAAAAAA0b6J54cBAAADMAIAQwH35JCzu4UBREv3MqigUXTGc4QNh+FlFmmmlExAYQ7Qb7ShwyfrLjk9a8kQUGe0fWujzlIbaF+iyvgc1lA1ZDFmNDdlYTY5YmIwZGUzMWMzMTNkN2FjZjg5Yjg5MGRiYjg5OTFlYThlMDNjNmMzNTUxNzFmODRiYjFiYTRhOjp0dXJib3M6OlRVUkJPUwAAAAAAAAAAAAAAAAAAAABTafLJ83wmSogBAAAAAAAACkdeO9CbfjjvjiANz4G1VjD3+Mk/RGUAUxYAIYQFHqLmY/Ud+3SmWU2l5JWN0cKixSu5FvMZsynycwzE49hgcRlyiWWGBvObxh8c4cYdVsI3vJ6zklOK+2+VJy4ZfwxBSjAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDI6OnN1aTo6U1VJAAAAAAAAAADhktQBAAAAAIE5+D2fvfYABAAAAAAAAAAKR1470Jt+OO+OIA3PgbVWMPf4yT9EZQBTFgAhhAUeoioNNPJNe2hbS39ock+3WeRnolY/NW94aWd/Gw3DCFr5jhiTP2VtvsZIJZMCXBEEMPEC4fpU2wawQFnMrw/M7KlQNWQxZjQ3ZWE2OWJiMGRlMzFjMzEzZDdhY2Y4OWI4OTBkYmI4OTkxZWE4ZTAzYzZjMzU1MTcxZjg0YmIxYmE0YTo6dHVyYm9zOjpUVVJCT1MAAAAAAAAAAAAAAAAAAAAAVBEMuEc50x4UAAAAAAAAAApHXjvQm344744gDc+BtVYw9/jJP0RlAFMWACGEBR6i/JD5aJEBAAA=" } ], "gasUsage": 14523600 } } } ``` * `events`: Events emitted from executing the transaction. * `mutatedObjects` / `createdObjects`: * Objects that has been mutated by the opportunity transaction. Each object will carry all its fields (regardless the field has changed or not). * `rawContent`is the serialized representation of the object, which can be used as an alternative to JSON representation for faster parsing. * Object with content larger than 4KB will be omitted from transmission. Historically, searchers could use [wscat](https://github.com/websockets/wscat) or similar tools to connect to the Feed. This WebSocket endpoint is no longer active. ```bash wscat --connect wss://rpc.getshio.com/feed ``` Note that because `wscat` do not respond to PingMessage, you connection will only be maintained for a couple of minutes. # Submit Bid {% hint style="danger" %} Shio permanently shut down on 12 May 2026. This page is kept as a historical reference only; the Shio feed, bidding APIs, explorer, and RPC endpoints are no longer active. {% endhint %} Once an `auctionStarted` event had been seen, searchers could submit bids. The Bid with the highest `bid_amount` won, while paying exactly that amount. ## Conditions for a Bid to be accepted A Bid had to satisfy all conditions below in order to be accepted. * A Bid could be submitted before the given deadline (specified by `deadlineTimestampMs`). Since that window could be extremely short (usually 200-300ms), searchers were strongly recommended to host services in **Frankfurt, Germany** to avoid unnecessary round trips. * A Bid **MUST** have a lexicologically larger transaction digest compared to the opportunity transaction's. Comparison was done with the two digests' binary form (represented as 32-byte binaries), rather than base-58 encoded. This is because in the implementation of [Soft Bundle (SIP-19)](https://github.com/sui-foundation/sips/blob/main/sips/sip-19.md), Shio chose the transaction with the smallest digest to determine submission order. One way to achieve this was to keep increasing gas budget by 1, until the digest of the transaction satisfied the condition. * A bid had to have the exact `gas_price` as the opportunity transaction's. * A bid had to avoid locking any object that had already been locked by the opportunity transaction. * A bid had to contain a MoveCall to the `submit_bid` method of the Shio package, paying exactly `bid_amount`, see [Interact with Shio Contract](/archived-searcher-guides/interact-with-shio-contract). * A bid had to pass dry-run in the bundle of \[opportunity transaction, bid]. ## Bid Submission There were two ways to submit a bid: * A Bid could be submitted directly through the Feed WebSocket connection. This approach appeared to be simpler (by not having to maintain more than one client), however, in case of bid rejection, exact reason would not be returned. * Or alternatively, a bid could also be submitted through JSON-RPC method `shio_submitBid`. An error message would be returned directly, explaining why the bid had been rejected if that was the case. ### Submission through WebSocket Searchers sent a message in the following format through the Feed WebSocket connection: ```json { "oppTxDigest": "E72mG9GCroPgaw9uoeGiKLzAfd9CZq82iGDjypKdzYG7", "bidAmount": 42000000000, "txData": "base64Encoded", "sig": "base64Encoded" } ``` * `bidAmount` is in terms of MIST. This was the amount that needed to be paid on successful execution. * `txData`: Base64-encoded bcs-serialized TransactionData without signature. * `sig`: Base64-encoded signature. Shio only supported the ED25519 signature scheme. Bids had to be sent within the given Auction Window. Once sent, the bid would either be accepted or rejected; however, no response would be given. For troubleshooting, please refer to Submission through JSON-RPC . ### Submission through JSON-RPC Historically, searchers sent a JSON-RPC request to `https://rpc.getshio.com` in the following format. This endpoint is no longer active. ```json { "jsonrpc": "2.0", "id": 1, "method": "shio_submitBid", "params": [ "E72mG9GCroPgaw9uoeGiKLzAfd9CZq82iGDjypKdzYG7", 42000000000, "txDataBase64Encoded", "sigBase64Encoded" ] } ``` A response would be returned, containing error message if any. This approach was not recommended in production, as extra RTTs could be incurred due to HTTP/TLS handshake. # Simulate Bid {% hint style="danger" %} Shio permanently shut down on 12 May 2026. This page is kept as a historical reference only; the Shio feed, bidding APIs, explorer, and RPC endpoints are no longer active. {% endhint %} A Bid was not accepted if it failed to pass dry-run (against current world state + opportunity transaction). There is no consequence from bid being rejected, so it makes sense to submit as many bids as it takes if you are unsure which ones will succeed, without the need of simulating each bid. If this stands, a Simulate Bid API will be not necessary. However, when writing and testing a program, it was useful to have a way to simulate a bid rather than actually submitting it, so that it would not be included on-chain (therefore, no gas cost). Historically, to simulate a bid, searchers sent a JSON-RPC request to `https://rpc.getshio.com` in the following format. This endpoint is no longer active. ```json { "jsonrpc": "2.0", "id": 1, "method": "shio_simulateBid", "params": [ "E72mG9GCroPgaw9uoeGiKLzAfd9CZq82iGDjypKdzYG7", "txDataBase64Encoded" ] } ``` * The first parameter indicates opportunity transaction's digest. An ongoing auction for that opportunity transaction is required, so that we know what state to simulate against. * The second parameter is a Base64-encoded bcs serialized bytes of TransactionData. This is the same method of encoding as if you are using `sui_dryRunTransactionBlock`. On success, the bid's side effects would be returned (gas usage, events, created objects and mutated objects), in the same format as in `auctionStarted` event ([sideEffects field](/archived-searcher-guides/connect-to-shio-feed/auctionstarted-event)). On error, there will be detailed error message indicating what went wrong. # Interact with Shio Contract {% hint style="danger" %} Shio permanently shut down on 12 May 2026. This page is kept as a historical reference only; the Shio feed, bidding APIs, explorer, and RPC endpoints are no longer active. {% endhint %} ### Making a call We check the PTB to ensure there is at least one `submit_bid` MoveCall to Shio package. The call must be in the PTB itself, rather than being called from another module. Shio Contract exposes these methods: ```rust module shio::auctioneer { public fun submit_bid( s: &mut GlobalState, bid_amount: u64, fee: Balance, _ctx: &mut TxContext) {} } ``` * Package is deployed at `0x1889977f0fb56ae730e7bda8e8e32859ce78874458c74910d36121a81a615123`. * `submid_bid`: * `s`: A mutable reference to the global state. There are 32 such objects and you are advised to choose a random one from [the list](#global-state-objects) for each submission. * `bid_amount` : Bid amount in MIST. Make sure the number if exactly the same as in the bid. * `fee`: Balance of exactly `bid_amount`, to be consumed by the contract. You can find example transactions [here](https://suiscan.xyz/mainnet/object/0x1889977f0fb56ae730e7bda8e8e32859ce78874458c74910d36121a81a615123/txs). You can submit a test transaction with the following command invoking SUI CLI: ```sh sui client ptb \ --split-coins gas '[42]' \ --assign coins \ --move-call 'sui::coin::into_balance' coins.0 \ --assign fee \ --move-call 0x1889977f0fb56ae730e7bda8e8e32859ce78874458c74910d36121a81a615123::auctioneer::submit_bid @0xc32ce42eac951759666cbc993646b72387ec2708a2917c2c6fb7d21f00108c18 42 fee ``` ### Global State Objects To avoid object congestion should the network becomes extremely busy, we have provided 32 global state objects. For each submission, you must randomly choose one of them to use, to minimize the chance that your bid gets congestion controlled by the network. A full list of global shared objects is as follows: ```json [ { "objectId": "0xc32ce42eac951759666cbc993646b72387ec2708a2917c2c6fb7d21f00108c18", "initialSharedVersion": 72869622 }, { "objectId": "0x0289acae0edcdf1fe3aedc2e886bc23064d41c359e0179a18152a64d1c1c2b3e", "initialSharedVersion": 327637282 }, { "objectId": "0x03132160e8c2c45208abf3ccf165e82edcc42fee2e614afe54582f9740a808b8", "initialSharedVersion": 327637282 }, { "objectId": "0x072ae7307459e535379f422995a0d10132f12a3450298f8cf0cc07bd164f9999", "initialSharedVersion": 327637282 }, { "objectId": "0x1c1a96a2f4a34ea09ab15b8ff98f4b6b4338ce89f4158eb7d3eb2cd4dcbd6d86", "initialSharedVersion": 327637282 }, { "objectId": "0x20d76f37ad9f2421a9e6afaf3bb204250b1c2241c50e8a955e86a1a48767d06f", "initialSharedVersion": 327637282 }, { "objectId": "0x213ed368233cc7480fcb6336e70c5ae7ee106b2317ba02ccb5d0478e45bcc046", "initialSharedVersion": 327637282 }, { "objectId": "0x22ce1e80937354eba5549fed2937dc6e2b24026d03505bb51a3e4a64aa4142f6", "initialSharedVersion": 327637282 }, { "objectId": "0x26188cb7ce5ae633279f440f66081cb65cc585e428de18e194f8843e866f799f", "initialSharedVersion": 327637282 }, { "objectId": "0x38642f01422480128388d3e2948d3dc1b2680f9914077edb6bd3451ae1c5bcf0", "initialSharedVersion": 327637282 }, { "objectId": "0x3dd85b6424aea1cae9eff6e55456ca783e056226325f1362106eca8b3ed04ca0", "initialSharedVersion": 327637282 }, { "objectId": "0x42f8adc490542369d9c3b95e9f6eb70b2583102900feb7e103072ed49ba7fc3d", "initialSharedVersion": 327637282 }, { "objectId": "0x46b8158c82fa6bda7230d31a127d934c7295a0042083b4900f3096e9191f6f3f", "initialSharedVersion": 327637282 }, { "objectId": "0x6ebac88a8c3f7a4a9fb05ea49d188a1fe8520ae59ee736e0473004d3033512a4", "initialSharedVersion": 327637282 }, { "objectId": "0x6f55ad6cb40cfc124c11b11c19be0a80237b104acd955e7b52ccb7bf9046fe33", "initialSharedVersion": 327637282 }, { "objectId": "0x71aafb8bac986e82e5f78846bf3b36c2a82505585625207324140227a27ff279", "initialSharedVersion": 327637282 }, { "objectId": "0x7fe9b08680d4179de5672f213b863525b21f10604ca161538075e9338d1d2324", "initialSharedVersion": 327637282 }, { "objectId": "0x81538ef2909a3e0dd3d7f38bcbee191509bae4e8666272938ced295672e2ee8d", "initialSharedVersion": 327637282 }, { "objectId": "0x828eb6b3354ad68a23dd792313a16a0d888b7ea4fdb884bb22bd569f8e61319e", "initialSharedVersion": 327637282 }, { "objectId": "0x9705a332b8c1650dd7fe687ef9f9a9638afb51c30c0b34db150d60b920bc07eb", "initialSharedVersion": 327637282 }, { "objectId": "0x9918f73797a9390e9888b55454f2b31bc01de1a4634acab08f80641c4248e8a5", "initialSharedVersion": 327637282 }, { "objectId": "0x9cd4c08bdf2e132ec2cc77b0f03be60a94951e046d8e82ed5494f44e609edd2f", "initialSharedVersion": 327637282 }, { "objectId": "0xac8ce2033571140509788337c8a1f3aa8941a320ecd7047acda310d39cad9e03", "initialSharedVersion": 327637282 }, { "objectId": "0xbcd4527035265461a9a7b4f1e57c63ea7a6bdf0dc223c66033c218d880f928b1", "initialSharedVersion": 327637282 }, { "objectId": "0xbfdb691b8cc0b3c3a3b7a654f6682f3e53b164d9ee00b9582cdb4d0a353440a9", "initialSharedVersion": 327637282 }, { "objectId": "0xc2559d5c52ae04837ddf943a8c2cd53a5a0b512cee615d30d3abe25aa339465e", "initialSharedVersion": 327637282 }, { "objectId": "0xc56db634d02511e66d7ca1254312b71c60d64dc44bf67ea46b922c52d8aebba6", "initialSharedVersion": 327637282 }, { "objectId": "0xc84545cbff1b36b874ab2b69d11a3d108f23562e87550588c0bda335b27101e0", "initialSharedVersion": 327637282 }, { "objectId": "0xcc141659b5885043f9bfcfe470064819ab9ac667953bcedd1000e0652e90ee76", "initialSharedVersion": 327637282 }, { "objectId": "0xef6bf4952968d25d3e79f7e4db1dc38f2e9d99d61ad38f3829acb4100fe6383a", "initialSharedVersion": 327637282 }, { "objectId": "0xf2ed8d00ef829de5c4a3c5adf2d6b0f41f7fec005fb9c88e5616b98173b2fd66", "initialSharedVersion": 327637282 }, { "objectId": "0xfce73f3c32c3f56ddb924a04cabd44dd870b72954bbe7c3d7767c3b8c25c4326", "initialSharedVersion": 327637282 } ] ``` # Inspect Historical Auction Events {% hint style="danger" %} Shio permanently shut down on 12 May 2026. This page is kept as a historical reference only; the Shio feed, bidding APIs, explorer, and RPC endpoints are no longer active. {% endhint %} Once an auction completed, a series of events were persisted, including when the auction started, what bids were accepted, etc. This information was useful for debugging, giving searchers visibility into what happened during the auction. Note that rejected bids (for any reason) did not generate an event. Historically, to retrieve such events, searchers sent the following request to `https://rpc.getshio.com/`. This endpoint is no longer active. ```json { "jsonrpc": "2.0", "id": 1, "method": "shio_auctionEvents", "params": [ "FRTxR2eMbu9DXaQUGSbvmCPTCm78ufBTPxu618Fd8c6P", ] } ``` The method `shio_auctionEvents` accepted only one parameter, which was the digest of the opportunity transaction. Alternatively, searchers could browse recent bundles in [Shio Explorer](https://www.getshio.com/explorer). The Explorer is no longer active. Historically, it did not show auctions that had no bid accepted at all. # Searcher FAQ {% hint style="danger" %} Shio permanently shut down on 12 May 2026. This page is kept as a historical reference only; the Shio feed, bidding APIs, explorer, and RPC endpoints are no longer active. {% endhint %} ### What does \`txBytes\` and \`sig\` mean when submitting bid? `txBytes` is the base64 encoded bcs-serializion of a `TransactionData` structure, while `sig` is a single base64 encoded signature. The two parameters follow the same format as `sui keytool decode-or-verify-tx` command. ### I have submitted a bid but it did not get accepted, what could be the issue? In order to troubleshoot bid submission, searchers used [Submission through JSON-RPC](/archived-searcher-guides/submit-bid#submission-through-json-rpc). Through this method, unlike through WebSocket, an error message would be returned. If you do not see an error message, it is very likely that your bid came in after the auction has already ended. ### Historically, why could a bid still land despite [Explorer](https://getshio.com/explorer) showing it did not win the auction? We may submit one or more bids to validators, depending on a number of factors. This is to ensure if a bid fails, some bid with a lower amount could have to chance to execute instead. This is controlled by the auctioneer and there is no way to opt-out this. ### There was no error from bid submission and I won the auction. But my bid has never landed, why? Please make sure your transaction can be successfully submitted to validators. A common reason is that your owned objects (such as gas objects) has already been locked by another transaction, or another transaction has just been submitted so that the object version specified in the bid is no longer valid. The auctioneer will drop your bid (despite shown as winning) if it cannot find a way to successfully submit it.