Relayers
Get relayer data
POST
https://api.octusbridge.io/v1/relays_pages/relay_info
This function is used to return information about a specific relayer based on its address.
It can be used anywhere where details about a specific relayer is needed such as details about events and their confirmation, validating rounds, rewards, stake etc.
Request parameters
Required body parameters:
relayAddress
0:daacff0f136da1d5c9fa73200d481362c44756b0ff7d083ee02e95f00a078557
Address of the desired relayer
Response fields explanation
evmStats
-
List of data related to the evm actions
chainId
1
Id of the chain
potentialConfirmed
2047
Number of potential events confirmed
relayConfirmed
1801
Actual number of events confirmed
frozenStake
258917.752572214000
Frozen stake of the relayer
latestReward
0
Reward acquired from the last round
potentialTotalConfirmed
20
Total number of potential events confirmed
relayTotalConfirmed
7291
Actual total number of confirmed events
successfulRounds
18
Rounds that ended successfully for the certain relayer
totalCountRounds
20
Total number of rounds relayer participated in
totalReward
8800.73179149
Total amount of reward the relayer acquired
untilFrozen
1661463628000
Date time until the stake will be frozen
Example
Get relayer round info
POST
https://api.octusbridge.io/v1/relays_pages/relay_round_info
This function use to get validation round info.
It can be used for showing a relayer’s efforts in one specific round. Following data about the relayer’s performance based on the round number can be displayed: How much a relayer staked to become a relayer, number of events he confirmed, volume from all the transfers relayer validated happened from everscale to ethereum network and vice versa shown in USDTs, round address, start and end time of the round.
Request parameters:
Required body parameters:
relayAddress
0:daacff0f136da1d5c9fa73200d481362c44756b0ff7d083ee02e95f00a078557
Address of the desired relayer
Response fields explanation
endTime
1654604726000
Date time of the validation round’s end
ethToTonUsdt
6119978.1405
Total amount of ethereum tokens in USDT swapped to everscale tokens and transferred
eventsConfirmed
661
Total number of events the relayer confirmed in the current round
evmStats
: [
List of data related to the evm events
chainId
1
Id of the chain
potentialConfirmed
144
Number of potential events confirmed
relayConfirmed
143
Number of actual events confirmed
relayAddress
0:daacff0f136da1d5c9fa73200d481362c44756b0ff7d083ee02e95f00a078557
Address of the relayer
relayPlace
1
Place of the relayer
roundAddress
0:20e866e80bb8ded0ad14f7317a58b05d378fd108306aafed64650465cd68b19e
Address of the round certain relayer is participating in
roundNum
15
Round number
stake
258917.752572214000
Amount relayer staked to become one of the participants
startTime
1653999926000
Date time of round start
tonToEthUsdt
5567068.9741
Total amount of everscale tokens in USDT swapped to ethereum tokens and transferred
totalRoundConfirms
695
Number of total confirms in the monitored round
eventsConfirmedShare
0.9511
Share of the relayer per event confirmed
Example
Get relayers round info
POST
https://api.octusbridge.io/v1/relays_pages/relays_round_info
This function returns list of relayers and details about them based on the round number they are part of.
Can be used for listing all or certain number of relayers when it comes to one validation round. Some of the details about the relayers are number of confirmed events and the share per event, relay’s address, list of events, place of a relayer and also info about the round such as start and end time, round number and address, etc.
Request parameters
Required body parameters:
limit
10
Maximum number of relayers to be retrieved
offset
0
Offset
ordering
stakeascending
Value based on which the retrieved relayer data will be ordered (stakeascending, stakedescending…)
roundNum
15
Round number
Response fields explanation
relays
: [
List of relays participating in the given round, determined by the amount set in the limit body parameter
endTime
1654604726000
Date time of the validation round’s end
ethToTonUsdt
5567068.9741
Total amount of ethereum tokens in USDT swapped to everscale tokens and transferred
eventsConfirmed
661
Total number of events the relayer confirmed in the current round
eventsConfirmedShare
0.9511
Share of the relayer per event confirmed
evmStats
: []
List of data related to the evm events
chainId
0
Id of the chain
potentialConfirmed
0
Number of potential events confirmed
relayConfirmed
0
Number of actual events confirmed
relayAddress
0:ef79b4aac06c33ab3435943d196de9ba9ee48a3e4572c86a8ad3a2bf84b4f767
Address of the relayer
relayPlace
null
Place of the relayer
roundAddress
0:20e866e80bb8ded0ad14f7317a58b05d378fd108306aafed64650465cd68b19e
Address of the round certain relayer is participating in
roundNum
15
Round number
stake
100000
Amount relayer staked to become one of the participants
startTime
1653999926000
Date time of round start
tonToEthUsdt
5567068.9741
Total amount of everscale tokens in USDT swapped to ethereum tokens and transferred
totalRoundConfirms
695
Number of total confirms in the monitored round
totalCount
23
Total number of relayers participating in the round with given round number
Example
Get all validation rounds info
POST
https://api.octusbridge.io/v1/relays_pages/all_relay_ronds_info
This function returns all validation relay rounds in which specified relayer took part in.
It can be used for monitoring a relayer's activity and history by retrieving data such as details about events and share per event, round details, relayer’s place and stake, etc. only by inputting relayer’s address.
Request parameters
Required body parameters:
limit
10
Maximum number of relayers to be retrieved
offset
0
Offset
ordering
roundnumascending
Value based on which the retrieved relayer data will be ordered (stakeascending, stakedescending…)
userAddress
0:daacff0f136da1d5c9fa73200d481362c44756b0ff7d083ee02e95f00a078557
Address of the relayer
Response fields explanation
evmStats
[]
List of data related to the evm events
chainId
0
Id of the chain
potentialConfirmed
0
Number of potential events confirmed
relayConfirmed
0
Number of actual events confirmed
relayAddress
0:aacff0f136da1d5c9fa73200d481362c44756b0ff7d083ee02e95f00a078557
Address of the relayer
relayPlace
null
Place of the relayer
roundAddress
0:77f4e7eb93d7fb3432f297782f2cd2e5fb2a62bb05d8a9590ea54c6ab954254d
Address of the round certain relayer is participating in
roundNum
1
Round number
stake
244636
Amount relayer staked to become one of the participants
startTime
1645303857000
Date time of round start
tonToEthUsdt
573326.1229
Total amount of everscale tokens in USDT swapped to ethereum tokens and transferred
totalRoundConfirms
108
Number of total confirms in the monitored round
totalCount
18
Number of validation rounds in which the desired relayer takes part
Example
Get validation round info
POST
https://api.octusbridge.io/v1/relays_pages/round_info
This function returns basic information about relayers based on their addresses, round number and stake.
It can be used for filtering rounds based on their number and showing information about them such as stake and stake changes, information about events, relayers and change in number of them, amount of USDTs transferred through the round duration.
Request parameters
Required body parameters:
roundNum
10
Round number
Response fields explanation
averageRelayStake
106213.02883900
Average relayers stake
averageRelayStakeChange
-0.5300
Change of the average relayers stake in percentage
ethToTonUsdt
5204152.7479
Total amount of ethereum tokens in USDT swapped to everscale tokens and transferred
eventsConfirmed
603
Total number of events the relayer confirmed in the current round
evmStats
: [
List of data related to the evm events
chainId
1
Id of the chain
potentialConfirmed
142
Number of potential events confirmed
relayConfirmed
0
Number of actual events confirmed
relaysCount
24
Total number of relayers in the desired round
relaysCountChange
9.0900
Change of number of relayers participating in the round in percentage
roundNum
10
Round number
tonToEthUsdt
6007826.4910
Total amount of everscale tokens in USDT swapped to ethereum tokens and transferred
totalStake
2549112.692146446000
Sum of all the stakes relayers invested in the round
totalStakeChange
8.5100
Change of total stake invested in percentage
Example
Get relayers info
POST
https://api.octusbridge.io/v1/relays_pages/search/relays
This function **** returns basic information about relayers based on their addresses, round number and stake.
Request parameters
Required body parameters:
createdAtGe
0
Value representing bottom border of the date time relayer was created
createdAtLe
0
Value representing top border of the date time relayer was created
limit
10
Maximum number of relayers to be retrieved
offset
0
Offset
ordering
stakeascending
Value based on which the retrieved relayer data will be ordered (stakeascending, stakedescending)
relayAddresses
0:79fc8ce8d32211a4c49adf7de1c9c0fa682ff3a13124ff027f6b92faa308ffeb
List of relayers (addresses)
roundNum
10
Round number
stakeGe
50
Bottom border of the stake amount relayer invested for participating in the round
stakeLe
1000000
Top border of the stake amount relayer invested for participating in the round
transferContractAddress
0:cbd090198d22e4b1a77227ba2bff58a05a32049ef2908aebfb461cacd6a474c8
Address of the transfer contract
Parameters used for the test:
limit
10
offset
0
ordering
stakeascending
Response fields explanation
relays
: [
List of relays participating in specified round and specified transfer
createdAt
1651074897000
Date time of becoming a relayer
currentRound
true
True if search refers to a current round, false if not
potentialTotalConfirmed
4749
Number of potential events confirmed
relayAddress
0:099341ccbe3f2db59432fc1cc794773b9da06048d14e43ae24ae224dd768145d
Address of the relayer
relayTotalConfirmed
4056
Actual number of events confirmed by a relayer
slashed
false
True if a relayer was slashed, false if not
stake
100000
Amount relayer staked for participating in the round
successfulRounds
10
Number of successful validation relay rounds of a relayer
totalRounds
10
Number of all rounds relayer participated in
totalCount
27
Total number of records retrieved based on the relayers’ addresses given and transaction contract’s address for the specified round
Example
Get relayer
POST
https://api.octusbridge.io/v1/relays_pages/search/relays_events
This function returns details about relayer’s events based on the chain id of the event, kind of transfer, receiver’s address, sender’s address, token address, relayer’s address, contract’s address, round number.
It can be used for filtering all the events based on the required parameters and displaying them in the list form along with information such as amount transferred, chain id, sender’s address, receiver’s address, token address etc.
Request parameters
Required body parameters:
amountGe
0
Bottom border of the transferred amount
amountLe
10000000000000000
Top border of the transferred amount
chainId
1
Id of the event’s chain
ethUserAddress
0xcbefe3344284444ac8141c930207b8ff82a3177e
User address on the ethereum network
limit
10
Maximum number of relayers to be retrieved
offset
0
Offset
ordering
amountascending
Value based on which the retrieved relayer data will be ordered
relayAddress
-
Address of the relayer
roundNum
18
Round number
timestampGe
1642813200000
Bottom border of the date time of the transfer
timestampLe
1656032400000
Top border of the date time of the transfer
tokenAddress
0:a519f99bb5d6d51ef958ed24d337ad75a1c770885dcd42d51d6663f9fcdacfb2
Address of the transferred token
tonUserAddress
0:1fcdda0bdb6cc28476575f1617949188fb9f29d35b9f86217438baf3519058c3
User address on the everscale network
transferContractAddress
0:91b879d842d2292db57abd10d1cd6e83959dd27fb70189d02032314c0de542a9
Address of the transfer contract
transferKind
ethtoton
Transfer kind (tontoeth, ethtoton)
Response fields explanation
relays
:[
List of relays participating in specified round and specified transfer
amount
90000
Amount of transfer
chainId
1
Id of the event’s chain
contractAddress
0:91b879d842d2292db57abd10d1cd6e83959dd27fb70189d02032314c0de542a9
Address of the transfer contract
from
0xcbefe3344284444ac8141c930207b8ff82a3177e
Address of the sender
timestamp
1655983612000
Date time of the transfer
to
0:1fcdda0bdb6cc28476575f1617949188fb9f29d35b9f86217438baf3519058c3
Address of the receiver
tokenAddress
0:a519f99bb5d6d51ef958ed24d337ad75a1c770885dcd42d51d6663f9fcdacfb2
Address of the transferred token
transferKind
ethtoton
Transfer kind (tontoeth, ethtoton)
totalCount
18
Total number of relays participating in the transfer
Example
Get global relayer
POST
https://api.octusbridge.io/v1/relays_pages/search/global_relays_events
This function returns details about relayer’s events based on the chain id of the event, kind of transfer, receiver’s address, sender’s address, token address, relayer’s address, contract’s address, round number.
It can be used for filtering all the events based on the required parameters and displaying them in the list form along with information such as amount transferred, chain id, sender’s address, receiver’s address, token address etc.
Request parameters
Required body parameters:
amountGe
0
Bottom border of the transferred amount
amountLe
10000000000000000
Top border of the transferred amount
chainId
1
Id of the event’s chain
ethUserAddress
0xcbefe3344284444ac8141c930207b8ff82a3177e
User address on the ethereum network
limit
10
Maximum number of relayers to be retrieved
offset
0
Offset
ordering
amountascending
Value based on which the retrieved relayer data will be ordered
relayAddress
-
Address of the relayer
roundNum
18
Round number
timestampGe
1642813200000
Bottom border of the date time of the transfer
timestampLe
1656032400000
Top border of the date time of the transfer
tokenAddress
0:a519f99bb5d6d51ef958ed24d337ad75a1c770885dcd42d51d6663f9fcdacfb2
Address of the transferred token
tonUserAddress
0:1fcdda0bdb6cc28476575f1617949188fb9f29d35b9f86217438baf3519058c3
User address on the everscale network
transferContractAddress
0:91b879d842d2292db57abd10d1cd6e83959dd27fb70189d02032314c0de542a9
Address of the transfer contract
transferKind
ethtoton
Transfer kind (tontoeth, ethtoton)
Response fields explanation
relays
List of relays participating in specified round and specified transfer
amount
90000
Transferred amount
chainId
1
Id of the event’s chain
contractAddress
091b879d842d2292db57abd10d1cd6e83959dd27fb70189d02032314c0de542a9
Address of the transfer contract
from
0xcbefe3344284444ac8141c930207b8ff82a3177e
Address of the sender
timestamp
1655983612000
Date time of the transfer
to
01fcdda0bdb6cc28476575f1617949188fb9f29d35b9f86217438baf3519058c3
Address of the receiver
tokenAddress
0a519f99bb5d6d51ef958ed24d337ad75a1c770885dcd42d51d6663f9fcdacfb2
Address of the transferred token
transferKind
ethtoton
Transfer kind (tontoeth, ethtoton)
totalCount
1
Total number of relays participating in the transfer
Example
Get rounds calendar
POST
https://api.octusbridge.io/v1/relays_pages/rounds_calendar
This fuction returns data about the rounds between from and to rounds numbers.
It can be used as round’s calendar where data about election start and end time, round’s start and end time, number and address for each round will be displayed
Request parameters
Required body parameters:
fromRoundNum
1
First round number to retrieve
toRoundNum
10
Last round number to retrieve
Response fields explanation
electionEndTime
1645131078000
Date time of the election’s end
electionStartTime
1644958278000
Date time of the election’s start
endTime
1645908657000
Date time of the round’s end
roundAddress
0:77f4e7eb93d7fb3432f297782f2cd2e5fb2a62bb05d8a9590ea54c6ab954254d
Address of the validation relay round
roundNum
1
Round number
startTime
1645303857000
Date time of the round’s start
Example
Get validation rounds info
POST
https://api.octusbridge.io/v1/relays_pages/relays_pages/relay_rounds_info
This function returns information about the relayerabout relayer relay taking part in the specific round based on itsit’s address and round number.
It can be used for filtering where relayer’s and round’s information, for the chosen round, such as round end, round start, events information, amount of assets transferred through the round etc., will be displayed.
Request parameters
Required body parameters:
limit
10
Maximum number of relayers to be retrieved
offset
0
Offset
ordering
stakeascending
Value based on which the retrieved relayer data will be ordered (stakeascending, stakedescending…)
userAddress
0:daacff0f136da1d5c9fa73200d481362c44756b0ff7d083ee02e95f00a078557
Address of the relayer
roundNum
10
Round number
Response fields explonation
relays
: [
Relay with specified address participating in specified round
endTime
1651580726000
Round end time
eventsConfirmed
529
Total number of confirmed events
eventsShare
0.8773
Amount of share relayer earns per event
fromTonUsdt
5204152.7479
Amount of USDTs transferred from everscale
fromTonUsdtShare
0.5358
Share of transferring evers to usdt
roundAddress
0:cc312267aa40b7f9a56ce1aad46dbca5088c2d30ee1ba88555d2e97941ac9816
Address of the specified round
roundNum
10
Round number
stake
244636
Invested stake of a relayer for participating in the round
startTime
1650975926000
Round start time
toTonUsdt
4509235.2178
Amount of USDTs transferred to everscale
toTonUsdtShare
0.4642
Share of transferring to everscale in USDTs
totalCount
0
Total number of relayers with specified address participating in the specified round
Example
Last updated