pay_hash 1.0.0

package/README.md

@@ -0,0 +1,149 @@
+# PayHash SDK
+
+PayHash SDK is a professional TypeScript library designed to streamline blockchain payments, receipt generation, and automated email notifications. Built on top of `viem`, it provides a high-level interface for handling crypto transactions on the Tempo network, while automatically generating PDF receipts and sending them to both organizations and clients via SMTP.
+
+## Key Features
+
+- **Seamless Payments**: Process single or batch token transfers with ease.
+- **Automated Receipts**: Generates professional PDF receipts using Puppeteer and Handlebars.
+- **Email Notifications**: Automatically sends email confirmations with attached PDF receipts.
+- **Customizable Templates**: Fully customizable HTML email and PDF receipt templates.
+- **Batch Processing**: Supports both sequential and parallel batch payments with advanced nonce management.
+- **TypeScript First**: Robust type definitions for a superior developer experience.
+
+## Installation
+
+```bash
+npm install pay_hash viem
+```
+
+## Quick Start
+
+```typescript
+import { PayHashClient } from "pay_hash";
+import { createClient, http, publicActions, walletActions } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+import { tempoTestnet } from "viem/chains";
+import { tempoActions } from "viem/tempo";
+
+// 1. Setup Viem Client
+const client = createClient({
+  account: privateKeyToAccount("0x..."),
+  chain: tempoTestnet,
+  transport: http(),
+})
+  .extend(publicActions)
+  .extend(walletActions)
+  .extend(tempoActions());
+
+// 2. Configure SMTP
+const smtp = {
+  host: "smtp.example.com",
+  port: 587,
+  secure: false,
+  user: "your-user",
+  pass: "your-password",
+};
+
+// 3. Define Email/Receipt Branding
+const emailTemplate = {
+  brandName: "My Brand",
+  primaryColor: "#4F46E5",
+  receiptTitle: "Payment Receipt",
+  subject: "Success! Your Payment Receipt",
+};
+
+// 4. Initialize PayHash SDK
+const payhash = new PayHashClient(client, smtp, emailTemplate);
+
+// 5. Process Payment
+const main = async () => {
+  const result = await payhash.pay({
+    amount: "100.50",
+    token: "0x...", // Token Address
+    orgAddress: "0x...", // Recipient Address
+    orgName: "My Company Inc",
+    orgMail: "billing@mycompany.com",
+    clientMail: "customer@example.com",
+    memo: "Order #789",
+  });
+
+  console.log(result.success ? "Paid!" : "Error: " + result.error);
+};
+
+main();
+```
+
+## Advanced Usage
+
+### Batch Payments
+
+#### Sequential Batch (Safer)
+
+Processes payments one by one, waiting for each to complete.
+
+```typescript
+await payhash.batchPay([params1, params2]);
+```
+
+#### Parallel Batch (Faster)
+
+Sends multiple transactions simultaneously using advanced nonce tracking.
+
+```typescript
+await payhash.batchPayAsync([params1, params2]);
+```
+
+### Customizing Templates
+
+You can provide your own Handlebars (.hbs) files for both emails and PDF receipts.
+
+```typescript
+const emailTemplate = {
+  brandName: "PayHash",
+  // Specify custom template paths
+  pdfTemplatePath: "./templates",
+  pdfTemplateName: "custom-receipt.hbs",
+  emailTemplatePath: "./templates",
+  emailTemplateName: "custom-email.hbs",
+  // Reusable branding
+  primaryColor: "#000",
+  logoUrl: "https://example.com/logo.png",
+};
+```
+
+## API Reference
+
+### `PayHashClient`
+
+- `constructor(client, smtp, template)`: Initializes the SDK.
+- `pay(params)`: Executes a single token transfer, generates a receipt, and sends an email.
+- `batchPay(params[])`: Executes multiple payments sequentially.
+- `batchPayAsync(params[])`: Executes multiple payments in parallel using unique nonces.
+- `verifyTransporter()`: Checks if the SMTP configuration is valid.
+
+## Configuration Types
+
+### `PayParams`
+
+| Property     | Type      | Description                                       |
+| :----------- | :-------- | :------------------------------------------------ |
+| `amount`     | `string`  | The amount to transfer (in human-readable units). |
+| `token`      | `Address` | The ERC20 token contract address.                 |
+| `orgAddress` | `Address` | The organization's wallet address.                |
+| `orgMail`    | `string`  | The organization's support email.                 |
+| `clientMail` | `string`  | The client's email address.                       |
+| `memo`       | `string`  | Optional payment reference.                       |
+
+### `EmailTemplate`
+
+| Property       | Type     | Description                                       |
+| :------------- | :------- | :------------------------------------------------ |
+| `brandName`    | `string` | Your organization's name.                         |
+| `primaryColor` | `string` | Primary hex color for the branding.               |
+| `logoUrl`      | `string` | URL to your organization's logo.                  |
+| `fontFamily`   | `string` | Font family for the PDF (Inter, Roboto, Poppins). |
+
+## License
+
+ISC License.

