{"id":20737592,"url":"https://github.com/patronum-labs/universalprofile-bot","last_synced_at":"2026-04-16T15:03:51.913Z","repository":{"id":251991140,"uuid":"835320249","full_name":"Patronum-Labs/universalprofile-bot","owner":"Patronum-Labs","description":"Telegram Bot for creating UniversalProfiles smart contract account on LUKSO Network using Relayer access","archived":false,"fork":false,"pushed_at":"2024-08-06T23:04:23.000Z","size":15,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-01-18T01:26:07.243Z","etag":null,"topics":["bot","lukso","telegram-bot","universal-profile"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Patronum-Labs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","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},"funding":{"custom":"https://etherscan.io/address/0x5D551AbEAD9b93ebd0D092722517136FF278c3D0"}},"created_at":"2024-07-29T15:37:25.000Z","updated_at":"2024-08-06T23:04:27.000Z","dependencies_parsed_at":"2024-08-07T02:36:19.100Z","dependency_job_id":null,"html_url":"https://github.com/Patronum-Labs/universalprofile-bot","commit_stats":null,"previous_names":["patronum-labs/universalprofile-bot"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Patronum-Labs%2Funiversalprofile-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Patronum-Labs%2Funiversalprofile-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Patronum-Labs%2Funiversalprofile-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Patronum-Labs%2Funiversalprofile-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Patronum-Labs","download_url":"https://codeload.github.com/Patronum-Labs/universalprofile-bot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243024209,"owners_count":20223558,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["bot","lukso","telegram-bot","universal-profile"],"created_at":"2024-11-17T06:14:57.176Z","updated_at":"2026-04-16T15:03:51.861Z","avatar_url":"https://github.com/Patronum-Labs.png","language":"JavaScript","funding_links":["https://etherscan.io/address/0x5D551AbEAD9b93ebd0D092722517136FF278c3D0"],"categories":[],"sub_categories":[],"readme":"# Universal Profile Telegram Bot\n\nThis project is a Telegram bot that creates Universal Profiles (UPs) on LUKSO using the LUKSO Relayer API. The bot collects basic information from users and encodes data keys that specify the Universal Receiver Delegate, its permissions, and a controller provided by the user.\n\n## Features\n\n- Creates Universal Profiles via Telegram interface\n- Collects user information (name, description, profile picture URL, Ethereum address)\n- Encodes data keys for Universal Receiver Delegate and permissions\n- Uses LUKSO Relayer API for profile creation\n\n## Potential Extensions\n\nDevelopers extending this bot can leverage the collected data (name, profile picture, description) to:\n\n1. Deploy metadata to IPFS using LUKSO data provider, and generate the LSP3Metdata and set it on the profile.\n2. Implementing a key system within Telegram, allowing users to perform simple transactions without providing an external address as the controller.\n\n## Prerequisites\n\n- Node.js and npm installed\n- LUKSO Relayer API access\n- Telegram Bot Token\n- ngrok for exposing the local server\n\n## Setup\n\n1. Clone the repository\n2. Install dependencies:\n```sh\nnpm install\n```\n\n3. Create a `.env` file in the root directory with the following variables:\n```sh\nTOKEN=your_telegram_bot_token\nAPI_KEY=your_lukso_relayer_api_key\nSERVER_URL=your_ngrok_url\n```\n\n## Obtaining Necessary Credentials\n\n1. Generate a Telegram Bot Token:\n- Talk to the BotFather on Telegram\n- Follow the prompts to create a new bot\n- Save the provided token in the `.env` file as `TOKEN`\n\n2. Request LUKSO Relayer API access:\n- Contact LUKSO to request access to the Relayer API\n- Once granted, save the API key in the `.env` file as `API_KEY`\n\n3. Set up ngrok:\n- Install ngrok: `npm install ngrok`\n- Run ngrok: `ngrok http 5001`\n- Copy the provided HTTPS URL (e.g., `https://x-x-x-x-x.ngrok-free.app`)\n- Save this URL in the `.env` file as `SERVER_URL`\n\n## Running the Bot\n\n1. Start the server:\n```\nnpm run dev\n```\n\nYour bot is now active. Send `/start` to your bot on Telegram to begin the profile creation process.\n\n## Note\n\nIf you prefer not to use the LUKSO Relayer and have your own method for creating profiles, you can modify the `createProfile` function to implement your custom logic.\n\n## Disclaimer\n\nThis bot requires access to the LUKSO Relayer API. Ensure you have the necessary permissions before deploying the bot.\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpatronum-labs%2Funiversalprofile-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpatronum-labs%2Funiversalprofile-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpatronum-labs%2Funiversalprofile-bot/lists"}