pwc-sdk-wallet 0.6.3

package/dist/chain/ChainService.d.ts

@@ -0,0 +1,84 @@
+import { TransactionRequest, TransactionResponse, TransactionReceipt } from 'ethers';
+import { type ChainConfig } from '../config/chains';
+/**
+ * Interface representing token metadata for ERC-20 tokens.
+ */
+export interface Token {
+    /** The contract address of the token */
+    address: string;
+    /** The human-readable name of the token */
+    name: string;
+    /** The token's symbol/ticker */
+    symbol: string;
+    /** The number of decimal places for the token */
+    decimals: number;
+}
+/**
+ * Service for interacting with EVM-compatible blockchains.
+ * Provides methods for balance checking, token operations, and transaction sending.
+ */
+export declare class ChainService {
+    private wallet;
+    /**
+     * Creates a new ChainService instance for the specified chain.
+     * @param privateKey - The private key to use for signing transactions (hex string without '0x' prefix)
+     * @param chainConfig - The chain configuration to use
+     */
+    constructor(privateKey: string, chainConfig: ChainConfig);
+    /**
+     * Derives the public address from a private key.
+     * @param privateKey - The private key to derive the address from (hex string without '0x' prefix)
+     * @returns The derived Ethereum address
+     */
+    static getAddress(privateKey: string): string;
+    /**
+     * Gets the native token balance (e.g., ETH, MATIC) for the wallet.
+     * @returns Promise resolving to the balance as a bigint in wei
+     * @throws Error if the provider is not set
+     */
+    getNativeBalance(): Promise<bigint>;
+    /**
+     * Gets the balance of a specific ERC-20 token for the wallet.
+     * @param tokenAddress - The contract address of the ERC-20 token
+     * @returns Promise resolving to the token balance as a bigint
+     * @throws Error if the provider is not set or token contract is invalid
+     */
+    getTokenBalance(tokenAddress: string): Promise<bigint>;
+    /**
+     * Gets metadata information about an ERC-20 token.
+     * @param tokenAddress - The contract address of the ERC-20 token
+     * @returns Promise resolving to token metadata including name, symbol, and decimals
+     * @throws Error if the provider is not set or token contract is invalid
+     */
+    getTokenInfo(tokenAddress: string): Promise<Token>;
+    /**
+     * Estimates the gas cost for a transaction.
+     * @param transaction - The transaction request to estimate gas for
+     * @returns Promise resolving to the estimated gas cost as a bigint
+     * @throws Error if the provider is not set or estimation fails
+     */
+    estimateGas(transaction: TransactionRequest): Promise<bigint>;
+    /**
+     * Sends a transaction to the blockchain.
+     * @param transaction - The transaction request to send
+     * @returns Promise resolving to the transaction response with hash and details
+     * @throws Error if the transaction fails or wallet is not properly configured
+     */
+    sendTransaction(transaction: TransactionRequest): Promise<TransactionResponse>;
+    /**
+     * Sends ERC-20 tokens to another address.
+     * @param tokenAddress - The contract address of the ERC-20 token to send
+     * @param to - The recipient's address
+     * @param amount - The amount of tokens to send as a string (e.g., "100.5")
+     * @returns Promise resolving to the transaction response with hash and details
+     * @throws Error if insufficient balance, invalid addresses, or transaction fails
+     */
+    sendToken(tokenAddress: string, to: string, amount: string): Promise<TransactionResponse>;
+    /**
+     * Gets the transaction receipt for a given transaction hash.
+     * @param hash - The transaction hash to get the receipt for
+     * @returns Promise resolving to the transaction receipt or null if not found
+     * @throws Error if the provider is not set
+     */
+    getTransactionReceipt(hash: string): Promise<TransactionReceipt | null>;
+}

