aether-agent-sdk 1.0.0 → 1.0.3

package/dist/src/protocols/AP2Protocol.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * AP2 (A2A Payment) Protocol
+ * Agent-to-Agent Payment Protocol for autonomous transactions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AP2PaymentNegotiation = exports.AP2Protocol = void 0;
+class AP2Protocol {
+    network;
+    currency;
+    constructor(network = 'solana-devnet', currency = 'USDC') {
+        this.network = network;
+        this.currency = currency;
+    }
+    createPaymentRequest(from, to, amount, description, metadata) {
+        const now = Date.now();
+        const request = {
+            id: `ap2-${now}-${Math.random().toString(36).substr(2, 9)}`,
+            from,
+            to,
+            amount: amount.toString(),
+            currency: this.currency,
+            network: this.network,
+            createdAt: now,
+            expiresAt: now + (5 * 60 * 1000)
+        };
+        if (description !== undefined)
+            request.description = description;
+        if (metadata !== undefined)
+            request.metadata = metadata;
+        return request;
+    }
+    createPaymentResponse(requestId, status, transactionHash, message) {
+        const response = {
+            requestId,
+            status,
+            timestamp: Date.now()
+        };
+        if (transactionHash !== undefined)
+            response.transactionHash = transactionHash;
+        if (message !== undefined)
+            response.message = message;
+        return response;
+    }
+    verifyPayment(requestId, transactionHash, verified, confirmations = 0) {
+        return {
+            requestId,
+            transactionHash,
+            network: this.network,
+            verified,
+            confirmations,
+            timestamp: Date.now()
+        };
+    }
+    isExpired(request) {
+        return Date.now() > request.expiresAt;
+    }
+    validateRequest(request) {
+        const errors = [];
+        if (!request.id)
+            errors.push('Missing request ID');
+        if (!request.from)
+            errors.push('Missing sender address');
+        if (!request.to)
+            errors.push('Missing recipient address');
+        if (!request.amount || Number(request.amount) <= 0) {
+            errors.push('Invalid amount');
+        }
+        if (!request.currency)
+            errors.push('Missing currency');
+        if (!request.network)
+            errors.push('Missing network');
+        if (this.isExpired(request))
+            errors.push('Request expired');
+        return {
+            valid: errors.length === 0,
+            errors
+        };
+    }
+    encodeRequest(request) {
+        return Buffer.from(JSON.stringify(request)).toString('base64');
+    }
+    decodeRequest(encoded) {
+        const json = Buffer.from(encoded, 'base64').toString('utf-8');
+        return JSON.parse(json);
+    }
+}
+exports.AP2Protocol = AP2Protocol;
+class AP2PaymentNegotiation {
+    requests;
+    responses;
+    constructor() {
+        this.requests = new Map();
+        this.responses = new Map();
+    }
+    proposePayment(request) {
+        this.requests.set(request.id, request);
+    }
+    respondToPayment(response) {
+        this.responses.set(response.requestId, response);
+    }
+    getRequest(requestId) {
+        return this.requests.get(requestId);
+    }
+    getResponse(requestId) {
+        return this.responses.get(requestId);
+    }
+    clearExpiredRequests() {
+        let cleared = 0;
+        const now = Date.now();
+        for (const [id, request] of this.requests.entries()) {
+            if (request.expiresAt < now) {
+                this.requests.delete(id);
+                cleared++;
+            }
+        }
+        return cleared;
+    }
+}
+exports.AP2PaymentNegotiation = AP2PaymentNegotiation;
+//# sourceMappingURL=AP2Protocol.js.map

package/dist/src/protocols/AP2Protocol.js.map

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

package/dist/src/protocols/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Aether Agent SDK - Protocols Module
+ *
+ * Export protocol implementations for agent communication and payments
+ */
+export { A2AProtocol, A2AServer } from './A2AProtocol';
+export type { A2AMessage, A2AResponse, Task } from './A2AProtocol';
+export { AP2Protocol, AP2PaymentNegotiation } from './AP2Protocol';
+export type { AP2PaymentRequest, AP2PaymentResponse, AP2PaymentVerification } from './AP2Protocol';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/protocols/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/protocols/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AACtD,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AAElE,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAClE,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,eAAe,CAAA"}

package/dist/src/protocols/index.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Aether Agent SDK - Protocols Module
+ *
+ * Export protocol implementations for agent communication and payments
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AP2PaymentNegotiation = exports.AP2Protocol = exports.A2AServer = exports.A2AProtocol = void 0;
+var A2AProtocol_1 = require("./A2AProtocol");
+Object.defineProperty(exports, "A2AProtocol", { enumerable: true, get: function () { return A2AProtocol_1.A2AProtocol; } });
+Object.defineProperty(exports, "A2AServer", { enumerable: true, get: function () { return A2AProtocol_1.A2AServer; } });
+var AP2Protocol_1 = require("./AP2Protocol");
+Object.defineProperty(exports, "AP2Protocol", { enumerable: true, get: function () { return AP2Protocol_1.AP2Protocol; } });
+Object.defineProperty(exports, "AP2PaymentNegotiation", { enumerable: true, get: function () { return AP2Protocol_1.AP2PaymentNegotiation; } });
+//# sourceMappingURL=index.js.map

