@coinbase/agentkit 0.0.0-nightly-20250328174338

package/dist/wallet-providers/walletProvider.d.ts

@@ -0,0 +1,48 @@
+import { Network } from "../network";
+/**
+ * WalletProvider is the abstract base class for all wallet providers.
+ *
+ * @abstract
+ */
+export declare abstract class WalletProvider {
+    /**
+     * Initializes the wallet provider.
+     */
+    constructor();
+    /**
+     * Tracks the initialization of the wallet provider.
+     */
+    private trackInitialization;
+    /**
+     * Get the address of the wallet provider.
+     *
+     * @returns The address of the wallet provider.
+     */
+    abstract getAddress(): string;
+    /**
+     * Get the network of the wallet provider.
+     *
+     * @returns The network of the wallet provider.
+     */
+    abstract getNetwork(): Network;
+    /**
+     * Get the name of the wallet provider.
+     *
+     * @returns The name of the wallet provider.
+     */
+    abstract getName(): string;
+    /**
+     * Get the balance of the native asset of the network.
+     *
+     * @returns The balance of the native asset of the network.
+     */
+    abstract getBalance(): Promise<bigint>;
+    /**
+     * Transfer the native asset of the network.
+     *
+     * @param to - The destination address.
+     * @param value - The amount to transfer in whole units (e.g. ETH)
+     * @returns The transaction hash.
+     */
+    abstract nativeTransfer(to: string, value: string): Promise<string>;
+}

package/dist/wallet-providers/walletProvider.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WalletProvider = void 0;
+const analytics_1 = require("../analytics");
+/**
+ * WalletProvider is the abstract base class for all wallet providers.
+ *
+ * @abstract
+ */
+class WalletProvider {
+    /**
+     * Initializes the wallet provider.
+     */
+    constructor() {
+        // Wait for the next tick to ensure child class is initialized
+        Promise.resolve().then(() => {
+            this.trackInitialization();
+        });
+    }
+    /**
+     * Tracks the initialization of the wallet provider.
+     */
+    trackInitialization() {
+        try {
+            (0, analytics_1.sendAnalyticsEvent)({
+                name: "agent_initialization",
+                action: "initialize_wallet_provider",
+                component: "wallet_provider",
+                wallet_provider: this.getName(),
+                wallet_address: this.getAddress(),
+                network_id: this.getNetwork().networkId,
+                chain_id: this.getNetwork().chainId,
+                protocol_family: this.getNetwork().protocolFamily,
+            });
+        }
+        catch (error) {
+            console.warn("Failed to track wallet provider initialization:", error);
+        }
+    }
+}
+exports.WalletProvider = WalletProvider;

package/dist/wallet-providers/walletProvider.test.d.ts

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

