@pasosdejesus/mpdj 0.1.0

package/dist/blockchain/AddSlearnButton.d.ts

@@ -0,0 +1,5 @@
+interface AddSlearnButtonProps {
+    lang: string;
+}
+export declare function AddSlearnButton({ lang }: AddSlearnButtonProps): import("react").JSX.Element;
+export {};

package/dist/blockchain/AddSlearnButton.js

@@ -0,0 +1,58 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useEffect, useMemo } from 'react';
+import { Button } from '@pasosdejesus/m/shadcn-components/ui/button';
+import { PlusCircle, CheckCircle, AlertCircle } from 'lucide-react';
+import { SLEARN_ADDRESSES, resolveNetwork } from './ecosystem-addresses.js';
+// Fallback addresses for when env is not available
+const FALLBACK_SLEARN = {
+    celo: '0x27fd41Bea85C39254f2B12789eB37a1543152CC1',
+    celoSepolia: '0x9fBa3A2Ca0275c4D7A3eA341923f8c531e913BFA',
+};
+export function AddSlearnButton({ lang }) {
+    const [state, setState] = useState('idle');
+    const [isMiniPay, setIsMiniPay] = useState(false);
+    const hasWallet = typeof window !== 'undefined' && !!window.ethereum;
+    const slearnAddr = useMemo(() => {
+        const network = resolveNetwork();
+        return SLEARN_ADDRESSES[network] || FALLBACK_SLEARN[network] || FALLBACK_SLEARN.celo;
+    }, []);
+    const shortAddr = slearnAddr?.slice(0, 6) + '…' + slearnAddr?.slice(-4);
+    useEffect(() => {
+        if (typeof window !== 'undefined' && window.ethereum?.isMiniPay) {
+            setIsMiniPay(true);
+        }
+    }, []);
+    const addToken = async () => {
+        if (!hasWallet)
+            return;
+        setState('loading');
+        try {
+            const wasAdded = await window.ethereum?.request({
+                method: 'wallet_watchAsset',
+                params: {
+                    type: 'ERC20',
+                    options: {
+                        address: slearnAddr,
+                        symbol: 'SLEARN',
+                        decimals: 2,
+                        image: 'https://learn.tg/img/slearn-icon.svg',
+                    },
+                },
+            });
+            setState(wasAdded ? 'success' : 'error');
+        }
+        catch {
+            setState('error');
+        }
+    };
+    return (_jsx("div", { className: "text-center", children: isMiniPay ? (_jsx("span", { className: "text-xs text-gray-400", children: lang === 'es'
+                ? `SLEARN: ${slearnAddr} — 2 decimales`
+                : `SLEARN: ${slearnAddr} — 2 decimals` })) : state === 'success' ? (_jsxs("span", { className: "text-xs text-emerald-600 flex items-center justify-center gap-1", children: [_jsx(CheckCircle, { className: "h-3 w-3" }), lang === 'es' ? '¡SLEARN agregado a tu billetera!' : 'SLEARN added to your wallet!'] })) : state === 'error' ? (_jsxs("span", { className: "text-xs text-red-500 flex items-center justify-center gap-1", children: [_jsx(AlertCircle, { className: "h-3 w-3" }), lang === 'es'
+                    ? `Agrega manualmente: ${shortAddr}, 2 decimales`
+                    : `Add manually: ${shortAddr}, 2 decimals`] })) : (_jsxs(Button, { variant: "outline", size: "sm", onClick: addToken, disabled: !hasWallet || state === 'loading', className: "text-xs gap-1", children: [_jsx(PlusCircle, { className: "h-3 w-3" }), state === 'loading'
+                    ? (lang === 'es' ? 'Agregando…' : 'Adding…')
+                    : lang === 'es'
+                        ? 'Agregar SLEARN a mi billetera'
+                        : 'Add SLEARN to my wallet'] })) }));
+}

package/dist/blockchain/SlearnInfo.d.ts

