@yallet/rwa-sdk 0.2.0

package/dist/sdk.js

@@ -0,0 +1,346 @@
+/**
+ * Yallet RWA SDK - Main SDK Class
+ *
+ * High-level interface for minting encrypted RWA assets as Solana cNFTs
+ */
+import { AssetType } from './types.js';
+import { ECIESEncryptor, createWasmEncryptor, encryptAsset } from './encryption.js';
+import { buildInvoicePayload, buildFilePayload, buildMessagePayload, buildPhotoPayload, } from './payloads.js';
+import { uploadEncryptedAsset, uploadMetadata } from './storage.js';
+import { generateNFTMetadata } from './metadata.js';
+import { createMinter } from './minting.js';
+import { InMemoryRegistry, createRegistry } from './registry.js';
+// ======================================
+//  RWA SDK Class
+// ======================================
+export class YalletRWASDK {
+    config;
+    registry;
+    minter;
+    encryptor;
+    uploadOptions;
+    constructor(config, options = {}) {
+        this.config = config;
+        // Initialize registry
+        if (options.registry) {
+            if ('getUser' in options.registry) {
+                this.registry = options.registry;
+            }
+            else {
+                this.registry = createRegistry(options.registry);
+            }
+        }
+        else {
+            this.registry = new InMemoryRegistry();
+        }
+        // Initialize encryptor
+        if (options.wasmEncryptFn) {
+            this.encryptor = createWasmEncryptor(options.wasmEncryptFn);
+        }
+        else {
+            this.encryptor = new ECIESEncryptor();
+        }
+        // Initialize minter
+        this.minter = createMinter(config);
+        // Upload options
+        this.uploadOptions = {
+            network: config.network,
+            apiKey: config.arweaveApiKey,
+            endpoint: config.arweaveEndpoint,
+            ...options.uploadOptions,
+        };
+    }
+    // ======================================
+    //  Configuration
+    // ======================================
+    /**
+     * Set the signer for minting transactions
+     *
+     * @param keypair - Umi keypair for signing
+     */
+    setSigner(keypair) {
+        this.minter.setSigner(keypair);
+    }
+    /**
+     * Set the Merkle tree configuration
+     *
+     * @param treeConfig - Tree configuration
+     */
+    setTreeConfig(treeConfig) {
+        this.minter.setTreeConfig(treeConfig);
+    }
+    /**
+     * Get the user registry
+     */
+    getRegistry() {
+        return this.registry;
+    }
+    // ======================================
+    //  User Management
+    // ======================================
+    /**
+     * Register a user with their xidentity
+     *
+     * @param user - User to register
+     */
+    async registerUser(user) {
+        await this.registry.registerUser(user);
+    }
+    /**
+     * Get a registered user by Solana address
+     *
+     * @param solanaAddress - User's Solana address
+     * @returns Registered user or null
+     */
+    async getUser(solanaAddress) {
+        return this.registry.getUser(solanaAddress);
+    }
+    // ======================================
+    //  Minting Methods
+    // ======================================
+    /**
+     * 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
+     */
+    async mintInvoice(invoice, recipientAddress, options = {}) {
+        const bundle = buildInvoicePayload(invoice, {
+            uuid: options.uuid,
+            pdfBase64: options.pdfBase64,
+            senderProfile: options.senderProfile,
+            recipientProfile: options.recipientProfile,
+        });
+        return this.mint({
+            assetType: AssetType.INVOICE,
+            assetData: bundle,
+            recipientAddress,
+            name: options.name || `Invoice #${invoice.invoiceId}`,
+            description: options.description,
+            uuid: options.uuid,
+        });
+    }
+    /**
+     * Mint an encrypted file to a recipient (extension-compatible payload).
+     */
+    async mintFile(file, recipientAddress, options = {}) {
+        const payload = buildFilePayload(file, { id: options.uuid });
+        return this.mint({
+            assetType: AssetType.FILE,
+            assetData: payload,
+            recipientAddress,
+            name: options.name || file.filename,
+            description: options.description,
+            uuid: options.uuid,
+        });
+    }
+    /**
+     * Mint an encrypted message/note to a recipient (extension-compatible payload, type always 'sent').
+     */
+    async mintMessage(note, recipientAddress, options = {}) {
+        const payload = buildMessagePayload(note, {
+            uuid: options.uuid,
+            recipientId: options.recipientId,
+            recipientName: options.recipientName,
+            replyTo: options.replyTo,
+        });
+        return this.mint({
+            assetType: AssetType.NOTE,
+            assetData: payload,
+            recipientAddress,
+            name: options.name || note.title,
+            description: options.description,
+            uuid: options.uuid,
+        });
+    }
+    /**
+     * Mint an encrypted picture/photo to a recipient (extension-compatible payload).
+     */
+    async mintPhoto(photo, recipientAddress, options = {}) {
+        const payload = buildPhotoPayload(photo, {
+            id: options.uuid,
+            thumbnail: options.thumbnail,
+        });
+        return this.mint({
+            assetType: AssetType.PHOTO,
+            assetData: payload,
+            recipientAddress,
+            name: options.name || photo.filename,
+            description: options.description,
+            uuid: options.uuid,
+        });
+    }
+    /**
+     * 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
+     */
+    async mint(request) {
+        const { assetType, assetData, recipientAddress, name, description, attributes = [], 
+        // New fields
+        uuid, previousToken, schema, mimeType, dataSize, } = request;
+        try {
+            // 1. Look up recipient's xidentity
+            const recipient = await this.registry.getUser(recipientAddress);
+            if (!recipient) {
+                return {
+                    success: false,
+                    error: `Recipient not registered: ${recipientAddress}. User must register their xidentity first.`,
+                };
+            }
+            console.log(`[RWA SDK] Minting ${assetType} to ${recipientAddress}`);
+            // 2. Encrypt asset with recipient's xidentity
+            console.log('[RWA SDK] Encrypting asset...');
+            const encryptedPayload = await encryptAsset(assetData, assetType, recipient.xidentity, this.encryptor, { uuid, previousToken, schema });
+            // 3. Upload encrypted data to Arweave
+            console.log('[RWA SDK] Uploading encrypted data to Arweave...');
+            const dataUploadResult = await uploadEncryptedAsset(encryptedPayload, {
+                assetType,
+                direction: 'received',
+                network: this.config.network,
+            }, this.uploadOptions);
+            console.log('[RWA SDK] Encrypted data uploaded:', dataUploadResult.id);
+            // 4. Generate NFT metadata with new fields
+            const nftMetadata = generateNFTMetadata({
+                name,
+                description,
+                assetType,
+                encryptedDataUri: dataUploadResult.arweaveUri,
+                owner: recipientAddress,
+                direction: 'received',
+                additionalAttributes: attributes,
+                // New fields from encryption result
+                uuid: encryptedPayload.uuid,
+                timestamp: Math.floor(encryptedPayload.timestamp / 1000), // Convert to seconds
+                previousToken,
+                schema,
+                mimeType,
+                dataSize: dataSize || encryptedPayload.dataSize,
+            });
+            // 5. Upload metadata to Arweave
+            console.log('[RWA SDK] Uploading metadata to Arweave...');
+            const metadataUploadResult = await uploadMetadata(nftMetadata, this.uploadOptions);
+            console.log('[RWA SDK] Metadata uploaded:', metadataUploadResult.id);
+            // 6. Mint cNFT
+            console.log('[RWA SDK] Minting cNFT...');
+            const mintResult = await this.minter.mint({
+                metadataUri: metadataUploadResult.arweaveUri,
+                name,
+                recipient: recipientAddress,
+            });
+            if (!mintResult.success) {
+                return { ...mintResult, uuid: encryptedPayload.uuid };
+            }
+            console.log('[RWA SDK] cNFT minted successfully!');
+            return {
+                success: true,
+                assetId: mintResult.assetId,
+                signature: mintResult.signature,
+                arweaveTxId: dataUploadResult.id,
+                metadataArweaveTxId: metadataUploadResult.id,
+                uuid: encryptedPayload.uuid,
+            };
+        }
+        catch (err) {
+            const errorMessage = err instanceof Error ? err.message : 'Unknown error';
+            console.error('[RWA SDK] Minting failed:', errorMessage);
+            return {
+                success: false,
+                error: errorMessage,
+            };
+        }
+    }
+    // ======================================
+    //  Batch Minting
+    // ======================================
+    /**
+     * Mint multiple invoices to different recipients
+     *
+     * @param invoices - Array of invoice requests
+     * @returns Array of mint results
+     */
+    async mintInvoiceBatch(invoices) {
+        const results = [];
+        for (const item of invoices) {
+            const result = await this.mintInvoice(item.invoice, item.recipientAddress, { name: item.name });
+            results.push(result);
+        }
+        return results;
+    }
+    // ======================================
+    //  Utility Methods
+    // ======================================
+    /**
+     * Check if a user is registered
+     *
+     * @param solanaAddress - User's Solana address
+     * @returns true if registered
+     */
+    async isUserRegistered(solanaAddress) {
+        const user = await this.registry.getUser(solanaAddress);
+        return user !== null;
+    }
+    /**
+     * Get the current tree configuration
+     */
+    async getTreeConfig() {
+        return this.minter.getTreeConfig();
+    }
+    /**
+     * 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
+     */
+    async encryptAndUpload(assetData, assetType, recipientXidentity) {
+        // Encrypt
+        const encryptedPayload = await encryptAsset(assetData, assetType, recipientXidentity, this.encryptor);
+        // Upload encrypted data
+        const dataUploadResult = await uploadEncryptedAsset(encryptedPayload, {
+            assetType,
+            direction: 'received',
+            network: this.config.network,
+        }, this.uploadOptions);
+        // Generate and upload metadata
+        const nftMetadata = generateNFTMetadata({
+            name: `Encrypted ${assetType}`,
+            assetType,
+            encryptedDataUri: dataUploadResult.arweaveUri,
+            owner: 'pending', // Will be set during minting
+            direction: 'received',
+        });
+        const metadataUploadResult = await uploadMetadata(nftMetadata, this.uploadOptions);
+        return {
+            encryptedDataUri: dataUploadResult.arweaveUri,
+            metadataUri: metadataUploadResult.arweaveUri,
+        };
+    }
+}
+// ======================================
+//  Factory Function
+// ======================================
+/**
+ * Create a new RWA SDK instance
+ *
+ * @param config - SDK configuration
+ * @param options - Additional options
+ * @returns YalletRWASDK instance
+ */
+export function createRWASDK(config, options) {
+    return new YalletRWASDK(config, options);
+}
+//# sourceMappingURL=sdk.js.map

