@pushchain/core 0.1.0

package/src/lib/universal/signer/signer.d.ts

@@ -0,0 +1,40 @@
+import { WalletClient, Account } from 'viem';
+import { UniversalSigner } from '../universal.types';
+import { CHAIN } from '../../constants/enums';
+import { Keypair } from '@solana/web3.js';
+/**
+ * Creates a `UniversalSigner` object for signing messages and transactions
+ * on any supported chain.
+ *
+ * @param {Object} params - The signer configuration object.
+ * @param {string} params.address - The signer's address.
+ * @param {(data: Uint8Array) => Promise<Uint8Array>} params.signMessage - Required function to sign messages.
+ * @param {(data: Uint8Array) => Promise<Uint8Array>} [params.signTransaction] - Required function to sign transactions.
+ * @param {CHAIN} params.chain - The chain the signer will operate on.
+ * @returns {UniversalSigner} A signer object with chain metadata.
+ *
+ * @example
+ * const signer = createUniversalSigner({
+ *   chain: CHAIN.ETHEREUM_SEPOLIA
+ *   address: "0xabc...",
+ *   signMessage: async (data) => sign(data),
+ *   signTransaction: async (data) => signRawTx(data),
+ * });
+ */
+export declare function createUniversalSigner({ chain, address, signMessage, signTransaction, signTypedData, }: UniversalSigner): UniversalSigner;
+/**
+ * Creates a UniversalSigner from either a viem WalletClient or Account instance.
+ *
+ * @param {WalletClient | Account} clientOrAccount - The viem WalletClient or Account instance
+ * @param {CHAIN} chain - The chain the signer will operate on
+ * @returns {Promise<UniversalSigner>} A signer object configured for the specified chain
+ */
+export declare function toUniversalFromViem(clientOrAccount: WalletClient | Account, chain: CHAIN): Promise<UniversalSigner>;
+/**
+ * Creates a UniversalSigner from a Solana Keypair.
+ *
+ * @param {Keypair} keypair - The Solana Keypair to create the signer from
+ * @param {CHAIN} chain - The chain the signer will operate on (should be a Solana chain)
+ * @returns {UniversalSigner} A signer object configured for Solana operations
+ */
+export declare function toUniversalFromSolanaKeypair(keypair: Keypair, chain: CHAIN): UniversalSigner;

