@zucchinifi/dapp-sdk 0.1.0

package/dist/zip321.js

@@ -0,0 +1,354 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Zip321Generator = exports.Zip321Parser = exports.Zip321ParsingError = void 0;
+exports.parsePaymentUri = parsePaymentUri;
+exports.createPaymentUri = createPaymentUri;
+const bech32_1 = require("bech32");
+const bs58check_1 = __importDefault(require("bs58check"));
+const unified_address_1 = require("./unified_address");
+class Zip321ParsingError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'Zip321ParsingError';
+    }
+}
+exports.Zip321ParsingError = Zip321ParsingError;
+class Zip321Parser {
+    /**
+     * Parses a zcash: URI into a list of Payment objects.
+     * @param uri The zcash URI string.
+     * @param options Parsing options.
+     * @returns An array of Payment objects.
+     * @throws Zip321ParsingError if the URI is invalid.
+     */
+    static parse(uri, options = {}) {
+        if (!uri.startsWith('zcash:')) {
+            throw new Zip321ParsingError('Invalid scheme: must start with zcash:');
+        }
+        const parts = uri.substring(6).split('?');
+        const path = parts[0];
+        const query = parts[1];
+        if (parts.length > 2) {
+            throw new Zip321ParsingError('Invalid URI: multiple question marks');
+        }
+        const params = new URLSearchParams(query || '');
+        const payments = new Map();
+        // Helper to get or create payment at index
+        const getPayment = (index) => {
+            if (!payments.has(index)) {
+                payments.set(index, { address: '' });
+            }
+            return payments.get(index);
+        };
+        // 1. Handle address in path
+        if (path && path.length > 0) {
+            if (!this.isValidAddress(path)) {
+                throw new Zip321ParsingError(`Invalid address in path: ${path}`);
+            }
+            const p = getPayment(0);
+            p.address = path;
+        }
+        // 2. Parse query parameters
+        params.forEach((value, key) => {
+            const match = key.match(/^([a-zA-Z][a-zA-Z0-9+-]*)(\.(\d+))?$/);
+            if (!match) {
+                if (key.startsWith('req-')) {
+                    throw new Zip321ParsingError(`Unknown required parameter: ${key}`);
+                }
+                return; // Ignore unknown non-req params
+            }
+            const paramName = match[1];
+            const indexStr = match[3];
+            let index = 0;
+            if (indexStr) {
+                if (indexStr.startsWith('0')) {
+                    throw new Zip321ParsingError(`Invalid index (leading zero): ${indexStr}`);
+                }
+                index = parseInt(indexStr, 10);
+                if (index > 9999) {
+                    throw new Zip321ParsingError(`Index out of range: ${indexStr}`);
+                }
+            }
+            else {
+                index = 0;
+            }
+            if (index === 0 && paramName === 'address' && path.length > 0) {
+                throw new Zip321ParsingError('Duplicate address: defined in path and query');
+            }
+            const payment = getPayment(index);
+            switch (paramName) {
+                case 'address':
+                    if (payment.address)
+                        throw new Zip321ParsingError(`Duplicate address for index ${index}`);
+                    if (!this.isValidAddress(value))
+                        throw new Zip321ParsingError(`Invalid address: ${value}`);
+                    payment.address = value;
+                    break;
+                case 'amount':
+                    if (payment.amount !== undefined)
+                        throw new Zip321ParsingError(`Duplicate amount for index ${index}`);
+                    if (payment.assetId)
+                        throw new Zip321ParsingError(`Amount and req-asset cannot both be present for index ${index}`);
+                    payment.amount = this.parseAmount(value);
+                    break;
+                case 'req-asset':
+                    if (payment.assetId)
+                        throw new Zip321ParsingError(`Duplicate req-asset for index ${index}`);
+                    if (payment.amount !== undefined)
+                        throw new Zip321ParsingError(`Amount and req-asset cannot both be present for index ${index}`);
+                    const assetData = this.parseAsset(value);
+                    payment.assetId = assetData.assetId;
+                    payment.amount = assetData.amount;
+                    break;
+                case 'memo':
+                    if (payment.memo)
+                        throw new Zip321ParsingError(`Duplicate memo for index ${index}`);
+                    if (!this.isValidBase64Url(value))
+                        throw new Zip321ParsingError(`Invalid Base64URL memo: ${value}`);
+                    payment.memo = value;
+                    break;
+                case 'label':
+                    if (payment.label)
+                        throw new Zip321ParsingError(`Duplicate label for index ${index}`);
+                    payment.label = value;
+                    break;
+                case 'message':
+                    if (payment.message)
+                        throw new Zip321ParsingError(`Duplicate message for index ${index}`);
+                    payment.message = value;
+                    break;
+                default:
+                    if (paramName.startsWith('req-')) {
+                        throw new Zip321ParsingError(`Unknown required parameter: ${paramName}`);
+                    }
+                    if (!payment.otherParams)
+                        payment.otherParams = {};
+                    payment.otherParams[paramName] = value;
+                    break;
+            }
+        });
+        const result = [];
+        const sortedIndices = Array.from(payments.keys()).sort((a, b) => a - b);
+        for (const idx of sortedIndices) {
+            const p = payments.get(idx);
+            if (!p.address) {
+                throw new Zip321ParsingError(`Missing address for index ${idx}`);
+            }
+            if (this.isTransparent(p.address) && p.memo) {
+                throw new Zip321ParsingError(`Memo not allowed for transparent address at index ${idx}`);
+            }
+            if ((this.isTransparent(p.address) || this.isSapling(p.address)) && p.assetId) {
+                throw new Zip321ParsingError(`Custom assets not allowed for transparent/Sapling address at index ${idx}`);
+            }
+            result.push(p);
+        }
+        if (result.length === 0) {
+            throw new Zip321ParsingError('No payments found in URI');
+        }
+        // Orchard conversion logic
+        if (options.useOrchard) {
+            for (const p of result) {
+                if (this.isUnified(p.address)) {
+                    try {
+                        const ua = (0, unified_address_1.parseUnifiedAddress)(p.address);
+                        if (ua.orchard) {
+                            p.address = ua.orchard;
+                        }
+                    }
+                    catch (e) {
+                        console.warn('Failed to extract Orchard receiver from UA:', e);
+                    }
+                }
+            }
+        }
+        return result;
+    }
+    static isValidAddress(address) {
+        return this.isTransparent(address) || this.isSapling(address) || this.isUnified(address);
+    }
+    static isTransparent(address) {
+        try {
+            bs58check_1.default.decode(address);
+            return address.startsWith('t');
+        }
+        catch {
+            return false;
+        }
+    }
+    static isSapling(address) {
+        try {
+            const decoded = bech32_1.bech32.decode(address);
+            return decoded.prefix === 'zs' || decoded.prefix === 'ztestsapling';
+        }
+        catch {
+            return false;
+        }
+    }
+    static isUnified(address) {
+        try {
+            const decoded = bech32_1.bech32m.decode(address, 1000);
+            return decoded.prefix === 'u' || decoded.prefix === 'utest';
+        }
+        catch (e) {
+            return false;
+        }
+    }
+    static parseAmount(value) {
+        if (!/^\d+(\.\d{1,8})?$/.test(value)) {
+            throw new Zip321ParsingError(`Invalid amount format: ${value}`);
+        }
+        const parts = value.split('.');
+        let whole = BigInt(parts[0]);
+        let fraction = parts[1] || '';
+        fraction = fraction.padEnd(8, '0');
+        const zatoshis = whole * 100000000n + BigInt(fraction);
+        if (zatoshis > 2100000000000000n) {
+            throw new Zip321ParsingError(`Amount exceeds max supply: ${value}`);
+        }
+        return zatoshis;
+    }
+    static parseAsset(base64) {
+        if (!this.isValidBase64Url(base64)) {
+            throw new Zip321ParsingError(`Invalid Base64URL asset: ${base64}`);
+        }
+        const b64 = base64.replace(/-/g, '+').replace(/_/g, '/');
+        const pad = b64.length % 4;
+        const padded = pad ? b64 + '='.repeat(4 - pad) : b64;
+        let buffer;
+        try {
+            const binString = atob(padded);
+            buffer = new Uint8Array(binString.length);
+            for (let i = 0; i < binString.length; i++) {
+                buffer[i] = binString.charCodeAt(i);
+            }
+        }
+        catch (e) {
+            throw new Zip321ParsingError(`Failed to decode asset base64: ${e}`);
+        }
+        if (buffer[0] !== 0x00) {
+            throw new Zip321ParsingError(`Unsupported asset version: ${buffer[0]}`);
+        }
+        const amountBytes = buffer.slice(1, 9);
+        let amount = 0n;
+        for (let i = 0; i < 8; i++) {
+            amount += BigInt(amountBytes[i]) << BigInt(i * 8);
+        }
+        const assetIdBytes = buffer.slice(9);
+        const assetId = Array.from(assetIdBytes).map(b => b.toString(16).padStart(2, '0')).join('');
+        return { assetId, amount };
+    }
+    static isValidBase64Url(str) {
+        return /^[A-Za-z0-9\-_]*$/.test(str);
+    }
+}
+exports.Zip321Parser = Zip321Parser;
+class Zip321Generator {
+    /**
+     * Creates a ZIP 321 compliant URI from a list of payments.
+     * @param payments List of Payment objects.
+     * @param options Generation options.
+     * @returns The formatted zcash: URI.
+     * @throws Error if payments list is empty or invalid.
+     */
+    static create(payments, options = {}) {
+        if (!payments || payments.length === 0) {
+            throw new Error('Payments list cannot be empty');
+        }
+        // Orchard conversion logic
+        const processedPayments = payments.map(p => {
+            if (options.useOrchard && Zip321Parser['isUnified'](p.address)) {
+                try {
+                    const ua = (0, unified_address_1.parseUnifiedAddress)(p.address);
+                    if (ua.orchard) {
+                        return { ...p, address: ua.orchard };
+                    }
+                }
+                catch (e) {
+                    console.warn('Failed to extract Orchard receiver from UA:', e);
+                }
+            }
+            return p;
+        });
+        processedPayments.forEach((p, i) => {
+            if (!p.address)
+                throw new Error(`Payment at index ${i} missing address`);
+        });
+        const parts = [];
+        const primary = processedPayments[0];
+        let uri = `zcash:${primary.address}`;
+        const addParam = (key, value, index) => {
+            if (value === undefined)
+                return;
+            const paramKey = index !== undefined && index > 0 ? `${key}.${index}` : key;
+            parts.push(`${paramKey}=${value}`);
+        };
+        if (primary.assetId) {
+            addParam('req-asset', this.formatAsset(primary.assetId, primary.amount || 0n));
+        }
+        else if (primary.amount !== undefined) {
+            addParam('amount', this.formatAmount(primary.amount));
+        }
+        addParam('memo', primary.memo);
+        addParam('label', primary.label);
+        addParam('message', primary.message);
+        if (primary.otherParams) {
+            Object.entries(primary.otherParams).forEach(([k, v]) => addParam(k, v));
+        }
+        for (let i = 1; i < processedPayments.length; i++) {
+            const p = processedPayments[i];
+            addParam('address', p.address, i);
+            if (p.assetId) {
+                addParam('req-asset', this.formatAsset(p.assetId, p.amount || 0n), i);
+            }
+            else if (p.amount !== undefined) {
+                addParam('amount', this.formatAmount(p.amount), i);
+            }
+            addParam('memo', p.memo, i);
+            addParam('label', p.label, i);
+            addParam('message', p.message, i);
+            if (p.otherParams) {
+                Object.entries(p.otherParams).forEach(([k, v]) => addParam(k, v, i));
+            }
+        }
+        if (parts.length > 0) {
+            uri += `?${parts.join('&')}`;
+        }
+        return uri;
+    }
+    static formatAmount(zatoshis) {
+        const whole = zatoshis / 100000000n;
+        const frac = zatoshis % 100000000n;
+        if (frac === 0n) {
+            return whole.toString();
+        }
+        let fracStr = frac.toString().padStart(8, '0');
+        fracStr = fracStr.replace(/0+$/, '');
+        return `${whole}.${fracStr}`;
+    }
+    static formatAsset(assetId, amount) {
+        const buffer = new Uint8Array(1 + 8 + 32);
+        buffer[0] = 0x00;
+        for (let i = 0; i < 8; i++) {
+            buffer[1 + i] = Number((amount >> BigInt(i * 8)) & 0xffn);
+        }
+        for (let i = 0; i < 32; i++) {
+            buffer[9 + i] = parseInt(assetId.substr(i * 2, 2), 16);
+        }
+        let binary = '';
+        for (let i = 0; i < buffer.length; i++) {
+            binary += String.fromCharCode(buffer[i]);
+        }
+        const b64 = btoa(binary);
+        return b64.replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
+    }
+}
+exports.Zip321Generator = Zip321Generator;
+function parsePaymentUri(uri, options = {}) {
+    return Zip321Parser.parse(uri, options);
+}
+function createPaymentUri(payments, options = {}) {
+    return Zip321Generator.create(payments, options);
+}

