@dynamic-labs-wallet/stellar 0.0.323 → 0.0.325

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@dynamic-labs-wallet/stellar",
-  "version": "0.0.323",
+  "version": "0.0.325",
   "license": "MIT",
   "type": "module",
   "dependencies": {
-    "@dynamic-labs-wallet/browser": "0.0.323",
+    "@dynamic-labs-wallet/browser": "0.0.325",
     "@stellar/stellar-sdk": "^12.3.0",
     "@dynamic-labs/sdk-api-core": "^0.0.900"
   },

package/src/client/client.d.ts

@@ -0,0 +1,63 @@
+import { DynamicWalletClient, type ClientKeyShare, type DynamicWalletClientInternalOptions, type DynamicWalletClientProps, type ThresholdSignatureScheme, type RequestWithElevatedAccessToken } from '@dynamic-labs-wallet/browser';
+import type { SignMessageContext } from '@dynamic-labs/sdk-api-core';
+export declare class DynamicStellarWalletClient extends DynamicWalletClient {
+    readonly chainName = "STELLAR";
+    constructor({ environmentId, authToken, baseApiUrl, baseMPCRelayApiUrl, storageKey, debug, featureFlags, authMode, sdkVersion, forwardMPCClient, logger, }: DynamicWalletClientProps, internalOptions?: DynamicWalletClientInternalOptions);
+    createWalletAccount({ thresholdSignatureScheme, password, onError, signedSessionId, }: {
+        thresholdSignatureScheme: ThresholdSignatureScheme;
+        password?: string;
+        onError?: (error: Error) => void;
+        signedSessionId: string;
+    }): Promise<{
+        accountAddress: string;
+        publicKeyHex: string;
+        rawPublicKey: Uint8Array;
+    }>;
+    signMessage({ message, accountAddress, password, signedSessionId, mfaToken, elevatedAccessToken, context, onError, }: {
+        message: string;
+        accountAddress: string;
+        password?: string;
+        signedSessionId: string;
+        mfaToken?: string;
+        elevatedAccessToken?: string;
+        context?: SignMessageContext;
+        onError?: (error: Error) => void;
+    }): Promise<string>;
+    signTransaction({ senderAddress, transaction, password, signedSessionId, mfaToken, elevatedAccessToken, chainId, context, onError, }: {
+        senderAddress: string;
+        /** XDR-encoded transaction envelope */
+        transaction: string;
+        password?: string;
+        signedSessionId: string;
+        mfaToken?: string;
+        elevatedAccessToken?: string;
+        chainId?: string;
+        context?: SignMessageContext;
+        onError?: (error: Error) => void;
+    }): Promise<string>;
+    exportPrivateKey({ accountAddress, password, signedSessionId, mfaToken, elevatedAccessToken, }: RequestWithElevatedAccessToken<{
+        accountAddress: string;
+        password?: string;
+        signedSessionId: string;
+        mfaToken?: string;
+    }>): Promise<string>;
+    importPrivateKey({ privateKey, chainName, thresholdSignatureScheme, password, signedSessionId, onError, publicAddressCheck, legacyWalletId, }: {
+        privateKey: string;
+        chainName: string;
+        thresholdSignatureScheme: ThresholdSignatureScheme;
+        password?: string;
+        signedSessionId: string;
+        onError?: (error: Error) => void;
+        publicAddressCheck?: string;
+        /** ID of the legacy embedded wallet being upgraded to v3 */
+        legacyWalletId?: string;
+    }): Promise<{
+        accountAddress: string;
+        publicKeyHex: string;
+        rawPublicKey: Uint8Array;
+        clientKeyShares: ClientKeyShare[];
+    }>;
+    getPublicKeyFromPrivateKey(privateKeyHex: string): string;
+    getStellarWallets(): Promise<any>;
+}
+//# sourceMappingURL=client.d.ts.map

package/src/client/client.d.ts.map

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

package/src/client/constants.d.ts

@@ -0,0 +1,20 @@
+export declare const ERROR_KEYGEN_FAILED = "Error with keygen";
+export declare const ERROR_CREATE_WALLET_ACCOUNT = "Error creating stellar wallet account";
+export declare const ERROR_IMPORT_PRIVATE_KEY = "Error importing private key";
+export declare const ERROR_EXPORT_PRIVATE_KEY = "Error exporting private key";
+export declare const ERROR_SIGN_MESSAGE = "Error signing message";
+export declare const ERROR_ACCOUNT_ADDRESS_REQUIRED = "Account address is required";
+export declare const ERROR_VERIFY_MESSAGE_SIGNATURE = "Error verifying message signature";
+export declare const ERROR_VERIFY_TRANSACTION_SIGNATURE = "Error verifying transaction signature";
+export declare const ERROR_SIGN_TRANSACTION = "Error signing transaction";
+export declare const ERROR_CHAIN_ID_REQUIRED_LOCAL = "Chain ID is required";
+export declare const STELLAR_NETWORK_PASSPHRASES: {
+    readonly MAINNET: "Public Global Stellar Network ; September 2015";
+    readonly TESTNET: "Test SDF Network ; September 2015";
+    readonly FUTURENET: "Test SDF Future Network ; October 2022";
+};
+/** Stellar network identifier for Horizon and display. */
+export type StellarNetwork = keyof typeof STELLAR_NETWORK_PASSPHRASES;
+/** Horizon API base URLs. Use when fetching account/balance so mainnet UI uses mainnet, testnet uses testnet. */
+export declare const STELLAR_HORIZON_URLS: Record<StellarNetwork, string>;
+//# sourceMappingURL=constants.d.ts.map