package/dist/chain/ChainService.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChainService = void 0;
+const ethers_1 = require("ethers");
+/**
+ * Standard ERC-20 token interface ABI for common token operations.
+ */
+const ERC20_ABI = [
+    "function name() view returns (string)",
+    "function symbol() view returns (string)",
+    "function decimals() view returns (uint8)",
+    "function totalSupply() view returns (uint256)",
+    "function balanceOf(address) view returns (uint)",
+    "function transfer(address to, uint amount) returns (bool)",
+    "function approve(address spender, uint amount) returns (bool)"
+];
+/**
+ * Service for interacting with EVM-compatible blockchains.
+ * Provides methods for balance checking, token operations, and transaction sending.
+ */
+class ChainService {
+    /**
+     * Creates a new ChainService instance for the specified chain.
+     * @param privateKey - The private key to use for signing transactions (hex string without '0x' prefix)
+     * @param chainConfig - The chain configuration to use
+     */
+    constructor(privateKey, chainConfig) {
+        if (chainConfig.type !== 'evm') {
+            throw new Error('ChainService only supports EVM chains');
+        }
+        const provider = new ethers_1.ethers.JsonRpcProvider(chainConfig.rpcUrl);
+        this.wallet = new ethers_1.Wallet(privateKey, provider);
+    }
+    /**
+     * Derives the public address from a private key.
+     * @param privateKey - The private key to derive the address from (hex string without '0x' prefix)
+     * @returns The derived Ethereum address
+     */
+    static getAddress(privateKey) {
+        return new ethers_1.Wallet(privateKey).address;
+    }
+    /**
+     * Gets the native token balance (e.g., ETH, MATIC) for the wallet.
+     * @returns Promise resolving to the balance as a bigint in wei
+     * @throws Error if the provider is not set
+     */
+    async getNativeBalance() {
+        if (!this.wallet.provider) {
+            throw new Error('Provider not set for wallet.');
+        }
+        return this.wallet.provider.getBalance(this.wallet.address);
+    }
+    /**
+     * Gets the balance of a specific ERC-20 token for the wallet.
+     * @param tokenAddress - The contract address of the ERC-20 token
+     * @returns Promise resolving to the token balance as a bigint
+     * @throws Error if the provider is not set or token contract is invalid
+     */
+    async getTokenBalance(tokenAddress) {
+        if (!this.wallet.provider) {
+            throw new Error('Provider not set for wallet.');
+        }
+        const contract = new ethers_1.ethers.Contract(tokenAddress, ERC20_ABI, this.wallet.provider);
+        return contract.balanceOf(this.wallet.address);
+    }
+    /**
+     * Gets metadata information about an ERC-20 token.
+     * @param tokenAddress - The contract address of the ERC-20 token
+     * @returns Promise resolving to token metadata including name, symbol, and decimals
+     * @throws Error if the provider is not set or token contract is invalid
+     */
+    async getTokenInfo(tokenAddress) {
+        if (!this.wallet.provider) {
+            throw new Error('Provider not set for wallet.');
+        }
+        const contract = new ethers_1.ethers.Contract(tokenAddress, ERC20_ABI, this.wallet.provider);
+        const [name, symbol, decimals] = await Promise.all([
+            contract.name(),
+            contract.symbol(),
+            contract.decimals(),
+        ]);
+        return { address: tokenAddress, name, symbol, decimals: Number(decimals) };
+    }
+    /**
+     * Estimates the gas cost for a transaction.
+     * @param transaction - The transaction request to estimate gas for
+     * @returns Promise resolving to the estimated gas cost as a bigint
+     * @throws Error if the provider is not set or estimation fails
+     */
+    async estimateGas(transaction) {
+        if (!this.wallet.provider) {
+            throw new Error('Provider not set for wallet.');
+        }
+        return this.wallet.provider.estimateGas(transaction);
+    }
+    /**
+     * Sends a transaction to the blockchain.
+     * @param transaction - The transaction request to send
+     * @returns Promise resolving to the transaction response with hash and details
+     * @throws Error if the transaction fails or wallet is not properly configured
+     */
+    async sendTransaction(transaction) {
+        return this.wallet.sendTransaction(transaction);
+    }
+    /**
+     * Sends ERC-20 tokens to another address.
+     * @param tokenAddress - The contract address of the ERC-20 token to send
+     * @param to - The recipient's address
+     * @param amount - The amount of tokens to send as a string (e.g., "100.5")
+     * @returns Promise resolving to the transaction response with hash and details
+     * @throws Error if insufficient balance, invalid addresses, or transaction fails
+     */
+    async sendToken(tokenAddress, to, amount) {
+        if (!this.wallet.provider) {
+            throw new Error('Provider not set for wallet.');
+        }
+        const contract = new ethers_1.Contract(tokenAddress, ERC20_ABI, this.wallet);
+        const tokenInfo = await this.getTokenInfo(tokenAddress);
+        const parsedAmount = ethers_1.ethers.parseUnits(amount, tokenInfo.decimals);
+        // The contract instance is connected to the wallet, which will sign and send the transaction.
+        return contract.transfer(to, parsedAmount);
+    }
+    /**
+     * Gets the transaction receipt for a given transaction hash.
+     * @param hash - The transaction hash to get the receipt for
+     * @returns Promise resolving to the transaction receipt or null if not found
+     * @throws Error if the provider is not set
+     */
+    async getTransactionReceipt(hash) {
+        if (!this.wallet.provider) {
+            throw new Error('Provider not set for wallet.');
+        }
+        return this.wallet.provider.getTransactionReceipt(hash);
+    }
+}
+exports.ChainService = ChainService;