package/dist/sdk.js.map

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

package/dist/storage.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Yallet RWA SDK - Storage Module
+ *
+ * Handles uploading encrypted data to Arweave via ArDrive Turbo
+ */
+import type { EncryptedPayload, AssetType } from './types.js';
+export interface UploadOptions {
+    /** Arweave API key (for ArDrive Turbo uploads) */
+    apiKey?: string;
+    /** Network: mainnet or devnet */
+    network?: 'mainnet' | 'devnet';
+    /** Custom endpoint */
+    endpoint?: string;
+    /** Content type */
+    contentType?: string;
+    /** Custom tags */
+    tags?: Record<string, string>;
+}
+export interface UploadResult {
+    /** Arweave transaction ID */
+    id: string;
+    /** Full Arweave URL */
+    url: string;
+    /** ar:// URI */
+    arweaveUri: string;
+    /** Upload timestamp */
+    timestamp: number;
+}
+/**
+ * Upload data to Arweave.
+ * Default: POST to Yallet backend (api.yallet.xyz → backend ArDrive Turbo).
+ * If options.endpoint is set to an Irys URL (e.g. turbo.irys.xyz), uses direct Irys /tx instead.
+ *
+ * @param data - Data to upload (string or Uint8Array)
+ * @param options - Upload options
+ * @returns Upload result with transaction ID
+ */
+export declare function uploadToArweave(data: string | Uint8Array, options?: UploadOptions): Promise<UploadResult>;
+/**
+ * Upload encrypted asset to Arweave
+ *
+ * @param encryptedPayload - Encrypted asset data (with extended fields)
+ * @param metadata - Additional metadata
+ * @param options - Upload options
+ * @returns Upload result
+ */
+export declare function uploadEncryptedAsset(encryptedPayload: EncryptedPayload & {
+    assetType: AssetType;
+    version: number;
+    uuid?: string;
+    timestamp?: number;
+    dataSize?: number;
+}, metadata: {
+    assetType: AssetType;
+    direction?: 'owned' | 'sent' | 'received';
+    network?: 'mainnet' | 'devnet';
+}, options?: UploadOptions): Promise<UploadResult>;
+/**
+ * Upload NFT metadata to Arweave
+ *
+ * @param metadata - NFT metadata object
+ * @param options - Upload options
+ * @returns Upload result
+ */
+export declare function uploadMetadata(metadata: Record<string, unknown>, options?: UploadOptions): Promise<UploadResult>;
+/**
+ * Download data from Arweave
+ *
+ * @param txIdOrUri - Transaction ID or ar:// URI
+ * @returns Fetched data
+ */
+export declare function downloadFromArweave(txIdOrUri: string): Promise<Response>;
+/**
+ * Download and parse JSON from Arweave
+ *
+ * @param txIdOrUri - Transaction ID or ar:// URI
+ * @returns Parsed JSON
+ */
+export declare function downloadJsonFromArweave<T = unknown>(txIdOrUri: string): Promise<T>;
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAkG9D,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,OAAO,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC/B,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,GAAG,UAAU,EACzB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAqFvB;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,gBAAgB,EAAE,gBAAgB,GAAG;IACnC,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,EACD,QAAQ,EAAE;IACR,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,CAAC;IAC1C,OAAO,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;CAChC,EACD,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAgCvB;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAYvB;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAqC9E;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,CAAC,GAAG,OAAO,EACvD,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,CAAC,CAGZ"}