{"id":17979050,"url":"https://github.com/lykhonis/relayer","last_synced_at":"2026-02-18T23:01:51.275Z","repository":{"id":141702101,"uuid":"519545025","full_name":"lykhonis/relayer","owner":"lykhonis","description":"Lukso Hackathon Relayer Service","archived":false,"fork":false,"pushed_at":"2022-08-31T14:05:13.000Z","size":97,"stargazers_count":2,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-19T17:37:17.489Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lykhonis.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-07-30T14:56:37.000Z","updated_at":"2022-11-08T12:12:24.000Z","dependencies_parsed_at":"2024-04-19T05:31:22.745Z","dependency_job_id":null,"html_url":"https://github.com/lykhonis/relayer","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/lykhonis/relayer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lykhonis%2Frelayer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lykhonis%2Frelayer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lykhonis%2Frelayer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lykhonis%2Frelayer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lykhonis","download_url":"https://codeload.github.com/lykhonis/relayer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lykhonis%2Frelayer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29597853,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-18T22:25:43.180Z","status":"ssl_error","status_checked_at":"2026-02-18T22:25:42.766Z","response_time":162,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-29T17:36:04.654Z","updated_at":"2026-02-18T23:01:51.260Z","avatar_url":"https://github.com/lykhonis.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Lukso Relayer Service\n\n| Name | Description |\n| ---- | ----------- |\n| Project | Wise Relayer Service |\n| Name | Volodymyr Lykhonis |\n| Email | volodymyr@lykhonis.com |\n| App | https://relayer-frontend.vercel.app |\n| Debug App | https://relayer-frontend.vercel.app/debug |\n| Frontend | [relayer-frontend](https://github.com/lykhonis/relayer-frontend) |\n| Contracts | [relayer-contracts](https://github.com/lykhonis/relayer-contracts) |\n| Oracles | [relayer-oracles](https://github.com/lykhonis/relayer-oracles) |\n| Walkthrough | [Walkthrough Demo Video](https://youtu.be/OizE7QbIOEs) |\n\n# Overview\n\nWise relayer service enables customers to leverage a staking pool to pay transaction fees on a blockchain.\n\nThere are at least 3 target customers:\n1. Users who are new to the Lukso ecosystem\n2. Users who own `LYX` and would like to earn `LYX` and pay no transaction fees\n3. Businesses that buy and stake `LYX` to pay transaction fees for their customers\n\n## How it works\n\n![overview diagram](assets/diagram-overview.png)\n\n- `purple`: a staking pool provider\n- `pink`: Lukso blockchain\n- `green`: Wise relayer service\n\n### Staking Pool\n\nA staking pool must be deployed and operated on Lukso blockchain. [Stakewise](https://stakewise.io/) has been leading and innovating on Ethereum mainnet for over a year. It provides a scalable dual token model:\n- `sETH`: a staked `Eth` token\n- `rETH`: a reward `Eth` token\n\nOnce withdrawals are enabled, both `sETH` and `rETH` can be safely redeemed to `Eth`. Following same architecture, there could be `sLYX` and `rLYX` ERC-20 tokens deployed and managed on Lukso blockchain.\n\nWhenever a user deposits `LYX`, they receive same amount of `sLYX` and start earning `rLYX` directly deposited to their UP. By approving `rLYX` amount to be used by relayer's operator contract.\n\n### Relayer Operator\n\nRelayer operator contract facilitates tracking and deduction of `rLYX` from specific UP addresses. For example, whenever a transaction is made, relayer's EOA pays required fees. In the meantime, relayer's oracles are observing pending transaction status to determine exact amount of fees paid. Once transaction is settled (failed or succeded), oracles submit usage to relayer's operator contract, which calculatates a configurable service fee and deducts total `rLYX` balance from the user. Deducted `rLYX` is send transferred to relayer's EOA.\n\n## Customers\n\n### New Users\n\nNew users to Lukso ecosystem can leverage Wise relayer service to get 100 free transactions per month. This is subsidized through earned fees in `rLYX`.\n\n### Users with LYX\n\nUsers who own `LYX` can deposit and start earning `rLYX`. They can bind their `rLYX` to pay for transaction fees. Users would continue earning rewards at a smaller rate and not worry about spending their `LYX`. In some countries, this can also be used to smooth taxation process as earned `rLYX` can be reused for fees being paid.\n\n### Businesses with LYX\n\nBusinesses would purchase `LYX` and deposit it to a pool to start earning `rLYX`. This benefits business in several ways:\n1. Business does not need to purchase more `LYX` as rewards might be sufficient to cover their customers fees\n2. Original investment of `LYX` is not spent, but working for business itself\n\nThe relayer API works slightly different in this case. Businsess's UP that deposited `LYX`, can generate an API key. This API key can be configured to limit blockchain interraction to a preset list of contracts. Businesse's UP can modify the contract list at any point of time on the dashboard.\n\nCustomers can use the business's relayer API url to pay no fees when interraction with allowed contracts.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flykhonis%2Frelayer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flykhonis%2Frelayer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flykhonis%2Frelayer/lists"}