package/dist/wallet-providers/walletProvider.test.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const walletProvider_1 = require("./walletProvider");
+const analytics_1 = require("../analytics");
+// Mock fetch globally to prevent any actual network requests
+global.fetch = jest.fn(() => Promise.resolve({
+    ok: true,
+    json: () => Promise.resolve({}),
+}));
+jest.mock("../analytics", () => ({
+    sendAnalyticsEvent: jest.fn().mockImplementation(() => Promise.resolve()),
+}));
+const MOCK_ADDRESS = "0x742d35Cc6634C0532925a3b844Bc454e4438f44e";
+const MOCK_NETWORK_ID = "mainnet";
+const MOCK_CHAIN_ID = "1";
+const MOCK_PROTOCOL_FAMILY = "evm";
+const MOCK_WALLET_NAME = "test_wallet_provider";
+const MOCK_NETWORK = {
+    protocolFamily: MOCK_PROTOCOL_FAMILY,
+    networkId: MOCK_NETWORK_ID,
+    chainId: MOCK_CHAIN_ID,
+};
+describe("WalletProvider", () => {
+    /**
+     *
+     */
+    class MockWalletProvider extends walletProvider_1.WalletProvider {
+        /**
+         * Returns the wallet address.
+         *
+         * @returns The wallet address as a string.
+         */
+        getAddress() {
+            return MOCK_ADDRESS;
+        }
+        /**
+         * Returns the network information.
+         *
+         * @returns The network details.
+         */
+        getNetwork() {
+            return MOCK_NETWORK;
+        }
+        /**
+         * Returns the wallet provider name.
+         *
+         * @returns The wallet provider name as a string.
+         */
+        getName() {
+            return MOCK_WALLET_NAME;
+        }
+        /**
+         * Returns the wallet balance.
+         *
+         * @returns A promise resolving to the wallet balance as a bigint.
+         */
+        getBalance() {
+            return Promise.resolve(BigInt(1000000000000000000));
+        }
+        /**
+         * Transfers native tokens.
+         *
+         * @param _to - The recipient address.
+         * @param _value - The amount to transfer.
+         * @returns A promise resolving to the transaction hash as a string.
+         */
+        nativeTransfer(_to, _value) {
+            return Promise.resolve("0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef");
+        }
+    }
+    beforeEach(() => {
+        jest.clearAllMocks();
+    });
+    it("should define abstract methods (TypeScript only - not a runtime check)", () => { });
+    it("should track initialization via analytics", () => {
+        new MockWalletProvider();
+        return new Promise(resolve => setTimeout(() => {
+            expect(analytics_1.sendAnalyticsEvent).toHaveBeenCalledWith({
+                name: "agent_initialization",
+                action: "initialize_wallet_provider",
+                component: "wallet_provider",
+                wallet_provider: MOCK_WALLET_NAME,
+                wallet_address: MOCK_ADDRESS,
+                network_id: MOCK_NETWORK_ID,
+                chain_id: MOCK_CHAIN_ID,
+                protocol_family: MOCK_PROTOCOL_FAMILY,
+            });
+            resolve(null);
+        }, 0));
+    });
+    it("should handle tracking failures gracefully", () => {
+        analytics_1.sendAnalyticsEvent.mockImplementationOnce(() => {
+            throw new Error("Test error");
+        });
+        const consoleWarnSpy = jest.spyOn(console, "warn").mockImplementation(() => { });
+        new MockWalletProvider();
+        return new Promise(resolve => setTimeout(() => {
+            expect(consoleWarnSpy).toHaveBeenCalledWith("Failed to track wallet provider initialization:", expect.any(Error));
+            consoleWarnSpy.mockRestore();
+            resolve(null);
+        }, 0));
+    });
+});

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "@coinbase/agentkit",
+  "description": "Coinbase AgentKit core primitives",
+  "repository": "https://github.com/coinbase/agentkit",
+  "version": "0.0.0-nightly-20250328174338",
+  "author": "Coinbase Inc.",
+  "license": "Apache-2.0",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "coinbase",
+    "sdk",
+    "crypto",
+    "cdp",
+    "agentkit",
+    "ai",
+    "agent",
+    "nodejs",
+    "typescript"
+  ],
+  "dependencies": {
+    "@across-protocol/app-sdk": "^0.2.0",
+    "@alloralabs/allora-sdk": "^0.1.0",
+    "@coinbase/coinbase-sdk": "^0.20.0",
+    "@jup-ag/api": "^6.0.39",
+    "@privy-io/server-auth": "^1.18.4",
+    "@solana/spl-token": "^0.4.12",
+    "@solana/web3.js": "^1.98.0",
+    "bs58": "^4.0.1",
+    "decimal.js": "^10.5.0",
+    "ethers": "^6.13.5",
+    "md5": "^2.3.0",
+    "opensea-js": "^7.1.18",
+    "reflect-metadata": "^0.2.2",
+    "twitter-api-v2": "^1.18.2",
+    "viem": "^2.22.16",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "@types/nunjucks": "^3.2.6",
+    "@types/ora": "^3.2.0",
+    "@types/prompts": "^2.4.9",
+    "@types/secp256k1": "^4.0.6",
+    "abitype": "^1.0.8",
+    "http-server": "^14.1.1",
+    "jest": "^29.7.0",
+    "mock-fs": "^5.2.0",
+    "nunjucks": "^3.2.4",
+    "ora": "^7.0.1",
+    "picocolors": "^1.0.0",
+    "prompts": "^2.4.2",
+    "ts-jest": "^29.2.5",
+    "tsd": "^0.31.2",
+    "tsx": "^4.7.1",
+    "typescript": "^5.7.2"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "lint": "eslint -c .eslintrc.json \"src/**/*.ts\"",
+    "lint:fix": "eslint -c .eslintrc.json \"src/**/*.ts\" --fix",
+    "format": "prettier -c .prettierrc --write \"**/*.{ts,js,cjs,json,md}\"",
+    "format:check": "prettier -c .prettierrc --check \"**/*.{ts,js,cjs,json,md}\"",
+    "check": "tsc --noEmit",
+    "test": "jest --no-cache --testMatch='**/*.test.ts'",
+    "test:e2e": "jest --no-cache --testMatch=**/e2e.ts --coverageThreshold '{}'",
+    "test:types": "tsd --files src/tests/types.test-d.ts",
+    "clean": "rm -rf dist/*",
+    "docs": "typedoc --entryPoints ./src --entryPointStrategy expand --exclude ./src/tests/**/*.ts",
+    "docs:serve": "http-server ./docs",
+    "dev": "tsc --watch",
+    "generate:action-provider": "tsx ./scripts/generate-action-provider/main.ts"
+  }
+}