Feat: Foundation Support and NFT contracts

[Bran18]

🎯 Overview

This PR introduces foundational infrastructure for the KindFi platform, including smart contract support for NFTs and reputation systems, along with a complete foundation management feature.

🚀 Key Features

1. Smart Contracts (Soroban/Rust)

NFT Contract (nft-kindfi)

• Core Functionality: Mint, burn, and metadata management for NFTs
• Components:
  • mint.rs: NFT minting logic
  • burn.rs: NFT burning functionality
  • metadata.rs: On-chain metadata handling
  • events.rs: Event emission for contract actions
  • errors.rs: Custom error types
  • Comprehensive test suite (test.rs)
• Deployment: Automated deployment script (deploy-nft.sh)

Reputation Contract

• Core Functionality: Reputation tracking and NFT-based credential system
• Components:
  • lib.rs: Main contract logic (576 lines)
  • nft_client.rs: NFT contract integration (327 lines)
  • storage.rs: State management (214 lines)
  • events.rs: Event emissions for reputation changes
  • types.rs: Type definitions
  • Comprehensive test coverage (test.rs)
• Deployment: Automated deployment script (deploy-reputation.sh)

2. Foundation Management System

Frontend Components

• Foundation Discovery:

  • Public foundation listing page with filtering
  • Individual foundation detail pages with tabs
  • Foundation cards with statistics and visual branding

• Foundation Creation:

  • Multi-step form with validation
  • Sections: Basic info, logo upload, mission/vision, social links
  • Real-time slug validation
  • Client-side form state management

• Foundation Management:

  • Command center dashboard with overview metrics
  • Campaign management interface
  • Member management with role assignment
  • Milestone tracking system
  • Foundation settings and editing
  • Escrow integration for financial operations

Backend API

• Endpoints:
  • POST /api/foundations/create: Create new foundation
  • GET /api/foundations/[slug]: Get foundation details
  • GET /api/foundations/[slug]/campaigns: List campaigns
  • GET /api/foundations/[slug]/milestones: List milestones
  • GET /api/foundations/check-slug: Validate slug availability

Database Schema

• Foundation tables and relationships
• Support for campaigns, members, and milestones
• Integration with existing project system

3. KYC Integration (Didit Provider)

API Endpoints

• POST /api/kyc/didit/create-session: Initialize KYC session
• GET /api/kyc/didit/check-status: Check verification status
• GET /api/kyc/didit/callback: Handle OAuth callback
• POST /api/kyc/didit/webhook: Process real-time updates
• GET /api/kyc/status: General KYC status check

UI Components

• KYC flow components (kyc-1, kyc-2, kyc-4)
• Status indicators and verification progress
• Error handling and retry mechanisms

Database

• New migration: allow_users_create_own_kyc_reviews
• KYC session and status tracking

4. Project Enhancements

• Foundation association for projects
• Team member management with new project_team table
• Enhanced escrow contract integration

5. Developer Experience

Documentation

• Updated contract README with deployment instructions
• Environment configuration examples (.env.example)
• Detailed NFT contract documentation (349 lines)
• Reputation contract documentation (540 lines)

Code Quality Guidelines

• Vercel React best practices (57 rules)
• Composition patterns (8 rules)
• Web design guidelines
• AI coding assistant configurations

📊 Impact

• Files Changed: 345
• Additions: +33,069 lines
• Deletions: -8,861 lines
• New Contracts: 2 (NFT + Reputation)
• New Pages: 11 foundation-related pages
• New API Routes: 7 endpoints
• Database Migrations: 4

🔧 Technical Details

Smart Contract Stack

• Language: Rust
• Platform: Soroban (Stellar)
• Testing: Comprehensive unit and integration tests
• Deployment: Automated shell scripts with environment configuration

Frontend Stack

• Framework: Next.js 14+ (App Router)
• Components: React Server Components + Client Components
• State Management: React Context + Hooks
• Styling: Tailwind CSS
• Forms: React Hook Form with validation

Backend Stack

• API: Next.js API Routes
• Database: Supabase (PostgreSQL)
• Authentication: Supabase Auth
• KYC: Didit integration

🧪 Testing

• Smart contract test coverage for both NFT and Reputation contracts
• Client-side validation for form inputs
• API error handling and edge cases

📝 Configuration

• New environment variables required (see .env.example)
• Contract deployment configuration
• KYC provider credentials

🔐 Security Considerations

• KYC webhook signature verification
• Role-based access control for foundation management
• Smart contract security patterns
• Secure credential handling

🚦 Deployment Notes

1. Run database migrations in services/supabase/migrations/
2. Deploy NFT contract using scripts/deploy-nft.sh
3. Deploy Reputation contract using scripts/deploy-reputation.sh
4. Update environment variables with contract addresses
5. Configure KYC provider credentials

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
kindfi	Ready	Preview, Comment	Feb 5, 2026 6:31pm

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

