@gala-chain/launchpad-sdk 8.0.2 → 9.0.0-rc.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +362 -0
- package/EXAMPLES.md +95 -681
- package/MIGRATING-TO-9.0.md +301 -0
- package/README.md +46 -17
- package/dist/LaunchpadSDK.d.ts +150 -419
- package/dist/LaunchpadSDK.d.ts.map +1 -1
- package/dist/api/LaunchpadAPI.d.ts +37 -43
- package/dist/api/LaunchpadAPI.d.ts.map +1 -1
- package/dist/auth/SessionAuthService.d.ts.map +1 -1
- package/dist/auth/SignatureAuth.d.ts +2 -2
- package/dist/auth/SignatureAuth.d.ts.map +1 -1
- package/dist/auth/types.d.ts +1 -1
- package/dist/auth/types.d.ts.map +1 -1
- package/dist/config/environments.d.ts +7 -2
- package/dist/config/environments.d.ts.map +1 -1
- package/dist/constants/decimals.d.ts +0 -23
- package/dist/constants/decimals.d.ts.map +1 -1
- package/dist/constants/endpoints.d.ts +0 -7
- package/dist/constants/endpoints.d.ts.map +1 -1
- package/dist/constants/version.generated.d.ts +1 -1
- package/dist/constants/version.generated.d.ts.map +1 -1
- package/dist/helpers/sdk.d.ts.map +1 -1
- package/dist/index.browser.d.ts +11 -23
- package/dist/index.browser.d.ts.map +1 -1
- package/dist/index.browser.esm.js +1 -1
- package/dist/index.cjs +1 -1
- package/dist/index.esm.js +1 -1
- package/dist/index.js +1 -1
- package/dist/index.node.d.ts +4 -5
- package/dist/index.node.d.ts.map +1 -1
- package/dist/launchpad/bundle-submission.d.ts +1 -9
- package/dist/launchpad/bundle-submission.d.ts.map +1 -1
- package/dist/launchpad/sell-fee-ceiling.d.ts +66 -0
- package/dist/launchpad/sell-fee-ceiling.d.ts.map +1 -0
- package/dist/launchpad/transport.d.ts +2 -1
- package/dist/launchpad/transport.d.ts.map +1 -1
- package/dist/launchpad/writes.d.ts +30 -2
- package/dist/launchpad/writes.d.ts.map +1 -1
- package/dist/native.cjs +1 -1
- package/dist/native.d.ts +3 -4
- package/dist/native.d.ts.map +1 -1
- package/dist/native.esm.js +1 -1
- package/dist/schemas/launchpad.d.ts +4 -4
- package/dist/schemas/launchpad.d.ts.map +1 -1
- package/dist/schemas/user.d.ts +0 -15
- package/dist/schemas/user.d.ts.map +1 -1
- package/dist/services/AbstractCacheService.d.ts +2 -2
- package/dist/services/BundleService.d.ts +9 -1
- package/dist/services/BundleService.d.ts.map +1 -1
- package/dist/services/GalaChainBalanceService.d.ts +17 -89
- package/dist/services/GalaChainBalanceService.d.ts.map +1 -1
- package/dist/services/GalaChainLockService.d.ts +19 -20
- package/dist/services/GalaChainLockService.d.ts.map +1 -1
- package/dist/services/GalaChainService.d.ts +28 -64
- package/dist/services/GalaChainService.d.ts.map +1 -1
- package/dist/services/GalaChainTokenService.d.ts +25 -53
- package/dist/services/GalaChainTokenService.d.ts.map +1 -1
- package/dist/services/GalaChainTransferService.d.ts +42 -41
- package/dist/services/GalaChainTransferService.d.ts.map +1 -1
- package/dist/services/LaunchpadPriceService.d.ts +66 -0
- package/dist/services/LaunchpadPriceService.d.ts.map +1 -0
- package/dist/services/NftCollectionService.d.ts +22 -6
- package/dist/services/NftCollectionService.d.ts.map +1 -1
- package/dist/services/TokenResolverService.d.ts +5 -5
- package/dist/services/TokenResolverService.d.ts.map +1 -1
- package/dist/services/TradingQuotesService.d.ts +3 -5
- package/dist/services/TradingQuotesService.d.ts.map +1 -1
- package/dist/services/gateway-transport.d.ts +32 -0
- package/dist/services/gateway-transport.d.ts.map +1 -0
- package/dist/services/gateway-writes.d.ts +83 -0
- package/dist/services/gateway-writes.d.ts.map +1 -0
- package/dist/signing/index.d.ts +2 -3
- package/dist/signing/index.d.ts.map +1 -1
- package/dist/signing/signers.d.ts +23 -11
- package/dist/signing/signers.d.ts.map +1 -1
- package/dist/signing/types.d.ts +7 -10
- package/dist/signing/types.d.ts.map +1 -1
- package/dist/types/burn.dto.d.ts +4 -2
- package/dist/types/burn.dto.d.ts.map +1 -1
- package/dist/types/common.d.ts +2 -23
- package/dist/types/common.d.ts.map +1 -1
- package/dist/types/dto.d.ts +0 -5
- package/dist/types/dto.d.ts.map +1 -1
- package/dist/types/launchpad.dto.d.ts +0 -269
- package/dist/types/launchpad.dto.d.ts.map +1 -1
- package/dist/types/lock.dto.d.ts +12 -7
- package/dist/types/lock.dto.d.ts.map +1 -1
- package/dist/types/options.dto.d.ts +8 -34
- package/dist/types/options.dto.d.ts.map +1 -1
- package/dist/types/session-auth.dto.d.ts +2 -4
- package/dist/types/session-auth.dto.d.ts.map +1 -1
- package/dist/types/user.dto.d.ts +7 -62
- package/dist/types/user.dto.d.ts.map +1 -1
- package/dist/utils/address-formatter.d.ts +10 -2
- package/dist/utils/address-formatter.d.ts.map +1 -1
- package/dist/utils/agent-config.d.ts +9 -4
- package/dist/utils/agent-config.d.ts.map +1 -1
- package/dist/utils/auto-pagination.d.ts +6 -239
- package/dist/utils/auto-pagination.d.ts.map +1 -1
- package/dist/utils/bignumber-helpers.d.ts +3 -2
- package/dist/utils/bignumber-helpers.d.ts.map +1 -1
- package/dist/utils/delimiter-parser.d.ts +0 -13
- package/dist/utils/delimiter-parser.d.ts.map +1 -1
- package/dist/utils/error-patterns.d.ts +0 -47
- package/dist/utils/error-patterns.d.ts.map +1 -1
- package/dist/utils/error-wrapper.d.ts +5 -5
- package/dist/utils/errors.d.ts +0 -308
- package/dist/utils/errors.d.ts.map +1 -1
- package/dist/utils/http.d.ts +15 -3
- package/dist/utils/http.d.ts.map +1 -1
- package/dist/utils/token-format-converter.d.ts +1 -1
- package/dist/utils/token-parser.d.ts +6 -127
- package/dist/utils/token-parser.d.ts.map +1 -1
- package/dist/utils/token-stringification.d.ts +7 -7
- package/dist/utils/token-stringification.d.ts.map +1 -1
- package/dist/utils/tokenNameNormalizer.d.ts +2 -2
- package/dist/utils/tokenNormalizer.d.ts +5 -29
- package/dist/utils/tokenNormalizer.d.ts.map +1 -1
- package/dist/utils/trade-quote.d.ts +32 -0
- package/dist/utils/trade-quote.d.ts.map +1 -0
- package/dist/utils/unique-key-generator.d.ts +7 -134
- package/dist/utils/unique-key-generator.d.ts.map +1 -1
- package/dist/utils/validation-helpers.d.ts +3 -5
- package/dist/utils/validation-helpers.d.ts.map +1 -1
- package/package.json +47 -87
- package/dist/api/dto/BurnTokensDto.d.ts +0 -77
- package/dist/api/dto/BurnTokensDto.d.ts.map +0 -1
- package/dist/api/dto/LockTokenDto.d.ts +0 -85
- package/dist/api/dto/LockTokenDto.d.ts.map +0 -1
- package/dist/api/dto/TransferTokenDto.d.ts +0 -64
- package/dist/api/dto/TransferTokenDto.d.ts.map +0 -1
- package/dist/api/dto/UnlockTokenDto.d.ts +0 -74
- package/dist/api/dto/UnlockTokenDto.d.ts.map +0 -1
- package/dist/bridge/BridgeService.d.ts +0 -484
- package/dist/bridge/BridgeService.d.ts.map +0 -1
- package/dist/bridge/GalaConnectClient.d.ts +0 -170
- package/dist/bridge/GalaConnectClient.d.ts.map +0 -1
- package/dist/bridge/constants/index.d.ts +0 -7
- package/dist/bridge/constants/index.d.ts.map +0 -1
- package/dist/bridge/constants/tokens.d.ts +0 -212
- package/dist/bridge/constants/tokens.d.ts.map +0 -1
- package/dist/bridge/index.d.ts +0 -24
- package/dist/bridge/index.d.ts.map +0 -1
- package/dist/bridge/public-types.d.ts +0 -2
- package/dist/bridge/public-types.d.ts.map +0 -1
- package/dist/bridge/strategies/BridgeStrategy.d.ts +0 -204
- package/dist/bridge/strategies/BridgeStrategy.d.ts.map +0 -1
- package/dist/bridge/strategies/EthereumBridgeStrategy.d.ts +0 -178
- package/dist/bridge/strategies/EthereumBridgeStrategy.d.ts.map +0 -1
- package/dist/bridge/strategies/SolanaBridgeStrategy.d.ts +0 -236
- package/dist/bridge/strategies/SolanaBridgeStrategy.d.ts.map +0 -1
- package/dist/bridge/types/bridge.dto.d.ts +0 -772
- package/dist/bridge/types/bridge.dto.d.ts.map +0 -1
- package/dist/bridge/types/bridgeable-token.dto.d.ts +0 -209
- package/dist/bridge/types/bridgeable-token.dto.d.ts.map +0 -1
- package/dist/bridge/types/eip712.d.ts +0 -66
- package/dist/bridge/types/eip712.d.ts.map +0 -1
- package/dist/bridge/types/index.d.ts +0 -8
- package/dist/bridge/types/index.d.ts.map +0 -1
- package/dist/bridge/utils/RateLimiter.d.ts +0 -34
- package/dist/bridge/utils/RateLimiter.d.ts.map +0 -1
- package/dist/bridge/utils/address-formatter.d.ts +0 -25
- package/dist/bridge/utils/address-formatter.d.ts.map +0 -1
- package/dist/bridge/utils/addressValidation.d.ts +0 -200
- package/dist/bridge/utils/addressValidation.d.ts.map +0 -1
- package/dist/bridge/utils/balanceHelpers.d.ts +0 -215
- package/dist/bridge/utils/balanceHelpers.d.ts.map +0 -1
- package/dist/bridge/utils/bridgeErrors.d.ts +0 -98
- package/dist/bridge/utils/bridgeErrors.d.ts.map +0 -1
- package/dist/bridge/utils/bridgeOutHelpers.d.ts +0 -68
- package/dist/bridge/utils/bridgeOutHelpers.d.ts.map +0 -1
- package/dist/bridge/utils/bridgePayload.d.ts +0 -98
- package/dist/bridge/utils/bridgePayload.d.ts.map +0 -1
- package/dist/bridge/utils/bridgeStatusParser.d.ts +0 -76
- package/dist/bridge/utils/bridgeStatusParser.d.ts.map +0 -1
- package/dist/bridge/utils/eip712Helpers.d.ts +0 -66
- package/dist/bridge/utils/eip712Helpers.d.ts.map +0 -1
- package/dist/bridge/utils/index.d.ts +0 -19
- package/dist/bridge/utils/index.d.ts.map +0 -1
- package/dist/bridge/utils/retry.d.ts +0 -112
- package/dist/bridge/utils/retry.d.ts.map +0 -1
- package/dist/bridge/utils/strategyDelegation.d.ts +0 -126
- package/dist/bridge/utils/strategyDelegation.d.ts.map +0 -1
- package/dist/bridge/utils/tokenIdUtils.d.ts +0 -86
- package/dist/bridge/utils/tokenIdUtils.d.ts.map +0 -1
- package/dist/bridge/utils/tokenMath.d.ts +0 -39
- package/dist/bridge/utils/tokenMath.d.ts.map +0 -1
- package/dist/bridge/utils/tokenMetadataResolver.d.ts +0 -97
- package/dist/bridge/utils/tokenMetadataResolver.d.ts.map +0 -1
- package/dist/helpers/wallet.d.ts +0 -151
- package/dist/helpers/wallet.d.ts.map +0 -1
- package/dist/react/WalletContext.d.ts +0 -60
- package/dist/react/WalletContext.d.ts.map +0 -1
- package/dist/react/index.d.ts +0 -65
- package/dist/react/index.d.ts.map +0 -1
- package/dist/react/types.d.ts +0 -76
- package/dist/react/types.d.ts.map +0 -1
- package/dist/react/useWallet.d.ts +0 -123
- package/dist/react/useWallet.d.ts.map +0 -1
- package/dist/react/useWalletConnection.d.ts +0 -89
- package/dist/react/useWalletConnection.d.ts.map +0 -1
- package/dist/react/useWalletDetection.d.ts +0 -81
- package/dist/react/useWalletDetection.d.ts.map +0 -1
- package/dist/react.cjs +0 -1
- package/dist/react.esm.js +0 -1
- package/dist/services/AbstractTokenFetchService.d.ts +0 -150
- package/dist/services/AbstractTokenFetchService.d.ts.map +0 -1
- package/dist/services/BatchedCacheService.d.ts +0 -133
- package/dist/services/BatchedCacheService.d.ts.map +0 -1
- package/dist/services/BridgeableTokenCache.d.ts +0 -120
- package/dist/services/BridgeableTokenCache.d.ts.map +0 -1
- package/dist/services/BridgeableTokenService.d.ts +0 -218
- package/dist/services/BridgeableTokenService.d.ts.map +0 -1
- package/dist/services/DexService.d.ts +0 -440
- package/dist/services/DexService.d.ts.map +0 -1
- package/dist/services/NetworkKeyedCacheService.d.ts +0 -185
- package/dist/services/NetworkKeyedCacheService.d.ts.map +0 -1
- package/dist/services/PriceHistoryService.d.ts +0 -209
- package/dist/services/PriceHistoryService.d.ts.map +0 -1
- package/dist/services/WrapService.d.ts +0 -171
- package/dist/services/WrapService.d.ts.map +0 -1
- package/dist/services/WrappableTokenCache.d.ts +0 -100
- package/dist/services/WrappableTokenCache.d.ts.map +0 -1
- package/dist/services/WrappableTokenService.d.ts +0 -130
- package/dist/services/WrappableTokenService.d.ts.map +0 -1
- package/dist/setup.d.ts +0 -8
- package/dist/setup.d.ts.map +0 -1
- package/dist/signing/eip712.d.ts +0 -13
- package/dist/signing/eip712.d.ts.map +0 -1
- package/dist/tokens/transfers.d.ts +0 -95
- package/dist/tokens/transfers.d.ts.map +0 -1
- package/dist/types/galachain-api.types.d.ts +0 -297
- package/dist/types/galachain-api.types.d.ts.map +0 -1
- package/dist/types/priceHistory.dto.d.ts +0 -134
- package/dist/types/priceHistory.dto.d.ts.map +0 -1
- package/dist/types/token.types.d.ts +0 -359
- package/dist/types/token.types.d.ts.map +0 -1
- package/dist/types/wrappable-token.dto.d.ts +0 -305
- package/dist/types/wrappable-token.dto.d.ts.map +0 -1
- package/dist/utils/crypto-compat.d.ts +0 -40
- package/dist/utils/crypto-compat.d.ts.map +0 -1
- package/dist/utils/load-env.d.ts +0 -31
- package/dist/utils/load-env.d.ts.map +0 -1
- package/dist/utils/token-instance-key.d.ts +0 -57
- package/dist/utils/token-instance-key.d.ts.map +0 -1
- package/dist/utils/wallet.d.ts +0 -166
- package/dist/utils/wallet.d.ts.map +0 -1
- package/dist/wallet/ExternalWalletProvider.d.ts +0 -90
- package/dist/wallet/ExternalWalletProvider.d.ts.map +0 -1
- package/dist/wallet/GalaWalletProvider.d.ts +0 -122
- package/dist/wallet/GalaWalletProvider.d.ts.map +0 -1
- package/dist/wallet/PrivateKeyProvider.d.ts +0 -90
- package/dist/wallet/PrivateKeyProvider.d.ts.map +0 -1
- package/dist/wallet/detection.d.ts +0 -107
- package/dist/wallet/detection.d.ts.map +0 -1
- package/dist/wallet/event-handlers.d.ts +0 -50
- package/dist/wallet/event-handlers.d.ts.map +0 -1
- package/dist/wallet/index.d.ts +0 -51
- package/dist/wallet/index.d.ts.map +0 -1
- package/dist/wallet/signing-operation.d.ts +0 -19
- package/dist/wallet/signing-operation.d.ts.map +0 -1
- package/dist/wallet/typed-data-helpers.d.ts +0 -68
- package/dist/wallet/typed-data-helpers.d.ts.map +0 -1
- package/dist/wallet/types.d.ts +0 -267
- package/dist/wallet/types.d.ts.map +0 -1
- package/dist/wallet/utils.d.ts +0 -117
- package/dist/wallet/utils.d.ts.map +0 -1
- package/dist/wallet.cjs +0 -1
- package/dist/wallet.esm.js +0 -1
|
@@ -1,40 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Crypto Compatibility Layer
|
|
3
|
-
*
|
|
4
|
-
* Provides browser-safe wrappers for Node.js crypto functions.
|
|
5
|
-
* In Node.js: uses native crypto module
|
|
6
|
-
* In Browser: uses fallback implementations (does NOT include crypto in bundle)
|
|
7
|
-
*
|
|
8
|
-
* Note: Crypto operations are tree-shaken in browser builds since
|
|
9
|
-
* they're only used by Node.js-specific services (PoolStateManager, WrapService).
|
|
10
|
-
*
|
|
11
|
-
* @category Utilities
|
|
12
|
-
* @since 3.6.3
|
|
13
|
-
*/
|
|
14
|
-
/**
|
|
15
|
-
* Generate a UUID v4 string
|
|
16
|
-
* Works in both Node.js (via crypto.randomUUID) and browser (via fallback)
|
|
17
|
-
*
|
|
18
|
-
* @returns UUID v4 string (36 characters)
|
|
19
|
-
* @example
|
|
20
|
-
* ```typescript
|
|
21
|
-
* const id = generateRandomUUID();
|
|
22
|
-
* // Returns: "550e8400-e29b-41d4-a716-446655440000"
|
|
23
|
-
* ```
|
|
24
|
-
*/
|
|
25
|
-
export declare function generateRandomUUID(): string;
|
|
26
|
-
/**
|
|
27
|
-
* Create a SHA-256 hash and return first 16 characters as hex string
|
|
28
|
-
* In Node.js: uses crypto.createHash for performance
|
|
29
|
-
* In Browser: uses simple fallback (service tree-shaken in browser anyway)
|
|
30
|
-
*
|
|
31
|
-
* @param data - Data to hash
|
|
32
|
-
* @returns First 16 characters of SHA-256 hash as hex string
|
|
33
|
-
* @example
|
|
34
|
-
* ```typescript
|
|
35
|
-
* const hash = createHashString('pool-state-123');
|
|
36
|
-
* // Returns: "a1b2c3d4e5f67890" (16-char hex string)
|
|
37
|
-
* ```
|
|
38
|
-
*/
|
|
39
|
-
export declare function createHashString(data: string): string;
|
|
40
|
-
//# sourceMappingURL=crypto-compat.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"crypto-compat.d.ts","sourceRoot":"","sources":["../../src/utils/crypto-compat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAqBH;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAqB3C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAerD"}
|
package/dist/utils/load-env.d.ts
DELETED
|
@@ -1,31 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Environment variable loader that checks both root and local .env files
|
|
3
|
-
* Useful for demo scripts and CLI tools that need wallet configuration
|
|
4
|
-
*/
|
|
5
|
-
/**
|
|
6
|
-
* Load environment variables from root .env and local .env files
|
|
7
|
-
* Root .env is loaded first, then local .env (local overrides root)
|
|
8
|
-
*
|
|
9
|
-
* Usage in demo scripts:
|
|
10
|
-
* ```typescript
|
|
11
|
-
* import { loadEnvWithFallback } from '../src/utils/load-env';
|
|
12
|
-
*
|
|
13
|
-
* loadEnvWithFallback();
|
|
14
|
-
*
|
|
15
|
-
* const privateKey = process.env.WALLET_PRIVATE_KEY;
|
|
16
|
-
* if (!privateKey) {
|
|
17
|
-
* throw new Error('WALLET_PRIVATE_KEY not set in root or local .env');
|
|
18
|
-
* }
|
|
19
|
-
* ```
|
|
20
|
-
*/
|
|
21
|
-
export declare function loadEnvWithFallback(): void;
|
|
22
|
-
/**
|
|
23
|
-
* Get a specific environment variable with detailed error message
|
|
24
|
-
* Checks both root and local .env files
|
|
25
|
-
*/
|
|
26
|
-
export declare function getEnvOrThrow(varName: string, context?: string): string;
|
|
27
|
-
/**
|
|
28
|
-
* Get environment variable with optional default
|
|
29
|
-
*/
|
|
30
|
-
export declare function getEnv(varName: string, defaultValue?: string): string | undefined;
|
|
31
|
-
//# sourceMappingURL=load-env.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"load-env.d.ts","sourceRoot":"","sources":["../../src/utils/load-env.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAY1C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAWvE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEjF"}
|
|
@@ -1,57 +0,0 @@
|
|
|
1
|
-
import type { TokenClassKey } from '@gala-chain/api';
|
|
2
|
-
/**
|
|
3
|
-
* The fungible token instance shape used by token operation DTOs.
|
|
4
|
-
*/
|
|
5
|
-
export interface FungibleTokenInstanceKey {
|
|
6
|
-
collection: string;
|
|
7
|
-
category: string;
|
|
8
|
-
type: string;
|
|
9
|
-
additionalKey: string;
|
|
10
|
-
instance: string;
|
|
11
|
-
}
|
|
12
|
-
/**
|
|
13
|
-
* Convert a token class key to the fungible token instance form.
|
|
14
|
-
*
|
|
15
|
-
* @param tokenClassKey - A token class key object or dollar-delimited string.
|
|
16
|
-
* @returns A token instance key with instance `0`.
|
|
17
|
-
*
|
|
18
|
-
* @example
|
|
19
|
-
* ```typescript
|
|
20
|
-
* const key = toFungibleTokenInstanceKey('GALA$Unit$none$none');
|
|
21
|
-
* console.log(key.instance); // '0'
|
|
22
|
-
* ```
|
|
23
|
-
*/
|
|
24
|
-
export declare function toFungibleTokenInstanceKey(tokenClassKey: TokenClassKey | string): FungibleTokenInstanceKey;
|
|
25
|
-
/**
|
|
26
|
-
* Return the canonical dollar-delimited class key for a token instance.
|
|
27
|
-
*
|
|
28
|
-
* @param tokenInstanceKey - A token instance key.
|
|
29
|
-
* @returns The canonical token class key string.
|
|
30
|
-
*
|
|
31
|
-
* @example
|
|
32
|
-
* ```typescript
|
|
33
|
-
* const key = getFungibleTokenClassKey({
|
|
34
|
-
* collection: 'GALA', category: 'Unit', type: 'none', additionalKey: 'none', instance: '0'
|
|
35
|
-
* });
|
|
36
|
-
* console.log(key); // 'GALA$Unit$none$none'
|
|
37
|
-
* ```
|
|
38
|
-
*/
|
|
39
|
-
export declare function getFungibleTokenClassKey(tokenInstanceKey: FungibleTokenInstanceKey): string;
|
|
40
|
-
/**
|
|
41
|
-
* Get the class key for the first token instance in a lock or unlock DTO.
|
|
42
|
-
*
|
|
43
|
-
* @param tokenInstances - Token instances held by the DTO.
|
|
44
|
-
* @returns The first token class key, or `undefined` when there are no instances.
|
|
45
|
-
*
|
|
46
|
-
* @example
|
|
47
|
-
* ```typescript
|
|
48
|
-
* const key = getSingleFungibleTokenClassKey([{ tokenInstanceKey: {
|
|
49
|
-
* collection: 'GALA', category: 'Unit', type: 'none', additionalKey: 'none', instance: '0'
|
|
50
|
-
* } }]);
|
|
51
|
-
* console.log(key); // "GALA$Unit$none$none"
|
|
52
|
-
* ```
|
|
53
|
-
*/
|
|
54
|
-
export declare function getSingleFungibleTokenClassKey(tokenInstances: ReadonlyArray<{
|
|
55
|
-
tokenInstanceKey: FungibleTokenInstanceKey;
|
|
56
|
-
}>): string | undefined;
|
|
57
|
-
//# sourceMappingURL=token-instance-key.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"token-instance-key.d.ts","sourceRoot":"","sources":["../../src/utils/token-instance-key.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAKrD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,aAAa,GAAG,MAAM,GACpC,wBAAwB,CAY1B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CACtC,gBAAgB,EAAE,wBAAwB,GACzC,MAAM,CAER;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,8BAA8B,CAC5C,cAAc,EAAE,aAAa,CAAC;IAAE,gBAAgB,EAAE,wBAAwB,CAAA;CAAE,CAAC,GAC5E,MAAM,GAAG,SAAS,CAGpB"}
|
package/dist/utils/wallet.d.ts
DELETED
|
@@ -1,166 +0,0 @@
|
|
|
1
|
-
import { Wallet } from 'ethers';
|
|
2
|
-
/**
|
|
3
|
-
* Generated wallet information
|
|
4
|
-
*/
|
|
5
|
-
export interface GeneratedWallet {
|
|
6
|
-
/** The private key (0x prefixed) */
|
|
7
|
-
privateKey: string;
|
|
8
|
-
/** The Ethereum address (0x prefixed) */
|
|
9
|
-
address: string;
|
|
10
|
-
/** The address in Gala backend format (eth|address) */
|
|
11
|
-
galaAddress: string;
|
|
12
|
-
/** The mnemonic phrase for backup/recovery */
|
|
13
|
-
mnemonic: string;
|
|
14
|
-
/** The ethers Wallet instance */
|
|
15
|
-
wallet: Wallet;
|
|
16
|
-
}
|
|
17
|
-
export declare class WalletUtils {
|
|
18
|
-
private readonly utilityInstance;
|
|
19
|
-
constructor();
|
|
20
|
-
/**
|
|
21
|
-
* Generates a new random Ethereum wallet
|
|
22
|
-
*
|
|
23
|
-
* Creates a secure random wallet with mnemonic phrase backup.
|
|
24
|
-
* The wallet can be used immediately with the LaunchpadSDK.
|
|
25
|
-
*
|
|
26
|
-
* @returns GeneratedWallet Complete wallet information
|
|
27
|
-
*
|
|
28
|
-
* @example
|
|
29
|
-
* ```typescript
|
|
30
|
-
* const wallet = WalletUtils.generateWallet();
|
|
31
|
-
*
|
|
32
|
-
* // Use with SDK
|
|
33
|
-
* const sdk = new LaunchpadSDK({ wallet: wallet.wallet });
|
|
34
|
-
*
|
|
35
|
-
* // Access wallet info
|
|
36
|
-
* console.log('Private Key:', wallet.privateKey);
|
|
37
|
-
* console.log('Address:', wallet.address);
|
|
38
|
-
* console.log('Gala Address:', wallet.galaAddress);
|
|
39
|
-
* console.log('Recovery phrase:', wallet.mnemonic);
|
|
40
|
-
* ```
|
|
41
|
-
*/
|
|
42
|
-
static generateWallet(): GeneratedWallet;
|
|
43
|
-
/**
|
|
44
|
-
* Creates a wallet from a private key
|
|
45
|
-
*
|
|
46
|
-
* @param privateKey The private key (with or without 0x prefix)
|
|
47
|
-
* @returns GeneratedWallet Wallet information (mnemonic will be empty)
|
|
48
|
-
*
|
|
49
|
-
* @example
|
|
50
|
-
* ```typescript
|
|
51
|
-
* const wallet = WalletUtils.fromPrivateKey('0x1234...');
|
|
52
|
-
* const sdk = new LaunchpadSDK({ wallet: wallet.wallet });
|
|
53
|
-
* ```
|
|
54
|
-
*/
|
|
55
|
-
static fromPrivateKey(privateKey: string): GeneratedWallet;
|
|
56
|
-
/**
|
|
57
|
-
* Creates a wallet from a mnemonic phrase
|
|
58
|
-
*
|
|
59
|
-
* @param mnemonic The mnemonic phrase (12 or 24 words)
|
|
60
|
-
* @param index The derivation index (default: 0)
|
|
61
|
-
* @returns GeneratedWallet Wallet information
|
|
62
|
-
*
|
|
63
|
-
* @example
|
|
64
|
-
* ```typescript
|
|
65
|
-
* const wallet = WalletUtils.fromMnemonic('word1 word2 ... word12');
|
|
66
|
-
* const sdk = new LaunchpadSDK({ wallet: wallet.wallet });
|
|
67
|
-
* ```
|
|
68
|
-
*/
|
|
69
|
-
static fromMnemonic(mnemonic: string, index?: number): GeneratedWallet;
|
|
70
|
-
/**
|
|
71
|
-
* Converts an Ethereum address to Gala backend format
|
|
72
|
-
*
|
|
73
|
-
* NOTE: This method preserves address case (for checksum compatibility).
|
|
74
|
-
* For general address formatting with lowercase normalization,
|
|
75
|
-
* use `toBackendAddressFormat` from './address-formatter' instead.
|
|
76
|
-
*
|
|
77
|
-
* @param address Ethereum address (with or without 0x prefix)
|
|
78
|
-
* @returns Address in eth|{40-hex-chars} format (preserves original case)
|
|
79
|
-
*
|
|
80
|
-
* @example
|
|
81
|
-
* ```typescript
|
|
82
|
-
* const galaAddr = WalletUtils.toGalaAddress('0x1234567890abcdef1234567890abcdef12345678');
|
|
83
|
-
* // Returns: 'eth|1234567890abcdef1234567890abcdef12345678'
|
|
84
|
-
* ```
|
|
85
|
-
*
|
|
86
|
-
* @see toBackendAddressFormat from './address-formatter' for lowercase normalization
|
|
87
|
-
*/
|
|
88
|
-
static toGalaAddress(address: string): string;
|
|
89
|
-
/**
|
|
90
|
-
* Converts a Gala backend address to Ethereum format
|
|
91
|
-
*
|
|
92
|
-
* NOTE: For general address formatting,
|
|
93
|
-
* use `fromBackendAddressFormat` from './address-formatter' instead.
|
|
94
|
-
*
|
|
95
|
-
* @param galaAddress Address in eth|{40-hex-chars} format
|
|
96
|
-
* @returns Ethereum address with 0x prefix
|
|
97
|
-
*
|
|
98
|
-
* @example
|
|
99
|
-
* ```typescript
|
|
100
|
-
* const ethAddr = WalletUtils.toEthereumAddress('eth|1234567890abcdef1234567890abcdef12345678');
|
|
101
|
-
* // Returns: '0x1234567890abcdef1234567890abcdef12345678'
|
|
102
|
-
* ```
|
|
103
|
-
*
|
|
104
|
-
* @see fromBackendAddressFormat from './address-formatter' for canonical implementation
|
|
105
|
-
*/
|
|
106
|
-
static toEthereumAddress(galaAddress: string): string;
|
|
107
|
-
/**
|
|
108
|
-
* Validates an Ethereum address format
|
|
109
|
-
*
|
|
110
|
-
* @param address Address to validate
|
|
111
|
-
* @returns True if valid Ethereum address format
|
|
112
|
-
*
|
|
113
|
-
* @example
|
|
114
|
-
* ```typescript
|
|
115
|
-
* const isValid = WalletUtils.isValidEthereumAddress('0x1234...');
|
|
116
|
-
* ```
|
|
117
|
-
*/
|
|
118
|
-
static isValidEthereumAddress(address: string): boolean;
|
|
119
|
-
/**
|
|
120
|
-
* Validates a Gala backend address format
|
|
121
|
-
*
|
|
122
|
-
* @param address Address to validate
|
|
123
|
-
* @returns True if valid Gala address format
|
|
124
|
-
*
|
|
125
|
-
* @example
|
|
126
|
-
* ```typescript
|
|
127
|
-
* const isValid = WalletUtils.isValidGalaAddress('eth|1234...');
|
|
128
|
-
* ```
|
|
129
|
-
*/
|
|
130
|
-
static isValidGalaAddress(address: string): boolean;
|
|
131
|
-
/**
|
|
132
|
-
* Generates multiple wallets at once
|
|
133
|
-
*
|
|
134
|
-
* Useful for testing, batch operations, or multi-user setups.
|
|
135
|
-
*
|
|
136
|
-
* @param count Number of wallets to generate (default: 1, max: 100)
|
|
137
|
-
* @returns Array of generated wallets
|
|
138
|
-
*
|
|
139
|
-
* @example
|
|
140
|
-
* ```typescript
|
|
141
|
-
* // Generate 5 test wallets
|
|
142
|
-
* const wallets = WalletUtils.generateMultipleWallets(5);
|
|
143
|
-
* wallets.forEach((wallet, index) => {
|
|
144
|
-
* console.log(`Wallet ${index + 1}: ${wallet.address}`);
|
|
145
|
-
* });
|
|
146
|
-
* ```
|
|
147
|
-
*/
|
|
148
|
-
static generateMultipleWallets(count?: number): GeneratedWallet[];
|
|
149
|
-
/**
|
|
150
|
-
* Creates a summary of wallet information for display
|
|
151
|
-
*
|
|
152
|
-
* @param wallet Generated wallet to summarize
|
|
153
|
-
* @param includeSensitive Whether to include private key (default: false)
|
|
154
|
-
* @returns Formatted wallet summary
|
|
155
|
-
*
|
|
156
|
-
* @example
|
|
157
|
-
* ```typescript
|
|
158
|
-
* const wallet = WalletUtils.generateWallet();
|
|
159
|
-
* const summary = WalletUtils.getWalletSummary(wallet);
|
|
160
|
-
* console.log(summary);
|
|
161
|
-
* // Outputs formatted wallet information
|
|
162
|
-
* ```
|
|
163
|
-
*/
|
|
164
|
-
static getWalletSummary(wallet: GeneratedWallet, includeSensitive?: boolean): string;
|
|
165
|
-
}
|
|
166
|
-
//# sourceMappingURL=wallet.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../src/utils/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,MAAM,EAAE,MAAM,QAAQ,CAAC;AAcnE;;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;AAwBD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAQ;;IAKxC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CAAC,cAAc,IAAI,eAAe;IAyCxC;;;;;;;;;;;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;IAwCzE;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAiB7C;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAqBrD;;;;;;;;;;OAUG;IACH,MAAM,CAAC,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAUvD;;;;;;;;;;OAUG;IACH,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAKnD;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,uBAAuB,CAAC,KAAK,GAAE,MAAU,GAAG,eAAe,EAAE;IAwBpE;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,gBAAgB,CACrB,MAAM,EAAE,eAAe,EACvB,gBAAgB,GAAE,OAAe,GAChC,MAAM;CA0BV"}
|
|
@@ -1,90 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* External Wallet Provider
|
|
3
|
-
*
|
|
4
|
-
* Wraps an EIP-1193 provider (MetaMask, Coinbase Wallet, etc.) for use
|
|
5
|
-
* with the WalletProvider interface. This provider does NOT have access
|
|
6
|
-
* to the private key - all signing happens through the external wallet.
|
|
7
|
-
*
|
|
8
|
-
* @packageDocumentation
|
|
9
|
-
*/
|
|
10
|
-
import type { Eip1193Provider, TypedDataDomain, TypedDataField, WalletProvider, WalletProviderType } from './types';
|
|
11
|
-
import { WalletEventProviderBase } from './event-handlers';
|
|
12
|
-
/**
|
|
13
|
-
* Wallet provider for EIP-1193 compatible browser wallets
|
|
14
|
-
*
|
|
15
|
-
* This provider wraps browser extension wallets like MetaMask, Coinbase Wallet,
|
|
16
|
-
* Trust Wallet, etc. All signing operations are delegated to the external wallet
|
|
17
|
-
* which means the private key is never exposed to the SDK.
|
|
18
|
-
*
|
|
19
|
-
* @example
|
|
20
|
-
* ```typescript
|
|
21
|
-
* // Using window.ethereum (MetaMask or other injected provider)
|
|
22
|
-
* const provider = new ExternalWalletProvider(window.ethereum);
|
|
23
|
-
*
|
|
24
|
-
* // Connect to request account access
|
|
25
|
-
* const address = await provider.connect();
|
|
26
|
-
*
|
|
27
|
-
* // Sign a message (wallet will show approval UI)
|
|
28
|
-
* const signature = await provider.signMessage('Hello');
|
|
29
|
-
*
|
|
30
|
-
* // Disconnect
|
|
31
|
-
* await provider.disconnect();
|
|
32
|
-
* ```
|
|
33
|
-
*/
|
|
34
|
-
export declare class ExternalWalletProvider extends WalletEventProviderBase<Eip1193Provider> implements WalletProvider {
|
|
35
|
-
readonly providerType: WalletProviderType;
|
|
36
|
-
/**
|
|
37
|
-
* Creates a new ExternalWalletProvider
|
|
38
|
-
*
|
|
39
|
-
* @param provider - An EIP-1193 compatible provider (e.g., window.ethereum)
|
|
40
|
-
* @throws WalletProviderError if no provider is given
|
|
41
|
-
*/
|
|
42
|
-
constructor(provider: Eip1193Provider);
|
|
43
|
-
/**
|
|
44
|
-
* Converts EIP-1193 errors to WalletProviderError
|
|
45
|
-
*/
|
|
46
|
-
private handleProviderError;
|
|
47
|
-
/**
|
|
48
|
-
* Ensures the provider is connected before operations
|
|
49
|
-
*/
|
|
50
|
-
private ensureConnected;
|
|
51
|
-
/**
|
|
52
|
-
* Connects to the wallet by requesting account access
|
|
53
|
-
*/
|
|
54
|
-
connect(): Promise<string>;
|
|
55
|
-
/**
|
|
56
|
-
* Disconnects from the wallet
|
|
57
|
-
*/
|
|
58
|
-
disconnect(): Promise<void>;
|
|
59
|
-
/**
|
|
60
|
-
* Checks if the wallet is connected
|
|
61
|
-
*/
|
|
62
|
-
isConnected(): boolean;
|
|
63
|
-
/**
|
|
64
|
-
* Signs a message using personal_sign
|
|
65
|
-
*/
|
|
66
|
-
signMessage(message: string): Promise<string>;
|
|
67
|
-
/**
|
|
68
|
-
* Signs typed data using EIP-712 (eth_signTypedData_v4)
|
|
69
|
-
*/
|
|
70
|
-
signTypedData(domain: TypedDataDomain, types: Record<string, TypedDataField[]>, value: Record<string, unknown>): Promise<string>;
|
|
71
|
-
/**
|
|
72
|
-
* Gets the connected address (0x prefixed, checksummed)
|
|
73
|
-
*/
|
|
74
|
-
getAddress(): Promise<string>;
|
|
75
|
-
/**
|
|
76
|
-
* Gets the address in Gala backend format (eth|{40-hex-chars})
|
|
77
|
-
*/
|
|
78
|
-
getGalaAddress(): Promise<string>;
|
|
79
|
-
/**
|
|
80
|
-
* Private key access is NOT available for external providers
|
|
81
|
-
*
|
|
82
|
-
* @throws WalletProviderError always - private key is not accessible
|
|
83
|
-
*/
|
|
84
|
-
getPrivateKey(): Promise<string>;
|
|
85
|
-
/**
|
|
86
|
-
* Gets the underlying EIP-1193 provider
|
|
87
|
-
*/
|
|
88
|
-
getProvider(): Eip1193Provider;
|
|
89
|
-
}
|
|
90
|
-
//# sourceMappingURL=ExternalWalletProvider.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"ExternalWalletProvider.d.ts","sourceRoot":"","sources":["../../src/wallet/ExternalWalletProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,cAAc,EACd,cAAc,EACd,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAkB3D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,sBAAuB,SAAQ,uBAAuB,CAAC,eAAe,CAAE,YAAW,cAAc;IAC5G,SAAgB,YAAY,EAAE,kBAAkB,CAAc;IAE9D;;;;;OAKG;gBACS,QAAQ,EAAE,eAAe;IAYrC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAsC3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IA+BhC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAejC;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUnD;;OAEG;IACG,aAAa,CACjB,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,EACvC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,MAAM,CAAC;IAUlB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAanC;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAKvC;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAQtC;;OAEG;IACH,WAAW,IAAI,eAAe;CAG/B"}
|
|
@@ -1,122 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Gala Wallet Provider
|
|
3
|
-
*
|
|
4
|
-
* Wraps the Gala Wallet extension (window.gala) for use with the WalletProvider
|
|
5
|
-
* interface. The Gala Wallet is a custom Gala-developed browser extension with
|
|
6
|
-
* unique characteristics:
|
|
7
|
-
*
|
|
8
|
-
* - Injects at window.gala instead of window.ethereum
|
|
9
|
-
* - Requires setAddress() call before signing operations
|
|
10
|
-
* - Custom error format (JSON-stringified objects)
|
|
11
|
-
* - Supports disconnect() method
|
|
12
|
-
*
|
|
13
|
-
* @packageDocumentation
|
|
14
|
-
*/
|
|
15
|
-
import type { TypedDataDomain, TypedDataField, WalletProvider, WalletProviderType } from './types';
|
|
16
|
-
import { WalletEventProviderBase } from './event-handlers';
|
|
17
|
-
/**
|
|
18
|
-
* Gala Wallet provider interface
|
|
19
|
-
*/
|
|
20
|
-
interface GalaWalletInterface {
|
|
21
|
-
setAddress(address: string): Promise<void>;
|
|
22
|
-
disconnect(): Promise<void>;
|
|
23
|
-
request<T = unknown>(args: {
|
|
24
|
-
method: string;
|
|
25
|
-
params?: unknown[];
|
|
26
|
-
}): Promise<T>;
|
|
27
|
-
on?(event: string, callback: (...args: unknown[]) => void): void;
|
|
28
|
-
removeListener?(event: string, callback: (...args: unknown[]) => void): void;
|
|
29
|
-
}
|
|
30
|
-
/**
|
|
31
|
-
* Wallet provider for Gala Wallet browser extension
|
|
32
|
-
*
|
|
33
|
-
* This provider wraps the Gala Wallet extension which has unique requirements
|
|
34
|
-
* compared to EIP-1193 wallets:
|
|
35
|
-
*
|
|
36
|
-
* - Must call setAddress() before any signing operation
|
|
37
|
-
* - Errors are JSON-stringified objects
|
|
38
|
-
* - Uses custom disconnect() method
|
|
39
|
-
*
|
|
40
|
-
* @example
|
|
41
|
-
* ```typescript
|
|
42
|
-
* // Using Gala Wallet
|
|
43
|
-
* const provider = new GalaWalletProvider(window.gala);
|
|
44
|
-
*
|
|
45
|
-
* // Connect to request account access
|
|
46
|
-
* const address = await provider.connect();
|
|
47
|
-
*
|
|
48
|
-
* // Sign a message (wallet will show approval UI)
|
|
49
|
-
* const signature = await provider.signMessage('Hello');
|
|
50
|
-
*
|
|
51
|
-
* // Disconnect
|
|
52
|
-
* await provider.disconnect();
|
|
53
|
-
* ```
|
|
54
|
-
*/
|
|
55
|
-
export declare class GalaWalletProvider extends WalletEventProviderBase<GalaWalletInterface> implements WalletProvider {
|
|
56
|
-
readonly providerType: WalletProviderType;
|
|
57
|
-
/** Original address returned by Gala Wallet (may be eth| format) */
|
|
58
|
-
private galaRawAddress;
|
|
59
|
-
/**
|
|
60
|
-
* Creates a new GalaWalletProvider
|
|
61
|
-
*
|
|
62
|
-
* @param provider - The Gala Wallet provider from window.gala
|
|
63
|
-
* @throws WalletProviderError if no provider is given
|
|
64
|
-
*/
|
|
65
|
-
constructor(provider: GalaWalletInterface);
|
|
66
|
-
/**
|
|
67
|
-
* Parses Gala Wallet errors (which are JSON-stringified)
|
|
68
|
-
*/
|
|
69
|
-
private parseGalaError;
|
|
70
|
-
/**
|
|
71
|
-
* Converts Gala Wallet errors to WalletProviderError
|
|
72
|
-
*/
|
|
73
|
-
private handleProviderError;
|
|
74
|
-
/**
|
|
75
|
-
* Ensures the provider is connected before operations
|
|
76
|
-
*/
|
|
77
|
-
private ensureConnected;
|
|
78
|
-
/**
|
|
79
|
-
* Connects to the wallet by requesting account access
|
|
80
|
-
*/
|
|
81
|
-
connect(): Promise<string>;
|
|
82
|
-
/**
|
|
83
|
-
* Disconnects from the wallet using Gala's disconnect method
|
|
84
|
-
*/
|
|
85
|
-
disconnect(): Promise<void>;
|
|
86
|
-
/**
|
|
87
|
-
* Checks if the wallet is connected
|
|
88
|
-
*/
|
|
89
|
-
isConnected(): boolean;
|
|
90
|
-
/**
|
|
91
|
-
* Signs a message using personal_sign
|
|
92
|
-
*
|
|
93
|
-
* Gala Wallet requires calling setAddress() before signing
|
|
94
|
-
*/
|
|
95
|
-
signMessage(message: string): Promise<string>;
|
|
96
|
-
/**
|
|
97
|
-
* Signs typed data using EIP-712 (eth_signTypedData_v4)
|
|
98
|
-
*
|
|
99
|
-
* Gala Wallet requires calling setAddress() before signing
|
|
100
|
-
*/
|
|
101
|
-
signTypedData(domain: TypedDataDomain, types: Record<string, TypedDataField[]>, value: Record<string, unknown>): Promise<string>;
|
|
102
|
-
/**
|
|
103
|
-
* Gets the connected address (0x prefixed, checksummed)
|
|
104
|
-
*/
|
|
105
|
-
getAddress(): Promise<string>;
|
|
106
|
-
/**
|
|
107
|
-
* Gets the address in Gala backend format (eth|{40-hex-chars})
|
|
108
|
-
*/
|
|
109
|
-
getGalaAddress(): Promise<string>;
|
|
110
|
-
/**
|
|
111
|
-
* Private key access is NOT available for Gala Wallet
|
|
112
|
-
*
|
|
113
|
-
* @throws WalletProviderError always - private key is not accessible
|
|
114
|
-
*/
|
|
115
|
-
getPrivateKey(): Promise<string>;
|
|
116
|
-
/**
|
|
117
|
-
* Gets the underlying Gala Wallet provider
|
|
118
|
-
*/
|
|
119
|
-
getProvider(): GalaWalletInterface;
|
|
120
|
-
}
|
|
121
|
-
export {};
|
|
122
|
-
//# sourceMappingURL=GalaWalletProvider.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"GalaWalletProvider.d.ts","sourceRoot":"","sources":["../../src/wallet/GalaWalletProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,cAAc,EACd,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAO3D;;GAEG;AACH,UAAU,mBAAmB;IAC3B,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC/E,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IACjE,cAAc,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;CAC9E;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,kBAAmB,SAAQ,uBAAuB,CAAC,mBAAmB,CAAE,YAAW,cAAc;IAC5G,SAAgB,YAAY,EAAE,kBAAkB,CAAc;IAE9D,oEAAoE;IACpE,OAAO,CAAC,cAAc,CAAuB;IAC7C;;;;;OAKG;gBACS,QAAQ,EAAE,mBAAmB;IAYzC;;OAEG;IACH,OAAO,CAAC,cAAc;IAuBtB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA+B3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAwChC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAYjC;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;;;OAIG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAcnD;;;;OAIG;IACG,aAAa,CACjB,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,EACvC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,MAAM,CAAC;IAclB;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAK7B;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAKvC;;;;OAIG;IACH,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAQhC;;OAEG;IACH,WAAW,IAAI,mBAAmB;CAGnC"}
|
|
@@ -1,90 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Private Key Wallet Provider
|
|
3
|
-
*
|
|
4
|
-
* Wraps an ethers.js Wallet for use with the WalletProvider interface.
|
|
5
|
-
* This provider has full access to the private key and can perform all operations.
|
|
6
|
-
*
|
|
7
|
-
* @packageDocumentation
|
|
8
|
-
*/
|
|
9
|
-
import { Wallet } from 'ethers';
|
|
10
|
-
import type { TypedDataDomain, TypedDataField, WalletProvider, WalletProviderType } from './types';
|
|
11
|
-
/**
|
|
12
|
-
* Wallet provider backed by a private key (ethers.js Wallet)
|
|
13
|
-
*
|
|
14
|
-
* This provider wraps an ethers.js Wallet instance, providing full signing
|
|
15
|
-
* capabilities including access to the private key for @gala-chain operations.
|
|
16
|
-
*
|
|
17
|
-
* @example
|
|
18
|
-
* ```typescript
|
|
19
|
-
* // Create from private key
|
|
20
|
-
* const provider = new PrivateKeyProvider('0x...');
|
|
21
|
-
*
|
|
22
|
-
* // Or from existing ethers Wallet
|
|
23
|
-
* const wallet = new Wallet('0x...');
|
|
24
|
-
* const provider = PrivateKeyProvider.fromWallet(wallet);
|
|
25
|
-
*
|
|
26
|
-
* // Use the provider
|
|
27
|
-
* const address = await provider.getAddress();
|
|
28
|
-
* const signature = await provider.signMessage('Hello');
|
|
29
|
-
* ```
|
|
30
|
-
*/
|
|
31
|
-
export declare class PrivateKeyProvider implements WalletProvider {
|
|
32
|
-
readonly providerType: WalletProviderType;
|
|
33
|
-
private readonly wallet;
|
|
34
|
-
private connected;
|
|
35
|
-
/**
|
|
36
|
-
* Creates a new PrivateKeyProvider from a private key
|
|
37
|
-
*
|
|
38
|
-
* @param privateKey - The private key (0x prefixed or raw hex)
|
|
39
|
-
* @throws WalletProviderError if the private key is invalid
|
|
40
|
-
*/
|
|
41
|
-
constructor(privateKey: string);
|
|
42
|
-
/**
|
|
43
|
-
* Creates a PrivateKeyProvider from an existing ethers.js Wallet
|
|
44
|
-
*
|
|
45
|
-
* @param wallet - An ethers.js Wallet instance
|
|
46
|
-
* @returns A new PrivateKeyProvider wrapping the wallet
|
|
47
|
-
*/
|
|
48
|
-
static fromWallet(wallet: Wallet): PrivateKeyProvider;
|
|
49
|
-
/**
|
|
50
|
-
* Signs a message using EIP-191 personal_sign
|
|
51
|
-
*/
|
|
52
|
-
signMessage(message: string): Promise<string>;
|
|
53
|
-
/**
|
|
54
|
-
* Signs typed data using EIP-712
|
|
55
|
-
*/
|
|
56
|
-
signTypedData(domain: TypedDataDomain, types: Record<string, TypedDataField[]>, value: Record<string, unknown>): Promise<string>;
|
|
57
|
-
/**
|
|
58
|
-
* Gets the wallet's Ethereum address (0x prefixed, checksummed)
|
|
59
|
-
*/
|
|
60
|
-
getAddress(): Promise<string>;
|
|
61
|
-
/**
|
|
62
|
-
* Gets the wallet address in Gala backend format (eth|{40-hex-chars})
|
|
63
|
-
*/
|
|
64
|
-
getGalaAddress(): Promise<string>;
|
|
65
|
-
/**
|
|
66
|
-
* Connect is a no-op for PrivateKeyProvider since we always have the key
|
|
67
|
-
*/
|
|
68
|
-
connect(): Promise<string>;
|
|
69
|
-
/**
|
|
70
|
-
* Disconnect marks the provider as disconnected
|
|
71
|
-
*/
|
|
72
|
-
disconnect(): Promise<void>;
|
|
73
|
-
/**
|
|
74
|
-
* Checks if the provider is connected
|
|
75
|
-
*/
|
|
76
|
-
isConnected(): boolean;
|
|
77
|
-
/**
|
|
78
|
-
* Gets the private key
|
|
79
|
-
*
|
|
80
|
-
* This is only available for PrivateKeyProvider.
|
|
81
|
-
*/
|
|
82
|
-
getPrivateKey(): Promise<string>;
|
|
83
|
-
/**
|
|
84
|
-
* Gets the underlying ethers.js Wallet instance
|
|
85
|
-
*
|
|
86
|
-
* Useful for operations that require direct Wallet access.
|
|
87
|
-
*/
|
|
88
|
-
getWallet(): Wallet;
|
|
89
|
-
}
|
|
90
|
-
//# sourceMappingURL=PrivateKeyProvider.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"PrivateKeyProvider.d.ts","sourceRoot":"","sources":["../../src/wallet/PrivateKeyProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAa,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE3C,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,cAAc,EACd,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAMjB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACvD,SAAgB,YAAY,EAAE,kBAAkB,CAAgB;IAEhE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,SAAS,CAAiB;IAElC;;;;;OAKG;gBACS,UAAU,EAAE,MAAM;IAY9B;;;;;OAKG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB;IAIrD;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAYnD;;OAEG;IACG,aAAa,CACjB,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,EACvC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,MAAM,CAAC;IAYlB;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAI7B;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAMvC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAKhC;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;;;OAIG;IACH,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAIhC;;;;OAIG;IACH,SAAS,IAAI,MAAM;CAGpB"}
|