@@ -0,0 +1,22 @@
+interface StepConfig {
+    title: string;
+    desc: string;
+    icon?: 'donate' | 'earn' | 'course' | 'redeem';
+}
+interface LinkConfig {
+    label: string;
+    href: string;
+    external?: boolean;
+}
+export interface SlearnInfoProps {
+    locale?: string;
+    isVerified?: boolean;
+    /** Description shown below the title (overrides built-in description) */
+    description?: string;
+    /** Custom steps. Falls back to DEFAULT_STEPS[locale] if not provided */
+    steps?: StepConfig[];
+    /** External links shown at the bottom. Falls back to DEFAULT_LINKS. Pass [] to hide. */
+    links?: LinkConfig[];
+}
+export declare function SlearnInfo({ locale, isVerified, description, steps, links }: SlearnInfoProps): import("react").JSX.Element;
+export {};

package/dist/blockchain/SlearnInfo.js

@@ -0,0 +1,68 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
+import { Card, CardContent } from '@pasosdejesus/m/shadcn-components/ui/card';
+import { Info, GraduationCap, BadgeCheck, ArrowRightLeft, ExternalLink } from 'lucide-react';
+import { SLEARN_ADDRESSES, resolveNetwork } from './ecosystem-addresses.js';
+const DEFAULT_STEPS = {
+    en: [
+        { title: 'Donate', desc: 'You donate to a region in sivel.xyz', icon: 'donate' },
+        { title: 'Earn SLEARN', desc: '10% of your donation is minted as SLEARN to your wallet', icon: 'earn' },
+        { title: 'Take courses', desc: 'Use SLEARN to pay for courses on learn.tg', icon: 'course' },
+        { title: 'Redeem', desc: 'Complete a premium course → get SBT → redeem SLEARN on stable-sl.pdJ.app for Leones (Sierra Leone) or USDT (worldwide)', icon: 'redeem' },
+    ],
+    es: [
+        { title: 'Donas', desc: 'Donas a una región en sivel.xyz', icon: 'donate' },
+        { title: 'Ganas SLEARN', desc: 'El 10% de tu donación se mintea como SLEARN a tu billetera', icon: 'earn' },
+        { title: 'Tomas cursos', desc: 'Usa SLEARN para pagar cursos en learn.tg', icon: 'course' },
+        { title: 'Canjeas', desc: 'Completa un curso premium → obtén SBT → canjea SLEARN en stable-sl.pdJ.app por Leones (Sierra Leona) o USDT (todo el mundo)', icon: 'redeem' },
+    ],
+};
+const DEFAULT_LINKS = [
+    { label: 'learn.tg', href: 'https://learn.tg' },
+    { label: 'stable-sl', href: 'https://stable-sl.pdJ.app' },
+];
+const tS = {
+    en: {
+        title: '🎓 SLEARN Cashback',
+        what: 'What is SLEARN?',
+        description: 'When you donate, you earn 10% back in SLEARN tokens — a reward for your generosity.',
+        contractLink: 'Verified contract',
+        unverified: '🔐 Verify on learn.tg to unlock SLEARN and start taking courses.',
+        learnTg: 'Take courses on learn.tg',
+        stableSl: 'Redeem on stable-sl',
+    },
+    es: {
+        title: '🎓 SLEARN Cashback',
+        what: '¿Qué es SLEARN?',
+        description: 'Al donar, recibes el 10% de vuelta en tokens SLEARN — una recompensa por tu generosidad.',
+        contractLink: 'Contrato verificado',
+        unverified: '🔐 Verifícate en learn.tg para desbloquear SLEARN y comenzar a tomar cursos.',
+        learnTg: 'Tomar cursos en learn.tg',
+        stableSl: 'Canjear en stable-sl',
+    },
+};
+const stepIcons = {
+    donate: ArrowRightLeft,
+    earn: GraduationCap,
+    course: GraduationCap,
+    redeem: BadgeCheck,
+};
+export function SlearnInfo({ locale = 'en', isVerified, description, steps, links }) {
+    const t = (k) => (tS[locale]?.[k] || tS.en[k]);
+    const [open, setOpen] = useState(false);
+    const network = resolveNetwork();
+    const slearnAddr = SLEARN_ADDRESSES[network];
+    const blockscoutBase = network === 'celo'
+        ? 'https://celo.blockscout.com'
+        : 'https://celo-sepolia.blockscout.com';
+    const finalSteps = steps || DEFAULT_STEPS[locale] || DEFAULT_STEPS.en;
+    const finalLinks = links !== undefined ? links : [
+        { label: t('learnTg'), href: 'https://learn.tg' },
+        { label: t('stableSl'), href: 'https://stable-sl.pdJ.app' },
+    ];
+    return (_jsxs(Card, { children: [_jsxs("button", { onClick: () => setOpen(!open), className: "w-full flex items-center justify-between p-3 text-left hover:bg-gray-50 transition-colors rounded-t-lg", children: [_jsxs("span", { className: "font-medium flex items-center gap-2", children: [_jsx(GraduationCap, { className: "h-4 w-4 text-purple-600" }), t('what')] }), _jsx(Info, { className: "h-4 w-4 text-gray-400" })] }), open && (_jsxs(CardContent, { className: "pt-0 pb-4 space-y-3 text-sm", children: [_jsx("p", { className: "text-gray-600", children: description || t('description') }), !isVerified && (_jsx("div", { className: "bg-blue-50 border border-blue-200 rounded p-2 text-xs text-blue-800", children: t('unverified') })), _jsx("div", { className: "space-y-2", children: finalSteps.map((step, i) => {
+                            const Icon = step.icon ? stepIcons[step.icon] : null;
+                            return (_jsxs("div", { className: "flex items-start gap-2", children: [_jsx("span", { className: "flex-shrink-0 w-5 h-5 rounded-full bg-purple-100 text-purple-700 text-xs flex items-center justify-center font-bold", children: i + 1 }), _jsxs("div", { children: [_jsx("strong", { children: step.title }), _jsxs("span", { className: "text-gray-500", children: [" \u2014 ", step.desc] })] }), Icon && _jsx(Icon, { className: "h-3 w-3 text-purple-400 flex-shrink-0 mt-0.5" })] }, i));
+                        }) }), _jsxs("div", { className: "flex flex-wrap gap-2 pt-1", children: [finalLinks.map((link, i) => (_jsxs("a", { href: link.href, target: link.external !== false ? '_blank' : undefined, rel: link.external !== false ? 'noopener noreferrer' : undefined, className: "text-xs text-purple-600 underline hover:text-purple-800", children: [link.label, " \u2192"] }, i))), slearnAddr && (_jsxs("a", { href: `${blockscoutBase}/address/${slearnAddr}`, target: "_blank", rel: "noopener noreferrer", className: "text-xs text-gray-400 underline hover:text-gray-600 flex items-center gap-1", children: [_jsx(ExternalLink, { className: "h-3 w-3" }), t('contractLink')] }))] })] }))] }));
+}

