Loan Request Flow
The P2P lending process in usmewe is designed to be simple, transparent, and instant.
Overview
┌─────────────────────────────────────────────────────────────────┐
│ 1. REQUEST 2. MATCH 3. FUND 4. USE │
│ ───────────────────────────────────────────────────────────────│
│ User submits → System finds → Funds sent → Borrow │
│ loan request best rates instantly & repay │
└─────────────────────────────────────────────────────────────────┘
Step 1: Check Eligibility
Before requesting a loan, verify your borrowing limits:
Trust Score Minimum score of 10 required to borrow
Active Loans Maximum 3 active loans at once
// Check your borrowing eligibility
const eligibility = await usmewe . loans . checkEligibility ();
// Response
{
"eligible" : true ,
"maxAmount" : 100 ,
"maxDuration" : 30 ,
"currentLoans" : 1 ,
"trustScore" : 56
}
Step 2: Submit Request
Create a loan request with your desired parameters:
Parameter Description Constraints amountUSDC amount Based on Trust Score tier durationLoan term in days 7-90 days purposeReason for loan Optional but recommended
const loanRequest = await usmewe . loans . create ({
amount: 50 ,
duration: 14 ,
purpose: "Emergency expense"
});
// Response
{
"requestId" : "loan_req_abc123" ,
"status" : "pending" ,
"amount" : 50 ,
"duration" : 14 ,
"interestRate" : 0.03 , // 3%
"totalRepayment" : 51.50 ,
"expiresAt" : "2024-01-15T12:00:00Z"
}
Step 3: Automatic Matching
The system automatically matches your request with available liquidity:
Trust Vault Check
System checks if Trust Vault has sufficient liquidity
Rate Calculation
Interest rate calculated based on utilization and your Trust Score
Insurance Fee
10% of loan amount reserved for Insurance Pool
Instant Funding
Funds transferred to your wallet immediately
Step 4: Receive Funds
Once matched, funds are sent instantly to your connected wallet:
// Loan funded event
{
"event" : "loan.funded" ,
"loanId" : "loan_xyz789" ,
"amount" : 50 ,
"netAmount" : 45 , // After 10% insurance fee
"walletAddress" : "0x..." ,
"txHash" : "0x..." ,
"repaymentDue" : "2024-01-29T12:00:00Z"
}
The 10% insurance fee is deducted upfront. If you request 50 , y o u r e c e i v e 50, you receive 50 , yo u rece i v e 45.
Interest Rates
Interest rates are dynamic based on:
Factor Impact Trust Score Higher score = lower rate Vault Utilization Higher usage = higher rate Loan Duration Longer term = slightly higher rate Level Bonus Gold+ levels get rate discounts
Rate Tiers
Trust Score Base Rate 10-30 5% 31-50 4% 51-70 3% 71-85 2% 86-100 1%
Loan States
Your loan can be in one of these states:
pending → funded → active → repaid
↓
overdue → defaulted
State Description pendingRequest submitted, awaiting funding fundedFunds sent to wallet activeLoan in progress repaidSuccessfully repaid overduePast due date, grace period defaultedNot repaid within grace period
Cancellation
You can cancel a pending loan request before it’s funded:
await usmewe . loans . cancel ( "loan_req_abc123" );
Once a loan is funded, it cannot be cancelled. You must repay the full amount.
Next Steps