@beclab/olaresid 0.1.1 → 0.1.2

package/dist/utils/tag-type-builder.js

@@ -0,0 +1,410 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TupleTypeBuilder = exports.TagTypeBuilder = void 0;
+/**
+ * Tag Type Builder
+ * Calculate ABI type bytes offline without contract calls
+ * Does NOT handle encoding/decoding - use TagAbiCodec for that
+ *
+ * Encoding Rules:
+ * - uint: 0x01 + size (size = bits/8)
+ * - int: 0x00 + size
+ * - bool: 0x02
+ * - string: 0x03
+ * - array: 0x04 + elementType
+ * - fixedArray: 0x05 + length (2 bytes) + elementType
+ * - tuple: 0x06 + fieldCount (2 bytes) + fieldTypes...
+ * - address: 0x07
+ * - fixedBytes: 0x08 + size
+ * - bytes: 0x09
+ */
+class TagTypeBuilder {
+    constructor(typeBytes, abiTypeString = '') {
+        this.typeBytes = '';
+        this.abiTypeString = '';
+        this.typeBytes = typeBytes;
+        this.abiTypeString = abiTypeString;
+    }
+    /**
+     * Get ABI type bytes (without 0x prefix)
+     */
+    getTypeBytes() {
+        return this.typeBytes;
+    }
+    /**
+     * Get ABI type string (e.g., "string", "uint256", "tuple(string,uint8)")
+     */
+    getAbiTypeString() {
+        return this.abiTypeString;
+    }
+    /**
+     * Parse type bytes to ABI type string
+     * This is the reverse operation of building type bytes
+     * @param typeBytes Hex string of type bytes (with or without 0x prefix)
+     * @returns ABI type string
+     */
+    static parseTypeBytesToAbiString(typeBytes) {
+        // Remove 0x prefix if present
+        const bytes = typeBytes.startsWith('0x')
+            ? typeBytes.slice(2)
+            : typeBytes;
+        if (bytes.length === 0) {
+            throw new Error('Empty type bytes');
+        }
+        const typeFlag = parseInt(bytes.slice(0, 2), 16);
+        switch (typeFlag) {
+            case 0x00: {
+                // int
+                const size = parseInt(bytes.slice(2, 4), 16);
+                return `int${size * 8}`;
+            }
+            case 0x01: {
+                // uint
+                const size = parseInt(bytes.slice(2, 4), 16);
+                return `uint${size * 8}`;
+            }
+            case 0x02: {
+                // bool
+                return 'bool';
+            }
+            case 0x03: {
+                // string
+                return 'string';
+            }
+            case 0x04: {
+                // array
+                const elementTypeBytes = '0x' + bytes.slice(2);
+                const elementType = this.parseTypeBytesToAbiString(elementTypeBytes);
+                return `${elementType}[]`;
+            }
+            case 0x05: {
+                // fixedArray
+                const length = parseInt(bytes.slice(2, 6), 16);
+                const elementTypeBytes = '0x' + bytes.slice(6);
+                const elementType = this.parseTypeBytesToAbiString(elementTypeBytes);
+                return `${elementType}[${length}]`;
+            }
+            case 0x06: {
+                // tuple
+                const fieldCount = parseInt(bytes.slice(2, 6), 16);
+                let offset = 6;
+                const fieldTypes = [];
+                for (let i = 0; i < fieldCount; i++) {
+                    // Parse each field's type recursively
+                    const fieldTypeBytes = '0x' + bytes.slice(offset);
+                    const fieldType = this.parseTypeBytesToAbiString(fieldTypeBytes);
+                    fieldTypes.push(fieldType);
+                    // Calculate the length of this field's type bytes
+                    const fieldTypeBytesLength = this.getTypeBytesLength(fieldTypeBytes);
+                    offset += fieldTypeBytesLength;
+                }
+                return `tuple(${fieldTypes.join(',')})`;
+            }
+            case 0x07: {
+                // address
+                return 'address';
+            }
+            case 0x08: {
+                // fixedBytes
+                const size = parseInt(bytes.slice(2, 4), 16);
+                return `bytes${size}`;
+            }
+            case 0x09: {
+                // bytes
+                return 'bytes';
+            }
+            default:
+                throw new Error(`Unknown type flag: 0x${typeFlag.toString(16)}`);
+        }
+    }
+    /**
+     * Calculate the byte length of a type bytes string (without 0x prefix)
+     * @private
+     */
+    static getTypeBytesLength(typeBytes) {
+        const bytes = typeBytes.startsWith('0x')
+            ? typeBytes.slice(2)
+            : typeBytes;
+        const typeFlag = parseInt(bytes.slice(0, 2), 16);
+        switch (typeFlag) {
+            case 0x00: // int
+            case 0x01: // uint
+            case 0x08: // fixedBytes
+                return 4; // 1 byte flag + 1 byte size
+            case 0x02: // bool
+            case 0x03: // string
+            case 0x07: // address
+            case 0x09: // bytes
+                return 2; // 1 byte flag only
+            case 0x04: {
+                // array
+                const elementTypeBytes = '0x' + bytes.slice(2);
+                return 2 + this.getTypeBytesLength(elementTypeBytes);
+            }
+            case 0x05: {
+                // fixedArray
+                const elementTypeBytes = '0x' + bytes.slice(6);
+                return 6 + this.getTypeBytesLength(elementTypeBytes); // flag + length (2 bytes) + element type
+            }
+            case 0x06: {
+                // tuple
+                const fieldCount = parseInt(bytes.slice(2, 6), 16);
+                let length = 6; // flag + field count (2 bytes)
+                let offset = 6;
+                for (let i = 0; i < fieldCount; i++) {
+                    const fieldTypeBytes = '0x' + bytes.slice(offset);
+                    const fieldLength = this.getTypeBytesLength(fieldTypeBytes);
+                    length += fieldLength;
+                    offset += fieldLength;
+                }
+                return length;
+            }
+            default:
+                throw new Error(`Unknown type flag: 0x${typeFlag.toString(16)}`);
+        }
+    }
+    /**
+     * Get field names (for Tuple types)
+     * Returns format: string[][], each element is a tuple's field name array
+     */
+    getFieldNames() {
+        // Default returns empty array, Tuple type will override this method
+        return [];
+    }
+    // ========================================
+    // Basic Types
+    // ========================================
+    /**
+     * uint type
+     * @param bits Bit count: 8, 16, 24, ..., 256 (must be divisible by 8)
+     * @example
+     * TagTypeBuilder.uint(8)   → "0101"
+     * TagTypeBuilder.uint(256) → "0120"
+     */
+    static uint(bits = 256) {
+        if (bits < 8 || bits > 256 || bits % 8 !== 0) {
+            throw new Error('uint bits must be 8-256 and divisible by 8');
+        }
+        const size = bits / 8;
+        const sizeHex = size.toString(16).padStart(2, '0');
+        return new TagTypeBuilder(`01${sizeHex}`, `uint${bits}`);
+    }
+    /**
+     * int type
+     * @param bits Bit count: 8, 16, 24, ..., 256 (must be divisible by 8)
+     * @example
+     * TagTypeBuilder.int(8)   → "0001"
+     * TagTypeBuilder.int(256) → "0020"
+     */
+    static int(bits = 256) {
+        if (bits < 8 || bits > 256 || bits % 8 !== 0) {
+            throw new Error('int bits must be 8-256 and divisible by 8');
+        }
+        const size = bits / 8;
+        const sizeHex = size.toString(16).padStart(2, '0');
+        return new TagTypeBuilder(`00${sizeHex}`, `int${bits}`);
+    }
+    /**
+     * bool type
+     * @example
+     * TagTypeBuilder.bool() → "02"
+     */
+    static bool() {
+        return new TagTypeBuilder('02', 'bool');
+    }
+    /**
+     * string type
+     * @example
+     * TagTypeBuilder.string() → "03"
+     */
+    static string() {
+        return new TagTypeBuilder('03', 'string');
+    }
+    /**
+     * address type
+     * @example
+     * TagTypeBuilder.address() → "07"
+     */
+    static address() {
+        return new TagTypeBuilder('07', 'address');
+    }
+    /**
+     * bytes type (dynamic length)
+     * @example
+     * TagTypeBuilder.bytes() → "09"
+     */
+    static bytes() {
+        return new TagTypeBuilder('09', 'bytes');
+    }
+    /**
+     * bytesN type (fixed length)
+     * @param size Byte count: 1-32
+     * @example
+     * TagTypeBuilder.fixedBytes(32) → "0820"
+     */
+    static fixedBytes(size) {
+        if (size < 1 || size > 32) {
+            throw new Error('Fixed bytes size must be between 1 and 32');
+        }
+        const sizeHex = size.toString(16).padStart(2, '0');
+        return new TagTypeBuilder(`08${sizeHex}`, `bytes${size}`);
+    }
+    // ========================================
+    // Array Types
+    // ========================================
+    /**
+     * Dynamic array
+     * @param elementType Element type
+     * @example
+     * TagTypeBuilder.array(TagTypeBuilder.address()) → "0407"
+     */
+    static array(elementType) {
+        const typeBytes = `04${elementType.getTypeBytes()}`;
+        const abiTypeString = `${elementType.getAbiTypeString()}[]`;
+        const fieldNames = elementType.getFieldNames();
+        // If element type has field names (e.g., tuple), propagate them
+        if (fieldNames.length > 0) {
+            return new TupleTypeBuilder(typeBytes, fieldNames, abiTypeString);
+        }
+        return new TagTypeBuilder(typeBytes, abiTypeString);
+    }
+    /**
+     * Fixed-length array
+     * @param elementType Element type
+     * @param length Array length (1-65535)
+     * @example
+     * TagTypeBuilder.fixedArray(TagTypeBuilder.address(), 5) → "05000507"
+     */
+    static fixedArray(elementType, length) {
+        if (length < 1 || length > 65535) {
+            throw new Error('Fixed array length must be between 1 and 65535');
+        }
+        const lengthHex = length.toString(16).padStart(4, '0');
+        const typeBytes = `05${lengthHex}${elementType.getTypeBytes()}`;
+        const abiTypeString = `${elementType.getAbiTypeString()}[${length}]`;
+        const fieldNames = elementType.getFieldNames();
+        // If element type has field names (e.g., tuple), propagate them
+        if (fieldNames.length > 0) {
+            return new TupleTypeBuilder(typeBytes, fieldNames, abiTypeString);
+        }
+        return new TagTypeBuilder(typeBytes, abiTypeString);
+    }
+    // ========================================
+    // Tuple (Struct)
+    // ========================================
+    /**
+     * tuple type
+     * @param fields Field definitions, format: { fieldName: fieldType }
+     * @example
+     * TagTypeBuilder.tuple({
+     *   name: TagTypeBuilder.string(),
+     *   age: TagTypeBuilder.uint8()
+     * }) → "060002" + "03" + "0101"
+     *
+     * Field names are collected in pre-order traversal (DFS pre-order) for nested tuples.
+     * Pre-order: Visit root first, then recursively visit children left-to-right.
+     *
+     * Example tree structure: A{B{D{E, F}}, C}
+     * fieldNames = [
+     *   ["i", "j"],  // A's fields (root)
+     *   ["i"],       // B's fields (A's 1st child)
+     *   ["i", "j"],  // D's fields (B's child)
+     *   ["i", "j"],  // E's fields (D's 1st child)
+     *   ["i", "j"],  // F's fields (D's 2nd child)
+     *   ["i"]        // C's fields (A's 2nd child)
+     * ]
+     */
+    static tuple(fields) {
+        const fieldNames = [];
+        const fieldTypes = [];
+        const fieldAbiTypes = [];
+        const allFieldNames = [];
+        // First, add current tuple's field names
+        for (const name of Object.keys(fields)) {
+            fieldNames.push(name);
+        }
+        allFieldNames.push(fieldNames);
+        // Then, recursively collect nested tuple field names in depth-first order
+        for (const [_name, type] of Object.entries(fields)) {
+            fieldTypes.push(type.getTypeBytes());
+            fieldAbiTypes.push(type.getAbiTypeString());
+            // Recursively collect nested tuple field names
+            const nested = type.getFieldNames();
+            if (nested.length > 0) {
+                allFieldNames.push(...nested);
+            }
+        }
+        const fieldCount = fieldTypes.length;
+        const fieldCountHex = fieldCount.toString(16).padStart(4, '0');
+        const typeBytes = `06${fieldCountHex}${fieldTypes.join('')}`;
+        const abiTypeString = `tuple(${fieldAbiTypes.join(',')})`;
+        return new TupleTypeBuilder(typeBytes, allFieldNames, abiTypeString, fields);
+    }
+    // ========================================
+    // Common Type Shortcuts
+    // ========================================
+    static uint8() {
+        return this.uint(8);
+    }
+    static uint16() {
+        return this.uint(16);
+    }
+    static uint32() {
+        return this.uint(32);
+    }
+    static uint64() {
+        return this.uint(64);
+    }
+    static uint128() {
+        return this.uint(128);
+    }
+    static uint256() {
+        return this.uint(256);
+    }
+    static int8() {
+        return this.int(8);
+    }
+    static int16() {
+        return this.int(16);
+    }
+    static int32() {
+        return this.int(32);
+    }
+    static int64() {
+        return this.int(64);
+    }
+    static int128() {
+        return this.int(128);
+    }
+    static int256() {
+        return this.int(256);
+    }
+    static bytes32() {
+        return this.fixedBytes(32);
+    }
+    static addressArray() {
+        return this.array(this.address());
+    }
+    static stringArray() {
+        return this.array(this.string());
+    }
+    static uint256Array() {
+        return this.array(this.uint256());
+    }
+}
+exports.TagTypeBuilder = TagTypeBuilder;
+/**
+ * Tuple Type Builder (supports field names and object encoding)
+ */
+class TupleTypeBuilder extends TagTypeBuilder {
+    constructor(typeBytes, fieldNames, abiTypeString = '', fieldTypes) {
+        super(typeBytes, abiTypeString);
+        this.fieldNames = fieldNames;
+        this.fieldTypes = fieldTypes;
+    }
+    getFieldNames() {
+        return this.fieldNames;
+    }
+}
+exports.TupleTypeBuilder = TupleTypeBuilder;
+//# sourceMappingURL=tag-type-builder.js.map

