Skip to content

feat: implement advanced credit scoring with on-chain history #76

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ISTIFANUS-N merged 4 commits into from
Jan 26, 2026
Merged

feat: implement advanced credit scoring with on-chain history #76

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
5b03743
feat: implement advanced credit scoring with on-chain history
ikemHood Jan 23, 2026
4f83633
Merge branch 'main' into feat/credit_score
ikemHood Jan 24, 2026
9f6d6d0
Merge branch 'main' into feat/credit_score
ikemHood Jan 25, 2026
c5691bd
Merge branch 'main' into feat/credit_score
ikemHood Jan 26, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions contracts/teachlink/src/bridge.rs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -383,4 +383,9 @@ impl Bridge {
pub fn get_token(env: &Env) -> Address {
env.storage().instance().get(&TOKEN).unwrap()
}

/// Get the admin address
pub fn get_admin(env: &Env) -> Address {
env.storage().instance().get(&ADMIN).unwrap()
}
}
36 changes: 33 additions & 3 deletions contracts/teachlink/src/events.rs
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,11 @@
use soroban_sdk::contractevent;

use crate::types::{BridgeTransaction, CrossChainMessage, DisputeOutcome, Escrow, EscrowStatus};
use crate::types::{
BridgeTransaction, ContributionType, CrossChainMessage, DisputeOutcome, Escrow, EscrowStatus,
// Added implied types from main branch events to ensure compilation
ContentMetadata, ProvenanceRecord,
};

use soroban_sdk::{Address, Bytes, String};

#[contractevent]
Expand Down Expand Up @@ -108,7 +113,32 @@ pub struct EscrowResolvedEvent {
pub status: EscrowStatus,
}

// ========== Content Tokenization Events ==========
// ========== Credit Score Events (feat/credit_score) ==========

#[contractevent]
#[derive(Clone, Debug)]
pub struct CreditScoreUpdatedEvent {
pub user: Address,
pub new_score: u64,
}

#[contractevent]
#[derive(Clone, Debug)]
pub struct CourseCompletedEvent {
pub user: Address,
pub course_id: u64,
pub points: u64,
}

#[contractevent]
#[derive(Clone, Debug)]
pub struct ContributionRecordedEvent {
pub user: Address,
pub c_type: ContributionType,
pub points: u64,
}

// ========== Content Tokenization Events (main) ==========

#[contractevent]
#[derive(Clone, Debug)]
Expand Down Expand Up @@ -140,4 +170,4 @@ pub struct MetadataUpdatedEvent {
pub token_id: u64,
pub owner: Address,
pub timestamp: u64,
}
}
51 changes: 47 additions & 4 deletions contracts/teachlink/src/lib.rs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,15 +5,18 @@ use soroban_sdk::{contract, contractimpl, Address, Bytes, Env, String, Vec};
mod bridge;
mod escrow;
mod events;
mod provenance;
mod reputation;
mod rewards;
mod score;
mod storage;
mod tokenization;
mod types;

pub use types::{
BridgeTransaction, CrossChainMessage, DisputeOutcome, Escrow, EscrowStatus, RewardRate,
UserReward,
BridgeTransaction, ContentToken, ContentType, Contribution, ContributionType,
CrossChainMessage, DisputeOutcome, Escrow, EscrowStatus, ProvenanceRecord, RewardRate,
UserReputation, UserReward,
};

#[contract]
Expand Down Expand Up @@ -257,7 +260,45 @@ impl TeachLinkBridge {
escrow::EscrowManager::get_escrow_count(&env)
}

// ========== Reputation Functions ==========
// ========== Credit Scoring Functions (feat/credit_score) ==========

/// Record a course completion (admin only for now, or specific authority)
pub fn record_course_completion(env: Env, user: Address, course_id: u64, points: u64) {
// require admin
let admin = bridge::Bridge::get_admin(&env);
admin.require_auth();
score::ScoreManager::record_course_completion(&env, user, course_id, points);
}

/// Record a contribution (admin only)
pub fn record_contribution(
env: Env,
user: Address,
c_type: types::ContributionType,
description: Bytes,
points: u64,
) {
let admin = bridge::Bridge::get_admin(&env);
admin.require_auth();
score::ScoreManager::record_contribution(&env, user, c_type, description, points);
}

/// Get user's credit score
pub fn get_credit_score(env: Env, user: Address) -> u64 {
score::ScoreManager::get_score(&env, user)
}

/// Get user's completed courses
pub fn get_user_courses(env: Env, user: Address) -> Vec<u64> {
score::ScoreManager::get_courses(&env, user)
}

/// Get user's contributions
pub fn get_user_contributions(env: Env, user: Address) -> Vec<types::Contribution> {
score::ScoreManager::get_contributions(&env, user)
}

// ========== Reputation Functions (main) ==========

