Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/LaBoulange/tezpay-extensions
Extensions for @tez-capital's tezpay Tezos rewards engine
https://github.com/LaBoulange/tezpay-extensions
Last synced: 2 months ago
JSON representation
Extensions for @tez-capital's tezpay Tezos rewards engine
- Host: GitHub
- URL: https://github.com/LaBoulange/tezpay-extensions
- Owner: LaBoulange
- License: eupl-1.2
- Created: 2024-06-14T14:25:29.000Z (5 months ago)
- Default Branch: master
- Last Pushed: 2024-06-30T09:24:28.000Z (5 months ago)
- Last Synced: 2024-07-01T16:01:17.720Z (4 months ago)
- Language: Go
- Homepage:
- Size: 45.9 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-tezos - Tezpay Extensions
README
# Tezpay Extensions
This repository is dedicated to hosting the [Tezpay](https://github.com/tez-capital/tezpay/) extensions that we are developing at La Boulange.
We only have one so far, but likely more will follow.Content of this document:
- [Tezpay Extensions](#tezpay-extensions)
* [Disclaimer](#disclaimer)
* [Extensions](#extensions)
+ [payouts-substitutor](#payouts-substitutor)
- [Installation](#installation)
- [Configuration](#configuration)
* [Should you wish to support us](#should-you-wish-to-support-us)
* [Contact](#contact)## Disclaimer
This repository contains extensions for the blockchain reward distribution engine Tezpay. The code is licensed under the European Union Public License (EUPL) v1.2.
The software is provided "as-is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and non-infringement. In no event shall the authors or copyright holders be liable for any claim, damages, or other liability, whether in an action of contract, tort, or otherwise, arising from, out of, or in connection with the software or the use or other dealings in the software.
Use this software at your own risk.
For the full license, please refer to the LICENSE.txt file.
## Extensions
### payouts-substitutor
This extension allows the redirection of delegation rewards due to smart contracts (address "KT") of the "oven" type to the owner accounts of the respective contracts.
This extension contributes to the solution proposed by [TezCapital](https://github.com/tez-capital) to the balance management issue of these contracts, which results in a zero reward from the protocol while there is actually delegation (see the complete description [here on Tezos Agora](https://forum.tezosagora.org/t/tez-capital-resolving-kt-delegator-payment-issues-in-paris/6256/1)).
#### Installation
- Download the executable appropriate for your operating system and hardware from the [latest release page](https://github.com/LaBoulange/tezpay-extensions/releases/latest).
- Move the downloaded file to the directory from which you intend to run it, typically the same location as `tezpay`.
- If not already done at download or move time, rename it to `payouts-substitutor`.
- Make sure it is executable by the user that runs `tezpay`.#### Configuration
Add the following element to the list of extensions defined in `tezpay`'s `config.hjson` file:
extensions: [
{
name: payouts-substitutor
command: /path/to/payouts-substitutor
kind: stdio
configuration: {
LOG_FILE: /path/to/log
LOG_LEVEL: contracts
RPC_NODE: https://eu.rpc.tez.capital
}
hooks: [
after_candidates_generated:rw
]
}
]**Note**: the `extensions: [ ... ]` array should only be included if no extensions have previously been configured in `config.hjson`. If other extensions are already listed, only the inner block `{ ... }` should be added.
Configure the following fields of the element above:
- **`command`**: `/path/to/` should be replaced by the path to the directory where you placed the `payouts-substitutor` extension.
- **`LOG_FILE`**: `/path/to/log` should be replaced by the path of the log file the extension should produce. The directory should exist, the extension will only create the file. *(optional: if omitted, no log file will be produced)*.
- **`LOG_LEVEL`**: verbosity of the produced log. *(optional: if omitted, the default value is 'contracts')*. Allowed values are:
- *errors*: logs only errors and warnings.
- *redirects*: everything from *errors* + logs about redirections of rewards to substituted smart contract owner addresses.
- *contracts*: everything from *redirects* + information related to all other smart contracts.
- *verbose*: everything from *contracts* + information related to non-smart-contract addresses.
- *debug*: everything from *verbose* + technical information.
- **`RPC_NODE`**: URL of the RPC node used to query the contracts *(optional: if omitted, the default URL is `https://eu.rpc.tez.capital`)*.Restart `tezpay` if it is running in `continual` mode.
You can ensure the extension is working properly by running `tezpay -c generate-payouts`.
## Should you wish to support us
You can send a donation:
- to our baker's address: [tz1aJHKKUWrwfsuoftdmwNBbBctjSWchMWZY](https://tzkt.io/tz1aJHKKUWrwfsuoftdmwNBbBctjSWchMWZY/schedule)
- or to its Tezos domain name: [laboulange.tez](https://tzkt.io/laboulange.tez/schedule)Or just click here:
[![Button Support]][Link Support]
This is not mandatory, but it is greatly appreciated!
[Button Support]: https://img.shields.io/badge/Support_La_Boulange!_(5_XTZ)-007bff?style=for-the-badge
[Link Support]: https://tezos-share.stroep.nl/?id=tfLn0 'Support La Boulange (5 XTZ)'## Contact
Feel free to contact us with any questions or suggestions. We can be reached through the following channels:
- MailChain: [laboulange@mailchain](https://app.mailchain.com/)
- E-mail: [email protected]
- DNS: https://dns.xyz/fr/LaBoulange
- Twitter: https://twitter.com/LaBoulangeTezos
- Telegram: https://t.me/laboulangetezosWe are also active in various Telegram and Discord groups related to Tezos.