package/dist/utils/tag-type-builder.js.map

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

package/examples/crypto-utilities.ts

@@ -0,0 +1,140 @@
+/**
+ * Example: Crypto Utilities
+ *
+ * This example demonstrates all crypto utility functions:
+ * - Generate mnemonic phrases
+ * - Derive Ethereum addresses from mnemonics
+ * - Derive DIDs from mnemonics
+ * - Derive EVM private keys from mnemonics
+ * - Complete key derivation (all at once)
+ */
+
+import {
+	generateMnemonic,
+	getEthereumAddressFromMnemonic,
+	getDIDFromMnemonic,
+	getEVMPrivateKeyFromMnemonic,
+	deriveDIDFromMnemonic,
+	generateDIDKeyData
+} from '../src/utils/crypto-utils';
+
+async function main() {
+	console.log('='.repeat(60));
+	console.log('Crypto Utilities Examples');
+	console.log('='.repeat(60));
+
+	// =========================================================================
+	// 1. Generate Mnemonic
+	// =========================================================================
+	console.log('\n📝 Example 1: Generate Mnemonic Phrases');
+	console.log('-'.repeat(60));
+
+	const mnemonic12 = generateMnemonic(12);
+	console.log('12-word mnemonic:', mnemonic12);
+
+	const mnemonic24 = generateMnemonic(24);
+	console.log('24-word mnemonic:', mnemonic24);
+
+	// =========================================================================
+	// 2. Derive Ethereum Address
+	// =========================================================================
+	console.log('\n🏠 Example 2: Get Ethereum Address from Mnemonic');
+	console.log('-'.repeat(60));
+
+	const testMnemonic =
+		'abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about';
+	const address = await getEthereumAddressFromMnemonic(testMnemonic);
+	console.log('Mnemonic:', testMnemonic);
+	console.log('Address:', address);
+
+	// =========================================================================
+	// 3. Derive DID
+	// =========================================================================
+	console.log('\n🆔 Example 3: Get DID from Mnemonic');
+	console.log('-'.repeat(60));
+
+	const did = await getDIDFromMnemonic(testMnemonic);
+	console.log('Mnemonic:', testMnemonic);
+	console.log('DID:', did);
+
+	// =========================================================================
+	// 4. Derive EVM Private Key
+	// =========================================================================
+	console.log('\n🔑 Example 4: Get EVM Private Key from Mnemonic');
+	console.log('-'.repeat(60));
+
+	const privateKey = await getEVMPrivateKeyFromMnemonic(testMnemonic);
+	console.log('Mnemonic:', testMnemonic);
+	console.log('Private Key:', privateKey);
+	console.log('\n⚠️  Never share your private key!');
+
+	// =========================================================================
+	// 5. Derive Owner and DID Together
+	// =========================================================================
+	console.log('\n🔐 Example 5: Derive Owner and DID from Mnemonic');
+	console.log('-'.repeat(60));
+
+	const { owner, did: derivedDid } = await deriveDIDFromMnemonic(
+		testMnemonic
+	);
+	console.log('Mnemonic:', testMnemonic);
+	console.log('Owner (Address):', owner);
+	console.log('DID:', derivedDid);
+
+	// =========================================================================
+	// 6. Generate Complete Key Data (All at Once)
+	// =========================================================================
+	console.log('\n🎲 Example 6: Generate Complete Key Data');
+	console.log('-'.repeat(60));
+
+	const keyData12 = await generateDIDKeyData(12);
+	console.log('Generated 12-word key set:');
+	console.log('  Mnemonic:', keyData12.mnemonic);
+	console.log('  Owner:', keyData12.owner);
+	console.log('  DID:', keyData12.did);
+
+	const keyData24 = await generateDIDKeyData(24);
+	console.log('\nGenerated 24-word key set:');
+	console.log('  Mnemonic:', keyData24.mnemonic);
+	console.log('  Owner:', keyData24.owner);
+	console.log('  DID:', keyData24.did);
+
+	// =========================================================================
+	// 7. Verify Consistency
+	// =========================================================================
+	console.log('\n✅ Example 7: Verify Consistency');
+	console.log('-'.repeat(60));
+
+	const verifyMnemonic = generateMnemonic(12);
+	console.log('Testing mnemonic:', verifyMnemonic);
+
+	const addr1 = await getEthereumAddressFromMnemonic(verifyMnemonic);
+	const { owner: addr2 } = await deriveDIDFromMnemonic(verifyMnemonic);
+	const { owner: addr3 } = await generateDIDKeyData(12); // Different mnemonic
+
+	console.log('\nAddresses derived from same mnemonic:');
+	console.log('  Method 1 (getEthereumAddressFromMnemonic):', addr1);
+	console.log('  Method 2 (deriveDIDFromMnemonic):', addr2);
+	console.log('  Consistent?', addr1 === addr2 ? '✅ Yes' : '❌ No');
+
+	console.log('\nAddresses from different mnemonics:');
+	console.log('  Address 1:', addr1);
+	console.log('  Address 2:', addr3);
+	console.log('  Different?', addr1 !== addr3 ? '✅ Yes' : '❌ No');
+
+	// =========================================================================
+	// Summary
+	// =========================================================================
+	console.log('\n' + '='.repeat(60));
+	console.log('Summary of Crypto Utilities:');
+	console.log('='.repeat(60));
+	console.log('1. generateMnemonic(words)        - Generate new mnemonic');
+	console.log('2. getEthereumAddressFromMnemonic - Get Ethereum address');
+	console.log('3. getDIDFromMnemonic             - Get DID');
+	console.log('4. getEVMPrivateKeyFromMnemonic   - Get private key');
+	console.log('5. deriveDIDFromMnemonic          - Get owner + DID');
+	console.log('6. generateDIDKeyData             - Generate all at once');
+	console.log('='.repeat(60));
+}
+
+main().catch(console.error);

