Pool Register Contract

poolreg.xsat

This contract performs Synchronizer registration, configuration, and related tasks.

Actions

• Initialize the synchronizer

• Delete the synchronizer

• Unbind the miner

• Configure financial account and commission rate for the synchronizer

• Purchase a slot

• Claim rewards for validating blocks

• Update the synchronizer with the latest block height

TABLE config

scope

poolreg.xsat

params

• {string} donation_account - the account designated for receiving donations

example

{
  "donation_account": "donate.xsat"
}

TABLE synchronizer

scope

poolreg.xsat

params

• {name} synchronizer - synchronizer account

• {name} reward_recipient - receiving account for receiving rewards

• {string} memo - memo when receiving reward transfer

• {uint16_t} num_slots - number of slots owned

• {uint64_t} latest_produced_block_height - the latest block number

• {uint16_t} produced_block_limit - upload block limit, for example, if 432 is set, the upload height needs to be a synchronizer that has produced blocks in 432 blocks before it can be uploaded.

• {uint16_t} donate_rate - the donation rate, represented as a percentage, ex: 500 means 5.00%

• {asset} total_donated - the total amount of XSAT that has been donated

• {asset} unclaimed - unclaimed rewards

• {asset} claimed - rewards claimed

• {uint64_t} latest_reward_block - the latest block number to receive rewards

• {time_point_sec} latest_reward_time - latest reward time

example

{
   "synchronizer": "test.xsat",
   "reward_recipient": "erc2o.xsat",
   "memo": "0x4838b106fce9647bdf1e7877bf73ce8b0bad5f97",
   "num_slots": 2,
   "latest_produced_block_height": 840000,
   "produced_block_limit": 432,
   "donate_rate": 100,
   "total_donated": "100.00000000 XSAT",
   "unclaimed": "5.00000000 XSAT",
   "claimed": "0.00000000 XSAT",
   "latest_reward_block": 840001,
   "latest_reward_time": "2024-07-13T14:29:32"
}

TABLE miners

scope

poolreg.xsat

params

• {uint64_t} id - primary key

• {name} synchronizer - synchronizer account

• {string} miner - associated btc miner account

example

{
   "id": 1,
   "synchronizer": "alice",
   "miner": "3PiyiAezRdSUQub3ewUXsgw5M6mv6tskGv"
}

TABLE stat

scope

poolreg.xsat

params

• {asset} xsat_total_donated - the cumulative amount of XSAT donated

example

{
  "xsat_total_donated": "100.40000000 XSAT"
}

ACTION setdonateacc

• authority: poolreg.xsat

Update donation account.

params

• {string} donation_account - account to receive donations

example

$ cleos push action poolreg.xsat setdonateacc '["alice"]' -p poolreg.xsat

ACTION updateheight

• authority: utxomng.xsat

Update synchronizer’s latest block height and add associated btc miners.

params

• {name} synchronizer - synchronizer account

• {uint64_t} latest_produced_block_height - the height of the latest mined block

• {std::vector<string>} miners - list of btc accounts corresponding to synchronizer

ACTION initpool

• authority: poolreg.xsat

Unbind the association between synchronizer and btc miner.

params

• {name} synchronizer - synchronizer account

• {uint64_t} latest_produced_block_height - the height of the latest mined block

• {string} financial_account - financial account to receive rewards

• {std::vector<string>} miners - list of btc accounts corresponding to synchronizer

ACTION delpool

• authority: poolreg.xsat

Erase synchronizer.

params

• {name} synchronizer - synchronizer account

ACTION unbundle

• authority: poolreg.xsat

Unbind the association between synchronizer and btc miner.

params

• {uint64_t} id - primary key of miners table

ACTION config

• authority: poolreg.xsat

Configure synchronizer block output limit.

params

• {name} synchronizer - synchronizer account

• {uint16_t} produced_block_limit - upload block limit, for example, if 432 is set, the upload height needs to be a synchronizer that has produced blocks in 432 blocks before it can be uploaded.

ACTION buyslot

• authority: synchronizer

Buy slot.

params

• {name} synchronizer - synchronizer account

• {name} receiver - the account of the receiving slot

• {uint16_t} num_slots - number of slots

ACTION setdonate

• authority: synchronizer

Configure donate rate.

params

• {name} synchronizer - synchronizer account

• {uint16_t} donate_rate - the donation rate, represented as a percentage, ex: 500 means 5.00%

ACTION setfinacct

• authority: synchronizer

Configure financial account.

params

• {name} synchronizer - synchronizer account

• {string} financial_account - financial account to receive rewards

ACTION claim

• authority: synchronizer->to or evmutil.xsat

Receive award.

params

• {name} synchronizer - synchronizer account