package/dist/zip321.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/zip321.test.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const zip321_1 = require("./zip321");
+(0, vitest_1.describe)('Zip321Parser', () => {
+    (0, vitest_1.it)('parses a simple single payment URI', () => {
+        const uri = 'zcash:ztestsapling10yy2ex5dcqkclhc7z7yrnjq2z6feyjad56ptwlfgmy77dmaqqrl9gyhprdx59qgmsnyfska2kez?amount=1&memo=VGhpcyBpcyBhIHNpbXBsZSBtZW1vLg';
+        const payments = zip321_1.Zip321Parser.parse(uri);
+        (0, vitest_1.expect)(payments).toHaveLength(1);
+        (0, vitest_1.expect)(payments[0].address).toBe('ztestsapling10yy2ex5dcqkclhc7z7yrnjq2z6feyjad56ptwlfgmy77dmaqqrl9gyhprdx59qgmsnyfska2kez');
+        (0, vitest_1.expect)(payments[0].amount).toBe(100000000n);
+        (0, vitest_1.expect)(payments[0].memo).toBe('VGhpcyBpcyBhIHNpbXBsZSBtZW1vLg');
+    });
+    (0, vitest_1.it)('parses a multi-payment URI', () => {
+        const uri = 'zcash:?address=tmEZhbWHTpdKMw5it8YDspUXSMGQyFwovpU&amount=123.456&address.1=ztestsapling10yy2ex5dcqkclhc7z7yrnjq2z6feyjad56ptwlfgmy77dmaqqrl9gyhprdx59qgmsnyfska2kez&amount.1=0.001&memo.1=VGhpcyBpcyBhIHNpbXBsZSBtZW1vLg';
+        const payments = zip321_1.Zip321Parser.parse(uri);
+        (0, vitest_1.expect)(payments).toHaveLength(2);
+        // Index 0 (implicit)
+        (0, vitest_1.expect)(payments[0].address).toBe('tmEZhbWHTpdKMw5it8YDspUXSMGQyFwovpU');
+        (0, vitest_1.expect)(payments[0].amount).toBe(12345600000n);
+        // Index 1
+        (0, vitest_1.expect)(payments[1].address).toBe('ztestsapling10yy2ex5dcqkclhc7z7yrnjq2z6feyjad56ptwlfgmy77dmaqqrl9gyhprdx59qgmsnyfska2kez');
+        (0, vitest_1.expect)(payments[1].amount).toBe(100000n);
+        (0, vitest_1.expect)(payments[1].memo).toBe('VGhpcyBpcyBhIHNpbXBsZSBtZW1vLg');
+    });
+    (0, vitest_1.it)('parses URI with address in path', () => {
+        const uri = 'zcash:ztestsapling10yy2ex5dcqkclhc7z7yrnjq2z6feyjad56ptwlfgmy77dmaqqrl9gyhprdx59qgmsnyfska2kez?amount=1';
+        const payments = zip321_1.Zip321Parser.parse(uri);
+        (0, vitest_1.expect)(payments).toHaveLength(1);
+        (0, vitest_1.expect)(payments[0].address).toBe('ztestsapling10yy2ex5dcqkclhc7z7yrnjq2z6feyjad56ptwlfgmy77dmaqqrl9gyhprdx59qgmsnyfska2kez');
+        (0, vitest_1.expect)(payments[0].amount).toBe(100000000n);
+    });
+    (0, vitest_1.it)('throws on invalid scheme', () => {
+        (0, vitest_1.expect)(() => zip321_1.Zip321Parser.parse('http:ztestsapling...')).toThrow('Invalid scheme');
+    });
+    (0, vitest_1.it)('throws on duplicate address', () => {
+        (0, vitest_1.expect)(() => zip321_1.Zip321Parser.parse('zcash:ztestsapling10yy2ex5dcqkclhc7z7yrnjq2z6feyjad56ptwlfgmy77dmaqqrl9gyhprdx59qgmsnyfska2kez?address=ztestsapling10yy2ex5dcqkclhc7z7yrnjq2z6feyjad56ptwlfgmy77dmaqqrl9gyhprdx59qgmsnyfska2kez')).toThrow('Duplicate address');
+    });
+    (0, vitest_1.it)('throws on missing address for index', () => {
+        (0, vitest_1.expect)(() => zip321_1.Zip321Parser.parse('zcash:?amount=1')).toThrow('Missing address');
+    });
+    (0, vitest_1.it)('throws on invalid amount format', () => {
+        (0, vitest_1.expect)(() => zip321_1.Zip321Parser.parse('zcash:ztestsapling10yy2ex5dcqkclhc7z7yrnjq2z6feyjad56ptwlfgmy77dmaqqrl9gyhprdx59qgmsnyfska2kez?amount=1.2.3')).toThrow('Invalid amount');
+    });
+    (0, vitest_1.it)('throws on memo for transparent address', () => {
+        const uri = 'zcash:tmEZhbWHTpdKMw5it8YDspUXSMGQyFwovpU?amount=1&memo=VGhpcyBpcyBhIHNpbXBsZSBtZW1vLg';
+        (0, vitest_1.expect)(() => zip321_1.Zip321Parser.parse(uri)).toThrow('Memo not allowed for transparent address');
+    });
+});
+(0, vitest_1.describe)('Zip321Generator', () => {
+    (0, vitest_1.it)('creates a simple single payment URI', () => {
+        const payments = [{
+                address: 'ztestsapling10yy2ex5dcqkclhc7z7yrnjq2z6feyjad56ptwlfgmy77dmaqqrl9gyhprdx59qgmsnyfska2kez',
+                amount: 100000000n,
+                memo: 'VGhpcyBpcyBhIHNpbXBsZSBtZW1vLg'
+            }];
+        const uri = zip321_1.Zip321Generator.create(payments);
+        (0, vitest_1.expect)(uri).toContain('zcash:ztestsapling10yy2ex5dcqkclhc7z7yrnjq2z6feyjad56ptwlfgmy77dmaqqrl9gyhprdx59qgmsnyfska2kez');
+        (0, vitest_1.expect)(uri).toContain('amount=1');
+        (0, vitest_1.expect)(uri).toContain('memo=VGhpcyBpcyBhIHNpbXBsZSBtZW1vLg');
+    });
+    (0, vitest_1.it)('creates a multi-payment URI', () => {
+        const payments = [
+            {
+                address: 'tmEZhbWHTpdKMw5it8YDspUXSMGQyFwovpU',
+                amount: 12345600000n
+            },
+            {
+                address: 'ztestsapling10yy2ex5dcqkclhc7z7yrnjq2z6feyjad56ptwlfgmy77dmaqqrl9gyhprdx59qgmsnyfska2kez',
+                amount: 100000n,
+                memo: 'VGhpcyBpcyBhIHNpbXBsZSBtZW1vLg'
+            }
+        ];
+        const uri = zip321_1.Zip321Generator.create(payments);
+        (0, vitest_1.expect)(uri).toContain('zcash:tmEZhbWHTpdKMw5it8YDspUXSMGQyFwovpU');
+        (0, vitest_1.expect)(uri).toContain('amount=123.456');
+        (0, vitest_1.expect)(uri).toContain('address.1=ztestsapling10yy2ex5dcqkclhc7z7yrnjq2z6feyjad56ptwlfgmy77dmaqqrl9gyhprdx59qgmsnyfska2kez');
+        (0, vitest_1.expect)(uri).toContain('amount.1=0.001');
+        (0, vitest_1.expect)(uri).toContain('memo.1=VGhpcyBpcyBhIHNpbXBsZSBtZW1vLg');
+    });
+    (0, vitest_1.it)('round-trip test', () => {
+        const original = [
+            {
+                address: 'ztestsapling10yy2ex5dcqkclhc7z7yrnjq2z6feyjad56ptwlfgmy77dmaqqrl9gyhprdx59qgmsnyfska2kez',
+                amount: 50000000n,
+                memo: 'VGhpcyBpcyBhIHNpbXBsZSBtZW1vLg'
+            },
+            {
+                address: 'tmEZhbWHTpdKMw5it8YDspUXSMGQyFwovpU',
+                amount: 100000000n
+            }
+        ];
+        const uri = zip321_1.Zip321Generator.create(original);
+        const parsed = zip321_1.Zip321Parser.parse(uri);
+        (0, vitest_1.expect)(parsed).toHaveLength(2);
+        (0, vitest_1.expect)(parsed[0].address).toBe(original[0].address);
+        (0, vitest_1.expect)(parsed[0].amount).toBe(original[0].amount);
+        (0, vitest_1.expect)(parsed[0].memo).toBe(original[0].memo);
+        (0, vitest_1.expect)(parsed[1].address).toBe(original[1].address);
+        (0, vitest_1.expect)(parsed[1].amount).toBe(original[1].amount);
+    });
+    (0, vitest_1.it)('parses the user reported unified address', () => {
+        const ua = 'u1cen6dqc7qdwm24m0wkr3ph59vlrzksqx0e28j0yv8xhfvdv68k7yexafyrwja3qe20naaaa75q33sujupsmsc7t3vw34q83dl2xa70ud8z0p28z83fuc2gry6q23aame7xjwyp4n2vvuu7audwrcmu0gwqn6crmf6pky75pa000w6c4zlhv2gfdw8tveezxaj73atp5hj7w82fycwny';
+        const uri = `zcash:${ua}?amount=1&label=Payment%20Request`;
+        const parsed = zip321_1.Zip321Parser.parse(uri);
+        (0, vitest_1.expect)(parsed).toHaveLength(1);
+        (0, vitest_1.expect)(parsed[0].address).toBe(ua);
+    });
+});