package/dist/blockchain/admin-credentials.d.ts

@@ -0,0 +1,29 @@
+import type { WalletClient } from 'viem';
+/**
+ * Grant MINTER_ROLE to a wallet.
+ */
+export declare function grantMinter(walletClient: WalletClient, contractAddress: `0x${string}`, address: `0x${string}`): Promise<string>;
+/**
+ * Revoke MINTER_ROLE from a wallet.
+ */
+export declare function revokeMinter(walletClient: WalletClient, contractAddress: `0x${string}`, address: `0x${string}`): Promise<string>;
+/**
+ * Register a new credential type. MINTER_ROLE (backends can register).
+ *
+ * @param customURI Optional per‑token URI (e.g., ipfs://...). Pass '' for site default.
+ * @param maxSupply_ Max supply. 0 = unlimited. Ignored for NFTs with customURI.
+ */
+export declare function registerCredentialType(walletClient: WalletClient, contractAddress: `0x${string}`, siteName: string, typeName: string, displayName: string, soulbound: boolean, courseId: number, premium: boolean, customURI?: string, maxSupply_?: number): Promise<number>;
+/**
+ * Set max supply for a token. Only DEFAULT_ADMIN_ROLE.
+ * Cannot be used on NFTs (their maxSupply is locked at registration).
+ */
+export declare function setMaxSupply(walletClient: WalletClient, contractAddress: `0x${string}`, tokenId: number, max: number): Promise<string>;
+/**
+ * Set base URI for a site. Only DEFAULT_ADMIN_ROLE.
+ */
+export declare function setSiteBaseURI(walletClient: WalletClient, contractAddress: `0x${string}`, siteName: string, uri: string): Promise<string>;
+/**
+ * Set or correct a custom token URI. Only DEFAULT_ADMIN_ROLE.
+ */
+export declare function setCustomTokenURI(walletClient: WalletClient, contractAddress: `0x${string}`, tokenId: number, customURI: string): Promise<string>;

