@dag-kit/kit 1.0.0

package/dist/esm/clients/actions/contract.js

@@ -0,0 +1,42 @@
+export const abi = [
+    {
+        inputs: [],
+        name: "decrement",
+        outputs: [],
+        stateMutability: "nonpayable",
+        type: "function",
+    },
+    {
+        inputs: [],
+        name: "increment",
+        outputs: [],
+        stateMutability: "nonpayable",
+        type: "function",
+    },
+    {
+        inputs: [],
+        name: "getNum",
+        outputs: [
+            {
+                internalType: "uint256",
+                name: "",
+                type: "uint256",
+            },
+        ],
+        stateMutability: "view",
+        type: "function",
+    },
+    {
+        inputs: [],
+        name: "num",
+        outputs: [
+            {
+                internalType: "uint256",
+                name: "",
+                type: "uint256",
+            },
+        ],
+        stateMutability: "view",
+        type: "function",
+    },
+];

package/dist/esm/clients/actions/example.js

@@ -0,0 +1,211 @@
+import { defineChain } from "viem";
+import { createDagAAClient, parseDAG } from "./main";
+import { abi } from "./contract";
+import { config as dotenvConfig } from "dotenv";
+dotenvConfig();
+// ==============================================================================
+// Configuration
+// ==============================================================================
+const awakening = defineChain({
+    id: 1043,
+    name: "Awakening Testnet",
+    nativeCurrency: { decimals: 18, name: "Dag", symbol: "DAG" },
+    rpcUrls: { default: { http: ["https://relay.awakening.bdagscan.com"] } },
+    blockExplorers: {
+        default: { name: "Explorer", url: "https://awakening.bdagscan.com/" },
+    },
+});
+// Your contract ABI
+const counterAbi = [
+    {
+        name: "increment",
+        type: "function",
+        stateMutability: "nonpayable",
+        inputs: [],
+        outputs: [],
+    },
+    {
+        name: "counter",
+        type: "function",
+        stateMutability: "view",
+        inputs: [],
+        outputs: [{ name: "", type: "uint256" }],
+    },
+];
+// ==============================================================================
+// Example 1: Basic Usage
+// ==============================================================================
+const PRIVATE_KEY_1 = process.env.PRIVATE_KEY_2;
+async function basicExample() {
+    console.log("\n📦 Example 1: Basic Usage");
+    console.log("═══════════════════════════\n");
+    // Create the client
+    const client = createDagAAClient({
+        chain: awakening,
+        rpcUrl: "https://relay.awakening.bdagscan.com",
+        bundlerUrl: "http://0.0.0.0:3000",
+        factoryAddress: "0x8FaB6DF00085eb05D5F2C1FA46a6E539587ae3f3",
+    });
+    // Connect to your existing smart account
+    await client.connectSmartAccount({
+        owner: PRIVATE_KEY_1,
+        accountAddress: "0x7fd5385efcB7B2898933288948a9496CDc0fA8ee",
+    });
+    // Get account info
+    const address = client.getAddress();
+    const balance = await client.getBalance();
+    const isDeployed = await client.isDeployed();
+    const nonce = await client.getNonce();
+    console.log(`Address: ${address}`);
+    console.log(`Balance: ${Number(balance) / 1e18} DAG`);
+    console.log(`Deployed: ${isDeployed ? "Yes" : "No"}`);
+    console.log(`Nonce: ${nonce}`);
+}
+// ==============================================================================
+// Example 2: Send Simple Transfer
+// ==============================================================================
+async function transferExample() {
+    console.log("\n💸 Example 2: Send Transfer");
+    console.log("═══════════════════════════\n");
+    const client = createDagAAClient({
+        chain: awakening,
+        rpcUrl: "https://relay.awakening.bdagscan.com",
+        bundlerUrl: "http://0.0.0.0:3000",
+        factoryAddress: "0x8FaB6DF00085eb05D5F2C1FA46a6E539587ae3f3",
+    });
+    await client.connectSmartAccount({
+        owner: PRIVATE_KEY_1,
+        accountAddress: "0x7fd5385efcB7B2898933288948a9496CDc0fA8ee",
+    });
+    // Send 0.01 DAG to an address
+    const txHash = await client.sendUserOperation({
+        target: "0x1749be926ef79a63a285b01263f7ddc350d435e6",
+        value: parseDAG("1"), // 0.01 DAG
+        maxFeePerGas: 50000000000n,
+        maxPriorityFeePerGas: 50000000000n,
+    });
+    console.log(`Transaction: ${txHash}`);
+}
+// ==============================================================================
+// Example 3: Call Smart Contract (Write)
+// ==============================================================================
+async function contractWriteExample() {
+    console.log("\n📝 Example 3: Contract Write");
+    console.log("═══════════════════════════\n");
+    const client = createDagAAClient({
+        chain: awakening,
+        rpcUrl: "https://relay.awakening.bdagscan.com",
+        bundlerUrl: "http://0.0.0.0:3000",
+        factoryAddress: "0x8FaB6DF00085eb05D5F2C1FA46a6E539587ae3f3",
+    });
+    await client.connectSmartAccount({
+        owner: PRIVATE_KEY_1,
+        accountAddress: "0x7fd5385efcB7B2898933288948a9496CDc0fA8ee",
+    });
+    // Call increment() on counter contract
+    const txHash = await client.writeContract({
+        address: "0x692e69cA1Fe89eF72ca94B0E3a32A92835501a08",
+        abi,
+        functionName: "increment",
+        maxFeePerGas: 50000000000n,
+        maxPriorityFeePerGas: 50000000000n,
+    });
+    console.log(`Transaction: ${txHash}`);
+    console.log(`https://awakening.bdagscan.com/tx/${txHash}`);
+}
+// ==============================================================================
+// Example 4: Read Contract Data
+// ==============================================================================
+async function contractReadExample() {
+    console.log("\n🔍 Example 4: Contract Read");
+    console.log("═══════════════════════════\n");
+    const client = createDagAAClient({
+        chain: awakening,
+        rpcUrl: "https://relay.awakening.bdagscan.com",
+        bundlerUrl: "http://0.0.0.0:3000",
+        factoryAddress: "0x8FaB6DF00085eb05D5F2C1FA46a6E539587ae3f3",
+    });
+    await client.connectSmartAccount({
+        owner: PRIVATE_KEY_1,
+        accountAddress: "0x7fd5385efcB7B2898933288948a9496CDc0fA8ee",
+    });
+    // Read counter value
+    const counterValue = await client.readContract({
+        address: "0x692e69cA1Fe89eF72ca94B0E3a32A92835501a08",
+        abi,
+        functionName: "getNum",
+    });
+    console.log(`Counter value: ${counterValue}`);
+}
+// ==============================================================================
+// Example 5: Batch Operations
+// ==============================================================================
+async function batchExample() {
+    console.log("\n📦 Example 5: Batch Operations");
+    console.log("═══════════════════════════\n");
+    const client = createDagAAClient({
+        chain: awakening,
+        rpcUrl: "https://relay.awakening.bdagscan.com",
+        bundlerUrl: "http://0.0.0.0:3000",
+        factoryAddress: "0x8FaB6DF00085eb05D5F2C1FA46a6E539587ae3f3",
+    });
+    await client.connectSmartAccount({
+        owner: PRIVATE_KEY_1,
+        accountAddress: "0x7fd5385efcB7B2898933288948a9496CDc0fA8ee",
+    });
+    // Send multiple operations
+    const hashes = await client.sendBatchUserOperations([
+        {
+            target: "0x1749be926ef79a63a285b01263f7ddc350d435e6",
+            value: parseDAG("0.5"),
+        },
+        {
+            target: "0x8371e519177f81b93287f750dcd06ce894c12cc5",
+            value: parseDAG("0.5"),
+        },
+    ]);
+    console.log(`Sent ${hashes.length} operations`);
+    hashes.forEach((hash, i) => {
+        console.log(`  ${i + 1}. ${hash}`);
+    });
+}
+// ==============================================================================
+// Example 6: Fund Account
+// ==============================================================================
+async function fundingExample() {
+    console.log("\n💰 Example 6: Fund Account");
+    console.log("═══════════════════════════\n");
+    const client = createDagAAClient({
+        chain: awakening,
+        rpcUrl: "https://relay.awakening.bdagscan.com",
+        bundlerUrl: "http://0.0.0.0:3000",
+        factoryAddress: "0x8FaB6DF00085eb05D5F2C1FA46a6E539587ae3f3",
+    });
+    await client.connectSmartAccount({
+        owner: PRIVATE_KEY_1,
+        accountAddress: "0x7fd5385efcB7B2898933288948a9496CDc0fA8ee",
+    });
+    // Fund from EOA
+    const txHash = await client.fundAccount(parseDAG("1"), // 1 DAG
+    "0x5810098e367422376897bb2645c5ada5850a99aeec0505a58d38853ebd7f9f31" // From this private key
+    );
+    console.log(`Funded: ${txHash}`);
+}
+// ==============================================================================
+// Run Examples
+// ==============================================================================
+async function main() {
+    try {
+        // Run the example you want
+        // await basicExample();
+        // await transferExample();
+        // await contractWriteExample();
+        await contractReadExample();
+        // await batchExample();
+        // await fundingExample();
+    }
+    catch (error) {
+        console.error("Error:", error);
+    }
+}
+main();

