@yallet/rwa-sdk 0.2.0

package/dist/payloads.js

@@ -0,0 +1,118 @@
+/**
+ * Yallet RWA SDK - Payload builders
+ *
+ * Build JSON payloads that match chrome-extension decryption expectations
+ * for invoice / statements / receipts / files / messages / pictures.
+ */
+// ======================================
+//  Helpers
+// ======================================
+function toExtensionLineItems(items) {
+    if (!items?.length)
+        return [];
+    return items.map((li) => ({
+        name: li.name ?? li.description,
+        price: li.unitPrice ?? 0,
+        qty: li.qty ?? li.quantity,
+        unit: li.unit ?? 'units',
+        total: li.total ?? li.amount ?? (li.quantity * (li.unitPrice ?? 0)),
+    }));
+}
+// ======================================
+//  Payload builders
+// ======================================
+/**
+ * Build invoice payload bundle for minting.
+ * Matches chrome-extension format so the extension can decrypt and display.
+ */
+export function buildInvoicePayload(invoice, options) {
+    const lineItems = toExtensionLineItems(invoice.items);
+    const subtotal = invoice.subtotal ?? invoice.amount ?? 0;
+    const total = invoice.total ?? invoice.amount ?? subtotal;
+    const extensionInvoice = {
+        id: options?.id,
+        uuid: options?.uuid,
+        invoiceNo: invoice.invoiceId,
+        type: 'sent',
+        status: 'submitted',
+        billTo: invoice.billTo,
+        poNo: invoice.poNo,
+        dueDate: invoice.dueDate,
+        lineItems,
+        discountRate: invoice.discountRate ?? 0,
+        discountAmount: invoice.discountAmount,
+        taxRate: invoice.taxRate ?? 0,
+        subtotal,
+        taxAmount: invoice.taxAmount,
+        total,
+        currency: invoice.currency,
+        paymentMethod: invoice.paymentMethod,
+        paymentTerms: invoice.paymentTerms,
+        notePayee: invoice.notePayee ?? invoice.notes,
+        createdAt: invoice.date ?? new Date().toISOString(),
+    };
+    const bundle = {
+        invoice: extensionInvoice,
+    };
+    if (options?.pdfBase64)
+        bundle.pdf = options.pdfBase64;
+    if (options?.senderProfile)
+        bundle.senderProfile = options.senderProfile;
+    if (options?.recipientProfile)
+        bundle.recipientProfile = options.recipientProfile;
+    return bundle;
+}
+/**
+ * Build file payload for minting.
+ * Matches chrome-extension format (name, fileData base64, type, size).
+ */
+export function buildFilePayload(file, options) {
+    return {
+        id: options?.id,
+        name: file.filename,
+        originalName: file.filename,
+        description: file.metadata?.description,
+        tag: null,
+        size: file.size,
+        type: file.mimeType,
+        fileData: file.content,
+        createdAt: file.metadata?.createdAt ?? new Date().toISOString(),
+    };
+}
+/**
+ * Build message/note payload for minting.
+ * Matches chrome-extension format (title, content, replyTo). Type is always 'sent' (institution sends to users).
+ */
+export function buildMessagePayload(note, options) {
+    return {
+        id: options?.id,
+        uuid: options?.uuid,
+        title: note.title,
+        content: note.content,
+        tag: note.tags?.length ? note.tags.join(', ') : null,
+        type: 'sent',
+        recipientId: options?.recipientId ?? null,
+        recipientName: options?.recipientName ?? null,
+        replyTo: options?.replyTo ?? null,
+        createdAt: note.metadata?.createdAt ?? new Date().toISOString(),
+    };
+}
+/**
+ * Build picture/photo payload for minting.
+ * Matches chrome-extension format (imageData base64, mimeType, name).
+ */
+export function buildPhotoPayload(photo, options) {
+    const dataUrl = options?.dataUrl ?? (photo.content ? `data:${photo.mimeType};base64,${photo.content}` : undefined);
+    return {
+        id: options?.id,
+        name: photo.filename,
+        description: photo.metadata?.description,
+        tag: null,
+        imageData: photo.content,
+        mimeType: photo.mimeType,
+        dataUrl,
+        thumbnail: options?.thumbnail,
+        createdAt: photo.metadata?.createdAt ?? new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=payloads.js.map

package/dist/payloads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payloads.js","sourceRoot":"","sources":["../src/payloads.ts"],"names":[],"mappings":"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"}

package/dist/registry.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Yallet RWA SDK - User Registry Module
+ *
+ * Manages registered users with their xidentity public keys
+ */
+import type { RegisteredUser, UserRegistry } from './types.js';
+/**
+ * Simple in-memory user registry
+ * For production, implement a database-backed registry
+ */
+export declare class InMemoryRegistry implements UserRegistry {
+    private users;
+    getUser(solanaAddress: string): Promise<RegisteredUser | null>;
+    registerUser(user: RegisteredUser): Promise<void>;
+    updateUser(solanaAddress: string, updates: Partial<RegisteredUser>): Promise<void>;
+    deleteUser(solanaAddress: string): Promise<void>;
+    listUsers(): Promise<RegisteredUser[]>;
+}
+export interface HTTPRegistryConfig {
+    /** Base URL of the registry API */
+    baseUrl: string;
+    /** API key for authentication */
+    apiKey?: string;
+    /** Custom headers */
+    headers?: Record<string, string>;
+}
+/**
+ * HTTP-backed user registry
+ * Connects to a backend API for user management
+ */
+export declare class HTTPRegistry implements UserRegistry {
+    private config;
+    constructor(config: HTTPRegistryConfig);
+    private fetch;
+    getUser(solanaAddress: string): Promise<RegisteredUser | null>;
+    registerUser(user: RegisteredUser): Promise<void>;
+    updateUser(solanaAddress: string, updates: Partial<RegisteredUser>): Promise<void>;
+    deleteUser(solanaAddress: string): Promise<void>;
+    listUsers(): Promise<RegisteredUser[]>;
+}
+export type RegistryType = 'memory' | 'http';
+export interface RegistryOptions {
+    type: RegistryType;
+    httpConfig?: HTTPRegistryConfig;
+}
+/**
+ * Create a user registry instance
+ *
+ * @param options - Registry options
+ * @returns UserRegistry instance
+ */
+export declare function createRegistry(options: RegistryOptions): UserRegistry;
+/**
+ * Validate a Solana address
+ *
+ * @param address - Address to validate
+ * @returns true if valid
+ */
+export declare function isValidSolanaAddress(address: string): boolean;
+/**
+ * Validate an xidentity public key (base64)
+ *
+ * @param xidentity - xidentity to validate
+ * @returns true if valid
+ */
+export declare function isValidXidentity(xidentity: string): boolean;
+/**
+ * Validate a registered user
+ *
+ * @param user - User to validate
+ * @returns Validation result
+ */
+export declare function validateUser(user: Partial<RegisteredUser>): {
+    valid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM/D;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IACnD,OAAO,CAAC,KAAK,CAA0C;IAEjD,OAAO,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAI9D,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjD,UAAU,CACd,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC;IAQV,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,SAAS,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;CAG7C;AAMD,MAAM,WAAW,kBAAkB;IACjC,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,qBAAa,YAAa,YAAW,YAAY;IAC/C,OAAO,CAAC,MAAM,CAAqB;gBAEvB,MAAM,EAAE,kBAAkB;YAIxB,KAAK;IA4Bb,OAAO,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAa9D,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjD,UAAU,CACd,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC;IAOV,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhD,SAAS,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;CAG7C;AAMD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,CAAC,EAAE,kBAAkB,CAAC;CACjC;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,YAAY,CAYrE;AAMD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAI7D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAS3D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG;IAC3D,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAmBA"}

package/dist/registry.js

@@ -0,0 +1,173 @@
+/**
+ * Yallet RWA SDK - User Registry Module
+ *
+ * Manages registered users with their xidentity public keys
+ */
+// ======================================
+//  In-Memory Registry (For Development)
+// ======================================
+/**
+ * Simple in-memory user registry
+ * For production, implement a database-backed registry
+ */
+export class InMemoryRegistry {
+    users = new Map();
+    async getUser(solanaAddress) {
+        return this.users.get(solanaAddress) || null;
+    }
+    async registerUser(user) {
+        this.users.set(user.solanaAddress, {
+            ...user,
+            registeredAt: user.registeredAt || Date.now(),
+        });
+    }
+    async updateUser(solanaAddress, updates) {
+        const existing = this.users.get(solanaAddress);
+        if (!existing) {
+            throw new Error(`User not found: ${solanaAddress}`);
+        }
+        this.users.set(solanaAddress, { ...existing, ...updates });
+    }
+    async deleteUser(solanaAddress) {
+        this.users.delete(solanaAddress);
+    }
+    async listUsers() {
+        return Array.from(this.users.values());
+    }
+}
+/**
+ * HTTP-backed user registry
+ * Connects to a backend API for user management
+ */
+export class HTTPRegistry {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async fetch(path, options = {}) {
+        const url = `${this.config.baseUrl}${path}`;
+        const headers = {
+            'Content-Type': 'application/json',
+            ...this.config.headers,
+        };
+        if (this.config.apiKey) {
+            headers['Authorization'] = `Bearer ${this.config.apiKey}`;
+        }
+        const response = await fetch(url, {
+            ...options,
+            headers: { ...headers, ...options.headers },
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Registry API error: ${response.status} - ${error}`);
+        }
+        return response.json();
+    }
+    async getUser(solanaAddress) {
+        try {
+            return await this.fetch(`/users/${encodeURIComponent(solanaAddress)}`);
+        }
+        catch (err) {
+            if (err instanceof Error && err.message.includes('404')) {
+                return null;
+            }
+            throw err;
+        }
+    }
+    async registerUser(user) {
+        await this.fetch('/users', {
+            method: 'POST',
+            body: JSON.stringify(user),
+        });
+    }
+    async updateUser(solanaAddress, updates) {
+        await this.fetch(`/users/${encodeURIComponent(solanaAddress)}`, {
+            method: 'PATCH',
+            body: JSON.stringify(updates),
+        });
+    }
+    async deleteUser(solanaAddress) {
+        await this.fetch(`/users/${encodeURIComponent(solanaAddress)}`, {
+            method: 'DELETE',
+        });
+    }
+    async listUsers() {
+        return this.fetch('/users');
+    }
+}
+/**
+ * Create a user registry instance
+ *
+ * @param options - Registry options
+ * @returns UserRegistry instance
+ */
+export function createRegistry(options) {
+    switch (options.type) {
+        case 'memory':
+            return new InMemoryRegistry();
+        case 'http':
+            if (!options.httpConfig) {
+                throw new Error('httpConfig is required for HTTP registry');
+            }
+            return new HTTPRegistry(options.httpConfig);
+        default:
+            throw new Error(`Unknown registry type: ${options.type}`);
+    }
+}
+// ======================================
+//  Validation Helpers
+// ======================================
+/**
+ * Validate a Solana address
+ *
+ * @param address - Address to validate
+ * @returns true if valid
+ */
+export function isValidSolanaAddress(address) {
+    // Basic validation: 32-44 characters, base58
+    const base58Regex = /^[1-9A-HJ-NP-Za-km-z]{32,44}$/;
+    return base58Regex.test(address);
+}
+/**
+ * Validate an xidentity public key (base64)
+ *
+ * @param xidentity - xidentity to validate
+ * @returns true if valid
+ */
+export function isValidXidentity(xidentity) {
+    // Check if it's valid base64
+    try {
+        const decoded = atob(xidentity);
+        // X25519 public key should be 32 bytes
+        return decoded.length === 32;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Validate a registered user
+ *
+ * @param user - User to validate
+ * @returns Validation result
+ */
+export function validateUser(user) {
+    const errors = [];
+    if (!user.solanaAddress) {
+        errors.push('solanaAddress is required');
+    }
+    else if (!isValidSolanaAddress(user.solanaAddress)) {
+        errors.push('Invalid Solana address format');
+    }
+    if (!user.xidentity) {
+        errors.push('xidentity is required');
+    }
+    else if (!isValidXidentity(user.xidentity)) {
+        errors.push('Invalid xidentity format (must be base64-encoded 32-byte key)');
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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"}

package/dist/sdk.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Yallet RWA SDK - Main SDK Class
+ *
+ * High-level interface for minting encrypted RWA assets as Solana cNFTs
+ */
+import type { SDKConfig, MintRequest, MintResult, RegisteredUser, UserRegistry, InvoiceData, NoteData, FileData, PhotoData, EncryptFunction, TreeConfig } from './types.js';
+import { AssetType } from './types.js';
+import { type UploadOptions } from './storage.js';
+import { type RegistryOptions } from './registry.js';
+import type { Keypair } from '@metaplex-foundation/umi';
+export declare class YalletRWASDK {
+    private config;
+    private registry;
+    private minter;
+    private encryptor;
+    private uploadOptions;
+    constructor(config: SDKConfig, options?: {
+        registry?: UserRegistry | RegistryOptions;
+        wasmEncryptFn?: EncryptFunction;
+        uploadOptions?: UploadOptions;
+    });
+    /**
+     * Set the signer for minting transactions
+     *
+     * @param keypair - Umi keypair for signing
+     */
+    setSigner(keypair: Keypair): void;
+    /**
+     * Set the Merkle tree configuration
+     *
+     * @param treeConfig - Tree configuration
+     */
+    setTreeConfig(treeConfig: TreeConfig): void;
+    /**
+     * Get the user registry
+     */
+    getRegistry(): UserRegistry;
+    /**
+     * Register a user with their xidentity
+     *
+     * @param user - User to register
+     */
+    registerUser(user: RegisteredUser): Promise<void>;
+    /**
+     * Get a registered user by Solana address
+     *
+     * @param solanaAddress - User's Solana address
+     * @returns Registered user or null
+     */
+    getUser(solanaAddress: string): Promise<RegisteredUser | null>;
+    /**
+     * Mint an encrypted invoice to a recipient.
+     * Uses extension-compatible payload (invoice bundle) so the recipient's wallet can decrypt and display.
+     *
+     * @param invoice - Invoice data
+     * @param recipientAddress - Recipient's Solana address
+     * @param options - Name, description, and optional pdf/sender/recipient for extension compatibility
+     * @returns Mint result
+     */
+    mintInvoice(invoice: InvoiceData, recipientAddress: string, options?: {
+        name?: string;
+        description?: string;
+        pdfBase64?: string;
+        senderProfile?: Record<string, unknown>;
+        recipientProfile?: Record<string, unknown>;
+        uuid?: string;
+    }): Promise<MintResult>;
+    /**
+     * Mint an encrypted file to a recipient (extension-compatible payload).
+     */
+    mintFile(file: FileData, recipientAddress: string, options?: {
+        name?: string;
+        description?: string;
+        uuid?: string;
+    }): Promise<MintResult>;
+    /**
+     * Mint an encrypted message/note to a recipient (extension-compatible payload, type always 'sent').
+     */
+    mintMessage(note: NoteData, recipientAddress: string, options?: {
+        name?: string;
+        description?: string;
+        uuid?: string;
+        recipientId?: string | null;
+        recipientName?: string | null;
+        replyTo?: string | null;
+    }): Promise<MintResult>;
+    /**
+     * Mint an encrypted picture/photo to a recipient (extension-compatible payload).
+     */
+    mintPhoto(photo: PhotoData, recipientAddress: string, options?: {
+        name?: string;
+        description?: string;
+        uuid?: string;
+        thumbnail?: string;
+    }): Promise<MintResult>;
+    /**
+     * Mint an encrypted asset to a recipient
+     *
+     * This is the main minting method that handles the full flow:
+     * 1. Look up recipient's xidentity from registry
+     * 2. Encrypt asset with recipient's xidentity
+     * 3. Upload encrypted data to Arweave
+     * 4. Generate and upload NFT metadata
+     * 5. Mint cNFT to recipient
+     *
+     * @param request - Mint request
+     * @returns Mint result
+     */
+    mint(request: MintRequest): Promise<MintResult>;
+    /**
+     * Mint multiple invoices to different recipients
+     *
+     * @param invoices - Array of invoice requests
+     * @returns Array of mint results
+     */
+    mintInvoiceBatch(invoices: Array<{
+        invoice: InvoiceData;
+        recipientAddress: string;
+        name?: string;
+    }>): Promise<MintResult[]>;
+    /**
+     * Check if a user is registered
+     *
+     * @param solanaAddress - User's Solana address
+     * @returns true if registered
+     */
+    isUserRegistered(solanaAddress: string): Promise<boolean>;
+    /**
+     * Get the current tree configuration
+     */
+    getTreeConfig(): Promise<TreeConfig | null>;
+    /**
+     * Encrypt and upload without minting
+     * Useful for testing or when you want to handle minting separately
+     *
+     * @param assetData - Asset data to encrypt
+     * @param assetType - Type of asset
+     * @param recipientXidentity - Recipient's xidentity (base64)
+     * @returns Upload results
+     */
+    encryptAndUpload(assetData: unknown, assetType: AssetType, recipientXidentity: string): Promise<{
+        encryptedDataUri: string;
+        metadataUri: string;
+    }>;
+}
+/**
+ * Create a new RWA SDK instance
+ *
+ * @param config - SDK configuration
+ * @param options - Additional options
+ * @returns YalletRWASDK instance
+ */
+export declare function createRWASDK(config: SDKConfig, options?: {
+    registry?: UserRegistry | RegistryOptions;
+    wasmEncryptFn?: EncryptFunction;
+    uploadOptions?: UploadOptions;
+}): YalletRWASDK;
+//# sourceMappingURL=sdk.d.ts.map

package/dist/sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"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"}