package/dist/client.js

@@ -0,0 +1,163 @@
+import { parseUnits, stringToHex } from "viem";
+import { generateReceiptPDF } from "./pdf";
+import { createTransporter } from "./mailer";
+import path from "path";
+import { fileURLToPath } from "url";
+import { TEMPO_TESTNET_CHAIN_ID } from "./constants";
+import { renderReceiptHtml } from "./render";
+import { Actions } from "viem/tempo";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const pdfPath = path.join(__dirname, "./receipt.hbs");
+export class PayHashClient {
+    client;
+    transporter;
+    emailTemplate;
+    constructor(client, smtp, emailTemplate) {
+        this.client = client;
+        this.transporter = createTransporter(smtp);
+        this.emailTemplate = emailTemplate;
+    }
+    async verifyTransporter() {
+        return await this.transporter.verify();
+    }
+    // private loadEmailTemplate(filePath: string, fileName: string) {
+    //   const templatePath = path.join(filePath, fileName);
+    //   const html = fs.readFileSync(templatePath, "utf-8");
+    //   return html;
+    // }
+    async pay(params) {
+        try {
+            const [account] = await this.client?.getAddresses();
+            const metadata = await this.client.token.getMetadata({
+                token: params.token,
+            });
+            const tokenName = metadata.symbol;
+            const decimals = metadata.decimals;
+            const chainId = this.client.chain.id;
+            let receipt = null;
+            if (chainId == TEMPO_TESTNET_CHAIN_ID) {
+                receipt = await this.client.token.transferSync({
+                    amount: parseUnits(params.amount, decimals),
+                    memo: stringToHex(params.memo || "0x"),
+                    token: params.token,
+                    to: params.orgAddress,
+                });
+            }
+            if (receipt == null) {
+                throw new Error("Receipt not found");
+            }
+            await this.sendReceiptAndEmail({
+                params: params,
+                receipt: receipt,
+                txHash: receipt.receipt.transactionHash,
+                tokenName: metadata.symbol,
+            });
+            return {
+                success: true,
+                receipt,
+                account,
+            };
+        }
+        catch (error) {
+            console.error("[PayHashClient Error]", error);
+            return {
+                success: false,
+                error: error?.message || "Unknown error occurred",
+            };
+        }
+    }
+    // bathch Pay sync to multiple addresses at once
+    async batchPay(params) {
+        for (const param of params) {
+            await this.pay(param);
+        }
+        return {
+            success: true,
+            message: "Batch payment successful",
+        };
+    }
+    // batch Pay async to multiple addresses at once
+    async batchPayAsync(params) {
+        const [account] = await this.client.getAddresses();
+        // 1️⃣ unique nonce key per tx
+        const nonceKeys = params.map((_, i) => BigInt(i + 1));
+        // 2️⃣ fetch all nonces in parallel
+        const nonces = await Promise.all(nonceKeys.map((nonceKey) => Actions.nonce.getNonce(this.client, { account, nonceKey })));
+        // 3️⃣ send all txs in parallel with per-item error handling
+        const results = await Promise.all(params.map(async (param, i) => {
+            try {
+                const metadata = await this.client.token.getMetadata({
+                    token: param.token,
+                });
+                const decimals = metadata.decimals;
+                const receipt = await Actions.token.transferSync(this.client, {
+                    amount: parseUnits(param.amount, decimals),
+                    to: param.orgAddress,
+                    token: param.token,
+                    // memo: stringToHex(param.memo || "0x"),
+                    nonceKey: nonceKeys[i],
+                    nonce: Number(nonces[i]),
+                });
+                await this.sendReceiptAndEmail({
+                    params: param,
+                    receipt: receipt,
+                    txHash: receipt.receipt.transactionHash,
+                    tokenName: metadata.symbol,
+                });
+                return {
+                    success: true,
+                    index: i,
+                    orgAddress: param.orgAddress,
+                    txHash: receipt.receipt.transactionHash,
+                };
+            }
+            catch (error) {
+                console.error(`[BatchPay Error] index=${i}, org=${param.orgAddress}`, error);
+                return {
+                    success: false,
+                    index: i,
+                    orgAddress: param.orgAddress,
+                    error: error?.message ?? "Unknown error",
+                };
+            }
+        }));
+        return {
+            success: true,
+            results,
+        };
+    }
+    async sendReceiptAndEmail({ params, receipt, txHash, tokenName, }) {
+        /* Generate PDF */
+        const pdf = await generateReceiptPDF(path.join(this.emailTemplate?.pdfTemplatePath ?? __dirname, this.emailTemplate?.pdfTemplateName ?? "receipt.hbs"), {
+            brandName: this.emailTemplate?.brandName ?? params.orgName,
+            primaryColor: this.emailTemplate?.primaryColor ?? "#000",
+            receiptTitle: this.emailTemplate?.receiptTitle ?? "Payment Receipt",
+            amount: params.amount,
+            token: tokenName,
+            txHash,
+            date: new Date().toUTCString(),
+            footerText: this.emailTemplate?.footerText ?? "Powered by PayHash",
+            fontFamily: this.emailTemplate?.fontFamily ?? "Inter",
+            titleFontSize: this.emailTemplate?.titleFontSize ?? 24,
+        });
+        const html = renderReceiptHtml({
+            receipt,
+            template: this.emailTemplate,
+            params,
+            tokenName,
+        });
+        /* Send email */
+        await this.transporter.sendMail({
+            from: `${params.orgName} <${params.orgMail}>`,
+            to: `${params.clientMail}, ${params.orgMail}`,
+            subject: this.emailTemplate?.subject ?? "Payment Receipt",
+            html,
+            attachments: [
+                {
+                    filename: this.emailTemplate?.pdfFileName ?? "receipt.pdf",
+                    content: pdf,
+                },
+            ],
+        });
+    }
+}