package/dist/esm/clients/actions/example2.js

@@ -0,0 +1,47 @@
+import { awakening } from "../chains";
+import { createDagAAClient, parseDAG } from "./main";
+import { config as dotenvConfig } from "dotenv";
+dotenvConfig();
+const PRIVATE_KEY_2 = process.env.PRIVATE_KEY_1;
+(async () => {
+    console.log("Sending Simple Transaction");
+    const client = createDagAAClient({
+        chain: awakening.chain_config,
+        rpcUrl: "https://rpc.awakening.bdagscan.com",
+        bundlerUrl: awakening.bundler_rpc,
+        factoryAddress: "0x8FaB6DF00085eb05D5F2C1FA46a6E539587ae3f3",
+    });
+    await client.connectSmartAccount({
+        owner: "0x6b0f66a03b67d7b9eaa6c31123ffe5bf2ee58eb40ab86c8a14d6f1294838b0c8",
+        accountAddress: "0xDe10aaC59f659fA154C063153AB3f7Cca1fb23A5",
+    });
+    // Send 0.01 DAG to an address
+    const txHash = await client.sendUserOperation({
+        target: "0x1749be926ef79a63a285b01263f7ddc350d435e6",
+        value: parseDAG("1"), // 0.01 DAG
+        maxFeePerGas: 50000000000n,
+        maxPriorityFeePerGas: 50000000000n,
+    });
+    console.log(`Transaction: ${txHash}`);
+    console.log("\n📦 Example : Batch Operations");
+    console.log("═══════════════════════════\n");
+    await client.connectSmartAccount({
+        owner: PRIVATE_KEY_2,
+        accountAddress: "0x7fd5385efcB7B2898933288948a9496CDc0fA8ee",
+    });
+    // Send multiple operations
+    const hashes = await client.sendBatchUserOperations([
+        {
+            target: "0x1749be926ef79a63a285b01263f7ddc350d435e6",
+            value: parseDAG("0.5"),
+        },
+        {
+            target: "0x8371e519177f81b93287f750dcd06ce894c12cc5",
+            value: parseDAG("0.5"),
+        },
+    ]);
+    console.log(`Sent ${hashes.length} operations`);
+    hashes.forEach((hash, i) => {
+        console.log(`  ${i + 1}. ${hash}`);
+    });
+})();

