@dag-kit/kit 1.0.0 → 1.0.4-alpha.3

package/dist/index.d.cts

@@ -0,0 +1,209 @@
+import * as viem from 'viem';
+import { LocalAccount, WalletClient, Chain, Address, Hash } from 'viem';
+export { Address, Chain, Hash } from 'viem';
+
+/**
+ * Common interface for all signers
+ * This allows users to plug in different signing methods
+ */
+interface ISigner {
+    /**
+     * Get the viem Account object for signing
+     */
+    getAccount(): LocalAccount | Promise<LocalAccount>;
+    /**
+     * Get the wallet client for transactions
+     */
+    getWalletClient(): WalletClient | Promise<WalletClient>;
+    /**
+     * Get the signer's address
+     */
+    getAddress(): `0x${string}` | Promise<`0x${string}`>;
+    /**
+     * Check if signer is ready/connected
+     */
+    isReady(): boolean | Promise<boolean>;
+}
+
+interface DagAAConfig {
+    chain: Chain;
+    rpcUrl: string;
+    bundlerUrl: string;
+    factoryAddress: Address;
+    entryPointAddress?: Address;
+    paymasterUrl?: string;
+}
+interface SmartAccountConfig {
+    signer: ISigner;
+    accountAddress?: Address;
+}
+interface SendUserOperationParams {
+    target: Address;
+    data?: `0x${string}`;
+    value?: bigint;
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
+    callGasLimit?: bigint;
+    verificationGasLimit?: bigint;
+    preVerificationGas?: bigint;
+}
+interface UserOperationReceipt {
+    userOpHash: Hash;
+    transactionHash?: Hash;
+    success: boolean;
+    blockNumber?: bigint;
+    blockHash?: Hash;
+}
+
+declare class DagAAClient {
+    private config;
+    private publicClient;
+    private walletClient;
+    private bundlerClient;
+    private smartAccount;
+    private paymasterClient;
+    private smartAccountClient;
+    constructor(config: DagAAConfig);
+    private createPaymasterClient;
+    connectSmartAccount(accountConfig: SmartAccountConfig): Promise<Address>;
+    getAddress(): Address;
+    getBalance(): Promise<bigint>;
+    isDeployed(): Promise<boolean>;
+    getNonce(): Promise<bigint>;
+    sendUserOperation(params: SendUserOperationParams): Promise<Hash>;
+    writeContract(params: {
+        address: Address;
+        abi: any[];
+        functionName: string;
+        args?: any[];
+        value?: bigint;
+        maxFeePerGas?: bigint;
+        maxPriorityFeePerGas?: bigint;
+    }): Promise<Hash>;
+    readContract(params: {
+        address: Address;
+        abi: any[];
+        functionName: string;
+        args?: any[];
+    }): Promise<any>;
+    waitForUserOperationReceipt(userOpHash: Hash, timeout?: number): Promise<UserOperationReceipt>;
+    fundAccount(amount: bigint, fromPrivateKey: `0x${string}`): Promise<Hash>;
+    sendBatchUserOperations(operations: SendUserOperationParams[]): Promise<Hash[]>;
+}
+declare function createDagAAClient(config: DagAAConfig): DagAAClient;
+declare function parseDAG(amount: string): bigint;
+
+declare const awakening: {
+    bundler_rpc: string;
+    chain_config: {
+        blockExplorers: {
+            readonly default: {
+                readonly name: "Explorer";
+                readonly url: "https://awakening.bdagscan.com/";
+            };
+        };
+        contracts?: viem.Prettify<{
+            [key: string]: viem.ChainContract | {
+                [sourceId: number]: viem.ChainContract | undefined;
+            } | undefined;
+        } & {
+            ensRegistry?: viem.ChainContract | undefined;
+            ensUniversalResolver?: viem.ChainContract | undefined;
+            multicall3?: viem.ChainContract | undefined;
+            universalSignatureVerifier?: viem.ChainContract | undefined;
+        }> | undefined;
+        ensTlds?: readonly string[] | undefined;
+        id: 1043;
+        name: "Awakening Testnet";
+        nativeCurrency: {
+            readonly decimals: 18;
+            readonly name: "Dag";
+            readonly symbol: "DAG";
+        };
+        rpcUrls: {
+            readonly default: {
+                readonly http: readonly ["https://public-bdag.nownodes.io"];
+            };
+        };
+        sourceId?: number | undefined;
+        testnet?: boolean | undefined;
+        custom?: Record<string, unknown>;
+        fees?: viem.ChainFees<undefined>;
+        formatters?: undefined;
+        serializers?: viem.ChainSerializers<undefined, viem.TransactionSerializable>;
+    };
+};
+declare const arbitrumSep: {
+    bundler_rpc: string;
+    chain_config: {
+        blockExplorers: {
+            readonly default: {
+                readonly name: "Arbiscan";
+                readonly url: "https://sepolia.arbiscan.io";
+                readonly apiUrl: "https://api-sepolia.arbiscan.io/api";
+            };
+        };
+        contracts: {
+            readonly multicall3: {
+                readonly address: "0xca11bde05977b3631167028862be2a173976ca11";
+                readonly blockCreated: 81930;
+            };
+        };
+        ensTlds?: readonly string[] | undefined;
+        id: 421614;
+        name: "Arbitrum Sepolia";
+        nativeCurrency: {
+            readonly name: "Arbitrum Sepolia Ether";
+            readonly symbol: "ETH";
+            readonly decimals: 18;
+        };
+        rpcUrls: {
+            readonly default: {
+                readonly http: readonly ["https://sepolia-rollup.arbitrum.io/rpc"];
+            };
+        };
+        sourceId?: number | undefined | undefined;
+        testnet: true;
+        custom?: Record<string, unknown> | undefined;
+        fees?: viem.ChainFees<undefined> | undefined;
+        formatters?: undefined;
+        serializers?: viem.ChainSerializers<undefined, viem.TransactionSerializable> | undefined;
+    };
+};
+
+/**
+ * Privy Signer - Works with Privy's embedded wallets
+ *
+ * Usage in React:
+ * ```tsx
+ * import { useWallets } from '@privy-io/react-auth';
+ *
+ * const { wallets } = useWallets();
+ * const embeddedWallet = wallets.find(w => w.walletClientType === 'privy');
+ *
+ * const signer = new PrivySigner(embeddedWallet, chain);
+ * ```
+ */
+declare class PrivySigner implements ISigner {
+    private privyWallet;
+    private chain;
+    private cachedAddress?;
+    private cachedWalletClient;
+    constructor(privyWallet: any, chain: Chain);
+    getAccount(): Promise<LocalAccount>;
+    getWalletClient(): Promise<WalletClient>;
+    getAddress(): Promise<`0x${string}`>;
+    isReady(): Promise<boolean>;
+}
+
+declare class PrivateKeySigner implements ISigner {
+    private account;
+    private walletClient;
+    constructor(privateKey: `0x${string}`, chain: Chain, rpcUrl: string);
+    getAccount(): LocalAccount;
+    getWalletClient(): WalletClient;
+    getAddress(): `0x${string}`;
+    isReady(): boolean;
+}
+
+export { DagAAClient, type DagAAConfig, type ISigner, PrivateKeySigner, PrivySigner, type SendUserOperationParams, type SmartAccountConfig, type UserOperationReceipt, arbitrumSep, awakening, createDagAAClient, parseDAG };

