{"id":30045721,"url":"https://github.com/hadv/vito-interface","last_synced_at":"2025-08-07T07:57:10.322Z","repository":{"id":286275228,"uuid":"960759614","full_name":"hadv/vito-interface","owner":"hadv","description":"on-chain secure and efficient application designed to interact with safe{wallet} ","archived":false,"fork":false,"pushed_at":"2025-08-06T11:11:57.000Z","size":940,"stargazers_count":2,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-06T13:07:30.421Z","etag":null,"topics":["ethereum","safe","wallet"],"latest_commit_sha":null,"homepage":"https://ethersafe.org","language":"TypeScript","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/hadv.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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,"zenodo":null}},"created_at":"2025-04-05T02:29:22.000Z","updated_at":"2025-08-03T03:55:26.000Z","dependencies_parsed_at":"2025-06-10T09:25:08.756Z","dependency_job_id":"3f9b5bff-1b53-46d8-b164-1cb9a50f09ff","html_url":"https://github.com/hadv/vito-interface","commit_stats":null,"previous_names":["hadv/vito-interface"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hadv/vito-interface","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hadv%2Fvito-interface","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hadv%2Fvito-interface/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hadv%2Fvito-interface/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hadv%2Fvito-interface/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hadv","download_url":"https://codeload.github.com/hadv/vito-interface/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hadv%2Fvito-interface/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269220671,"owners_count":24380624,"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","status":"online","status_checked_at":"2025-08-07T02:00:09.698Z","response_time":73,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["ethereum","safe","wallet"],"created_at":"2025-08-07T07:57:07.016Z","updated_at":"2025-08-07T07:57:10.313Z","avatar_url":"https://github.com/hadv.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Vito Safe{Wallet}\n\nA secure and efficient static web application designed to interact with Safe{Wallet} through a minimalist interface. Fully client-side with no backend dependencies.\n\n## Features\n\n- **Static Deployment**: No server required - deploy anywhere\n- **Safe Wallet Management**: Connect and manage Safe wallets\n- **Multi-Network Support**: Ethereum, Sepolia, Arbitrum\n- **WalletConnect Integration**: Connect mobile wallets via QR codes\n- **Web3Auth Social Login**: Google OAuth integration\n- **Transaction Management**: View, create, and execute transactions\n- **Address Book**: Manage trusted addresses\n- **PWA Support**: Mobile app-like experience\n\n## Tech Stack\n\n- **Frontend**: React, TypeScript, Tailwind CSS\n- **Wallet Integration**: WalletConnect v2, Web3Auth, Ethers.js\n- **Build System**: Create React App with custom webpack config\n- **Deployment**: Static files (HTML, CSS, JS)\n\n## Project Structure\n\n```\nvito-interface/\n├── client/                # React frontend (static app)\n│   ├── src/\n│   │   ├── components/    # Reusable UI components\n│   │   ├── hooks/         # Custom React hooks\n│   │   ├── models/        # TypeScript interfaces/types\n│   │   ├── services/      # External API services\n│   │   ├── utils/         # Utility functions\n│   │   └── contracts/     # Smart contract ABIs\n│   ├── public/            # Static assets\n│   ├── build/             # Production build output\n│   └── .env               # Environment variables\n├── vito-contracts/        # Smart contracts\n└── package.json          # Root package configuration\n```\n\n## Getting Started\n\n### Prerequisites\n\n- Node.js (LTS version recommended)\n- npm or yarn\n\n### Environment Setup\n\nConfigure the environment variables:\n- Copy `client/.env.example` to `client/.env.local`\n- Set appropriate values for all environment variables (see STATIC_DEPLOYMENT_GUIDE.md for details)\n\n### Installation\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/hadv/vito-interface.git\ncd vito-interface\n```\n\n2. Install dependencies:\n```bash\n# Use nvm to set the correct Node.js version (if available)\nnvm use --lts\n\n# Install dependencies\nnpm run install:all\n```\n\n### Running the Development Server\n\nRun the client in development mode:\n\n```bash\nnpm run dev\n# or\nnpm start\n```\n\nThe application will be available at `http://localhost:3000`\n\n### Building for Production\n\nTo create a production build:\n\n```bash\nnpm run build\n```\n\nThis creates a `client/build/` directory with static files ready for deployment to any web server or hosting service.\n\n## Web3Auth-Style Social Login Setup\n\nThe Vito interface supports Web3Auth-style social login using Google OAuth, allowing users to connect using their Google accounts with deterministic wallet generation.\n\n### 1. Set up Web3Auth Dashboard (REQUIRED)\n\n1. Visit the [Web3Auth Dashboard](https://dashboard.web3auth.io/)\n2. Sign up or log in to your account\n3. Create a new project\n4. Copy your **Web3Auth Client ID** from the project dashboard\n5. In your Web3Auth project, go to \"Social Connections\"\n6. Configure Google OAuth:\n   - Click on Google connection settings\n   - You can either:\n     - **Option A**: Use Web3Auth's default Google configuration (recommended)\n     - **Option B**: Use your own Google OAuth Client ID (advanced)\n\n### 2. Optional: Configure Custom Google OAuth (Advanced)\n\nOnly needed if you want to use your own Google OAuth configuration:\n\n1. Go to the [Google Cloud Console](https://console.developers.google.com/)\n2. Create a new project or select an existing one\n3. Enable the Google Identity Services API\n4. Go to \"Credentials\" and create an OAuth 2.0 Client ID\n5. Set the application type to \"Web application\"\n6. Add `https://auth.web3auth.io/auth` to \"Authorized redirect URIs\"\n7. Copy your **Google Client ID**\n8. Add it to your Web3Auth Dashboard under Social Connections\n\n### 3. Update Environment Variables\n\nCopy the `.env.example` file to `.env.local` in the client directory and update:\n\n```bash\n# Web3Auth Configuration (REQUIRED)\nREACT_APP_WEB3AUTH_CLIENT_ID=your-web3auth-client-id-here\n\n# Google OAuth Configuration (optional - for fallback methods only)\nREACT_APP_GOOGLE_CLIENT_ID=your-google-oauth-client-id-here\n```\n\n### 4. Test the Integration\n\n1. Start the development server\n2. Click \"Connect\" in the header\n3. Select \"Google\" from the wallet options\n4. Complete the Google OAuth flow\n5. Your Google account will be connected as a signer wallet\n\n### Features\n\n- **Social Login**: Users can connect using their Google accounts\n- **Deterministic Wallets**: Same Google account always generates the same wallet address\n- **Seamless Integration**: Works alongside existing MetaMask and WalletConnect options\n- **No Complex Dependencies**: Uses Google Identity Services directly\n- **User-Friendly**: No need to manage private keys manually\n- **Web3Auth Compatible**: Ready for future Web3Auth SDK integration\n- **Multi-Network Support**: Works across different blockchain networks\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhadv%2Fvito-interface","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhadv%2Fvito-interface","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhadv%2Fvito-interface/lists"}