package/dist/chain/SolanaChainService.d.ts

@@ -0,0 +1,94 @@
+import { type ChainConfig } from '../config/chains';
+/**
+ * Interface representing Solana transaction response.
+ * Similar to EVM transaction response but adapted for Solana's transaction structure.
+ */
+export interface SolanaTransactionResponse {
+    /** The transaction signature/hash */
+    hash: string;
+    /** The sender's public key address */
+    from: string;
+    /** The recipient's public key address */
+    to: string;
+    /** The block number (optional, not always available on Solana) */
+    blockNumber?: number;
+}
+/**
+ * Interface representing Solana SPL token metadata.
+ * Extends the basic token interface with Solana-specific fields.
+ */
+export interface SolanaToken {
+    /** The token's mint address */
+    address: string;
+    /** The human-readable name of the token */
+    name: string;
+    /** The token's symbol/ticker */
+    symbol: string;
+    /** The number of decimal places for the token */
+    decimals: number;
+    /** The total supply of the token (optional) */
+    totalSupply?: string;
+}
+/**
+ * Service for interacting with Solana blockchain.
+ * Provides methods for SOL balance checking, SPL token operations, and transaction sending.
+ */
+export declare class SolanaChainService {
+    private connection;
+    private keypair;
+    /**
+     * Creates a new SolanaChainService instance for the specified Solana network.
+     * @param privateKey - The private key to use for signing transactions (hex string)
+     * @param chainConfig - The chain configuration to use
+     * @throws Error if the chain is not a Solana chain
+     */
+    constructor(privateKey: string, chainConfig: ChainConfig);
+    /**
+     * Gets the native SOL balance for the wallet.
+     * @returns Promise resolving to the balance as a bigint in lamports
+     * @throws Error if the balance query fails
+     */
+    getNativeBalance(): Promise<bigint>;
+    /**
+     * Sends native SOL to another address.
+     * @param to - The recipient's public key address
+     * @param amount - The amount of SOL to send as a string (e.g., "1.5")
+     * @returns Promise resolving to the transaction response with signature and details
+     * @throws Error if the transaction fails or recipient address is invalid
+     */
+    sendTransaction(to: string, amount: string): Promise<SolanaTransactionResponse>;
+    /**
+     * Gets the balance of a specific SPL token for the wallet.
+     * @param tokenAddress - The token's mint address
+     * @returns Promise resolving to the token balance as a bigint
+     * @throws Error if the balance query fails (returns 0 if token account doesn't exist)
+     */
+    getTokenBalance(tokenAddress: string): Promise<bigint>;
+    /**
+     * Gets metadata information about an SPL token.
+     * @param tokenAddress - The token's mint address
+     * @returns Promise resolving to token metadata including supply information
+     * @throws Error if the token info query fails
+     */
+    getTokenInfo(tokenAddress: string): Promise<SolanaToken>;
+    /**
+     * Sends SPL tokens to another address.
+     * @param tokenAddress - The token's mint address to send
+     * @param to - The recipient's public key address
+     * @param amount - The amount of tokens to send as a string
+     * @returns Promise resolving to the transaction response with signature and details
+     * @throws Error if the transaction fails, insufficient balance, or addresses are invalid
+     */
+    sendToken(tokenAddress: string, to: string, amount: string): Promise<SolanaTransactionResponse>;
+    /**
+     * Gets the public key address of the wallet.
+     * @returns The public key address as a string
+     */
+    getAddress(): string;
+    /**
+     * Estimates the transaction fee for a typical transaction.
+     * @returns Promise resolving to the estimated fee as a bigint in lamports
+     * @throws Error if the fee estimation fails
+     */
+    estimateTransactionFee(): Promise<bigint>;
+}

