@gala-chain/launchpad-sdk 4.0.15-beta.0 → 4.0.15-beta.1

package/README.md

@@ -2522,6 +2522,55 @@ const randomWallet = createWallet(); // Generate random wallet
 const isValid = validateWalletInput('0x1234...'); // boolean
 ```
 
+### **Key Derivation**
+
+Derive public keys and addresses from private keys without creating a wallet:
+
+```typescript
+import {
+  getPublicKeyFromPrivateKey,
+  getEthereumAddressFromPrivateKey
+} from '@gala-chain/launchpad-sdk';
+
+// Get public key (both compressed and uncompressed formats)
+const { publicKey, compressedPublicKey } = getPublicKeyFromPrivateKey('0x...');
+// publicKey: "0x04..." (132 chars, uncompressed)
+// compressedPublicKey: "0x02..." or "0x03..." (68 chars)
+
+// Get Ethereum address from private key
+const address = getEthereumAddressFromPrivateKey('0x...');
+// "0x8Ba1f109551bD432803012645Ac136ddd64DBA72" (checksum format)
+
+// Convert to GalaChain format manually
+const galaChainAddress = `eth|${address.slice(2).toLowerCase()}`;
+// "eth|8ba1f109551bd432803012645ac136ddd64dba72"
+```
+
+### **GalaChain Address Override**
+
+For non-standard GalaChain addresses (like `client|ops-admin`), use the `galaChainAddress` config option:
+
+```typescript
+import { LaunchpadSDK } from '@gala-chain/launchpad-sdk';
+
+// Standard: address derived from wallet
+const sdk = new LaunchpadSDK({ wallet });
+sdk.getAddress(); // "eth|a1b2c3d4..."
+
+// Override: use custom GalaChain address
+const adminSdk = new LaunchpadSDK({
+  wallet,
+  galaChainAddress: 'client|ops-admin'
+});
+adminSdk.getAddress(); // "client|ops-admin"
+```
+
+Or via environment variable for MCP/Agent setups:
+```bash
+export WALLET_PRIVATE_KEY=0x...
+export WALLET_ADDRESS=client|ops-admin  # Override
+```
+
 ### **SDK Factory Functions**
 ```typescript
 import { createLaunchpadSDK, createTestLaunchpadSDK } from '@gala-chain/launchpad-sdk';