package/dist/constants.js

@@ -0,0 +1 @@
+export const TEMPO_TESTNET_CHAIN_ID = 42429;

package/dist/contracts.js

@@ -0,0 +1,2 @@
+export const STABLE_TOKEN = "0x0000000000000000000000000000000000000000"; // Replace with actual address
+export const PAYHASH_CONTRACT = "0x0000000000000000000000000000000000000000"; // Replace with actual address

package/dist/index.js

@@ -0,0 +1,2 @@
+export { PayHashClient } from "./client";
+export * from "./types";

package/dist/mailTemplate.hbs

@@ -0,0 +1,69 @@
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <title>{{receiptTitle}}</title>
+    <style>
+      body, table, td, a { -webkit-text-size-adjust: 100%; -ms-text-size-adjust:
+      100%; } body { margin: 0; padding: 0; font-family: Arial, sans-serif;
+      background-color: #f9f9f9; color: #111; } table { border-collapse:
+      collapse !important; } a { color: inherit; text-decoration: none; }
+      .container { max-width: 600px; margin: 40px auto; background-color:
+      #ffffff; border-radius: 8px; overflow: hidden; box-shadow: 0 4px 12px
+      rgba(0,0,0,0.05); padding: 32px; } .header { text-align: center;
+      border-bottom: 2px solid
+      {{primaryColor}}; padding-bottom: 16px; margin-bottom: 24px; } .header h1
+      { color:
+      {{primaryColor}}; font-size:
+      {{titleFontSize}}px; margin: 0; } .body-content { font-size:
+      {{bodyFontSize}}px; line-height: 1.6; color: #333; } .body-content p {
+      margin-bottom: 16px; } .highlight { font-weight: bold; color:
+      {{primaryColor}}; } .footer { font-size: 12px; color: #777; text-align:
+      center; margin-top: 32px; line-height: 1.4; } .btn { display:
+      inline-block; background-color:
+      {{primaryColor}}; color: #ffffff; padding: 12px 24px; border-radius: 4px;
+      font-weight: 600; margin-top: 16px; }
+    </style>
+  </head>
+  <body>
+    <div class="container">
+      <div class="header">
+        <img src="{{logoUrl}}" alt="{{brandName}}" />
+        <h1>{{receiptTitle}}</h1>
+      </div>
+
+      <div class="body-content">
+        <p>Hello {{payer}},</p>
+        <p class="highlight">
+          You have made a payment of
+          {{amount}}
+          {{token}}
+          to
+          {{brandName}}.
+        </p>
+        <p>
+          Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer nec
+          odio. Praesent libero. Sed cursus ante dapibus diam. Sed nisi. Nulla
+          quis sem at nibh elementum imperdiet. Duis sagittis ipsum. Praesent
+          mauris. Fusce nec tellus sed augue semper porta.
+        </p>
+        <p>
+          Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do
+          eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad
+          minim veniam, quis nostrud exercitation ullamco laboris nisi ut
+          aliquip ex ea commodo consequat.
+        </p>
+
+        <a
+          href="https://explore.tempo.xyz/receipt/{{txHash}}?live=false"
+          class="btn"
+        >View Transaction</a>
+      </div>
+
+      <div class="footer">
+        {{footerText}}
+        &copy;
+        {{year}}
+      </div>
+    </div>
+  </body>
+</html>

