@pushchain/core 0.1.0

package/src/lib/vm-client/evm-client.js

@@ -0,0 +1,244 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EvmClient = void 0;
+const tslib_1 = require("tslib");
+const viem_1 = require("viem");
+/**
+ * EVM client for reading and writing to Ethereum-compatible chains
+ *
+ * @example
+ * // Initialize with an RPC URL
+ * const evmClient = new EvmClient({
+ *   rpcUrl: 'https://eth-sepolia.g.alchemy.com/v2/your-api-key'
+ * });
+ */
+class EvmClient {
+    constructor({ rpcUrl }) {
+        this.publicClient = (0, viem_1.createPublicClient)({
+            transport: (0, viem_1.http)(rpcUrl),
+        });
+    }
+    /**
+     * Returns the balance (in wei) of an EVM address.
+     *
+     * @param address - The EVM address to check balance for
+     * @returns Balance as a bigint in wei
+     *
+     * @example
+     * // Get balance of an address
+     * const balance = await evmClient.getBalance('0x123...');
+     * console.log(`Balance: ${balance} wei`);
+     *
+     * @example
+     * // Check if an address has zero balance
+     * const newAddress = privateKeyToAccount(generatePrivateKey()).address;
+     * const balance = await evmClient.getBalance(newAddress);
+     * if (balance === BigInt(0)) {
+     *   console.log('Address has no funds');
+     * }
+     */
+    getBalance(address) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return this.publicClient.getBalance({ address });
+        });
+    }
+    /**
+     * Performs a read-only call to a smart contract.
+     *
+     * @param params - Parameters including ABI, contract address, function name, and args
+     * @returns The result of the contract call with the specified type
+     *
+     * @example
+     * // Read a greeting value from a contract
+     * const greeting = await evmClient.readContract<string>({
+     *   abi: parseAbi(['function greet() view returns (string)']),
+     *   address: '0x2ba5873eF818BEE57645B7d674149041C44F42c6',
+     *   functionName: 'greet',
+     * });
+     * console.log(`Current greeting: ${greeting}`);
+     *
+     * @example
+     * // Reading with arguments
+     * const balance = await evmClient.readContract<bigint>({
+     *   abi: parseAbi(['function balanceOf(address) view returns (uint256)']),
+     *   address: '0xTokenAddress',
+     *   functionName: 'balanceOf',
+     *   args: ['0xUserAddress'],
+     * });
+     */
+    readContract(_a) {
+        return tslib_1.__awaiter(this, arguments, void 0, function* ({ abi, address, functionName, args = [], }) {
+            return this.publicClient.readContract({
+                abi: abi,
+                address: address,
+                functionName,
+                args,
+            });
+        });
+    }
+    /**
+     * Writes a transaction to a smart contract using a UniversalSigner.
+     * This function handles contract interaction by encoding function data
+     * and sending the transaction through sendTransaction.
+     *
+     * @param params - Parameters including ABI, contract address, function name, args, value and signer
+     * @returns Transaction hash as a hex string
+     *
+     * @example
+     * // Set a new greeting on a contract
+     * const txHash = await evmClient.writeContract({
+     *   abi: parseAbi(['function setGreeting(string _greeting)']),
+     *   address: '0x2ba5873eF818BEE57645B7d674149041C44F42c6',
+     *   functionName: 'setGreeting',
+     *   args: ['Hello from Push SDK!'],
+     *   signer: universalSigner,
+     * });
+     * console.log(`Transaction sent: ${txHash}`);
+     *
+     * @example
+     * // Sending ether with a contract interaction
+     * const txHash = await evmClient.writeContract({
+     *   abi: parseAbi(['function deposit() payable']),
+     *   address: '0xContractAddress',
+     *   functionName: 'deposit',
+     *   value: parseEther('0.1'), // Send 0.1 ETH
+     *   signer: universalSigner,
+     * });
+     */
+    writeContract(_a) {
+        return tslib_1.__awaiter(this, arguments, void 0, function* ({ abi, address, functionName, args = [], value = (0, viem_1.parseEther)('0'), signer, }) {
+            const data = (0, viem_1.encodeFunctionData)({
+                abi: abi,
+                functionName,
+                args,
+            });
+            return this.sendTransaction({
+                to: address,
+                data,
+                value,
+                signer,
+            });
+        });
+    }
+    /**
+     * Sends a raw EVM transaction using a UniversalSigner.
+     * This handles the full transaction flow:
+     * 1. Gets nonce, estimates gas, and gets current fee data
+     * 2. Serializes and signs the transaction
+     * 3. Broadcasts the signed transaction to the network
+     *
+     * @param params - Transaction parameters including destination, data, value and signer
+     * @returns Transaction hash as a hex string
+     *
+     * @example
+     * // Send a simple ETH transfer
+     * const txHash = await evmClient.sendTransaction({
+     *   to: '0xRecipientAddress',
+     *   data: '0x', // empty data for a simple transfer
+     *   value: parseEther('0.01'),
+     *   signer: universalSigner,
+     * });
+     * console.log(`ETH transfer sent: ${txHash}`);
+     */
+    sendTransaction(_a) {
+        return tslib_1.__awaiter(this, arguments, void 0, function* ({ to, data, value = (0, viem_1.parseEther)('0'), signer, }) {
+            const [nonce, gas, feePerGas] = yield Promise.all([
+                this.publicClient.getTransactionCount({
+                    address: signer.address,
+                }),
+                this.publicClient.estimateGas({
+                    account: signer.address,
+                    to,
+                    data,
+                    value,
+                }),
+                this.publicClient.estimateFeesPerGas(),
+            ]);
+            const chainId = yield this.publicClient.getChainId();
+            const unsignedTx = (0, viem_1.serializeTransaction)({
+                chainId,
+                type: 'eip1559',
+                to,
+                data,
+                gas,
+                nonce,
+                maxFeePerGas: feePerGas.maxFeePerGas,
+                maxPriorityFeePerGas: feePerGas.maxPriorityFeePerGas,
+                value,
+            });
+            if (!signer.signTransaction) {
+                throw new Error('signer.signTransaction is undefined');
+            }
+            const signedTx = yield signer.signTransaction((0, viem_1.hexToBytes)(unsignedTx));
+            return this.publicClient.sendRawTransaction({
+                serializedTransaction: (0, viem_1.bytesToHex)(signedTx),
+            });
+        });
+    }
+    /**
+     * Estimates the gas required for a transaction.
+     *
+     * @param params - Parameters including from/to addresses, value and optional data
+     * @returns Estimated gas as a bigint
+     *
+     * @example
+     * // Estimate gas for a simple transfer
+     * const gasEstimate = await evmClient.estimateGas({
+     *   from: '0xSenderAddress',
+     *   to: '0xRecipientAddress',
+     *   value: parseEther('0.01'),
+     * });
+     * console.log(`Estimated gas: ${gasEstimate}`);
+     *
+     * @example
+     * // Estimate gas for a contract interaction
+     * const data = encodeFunctionData({
+     *   abi: parseAbi(['function setGreeting(string)']),
+     *   functionName: 'setGreeting',
+     *   args: ['New greeting'],
+     * });
+     *
+     * const gasEstimate = await evmClient.estimateGas({
+     *   from: universalSigner.address as `0x${string}`,
+     *   to: '0xContractAddress',
+     *   data,
+     *   value: BigInt(0),
+     * });
+     */
+    estimateGas(_a) {
+        return tslib_1.__awaiter(this, arguments, void 0, function* ({ from, to, value, data, }) {
+            return this.publicClient.estimateGas({
+                account: from || undefined,
+                to,
+                value,
+                data,
+            });
+        });
+    }
+    /**
+     * Gets the current gas price on the network.
+     * This is primarily used for legacy transactions, but can be useful
+     * for gas cost estimation in EIP-1559 transactions as well.
+     *
+     * @returns Current gas price in wei as a bigint
+     *
+     * @example
+     * // Get current gas price for cost estimation
+     * const gasPrice = await evmClient.getGasPrice();
+     * console.log(`Current gas price: ${gasPrice} wei`);
+     *
+     * @example
+     * // Calculate total cost of a transaction
+     * const gasPrice = await evmClient.getGasPrice();
+     * const gasEstimate = await evmClient.estimateGas({...});
+     * const totalCost = gasPrice * gasEstimate;
+     * console.log(`Estimated transaction cost: ${totalCost} wei`);
+     */
+    getGasPrice() {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return this.publicClient.getGasPrice();
+        });
+    }
+}
+exports.EvmClient = EvmClient;
+//# sourceMappingURL=evm-client.js.map