package/dist/esm/clients/actions/index.js

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

package/dist/esm/clients/actions/main.js

@@ -0,0 +1,266 @@
+// ==============================================================================
+// DAG AA SDK - BlockDAG Account Abstraction SDK
+// Inspired by Alchemy AA SDK
+// ==============================================================================
+import { createPublicClient, createWalletClient, http, encodeFunctionData, parseEther, } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+import { toSimpleSmartAccount } from "permissionless/accounts";
+import { createPimlicoClient } from "permissionless/clients/pimlico";
+import { entryPoint06Address } from "viem/account-abstraction";
+import { createSmartAccountClient } from "permissionless";
+// ==============================================================================
+// Main SDK Class
+// ==============================================================================
+export class DagAAClient {
+    config;
+    publicClient;
+    walletClient;
+    bundlerClient = null;
+    smartAccount = null;
+    smartAccountClient = null;
+    constructor(config) {
+        this.config = {
+            ...config,
+            entryPointAddress: config.entryPointAddress || entryPoint06Address,
+        };
+        this.publicClient = createPublicClient({
+            chain: config.chain,
+            transport: http(config.rpcUrl),
+        });
+        this.walletClient = createWalletClient({
+            chain: config.chain,
+            transport: http(config.rpcUrl),
+        });
+    }
+    // ==============================================================================
+    // Smart Account Management
+    // ==============================================================================
+    async connectSmartAccount(accountConfig) {
+        const owner = privateKeyToAccount(accountConfig.owner);
+        const signingClient = createWalletClient({
+            account: owner,
+            chain: this.config.chain,
+            transport: http(this.config.rpcUrl),
+        });
+        if (accountConfig.accountAddress) {
+            // Use existing account
+            this.smartAccount = await toSimpleSmartAccount({
+                client: signingClient,
+                owner: owner,
+                factoryAddress: this.config.factoryAddress,
+                entryPoint: {
+                    address: this.config.entryPointAddress,
+                    version: "0.6",
+                },
+                address: accountConfig.accountAddress,
+            });
+        }
+        else {
+            // Create new account
+            this.smartAccount = await toSimpleSmartAccount({
+                client: signingClient,
+                owner: owner,
+                factoryAddress: this.config.factoryAddress,
+                entryPoint: {
+                    address: this.config.entryPointAddress,
+                    version: "0.6",
+                },
+            });
+        }
+        // Create bundler client
+        this.bundlerClient = createPimlicoClient({
+            transport: http(this.config.bundlerUrl),
+            entryPoint: {
+                address: this.config.entryPointAddress,
+                version: "0.6",
+            },
+        });
+        // Create smart account client
+        this.smartAccountClient = createSmartAccountClient({
+            bundlerTransport: http(this.config.bundlerUrl),
+            chain: this.config.chain,
+            account: this.smartAccount,
+        });
+        console.log(`✅ Connected to smart account: ${this.smartAccount.address}`);
+        return this.smartAccount.address;
+    }
+    // ==============================================================================
+    // Account Information
+    // ==============================================================================
+    getAddress() {
+        if (!this.smartAccount) {
+            throw new Error("Smart account not connected. Call connectSmartAccount() first.");
+        }
+        return this.smartAccount.address;
+    }
+    async getBalance() {
+        if (!this.smartAccount) {
+            throw new Error("Smart account not connected");
+        }
+        return await this.publicClient.getBalance({
+            address: this.smartAccount.address,
+        });
+    }
+    async isDeployed() {
+        if (!this.smartAccount) {
+            throw new Error("Smart account not connected");
+        }
+        const code = await this.publicClient.getCode({
+            address: this.smartAccount.address,
+        });
+        return code !== undefined && code !== "0x";
+    }
+    async getNonce() {
+        if (!this.smartAccount) {
+            throw new Error("Smart account not connected");
+        }
+        return await this.publicClient.readContract({
+            address: this.config.entryPointAddress,
+            abi: [
+                {
+                    name: "getNonce",
+                    type: "function",
+                    stateMutability: "view",
+                    inputs: [
+                        { name: "sender", type: "address" },
+                        { name: "key", type: "uint192" },
+                    ],
+                    outputs: [{ name: "nonce", type: "uint256" }],
+                },
+            ],
+            functionName: "getNonce",
+            args: [this.smartAccount.address, 0n],
+        });
+    }
+    // ==============================================================================
+    // Send UserOperations
+    // ==============================================================================
+    async sendUserOperation(params) {
+        if (!this.smartAccountClient) {
+            throw new Error("Smart account not connected");
+        }
+        const { target, data = "0x", value = 0n, maxFeePerGas, maxPriorityFeePerGas, callGasLimit = 150000n, verificationGasLimit = 300000n, preVerificationGas = 100000n, } = params;
+        // Get gas prices if not provided
+        let gasPrices = {
+            maxFeePerGas: maxFeePerGas,
+            maxPriorityFeePerGas: maxPriorityFeePerGas,
+        };
+        if (!maxFeePerGas || !maxPriorityFeePerGas) {
+            const estimatedGas = await this.bundlerClient.getUserOperationGasPrice();
+            gasPrices = {
+                maxFeePerGas: maxFeePerGas || estimatedGas.fast.maxFeePerGas,
+                maxPriorityFeePerGas: maxPriorityFeePerGas || estimatedGas.fast.maxPriorityFeePerGas,
+            };
+        }
+        console.log("Sending UserOperation...");
+        console.log(`  Target: ${target}`);
+        console.log(`  Value: ${value}`);
+        console.log(`  Gas: ${gasPrices.maxFeePerGas} / ${gasPrices.maxPriorityFeePerGas}`);
+        const userOpHash = await this.smartAccountClient.sendTransaction({
+            calls: [
+                {
+                    to: target,
+                    value: value,
+                    data: data,
+                },
+            ],
+            maxFeePerGas: gasPrices.maxFeePerGas,
+            maxPriorityFeePerGas: gasPrices.maxPriorityFeePerGas,
+            callGasLimit,
+            verificationGasLimit,
+            preVerificationGas,
+        });
+        console.log(`✅ UserOperation sent: ${userOpHash}`);
+        return userOpHash;
+    }
+    // ==============================================================================
+    // Contract Interactions
+    // ==============================================================================
+    async writeContract(params) {
+        const { address, abi, functionName, args = [], value = 0n } = params;
+        const data = encodeFunctionData({
+            abi,
+            functionName,
+            args,
+        });
+        return await this.sendUserOperation({
+            target: address,
+            data,
+            value,
+            maxFeePerGas: params.maxFeePerGas,
+            maxPriorityFeePerGas: params.maxPriorityFeePerGas,
+        });
+    }
+    async readContract(params) {
+        return await this.publicClient.readContract({
+            address: params.address,
+            abi: params.abi,
+            functionName: params.functionName,
+            args: params.args || [],
+        });
+    }
+    // ==============================================================================
+    // Utilities
+    // ==============================================================================
+    async waitForUserOperationReceipt(userOpHash, timeout = 30000) {
+        console.log(`Waiting for UserOperation receipt...`);
+        const startTime = Date.now();
+        while (Date.now() - startTime < timeout) {
+            await new Promise((resolve) => setTimeout(resolve, 2000));
+            // In a real implementation, you'd query the bundler for receipt
+            // For now, we'll return a basic receipt structure
+            console.log("Checking for receipt...");
+        }
+        return {
+            userOpHash,
+            success: true,
+        };
+    }
+    async fundAccount(amount, fromPrivateKey) {
+        if (!this.smartAccount) {
+            throw new Error("Smart account not connected");
+        }
+        const signer = privateKeyToAccount(fromPrivateKey);
+        const client = createWalletClient({
+            account: signer,
+            chain: this.config.chain,
+            transport: http(this.config.rpcUrl),
+        });
+        console.log(`Funding account with ${amount} wei...`);
+        const hash = await client.sendTransaction({
+            to: this.smartAccount.address,
+            value: amount,
+        });
+        console.log(`✅ Funded: ${hash}`);
+        return hash;
+    }
+    // ==============================================================================
+    // Batch Operations
+    // ==============================================================================
+    async sendBatchUserOperations(operations) {
+        const results = [];
+        for (const op of operations) {
+            const hash = await this.sendUserOperation(op);
+            results.push(hash);
+        }
+        return results;
+    }
+}
+// ==============================================================================
+// Helper Functions
+// ==============================================================================
+export function createDagAAClient(config) {
+    return new DagAAClient(config);
+}
+export function parseDAG(amount) {
+    return parseEther(amount);
+}
+// ==============================================================================
+// Export Types
+// ==============================================================================
+// export type {
+//   DagAAConfig,
+//   SmartAccountConfig,
+//   SendUserOperationParams,
+//   UserOperationReceipt,
+// };

