Contract Events
Last updated
Was this helpful?
Last updated
Was this helpful?
You are referring to the Legacy version of KyberSwap docs.
For the most updated information, please refer to:
Ethereum allows smart contracts to emit events during the execution of a function. Your application can track these events to find information such as trades, platform fees, reserve rebates, KNC burnt etc.
Using these events, you will be able to calculate other important information such as overall volume, volume per token, volume per reserve, and more. Our uses the events emitted to track these statistics.
The ExecuteTrade event is emitted by the KyberNetworkProxy contracts.
The KyberTrade event is emitted by the KyberNetwork contracts.
The following events are emitted by the KyberFeeHandler contract(s).
These events are emitted by the FPRs and APRs.
These events are no longer emitted, but remain documented.
Event is emitted when a trade is executed.
event ExecuteTrade(address indexed trader, IERC20 src, IERC20 dest, address destAddress, uint256 actualSrcAmount, uint256 actualDestAmount, address platformWallet, uint256 platformFeeBps)
trader
address
YES
trader's address
trader's address
IERC20
NO
source ERC20 token contract address
dest
IERC20
NO
destination ERC20 token contract address
destAddress
address
NO
destination address for receiving dest tokens
actualSrcAmount
uint256
NO
src token wei amount
platformWallet
address
NO
wallet address receiving trade fees
platformFeeBps
uint256
NO
platform fee percentage (in basis points) of trade
Event Signature: 0xf724b4df6617473612b53d7f88ecc6ea983074b30960a049fcd0657ffe808083
Event is emitted when a trade is executed.
event ExecuteTrade(address indexed sender, ERC20 src, ERC20 dest, uint actualSrcAmount, uint actualDestAmount)
sender
address
YES
sender's address
src
ERC20
NO
source ERC20 token contract address
dest
ERC20
NO
destination ERC20 Token contract address
actualSrcAmount
uint
uint
source ERC20 token amount in wei
actualDestAmount
uint
NO
destination ERC20 token amount in wei
Event Signature: 0x1849bd6a030a1bca28b83437fd3de96f3d27a5d172fa7e9c78e7b61468928a39\
Emitted when a trade is executed in the internal network.
event KyberTrade(IERC20 indexed src, ERC20 indexed dest, uint256 ethWeiValue, uint256 networkFeeWei, uint256 customPlatformFeeWei, bytes32[] t2eIds, bytes32[] e2tIds, uint256[] t2eSrcAmounts, uint256[] e2tSrcAmounts, uint256[] t2eRates, uint256[] e2tRates)
src
ERC20
YES
source ERC20 token contract address
dest
ERC20
YES
destination ERC20 token contract address
ethWeiValue
uint256
NO
ether wei value of the trade
networkFeeWei
uint256
NO
network fee in ether wei
customPlatformFeeWei
uint256
NO
platform fee in ether wei
t2eIds
bytes32[]
NO
token -> ether reserve IDs used for the trade
e2tIds
bytes32[]
NO
Ether to token reserve IDs used for the trade
t2eSrcAmounts
uint256[]
NO
token -> ether source amounts in source token wei
e2tSrcAmounts
uint256[]
NO
Ether to token source amounts in destination token wei
t2eRates
uint256[]
NO
token -> ether rates used for the trade
e2tRates
uint256[]
NO
Ether to token rates used for the trade
Event Signature: 0xc6efb0df0b5d684cd6482e00270d068229ca5833634798e25f85b79eee5183f9
For token to token trades, the ethWeiValue will be just 1 side of the trade. As an example, X KNC -> 10 ETH -> Y DAI yields ethWeiValue = 10e18.
Emitted when there are fees to be given to various parties, based on the BRR distribution determined by the KyberDAO.
event FeeDistributed(IERC20 indexed token, address indexed platformWallet, uint256 platformFeeWei, uint256 rewardWei, uint256 rebateWei, address[] rebateWallets, uint256[] rebatePercentBpsPerWallet, uint256 burnAmtWei)
token
IERC20
YES
token for which fees will be distributed in
platformWallet
address
YES
Wallet address that gets fees from the trade
platformFeeWei
uint256
NO
Platform fee in token wei
rewardWei
uint256
NO
KNC stakers' rewards in token wei
rebateWei
uint256
NO
Reserve rebates in token wei
rebateWallets
address[]
NO
List of rebate wallet addresses receiving rebates
rebatePercentBpsPerWallet
uint256[]
NO
Corresponding rebate proportions in basis points
burnAmtWei
uint256
NO
token wei allocated for converting to and burning KNC
Event Signature: 0xd66a6cfa04148d5e34fd3da6bbabc8a7e6c9ebffb1638f00e9c35d67b51c6bd2
Emitted when there is a change made to the BRR distribution, as determined by the KyberDAO.
event BRRUpdated(uint256 rewardBps, uint256 rebateBps, uint256 burnBps, uint256 expiryTimestamp, uint256 indexed epoch)
rewardBps
uint256
NO
proportion (in basis points) of network fee allocated to staker rewards
rebateBps
uint256
NO
proportion (in basis points) of network fee allocated to reserve rebates
burnBps
uint256
NO
proportion (in basis points) of network fee allocated to burning KNC
expiryTimestamp
uint256
NO
timestamp after which this BRR configuration will be invalid
epoch
uint256
YES
current epoch number
Event Signature: 0x90da252e8e1873b40c0a15bba09620de70b1550bcd36e796175beb6f259c797d
Emitted when KNC has been burnt.
event KncBurned(uint256 kncTWei, IERC20 indexed token, uint256 amount)
kncTWei
uint256
NO
KNC burnt amont in KNC token wei
token
IERC20
YES
token for which KNC was converted from
amount
uint256
NO
token wei amount used for conversion and burning KNC
Event Signature: 0xd66a6cfa04148d5e34fd3da6bbabc8a7e6c9ebffb1638f00e9c35d67b51c6bd2
Emitted when an entire epoch's reward has been allocated for burning KNC (Eg. epoch 0).
event RewardsRemovedToBurn(uint256 indexed epoch, uint256 rewardsWei)
epoch
uint256
YES
epoch number for which rewards are entirely for burning KNC
rewardsWei
uint256
NO
ether wei amount allocated for burning KNC
Event Signature: 0x11c852d8be537f120b8d4b4d5c3c211870522fd96a8bd9fa51d102774077a51b
Event is emitted when the contract receives the token deposit.
event DepositToken(ERC20 token, uint amount)
token
ERC20
NO
ERC20 token contract address
amount
uint
NO
ERC20 token amount in wei
Event Signature: 0x2d0c0a8842b9944ece1495eb61121621b5e36bd6af3bba0318c695f525aef79f
Event is emitted when trading is enabled for the reserve.
event TradeEnabled(bool enable)
enable
bool
NO
true if reserve is enabled, otherwise false if disabled
Event Signature: 0x7d7f00509dd73ac4449f698ae75ccc797895eff5fa9d446d3df387598a26e735
Event is emitted when the reserve has executed a trade.
event TradeExecute(address indexed origin, address src, uint srcAmount, address destToken, uint destAmount, address destAddress)
origin
address
YES
sender's address
src
address
NO
source ERC20 token contract address
srcAmount
uint
NO
wei amount of source ERC20 tokens
destToken
destToken
NO
destination ERC20 token contract address
destAmount
uint
NO
wei amount of destination ERC20 tokens
destAddress
address
NO
recipient address for destination ERC20 tokens
Event Signature: 0xea9415385bae08fe9f6dc457b02577166790cde83bb18cc340aac6cb81b824de
Event is emitted with funds are withdrawn from the reserve.
event WithdrawFunds(ERC20 token, uint amount, address destination)
token
ERC20
NO
ERC20 token contract address
amount
uint
NO
wei amount of tokens that was withdrawn
destination
address
NO
recipient address of withdrawn funds
Event Signature: 0xb67719fc33c1f17d31bf3a698690d62066b1e0bae28fcd3c56cf2c015c2863d6
Emitted when a trade is executed in the internal network.
event KyberTrade(address indexed trader, ERC20 src, ERC20 dest, uint srcAmount, uint dstAmount, address destAddress, uint ethWeiValue, address reserve1, address reserve2, bytes hint)
trader
address
YES
trader's address
src
ERC20
NO
source ERC20 token contract address
dest
ERC20
NO
destination ERC20 token contract address
srcAmount
uint
NO
source ERC20 token amount
dstAmount
uint
NO
destination ERC20 token amount
destAddress
ERC20
NO
recipient address for destination ERC20 token
ethWeiValue
uint
NO
Ether wei value of the trade
reserve1
address
NO
address of reserve selected for source token -> ether trade
reserve2
address
NO
address of reserve selected for source ether -> token trade
hint
bytes
NO
used to determine if permissionless reserves are to be used
Event Signature: 0xd30ca399cb43507ecec6a629a35cf45eb98cda550c27696dcb0d8c4a3873ce6c
Event is emitted when fees for burning are assigned for a reserve.
event AssignBurnFees(address reserve, uint burnFee)
reserve
address
NO
reserve's contract address
burnFee
burnFee
NO
amount of fees to be burned in wei
Event Signature: 0xf838f6ddc89706878e3c3e698e9b5cbfbf2c0e3d3dcd0bd2e00f1ccf313e0185
Event is emitted when fees for fee sharing are assigned for a reserve.
event AssignFeeToWallet(address reserve, address wallet, uint walletFee)
reserve
address
NO
reserve's contract address
wallet
address
NO
wallet address to send fees to
walletFee
uint
NO
amount of fees to be assigned to wallet address
Event Signature: 0x366bc34352215bf0bd3b527cfd6718605e1f5938777e42bcd8ed92f578368f52
Event is emitted when fees are burned.
event BurnAssignedFees(address indexed reserve, address sender, uint quantity)
reserve
address
YES
reserve's contract address
sender
address
NO
sender's address
quantity
uint
NO
amount of assigned fees to be burned
Event Signature: 0x2f8d2d194cbe1816411754a2fc9478a11f0707da481b11cff7c69791eb877ee1
Event is emitted when fees are sent to a wallet as part of the fee sharing program.
event SendWalletFees(address indexed wallet, address reserve, address sender)
wallet
address
YES
reserve's specified wallet address
reserve
address
NO
reserve's contract address
sender
address
NO
sender's address
Event Signature: 0xb3f3e7375c0c0c4f7dd94069a5a4e68667827491318da786c818b8c7a794924e
Contract Address: &#xNAN;Source:
Contract Address: &#xNAN;Source:
Contract Address: &#xNAN;Source:
Note
Contract Address: &#xNAN;Source:
Contract Address: &#xNAN;Other Reserves: Visit our to see other reserve addresses. &#xNAN;Source:
Past Contract Addresses:
Past Contract Addresses: