rook-agent-sdk 0.1.0

package/dist/RookAgent.d.ts

@@ -0,0 +1,115 @@
+/**
+ * ROOK Agent SDK
+ *
+ * Bu SDK, AI ajanlarinin ROOK cuzdanini kullanmasini saglar.
+ * Insan kullanici ajani olusturduktan sonra, private key ve config'i
+ * ajana verir. Ajan bu SDK'yi kullanarak islem yapar.
+ *
+ * Kullanim:
+ * ```typescript
+ * import { RookAgent } from '@rook/agent-sdk';
+ *
+ * const agent = new RookAgent({
+ *   privateKey: '0x...',  // Insandan alinan private key
+ *   config: {             // Insandan alinan limit config
+ *     dailyLimitMON: '10',
+ *     perTxLimitMON: '1',
+ *     contractWhitelist: []
+ *   }
+ * });
+ *
+ * // Islem gonder
+ * const result = await agent.send('0xRecipient...', '0.5');
+ * ```
+ */
+import { ethers } from 'ethers';
+export interface AgentConfig {
+    dailyLimitMON: string;
+    perTxLimitMON: string;
+    contractWhitelist: string[];
+    expiresAt?: number | null;
+}
+export interface AgentOptions {
+    privateKey: string;
+    config: AgentConfig;
+    rpcUrl?: string;
+}
+export interface TransactionResult {
+    success: boolean;
+    txHash?: string;
+    error?: string;
+}
+export interface SpendingRecord {
+    date: string;
+    amount: string;
+    txHash: string;
+}
+/**
+ * ROOK Agent - AI ajanlari icin cuzdan SDK'si
+ */
+export declare class RookAgent {
+    private wallet;
+    private provider;
+    private config;
+    private spendingHistory;
+    constructor(options: AgentOptions);
+    /**
+     * Ajan adresi
+     */
+    get address(): string;
+    /**
+     * Bakiye sorgula
+     */
+    getBalance(): Promise<string>;
+    /**
+     * Bugunun tarihi (YYYY-MM-DD)
+     */
+    private getTodayDate;
+    /**
+     * Bugun harcanan miktar
+     */
+    getSpentToday(): number;
+    /**
+     * Kalan gunluk limit
+     */
+    getRemainingDailyLimit(): number;
+    /**
+     * Islem validasyonu
+     */
+    private validateTransaction;
+    /**
+     * MON gonder
+     *
+     * @param to - Alici adresi
+     * @param amountMON - MON miktari
+     */
+    send(to: string, amountMON: string): Promise<TransactionResult>;
+    /**
+     * Smart contract cagir
+     *
+     * @param contractAddress - Kontrat adresi
+     * @param abi - Kontrat ABI'si
+     * @param method - Cagrilacak metod
+     * @param args - Metod argumanlari
+     * @param valueMON - Gonderilecek MON (opsiyonel)
+     */
+    callContract(contractAddress: string, abi: ethers.InterfaceAbi, method: string, args?: unknown[], valueMON?: string): Promise<TransactionResult>;
+    /**
+     * Islem gecmisi
+     */
+    getTransactionHistory(): SpendingRecord[];
+    /**
+     * Durum ozeti
+     */
+    getStatus(): Promise<{
+        address: string;
+        balance: string;
+        spentToday: number;
+        remainingToday: number;
+        dailyLimit: string;
+        perTxLimit: string;
+        network: string;
+        chainId: number;
+    }>;
+}
+export default RookAgent;

package/dist/RookAgent.js