package/dist/index.d.ts

@@ -0,0 +1,209 @@
+import * as viem from 'viem';
+import { LocalAccount, WalletClient, Chain, Address, Hash } from 'viem';
+export { Address, Chain, Hash } from 'viem';
+
+/**
+ * Common interface for all signers
+ * This allows users to plug in different signing methods
+ */
+interface ISigner {
+    /**
+     * Get the viem Account object for signing
+     */
+    getAccount(): LocalAccount | Promise<LocalAccount>;
+    /**
+     * Get the wallet client for transactions
+     */
+    getWalletClient(): WalletClient | Promise<WalletClient>;
+    /**
+     * Get the signer's address
+     */
+    getAddress(): `0x${string}` | Promise<`0x${string}`>;
+    /**
+     * Check if signer is ready/connected
+     */
+    isReady(): boolean | Promise<boolean>;
+}
+
+interface DagAAConfig {
+    chain: Chain;
+    rpcUrl: string;
+    bundlerUrl: string;
+    factoryAddress: Address;
+    entryPointAddress?: Address;
+    paymasterUrl?: string;
+}
+interface SmartAccountConfig {
+    signer: ISigner;
+    accountAddress?: Address;
+}
+interface SendUserOperationParams {
+    target: Address;
+    data?: `0x${string}`;
+    value?: bigint;
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
+    callGasLimit?: bigint;
+    verificationGasLimit?: bigint;
+    preVerificationGas?: bigint;
+}
+interface UserOperationReceipt {
+    userOpHash: Hash;
+    transactionHash?: Hash;
+    success: boolean;
+    blockNumber?: bigint;
+    blockHash?: Hash;
+}
+
+declare class DagAAClient {
+    private config;
+    private publicClient;
+    private walletClient;
+    private bundlerClient;
+    private smartAccount;
+    private paymasterClient;
+    private smartAccountClient;
+    constructor(config: DagAAConfig);
+    private createPaymasterClient;
+    connectSmartAccount(accountConfig: SmartAccountConfig): Promise<Address>;
+    getAddress(): Address;
+    getBalance(): Promise<bigint>;
+    isDeployed(): Promise<boolean>;
+    getNonce(): Promise<bigint>;
+    sendUserOperation(params: SendUserOperationParams): Promise<Hash>;
+    writeContract(params: {
+        address: Address;
+        abi: any[];
+        functionName: string;
+        args?: any[];
+        value?: bigint;
+        maxFeePerGas?: bigint;
+        maxPriorityFeePerGas?: bigint;
+    }): Promise<Hash>;
+    readContract(params: {
+        address: Address;
+        abi: any[];
+        functionName: string;
+        args?: any[];
+    }): Promise<any>;
+    waitForUserOperationReceipt(userOpHash: Hash, timeout?: number): Promise<UserOperationReceipt>;
+    fundAccount(amount: bigint, fromPrivateKey: `0x${string}`): Promise<Hash>;
+    sendBatchUserOperations(operations: SendUserOperationParams[]): Promise<Hash[]>;
+}
+declare function createDagAAClient(config: DagAAConfig): DagAAClient;
+declare function parseDAG(amount: string): bigint;
+
+declare const awakening: {
+    bundler_rpc: string;
+    chain_config: {
+        blockExplorers: {
+            readonly default: {
+                readonly name: "Explorer";
+                readonly url: "https://awakening.bdagscan.com/";
+            };
+        };
+        contracts?: viem.Prettify<{
+            [key: string]: viem.ChainContract | {
+                [sourceId: number]: viem.ChainContract | undefined;
+            } | undefined;
+        } & {
+            ensRegistry?: viem.ChainContract | undefined;
+            ensUniversalResolver?: viem.ChainContract | undefined;
+            multicall3?: viem.ChainContract | undefined;
+            universalSignatureVerifier?: viem.ChainContract | undefined;
+        }> | undefined;
+        ensTlds?: readonly string[] | undefined;
+        id: 1043;
+        name: "Awakening Testnet";
+        nativeCurrency: {
+            readonly decimals: 18;
+            readonly name: "Dag";
+            readonly symbol: "DAG";
+        };
+        rpcUrls: {
+            readonly default: {
+                readonly http: readonly ["https://public-bdag.nownodes.io"];
+            };
+        };
+        sourceId?: number | undefined;
+        testnet?: boolean | undefined;
+        custom?: Record<string, unknown>;
+        fees?: viem.ChainFees<undefined>;
+        formatters?: undefined;
+        serializers?: viem.ChainSerializers<undefined, viem.TransactionSerializable>;
+    };
+};
+declare const arbitrumSep: {
+    bundler_rpc: string;
+    chain_config: {
+        blockExplorers: {
+            readonly default: {
+                readonly name: "Arbiscan";
+                readonly url: "https://sepolia.arbiscan.io";
+                readonly apiUrl: "https://api-sepolia.arbiscan.io/api";
+            };
+        };
+        contracts: {
+            readonly multicall3: {
+                readonly address: "0xca11bde05977b3631167028862be2a173976ca11";
+                readonly blockCreated: 81930;
+            };
+        };
+        ensTlds?: readonly string[] | undefined;
+        id: 421614;
+        name: "Arbitrum Sepolia";
+        nativeCurrency: {
+            readonly name: "Arbitrum Sepolia Ether";
+            readonly symbol: "ETH";
+            readonly decimals: 18;
+        };
+        rpcUrls: {
+            readonly default: {
+                readonly http: readonly ["https://sepolia-rollup.arbitrum.io/rpc"];
+            };
+        };
+        sourceId?: number | undefined | undefined;
+        testnet: true;
+        custom?: Record<string, unknown> | undefined;
+        fees?: viem.ChainFees<undefined> | undefined;
+        formatters?: undefined;
+        serializers?: viem.ChainSerializers<undefined, viem.TransactionSerializable> | undefined;
+    };
+};
+
+/**
+ * Privy Signer - Works with Privy's embedded wallets
+ *
+ * Usage in React:
+ * ```tsx
+ * import { useWallets } from '@privy-io/react-auth';
+ *
+ * const { wallets } = useWallets();
+ * const embeddedWallet = wallets.find(w => w.walletClientType === 'privy');
+ *
+ * const signer = new PrivySigner(embeddedWallet, chain);
+ * ```
+ */
+declare class PrivySigner implements ISigner {
+    private privyWallet;
+    private chain;
+    private cachedAddress?;
+    private cachedWalletClient;
+    constructor(privyWallet: any, chain: Chain);
+    getAccount(): Promise<LocalAccount>;
+    getWalletClient(): Promise<WalletClient>;
+    getAddress(): Promise<`0x${string}`>;
+    isReady(): Promise<boolean>;
+}
+
+declare class PrivateKeySigner implements ISigner {
+    private account;
+    private walletClient;
+    constructor(privateKey: `0x${string}`, chain: Chain, rpcUrl: string);
+    getAccount(): LocalAccount;
+    getWalletClient(): WalletClient;
+    getAddress(): `0x${string}`;
+    isReady(): boolean;
+}
+
+export { DagAAClient, type DagAAConfig, type ISigner, PrivateKeySigner, PrivySigner, type SendUserOperationParams, type SmartAccountConfig, type UserOperationReceipt, arbitrumSep, awakening, createDagAAClient, parseDAG };