package/dist/mailer.js

@@ -0,0 +1,13 @@
+// mailer.ts
+import nodemailer from "nodemailer";
+export function createTransporter(smtp) {
+    return nodemailer.createTransport({
+        host: smtp.host,
+        port: smtp.port,
+        secure: smtp.secure ?? smtp.port === 465,
+        auth: {
+            user: smtp.user,
+            pass: smtp.pass,
+        },
+    });
+}

package/dist/pdf.js

@@ -0,0 +1,19 @@
+import puppeteer from "puppeteer";
+import Handlebars from "handlebars";
+import fs from "fs";
+export async function generateReceiptPDF(templatePath, data) {
+    const html = fs.readFileSync(templatePath, "utf8");
+    const compiled = Handlebars.compile(html);
+    const content = compiled(data);
+    const browser = await puppeteer.launch({
+        args: ["--no-sandbox"],
+    });
+    const page = await browser.newPage();
+    await page.setContent(content, { waitUntil: "networkidle0" });
+    const pdf = await page.pdf({
+        format: "A4",
+        printBackground: true,
+    });
+    await browser.close();
+    return pdf;
+}

package/dist/receipt.hbs

@@ -0,0 +1,53 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8" />
+  <style>
+    body {
+      font-family: {{fontFamily}};
+      padding: 32px;
+      color: #111;
+    }
+
+    .header {
+      border-bottom: 2px solid {{primaryColor}};
+      margin-bottom: 24px;
+    }
+
+    .title {
+      font-size: {{titleFontSize}}px;
+      color: {{primaryColor}};
+    }
+
+    .row {
+      margin: 8px 0;
+    }
+
+    .label {
+      font-weight: bold;
+    }
+
+    footer {
+      margin-top: 32px;
+      font-size: 12px;
+      opacity: 0.7;
+    }
+  </style>
+</head>
+
+<body>
+  <div class="header">
+    <h1 class="title">{{receiptTitle}}</h1>
+  </div>
+
+  <div class="row"><span class="label">Brand:</span> {{brandName}}</div>
+  <div class="row"><span class="label">Amount:</span> {{amount}}</div>
+  <div class="row"><span class="label">Token:</span> {{token}}</div>
+  <div class="row"><span class="label">Transaction:</span> {{txHash}}</div>
+  <div class="row"><span class="label">Date:</span> {{date}}</div>
+
+  <footer>
+    {{footerText}}
+  </footer>
+</body>
+</html>

package/dist/render.js