package/dist/zip321_orchard.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/zip321_orchard.test.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const zip321_1 = require("./zip321");
+(0, vitest_1.describe)('ZIP 321 Orchard Conversion', () => {
+    const unifiedAddress = 'u1cen6dqc7qdwm24m0wkr3ph59vlrzksqx0e28j0yv8xhfvdv68k7yexafyrwja3qe20naaaa75q33sujupsmsc7t3vw34q83dl2xa70ud8z0p28z83fuc2gry6q23aame7xjwyp4n2vvuu7audwrcmu0gwqn6crmf6pky75pa000w6c4zlhv2gfdw8tveezxaj73atp5hj7w82fycwny';
+    const orchardAddress = 'u1kv5mzj7pjc4syjepu72dc0ejns8eyfvwlgafnf5v7yke5mkme7d8jc05qkf656ud3kcr69822lxywjvtllg3sv09u2ur3uxdq5ez8v5q';
+    (0, vitest_1.it)('should use Unified Address by default in createPaymentUri', () => {
+        const uri = (0, zip321_1.createPaymentUri)([{ address: unifiedAddress, amount: 1000n }]);
+        (0, vitest_1.expect)(uri).toContain(unifiedAddress);
+        (0, vitest_1.expect)(uri).not.toContain(orchardAddress);
+    });
+    (0, vitest_1.it)('should convert to Orchard address in createPaymentUri when useOrchard is true', () => {
+        const uri = (0, zip321_1.createPaymentUri)([{ address: unifiedAddress, amount: 1000n }], { useOrchard: true });
+        (0, vitest_1.expect)(uri).toContain(orchardAddress);
+        (0, vitest_1.expect)(uri).not.toContain(unifiedAddress);
+    });
+    (0, vitest_1.it)('should use Unified Address by default in parsePaymentUri', () => {
+        const uri = `zcash:${unifiedAddress}?amount=0.00001`;
+        const payments = (0, zip321_1.parsePaymentUri)(uri);
+        (0, vitest_1.expect)(payments[0].address).toBe(unifiedAddress);
+    });
+    (0, vitest_1.it)('should convert to Orchard address in parsePaymentUri when useOrchard is true', () => {
+        const uri = `zcash:${unifiedAddress}?amount=0.00001`;
+        const payments = (0, zip321_1.parsePaymentUri)(uri, { useOrchard: true });
+        (0, vitest_1.expect)(payments[0].address).toBe(orchardAddress);
+    });
+    (0, vitest_1.it)('should handle multiple payments with conversion', () => {
+        const uri = `zcash:${unifiedAddress}?amount=1&address.1=${unifiedAddress}&amount.1=2`;
+        const payments = (0, zip321_1.parsePaymentUri)(uri, { useOrchard: true });
+        (0, vitest_1.expect)(payments[0].address).toBe(orchardAddress);
+        (0, vitest_1.expect)(payments[1].address).toBe(orchardAddress);
+    });
+});