package/dist/chain/SolanaChainService.js

@@ -0,0 +1,167 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SolanaChainService = void 0;
+const web3_js_1 = require("@solana/web3.js");
+const spl_token_1 = require("@solana/spl-token");
+const buffer_1 = require("buffer");
+/**
+ * Service for interacting with Solana blockchain.
+ * Provides methods for SOL balance checking, SPL token operations, and transaction sending.
+ */
+class SolanaChainService {
+    /**
+     * Creates a new SolanaChainService instance for the specified Solana network.
+     * @param privateKey - The private key to use for signing transactions (hex string)
+     * @param chainConfig - The chain configuration to use
+     * @throws Error if the chain is not a Solana chain
+     */
+    constructor(privateKey, chainConfig) {
+        if (chainConfig.type !== 'solana') {
+            throw new Error('SolanaChainService only supports Solana chains');
+        }
+        this.connection = new web3_js_1.Connection(chainConfig.rpcUrl, 'confirmed');
+        this.keypair = web3_js_1.Keypair.fromSecretKey(buffer_1.Buffer.from(privateKey, 'hex'));
+    }
+    /**
+     * Gets the native SOL balance for the wallet.
+     * @returns Promise resolving to the balance as a bigint in lamports
+     * @throws Error if the balance query fails
+     */
+    async getNativeBalance() {
+        try {
+            const balance = await this.connection.getBalance(this.keypair.publicKey);
+            return BigInt(balance);
+        }
+        catch (error) {
+            throw new Error(`Failed to get SOL balance: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Sends native SOL to another address.
+     * @param to - The recipient's public key address
+     * @param amount - The amount of SOL to send as a string (e.g., "1.5")
+     * @returns Promise resolving to the transaction response with signature and details
+     * @throws Error if the transaction fails or recipient address is invalid
+     */
+    async sendTransaction(to, amount) {
+        try {
+            const toPubkey = new web3_js_1.PublicKey(to);
+            const lamports = parseFloat(amount) * web3_js_1.LAMPORTS_PER_SOL;
+            const transaction = new web3_js_1.Transaction().add(web3_js_1.SystemProgram.transfer({
+                fromPubkey: this.keypair.publicKey,
+                toPubkey: toPubkey,
+                lamports: lamports
+            }));
+            const signature = await (0, web3_js_1.sendAndConfirmTransaction)(this.connection, transaction, [this.keypair]);
+            return {
+                hash: signature,
+                from: this.keypair.publicKey.toString(),
+                to: to
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to send SOL transaction: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Gets the balance of a specific SPL token for the wallet.
+     * @param tokenAddress - The token's mint address
+     * @returns Promise resolving to the token balance as a bigint
+     * @throws Error if the balance query fails (returns 0 if token account doesn't exist)
+     */
+    async getTokenBalance(tokenAddress) {
+        try {
+            const tokenPubkey = new web3_js_1.PublicKey(tokenAddress);
+            const associatedTokenAddress = await (0, spl_token_1.getAssociatedTokenAddress)(tokenPubkey, this.keypair.publicKey);
+            const balance = await this.connection.getTokenAccountBalance(associatedTokenAddress);
+            if (balance.value === null) {
+                return BigInt(0);
+            }
+            return BigInt(balance.value.amount);
+        }
+        catch (error) {
+            // If token account doesn't exist, return 0
+            if (error instanceof Error && error.message.includes('TokenAccountNotFoundError')) {
+                return BigInt(0);
+            }
+            throw new Error(`Failed to get token balance: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Gets metadata information about an SPL token.
+     * @param tokenAddress - The token's mint address
+     * @returns Promise resolving to token metadata including supply information
+     * @throws Error if the token info query fails
+     */
+    async getTokenInfo(tokenAddress) {
+        try {
+            const tokenPubkey = new web3_js_1.PublicKey(tokenAddress);
+            // Get token supply
+            const supply = await this.connection.getTokenSupply(tokenPubkey);
+            // For now, return basic info. In a real implementation,
+            // you'd fetch metadata from the token's metadata account
+            return {
+                address: tokenAddress,
+                name: 'Unknown Token',
+                symbol: 'UNKNOWN',
+                decimals: 0,
+                totalSupply: supply.value.amount
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to get token info: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Sends SPL tokens to another address.
+     * @param tokenAddress - The token's mint address to send
+     * @param to - The recipient's public key address
+     * @param amount - The amount of tokens to send as a string
+     * @returns Promise resolving to the transaction response with signature and details
+     * @throws Error if the transaction fails, insufficient balance, or addresses are invalid
+     */
+    async sendToken(tokenAddress, to, amount) {
+        try {
+            const tokenPubkey = new web3_js_1.PublicKey(tokenAddress);
+            const toPubkey = new web3_js_1.PublicKey(to);
+            // Get or create associated token account for recipient
+            const recipientTokenAccount = await (0, spl_token_1.getAssociatedTokenAddress)(tokenPubkey, toPubkey);
+            // Get sender's associated token account
+            const senderTokenAccount = await (0, spl_token_1.getAssociatedTokenAddress)(tokenPubkey, this.keypair.publicKey);
+            // Create transfer instruction
+            const transferInstruction = (0, spl_token_1.createTransferInstruction)(senderTokenAccount, recipientTokenAccount, this.keypair.publicKey, parseFloat(amount));
+            const transaction = new web3_js_1.Transaction().add(transferInstruction);
+            const signature = await (0, web3_js_1.sendAndConfirmTransaction)(this.connection, transaction, [this.keypair]);
+            return {
+                hash: signature,
+                from: this.keypair.publicKey.toString(),
+                to: to
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to send token: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Gets the public key address of the wallet.
+     * @returns The public key address as a string
+     */
+    getAddress() {
+        return this.keypair.publicKey.toString();
+    }
+    /**
+     * Estimates the transaction fee for a typical transaction.
+     * @returns Promise resolving to the estimated fee as a bigint in lamports
+     * @throws Error if the fee estimation fails
+     */
+    async estimateTransactionFee() {
+        try {
+            const { feeCalculator } = await this.connection.getRecentBlockhash();
+            return BigInt(feeCalculator.lamportsPerSignature);
+        }
+        catch (error) {
+            throw new Error(`Failed to estimate transaction fee: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+}
+exports.SolanaChainService = SolanaChainService;