package/src/lib/vm-client/evm-client.js.map

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

package/src/lib/vm-client/svm-client.d.ts

@@ -0,0 +1,42 @@
+import { Keypair, TransactionInstruction } from '@solana/web3.js';
+import { ClientOptions, ReadContractParams, WriteContractParams } from './vm-client.types';
+import { UniversalSigner } from '../universal/universal.types';
+/**
+ * Solana-compatible VM client for reading and writing SVM-based chains.
+ */
+export declare class SvmClient {
+    private readonly connection;
+    constructor({ rpcUrl }: ClientOptions);
+    /**
+     * Returns the balance (in lamports) of a Solana address.
+     */
+    getBalance(address: string): Promise<bigint>;
+    /**
+     * Reads a full program account using Anchor IDL.
+     * `functionName` must match the account layout name in the IDL.
+     */
+    readContract<T = unknown>({ abi, functionName, args, }: ReadContractParams): Promise<T>;
+    /**
+     * Sends a Solana transaction using a smart contract instruction.
+     */
+    writeContract({ abi, signer, functionName, args, accounts, extraSigners, }: WriteContractParams): Promise<string>;
+    /**
+     * Sends a set of instructions as a manually-signed Solana transaction.
+     */
+    sendTransaction({ instruction, signer, extraSigners, }: {
+        instruction: TransactionInstruction;
+        signer: UniversalSigner;
+        extraSigners?: Keypair[];
+    }): Promise<string>;
+    /**
+     * Waits for a transaction to be confirmed on the blockchain.
+     */
+    confirmTransaction(signature: string, timeout?: number): Promise<void>;
+    /**
+     * Estimates the fee (in lamports) to send a transaction with the given instructions.
+     */
+    estimateGas({ instructions, signer, }: {
+        instructions: TransactionInstruction[];
+        signer: UniversalSigner;
+    }): Promise<bigint>;
+}