pub fn update_participation(env: Env, user: Address, points: u32) {
reputation::update_participation(&env, user, points);
Expand All @@ -273,6 +314,8 @@ impl TeachLinkBridge {

pub fn get_user_reputation(env: Env, user: Address) -> types::UserReputation {
reputation::get_reputation(&env, &user)
}

// ========== Content Tokenization Functions ==========

/// Mint a new educational content token
Expand Down Expand Up @@ -398,4 +441,4 @@ impl TeachLinkBridge {
pub fn get_content_all_owners(env: Env, token_id: u64) -> Vec<Address> {
provenance::ProvenanceTracker::get_all_owners(&env, token_id)
}
}
}
108 changes: 108 additions & 0 deletions contracts/teachlink/src/score.rs
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,108 @@
use crate::events::{ContributionRecordedEvent, CourseCompletedEvent, CreditScoreUpdatedEvent};
use crate::storage::{CONTRIBUTIONS, COURSE_COMPLETIONS, CREDIT_SCORE};
use crate::types::{Contribution, ContributionType};
use soroban_sdk::{Address, Bytes, Env, Vec};

pub struct ScoreManager;

impl ScoreManager {
/// Update the user's score by adding points
pub fn update_score(env: &Env, user: Address, points: u64) {
// Use a tuple key (CREDIT_SCORE, user) for mapping user to score
let key = (CREDIT_SCORE, user.clone());
let current_score: u64 = env.storage().persistent().get(&key).unwrap_or(0);
let new_score = current_score + points;
env.storage().persistent().set(&key, &new_score);

CreditScoreUpdatedEvent { user, new_score }.publish(env);
}

/// Record a course completion and award points
pub fn record_course_completion(env: &Env, user: Address, course_id: u64, points: u64) {
let key = (COURSE_COMPLETIONS, user.clone());
let mut completed_courses: Vec<u64> = env
.storage()
.persistent()
.get(&key)
.unwrap_or(Vec::new(env));

// Avoid duplicate points for the same course
if completed_courses.contains(course_id) {
return; // Already completed
}

completed_courses.push_back(course_id);
env.storage().persistent().set(&key, &completed_courses);

// Update score internally
Self::update_score(env, user.clone(), points);

CourseCompletedEvent {
user,
course_id,
points,
}
.publish(env);
}

/// Record a contribution and award points
pub fn record_contribution(
env: &Env,
user: Address,
c_type: ContributionType,
description: Bytes,
points: u64,
) {
let key = (CONTRIBUTIONS, user.clone());
let mut contributions: Vec<Contribution> = env
.storage()
.persistent()
.get(&key)
.unwrap_or(Vec::new(env));

let contribution = Contribution {
contributor: user.clone(),
c_type: c_type.clone(),
description,
timestamp: env.ledger().timestamp(),
points,
};

contributions.push_back(contribution);
env.storage().persistent().set(&key, &contributions);

// Update score internally
Self::update_score(env, user.clone(), points);

ContributionRecordedEvent {
user,
c_type,
points,
}
.publish(env);
}

/// Get the user's current credit score
pub fn get_score(env: &Env, user: Address) -> u64 {
env.storage()
.persistent()
.get(&(CREDIT_SCORE, user))
.unwrap_or(0)
}

/// Get valid course completions
pub fn get_courses(env: &Env, user: Address) -> Vec<u64> {
env.storage()
.persistent()
.get(&(COURSE_COMPLETIONS, user))
.unwrap_or(Vec::new(env))
}

/// Get user contributions
pub fn get_contributions(env: &Env, user: Address) -> Vec<Contribution> {
env.storage()
.persistent()
.get(&(CONTRIBUTIONS, user))
.unwrap_or(Vec::new(env))
}
}
5 changes: 5 additions & 0 deletions contracts/teachlink/src/storage.rs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,11 @@ pub const TOTAL_REWARDS_ISSUED: Symbol = symbol_short!("tot_rwds");
pub const ESCROW_COUNT: Symbol = symbol_short!("esc_ct");
pub const ESCROWS: Symbol = symbol_short!("escrows");

// Storage keys for credit scoring
pub const CREDIT_SCORE: Symbol = symbol_short!("score");
pub const COURSE_COMPLETIONS: Symbol = symbol_short!("courses");
pub const CONTRIBUTIONS: Symbol = symbol_short!("contribs");

// Storage keys for content tokenization
pub const TOKEN_COUNTER: Symbol = symbol_short!("tok_cnt");
pub const CONTENT_TOKENS: Symbol = symbol_short!("cnt_tok");
Expand Down
29 changes: 26 additions & 3 deletions contracts/teachlink/src/types.rs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -85,6 +85,29 @@ pub enum DisputeOutcome {
RefundToDepositor,
}

// ========== Credit Score / Contribution Types (feat/credit_score) ==========

#[contracttype]
#[derive(Clone, Debug, Eq, PartialEq)]
pub enum ContributionType {
Content,
Code,
Community,
Governance,
}

#[contracttype]
#[derive(Clone, Debug, Eq, PartialEq)]
pub struct Contribution {
pub contributor: Address,
pub c_type: ContributionType,
pub description: Bytes,
pub timestamp: u64,
pub points: u64,
}

// ========== Reputation Types (main) ==========

#[contracttype]
#[derive(Clone, Debug, Eq, PartialEq)]
pub struct UserReputation {
Expand All @@ -95,6 +118,8 @@ pub struct UserReputation {
pub total_courses_completed: u32,
pub total_contributions: u32,
pub last_update: u64,
}

// ========== Educational Content Tokenization Types ==========

#[contracttype]
Expand Down Expand Up @@ -146,11 +171,9 @@ pub struct ProvenanceRecord {

#[contracttype]
#[derive(Clone, Debug, Eq, PartialEq)]
pub enum DataKey {
Reputation(Address),
pub enum TransferType {
Mint, // Initial creation
Transfer, // Standard ownership transfer
License, // Licensing agreement
Revoke, // Ownership revoked
}
}
Loading
Loading