package/dist/esm/clients/actions/test.js

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

package/dist/esm/clients/chains.js

@@ -0,0 +1,14 @@
+import { defineChain } from "viem";
+const awakening_ = defineChain({
+    id: 1043,
+    name: "Awakening Testnet",
+    nativeCurrency: { decimals: 18, name: "Dag", symbol: "DAG" },
+    rpcUrls: { default: { http: ["https://public-bdag.nownodes.io"] } },
+    blockExplorers: {
+        default: { name: "Explorer", url: "https://awakening.bdagscan.com/" },
+    },
+});
+export const awakening = {
+    bundler_rpc: "http://0.0.0.0:3000/",
+    chain_config: awakening_,
+};

package/dist/esm/clients/types.js

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

package/dist/esm/exports/index.js

@@ -0,0 +1 @@
+export { createDagAAClient, parseDAG } from "../clients/actions/main";

package/dist/esm/script.js

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

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@dag-kit/kit",
+  "version": "1.0.0",
+  "description": "",
+  "author": "Abstract",
+  "license": "MIT",
+  "private": false,
+  "type": "module",
+  "main": "./dist/esm/exports/index.js",
+  "module": "./dist/esm/exports/index.js",
+  "types": "./dist/types/exports/index.d.ts",
+  "typings": "./dist/types/exports/index.d.ts",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "src/**/*.ts",
+    "package.json",
+    "!dist/**/*.tsbuildinfo",
+    "!vitest.config.ts",
+    "!.env",
+    "!src/**/*.test.ts",
+    "!src/**/*.test-d.ts",
+    "!src/__tests__/**/*"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/types/exports/index.d.ts",
+      "require": "./dist/esm/exports/index.js",
+      "import": "./dist/esm/exports/index.js"
+    },
+    "./experimental": {
+      "types": "./dist/types/exports/experimental.d.ts",
+      "import": "./dist/esm/exports/experimental.js",
+      "default": "./dist/esm/exports/experimental.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "dotenv": "^16.6.1",
+    "permissionless": "^0.2.0",
+    "viem": "^2.20.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.10",
+    "tsx": "^3.13.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com:Ayodeji63/blockdag-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/alchemyplatform/aa-sdk/issues"
+  },
+  "homepage": "https://github.com/alchemyplatform/aa-sdk#readme",
+  "scripts": {
+    "prebuild": "tsx ./inject-version.ts",
+    "build": "yarn clean && yarn build:esm && yarn build:types",
+    "build:esm": "tsc --project tsconfig.build.json --outDir ./dist/esm",
+    "build:types": "tsc --project tsconfig.build.json --declarationDir ./dist/types --emitDeclarationOnly --declaration --declarationMap",
+    "clean": "rm -rf ./dist",
+    "test:e2e": "bun test ./src/**/*.e2e.test.*"
+  }
+}