@gala-chain/launchpad-sdk 0.4.0

package/dist/utils/wallet.d.ts

@@ -0,0 +1,174 @@
+import { Wallet } from 'ethers';
+/**
+ * Generated wallet information
+ */
+export interface GeneratedWallet {
+    /** The private key (0x prefixed) */
+    privateKey: string;
+    /** The Ethereum address (0x prefixed) */
+    address: string;
+    /** The address in Gala backend format (eth|address) */
+    galaAddress: string;
+    /** The mnemonic phrase for backup/recovery */
+    mnemonic: string;
+    /** The ethers Wallet instance */
+    wallet: Wallet;
+}
+/**
+ * Wallet generation and utility functions for the Launchpad SDK
+ *
+ * Provides convenient methods for creating new wallets and converting
+ * between different address formats used by the Gala ecosystem.
+ *
+ * @example
+ * ```typescript
+ * import { WalletUtils } from '@gala-chain/launchpad-sdk';
+ *
+ * // Generate a new wallet
+ * const newWallet = WalletUtils.generateWallet();
+ * console.log('Address:', newWallet.address);
+ * console.log('Gala Address:', newWallet.galaAddress);
+ * console.log('Mnemonic:', newWallet.mnemonic);
+ *
+ * // Convert existing address to Gala format
+ * const galaAddr = WalletUtils.toGalaAddress('0x1234...');
+ * ```
+ */
+export declare class WalletUtils {
+    private static testCounter;
+    /**
+     * Generates a new random Ethereum wallet
+     *
+     * Creates a secure random wallet with mnemonic phrase backup.
+     * The wallet can be used immediately with the LaunchpadSDK.
+     *
+     * @returns GeneratedWallet Complete wallet information
+     *
+     * @example
+     * ```typescript
+     * const wallet = WalletUtils.generateWallet();
+     *
+     * // Use with SDK
+     * const sdk = new LaunchpadSDK({ wallet: wallet.wallet });
+     *
+     * // Access wallet info
+     * console.log('Private Key:', wallet.privateKey);
+     * console.log('Address:', wallet.address);
+     * console.log('Gala Address:', wallet.galaAddress);
+     * console.log('Recovery phrase:', wallet.mnemonic);
+     * ```
+     */
+    static generateWallet(): GeneratedWallet;
+    /**
+     * Creates a wallet from a private key
+     *
+     * @param privateKey The private key (with or without 0x prefix)
+     * @returns GeneratedWallet Wallet information (mnemonic will be empty)
+     *
+     * @example
+     * ```typescript
+     * const wallet = WalletUtils.fromPrivateKey('0x1234...');
+     * const sdk = new LaunchpadSDK({ wallet: wallet.wallet });
+     * ```
+     */
+    static fromPrivateKey(privateKey: string): GeneratedWallet;
+    /**
+     * Creates a wallet from a mnemonic phrase
+     *
+     * @param mnemonic The mnemonic phrase (12 or 24 words)
+     * @param index The derivation index (default: 0)
+     * @returns GeneratedWallet Wallet information
+     *
+     * @example
+     * ```typescript
+     * const wallet = WalletUtils.fromMnemonic('word1 word2 ... word12');
+     * const sdk = new LaunchpadSDK({ wallet: wallet.wallet });
+     * ```
+     */
+    static fromMnemonic(mnemonic: string, index?: number): GeneratedWallet;
+    /**
+     * Converts an Ethereum address to Gala backend format
+     *
+     * @param address Ethereum address (with or without 0x prefix)
+     * @returns Address in eth|{40-hex-chars} format
+     *
+     * @example
+     * ```typescript
+     * const galaAddr = WalletUtils.toGalaAddress('0x1234567890abcdef1234567890abcdef12345678');
+     * // Returns: 'eth|1234567890abcdef1234567890abcdef12345678'
+     * ```
+     */
+    static toGalaAddress(address: string): string;
+    /**
+     * Converts a Gala backend address to Ethereum format
+     *
+     * @param galaAddress Address in eth|{40-hex-chars} format
+     * @returns Ethereum address with 0x prefix
+     *
+     * @example
+     * ```typescript
+     * const ethAddr = WalletUtils.toEthereumAddress('eth|1234567890abcdef1234567890abcdef12345678');
+     * // Returns: '0x1234567890abcdef1234567890abcdef12345678'
+     * ```
+     */
+    static toEthereumAddress(galaAddress: string): string;
+    /**
+     * Validates an Ethereum address format
+     *
+     * @param address Address to validate
+     * @returns True if valid Ethereum address format
+     *
+     * @example
+     * ```typescript
+     * const isValid = WalletUtils.isValidEthereumAddress('0x1234...');
+     * ```
+     */
+    static isValidEthereumAddress(address: string): boolean;
+    /**
+     * Validates a Gala backend address format
+     *
+     * @param address Address to validate
+     * @returns True if valid Gala address format
+     *
+     * @example
+     * ```typescript
+     * const isValid = WalletUtils.isValidGalaAddress('eth|1234...');
+     * ```
+     */
+    static isValidGalaAddress(address: string): boolean;
+    /**
+     * Generates multiple wallets at once
+     *
+     * Useful for testing, batch operations, or multi-user setups.
+     *
+     * @param count Number of wallets to generate (default: 1, max: 100)
+     * @returns Array of generated wallets
+     *
+     * @example
+     * ```typescript
+     * // Generate 5 test wallets
+     * const wallets = WalletUtils.generateMultipleWallets(5);
+     * wallets.forEach((wallet, index) => {
+     *   console.log(`Wallet ${index + 1}: ${wallet.address}`);
+     * });
+     * ```
+     */
+    static generateMultipleWallets(count?: number): GeneratedWallet[];
+    /**
+     * Creates a summary of wallet information for display
+     *
+     * @param wallet Generated wallet to summarize
+     * @param includeSensitive Whether to include private key (default: false)
+     * @returns Formatted wallet summary
+     *
+     * @example
+     * ```typescript
+     * const wallet = WalletUtils.generateWallet();
+     * const summary = WalletUtils.getWalletSummary(wallet);
+     * console.log(summary);
+     * // Outputs formatted wallet information
+     * ```
+     */
+    static getWalletSummary(wallet: GeneratedWallet, includeSensitive?: boolean): string;
+}
+//# sourceMappingURL=wallet.d.ts.map

