@beclab/olaresid 0.1.1 → 0.1.3

package/examples/test-type-bytes-parser.ts

@@ -0,0 +1,70 @@
+#!/usr/bin/env ts-node
+/**
+ * Test Type Bytes Parser
+ * Verifies that parseTypeBytesToAbiString correctly converts type bytes to ABI strings
+ */
+
+import { TagTypeBuilder } from '../src/utils/tag-type-builder';
+
+console.log('🧪 Testing Type Bytes Parser\n');
+
+interface TestCase {
+	name: string;
+	typeBytes: string;
+	expectedAbi: string;
+}
+
+const testCases: TestCase[] = [
+	// Simple types
+	{ name: 'string', typeBytes: '0x03', expectedAbi: 'string' },
+	{ name: 'uint8', typeBytes: '0x0101', expectedAbi: 'uint8' },
+	{ name: 'uint256', typeBytes: '0x0120', expectedAbi: 'uint256' },
+	{ name: 'bool', typeBytes: '0x02', expectedAbi: 'bool' },
+	{ name: 'address', typeBytes: '0x07', expectedAbi: 'address' },
+
+	// Array types
+	{ name: 'string[]', typeBytes: '0x0403', expectedAbi: 'string[]' },
+	{ name: 'address[]', typeBytes: '0x0407', expectedAbi: 'address[]' },
+
+	// Complex tuple (from tag-management.ts)
+	{
+		name: 'userInfo tuple',
+		typeBytes: '0x060004030101040702',
+		expectedAbi: 'tuple(string,uint8,address[],bool)'
+	}
+];
+
+let passed = 0;
+let failed = 0;
+
+for (const testCase of testCases) {
+	try {
+		const result = TagTypeBuilder.parseTypeBytesToAbiString(
+			testCase.typeBytes
+		);
+
+		if (result === testCase.expectedAbi) {
+			console.log(`✅ ${testCase.name}`);
+			console.log(`   Type bytes: ${testCase.typeBytes}`);
+			console.log(`   ABI string: ${result}\n`);
+			passed++;
+		} else {
+			console.log(`❌ ${testCase.name} - MISMATCH`);
+			console.log(`   Type bytes: ${testCase.typeBytes}`);
+			console.log(`   Expected: ${testCase.expectedAbi}`);
+			console.log(`   Got:      ${result}\n`);
+			failed++;
+		}
+	} catch (error: any) {
+		console.log(`❌ ${testCase.name} - ERROR`);
+		console.log(`   Type bytes: ${testCase.typeBytes}`);
+		console.log(`   Error: ${error.message}\n`);
+		failed++;
+	}
+}
+
+console.log('============================================================');
+console.log(`Results: ${passed} passed, ${failed} failed`);
+console.log('============================================================\n');
+
+process.exit(failed > 0 ? 1 : 0);

package/examples/transfer-domain.ts

