For every event that we track, we need the proper configuration format for each event.

Points are issued retroactively. If new conditions are added, users will be rewarded retroactively according to the blockheight ranges.

sc_address
string
required

The address of the smart contract that emits the event.

Example: 0xCBCdF9626bC03E24f779434178A73a0B4bad62eD

event_signature
string
required

The event signature of the event. It must be exactly correct or the hashed signature will not match up.

Example: event Swap(address sender indexed, uint256 amount0In, uint256 amount1In, uint256 amount0Out, uint256 amount1Out, address to indexed)

beneficiary
string
required

The points beneficiary represents the field that contains the wallet address that the points will be attributed to.

Options:

  1. "from" - This is the “from” field of the transaction
  2. <field of the event name> - This is one of the fields in the event

Example: sender

dapp_name
string
required

This is the name of the DApp/Protocol where the points are issued from. This aggregates all the points from the same provider (if multiple pools are referenced, for example).

Example: uniswap

chain_id
number
required

The id of the chain. Look up yours here: chainlist.

Example: 1

blockexplorer_url
string
required

A link to a blockexplorer that contains the verified contract.

Example: https://etherscan.io/address/0xCBCdF9626bC03E24f779434178A73a0B4bad62eD

start_blockheight
number
required

The block number that we will begin indexing events at (inclusive).

Example: 20565883

end_blockheight
number

The block number that we will stop indexing events at (inclusive).

Example: 20566000

primary_field
string
required

The value of this field is used as the basis for the number of points issued.

Example: amount0In

fallback_field
string

If the Primary Field is 0 or null, then the Fallback Field will be used. Useful for events that have unused arguments.

Example: amount0Out

Because swaps have an equal value of tokens on each side, you only need to define 1 of the token ids in question for a swap event!

coingecko_id
string

The appropriate coingecko Id for the token being tracked in the event. A full list of valid token ids can be found here.

Example: weth

decimals
number

If tracking dollar-denominated amount, input the number of decimals the tracked token has.

Example: 18

AchievementsPoints API