package/src/lib/universal/signer/signer.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createUniversalSigner = createUniversalSigner;
+exports.toUniversalFromViem = toUniversalFromViem;
+exports.toUniversalFromSolanaKeypair = toUniversalFromSolanaKeypair;
+const tslib_1 = require("tslib");
+const viem_1 = require("viem");
+const account_1 = require("../account/account");
+const enums_1 = require("../../constants/enums");
+const nacl = tslib_1.__importStar(require("tweetnacl"));
+/**
+ * Creates a `UniversalSigner` object for signing messages and transactions
+ * on any supported chain.
+ *
+ * @param {Object} params - The signer configuration object.
+ * @param {string} params.address - The signer's address.
+ * @param {(data: Uint8Array) => Promise<Uint8Array>} params.signMessage - Required function to sign messages.
+ * @param {(data: Uint8Array) => Promise<Uint8Array>} [params.signTransaction] - Required function to sign transactions.
+ * @param {CHAIN} params.chain - The chain the signer will operate on.
+ * @returns {UniversalSigner} A signer object with chain metadata.
+ *
+ * @example
+ * const signer = createUniversalSigner({
+ *   chain: CHAIN.ETHEREUM_SEPOLIA
+ *   address: "0xabc...",
+ *   signMessage: async (data) => sign(data),
+ *   signTransaction: async (data) => signRawTx(data),
+ * });
+ */
+function createUniversalSigner({ chain, address, signMessage, signTransaction, signTypedData, }) {
+    return Object.assign(Object.assign({}, (0, account_1.createUniversalAccount)({ chain, address })), { signMessage,
+        signTransaction,
+        signTypedData });
+}
+/**
+ * Creates a UniversalSigner from either a viem WalletClient or Account instance.
+ *
+ * @param {WalletClient | Account} clientOrAccount - The viem WalletClient or Account instance
+ * @param {CHAIN} chain - The chain the signer will operate on
+ * @returns {Promise<UniversalSigner>} A signer object configured for the specified chain
+ */
+function toUniversalFromViem(clientOrAccount, chain) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        let address;
+        let signMessage;
+        let signTransaction;
+        let signTypedData;
+        if ('getAddresses' in clientOrAccount) {
+            // It's a WalletClient
+            address = (yield clientOrAccount.getAddresses())[0];
+            signMessage = (data) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                const hexSig = yield clientOrAccount.signMessage({
+                    account: clientOrAccount.account || address,
+                    message: { raw: data },
+                });
+                return (0, viem_1.hexToBytes)(hexSig);
+            });
+            signTransaction = (unsignedTx) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                const tx = (0, viem_1.parseTransaction)((0, viem_1.bytesToHex)(unsignedTx));
+                const txHash = yield clientOrAccount.signTransaction(tx);
+                return (0, viem_1.hexToBytes)(txHash);
+            });
+            signTypedData = (_a) => tslib_1.__awaiter(this, [_a], void 0, function* ({ domain, types, primaryType, message, }) {
+                const hexSig = yield clientOrAccount.signTypedData({
+                    domain,
+                    types,
+                    primaryType,
+                    message,
+                    account: clientOrAccount.account || address,
+                });
+                return (0, viem_1.hexToBytes)(hexSig);
+            });
+        }
+        else {
+            // It's an Account
+            if (!clientOrAccount.address ||
+                !clientOrAccount.signMessage ||
+                !clientOrAccount.signTransaction) {
+                throw new Error('Invalid Account instance: missing required properties');
+            }
+            address = clientOrAccount.address;
+            signMessage = (data) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                const hexSig = yield clientOrAccount.signMessage({
+                    message: { raw: data },
+                });
+                return (0, viem_1.hexToBytes)(hexSig);
+            });
+            signTransaction = (unsignedTx) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                const tx = (0, viem_1.parseTransaction)((0, viem_1.bytesToHex)(unsignedTx));
+                const hexSig = yield clientOrAccount.signTransaction(tx);
+                return (0, viem_1.hexToBytes)(hexSig);
+            });
+            signTypedData = (_a) => tslib_1.__awaiter(this, [_a], void 0, function* ({ domain, types, primaryType, message, }) {
+                const hexSig = yield clientOrAccount.signTypedData({
+                    domain,
+                    types,
+                    primaryType,
+                    message,
+                });
+                return (0, viem_1.hexToBytes)(hexSig);
+            });
+        }
+        const universalSigner = {
+            address,
+            chain,
+            signMessage,
+            signTransaction,
+            signTypedData,
+        };
+        return createUniversalSigner(universalSigner);
+    });
+}
+/**
+ * Creates a UniversalSigner from a Solana Keypair.
+ *
+ * @param {Keypair} keypair - The Solana Keypair to create the signer from
+ * @param {CHAIN} chain - The chain the signer will operate on (should be a Solana chain)
+ * @returns {UniversalSigner} A signer object configured for Solana operations
+ */
+function toUniversalFromSolanaKeypair(keypair, chain) {
+    if (chain !== enums_1.CHAIN.SOLANA_MAINNET &&
+        chain !== enums_1.CHAIN.SOLANA_TESTNET &&
+        chain !== enums_1.CHAIN.SOLANA_DEVNET) {
+        throw new Error('Invalid chain for Solana Keypair');
+    }
+    const universalSigner = {
+        address: keypair.publicKey.toBase58(),
+        chain,
+        signMessage: (data) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return nacl.sign.detached(data, keypair.secretKey);
+        }),
+        signTransaction: (unsignedTx) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return nacl.sign.detached(unsignedTx, keypair.secretKey);
+        }),
+    };
+    return createUniversalSigner(universalSigner);
+}
+//# sourceMappingURL=signer.js.map

package/src/lib/universal/signer/signer.js.map

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

package/src/lib/universal/universal.types.d.ts