@@ -0,0 +1,197 @@
+/**
+ * Example: Transfer domain ownership using mnemonic-derived keys
+ *
+ * This example demonstrates how to:
+ * 1. Connect to the network with the current owner's wallet
+ * 2. Generate or use a mnemonic for the new owner
+ * 3. Transfer domain ownership (both NFT and DID)
+ */
+
+import OlaresID, { generateMnemonic } from '../src/index';
+
+async function main() {
+	console.log('🔐 Domain Transfer Example\n');
+	console.log('='.repeat(60));
+
+	// ============================================================================
+	// Step 1: Setup
+	// ============================================================================
+	console.log('\n📝 Step 1: Setup Network and Wallet');
+	console.log('-'.repeat(60));
+
+	// Check for required environment variables
+	if (!process.env.PRIVATE_KEY_OR_MNEMONIC) {
+		console.error(
+			'❌ Error: PRIVATE_KEY_OR_MNEMONIC environment variable is required'
+		);
+		console.log('\nUsage:');
+		console.log('  export PRIVATE_KEY_OR_MNEMONIC=0x... (private key)');
+		console.log('  # Or');
+		console.log(
+			'  export PRIVATE_KEY_OR_MNEMONIC="your twelve words..." (mnemonic)'
+		);
+		console.log('  npx ts-node examples/transfer-domain.ts\n');
+		process.exit(1);
+	}
+
+	// ============================================================================
+	// Step 2: Initialize OlaresID
+	// ============================================================================
+	console.log('\n📝 Step 2: Initialize OlaresID');
+	console.log('-'.repeat(60));
+
+	const olaresId = OlaresID.createTestnet();
+	await olaresId.setSigner(process.env.PRIVATE_KEY_OR_MNEMONIC);
+
+	console.log('✅ OlaresID initialized for OP Sepolia Testnet');
+
+	// ============================================================================
+	// Step 3: Get Domain Information
+	// ============================================================================
+	console.log('\n📝 Step 3: Get Domain Information');
+	console.log('-'.repeat(60));
+
+	// Replace with your actual domain
+	const DOMAIN_NAME = process.env.DOMAIN || '1.com';
+	const domain = olaresId.domain(DOMAIN_NAME);
+
+	console.log(`📋 Domain: ${DOMAIN_NAME}`);
+
+	try {
+		const domainInfo = await domain.getMetaInfo();
+		const currentOwner = await domain.getOwner();
+
+		console.log('✅ Current domain info:');
+		console.log(`   - ID (Token ID): ${domainInfo.id}`);
+		console.log(`   - Owner: ${currentOwner}`);
+		console.log(`   - DID: ${domainInfo.did}`);
+		console.log(`   - Note: ${domainInfo.note}`);
+
+		// Verify ownership
+		const isOwner = await domain.isOwner();
+		if (!isOwner) {
+			console.error(
+				`❌ Error: You are not the owner of "${DOMAIN_NAME}"`
+			);
+			console.error(`   Current owner: ${currentOwner}`);
+			console.error(`   Your address: ${olaresId.signer?.getAddress()}`);
+			process.exit(1);
+		}
+		console.log('✅ Ownership verified');
+	} catch (error: any) {
+		console.error(
+			`❌ Error: Domain "${DOMAIN_NAME}" not found or not accessible`
+		);
+		console.error(`   ${error.message}`);
+		process.exit(1);
+	}
+
+	// ============================================================================
+	// Step 4: Generate Mnemonic for New Owner
+	// ============================================================================
+	console.log('\n📝 Step 4: Generate Mnemonic for New Owner');
+	console.log('-'.repeat(60));
+
+	// Generate a new mnemonic (or use existing one)
+	let mnemonic: string;
+	if (process.env.NEW_OWNER_MNEMONIC) {
+		mnemonic = process.env.NEW_OWNER_MNEMONIC;
+		console.log('📝 Using provided mnemonic');
+	} else {
+		mnemonic = generateMnemonic(12);
+		console.log('🔑 Generated 12-word mnemonic:');
+		console.log(`   ${mnemonic}`);
+		console.log(
+			'\n⚠️  IMPORTANT: Save this mnemonic securely! It controls the domain after transfer.\n'
+		);
+	}
+
+	// Preview new owner info
+	const { deriveDIDFromMnemonic } = await import('../src/utils/crypto-utils');
+	const { owner: newOwner, did: newDid } = await deriveDIDFromMnemonic(
+		mnemonic
+	);
+	console.log('👤 New owner (derived from mnemonic):');
+	console.log(`   - Address: ${newOwner}`);
+	console.log(`   - DID: ${newDid}`);
+
+	// ============================================================================
+	// Step 5: Confirm Transfer
+	// ============================================================================
+	console.log('\n📝 Step 5: Confirm Transfer');
+	console.log('-'.repeat(60));
+	console.log('⚠️  You are about to transfer domain ownership!');
+	console.log(`   Domain: ${DOMAIN_NAME}`);
+	console.log(`   From: ${olaresId.signer?.getAddress()}`);
+	console.log(`   To: ${newOwner}`);
+	console.log(
+		'\n⏸️  Press Ctrl+C to cancel, or wait 5 seconds to continue...\n'
+	);
+
+	// Wait 5 seconds
+	await new Promise((resolve) => setTimeout(resolve, 5000));
+
+	// ============================================================================
+	// Step 6: Transfer Domain
+	// ============================================================================
+	console.log('📝 Step 6: Transfer Domain');
+	console.log('-'.repeat(60));
+	console.log('⏳ Submitting transactions...\n');
+
+	try {
+		const result = await domain.transfer(mnemonic);
+
+		if (result.success) {
+			console.log('✅ Domain transferred successfully!\n');
+			console.log('═'.repeat(60));
+			console.log('Transfer Details:');
+			console.log('═'.repeat(60));
+			console.log(`Domain:              ${DOMAIN_NAME}`);
+			console.log(`New Owner:           ${result.data.newOwner}`);
+			console.log(`New DID:             ${result.data.newDid}`);
+			console.log(`Token ID:            ${result.data.tokenId}`);
+			console.log(`Transfer Tx Hash:    ${result.data.transferTxHash}`);
+			console.log(`Set DID Tx Hash:     ${result.data.setDidTxHash}`);
+			console.log(
+				`Total Gas Used:      ${result.gasUsed?.toString() || 'N/A'}`
+			);
+			console.log(`Block Number:        ${result.blockNumber || 'N/A'}`);
+			console.log('═'.repeat(60));
+
+			console.log('\n🔗 View transactions on block explorer:');
+			console.log(
+				`   Transfer: https://sepolia-optimism.etherscan.io/tx/${result.data.transferTxHash}`
+			);
+			console.log(
+				`   Set DID:  https://sepolia-optimism.etherscan.io/tx/${result.data.setDidTxHash}`
+			);
+		} else {
+			console.error('❌ Domain transfer failed!');
+			console.error(`   Error: ${result.error}`);
+			process.exit(1);
+		}
+	} catch (error: any) {
+		console.error('❌ Unexpected error during transfer:');
+		console.error(`   ${error.message}`);
+		if (error.stack) {
+			console.error('\nStack trace:');
+			console.error(error.stack);
+		}
+		process.exit(1);
+	}
+
+	// ============================================================================
+	// Done
+	// ============================================================================
+	console.log('\n✅ Transfer completed successfully!');
+	console.log(
+		'\n⚠️  Remember: The new owner is controlled by the mnemonic you generated/used.'
+	);
+	console.log('   Make sure to store it securely!\n');
+}
+
+// Run the example
+main().catch((error) => {
+	console.error('Fatal error:', error);
+	process.exit(1);
+});