package/src/lib/vm-client/svm-client.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SvmClient = void 0;
+const tslib_1 = require("tslib");
+const web3_js_1 = require("@solana/web3.js");
+const anchor_1 = require("@coral-xyz/anchor");
+/**
+ * Solana-compatible VM client for reading and writing SVM-based chains.
+ */
+class SvmClient {
+    constructor({ rpcUrl }) {
+        this.connection = new web3_js_1.Connection(rpcUrl, 'confirmed');
+    }
+    /**
+     * Returns the balance (in lamports) of a Solana address.
+     */
+    getBalance(address) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const pubkey = new web3_js_1.PublicKey(address);
+            const lamports = yield this.connection.getBalance(pubkey);
+            return BigInt(lamports);
+        });
+    }
+    /**
+     * Reads a full program account using Anchor IDL.
+     * `functionName` must match the account layout name in the IDL.
+     */
+    readContract(_a) {
+        return tslib_1.__awaiter(this, arguments, void 0, function* ({ abi, functionName, args = [], }) {
+            const provider = new anchor_1.AnchorProvider(this.connection, new anchor_1.Wallet(new web3_js_1.Keypair()), { preflightCommitment: 'confirmed' });
+            // Anchor v0.31 constructor no longer takes programId
+            // Use the IDL's embedded metadata.address instead
+            const program = new anchor_1.Program(abi, provider);
+            const pubkey = new web3_js_1.PublicKey(args[0]);
+            // Cast account namespace to any to allow dynamic string
+            const accountNamespace = program.account;
+            const account = yield accountNamespace[functionName].fetch(pubkey);
+            return account;
+        });
+    }
+    /**
+     * Sends a Solana transaction using a smart contract instruction.
+     */
+    writeContract(_a) {
+        return tslib_1.__awaiter(this, arguments, void 0, function* ({ abi, signer, functionName, args = [], accounts = {}, extraSigners = [], }) {
+            const provider = new anchor_1.AnchorProvider(this.connection, new anchor_1.Wallet(new web3_js_1.Keypair()), { preflightCommitment: 'confirmed' });
+            // NEW: Drop explicit programId. Anchor v0.31 infers it from IDL.metadata.address
+            const program = new anchor_1.Program(abi, provider);
+            // Convert BigInt arguments to BN instances for Anchor compatibility. Anchor program expects BN for BigInts
+            const convertedArgs = args.map((arg) => {
+                if (typeof arg === 'bigint') {
+                    return new anchor_1.BN(arg.toString());
+                }
+                return arg;
+            });
+            // Build the method context
+            const methodContext = convertedArgs.length > 0
+                ? program.methods[functionName](...convertedArgs)
+                : program.methods[functionName]();
+            let instructionBuilder = methodContext;
+            if (Object.keys(accounts).length > 0) {
+                instructionBuilder = instructionBuilder.accounts(accounts);
+            }
+            const instruction = yield instructionBuilder.instruction();
+            return this.sendTransaction({
+                instruction,
+                signer,
+                extraSigners,
+            });
+        });
+    }
+    /**
+     * Sends a set of instructions as a manually-signed Solana transaction.
+     */
+    sendTransaction(_a) {
+        return tslib_1.__awaiter(this, arguments, void 0, function* ({ instruction, signer, extraSigners = [], }) {
+            const feePayerPubkey = new web3_js_1.PublicKey(signer.address);
+            const { blockhash, lastValidBlockHeight } = yield this.connection.getLatestBlockhash('finalized');
+            const tx = new web3_js_1.Transaction({
+                feePayer: feePayerPubkey,
+                blockhash,
+                lastValidBlockHeight,
+            }).add(instruction);
+            // Sign with all provided keypairs
+            if (extraSigners.length > 0) {
+                tx.partialSign(...extraSigners);
+            }
+            const messageBytes = tx.serializeMessage();
+            const signature = yield signer.signTransaction(messageBytes);
+            tx.addSignature(feePayerPubkey, Buffer.from(signature));
+            const rawTx = tx.serialize();
+            return yield this.connection.sendRawTransaction(rawTx);
+        });
+    }
+    /**
+     * Waits for a transaction to be confirmed on the blockchain.
+     */
+    confirmTransaction(signature_1) {
+        return tslib_1.__awaiter(this, arguments, void 0, function* (signature, timeout = 30000) {
+            const startTime = Date.now();
+            while (Date.now() - startTime < timeout) {
+                const status = yield this.connection.getSignatureStatus(signature);
+                if (status === null || status === void 0 ? void 0 : status.value) {
+                    if (status.value.err) {
+                        throw new Error(`Transaction failed: ${JSON.stringify(status.value.err)}`);
+                    }
+                    if (status.value.confirmationStatus === 'confirmed' ||
+                        status.value.confirmationStatus === 'finalized') {
+                        return;
+                    }
+                }
+                yield new Promise((r) => setTimeout(r, 500));
+            }
+            throw new Error(`Transaction confirmation timeout after ${timeout}ms`);
+        });
+    }
+    /**
+     * Estimates the fee (in lamports) to send a transaction with the given instructions.
+     */
+    estimateGas(_a) {
+        return tslib_1.__awaiter(this, arguments, void 0, function* ({ instructions, signer, }) {
+            const feePayer = new web3_js_1.PublicKey(signer.address);
+            const { blockhash, lastValidBlockHeight } = yield this.connection.getLatestBlockhash();
+            const tx = new web3_js_1.Transaction({ blockhash, lastValidBlockHeight, feePayer });
+            if (instructions.length)
+                tx.add(...instructions);
+            const message = tx.compileMessage();
+            const feeResp = yield this.connection.getFeeForMessage(message);
+            if (!(feeResp === null || feeResp === void 0 ? void 0 : feeResp.value))
+                throw new Error('Failed to estimate fee');
+            return BigInt(feeResp.value);
+        });
+    }
+}
+exports.SvmClient = SvmClient;
+//# sourceMappingURL=svm-client.js.map

