🏛️ Case Study: SovereignTrust

Browser
  │
  ├─ Avatar login (WEB4)  ─────────────────► OASIS ONODE API
  │                                           ├─ Avatar SSO
  │                                           ├─ JWT issued
  │                                           └─ Karma score loaded
  │
  ├─ Trust deed creation
  │   ├─ docx generation (client-side)
  │   ├─ pdf-lib rendering
  │   └─ Holon save (WEB4 HyperDrive)  ──────► Encrypted across providers
  │
  ├─ Stripe checkout  ────────────────────────► Stripe API → webhook → unlock features
  │
  └─ Leela AI chat (WEB6 FAHRN Debate)  ─────► 3 AI providers debate → judge synthesis
                                               └─ Holonic Memory auto-injected

import { OasisWeb4Client } from '@oasisomniverse/web4-api';

const oasis4 = new OasisWeb4Client({ baseUrl: 'https://api.web4.oasisomniverse.one' });

async function login(email, password) {
  const { result, isError, message } = await oasis4.avatar.authenticate({ email, password });
  if (isError) throw new Error(message);
  oasis4.auth.setToken(result.token);
  localStorage.setItem('oasis_token', result.token);
  localStorage.setItem('avatar_id', result.avatar.id);
  return result.avatar;
}

// On page load — restore session
const token = localStorage.getItem('oasis_token');
if (token) oasis4.auth.setToken(token);

async function saveTrustDeed(deed) {
  const { result } = await oasis4.data.saveHolon({
    holonType:   'TrustDeed',
    name:        deed.trustName,
    description: deed.description,
    customData: {
      settlor:      deed.settlor,
      trustees:     deed.trustees,
      beneficiaries: deed.beneficiaries,
      jurisdiction: deed.jurisdiction,
      trustType:    deed.trustType,     // 'Discretionary' | 'Fixed' | 'Bare'
      createdAt:    new Date().toISOString(),
    },
    isEncrypted:  true,
    providerType: 'HoloOASIS',        // primary; HyperDrive handles failover
  });
  return result.id;
}

import { PDFDocument, StandardFonts } from 'pdf-lib';
import { Document, Packer, Paragraph } from 'docx';

async function generateTrustPDF(deed) {
  const pdfDoc = await PDFDocument.create();
  const font   = await pdfDoc.embedFont(StandardFonts.Helvetica);
  const page   = pdfDoc.addPage();
  page.drawText(`Trust Deed: ${deed.trustName}`, { x: 50, y: 750, size: 18, font });
  // ... full deed content ...
  const pdfBytes = await pdfDoc.save();

  // Upload PDF to OASIS file storage
  await oasis4.files.upload({
    fileName:  `${deed.trustName}.pdf`,
    data:       pdfBytes,
    holonId:    deed.holonId,   // attach to the trust deed holon
    isPrivate:  true,
  });
}

async function createCheckoutSession(avatarId, planId) {
  // Your backend creates a Stripe session and stores avatarId in metadata
  const res = await fetch('/api/stripe/checkout', {
    method: 'POST',
    body: JSON.stringify({ avatarId, planId }),
    headers: { 'Content-Type': 'application/json' },
  });
  const { url } = await res.json();
  window.location.href = url;
}

// Webhook handler (server-side): on payment.succeeded
// → save subscription holon via WEB4, award karma to avatar
async function handleStripeWebhook(event) {
  if (event.type === 'checkout.session.completed') {
    const { avatarId, planId } = event.data.object.metadata;
    await oasis4.karma.award({ avatarId, amount: 500, reason: 'SovereignTrust subscription' });
    await oasis4.data.saveHolon({ holonType: 'Subscription', customData: { planId, status: 'active' }});
  }
}

import { OasisWeb6Client } from '@oasisomniverse/web6-api';

const ai = new OasisWeb6Client({ baseUrl: 'https://api.web4.oasisomniverse.one' });
ai.auth.setToken(oasis4.auth.getToken());

async function askLeela(question, avatarId, sessionId) {
  const { result } = await ai.fahrn.run({
    mode:   'Debate',
    rounds: 2,
    agents: [
      { name: 'LegalAdvocate',  provider: 'openai',    model: 'gpt-4o',
        systemPrompt: 'You are a UK trust law specialist. Give the strongest legal interpretation.' },
      { name: 'RiskAdvisor',    provider: 'anthropic', model: 'claude-3-5-sonnet',
        systemPrompt: 'You identify risks and edge cases in trust structures.' },
      { name: 'TaxCounsel',    provider: 'google',    model: 'gemini-pro',
        systemPrompt: 'You focus on HMRC and IHT implications of trust decisions.' },
    ],
    judge: {
      provider: 'anthropic', model: 'claude-3-5-sonnet',
      systemPrompt: 'You are Leela, a helpful and precise UK trust law assistant. Synthesise the best answer.',
    },
    input: question,
    memoryContext: { avatarId, sessionId, injectLevels: ['Session', 'User', 'Group'], topK: 6 },
  });
  return result.judgeVerdict;
}

// Award karma when user completes a trust deed — unlocks higher AI tiers
await oasis4.karma.award({
  avatarId,
  amount: 250,
  reason: 'Trust deed created',
  karmaType: 'LegalAction',
});