@@ -0,0 +1,237 @@
+/**
+ * ROOK Agent SDK
+ *
+ * Bu SDK, AI ajanlarinin ROOK cuzdanini kullanmasini saglar.
+ * Insan kullanici ajani olusturduktan sonra, private key ve config'i
+ * ajana verir. Ajan bu SDK'yi kullanarak islem yapar.
+ *
+ * Kullanim:
+ * ```typescript
+ * import { RookAgent } from '@rook/agent-sdk';
+ *
+ * const agent = new RookAgent({
+ *   privateKey: '0x...',  // Insandan alinan private key
+ *   config: {             // Insandan alinan limit config
+ *     dailyLimitMON: '10',
+ *     perTxLimitMON: '1',
+ *     contractWhitelist: []
+ *   }
+ * });
+ *
+ * // Islem gonder
+ * const result = await agent.send('0xRecipient...', '0.5');
+ * ```
+ */
+import { ethers } from 'ethers';
+// Monad Testnet Config
+const MONAD_CONFIG = {
+    chainId: 10143,
+    name: 'Monad Testnet',
+    rpcUrl: 'https://testnet-rpc.monad.xyz',
+    symbol: 'MON',
+    explorerUrl: 'https://monad-testnet.socialscan.io'
+};
+/**
+ * ROOK Agent - AI ajanlari icin cuzdan SDK'si
+ */
+export class RookAgent {
+    wallet;
+    provider;
+    config;
+    spendingHistory = [];
+    constructor(options) {
+        // Provider olustur
+        this.provider = new ethers.JsonRpcProvider(options.rpcUrl || MONAD_CONFIG.rpcUrl, {
+            chainId: MONAD_CONFIG.chainId,
+            name: MONAD_CONFIG.name
+        });
+        // Wallet olustur
+        this.wallet = new ethers.Wallet(options.privateKey, this.provider);
+        this.config = options.config;
+        console.log(`ROOK Agent initialized`);
+        console.log(`   Address: ${this.wallet.address}`);
+        console.log(`   Daily Limit: ${this.config.dailyLimitMON} MON`);
+        console.log(`   Per-Tx Limit: ${this.config.perTxLimitMON} MON`);
+    }
+    /**
+     * Ajan adresi
+     */
+    get address() {
+        return this.wallet.address;
+    }
+    /**
+     * Bakiye sorgula
+     */
+    async getBalance() {
+        const balance = await this.provider.getBalance(this.wallet.address);
+        return ethers.formatEther(balance);
+    }
+    /**
+     * Bugunun tarihi (YYYY-MM-DD)
+     */
+    getTodayDate() {
+        return new Date().toISOString().split('T')[0];
+    }
+    /**
+     * Bugun harcanan miktar
+     */
+    getSpentToday() {
+        const today = this.getTodayDate();
+        return this.spendingHistory
+            .filter(s => s.date === today)
+            .reduce((sum, s) => sum + parseFloat(s.amount), 0);
+    }
+    /**
+     * Kalan gunluk limit
+     */
+    getRemainingDailyLimit() {
+        const spent = this.getSpentToday();
+        const limit = parseFloat(this.config.dailyLimitMON);
+        return Math.max(0, limit - spent);
+    }
+    /**
+     * Islem validasyonu
+     */
+    validateTransaction(to, amountMON) {
+        const amount = parseFloat(amountMON);
+        // 1. Sure dolmus mu?
+        if (this.config.expiresAt && Date.now() > this.config.expiresAt) {
+            return { valid: false, reason: 'Agent access has expired' };
+        }
+        // 2. Islem basina limit
+        const perTxLimit = parseFloat(this.config.perTxLimitMON);
+        if (amount > perTxLimit) {
+            return {
+                valid: false,
+                reason: `Amount ${amountMON} MON exceeds per-transaction limit of ${this.config.perTxLimitMON} MON`
+            };
+        }
+        // 3. Gunluk limit
+        const remaining = this.getRemainingDailyLimit();
+        if (amount > remaining) {
+            return {
+                valid: false,
+                reason: `Would exceed daily limit. Remaining today: ${remaining.toFixed(4)} MON`
+            };
+        }
+        // 4. Whitelist kontrolu
+        if (this.config.contractWhitelist.length > 0) {
+            const isWhitelisted = this.config.contractWhitelist.some(addr => addr.toLowerCase() === to.toLowerCase());
+            if (!isWhitelisted) {
+                return {
+                    valid: false,
+                    reason: 'Recipient address is not in the allowed contracts list'
+                };
+            }
+        }
+        return { valid: true };
+    }
+    /**
+     * MON gonder
+     *
+     * @param to - Alici adresi
+     * @param amountMON - MON miktari
+     */
+    async send(to, amountMON) {
+        console.log(`Sending ${amountMON} MON to ${to}...`);
+        // Validasyon
+        const validation = this.validateTransaction(to, amountMON);
+        if (!validation.valid) {
+            console.log(`Transaction rejected: ${validation.reason}`);
+            return { success: false, error: validation.reason };
+        }
+        try {
+            // Adres kontrolu
+            if (!ethers.isAddress(to)) {
+                return { success: false, error: 'Invalid recipient address' };
+            }
+            // Islem gonder
+            const tx = await this.wallet.sendTransaction({
+                to,
+                value: ethers.parseEther(amountMON)
+            });
+            console.log(`Transaction sent: ${tx.hash}`);
+            // Onay bekle
+            await tx.wait();
+            console.log(`Transaction confirmed!`);
+            // Harcamayi kaydet
+            this.spendingHistory.push({
+                date: this.getTodayDate(),
+                amount: amountMON,
+                txHash: tx.hash
+            });
+            return { success: true, txHash: tx.hash };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Transaction failed';
+            console.log(`Transaction failed: ${message}`);
+            return { success: false, error: message };
+        }
+    }
+    /**
+     * Smart contract cagir
+     *
+     * @param contractAddress - Kontrat adresi
+     * @param abi - Kontrat ABI'si
+     * @param method - Cagrilacak metod
+     * @param args - Metod argumanlari
+     * @param valueMON - Gonderilecek MON (opsiyonel)
+     */
+    async callContract(contractAddress, abi, method, args = [], valueMON = '0') {
+        console.log(`Calling ${method} on ${contractAddress}...`);
+        // Validasyon (eger MON gonderiliyorsa)
+        if (parseFloat(valueMON) > 0) {
+            const validation = this.validateTransaction(contractAddress, valueMON);
+            if (!validation.valid) {
+                console.log(`Transaction rejected: ${validation.reason}`);
+                return { success: false, error: validation.reason };
+            }
+        }
+        try {
+            const contract = new ethers.Contract(contractAddress, abi, this.wallet);
+            const tx = await contract[method](...args, {
+                value: ethers.parseEther(valueMON)
+            });
+            console.log(`Transaction sent: ${tx.hash}`);
+            await tx.wait();
+            console.log(`Transaction confirmed!`);
+            // Harcamayi kaydet
+            if (parseFloat(valueMON) > 0) {
+                this.spendingHistory.push({
+                    date: this.getTodayDate(),
+                    amount: valueMON,
+                    txHash: tx.hash
+                });
+            }
+            return { success: true, txHash: tx.hash };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Contract call failed';
+            console.log(`Contract call failed: ${message}`);
+            return { success: false, error: message };
+        }
+    }
+    /**
+     * Islem gecmisi
+     */
+    getTransactionHistory() {
+        return [...this.spendingHistory];
+    }
+    /**
+     * Durum ozeti
+     */
+    async getStatus() {
+        const balance = await this.getBalance();
+        return {
+            address: this.wallet.address,
+            balance,
+            spentToday: this.getSpentToday(),
+            remainingToday: this.getRemainingDailyLimit(),
+            dailyLimit: this.config.dailyLimitMON,
+            perTxLimit: this.config.perTxLimitMON,
+            network: MONAD_CONFIG.name,
+            chainId: MONAD_CONFIG.chainId
+        };
+    }
+}
+export default RookAgent;

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * ROOK Agent SDK
+ *
+ * SDK for AI agents to interact with ROOK Wallet on Monad blockchain.
+ *
+ * @example
+ * ```typescript
+ * import { RookAgent } from '@rook/agent-sdk';
+ *
+ * const agent = new RookAgent({
+ *   privateKey: '0x...',
+ *   config: {
+ *     dailyLimitMON: '10',
+ *     perTxLimitMON: '1',
+ *     contractWhitelist: []
+ *   }
+ * });
+ *
+ * await agent.send('0x...', '0.5');
+ * ```
+ */
+export { RookAgent, type AgentConfig, type AgentOptions, type TransactionResult, type SpendingRecord } from './RookAgent.js';

package/dist/index.js

@@ -0,0 +1,22 @@
+/**
+ * ROOK Agent SDK
+ *
+ * SDK for AI agents to interact with ROOK Wallet on Monad blockchain.
+ *
+ * @example
+ * ```typescript
+ * import { RookAgent } from '@rook/agent-sdk';
+ *
+ * const agent = new RookAgent({
+ *   privateKey: '0x...',
+ *   config: {
+ *     dailyLimitMON: '10',
+ *     perTxLimitMON: '1',
+ *     contractWhitelist: []
+ *   }
+ * });
+ *
+ * await agent.send('0x...', '0.5');
+ * ```
+ */
+export { RookAgent } from './RookAgent.js';

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "rook-agent-sdk",
+  "version": "0.1.0",
+  "description": "ROOK Agent SDK - Non-custodial AI agent wallet for Monad blockchain",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "ethers": "^6.13.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  },
+  "keywords": ["rook", "wallet", "ai-agent", "monad", "crypto", "sdk", "mcp"],
+  "license": "MIT"
+}