System Architecture

Soleer Software Workflow

The Soleer software architecture combines on-chain and off-chain components to optimize for both decentralization and performance. The on-chain components ensure trust and transparency for critical operations, while the off-chain components allow for faster data retrieval and complex computations that would be inefficient or expensive to perform entirely on-chain.

Soleer Highlevel Architecture

The hybrid approach allows Soleer to leverage the benefits of blockchain technology while maintaining the responsiveness and flexibility expected in modern web applications. This architecture can scale to handle a large number of users and transactions while keeping costs low and ensuring a smooth user experience.

Component Interaction

2. Smart Contract Infrastructure

Program Architecture

Soleer platform consists of three main program modules:

1. Listing Program

   • Manages service listings

   • Handles search and discovery

   • Updates listing status

2. Escrow Program

   • Controls transaction flow

   • Manages fund locks and releases

   • Handles dispute resolution

3. Reputation Program

   • Calculates user scores

   • Processes reviews

   • Updates reputation metrics

Core Contract Interations

3. Core Processes

Service Listing Process

1. Listing Creation

   typescriptCopyasync function createListing(
     provider: PublicKey,
     details: ListingDetails
   ): Promise<PublicKey>

   • Validates provider credentials

   • Creates on-chain listing record

   • Stores extended metadata in IPFS

   • Returns listing public key

2. Listing Discovery

   • Implements indexed search

   • Filters by category, price, reputation

   • Integrates with AI recommendations

Transaction Flow

4. Data Models

Service Listing Structure

typescriptCopyinterface ServiceListing {
    id: PublicKey;
    provider: PublicKey;
    title: string;
    description: string;
    category: string;
    basePrice: BN;
    acceptedTokens: PublicKey[];
    reputation: number;
    status: ListingStatus;
    metadata: string;
}

Escrow Account Structure

typescriptCopyinterface EscrowAccount {
    id: PublicKey;
    listing: PublicKey;
    client: PublicKey;
    provider: PublicKey;
    amount: BN;
    token: PublicKey;
    status: EscrowStatus;
    deliveryDeadline: BN;
    disputeResolver: PublicKey | null;
}

5. Security Considerations

Transaction Security

1. Multi-signature Requirements

   • Client approval for fund release

   • Provider confirmation of service delivery

   • Arbitrator signatures for dispute resolution

2. Time Locks

   • Minimum escrow duration: 24 hours

   • Maximum escrow duration: 30 days

   • Dispute resolution window: 7 days

Access Control

Access Control Workflow