package/dist/src/protocols/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/protocols/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,6CAAsD;AAA7C,0GAAA,WAAW,OAAA;AAAE,wGAAA,SAAS,OAAA;AAG/B,6CAAkE;AAAzD,0GAAA,WAAW,OAAA;AAAE,oHAAA,qBAAqB,OAAA"}

package/dist/src/services/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Hedron Agent SDK - Services Module
+ *
+ * Export all service classes and utilities
+ */
+export { TokenService } from './TokenService';
+export { createRoyaltyTokenForNFTs } from './TokenService';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/src/services/index.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Hedron Agent SDK - Services Module
+ *
+ * Export all service classes and utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRoyaltyTokenForNFTs = exports.TokenService = void 0;
+var TokenService_1 = require("./TokenService");
+Object.defineProperty(exports, "TokenService", { enumerable: true, get: function () { return TokenService_1.TokenService; } });
+var TokenService_2 = require("./TokenService");
+Object.defineProperty(exports, "createRoyaltyTokenForNFTs", { enumerable: true, get: function () { return TokenService_2.createRoyaltyTokenForNFTs; } });
+//# sourceMappingURL=index.js.map

package/dist/src/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,+CAA6C;AAApC,4GAAA,YAAY,OAAA;AACrB,+CAA0D;AAAjD,yHAAA,yBAAyB,OAAA"}

package/dist/src/utils/env.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Environment utility functions
+ *
+ * Allows optional dotenv loading for SDK usage
+ */
+/**
+ * Load environment variables from .env file (if not already loaded)
+ * This is optional and only runs once
+ */
+export declare function loadEnvIfNeeded(): void;
+/**
+ * Get environment variable with optional default
+ */
+export declare function getEnv(key: string, defaultValue?: string): string | undefined;
+//# sourceMappingURL=env.d.ts.map

package/dist/src/utils/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../src/utils/env.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;GAGG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAgBtC;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG7E"}

package/dist/src/utils/env.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * Environment utility functions
+ *
+ * Allows optional dotenv loading for SDK usage
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadEnvIfNeeded = loadEnvIfNeeded;
+exports.getEnv = getEnv;
+let dotenvLoaded = false;
+/**
+ * Load environment variables from .env file (if not already loaded)
+ * This is optional and only runs once
+ */
+function loadEnvIfNeeded() {
+    if (dotenvLoaded) {
+        return;
+    }
+    try {
+        // Only load dotenv if it's available (not bundled in SDK)
+        const dotenv = require('dotenv');
+        if (dotenv && typeof dotenv.config === 'function') {
+            dotenv.config();
+            dotenvLoaded = true;
+        }
+    }
+    catch (error) {
+        // dotenv is optional - if not available, environment variables
+        // should be provided by the user via process.env
+    }
+}
+/**
+ * Get environment variable with optional default
+ */
+function getEnv(key, defaultValue) {
+    loadEnvIfNeeded();
+    return process.env[key] || defaultValue;
+}
+//# sourceMappingURL=env.js.map

package/dist/src/utils/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../../src/utils/env.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAQH,0CAgBC;AAKD,wBAGC;AA9BD,IAAI,YAAY,GAAG,KAAK,CAAA;AAExB;;;GAGG;AACH,SAAgB,eAAe;IAC7B,IAAI,YAAY,EAAE,CAAC;QACjB,OAAM;IACR,CAAC;IAED,IAAI,CAAC;QACH,0DAA0D;QAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;QAChC,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YAClD,MAAM,CAAC,MAAM,EAAE,CAAA;YACf,YAAY,GAAG,IAAI,CAAA;QACrB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,+DAA+D;QAC/D,iDAAiD;IACnD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,MAAM,CAAC,GAAW,EAAE,YAAqB;IACvD,eAAe,EAAE,CAAA;IACjB,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,YAAY,CAAA;AACzC,CAAC"}

package/dist/src/utils/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Aether Agent SDK - Utilities Module
+ *
+ * Export utility functions
+ */
+export { loadEnvIfNeeded, getEnv } from './env';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA"}

package/dist/src/utils/index.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Aether Agent SDK - Utilities Module
+ *
+ * Export utility functions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEnv = exports.loadEnvIfNeeded = void 0;
+var env_1 = require("./env");
+Object.defineProperty(exports, "loadEnvIfNeeded", { enumerable: true, get: function () { return env_1.loadEnvIfNeeded; } });
+Object.defineProperty(exports, "getEnv", { enumerable: true, get: function () { return env_1.getEnv; } });
+//# sourceMappingURL=index.js.map

package/dist/src/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,6BAA+C;AAAtC,sGAAA,eAAe,OAAA;AAAE,6FAAA,MAAM,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aether-agent-sdk",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "description": "Autonomous Agent Ecosystem SDK for Solana - A2A Protocol, x402 Payment Standard, and Agent-to-Agent Communication",
   "main": "./dist/src/index.js",
   "types": "./dist/src/index.d.ts",