• 🔍 Trigger a full review

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch develop

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[Bran18]

@coderabbitai create the PR description and summary of the changes

[coderabbitai]

Tip

For best results, initiate chat on the files or code changes.

🧩 Analysis chain

@Bran18, I'll analyze the changes in this PR and create a comprehensive description and summary for you.

---

🏁 Script executed:

#!/bin/bash

# Get PR information
echo "=== PR Information ==="
gh pr view 781 --json title,author,additions,deletions,changedFiles

# Get list of changed files
echo -e "\n=== Changed Files ==="
gh pr diff 781 --name-only

# Get the full diff to understand the changes
echo -e "\n=== Full Diff ==="
gh pr diff 781

Length of output: 829

---

🏁 Script executed:

#!/bin/bash

# Use the GitHub API to list PR files
echo "=== PR Files (first batch) ==="
gh api repos/kindfi-org/kindfi/pulls/781/files --paginate | jq -r '.[] | "\(.status)\t\(.filename)\t+\(.additions)/-\(.deletions)"' | head -100

echo -e "\n=== File Categories ==="
gh api repos/kindfi-org/kindfi/pulls/781/files --paginate | jq -r '.[].filename' | while read file; do
  dirname "$file"
done | sort | uniq -c | sort -rn | head -30

echo -e "\n=== Key File Types ==="
gh api repos/kindfi-org/kindfi/pulls/781/files --paginate | jq -r '.[].filename' | sed 's/.*\.//' | sort | uniq -c | sort -rn | head -20

echo -e "\n=== Solidity Contract Files ==="
gh api repos/kindfi-org/kindfi/pulls/781/files --paginate | jq -r '.[] | select(.filename | endswith(".sol")) | .filename'

echo -e "\n=== New Contract Files (added) ==="
gh api repos/kindfi-org/kindfi/pulls/781/files --paginate | jq -r '.[] | select(.status == "added" and (.filename | endswith(".sol"))) | .filename'

Length of output: 9591

---

🏁 Script executed:

#!/bin/bash

# Get more details about contract changes
echo "=== Rust Contract Files ==="
gh api repos/kindfi-org/kindfi/pulls/781/files --paginate | jq -r '.[] | select(.filename | contains("contract")) | "\(.status)\t\(.filename)\t+\(.additions)/-\(.deletions)"'

echo -e "\n=== Foundation-related Files ==="
gh api repos/kindfi-org/kindfi/pulls/781/files --paginate | jq -r '.[] | select(.filename | contains("foundation")) | "\(.status)\t\(.filename)\t+\(.additions)/-\(.deletions)"'

echo -e "\n=== Key TypeScript/React Components ==="
gh api repos/kindfi-org/kindfi/pulls/781/files --paginate | jq -r '.[] | select(.filename | endswith(".tsx") or endswith(".ts")) | select(.filename | contains("foundation") or contains("nft") or contains("kyc")) | "\(.status)\t\(.filename)\t+\(.additions)/-\(.deletions)"' | head -40

echo -e "\n=== Database Migration Files ==="
gh api repos/kindfi-org/kindfi/pulls/781/files --paginate | jq -r '.[] | select(.filename | contains("migration")) | .filename'

echo -e "\n=== NFT Contract Structure ==="
ls -la apps/contract/contracts/nft-kindfi/src/ 2>/dev/null || echo "Directory not in workspace"

echo -e "\n=== Checking main contract lib files ==="
fd -e rs . apps/contract/contracts/ --exec echo {}

Length of output: 11740

---

@Bran18, I've analyzed the changes in this PR. Here's a comprehensive description and summary:

---

🏁 Script executed:

#!/bin/bash

Update PR description

gh pr edit 781 --body "## 🎯 Overview

This PR introduces foundational infrastructure for the KindFi platform, including smart contract support for NFTs and reputation systems, along with a complete foundation management feature.

🚀 Key Features

1. Smart Contracts (Soroban/Rust)

NFT Contract (`nft-kindfi`)

• Core Functionality: Mint, burn, and metadata management for NFTs
• Components:
  • `mint.rs`: NFT minting logic
  • `burn.rs`: NFT burning functionality
  • `metadata.rs`: On-chain metadata handling
  • `events.rs`: Event emission for contract actions
  • `errors.rs`: Custom error types
  • Comprehensive test suite (`test.rs`)
• Deployment: Automated deployment script (`deploy-nft.sh`)

Reputation Contract

• Core Functionality: Reputation tracking and NFT-based credential system
• Components:
  • `lib.rs`: Main contract logic (576 lines)
  • `nft_client.rs`: NFT contract integration (327 lines)
  • `storage.rs`: State management (214 lines)
  • `events.rs`: Event emissions for reputation changes
  • `types.rs`: Type definitions
  • Comprehensive test coverage (`test.rs`)
• Deployment: Automated deployment script (`deploy-reputation.sh`)

2. Foundation Management System

