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

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

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.

Last updated