{"id":28349316,"url":"https://github.com/blockful/trustful-stellar","last_synced_at":"2026-03-07T08:03:18.671Z","repository":{"id":271772477,"uuid":"909887098","full_name":"blockful/trustful-stellar","owner":"blockful","description":null,"archived":false,"fork":false,"pushed_at":"2025-08-14T22:28:22.000Z","size":1761,"stargazers_count":0,"open_issues_count":1,"forks_count":3,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-14T23:23:46.063Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://demo-stellar.trust.ful.xyz","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/blockful.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":"2024-12-30T01:31:21.000Z","updated_at":"2025-08-14T22:28:29.000Z","dependencies_parsed_at":"2025-01-24T16:26:32.798Z","dependency_job_id":"4d391e5a-d315-42c0-86fc-fc8691508e7e","html_url":"https://github.com/blockful/trustful-stellar","commit_stats":null,"previous_names":["blockful-io/trustful-stellar","blockful/trustful-stellar"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/blockful/trustful-stellar","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blockful%2Ftrustful-stellar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blockful%2Ftrustful-stellar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blockful%2Ftrustful-stellar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blockful%2Ftrustful-stellar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/blockful","download_url":"https://codeload.github.com/blockful/trustful-stellar/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blockful%2Ftrustful-stellar/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30209797,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-07T05:23:27.321Z","status":"ssl_error","status_checked_at":"2026-03-07T05:00:17.256Z","response_time":53,"last_error":"SSL_read: 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":"2025-05-27T19:41:07.791Z","updated_at":"2026-03-07T08:03:18.637Z","avatar_url":"https://github.com/blockful.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"public/trustful-logo.svg\" alt=\"Trustful Stellar Logo\" width=\"200\" height=\"200\"\u003e\n\n# 🌟 Trustful Stellar\n\n**Transform Your Stellar Achievements Into Verifiable On-Chain Reputation**\n\n[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://choosealicense.com/licenses/mit/)\n[![Node.js](https://img.shields.io/badge/Node.js-18.x-green.svg)](https://nodejs.org/)\n[![Next.js](https://img.shields.io/badge/Next.js-14.2.4-black)](https://nextjs.org/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue)](https://typescriptlang.org/)\n[![Tailwind CSS](https://img.shields.io/badge/Tailwind%20CSS-3.4.1-38B2AC)](https://tailwindcss.com/)\n[![Stellar](https://img.shields.io/badge/Stellar-Network-7B2CBF)](https://stellar.org/)\n\n[🚀 Live Demo](#) • [📖 Documentation](#) • [🐛 Report Bug](https://github.com/blockful-io/trustful-stellar/issues) • [✨ Request Feature](https://github.com/blockful-io/trustful-stellar/issues)\n\n\u003c/div\u003e\n\n---\n\n## 🎯 What is Trustful Stellar?\n\n**Trustful Stellar** is a cutting-edge decentralized application (dApp) that revolutionizes on-chain reputation for the **Stellar ecosystem**. We transform your blockchain achievements—like **Stellar Quest badges** and ecosystem contributions—into verifiable, transparent, and actionable reputation scores.\n\n### 💡 The Problem We Solve\n\nIn decentralized communities, proving your contributions and expertise is challenging. Traditional reputation systems are centralized and opaque. Trustful Stellar bridges this gap by creating a **trustless, verifiable reputation system** that communities can use for:\n\n- 🗳️ **Governance voting** with weighted reputation\n- 💰 **Grant allocation** based on proven track record\n- 👥 **Role assignments** with verified credentials\n- 🤝 **Community participation** with transparent standing\n\n---\n\n## ✨ Key Features\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"25%\"\u003e\n\n### 🔗 **Wallet Integration**\n\n- **Stellar Wallet** (Albedo) for achievement retrieval\n\n### 🛡️ **Verifiable Reputation**\n\n- On-chain attestation and verification\n\n\u003c/td\u003e\n\u003ctd width=\"25%\"\u003e\n\n### 🏘️ **Community-Driven**\n\n- Multiple community contexts supported\n\n### 🎨 **Modern UI/UX**\n\n- Intuitive navigation and feedback\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n### 🛠️ **Core Technologies**\n\n| Category             | Technologies                                   |\n| -------------------- | ---------------------------------------------- |\n| **Frontend**         | Next.js 14, React 18, TypeScript, Tailwind CSS |\n| **State Management** | Zustand, React Query, React Hook Form          |\n| **Blockchain**       | Stellar SDK, Albedo                            |\n| **UI/UX**            | Lucide React, React Hot Toast, React Tooltip   |\n| **Development**      | Storybook, ESLint, Prettier, PostCSS           |\n\n---\n\n## 🚀 Quick Start\n\n### 📋 Prerequisites\n\n- **Node.js** 18.x or higher\n- **npm** or **yarn**\n- **Git**\n\n### ⚡ Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/blockful-io/trustful-stellar.git\n\n# Navigate to project directory\ncd trustful-stellar\n\n# Install dependencies\nnpm install\n\n# Copy environment file\ncp .env.example .env\n```\n\n### 🔧 Environment Setup\n\nCreate your `.env` file with the following variables:\n\n```env\n\nNEXT_PUBLIC_ENV=\nNEXT_PUBLIC_API_URL=\nNEXT_PUBLIC_RPC_URL=\nNEXT_PUBLIC_NETWORK=\nNEXT_PUBLIC_FACTORY_CONTRACT_ID=\n\n```\n\n### 🎬 Running the Application\n\n```bash\n# Start development server\nnpm run dev\n\n# Open your browser\n# Navigate to http://localhost:3000\n```\n\n### 📚 Component Development\n\n```bash\n# Start Storybook for UI development\nnpm run storybook\n\n# Open component library\n# Navigate to http://localhost:6006\n```\n\n---\n\n## 📖 Usage Guide\n\n### 1️⃣ **Connect Your Wallets**\n\n- Link your Stellar wallet (Albedo) to access your achievements\n\n### 2️⃣ **Verify Your Reputation**\n\n- Trustful Stellar registers user reputation\n\n### 3️⃣ **Join Communities**\n\n- Browse available reputation contexts\n- See how your score applies in different communities\n\n---\n\n## 🗂️ Project Structure\n\n```\ntrustful-stellar/\n├── 📁 src/                    # Source code\n│   ├── 📁 components/         # Reusable UI components\n│   ├── 📁 hooks/             # Custom React hooks\n│   ├── 📁 lib/               # Utility libraries\n│   └── 📁 types/             # TypeScript definitions\n├── 📁 app/                   # Next.js App Router\n├── 📁 public/               # Static assets\n├── 📁 .storybook/           # Storybook configuration\n├── 📄 tailwind.config.ts    # Tailwind configuration\n└── 📄 next.config.mjs       # Next.js configuration\n```\n\n---\n\n## 🔄 Available Scripts\n\n| Command                   | Description                       |\n| ------------------------- | --------------------------------- |\n| `npm run dev`             | 🏃‍♂️ Start development server       |\n| `npm run build`           | 🏗️ Build production application   |\n| `npm run start`           | 🚀 Start production server        |\n| `npm run lint`            | 🧹 Run ESLint for code quality    |\n| `npm run storybook`       | 📚 Start Storybook development    |\n| `npm run build-storybook` | 📦 Build Storybook for deployment |\n\n---\n\n## 🤝 Contributing\n\nWe love contributions! Here's how you can help make Trustful Stellar even better:\n\n### 🔥 Quick Contribution Steps\n\n1. **Fork** the repository\n2. **Create** a feature branch (`git checkout -b feature/amazing-feature`)\n3. **Commit** your changes (`git commit -m 'Add amazing feature'`)\n4. **Push** to the branch (`git push origin feature/amazing-feature`)\n5. **Open** a Pull Request\n\n### 📋 Development Guidelines\n\n- ✅ Use TypeScript for type safety\n- ✅ Follow existing code patterns and structure\n- ✅ Add comments and documentation\n- ✅ Write tests when applicable\n- ✅ Use semantic HTML and ARIA attributes\n- ✅ Leverage Tailwind CSS classes from `globals.css`\n\n### 🐛 Bug Reports \u0026 Feature Requests\n\nFound a bug or have an idea? [Open an issue](https://github.com/blockful-io/trustful-stellar/issues) and let's discuss it!\n\n---\n\n## 🏢 About Blockful\n\n\u003cdiv align=\"center\"\u003e\n  \n**Built with ❤️ by [Blockful](https://blockful.io)**\n\nWe're passionate about building the future of decentralized technologies and creating tools that empower communities.\n\n[🌐 Website](https://blockful.io) • [🐦 X](https://x.com/blockful_io) • [💼 LinkedIn](https://linkedin.com/company/blockful)\n\n\u003c/div\u003e\n\n---\n\n## 📜 License\n\nThis project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n### 🌟 Star this repository if you found it helpful!\n\n**Made with 💜 for the Stellar Ecosystem**\n\n[⬆️ Back to Top](#-trustful-stellar)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblockful%2Ftrustful-stellar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblockful%2Ftrustful-stellar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblockful%2Ftrustful-stellar/lists"}