package/package.json

@@ -0,0 +1,47 @@
+{
+    "name": "@zucchinifi/dapp-sdk",
+    "version": "0.1.0",
+    "description": "TypeScript SDK for Zucchini Wallet",
+    "main": "dist/index.js",
+    "module": "dist/index.mjs",
+    "types": "dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.mjs",
+            "require": "./dist/index.js"
+        }
+    },
+    "files": [
+        "dist",
+        "README.md"
+    ],
+    "scripts": {
+        "build": "tsup src/index.ts --format cjs,esm --dts",
+        "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+        "lint": "tsc --noEmit",
+        "test": "vitest run"
+    },
+    "keywords": [
+        "zcash",
+        "wallet",
+        "sdk",
+        "zucchini"
+    ],
+    "author": "Zucchini Team",
+    "license": "MIT",
+    "devDependencies": {
+        "@types/qrcode": "^1.5.6",
+        "tsup": "^8.0.0",
+        "typescript": "^5.0.0",
+        "vitest": "^2.1.4"
+    },
+    "dependencies": {
+        "@noble/hashes": "^2.0.1",
+        "bech32": "^2.0.0",
+        "bigint-buffer": "^1.1.5",
+        "blakejs": "^1.2.1",
+        "bs58check": "^4.0.0",
+        "qrcode": "^1.5.4"
+    }
+}