package/examples/domain-context.ts

@@ -0,0 +1,80 @@
+import OlaresID from '../src/index';
+
+async function main() {
+	console.log('='.repeat(60));
+	console.log('Testing DomainContext Methods');
+	console.log('='.repeat(60));
+
+	const didConsole = OlaresID.createTestnet();
+
+	const testDomain = '1.com';
+	const domain = didConsole.domain(testDomain);
+
+	// Test 1: getMetaInfo
+	console.log('\n📋 Test 1: getMetaInfo()');
+	console.log('-'.repeat(60));
+	try {
+		const metaInfo = await domain.getMetaInfo();
+		console.log('✅ Success:');
+		console.log('  ID:', metaInfo.id);
+		console.log('  Name:', metaInfo.name);
+		console.log('  DID:', metaInfo.did);
+		console.log('  Note:', metaInfo.note);
+		console.log('  Allow Subdomain:', metaInfo.allowSubdomain);
+	} catch (error) {
+		console.error('❌ Failed:', error);
+	}
+
+	// Test 2: getOwner
+	console.log('\n👤 Test 2: getOwner()');
+	console.log('-'.repeat(60));
+	try {
+		const owner = await domain.getOwner();
+		console.log('✅ Owner:', owner);
+	} catch (error) {
+		console.error('❌ Failed:', error);
+	}
+
+	// Test 3: isOwner (without signer, should throw)
+	console.log('\n🔑 Test 3: isOwner() - without signer');
+	console.log('-'.repeat(60));
+	try {
+		const isOwner = await domain.isOwner();
+		console.log('✅ Is Owner:', isOwner);
+	} catch (error) {
+		console.log('✅ Expected error:', error);
+	}
+
+	// Test 4: isOwner (with signer)
+	if (process.env.PRIVATE_KEY_OR_MNEMONIC) {
+		console.log('\n🔑 Test 4: isOwner() - with signer');
+		console.log('-'.repeat(60));
+		try {
+			await didConsole.setSigner(process.env.PRIVATE_KEY_OR_MNEMONIC);
+			const isOwner = await domain.isOwner();
+			console.log('✅ Is Owner:', isOwner);
+			didConsole.clearSigner();
+		} catch (error) {
+			console.error('❌ Failed:', error);
+		}
+	}
+
+	// Test 5: Test with non-existent domain
+	console.log('\n❓ Test 5: Non-existent domain');
+	console.log('-'.repeat(60));
+	const nonExistentDomain = didConsole.domain(
+		'this-domain-does-not-exist.olares.com'
+	);
+	try {
+		await nonExistentDomain.getMetaInfo();
+		console.error('❌ Should have thrown an error');
+	} catch (error) {
+		console.log('✅ Expected error:', error);
+	}
+
+	console.log('\n' + '='.repeat(60));
+	console.log('✅ All tests completed!');
+	console.log('='.repeat(60));
+}
+
+main().catch(console.error);