package/examples/wallet-management.ts

@@ -0,0 +1,196 @@
+import OlaresID from '../src/index';
+
+/**
+ * Example: EVM and Solana Wallet Management
+ *
+ * This example demonstrates how to:
+ * 1. Add EVM wallets to a domain
+ * 2. Remove EVM wallets from a domain
+ * 3. List all EVM wallets for a domain
+ * 4. Add Solana wallets to a domain
+ * 5. Remove Solana wallets from a domain
+ * 6. List all Solana wallets for a domain
+ */
+
+/**
+ * Helper function to wait for blockchain indexing
+ * @param seconds - Number of seconds to wait
+ */
+async function waitForIndexing(seconds: number = 5) {
+	console.log(`   ⏳ Waiting ${seconds}s for blockchain indexing...`);
+	await new Promise((resolve) => setTimeout(resolve, seconds * 1000));
+}
+
+async function main() {
+	// Initialize OlaresID (using testnet)
+	const olaresId = OlaresID.createTestnet();
+
+	// Set signer (domain owner's private key or mnemonic)
+	const domainOwnerKey = process.env.PRIVATE_KEY_OR_MNEMONIC;
+	if (!domainOwnerKey) {
+		throw new Error(
+			'Please set PRIVATE_KEY_OR_MNEMONIC environment variable'
+		);
+	}
+	await olaresId.setSigner(domainOwnerKey);
+
+	// The domain to manage wallets for
+	const domainName = process.env.DOMAIN_NAME || '1.com';
+	const domain = olaresId.domain(domainName);
+
+	console.log(`\n🔧 Managing wallets for domain: ${domainName}\n`);
+
+	// ============================================================================
+	// EVM Wallet Management
+	// ============================================================================
+
+	console.log('📝 EVM Wallet Management\n');
+
+	// 1. List current EVM wallets
+	console.log('1️⃣ Listing current EVM wallets...');
+	const currentEVMWallets = await domain.getEVMWallets();
+	console.log(`   Found ${currentEVMWallets.length} EVM wallet(s):`);
+	currentEVMWallets.forEach((addr, i) => {
+		console.log(`   ${i + 1}. ${addr}`);
+	});
+	console.log('');
+
+	// 2. Add a new EVM wallet (optional - only if you have an EVM private key)
+	if (process.env.EVM_WALLET_PRIVATE_KEY) {
+		console.log('2️⃣ Adding a new EVM wallet...');
+		const addResult = await domain.addEVMWallet(
+			process.env.EVM_WALLET_PRIVATE_KEY
+		);
+
+		if (addResult.success) {
+			console.log(
+				`   ✅ Successfully added EVM wallet: ${addResult.data?.address}`
+			);
+			console.log(`   📝 Transaction hash: ${addResult.transactionHash}`);
+			console.log(`   ⛽ Gas used: ${addResult.gasUsed?.toString()}`);
+
+			// Wait for blockchain to index the transaction
+			await waitForIndexing(5);
+		} else {
+			console.log(`   ❌ Failed to add EVM wallet: ${addResult.error}`);
+		}
+		console.log('');
+
+		// 3. List EVM wallets again to confirm
+		console.log('3️⃣ Listing EVM wallets after addition...');
+		const updatedEVMWallets = await domain.getEVMWallets();
+		console.log(`   Found ${updatedEVMWallets.length} EVM wallet(s):`);
+		updatedEVMWallets.forEach((addr, i) => {
+			console.log(`   ${i + 1}. ${addr}`);
+		});
+		console.log('');
+	}
+
+	// 4. Remove an EVM wallet (optional)
+	if (process.env.EVM_WALLET_TO_REMOVE) {
+		console.log('4️⃣ Removing an EVM wallet...');
+		const removeResult = await domain.removeEVMWallet(
+			process.env.EVM_WALLET_TO_REMOVE
+		);
+
+		if (removeResult.success) {
+			console.log(
+				`   ✅ Successfully removed EVM wallet: ${removeResult.data?.address}`
+			);
+			console.log(
+				`   📝 Transaction hash: ${removeResult.transactionHash}`
+			);
+
+			// Wait for blockchain to index the transaction
+			await waitForIndexing(5);
+		} else {
+			console.log(
+				`   ❌ Failed to remove EVM wallet: ${removeResult.error}`
+			);
+		}
+		console.log('');
+	}
+
+	// ============================================================================
+	// Solana Wallet Management
+	// ============================================================================
+
+	console.log('📝 Solana Wallet Management\n');
+
+	// 5. List current Solana wallets
+	console.log('5️⃣ Listing current Solana wallets...');
+	const currentSolanaWallets = await domain.getSolanaWallets();
+	console.log(`   Found ${currentSolanaWallets.length} Solana wallet(s):`);
+	currentSolanaWallets.forEach((addr, i) => {
+		console.log(`   ${i + 1}. ${addr}`);
+	});
+	console.log('');
+
+	// 6. Add a new Solana wallet (optional - only if you have a Solana private key)
+	if (process.env.SOLANA_WALLET_PRIVATE_KEY) {
+		console.log('6️⃣ Adding a new Solana wallet...');
+		const addResult = await domain.addSolanaWallet(
+			process.env.SOLANA_WALLET_PRIVATE_KEY
+		);
+
+		if (addResult.success) {
+			console.log(
+				`   ✅ Successfully added Solana wallet: ${addResult.data?.address}`
+			);
+			console.log(`   📝 Transaction hash: ${addResult.transactionHash}`);
+			console.log(`   ⛽ Gas used: ${addResult.gasUsed?.toString()}`);
+
+			// Wait for blockchain to index the transaction
+			await waitForIndexing(5);
+		} else {
+			console.log(
+				`   ❌ Failed to add Solana wallet: ${addResult.error}`
+			);
+		}
+		console.log('');
+
+		// 7. List Solana wallets again to confirm
+		console.log('7️⃣ Listing Solana wallets after addition...');
+		const updatedSolanaWallets = await domain.getSolanaWallets();
+		console.log(
+			`   Found ${updatedSolanaWallets.length} Solana wallet(s):`
+		);
+		updatedSolanaWallets.forEach((addr, i) => {
+			console.log(`   ${i + 1}. ${addr}`);
+		});
+		console.log('');
+	}
+
+	// 8. Remove a Solana wallet (optional)
+	if (process.env.SOLANA_WALLET_TO_REMOVE) {
+		console.log('8️⃣ Removing a Solana wallet...');
+		const removeResult = await domain.removeSolanaWallet(
+			process.env.SOLANA_WALLET_TO_REMOVE
+		);
+
+		if (removeResult.success) {
+			console.log(
+				`   ✅ Successfully removed Solana wallet: ${removeResult.data?.address}`
+			);
+			console.log(
+				`   📝 Transaction hash: ${removeResult.transactionHash}`
+			);
+
+			// Wait for blockchain to index the transaction
+			await waitForIndexing(5);
+		} else {
+			console.log(
+				`   ❌ Failed to remove Solana wallet: ${removeResult.error}`
+			);
+		}
+		console.log('');
+	}
+
+	console.log('✨ Done!\n');
+}
+
+// Run the example
+main().catch((error) => {
+	console.error('❌ Error:', error.message);
+	process.exit(1);
+});