package/dist/utils/wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../src/utils/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAA0B,MAAM,QAAQ,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,WAAW,CAAK;IAC/B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CAAC,cAAc,IAAI,eAAe;IAsCxC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe;IAa1D;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,eAAe;IAmCzE;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAY7C;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAerD;;;;;;;;;;OAUG;IACH,MAAM,CAAC,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAUvD;;;;;;;;;;OAUG;IACH,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAYnD;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,uBAAuB,CAAC,KAAK,GAAE,MAAU,GAAG,eAAe,EAAE;IAwBpE;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,eAAe,EAAE,gBAAgB,GAAE,OAAe,GAAG,MAAM;CAqB5F"}

package/package.json

@@ -0,0 +1,151 @@
+{
+  "name": "@gala-chain/launchpad-sdk",
+  "version": "0.4.0",
+  "description": "TypeScript SDK for Gala Launchpad Backend API - Production-ready DeFi token launchpad integration with wallet-based authentication, GalaChain trading, and comprehensive user operations. 100% tested (22/22 endpoints working).",
+  "main": "dist/index.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "dist/**/*.d.ts.map",
+    "!dist/**/*.test.*",
+    "!dist/**/tests/**",
+    "!dist/**/fixtures/**",
+    "README.md",
+    "API.md",
+    "EXAMPLES.md",
+    "TESTING.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "npm run clean && npm run build:types && npm run build:bundle",
+    "build:types": "tsc --declaration --emitDeclarationOnly --outDir dist",
+    "build:bundle": "rollup -c rollup.config.mjs",
+    "build:watch": "rollup -c rollup.config.mjs --watch",
+    "clean": "rimraf dist coverage .nyc_output",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "test:ci": "jest --coverage --ci --watchAll=false",
+    "test:unit": "jest --selectProjects unit",
+    "test:integration": "jest --selectProjects integration",
+    "test:live": "tsx examples/trading/test-real-api-comprehensive.ts",
+    "test:live:help": "echo 'Live API Testing requires .env file with: WALLET_PRIVATE_KEY=your_test_wallet_private_key'",
+    "test:all": "npm run test:unit && npm run test:integration",
+    "test:trading": "tsx examples/trading/test-5-buys-5-sells.ts",
+    "test:websocket": "tsx examples/trading/test-websocket-monitoring.ts",
+    "demo": "tsx examples/demo-showcase.ts",
+    "lint": "eslint src --ext .ts,.tsx --fix",
+    "lint:check": "eslint src --ext .ts,.tsx",
+    "typecheck": "tsc --noEmit",
+    "typecheck:watch": "tsc --noEmit --watch",
+    "typecheck:examples": "tsc --project tsconfig.examples.json --noEmit",
+    "format": "prettier --write \"src/**/*.{ts,tsx,json,md}\"",
+    "format:check": "prettier --check \"src/**/*.{ts,tsx,json,md}\"",
+    "prepublishOnly": "npm run validate && npm run build",
+    "validate": "npm run lint:check && npm run typecheck && npm run test:ci",
+    "publish:beta": "npm run prepublishOnly && npm publish --tag beta",
+    "publish:stable": "npm run prepublishOnly && npm publish",
+    "version:patch": "npm version patch",
+    "version:minor": "npm version minor",
+    "version:major": "npm version major",
+    "changeset": "changeset",
+    "changeset:version": "changeset version",
+    "changeset:publish": "changeset publish",
+    "dev": "concurrently \"npm run build:watch\" \"npm run typecheck:watch\"",
+    "docs:clean": "rimraf docs/api docs/api-markdown docs/api-report temp",
+    "docs:prebuild": "npm run build:types",
+    "docs:extract": "api-extractor run --local --verbose",
+    "docs:extract:markdown": "api-documenter markdown -i temp -o docs/api-markdown",
+    "docs:typedoc": "typedoc --options typedoc-html.json",
+    "docs:typedoc:markdown": "typedoc --plugin typedoc-plugin-markdown --out docs/markdown",
+    "docs:ai": "tsx scripts/generate-ai-docs.ts",
+    "docs:agent": "tsx scripts/generate-agent-spec.ts",
+    "docs:validate": "tsx scripts/validate-examples.ts",
+    "docs:generate": "npm run docs:prebuild && npm run docs:extract && npm run docs:typedoc",
+    "docs:all": "npm run docs:clean && npm run docs:generate && npm run docs:extract:markdown && npm run docs:ai && npm run docs:agent",
+    "docs:serve": "http-server docs/api -p 8080",
+    "size": "size-limit",
+    "analyze": "rollup -c rollup.config.mjs --bundleAnalyzerReport"
+  },
+  "keywords": [
+    "gala",
+    "galachain",
+    "launchpad",
+    "defi",
+    "blockchain",
+    "ethereum",
+    "token",
+    "trading",
+    "sdk",
+    "typescript",
+    "api-client",
+    "crypto",
+    "web3",
+    "wallet",
+    "signature-auth",
+    "bonding-curve",
+    "token-creation",
+    "portfolio",
+    "comments"
+  ],
+  "author": {
+    "name": "Gala Launchpad Team",
+    "email": "dev@gala-launchpad.com",
+    "url": "https://gala-launchpad.com"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.com/gala-games/defi/launchpad/sdk.git"
+  },
+  "bugs": {
+    "url": "https://gitlab.com/gala-games/defi/launchpad/sdk/-/issues"
+  },
+  "homepage": "https://gitlab.com/gala-games/defi/launchpad/sdk#readme",
+  "engines": {
+    "node": ">=18.0.0",
+    "npm": ">=10.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "browserslist": [
+    "> 1%",
+    "last 2 versions",
+    "not dead",
+    "not ie 11"
+  ],
+  "dependencies": {
+    "@gala-chain/api": "^1.10.10",
+    "@gala-chain/connect": "^2.4.3",
+    "@types/uuid": "^10.0.0",
+    "axios": "^1.12.2",
+    "bignumber.js": "^9.1.2",
+    "crypto-js": "^4.2.0",
+    "dotenv": "^17.2.2",
+    "ethers": "^6.15.0",
+    "socket.io-client": "^4.8.1",
+    "uuid": "^13.0.0"
+  },
+  "size-limit": [
+    {
+      "path": "./dist/index.js",
+      "limit": "50 kB"
+    },
+    {
+      "path": "./dist/index.esm.js",
+      "limit": "50 kB"
+    }
+  ]
+}