package/dist/blockchain/admin-credentials.js

@@ -0,0 +1,91 @@
+// src/blockchain/admin-credentials.ts
+// Admin functions for PasosDeJesusCredentials.
+// DEFAULT_ADMIN_ROLE required: grantMinter, revokeMinter, setMaxSupply, setSiteBaseURI, setCustomTokenURI.
+// MINTER_ROLE can also call registerCredentialType.
+import pasosDeJesusCredentialsAbi from '../abis/PasosDeJesusCredentials.json' with { type: 'json' };
+const MINTER_ROLE = '0x9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a6';
+/**
+ * Grant MINTER_ROLE to a wallet.
+ */
+export async function grantMinter(walletClient, contractAddress, address) {
+    return await walletClient.writeContract({
+        address: contractAddress,
+        abi: pasosDeJesusCredentialsAbi,
+        functionName: 'grantRole',
+        args: [MINTER_ROLE, address],
+        chain: walletClient.chain,
+        account: walletClient.account,
+    });
+}
+/**
+ * Revoke MINTER_ROLE from a wallet.
+ */
+export async function revokeMinter(walletClient, contractAddress, address) {
+    return await walletClient.writeContract({
+        address: contractAddress,
+        abi: pasosDeJesusCredentialsAbi,
+        functionName: 'revokeRole',
+        args: [MINTER_ROLE, address],
+        chain: walletClient.chain,
+        account: walletClient.account,
+    });
+}
+/**
+ * Register a new credential type. MINTER_ROLE (backends can register).
+ *
+ * @param customURI Optional per‑token URI (e.g., ipfs://...). Pass '' for site default.
+ * @param maxSupply_ Max supply. 0 = unlimited. Ignored for NFTs with customURI.
+ */
+export async function registerCredentialType(walletClient, contractAddress, siteName, typeName, displayName, soulbound, courseId, premium, customURI = '', maxSupply_ = 0) {
+    const hash = await walletClient.writeContract({
+        address: contractAddress,
+        abi: pasosDeJesusCredentialsAbi,
+        functionName: 'registerCredentialType',
+        args: [siteName, typeName, displayName, soulbound, BigInt(courseId), premium, customURI, BigInt(maxSupply_)],
+        chain: walletClient.chain,
+        account: walletClient.account,
+    });
+    // TokenId is sequential. The caller should use events to get the exact tokenId.
+    // This function returns 0 as placeholder — caller resolves via receipt.
+    return 0;
+}
+/**
+ * Set max supply for a token. Only DEFAULT_ADMIN_ROLE.
+ * Cannot be used on NFTs (their maxSupply is locked at registration).
+ */
+export async function setMaxSupply(walletClient, contractAddress, tokenId, max) {
+    return await walletClient.writeContract({
+        address: contractAddress,
+        abi: pasosDeJesusCredentialsAbi,
+        functionName: 'setMaxSupply',
+        args: [BigInt(tokenId), BigInt(max)],
+        chain: walletClient.chain,
+        account: walletClient.account,
+    });
+}
+/**
+ * Set base URI for a site. Only DEFAULT_ADMIN_ROLE.
+ */
+export async function setSiteBaseURI(walletClient, contractAddress, siteName, uri) {
+    return await walletClient.writeContract({
+        address: contractAddress,
+        abi: pasosDeJesusCredentialsAbi,
+        functionName: 'setSiteBaseURI',
+        args: [siteName, uri],
+        chain: walletClient.chain,
+        account: walletClient.account,
+    });
+}
+/**
+ * Set or correct a custom token URI. Only DEFAULT_ADMIN_ROLE.
+ */
+export async function setCustomTokenURI(walletClient, contractAddress, tokenId, customURI) {
+    return await walletClient.writeContract({
+        address: contractAddress,
+        abi: pasosDeJesusCredentialsAbi,
+        functionName: 'setCustomTokenURI',
+        args: [BigInt(tokenId), customURI],
+        chain: walletClient.chain,
+        account: walletClient.account,
+    });
+}

