![1st-.png](https://files.peakd.com/file/peakd-hive/imwatsi/245nJMp3eaERbRW5hZtvFJAREynoZaSFSfPLf3fgPPGmaooYivXE1N5FSQQSiUBB6otQJ.png) *1st update on the development of Plug & Play and Global Notification System (GNS).* --- There's a proposal up to fund the work I am doing. You can vote for it here: - [Support proposal 219 on PeakD](https://peakd.com/proposals/219) - [Support proposal 219 on HiveSigner](https://hivesigner.com/sign/update-proposal-votes?proposal_ids=%5B219%5D&approve=true) --- ![gns icon.png](https://files.peakd.com/file/peakd-hive/imwatsi/23xAeH4ui2zg25VwFBeg1AeN4Hfb91DexTsvzLYsmduSCuSYnCP1wmndxkLirp1RbAu4r.png)

Global Notification System

*Most of my work was on GNS as I developed some of the core functionality such as account preferences and also updating the documentation.* Pull Request: [https://github.com/imwatsi/hive-gns/pull/11](https://github.com/imwatsi/hive-gns/pull/11) API Docs: [https://gns-beta.imwatsi.com/docs](https://gns-beta.imwatsi.com/docs) ## Documentation _A summary of the documentation work I did._ ### Updated README [https://github.com/imwatsi/hive-gns/blob/main/README.md](https://github.com/imwatsi/hive-gns/blob/main/README.md) The README now contains links to more documentation detailing how accounts can set preferences for each notification type available on GNS. The README also has links to integration and internal HAF Operation IDs docs, as explained below. ### Integration [https://github.com/imwatsi/hive-gns/blob/main/docs/integration.md](https://github.com/imwatsi/hive-gns/blob/main/docs/integration.md) To add a new notification class: - name the module containing its data (for example core contains core notifications and splinterlands contains Splinterlands notifications - write SQL functions to handle the operations - define the hook, which essentially a JSON file with notification types, their respective HAF Internal Op IDs, the function that handles it (from step 2 above) and the `notif_code` to use (a 3 char code) [See the core module on GitHub](https://github.com/imwatsi/hive-gns/tree/main/hive_gns/modules/core) ### Internal HAF Op IDs [https://github.com/imwatsi/hive-gns/blob/main/docs/haf_op_ids.md](https://github.com/imwatsi/hive-gns/blob/main/docs/haf_op_ids.md) HAF uses IDs to identify all the available operations on Hive and these have integer codes. For example: - `2` transfer_operation - ` 18` custom_json_operation This document hosts the IDs, with sample payloads found in the HAF database, for reference when defining your GNS hooks. ## Account preferences [https://github.com/imwatsi/hive-gns/blob/main/docs/broadcast_ops.md](https://github.com/imwatsi/hive-gns/blob/main/docs/broadcast_ops.md) Account preferences are set by broadcasting `custom_json` operations. When broadcasting these operations, use `gns` as the custom_json ID. - the main json payload is stored in an array - the first element is the `op_name` - the second is the actual `payload` ### Enabling notifications Notifications are enabled on a module by module basis, by broadcasting a `custom_json` op. The example below: - enables notifications for core HIVE/HBD transfers and sets a minimum of 1 HBD for HBD transfers - enables vote notifications for votes over `12345` weight and summarizes every `12 hours` - enables all `splinterlands` notifications and sets a minimum of `1 DEC` for DEC transfer notifications `id` : `gns` `json` : ``` [ "prefs", { "core": { "enabled": ["trn", "vot"], "trn": { "min_hbd": 1 }, "vot": { "min_weight": 12345, "freq": 12, # hours "summary": true } }, "splinterlands": { "enabled": "*", "trn": { "min_dec": 1 } } } ] ``` More documentation will be published soon, to further explain the available preferences for each notification type. ### Marking notifications as “read” You can mark all notifications as “read” or individual notification types under a class. Broadcast a `custom_json` operation with `gns` as the `id` and the following as the JSON payload: **Mark all core notifications as “read”** ``` [ "read", ["core.*"] ] ``` **Mark all notifications as “read”** ``` [ "read", "*" ] ``` ---------- ![plug.png](https://files.peakd.com/file/peakd-hive/imwatsi/23tRvMmoWWKbQtY167RwxUPefAs3AEYSryhG1mHnseYG5kd8CFMXtxCsjGH4fgcHUxYa4.png)

Plug & Play

_Summary of my work on Plug & Play._ ## FastAPI updates - Multiple workers to handle more traffic, currently set at `50 workers` - Use FastAPI routers to modularize endpoint structure ## Podping upgrade @brianoflondon and I implemented a `limit` parameter to another one of Podping’s historical data endpoints on Plug & Play. ## Automation scripts I have begun writing some bash scripts to automate some administrative tasks for Plug & Play. ### Restart bash script One might need to restart the Plug & Play app (and possibly also the PostgreSQL service) to recover from an error or the like. This bash script allows you to do so in one command. [View on GitHub](https://github.com/imwatsi/haf-plug-play/blob/master/haf_plug_play/scripts/restart.sh) ### Reset bash script There are instances where you might want to reset the Plug & Play app and its data to start a fresh installation with breaking changes. This reset script allows you to delete all Plug & Play data in PostgreSQL and initiate a new run safely, without removing the main HAF database. [View on GitHub](https://github.com/imwatsi/haf-plug-play/blob/master/haf_plug_play/scripts/reset.sh) ---------- # What’s next? ## GNS - Implement the new HAF operation filtering - Upgrade development server to latest HAF software - Add more notification types - Hive Engine activity - More Splinterlands activity - Power up - Power down - Vest withdrawals - Delegations received - Votes - Comments - Reblogs - Follows - Unfollows - Mentions - … and more - Add more documentation - HAF internal Op IDs - How to design the endpoints for custom integrations - How to design the functions for custom integrations - FastAPI metadata ## Plug & Play - Implement the new HAF operation filtering - Redesign for simple custom deployment, with Plug based filtering - Automation and CI scripts - Upgrade production, development and backup servers to latest HAF software ---------- _**Thanks for reading!**_ There's a proposal up to fund the work I am doing. You can vote for it here: - [Support proposal 219 on PeakD](https://peakd.com/proposals/219) - [Support proposal 219 on HiveSigner](https://hivesigner.com/sign/update-proposal-votes?proposal_ids=%5B219%5D&approve=true) --- ---------- ### I run a Hive witness node: - Witness name: `imwatsi` - [HiveSigner](https://hivesigner.com/sign/account-witness-vote?witness=imwatsi&approve=1) - [Peakd Witnesses](https://peakd.com/me/witnesses) - [wallet.hive.blog Witnesses](https://wallet.hive.blog/~witnesses)