package/package.json

@@ -1,10 +1,19 @@
 {
     "name": "@beclab/olaresid",
-    "version": "0.1.1",
+    "version": "0.1.3",
     "description": "DID Contract SDK with CLI tool",
     "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js",
+            "require": "./dist/index.js",
+            "default": "./dist/index.js"
+        }
+    },
     "bin": {
-        "did-cli": "./dist/cli.js"
+        "did-cli": "dist/cli.js"
     },
     "scripts": {
         "build": "tsc",
@@ -28,23 +37,23 @@
     "author": "",
     "license": "Terminus License",
     "dependencies": {
-        "ethers": "^6.9.1"
+        "@solana/web3.js": "^1.87.6",
+        "@trustwallet/wallet-core": "^3.2.9",
+        "bip39": "^3.1.0",
+        "bs58": "^5.0.0",
+        "ethers": "^6.9.1",
+        "tweetnacl": "^1.0.3",
+        "tweetnacl-util": "^0.15.1",
+        "varint": "^6.0.0"
     },
     "module": "commonjs",
     "devDependencies": {
+        "@types/node": "^20.0.0",
+        "@types/varint": "^6.0.3",
         "ts-node": "^10.9.2",
-        "typescript": "^5.9.3",
-        "@types/node": "^20.0.0"
+        "typescript": "^5.9.3"
     },
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "import": "./dist/index.js",
-            "require": "./dist/index.js"
-        },
-        "./*": [
-            "./*",
-            "./*.d.ts"
-        ]
+    "directories": {
+        "example": "examples"
     }
 }