packages/stellar-facilitator/
├── facilitator/                    # Core HTTP facilitator server
│   ├── facilitator/
│   │   ├── server.ts              # Hono HTTP server (/verify, /settle, /supported)
│   │   └── types.ts               # Request/response schemas
│   ├── channel/
│   │   └── pool.ts                # 50-account channel pool manager
│   ├── bazaar/                    # (to be organized)
│   ├── helpers/                   # (to be organized)
│   ├── mcp/                       # (to be organized)
│   └── validation/                # (to be organized)
│
├── bazaar-service/                # P2P Bazaar Discovery Engine
│   └── src/
│       ├── db/schema.sql          # PostgreSQL + pgvector schema
│       ├── search/
│       │   ├── types.ts           # Type definitions
│       │   ├── engine.ts          # Hybrid RRF search
│       │   └── embeddings.ts     # Vector embedding generation
│       ├── p2p/
│       │   ├── types.ts           # P2P message types
│       │   └── mesh.ts            # Libp2p GossipSub mesh
│       ├── telemetry/
│       │   ├── circuit-breaker.ts # Liveness tracking
│       │   └── tracker.ts         # Telemetry metrics
│       └── catalog/
│           └── ingestion.ts       # Auto-cataloging worker
│
├── mcp-discovery-server/          # AI Agent MCP Server
│   └── src/
│       ├── server.ts              # MCP server implementation
│       └── index.ts               # CLI entry point
│
├── contracts/                     # Soroban Smart Contracts
│   └── upto-settlement/
│       ├── src/lib.rs             # Upto escrow contract (340 lines)
│       └── Cargo.toml             # Rust dependencies
│
├── sdks/                          # Multi-Language SDKs
│   ├── typescript/
│   │   ├── seller.ts              # TypeScript helpers
│   │   └── package.json
│   ├── python/
│   │   ├── seller.py              # Python helpers
│   │   └── setup.py
│   └── go/
│       ├── seller.go              # Go helpers
│       └── go.mod
│
├── specs/                         # Specifications
│   └── (to be added: scheme_upto_stellar.md)
│
├── ARCHITECTURE.md                # Architecture documentation
├── IMPLEMENTATION_STATUS.md       # Current implementation status
├── package.json                   # Root package config
└── README.md                      # This file

# Clone repository
git clone https://github.com/veridex-protocol/stellar-facilitator.git
cd stellar-facilitator

# Install dependencies
npm install
cd bazaar-service && npm install && cd ..
cd mcp-discovery-server && npm install && cd ..

# Setup PostgreSQL database
psql -U postgres -c "CREATE DATABASE veridex_bazaar"
psql -U postgres -d veridex_bazaar -f bazaar-service/src/db/schema.sql

cd bazaar-service

# Configure environment
export DATABASE_HOST=localhost
export DATABASE_PORT=5432
export DATABASE_NAME=veridex_bazaar
export DATABASE_USER=postgres
export DATABASE_PASSWORD=yourpassword

# Start service
npm run dev

cd facilitator

# Configure environment
export STELLAR_RPC_URL=https://soroban-testnet.stellar.org
export STELLAR_NETWORK_PASSPHRASE="Test SDF Network ; September 2015"
export CHANNEL_ACCOUNT_COUNT=50
export FEE_SPONSORSHIP_ENABLED=true

# Start server
npm run dev

cd mcp-discovery-server

# Configure environment
export BAZAAR_API_URL=http://localhost:3001
export FACILITATOR_URL=http://localhost:3000

# Start MCP server
npm start

cd contracts/upto-settlement

# Build contract
soroban contract build

# Deploy to testnet
soroban contract deploy \
  --wasm target/wasm32-unknown-unknown/release/upto_settlement.wasm \
  --network testnet \
  --source <YOUR_SECRET_KEY>

# Build facilitator
cd facilitator && npm run build && cd ..

# Build bazaar-service
cd bazaar-service && npm run build && cd ..

# Build mcp-discovery-server
cd mcp-discovery-server && npm run build && cd ..

# Build Soroban contract
cd contracts/upto-settlement && soroban contract build && cd ../..

# TypeScript tests
npm test

# Soroban contract tests
cd contracts/upto-settlement
cargo test

# SDK tests
cd sdks/typescript && npm test

npm run typecheck

import { createBazaarMetadata, validateBazaarMetadata } from "@veridex/stellar-sdk";

const metadata = createBazaarMetadata("Weather API", {
  serviceName: "OpenWeather",
  tags: ["weather", "api"],
  inputSpec: { /* JSON Schema */ },
});

const validation = validateBazaarMetadata(metadata);

from veridex_sdk.seller import create_bazaar_metadata, validate_bazaar_metadata

metadata = create_bazaar_metadata(
    description="Weather API",
    input_spec={},
    service_name="OpenWeather",
    tags=["weather", "api"]
)

validation = validate_bazaar_metadata(metadata)

import veridex "github.com/veridex-protocol/veridex/stellar-sdk"

metadata := veridex.CreateBazaarMetadata(
    "Weather API",
    map[string]interface{}{},
    "OpenWeather",
    []string{"weather", "api"},
    "", "", "", nil,
)

validation := veridex.ValidateBazaarMetadata(metadata)

-- Composite Score (Φ)
Φ = 0.35×semantic + 0.25×bm25 + 0.15×uptime + 0.15×latency + 0.10×reliability