package/src/client/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/client/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,sBAAsB,CAAC;AAEvD,eAAO,MAAM,2BAA2B,0CAA0C,CAAC;AAEnF,eAAO,MAAM,wBAAwB,gCAAgC,CAAC;AAEtE,eAAO,MAAM,wBAAwB,gCAAgC,CAAC;AAEtE,eAAO,MAAM,kBAAkB,0BAA0B,CAAC;AAE1D,eAAO,MAAM,8BAA8B,gCAAgC,CAAC;AAE5E,eAAO,MAAM,8BAA8B,sCAAsC,CAAC;AAElF,eAAO,MAAM,kCAAkC,0CAA0C,CAAC;AAE1F,eAAO,MAAM,sBAAsB,8BAA8B,CAAC;AAElE,eAAO,MAAM,6BAA6B,yBAAyB,CAAC;AAEpE,eAAO,MAAM,2BAA2B;;;;CAI9B,CAAC;AAEX,0DAA0D;AAC1D,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,2BAA2B,CAAC;AAEtE,iHAAiH;AACjH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAItD,CAAC"}

package/src/client/index.d.ts

@@ -0,0 +1,2 @@
+export * from './client.js';
+//# sourceMappingURL=index.d.ts.map

package/src/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/src/index.d.ts

@@ -0,0 +1,4 @@
+export * from './client/index.js';
+export { STELLAR_NETWORK_PASSPHRASES, STELLAR_HORIZON_URLS, type StellarNetwork } from './client/constants.js';
+export * as sdkApiCore from '@dynamic-labs/sdk-api-core';
+//# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../packages/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC/G,OAAO,KAAK,UAAU,MAAM,4BAA4B,CAAC"}

package/src/utils/deriveStellarAddress/deriveStellarAddress.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Derives a Stellar address (public key) from a raw Ed25519 public key
+ * Stellar addresses use StrKey encoding with version byte for public keys
+ * They start with 'G' and are 56 characters long
+ */
+export declare const deriveStellarAddress: ({ publicKeyHex }: {
+    publicKeyHex: string;
+}) => string;
+/**
+ * Validates a Stellar address
+ * @param address The address to validate
+ * @returns true if the address is a valid Stellar public key address
+ */
+export declare const isValidStellarAddress: (address: string) => boolean;
+/**
+ * Decodes a Stellar address to raw Ed25519 public key bytes
+ * @param address The Stellar address (G...)
+ * @returns The raw 32-byte Ed25519 public key
+ */
+export declare const decodeStellarAddress: (address: string) => Buffer;
+//# sourceMappingURL=deriveStellarAddress.d.ts.map

package/src/utils/deriveStellarAddress/deriveStellarAddress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deriveStellarAddress.d.ts","sourceRoot":"","sources":["../../../src/utils/deriveStellarAddress/deriveStellarAddress.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,qBAAsB;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,KAAG,MASjF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,YAAa,MAAM,KAAG,OAEvD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,YAAa,MAAM,KAAG,MAKtD,CAAC"}

package/src/utils/deriveStellarAddress/index.d.ts

@@ -0,0 +1,2 @@
+export * from './deriveStellarAddress.js';
+//# sourceMappingURL=index.d.ts.map

package/src/utils/deriveStellarAddress/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/deriveStellarAddress/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC"}

package/src/utils/getNetworkPassphrase/getNetworkPassphrase.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Maps numeric chainId (used in policies) to network passphrase (used for transaction hashing)
+ * ChainIds: '1' = pubnet (mainnet), '2' = testnet, '3' = futurenet
+ */
+export declare const STELLAR_CHAIN_ID_TO_PASSPHRASE: Record<string, string>;
+/**
+ * Gets the network passphrase from a numeric chainId, defaults to mainnet
+ */
+export declare const getNetworkPassphraseFromChainId: (chainId: string) => string;
+//# sourceMappingURL=getNetworkPassphrase.d.ts.map

package/src/utils/getNetworkPassphrase/getNetworkPassphrase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getNetworkPassphrase.d.ts","sourceRoot":"","sources":["../../../src/utils/getNetworkPassphrase/getNetworkPassphrase.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,8BAA8B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAIjE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,+BAA+B,YAAa,MAAM,KAAG,MAEjE,CAAC"}

package/src/utils/getNetworkPassphrase/index.d.ts

@@ -0,0 +1,2 @@
+export * from './getNetworkPassphrase.js';
+//# sourceMappingURL=index.d.ts.map

package/src/utils/getNetworkPassphrase/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/getNetworkPassphrase/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC"}

package/src/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from './deriveStellarAddress/index.js';
+export * from './getNetworkPassphrase/index.js';
+//# sourceMappingURL=index.d.ts.map

package/src/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC"}