package/src/lib/vm-client/svm-client.js.map

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

package/src/lib/vm-client/vm-client.types.d.ts

@@ -0,0 +1,49 @@
+import { UniversalSigner } from '../universal/universal.types';
+import { Abi } from 'viem';
+import { Keypair, PublicKey } from '@solana/web3.js';
+/**
+ * Common options used by all VM clients (EVM, SVM, etc.)
+ */
+export interface ClientOptions {
+    rpcUrl: string;
+}
+/**
+ * Parameters for reading from a smart contract (read-only call).
+ */
+export interface ReadContractParams {
+    /**
+     * EVM contract address
+     * SVM program id
+     */
+    address: string;
+    /**
+     * EVM abi
+     * SVM idl
+     */
+    abi: Abi | any;
+    /**
+     * EVM contract fn name
+     * SVM PDA var name
+     */
+    functionName: string;
+    /**
+     * EVM fn vars
+     * SVM - undefined
+     */
+    args?: any[];
+}
+/**
+ * Parameters for writing to a smart contract (requires signature).
+ */
+export interface WriteContractParams extends ReadContractParams {
+    value?: bigint;
+    signer: UniversalSigner;
+    /**
+     * **For Solana only** Dynamic accounts to pass to the solana program instruction
+     */
+    accounts?: Record<string, PublicKey>;
+    /**
+     * **For Solana only** Keypairs that should sign the transaction
+     */
+    extraSigners?: Keypair[];
+}

package/src/lib/vm-client/vm-client.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=vm-client.types.js.map

package/src/lib/vm-client/vm-client.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vm-client.types.js","sourceRoot":"","sources":["../../../../../../packages/core/src/lib/vm-client/vm-client.types.ts"],"names":[],"mappings":""}