feat: taker fee share

[czarcas7ic]

Closes: #8227

What is the purpose of the change

This PR implements the taker fee share logic that will be used to skim taker fee shares generated by swap routes that contain denoms that have a taker fee share agreement with the Osmosis protocol.

To review this PR, I recommend the following order:

1. Read the README additions here
2. Review the taker fee skim logic here
3. Review the Begin/EndBlock logic here
4. Review the taker fee skim fund clearing logic here and here
5. Review the entire store.go file here
6. Review all remaining tests/protos/files

Testing and Verifying

Setting a Taker Fee Share Agreement

To set a taker fee share agreement for a denom, use the new gov v1 type, sending a message of type MsgSetTakerFeeShareAgreementForDenom, with [denom] [skim_percent] [skim_address] as inputs. This message can only be executed by the gov module account.

Querying Taker Fee Share Agreements

To query all taker fee share agreements:

osmosisd query poolmanager all-taker-fee-share-agreements

To query the taker fee share agreement for a specific denom:

osmosisd query poolmanager taker-fee-share-agreement-from-denom [denom]

Querying Accrued Value and Accumulators

To query all taker fee share accumulators:

osmosisd query poolmanager all-taker-fee-share-accumulators

To query the accrued value of taker fees for specific denoms:

osmosisd query poolmanager taker-fee-share-denoms-to-accrued-value [takerFeeDenom] [denom]

Registering an Alloyed Pool

To register an alloyed pool for taker fee revenue sharing, use the new gov v1 type, sending a message of type MsgSetRegisteredAlloyedPool, with [pool_id] as the input. This message can only be executed by the gov module account.

Querying an Alloyed Pool

To query all registered alloyed pools:

osmosisd query poolmanager all-registered-alloyed-pools

To query the registered alloyed pool state from a specific denom:

osmosisd query poolmanager registered-alloyed-pool-from-denom [denom]

[czarcas7ic]

drive by

[p0mvn]

Great work