@@ -0,0 +1,52 @@
+import { TypedData, TypedDataDomain } from 'viem';
+import { CHAIN } from '../constants/enums';
+/**
+ * A chain-agnostic account representation.
+ * Used to represent a wallet address along with its chain context.
+ */
+export interface UniversalAccount {
+    /**
+     * Fully qualified chain (e.g., CHAIN.ETHEREUM_SEPOLIA, CHAIN.SOLANA_DEVNET)
+     */
+    chain: CHAIN;
+    /**
+     * The address on the respective chain (EVM: checksummed, Solana: base58, etc.)
+     */
+    address: string;
+}
+/**
+ * A signer capable of signing messages for a specific chain.
+ * Used to abstract away signing across multiple VM types.
+ */
+export interface UniversalSigner extends UniversalAccount {
+    /**
+     * Signs an arbitrary data, provided as binary data.
+     *
+     * If data is a **string**, you MUST UTF-8 encode it before calling this method.
+     * @param data - The message to sign, as a Uint8Array.
+     * @returns A Promise that resolves to the signature (as a Uint8Array).
+     *
+     * @example
+     * const encoded = new TextEncoder().encode("hello world");
+     * const signature = await signer.signMessage(encoded);
+     */
+    signMessage: (data: Uint8Array) => Promise<Uint8Array>;
+    /**
+     * Signs an typed data, provided as binary data.
+     * @dev !! Only Required for Evm Signers !!
+     *
+     * @param data - The message to sign, as a Uint8Array.
+     * @returns A Promise that resolves to the signature (as a Uint8Array).
+     */
+    signTypedData?: ({ domain, types, primaryType, message, }: {
+        domain: TypedDataDomain;
+        types: TypedData;
+        primaryType: string;
+        message: Record<string, any>;
+    }) => Promise<Uint8Array>;
+    /**
+     * Signs a transaction (unsigned tx bytes).
+     * Used for sending on-chain transactions.
+     */
+    signTransaction: (unsignedTx: Uint8Array) => Promise<Uint8Array>;
+}

package/src/lib/universal/universal.types.js

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

package/src/lib/universal/universal.types.js.map

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

package/src/lib/utils.d.ts

@@ -0,0 +1,53 @@
+import { toChainAgnostic, toUniversal as toUniversalAccount } from './universal/account';
+import { toUniversalFromSolanaKeypair, toUniversalFromViem } from './universal/signer';
+/**
+ * @dev - THESE UTILS ARE EXPORTED TO SDK CONSUMER
+ * @dev - Make sure each exported fn has good comments to help out sdk consumer
+ */
+/**
+ * Utility class for handling CAIP-10 chain-agnostic address formatting
+ * and universal account conversions.
+ */
+export declare class Utils {
+    static account: {
+        /**
+         * Converts a UniversalAccount into a CAIP-10 style address string.
+         *
+         * Format: `namespace:chainId:address`
+         * Namespace is derived from the chain's VM type using VM_NAMESPACE.
+         *
+         * @param {UniversalAccount} account - The account to convert.
+         * @returns {string} A CAIP-10 formatted string.
+         *
+         * @example
+         * Utils.account.toChainAgnostic({
+         *   chain: CHAIN.ETHEREUM_SEPOLIA,
+         *   address: '0xabc'
+         * })
+         * // → 'eip155:11155111:0xabc'
+         */
+        toChainAgnostic: typeof toChainAgnostic;
+        /**
+         * Converts a CAIP-10 formatted string into a UniversalAccount.
+         *
+         * @param {string} caip - A CAIP-10 address string (e.g., 'eip155:1:0xabc...').
+         * @returns {UniversalAccount} The resolved account.
+         * @throws {Error} If the CAIP string is invalid or unsupported.
+         *
+         * @example
+         * Utils.account.toUniversal('eip155:11155111:0xabc...')
+         * // → { chain: CHAIN.ETHEREUM_SEPOLIA, address: '0xabc...' }
+         */
+        toUniversal: typeof toUniversalAccount;
+    };
+    static signer: {
+        /**
+         * Wraps a viem WalletClient into a UniversalSigner.
+         */
+        toUniversalFromViem: typeof toUniversalFromViem;
+        /**
+         * Wraps a Solana Keypair into a UniversalSigner.
+         */
+        toUniversalFromSolanaKeypair: typeof toUniversalFromSolanaKeypair;
+    };
+}

