Shio
  • 👋INTRODUCTION
    • Shio
    • Defi Integrations
    • Campaign
    • Join the Community
    • Brand Kit
  • 🎮SHIO PRODUCTS
    • Shio Endpoint
  • 🤖Searcher Guides
    • Getting Started as a Searcher
    • Connect to Shio Feed
      • auctionStarted Event
    • Submit Bid
      • Simulate Bid
    • Interact with Shio Contract
    • Inspect Historical Auction Events
    • Searcher FAQ
Powered by GitBook
On this page

Was this helpful?

  1. Searcher Guides
  2. Connect to Shio Feed

auctionStarted Event

We partner with order flow originators to conduct auctions on incoming transactions, before they are seen by others or included. An opportunity transaction is 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 will start, with auctionStarted event emitted and broadcasted. We do not reveal the content of the transaction, while only revealing its side effects from execution, that includes events and objects that have been created or mutated. Full content of all mutated or created objects will be provided, so that a searcher could know how the world state would change by executing that opportunity transaction.

An example event:

{
  "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).

    • rawContentis 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.

wscat --connect wss://rpc.getshio.com/feed

Note that because do not respond to PingMessage, you connection will only be maintained for a couple of minutes.

PreviousConnect to Shio FeedNextSubmit Bid

Last updated 2 months ago

Was this helpful?

To get more sample events, use or similar tools to connect to the Feed:

🤖
wscat