@@ -0,0 +1,24 @@
+import Handlebars from "handlebars";
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+export function renderReceiptHtml({ receipt, template, params, tokenName, }) {
+    const templateSource = fs.readFileSync(path.join(template.emailTemplatePath ?? __dirname, template.emailTemplateName ?? "mailTemplate.hbs"), "utf8");
+    const templates = Handlebars.compile(templateSource);
+    return templates({
+        brandName: template.brandName || params.orgName,
+        logoUrl: template.logoUrl || "",
+        primaryColor: template.primaryColor || "#b5a8b0ff",
+        titleFontSize: template.titleFontSize || 20,
+        bodyFontSize: template.bodyFontSize || 14,
+        receiptTitle: template.subject || "Payment Receipt",
+        footerText: template.footerText || "Powered by PayHash",
+        txHash: receipt.transactionHash,
+        payer: receipt.from,
+        timestamp: new Date(receipt.timestamp).toUTCString(),
+        year: new Date().getFullYear(),
+        amount: params.amount,
+        token: tokenName,
+    });
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/utils.js

@@ -0,0 +1 @@
+"use strict";

package/dist/viem.config.js

@@ -0,0 +1,12 @@
+import { createClient, http, publicActions, walletActions } from 'viem';
+import { privateKeyToAccount } from 'viem/accounts';
+import { tempoTestnet } from 'viem/chains';
+import { tempoActions } from 'viem/tempo';
+export const client = createClient({
+    account: privateKeyToAccount('0x...'),
+    chain: tempoTestnet,
+    transport: http(),
+})
+    .extend(publicActions)
+    .extend(walletActions)
+    .extend(tempoActions());

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "pay_hash",
+  "version": "1.0.0",
+  "description": "PayHash SDK is a professional TypeScript library designed to streamline blockchain payments, receipt generation, and automated email notifications",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc && npm run copy-templates",
+    "copy-templates": "cpy 'src/**/*.hbs' 'dist'",
+    "dev": "tsc --watch"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "type": "module",
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "@types/nodemailer": "^6.4.14",
+    "cpy-cli": "^6.0.0",
+    "eslint": "^8.57.0",
+    "tsup": "^8.5.1",
+    "tsx": "^4.7.0",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "dotenv": "^16.4.5",
+    "express": "^4.19.2",
+    "handlebars": "^4.7.8",
+    "nodemailer": "7.0.12",
+    "puppeteer": "^22.8.2",
+    "viem": "^2.43.5",
+    "zod": "^3.23.8"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/src/client.ts

@@ -0,0 +1,219 @@
+import { parseUnits, stringToHex } from "viem";
+import {
+  PayHashViemClient,
+  PayParams,
+  EmailTemplate,
+  SMTPConfig,
+} from "./types";
+import { generateReceiptPDF } from "./pdf";
+import { createTransporter } from "./mailer";
+import nodemailer from "nodemailer";
+import path from "path";
+import { fileURLToPath } from "url";
+import { TEMPO_TESTNET_CHAIN_ID } from "./constants";
+import fs from "fs";
+import { renderReceiptHtml } from "./render";
+import { Actions } from "viem/tempo";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+const pdfPath = path.join(__dirname, "./receipt.hbs");
+
+export class PayHashClient {
+  private client: PayHashViemClient;
+  private transporter: nodemailer.Transporter;
+  private emailTemplate: EmailTemplate;
+
+  constructor(
+    client: PayHashViemClient,
+    smtp: SMTPConfig,
+    emailTemplate: EmailTemplate
+  ) {
+    this.client = client;
+    this.transporter = createTransporter(smtp);
+    this.emailTemplate = emailTemplate;
+  }
+
+  async verifyTransporter() {
+    return await this.transporter.verify();
+  }
+
+  // private loadEmailTemplate(filePath: string, fileName: string) {
+  //   const templatePath = path.join(filePath, fileName);
+  //   const html = fs.readFileSync(templatePath, "utf-8");
+  //   return html;
+  // }
+
+  async pay(params: PayParams) {
+    try {
+      const [account] = await this.client?.getAddresses();
+      const metadata = await this.client.token.getMetadata({
+        token: params.token,
+      });
+      const tokenName = metadata.symbol;
+      const decimals = metadata.decimals;
+      const chainId = this.client.chain.id;
+      let receipt: Actions.token.transferSync.ReturnValue | null = null;
+      if (chainId == TEMPO_TESTNET_CHAIN_ID) {
+        receipt = await this.client.token.transferSync({
+          amount: parseUnits(params.amount, decimals),
+          memo: stringToHex(params.memo || "0x"),
+          token: params.token,
+          to: params.orgAddress,
+        });
+      }
+      if (receipt == null) {
+        throw new Error("Receipt not found");
+      }
+
+      await this.sendReceiptAndEmail({
+        params: params,
+        receipt: receipt,
+        txHash: receipt.receipt.transactionHash,
+        tokenName: metadata.symbol,
+      });
+
+      return {
+        success: true,
+        receipt,
+        account,
+      };
+    } catch (error: any) {
+      console.error("[PayHashClient Error]", error);
+      return {
+        success: false,
+        error: error?.message || "Unknown error occurred",
+      };
+    }
+  }
+
+  // bathch Pay sync to multiple addresses at once
+  async batchPay(params: PayParams[]) {
+    for (const param of params) {
+      await this.pay(param);
+    }
+    return {
+      success: true,
+      message: "Batch payment successful",
+    };
+  }
+
+  // batch Pay async to multiple addresses at once
+  async batchPayAsync(params: PayParams[]) {
+    const [account] = await this.client.getAddresses();
+
+    // 1️⃣ unique nonce key per tx
+    const nonceKeys = params.map((_, i) => BigInt(i + 1));
+
+    // 2️⃣ fetch all nonces in parallel
+    const nonces = await Promise.all(
+      nonceKeys.map((nonceKey) =>
+        Actions.nonce.getNonce(this.client, { account, nonceKey })
+      )
+    );
+
+    // 3️⃣ send all txs in parallel with per-item error handling
+    const results = await Promise.all(
+      params.map(async (param, i) => {
+        try {
+          const metadata = await this.client.token.getMetadata({
+            token: param.token,
+          });
+
+          const decimals = metadata.decimals;
+
+          const receipt = await Actions.token.transferSync(this.client, {
+            amount: parseUnits(param.amount, decimals),
+            to: param.orgAddress,
+            token: param.token,
+            // memo: stringToHex(param.memo || "0x"),
+            nonceKey: nonceKeys[i],
+            nonce: Number(nonces[i]),
+          });
+
+          await this.sendReceiptAndEmail({
+            params: param,
+            receipt: receipt,
+            txHash: receipt.receipt.transactionHash,
+            tokenName: metadata.symbol,
+          });
+
+          return {
+            success: true,
+            index: i,
+            orgAddress: param.orgAddress,
+            txHash: receipt.receipt.transactionHash,
+          };
+        } catch (error: any) {
+          console.error(
+            `[BatchPay Error] index=${i}, org=${param.orgAddress}`,
+            error
+          );
+
+          return {
+            success: false,
+            index: i,
+            orgAddress: param.orgAddress,
+            error: error?.message ?? "Unknown error",
+          };
+        }
+      })
+    );
+
+    return {
+      success: true,
+      results,
+    };
+  }
+  private async sendReceiptAndEmail({
+    params,
+    receipt,
+    txHash,
+    tokenName,
+  }: {
+    params: PayParams;
+    receipt: Actions.token.transferSync.ReturnValue;
+    txHash: `0x${string}`;
+    tokenName: string;
+  }) {
+    /* Generate PDF */
+    const pdf = await generateReceiptPDF(
+      path.join(
+        this.emailTemplate?.pdfTemplatePath ?? __dirname,
+        this.emailTemplate?.pdfTemplateName ?? "receipt.hbs"
+      ),
+      {
+        brandName: this.emailTemplate?.brandName ?? params.orgName,
+        primaryColor: this.emailTemplate?.primaryColor ?? "#000",
+        receiptTitle: this.emailTemplate?.receiptTitle ?? "Payment Receipt",
+        amount: params.amount,
+        token: tokenName,
+        txHash,
+        date: new Date().toUTCString(),
+        footerText: this.emailTemplate?.footerText ?? "Powered by PayHash",
+        fontFamily: this.emailTemplate?.fontFamily ?? "Inter",
+        titleFontSize: this.emailTemplate?.titleFontSize ?? 24,
+      }
+    );
+
+    const html = renderReceiptHtml({
+      receipt,
+      template: this.emailTemplate,
+      params,
+      tokenName,
+    });
+
+    /* Send email */
+    await this.transporter.sendMail({
+      from: `${params.orgName} <${params.orgMail}>`,
+      to: `${params.clientMail}, ${params.orgMail}`,
+      subject: this.emailTemplate?.subject ?? "Payment Receipt",
+      html,
+      attachments: [
+        {
+          filename: this.emailTemplate?.pdfFileName ?? "receipt.pdf",
+          content: pdf,
+        },
+      ],
+    });
+  }
+}

package/src/constants.ts

@@ -0,0 +1 @@
+export const TEMPO_TESTNET_CHAIN_ID = 42429;

package/src/contracts.ts

@@ -0,0 +1,4 @@
+import { Address } from "viem";
+
+export const STABLE_TOKEN: Address = "0x0000000000000000000000000000000000000000"; // Replace with actual address
+export const PAYHASH_CONTRACT: Address = "0x0000000000000000000000000000000000000000"; // Replace with actual address

package/src/index.ts

@@ -0,0 +1,2 @@
+export { PayHashClient } from "./client";
+export * from "./types";

package/src/mailTemplate.hbs

@@ -0,0 +1,69 @@
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <title>{{receiptTitle}}</title>
+    <style>
+      body, table, td, a { -webkit-text-size-adjust: 100%; -ms-text-size-adjust:
+      100%; } body { margin: 0; padding: 0; font-family: Arial, sans-serif;
+      background-color: #f9f9f9; color: #111; } table { border-collapse:
+      collapse !important; } a { color: inherit; text-decoration: none; }
+      .container { max-width: 600px; margin: 40px auto; background-color:
+      #ffffff; border-radius: 8px; overflow: hidden; box-shadow: 0 4px 12px
+      rgba(0,0,0,0.05); padding: 32px; } .header { text-align: center;
+      border-bottom: 2px solid
+      {{primaryColor}}; padding-bottom: 16px; margin-bottom: 24px; } .header h1
+      { color:
+      {{primaryColor}}; font-size:
+      {{titleFontSize}}px; margin: 0; } .body-content { font-size:
+      {{bodyFontSize}}px; line-height: 1.6; color: #333; } .body-content p {
+      margin-bottom: 16px; } .highlight { font-weight: bold; color:
+      {{primaryColor}}; } .footer { font-size: 12px; color: #777; text-align:
+      center; margin-top: 32px; line-height: 1.4; } .btn { display:
+      inline-block; background-color:
+      {{primaryColor}}; color: #ffffff; padding: 12px 24px; border-radius: 4px;
+      font-weight: 600; margin-top: 16px; }
+    </style>
+  </head>
+  <body>
+    <div class="container">
+      <div class="header">
+        <img src="{{logoUrl}}" alt="{{brandName}}" />
+        <h1>{{receiptTitle}}</h1>
+      </div>
+
+      <div class="body-content">
+        <p>Hello {{payer}},</p>
+        <p class="highlight">
+          You have made a payment of
+          {{amount}}
+          {{token}}
+          to
+          {{brandName}}.
+        </p>
+        <p>
+          Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer nec
+          odio. Praesent libero. Sed cursus ante dapibus diam. Sed nisi. Nulla
+          quis sem at nibh elementum imperdiet. Duis sagittis ipsum. Praesent
+          mauris. Fusce nec tellus sed augue semper porta.
+        </p>
+        <p>
+          Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do
+          eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad
+          minim veniam, quis nostrud exercitation ullamco laboris nisi ut
+          aliquip ex ea commodo consequat.
+        </p>
+
+        <a
+          href="https://explore.tempo.xyz/receipt/{{txHash}}?live=false"
+          class="btn"
+        >View Transaction</a>
+      </div>
+
+      <div class="footer">
+        {{footerText}}
+        &copy;
+        {{year}}
+      </div>
+    </div>
+  </body>
+</html>

package/src/mailer.ts

@@ -0,0 +1,15 @@
+// mailer.ts
+import nodemailer from "nodemailer";
+import { SMTPConfig } from "./types";
+
+export function createTransporter(smtp: SMTPConfig) {
+  return nodemailer.createTransport({
+    host: smtp.host,
+    port: smtp.port,
+    secure: smtp.secure ?? smtp.port === 465,
+    auth: {
+      user: smtp.user,
+      pass: smtp.pass,
+    },
+  });
+}

package/src/pdf.ts

@@ -0,0 +1,27 @@
+import puppeteer from "puppeteer";
+import Handlebars from "handlebars";
+import fs from "fs";
+
+export async function generateReceiptPDF(
+  templatePath: string,
+  data: Record<string, any>
+): Promise<Buffer> {
+  const html = fs.readFileSync(templatePath, "utf8");
+  const compiled = Handlebars.compile(html);
+  const content = compiled(data);
+
+  const browser = await puppeteer.launch({
+    args: ["--no-sandbox"],
+  });
+
+  const page = await browser.newPage();
+  await page.setContent(content, { waitUntil: "networkidle0" });
+
+  const pdf = await page.pdf({
+    format: "A4",
+    printBackground: true,
+  });
+
+  await browser.close();
+  return pdf;
+}

package/src/receipt.hbs

@@ -0,0 +1,53 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8" />
+  <style>
+    body {
+      font-family: {{fontFamily}};
+      padding: 32px;
+      color: #111;
+    }
+
+    .header {
+      border-bottom: 2px solid {{primaryColor}};
+      margin-bottom: 24px;
+    }
+
+    .title {
+      font-size: {{titleFontSize}}px;
+      color: {{primaryColor}};
+    }
+
+    .row {
+      margin: 8px 0;
+    }
+
+    .label {
+      font-weight: bold;
+    }
+
+    footer {
+      margin-top: 32px;
+      font-size: 12px;
+      opacity: 0.7;
+    }
+  </style>
+</head>
+
+<body>
+  <div class="header">
+    <h1 class="title">{{receiptTitle}}</h1>
+  </div>
+
+  <div class="row"><span class="label">Brand:</span> {{brandName}}</div>
+  <div class="row"><span class="label">Amount:</span> {{amount}}</div>
+  <div class="row"><span class="label">Token:</span> {{token}}</div>
+  <div class="row"><span class="label">Transaction:</span> {{txHash}}</div>
+  <div class="row"><span class="label">Date:</span> {{date}}</div>
+
+  <footer>
+    {{footerText}}
+  </footer>
+</body>
+</html>

package/src/render.ts

@@ -0,0 +1,42 @@
+import Handlebars from "handlebars";
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+import { PayParams, EmailTemplate } from "./types";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+export function renderReceiptHtml({
+  receipt,
+  template,
+  params,
+  tokenName,
+}: {
+  receipt: any;
+  template: EmailTemplate;
+  params: PayParams;
+  tokenName: string;
+}) {
+  const templateSource = fs.readFileSync(
+    path.join(
+      template.emailTemplatePath ?? __dirname,
+      template.emailTemplateName ?? "mailTemplate.hbs"
+    ),
+    "utf8"
+  );
+  const templates = Handlebars.compile(templateSource);
+  return templates({
+    brandName: template.brandName || params.orgName,
+    logoUrl: template.logoUrl || "",
+    primaryColor: template.primaryColor || "#b5a8b0ff",
+    titleFontSize: template.titleFontSize || 20,
+    bodyFontSize: template.bodyFontSize || 14,
+    receiptTitle: template.subject || "Payment Receipt",
+    footerText: template.footerText || "Powered by PayHash",
+    txHash: receipt.transactionHash,
+    payer: receipt.from,
+    timestamp: new Date(receipt.timestamp).toUTCString(),
+    year: new Date().getFullYear(),
+    amount: params.amount,
+    token: tokenName,
+  });
+}

package/src/types.ts

@@ -0,0 +1,74 @@
+import {
+  WalletActions,
+  PublicActions,
+  Transport,
+  Chain,
+  Account,
+  Client,
+  RpcSchema,
+  Address,
+  Hex,
+  WalletClient,
+  PublicClient,
+} from "viem";
+import { TempoActions } from "viem/tempo";
+
+export type PayHashViemClient = WalletClient<Transport,Chain, Account> & WalletActions<Chain, Account> & PublicActions<Transport, Chain> &
+  TempoActions<Chain, Account> &
+  Omit<Client<Transport, Chain, Account, RpcSchema>, "cacheTime">;
+
+export interface PayHashSDKConfig {
+  client: PayHashViemClient;
+}
+
+export interface PayParams {
+  token: Address;
+  amount: string; // already in token decimals
+  memo: Hex;
+  orgAddress: Address;
+  orgName:string,
+  orgMail:string,
+  clientMail:string,
+  additionalInfo?: Hex;
+}
+
+export interface SMTPConfig {
+  host: string;
+  port: number;
+  secure?: boolean;
+  user: string;
+  pass: string;
+}
+
+export type EmailTemplate = {
+  pdfFileName?: string;
+  pdfTemplatePath?: string;
+  pdfTemplateName?: string;
+  emailTemplatePath?: string;
+  emailTemplateName?: string;
+  subject?: string;
+  brandName: string;
+  logoUrl?: string;
+
+  // Colors
+  primaryColor?: string;
+  secondaryColor?: string;
+  backgroundColor?: string;
+  textColor?: string;
+
+  // Typography
+  fontFamily?: "inter" | "roboto" | "poppins";
+  titleFontSize?: number; // px
+  bodyFontSize?: number; // px
+  footerFontSize?: number; // px
+
+  // Layout
+  layout?: "compact" | "standard" | "spacious";
+  align?: "left" | "center";
+
+  // Content
+  receiptTitle?: string;
+  footerText?: string;
+  showTxHash?: boolean;
+  showTimestamp?: boolean;
+};

package/src/viem.config.ts

@@ -0,0 +1,13 @@
+import { createClient, http, publicActions, walletActions } from 'viem'
+import { privateKeyToAccount } from 'viem/accounts'
+import { tempoTestnet } from 'viem/chains'
+import { tempoActions } from 'viem/tempo'
+ 
+export const client = createClient({
+  account: privateKeyToAccount('0x...'),
+  chain: tempoTestnet,
+  transport: http(),
+})
+  .extend(publicActions)
+  .extend(walletActions)
+  .extend(tempoActions())

package/tsconfig.json

@@ -0,0 +1,40 @@
+// {
+//   "compilerOptions": {
+//     "target": "es2022",
+//     "module": "commonjs",
+//     "lib": ["es2022", "dom"],
+//     "skipLibCheck": true,
+//     "strict": true,
+//     "esModuleInterop": true
+//   }
+// }
+
+{
+  "compilerOptions": {
+    "target": "es2022",
+    "module": "ESNext",
+    "lib": ["es2022", "dom"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "moduleResolution": "node"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules"]
+}
+// {
+//   "compilerOptions": {
+//     "target": "ES2020",
+//     "module": "ESNext",
+//     "moduleResolution": "Node",
+//     "outDir": "dist",
+//     "declaration": true,
+//     "strict": true,
+//     "esModuleInterop": true,
+//     "skipLibCheck": true
+//   },
+//   "include": ["src"]
+// }