For the complete documentation index, see llms.txt. This page is also available as Markdown.

auctionStarted Event

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:

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

Historically, searchers could use wscat or similar tools to connect to the Feed. This WebSocket endpoint is no longer active.

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

Last updated