package/src/lib/utils.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Utils = void 0;
+const account_1 = require("./universal/account");
+const signer_1 = require("./universal/signer");
+/**
+ * @dev - THESE UTILS ARE EXPORTED TO SDK CONSUMER
+ * @dev - Make sure each exported fn has good comments to help out sdk consumer
+ */
+/**
+ * Utility class for handling CAIP-10 chain-agnostic address formatting
+ * and universal account conversions.
+ */
+class Utils {
+}
+exports.Utils = Utils;
+Utils.account = {
+    /**
+     * Converts a UniversalAccount into a CAIP-10 style address string.
+     *
+     * Format: `namespace:chainId:address`
+     * Namespace is derived from the chain's VM type using VM_NAMESPACE.
+     *
+     * @param {UniversalAccount} account - The account to convert.
+     * @returns {string} A CAIP-10 formatted string.
+     *
+     * @example
+     * Utils.account.toChainAgnostic({
+     *   chain: CHAIN.ETHEREUM_SEPOLIA,
+     *   address: '0xabc'
+     * })
+     * // → 'eip155:11155111:0xabc'
+     */
+    toChainAgnostic: account_1.toChainAgnostic,
+    /**
+     * Converts a CAIP-10 formatted string into a UniversalAccount.
+     *
+     * @param {string} caip - A CAIP-10 address string (e.g., 'eip155:1:0xabc...').
+     * @returns {UniversalAccount} The resolved account.
+     * @throws {Error} If the CAIP string is invalid or unsupported.
+     *
+     * @example
+     * Utils.account.toUniversal('eip155:11155111:0xabc...')
+     * // → { chain: CHAIN.ETHEREUM_SEPOLIA, address: '0xabc...' }
+     */
+    toUniversal: account_1.toUniversal,
+};
+Utils.signer = {
+    /**
+     * Wraps a viem WalletClient into a UniversalSigner.
+     */
+    toUniversalFromViem: signer_1.toUniversalFromViem,
+    /**
+     * Wraps a Solana Keypair into a UniversalSigner.
+     */
+    toUniversalFromSolanaKeypair: signer_1.toUniversalFromSolanaKeypair,
+};
+//# sourceMappingURL=utils.js.map

package/src/lib/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../../packages/core/src/lib/utils.ts"],"names":[],"mappings":";;;AAAA,iDAG6B;AAC7B,+CAG4B;AAE5B;;;GAGG;AAEH;;;GAGG;AACH,MAAa,KAAK;;AAAlB,sBA6CC;AA5CQ,aAAO,GAAG;IACf;;;;;;;;;;;;;;;OAeG;IACH,eAAe,EAAf,yBAAe;IAEf;;;;;;;;;;OAUG;IACH,WAAW,EAAE,qBAAkB;CAChC,CAAC;AAEK,YAAM,GAAG;IACd;;OAEG;IACH,mBAAmB,EAAnB,4BAAmB;IAEnB;;OAEG;IACH,4BAA4B,EAA5B,qCAA4B;CAC7B,CAAC"}

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

@@ -0,0 +1,173 @@
+import { UniversalSigner } from '../universal/universal.types';
+import { ClientOptions, ReadContractParams, WriteContractParams } from './vm-client.types';
+import { PublicClient, Hex } from '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'
+ * });
+ */
+export declare class EvmClient {
+    publicClient: PublicClient;
+    constructor({ rpcUrl }: ClientOptions);
+    /**
+     * 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: `0x${string}`): Promise<bigint>;
+    /**
+     * 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<T = unknown>({ abi, address, functionName, args, }: ReadContractParams): Promise<T>;
+    /**
+     * 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({ abi, address, functionName, args, value, signer, }: WriteContractParams): Promise<Hex>;
+    /**
+     * 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({ to, data, value, signer, }: {
+        to: `0x${string}`;
+        data: Hex;
+        value?: bigint;
+        signer: UniversalSigner;
+    }): Promise<Hex>;
+    /**
+     * 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({ from, to, value, data, }: {
+        from?: `0x${string}`;
+        to: `0x${string}`;
+        value?: bigint;
+        data?: `0x${string}`;
+    }): Promise<bigint>;
+    /**
+     * 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(): Promise<bigint>;
+}