Frontend Components

• Foundation Discovery:

  • Public foundation listing page with filtering
  • Individual foundation detail pages with tabs
  • Foundation cards with statistics and visual branding

• Foundation Creation:

  • Multi-step form with validation
  • Sections: Basic info, logo upload, mission/vision, social links
  • Real-time slug validation
  • Client-side form state management

• Foundation Management:

  • Command center dashboard with overview metrics
  • Campaign management interface
  • Member management with role assignment
  • Milestone tracking system
  • Foundation settings and editing
  • Escrow integration for financial operations

Backend API

• Endpoints:
  • `POST /api/foundations/create`: Create new foundation
  • `GET /api/foundations/[slug]`: Get foundation details
  • `GET /api/foundations/[slug]/campaigns`: List campaigns
  • `GET /api/foundations/[slug]/milestones`: List milestones
  • `GET /api/foundations/check-slug`: Validate slug availability

Database Schema

• Foundation tables and relationships
• Support for campaigns, members, and milestones
• Integration with existing project system

3. KYC Integration (Didit Provider)

API Endpoints

• `POST /api/kyc/didit/create-session`: Initialize KYC session
• `GET /api/kyc/didit/check-status`: Check verification status
• `GET /api/kyc/didit/callback`: Handle OAuth callback
• `POST /api/kyc/didit/webhook`: Process real-time updates
• `GET /api/kyc/status`: General KYC status check

UI Components

• KYC flow components (kyc-1, kyc-2, kyc-4)
• Status indicators and verification progress
• Error handling and retry mechanisms

Database

• New migration: `allow_users_create_own_kyc_reviews`
• KYC session and status tracking

4. Project Enhancements

• Foundation association for projects
• Team member management with new `project_team` table
• Enhanced escrow contract integration

5. Developer Experience

Documentation

• Updated contract README with deployment instructions
• Environment configuration examples (`.env.example`)
• Detailed NFT contract documentation (349 lines)
• Reputation contract documentation (540 lines)

Code Quality Guidelines

• Vercel React best practices (57 rules)
• Composition patterns (8 rules)
• Web design guidelines
• AI coding assistant configurations

📊 Impact

• Files Changed: 345
• Additions: +33,069 lines
• Deletions: -8,861 lines
• New Contracts: 2 (NFT + Reputation)
• New Pages: 11 foundation-related pages
• New API Routes: 7 endpoints
• Database Migrations: 4

🔧 Technical Details

Smart Contract Stack

• Language: Rust
• Platform: Soroban (Stellar)
• Testing: Comprehensive unit and integration tests
• Deployment: Automated shell scripts with environment configuration

Frontend Stack

• Framework: Next.js 14+ (App Router)
• Components: React Server Components + Client Components
• State Management: React Context + Hooks
• Styling: Tailwind CSS
• Forms: React Hook Form with validation

Backend Stack

• API: Next.js API Routes
• Database: Supabase (PostgreSQL)
• Authentication: Supabase Auth
• KYC: Didit integration

🧪 Testing

• Smart contract test coverage for both NFT and Reputation contracts
• Client-side validation for form inputs
• API error handling and edge cases

📝 Configuration

• New environment variables required (see `.env.example`)
• Contract deployment configuration
• KYC provider credentials

🔐 Security Considerations

• KYC webhook signature verification
• Role-based access control for foundation management
• Smart contract security patterns
• Secure credential handling

🚦 Deployment Notes

1. Run database migrations in `services/supabase/migrations/`
2. Deploy NFT contract using `scripts/deploy-nft.sh`
3. Deploy Reputation contract using `scripts/deploy-reputation.sh`
4. Update environment variables with contract addresses
5. Configure KYC provider credentials"

echo "✅ PR description updated successfully!"

Length of output: 84

---



</details>

`@Bran18`, I've successfully created and updated the PR description! 🎉

## Summary

This is a **major feature release** that adds foundational infrastructure to KindFi:

### 🔑 Key Additions

1. **Smart Contracts (Rust/Soroban)**
   - NFT contract with mint/burn/metadata capabilities
   - Reputation contract with NFT integration for credentials
   - Automated deployment scripts

2. **Foundation Management System**
   - Complete CRUD operations for foundations
   - Multi-page management interface (campaigns, members, milestones, settings)
   - Public discovery and detail pages
   - Integration with existing project system

3. **KYC Integration**
   - Didit provider integration with webhook support
   - Multi-step KYC flow components
   - Session management and status tracking

4. **Developer Experience**
   - Comprehensive documentation (889 lines for contracts)
   - React best practices and composition patterns (65+ rules)
   - Environment configuration templates

### 📊 Stats
- **345 files** changed
- **+33,069** lines added
- **-8,861** lines removed
- **2 new smart contracts**
- **11 new pages**
- **7 new API endpoints**

The PR description has been updated with detailed technical information, deployment notes, and security considerations. You can view it at the PR link above! ✨