package/dist/blockchain/credential-cache.d.ts

@@ -0,0 +1,33 @@
+import type { Kysely } from 'kysely';
+import type { PublicClient } from 'viem';
+export interface CredentialMetadataRow {
+    token_id: number;
+    chain_id: string;
+    name: string;
+    type: string;
+    site: string;
+    is_premium: boolean;
+    is_soulbound: boolean;
+    image_url: string;
+}
+/**
+ * Upsert a row into credential_metadata cache.
+ */
+export declare function upsertCredentialMetadata(db: Kysely<any>, row: CredentialMetadataRow): Promise<void>;
+/**
+ * Get credential metadata from cache for a single token.
+ * Returns full CredentialMetadataRow or null if not found.
+ */
+export declare function getCredentialMetadata(db: Kysely<any>, tokenId: number, chainId: string): Promise<CredentialMetadataRow | null>;
+/**
+ * Sync all credential types from contract into cache (backfill).
+ */
+export declare function syncCredentialMetadata(publicClient: PublicClient, contractAddress: `0x${string}`, db: Kysely<any>, chainId: string): Promise<number>;
+/**
+ * Verify that the credential_metadata table has the expected English columns.
+ */
+export declare function verifyCredentialMetadataSchema(db: Kysely<any>, tableName?: string): Promise<{
+    columns: number;
+    missing: string[];
+    colTypes: Record<string, string>;
+} | null>;

package/dist/blockchain/credential-cache.js

@@ -0,0 +1,129 @@
+// src/blockchain/credential-cache.ts
+// Cache functions for credential_metadata table.
+// Receives Kysely db instance as parameter — project-agnostic.
+import pasosDeJesusCredentialsAbi from '../abis/PasosDeJesusCredentials.json' with { type: 'json' };
+/**
+ * Upsert a row into credential_metadata cache.
+ */
+export async function upsertCredentialMetadata(db, row) {
+    await db
+        .insertInto('credential_metadata')
+        .values(row)
+        .onConflict((oc) => oc.columns(['token_id', 'chain_id']).doUpdateSet({
+        name: row.name,
+        type: row.type,
+        site: row.site,
+        is_premium: row.is_premium,
+        is_soulbound: row.is_soulbound,
+        image_url: row.image_url,
+        updated_at: new Date(),
+    }))
+        .execute();
+}
+/**
+ * Get credential metadata from cache for a single token.
+ * Returns full CredentialMetadataRow or null if not found.
+ */
+export async function getCredentialMetadata(db, tokenId, chainId) {
+    const row = await db
+        .selectFrom('credential_metadata')
+        .select([
+        'token_id',
+        'chain_id',
+        'name',
+        'type',
+        'site',
+        'is_premium',
+        'is_soulbound',
+        'image_url',
+    ])
+        .where('token_id', '=', tokenId)
+        .where('chain_id', '=', chainId)
+        .executeTakeFirst();
+    return row
+        ? {
+            token_id: row.token_id,
+            chain_id: row.chain_id,
+            name: row.name,
+            type: row.type,
+            site: row.site,
+            is_premium: row.is_premium,
+            is_soulbound: row.is_soulbound,
+            image_url: row.image_url,
+        }
+        : null;
+}
+/**
+ * Sync all credential types from contract into cache (backfill).
+ */
+export async function syncCredentialMetadata(publicClient, contractAddress, db, chainId) {
+    const nextTokenId = await publicClient.readContract({
+        address: contractAddress,
+        abi: pasosDeJesusCredentialsAbi,
+        functionName: 'nextTokenId',
+    });
+    let count = 0;
+    for (let i = 1; i < Number(nextTokenId); i++) {
+        try {
+            const [name, sb, premium] = await Promise.all([
+                publicClient.readContract({
+                    address: contractAddress,
+                    abi: pasosDeJesusCredentialsAbi,
+                    functionName: 'tokenNames',
+                    args: [BigInt(i)],
+                }),
+                publicClient.readContract({
+                    address: contractAddress,
+                    abi: pasosDeJesusCredentialsAbi,
+                    functionName: 'isSoulbound',
+                    args: [BigInt(i)],
+                }),
+                publicClient.readContract({
+                    address: contractAddress,
+                    abi: pasosDeJesusCredentialsAbi,
+                    functionName: 'isPremiumCourse',
+                    args: [BigInt(i)],
+                }),
+            ]);
+            if (!name || name === '')
+                continue;
+            await upsertCredentialMetadata(db, {
+                token_id: i,
+                chain_id: chainId,
+                name: name,
+                type: 'unknown',
+                site: 'unknown',
+                is_premium: premium,
+                is_soulbound: sb,
+                image_url: `img/credential/${i}.png`,
+            });
+            count++;
+        }
+        catch {
+            // Skip unconfigured tokens
+        }
+    }
+    return count;
+}
+/**
+ * Verify that the credential_metadata table has the expected English columns.
+ */
+export async function verifyCredentialMetadataSchema(db, tableName = 'credential_metadata') {
+    const { sql } = await import('kysely');
+    const result = await sql `
+    SELECT column_name, data_type
+    FROM information_schema.columns
+    WHERE table_name = ${tableName}
+    ORDER BY column_name
+  `.execute(db);
+    const rows = result.rows;
+    if (rows.length === 0)
+        return null; // table doesn't exist
+    const columns = new Set(rows.map(r => r.column_name));
+    const required = ['token_id', 'chain_id', 'name', 'type', 'site', 'image_url'];
+    const missing = required.filter(c => !columns.has(c));
+    const colTypes = {};
+    for (const r of rows)
+        colTypes[r.column_name] = r.data_type;
+    return { columns: rows.length, missing, colTypes };
+}

package/dist/blockchain/credential-images.d.ts

@@ -0,0 +1,30 @@
+export declare const TYPE_COLORS: Record<string, string>;
+export declare const FONT_FAMILY = "system-ui, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif";
+/**
+ * Extract inner content of user's SVG (between <svg> tags).
+ */
+export declare function extractSvgInner(svgText: string): string;
+/**
+ * Validate user's SVG file before composition.
+ */
+export declare function validateSvg(svgText: string): void;
+export interface ComposeParams {
+    userSvgPath: string;
+    tokenId: number;
+    site: string;
+    siteName: string;
+    type: string;
+    isSoulbound: boolean;
+    isPremium: boolean;
+    displayName: string;
+    publicDir: string;
+    pngCommand: string;
+}
+/**
+ * Compose credential image by layering user's SVG icon with
+ * programmatic elements (border, site logo, lock/star overlays).
+ */
+export declare function composeCredentialImage(params: ComposeParams): Promise<{
+    svgPath: string;
+    pngPath: string;
+}>;