@coinbase/agentkit 0.10.0 → 0.10.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (169) hide show
  1. package/README.md +195 -23
  2. package/dist/action-providers/across/acrossActionProvider.js +3 -3
  3. package/dist/action-providers/across/schemas.d.ts +1 -1
  4. package/dist/action-providers/baseAccount/baseAccountActionProvider.d.ts +46 -0
  5. package/dist/action-providers/baseAccount/baseAccountActionProvider.js +404 -0
  6. package/dist/action-providers/baseAccount/baseAccountActionProvider.test.d.ts +1 -0
  7. package/dist/action-providers/baseAccount/baseAccountActionProvider.test.js +325 -0
  8. package/dist/action-providers/baseAccount/index.d.ts +2 -0
  9. package/dist/action-providers/baseAccount/index.js +18 -0
  10. package/dist/action-providers/baseAccount/schemas.d.ts +43 -0
  11. package/dist/action-providers/baseAccount/schemas.js +62 -0
  12. package/dist/action-providers/baseAccount/types.d.ts +17 -0
  13. package/dist/action-providers/baseAccount/types.js +2 -0
  14. package/dist/action-providers/baseAccount/utils.d.ts +14 -0
  15. package/dist/action-providers/baseAccount/utils.js +57 -0
  16. package/dist/action-providers/cdp/cdpApiActionProvider.d.ts +3 -12
  17. package/dist/action-providers/cdp/cdpApiActionProvider.js +2 -81
  18. package/dist/action-providers/cdp/cdpApiActionProvider.test.js +0 -125
  19. package/dist/action-providers/cdp/cdpEvmWalletActionProvider.d.ts +18 -3
  20. package/dist/action-providers/cdp/cdpEvmWalletActionProvider.js +224 -23
  21. package/dist/action-providers/cdp/cdpEvmWalletActionProvider.test.js +280 -0
  22. package/dist/action-providers/cdp/cdpSmartWalletActionProvider.d.ts +17 -2
  23. package/dist/action-providers/cdp/cdpSmartWalletActionProvider.js +224 -18
  24. package/dist/action-providers/cdp/cdpSmartWalletActionProvider.test.js +267 -1
  25. package/dist/action-providers/cdp/schemas.d.ts +12 -12
  26. package/dist/action-providers/cdp/schemas.js +17 -5
  27. package/dist/action-providers/cdp/swapUtils.d.ts +23 -0
  28. package/dist/action-providers/cdp/swapUtils.js +106 -0
  29. package/dist/action-providers/clanker/clankerActionProvider.d.ts +43 -0
  30. package/dist/action-providers/clanker/clankerActionProvider.js +130 -0
  31. package/dist/action-providers/clanker/clankerActionProvider.test.d.ts +4 -0
  32. package/dist/action-providers/clanker/clankerActionProvider.test.js +119 -0
  33. package/dist/action-providers/clanker/index.d.ts +2 -0
  34. package/dist/action-providers/clanker/index.js +18 -0
  35. package/dist/action-providers/clanker/schemas.d.ts +56 -0
  36. package/dist/action-providers/clanker/schemas.js +47 -0
  37. package/dist/action-providers/clanker/utils.d.ts +9 -0
  38. package/dist/action-providers/clanker/utils.js +23 -0
  39. package/dist/action-providers/compound/constants.d.ts +1 -1
  40. package/dist/action-providers/compound/constants.js +2 -2
  41. package/dist/action-providers/erc20/constants.d.ts +35 -135
  42. package/dist/action-providers/erc20/constants.js +37 -189
  43. package/dist/action-providers/erc20/erc20ActionProvider.d.ts +9 -1
  44. package/dist/action-providers/erc20/erc20ActionProvider.js +87 -35
  45. package/dist/action-providers/erc20/erc20ActionProvider.test.js +115 -52
  46. package/dist/action-providers/erc20/schemas.d.ts +25 -12
  47. package/dist/action-providers/erc20/schemas.js +34 -6
  48. package/dist/action-providers/erc20/utils.d.ts +19 -0
  49. package/dist/action-providers/erc20/utils.js +54 -0
  50. package/dist/action-providers/flaunch/client_utils.d.ts +25 -0
  51. package/dist/action-providers/flaunch/client_utils.js +62 -0
  52. package/dist/action-providers/flaunch/constants.d.ts +42 -21
  53. package/dist/action-providers/flaunch/constants.js +113 -38
  54. package/dist/action-providers/flaunch/flaunchActionProvider.d.ts +4 -43
  55. package/dist/action-providers/flaunch/flaunchActionProvider.js +133 -209
  56. package/dist/action-providers/flaunch/flaunchActionProvider.test.js +113 -13
  57. package/dist/action-providers/flaunch/metadata_utils.d.ts +12 -0
  58. package/dist/action-providers/flaunch/metadata_utils.js +216 -0
  59. package/dist/action-providers/flaunch/schemas.d.ts +39 -3
  60. package/dist/action-providers/flaunch/schemas.js +62 -10
  61. package/dist/action-providers/flaunch/{utils.d.ts → swap_utils.d.ts} +17 -19
  62. package/dist/action-providers/flaunch/{utils.js → swap_utils.js} +137 -172
  63. package/dist/action-providers/index.d.ts +4 -0
  64. package/dist/action-providers/index.js +4 -0
  65. package/dist/action-providers/jupiter/schemas.d.ts +1 -1
  66. package/dist/action-providers/moonwell/schemas.d.ts +2 -2
  67. package/dist/action-providers/morpho/morphoActionProvider.js +5 -5
  68. package/dist/action-providers/morpho/schemas.d.ts +2 -2
  69. package/dist/action-providers/pyth/pythActionProvider.d.ts +2 -2
  70. package/dist/action-providers/pyth/pythActionProvider.js +83 -26
  71. package/dist/action-providers/pyth/pythActionProvider.test.js +179 -23
  72. package/dist/action-providers/pyth/schemas.d.ts +6 -0
  73. package/dist/action-providers/pyth/schemas.js +9 -1
  74. package/dist/action-providers/superfluid/constants.d.ts +814 -0
  75. package/dist/action-providers/superfluid/constants.js +2826 -0
  76. package/dist/action-providers/superfluid/graphQueries/endpoints.d.ts +2 -0
  77. package/dist/action-providers/superfluid/graphQueries/endpoints.js +5 -0
  78. package/dist/action-providers/superfluid/graphQueries/queries.d.ts +1 -0
  79. package/dist/action-providers/superfluid/graphQueries/queries.js +35 -0
  80. package/dist/action-providers/superfluid/graphQueries/superfluidGraphQueries.d.ts +8 -0
  81. package/dist/action-providers/superfluid/graphQueries/superfluidGraphQueries.js +24 -0
  82. package/dist/action-providers/superfluid/graphQueries/types.d.ts +27 -0
  83. package/dist/action-providers/superfluid/graphQueries/types.js +2 -0
  84. package/dist/action-providers/superfluid/index.d.ts +7 -0
  85. package/dist/action-providers/superfluid/index.js +23 -0
  86. package/dist/action-providers/superfluid/schemas.d.ts +86 -0
  87. package/dist/action-providers/superfluid/schemas.js +103 -0
  88. package/dist/action-providers/superfluid/superfluidActionProvider.d.ts +20 -0
  89. package/dist/action-providers/superfluid/superfluidActionProvider.js +36 -0
  90. package/dist/action-providers/superfluid/superfluidPoolActionProvider.d.ts +46 -0
  91. package/dist/action-providers/superfluid/superfluidPoolActionProvider.js +143 -0
  92. package/dist/action-providers/superfluid/superfluidPoolActionProvider.test.d.ts +1 -0
  93. package/dist/action-providers/superfluid/superfluidPoolActionProvider.test.js +92 -0
  94. package/dist/action-providers/superfluid/superfluidQueryActionProvider.d.ts +27 -0
  95. package/dist/action-providers/superfluid/superfluidQueryActionProvider.js +71 -0
  96. package/dist/action-providers/superfluid/superfluidQueryActionProvider.test.d.ts +1 -0
  97. package/dist/action-providers/superfluid/superfluidQueryActionProvider.test.js +57 -0
  98. package/dist/action-providers/superfluid/superfluidStreamActionProvider.d.ts +56 -0
  99. package/dist/action-providers/superfluid/superfluidStreamActionProvider.js +191 -0
  100. package/dist/action-providers/superfluid/superfluidStreamActionProvider.test.d.ts +1 -0
  101. package/dist/action-providers/superfluid/superfluidStreamActionProvider.test.js +80 -0
  102. package/dist/action-providers/superfluid/superfluidSuperTokenCreatorActionProvider.d.ts +30 -0
  103. package/dist/action-providers/superfluid/superfluidSuperTokenCreatorActionProvider.js +109 -0
  104. package/dist/action-providers/superfluid/superfluidSuperTokenCreatorActionProvider.test.d.ts +1 -0
  105. package/dist/action-providers/superfluid/superfluidSuperTokenCreatorActionProvider.test.js +75 -0
  106. package/dist/action-providers/superfluid/superfluidWrapperActionProvider.d.ts +32 -0
  107. package/dist/action-providers/superfluid/superfluidWrapperActionProvider.js +101 -0
  108. package/dist/action-providers/superfluid/superfluidWrapperActionProvider.test.d.ts +1 -0
  109. package/dist/action-providers/superfluid/superfluidWrapperActionProvider.test.js +85 -0
  110. package/dist/action-providers/superfluid/utils/parseLogs.d.ts +19 -0
  111. package/dist/action-providers/superfluid/utils/parseLogs.js +81 -0
  112. package/dist/action-providers/truemarkets/truemarketsActionProvider.d.ts +4 -16
  113. package/dist/action-providers/truemarkets/truemarketsActionProvider.js +20 -41
  114. package/dist/action-providers/truemarkets/truemarketsActionProvider.test.js +11 -33
  115. package/dist/action-providers/wallet/walletActionProvider.js +24 -10
  116. package/dist/action-providers/wallet/walletActionProvider.test.js +6 -2
  117. package/dist/action-providers/x402/schemas.d.ts +7 -0
  118. package/dist/action-providers/x402/schemas.js +11 -1
  119. package/dist/action-providers/x402/utils.d.ts +55 -0
  120. package/dist/action-providers/x402/utils.js +160 -0
  121. package/dist/action-providers/x402/x402ActionProvider.d.ts +9 -9
  122. package/dist/action-providers/x402/x402ActionProvider.js +158 -39
  123. package/dist/action-providers/x402/x402ActionProvider.test.js +116 -10
  124. package/dist/action-providers/zeroX/index.d.ts +1 -0
  125. package/dist/action-providers/zeroX/index.js +17 -0
  126. package/dist/action-providers/zeroX/schemas.d.ts +51 -0
  127. package/dist/action-providers/zeroX/schemas.js +82 -0
  128. package/dist/action-providers/zeroX/utils.d.ts +23 -0
  129. package/dist/action-providers/zeroX/utils.js +106 -0
  130. package/dist/action-providers/zeroX/zeroXActionProvider.d.ts +57 -0
  131. package/dist/action-providers/zeroX/zeroXActionProvider.js +407 -0
  132. package/dist/action-providers/zeroX/zeroXActionProvider.test.d.ts +1 -0
  133. package/dist/action-providers/zeroX/zeroXActionProvider.test.js +445 -0
  134. package/dist/utils.d.ts +10 -0
  135. package/dist/utils.js +43 -13
  136. package/dist/wallet-providers/cdpEvmWalletProvider.d.ts +27 -2
  137. package/dist/wallet-providers/cdpEvmWalletProvider.js +54 -36
  138. package/dist/wallet-providers/cdpEvmWalletProvider.test.js +7 -0
  139. package/dist/wallet-providers/cdpShared.d.ts +5 -0
  140. package/dist/wallet-providers/cdpSmartWalletProvider.d.ts +29 -3
  141. package/dist/wallet-providers/cdpSmartWalletProvider.js +66 -25
  142. package/dist/wallet-providers/cdpSmartWalletProvider.test.js +6 -10
  143. package/dist/wallet-providers/cdpSolanaWalletProvider.d.ts +1 -1
  144. package/dist/wallet-providers/cdpSolanaWalletProvider.js +7 -7
  145. package/dist/wallet-providers/cdpSolanaWalletProvider.test.js +15 -12
  146. package/dist/wallet-providers/evmWalletProvider.d.ts +13 -2
  147. package/dist/wallet-providers/evmWalletProvider.js +4 -0
  148. package/dist/wallet-providers/legacyCdpSmartWalletProvider.d.ts +18 -2
  149. package/dist/wallet-providers/legacyCdpSmartWalletProvider.js +23 -2
  150. package/dist/wallet-providers/legacyCdpWalletProvider.d.ts +19 -2
  151. package/dist/wallet-providers/legacyCdpWalletProvider.js +27 -2
  152. package/dist/wallet-providers/legacyCdpWalletProvider.test.js +6 -0
  153. package/dist/wallet-providers/privyEvmDelegatedEmbeddedWalletProvider.d.ts +17 -2
  154. package/dist/wallet-providers/privyEvmDelegatedEmbeddedWalletProvider.js +39 -3
  155. package/dist/wallet-providers/privyEvmDelegatedEmbeddedWalletProvider.test.js +1 -1
  156. package/dist/wallet-providers/privyEvmWalletProvider.d.ts +2 -0
  157. package/dist/wallet-providers/privyEvmWalletProvider.js +2 -1
  158. package/dist/wallet-providers/privyEvmWalletProvider.test.js +12 -1
  159. package/dist/wallet-providers/solanaKeypairWalletProvider.d.ts +1 -1
  160. package/dist/wallet-providers/solanaKeypairWalletProvider.js +3 -4
  161. package/dist/wallet-providers/solanaKeypairWalletProvider.test.js +4 -2
  162. package/dist/wallet-providers/viemWalletProvider.d.ts +20 -3
  163. package/dist/wallet-providers/viemWalletProvider.js +33 -4
  164. package/dist/wallet-providers/viemWalletProvider.test.js +27 -6
  165. package/dist/wallet-providers/walletProvider.d.ts +1 -1
  166. package/dist/wallet-providers/zeroDevWalletProvider.d.ts +17 -2
  167. package/dist/wallet-providers/zeroDevWalletProvider.js +26 -5
  168. package/dist/wallet-providers/zeroDevWalletProvider.test.js +12 -2
  169. package/package.json +8 -4
@@ -8,12 +8,6 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
8
8
  var __metadata = (this && this.__metadata) || function (k, v) {
9
9
  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
10
10
  };
11
- var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
12
- if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
13
- if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
14
- return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
15
- };
16
- var _CdpApiActionProvider_instances, _CdpApiActionProvider_getCdpSdkNetwork;
17
11
  Object.defineProperty(exports, "__esModule", { value: true });
18
12
  exports.cdpApiActionProvider = exports.CdpApiActionProvider = void 0;
19
13
  const zod_1 = require("zod");
@@ -33,14 +27,13 @@ class CdpApiActionProvider extends actionProvider_1.ActionProvider {
33
27
  */
34
28
  constructor() {
35
29
  super("cdp_api", []);
36
- _CdpApiActionProvider_instances.add(this);
37
30
  /**
38
- * Checks if the Cdp action provider supports the given network.
31
+ * Checks if the CDP action provider supports the given network.
39
32
  *
40
33
  * NOTE: Network scoping is done at the action implementation level
41
34
  *
42
35
  * @param _ - The network to check.
43
- * @returns True if the Cdp action provider supports the network, false otherwise.
36
+ * @returns True if the CDP action provider supports the network, false otherwise.
44
37
  */
45
38
  this.supportsNetwork = (_) => true;
46
39
  }
@@ -84,66 +77,8 @@ class CdpApiActionProvider extends actionProvider_1.ActionProvider {
84
77
  throw new Error("Wallet provider is not a CDP Wallet Provider.");
85
78
  }
86
79
  }
87
- /**
88
- * Swaps tokens using the CDP client.
89
- *
90
- * @param walletProvider - The wallet provider to perform the swap with.
91
- * @param args - The input arguments for the swap action.
92
- * @returns A confirmation message with transaction details.
93
- */
94
- async swap(walletProvider, args) {
95
- const network = walletProvider.getNetwork();
96
- const networkId = network.networkId;
97
- if ((0, cdpShared_1.isWalletProviderWithClient)(walletProvider)) {
98
- if (network.protocolFamily === "evm") {
99
- try {
100
- const cdpNetwork = __classPrivateFieldGet(this, _CdpApiActionProvider_instances, "m", _CdpApiActionProvider_getCdpSdkNetwork).call(this, networkId);
101
- // Get the account for the wallet address
102
- const account = await walletProvider.getClient().evm.getAccount({
103
- address: walletProvider.getAddress(),
104
- });
105
- // Execute swap using the all-in-one pattern
106
- const swapResult = await account.swap({
107
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
108
- network: cdpNetwork,
109
- from: args.fromAssetId,
110
- to: args.toAssetId,
111
- amount: args.amount,
112
- slippageBps: 100, // 1% slippage tolerance
113
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
114
- paymasterUrl: walletProvider.getPaymasterUrl?.(),
115
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
116
- });
117
- return `Successfully swapped ${args.amount} ${args.fromAssetId.toUpperCase()} to ${args.toAssetId.toUpperCase()}. Transaction hash: ${swapResult.transactionHash}`;
118
- }
119
- catch (error) {
120
- throw new Error(`Swap failed: ${error}`);
121
- }
122
- }
123
- else {
124
- throw new Error("Swap is currently only supported on EVM networks.");
125
- }
126
- }
127
- else {
128
- throw new Error("Wallet provider is not a CDP Wallet Provider.");
129
- }
130
- }
131
80
  }
132
81
  exports.CdpApiActionProvider = CdpApiActionProvider;
133
- _CdpApiActionProvider_instances = new WeakSet(), _CdpApiActionProvider_getCdpSdkNetwork = function _CdpApiActionProvider_getCdpSdkNetwork(networkId) {
134
- switch (networkId) {
135
- case "base-sepolia":
136
- return "base-sepolia";
137
- case "base-mainnet":
138
- return "base";
139
- case "ethereum-sepolia":
140
- return "ethereum-sepolia";
141
- case "ethereum-mainnet":
142
- return "ethereum";
143
- default:
144
- return networkId; // For other networks, use as-is
145
- }
146
- };
147
82
  __decorate([
148
83
  (0, actionDecorator_1.CreateAction)({
149
84
  name: "request_faucet_funds",
@@ -159,19 +94,5 @@ from another wallet and provide the user with your wallet details.`,
159
94
  __metadata("design:paramtypes", [wallet_providers_1.WalletProvider, void 0]),
160
95
  __metadata("design:returntype", Promise)
161
96
  ], CdpApiActionProvider.prototype, "faucet", null);
162
- __decorate([
163
- (0, actionDecorator_1.CreateAction)({
164
- name: "swap",
165
- description: `This tool swaps tokens using the CDP API. It takes the wallet, from asset ID, to asset ID, and amount as input.
166
- Swaps are currently supported on EVM networks like Base and Ethereum.
167
- Example usage:
168
- - Swap 0.1 ETH to USDC: { fromAssetId: "eth", toAssetId: "usdc", amount: "0.1" }
169
- - Swap 100 USDC to ETH: { fromAssetId: "usdc", toAssetId: "eth", amount: "100" }`,
170
- schema: schemas_1.SwapSchema,
171
- }),
172
- __metadata("design:type", Function),
173
- __metadata("design:paramtypes", [wallet_providers_1.WalletProvider, void 0]),
174
- __metadata("design:returntype", Promise)
175
- ], CdpApiActionProvider.prototype, "swap", null);
176
97
  const cdpApiActionProvider = () => new CdpApiActionProvider();
177
98
  exports.cdpApiActionProvider = cdpApiActionProvider;
@@ -10,20 +10,14 @@ describe("CDP API Action Provider", () => {
10
10
  let mockCdpClient;
11
11
  beforeEach(() => {
12
12
  jest.clearAllMocks();
13
- const mockAccount = {
14
- swap: jest.fn(),
15
- };
16
13
  mockCdpClient = {
17
14
  evm: {
18
15
  requestFaucet: jest.fn(),
19
- getAccount: jest.fn(),
20
16
  },
21
17
  solana: {
22
18
  requestFaucet: jest.fn(),
23
19
  },
24
20
  };
25
- // Set up default mock behavior
26
- mockCdpClient.evm.getAccount.mockResolvedValue(mockAccount);
27
21
  mockWalletProvider = {
28
22
  getNetwork: jest.fn(),
29
23
  getAddress: jest.fn(),
@@ -93,94 +87,6 @@ describe("CDP API Action Provider", () => {
93
87
  await expect(actionProvider.faucet(mockWalletWithoutClient, { assetId: "eth" })).rejects.toThrow("Wallet provider is not a CDP Wallet Provider");
94
88
  });
95
89
  });
96
- describe("swap", () => {
97
- it("should perform swap on base-sepolia", async () => {
98
- const mockNetwork = { protocolFamily: "evm", networkId: "base-sepolia" };
99
- mockWalletProvider.getNetwork.mockReturnValue(mockNetwork);
100
- mockWalletProvider.getAddress.mockReturnValue("0x123456789");
101
- mockWalletProvider.getClient.mockReturnValue(mockCdpClient);
102
- const mockAccount = { swap: jest.fn() };
103
- mockCdpClient.evm.getAccount.mockResolvedValue(mockAccount);
104
- mockAccount.swap.mockResolvedValue({
105
- transactionHash: "0xswap123456",
106
- });
107
- const result = await actionProvider.swap(mockWalletProvider, {
108
- fromAssetId: "eth",
109
- toAssetId: "usdc",
110
- amount: "0.1",
111
- });
112
- expect(mockCdpClient.evm.getAccount).toHaveBeenCalledWith({
113
- address: "0x123456789",
114
- });
115
- expect(mockAccount.swap).toHaveBeenCalledWith({
116
- network: "base-sepolia",
117
- from: "eth",
118
- to: "usdc",
119
- amount: "0.1",
120
- slippageBps: 100,
121
- });
122
- expect(result).toContain("Successfully swapped 0.1 ETH to USDC");
123
- expect(result).toContain("0xswap123456");
124
- });
125
- it("should perform swap on base-mainnet", async () => {
126
- const mockNetwork = { protocolFamily: "evm", networkId: "base-mainnet" };
127
- mockWalletProvider.getNetwork.mockReturnValue(mockNetwork);
128
- mockWalletProvider.getAddress.mockReturnValue("0x123456789");
129
- mockWalletProvider.getClient.mockReturnValue(mockCdpClient);
130
- const mockAccount = { swap: jest.fn() };
131
- mockCdpClient.evm.getAccount.mockResolvedValue(mockAccount);
132
- mockAccount.swap.mockResolvedValue({
133
- transactionHash: "0xswap789",
134
- });
135
- const result = await actionProvider.swap(mockWalletProvider, {
136
- fromAssetId: "usdc",
137
- toAssetId: "eth",
138
- amount: "100",
139
- });
140
- expect(mockAccount.swap).toHaveBeenCalledWith({
141
- network: "base", // Should convert base-mainnet to base
142
- from: "usdc",
143
- to: "eth",
144
- amount: "100",
145
- slippageBps: 100,
146
- });
147
- expect(result).toContain("Successfully swapped 100 USDC to ETH");
148
- });
149
- it("should throw error for non-EVM networks", async () => {
150
- const mockNetwork = { protocolFamily: "svm", networkId: "solana-devnet" };
151
- mockWalletProvider.getNetwork.mockReturnValue(mockNetwork);
152
- mockWalletProvider.getClient.mockReturnValue(mockCdpClient);
153
- await expect(actionProvider.swap(mockWalletProvider, {
154
- fromAssetId: "sol",
155
- toAssetId: "usdc",
156
- amount: "1",
157
- })).rejects.toThrow("Swap is currently only supported on EVM networks");
158
- });
159
- it("should throw error for wallet provider without client", async () => {
160
- const mockWalletWithoutClient = {
161
- getNetwork: jest.fn().mockReturnValue({ protocolFamily: "evm", networkId: "base-sepolia" }),
162
- };
163
- await expect(actionProvider.swap(mockWalletWithoutClient, {
164
- fromAssetId: "eth",
165
- toAssetId: "usdc",
166
- amount: "0.1",
167
- })).rejects.toThrow("Wallet provider is not a CDP Wallet Provider");
168
- });
169
- it("should handle swap errors", async () => {
170
- const mockNetwork = { protocolFamily: "evm", networkId: "base-sepolia" };
171
- mockWalletProvider.getNetwork.mockReturnValue(mockNetwork);
172
- mockWalletProvider.getAddress.mockReturnValue("0x123456789");
173
- mockWalletProvider.getClient.mockReturnValue(mockCdpClient);
174
- const mockAccount = { swap: jest.fn() };
175
- mockCdpClient.evm.getAccount.mockResolvedValue(mockAccount);
176
- mockAccount.swap.mockRejectedValue(new Error("Insufficient liquidity"));
177
- await expect(actionProvider.swap(mockWalletProvider, {
178
- fromAssetId: "eth",
179
- toAssetId: "usdc",
180
- amount: "1000",
181
- })).rejects.toThrow("Swap failed: Error: Insufficient liquidity");
182
- });
183
- });
184
90
  describe("RequestFaucetFundsV2Schema", () => {
185
91
  it("should validate correct input", () => {
186
92
  const validInput = { assetId: "eth" };
@@ -193,35 +99,4 @@ describe("CDP API Action Provider", () => {
193
99
  expect(result.success).toBe(true);
194
100
  });
195
101
  });
196
- describe("SwapSchema", () => {
197
- it("should validate correct swap input", () => {
198
- const validInput = {
199
- fromAssetId: "eth",
200
- toAssetId: "usdc",
201
- amount: "0.1",
202
- };
203
- const result = schemas_1.SwapSchema.safeParse(validInput);
204
- expect(result.success).toBe(true);
205
- expect(result.data).toEqual(validInput);
206
- });
207
- it("should validate swap input with network", () => {
208
- const validInput = {
209
- fromAssetId: "usdc",
210
- toAssetId: "eth",
211
- amount: "100",
212
- network: "base-sepolia",
213
- };
214
- const result = schemas_1.SwapSchema.safeParse(validInput);
215
- expect(result.success).toBe(true);
216
- expect(result.data).toEqual(validInput);
217
- });
218
- it("should fail validation when missing required fields", () => {
219
- const invalidInput = {
220
- fromAssetId: "eth",
221
- // missing toAssetId and amount
222
- };
223
- const result = schemas_1.SwapSchema.safeParse(invalidInput);
224
- expect(result.success).toBe(false);
225
- });
226
- });
227
102
  });
@@ -2,7 +2,7 @@ import { z } from "zod";
2
2
  import { WalletProvider } from "../../wallet-providers";
3
3
  import { CdpEvmWalletProvider } from "../../wallet-providers/cdpEvmWalletProvider";
4
4
  import { ActionProvider } from "../actionProvider";
5
- import { UseSpendPermissionSchema, ListSpendPermissionsSchema } from "./schemas";
5
+ import { UseSpendPermissionSchema, ListSpendPermissionsSchema, SwapSchema } from "./schemas";
6
6
  import type { Network } from "../../network";
7
7
  /**
8
8
  * CdpEvmWalletActionProvider is an action provider for CDP EVM Wallet specific actions.
@@ -11,7 +11,6 @@ import type { Network } from "../../network";
11
11
  * that are optimized for EVM functionality, including spend permission usage.
12
12
  */
13
13
  export declare class CdpEvmWalletActionProvider extends ActionProvider<CdpEvmWalletProvider> {
14
- #private;
15
14
  /**
16
15
  * Constructor for the CdpEvmWalletActionProvider class.
17
16
  */
@@ -31,7 +30,23 @@ export declare class CdpEvmWalletActionProvider extends ActionProvider<CdpEvmWal
31
30
  * @param args - The input arguments for using the spend permission.
32
31
  * @returns A confirmation message with transaction details.
33
32
  */
34
- useSpendPermission(walletProvider: WalletProvider, args: z.infer<typeof UseSpendPermissionSchema>): Promise<string>;
33
+ useSpendPermission(walletProvider: CdpEvmWalletProvider, args: z.infer<typeof UseSpendPermissionSchema>): Promise<string>;
34
+ /**
35
+ * Gets a price quote for swapping tokens using the CDP Swap API.
36
+ *
37
+ * @param walletProvider - The EVM wallet provider to get the quote for.
38
+ * @param args - The input arguments for the swap price action.
39
+ * @returns A JSON string with detailed swap price quote information.
40
+ */
41
+ getSwapPrice(walletProvider: CdpEvmWalletProvider, args: z.infer<typeof SwapSchema>): Promise<string>;
42
+ /**
43
+ * Swaps tokens using the CDP client.
44
+ *
45
+ * @param walletProvider - The EVM wallet provider to perform the swap with.
46
+ * @param args - The input arguments for the swap action.
47
+ * @returns A JSON string with detailed swap execution information.
48
+ */
49
+ swap(walletProvider: CdpEvmWalletProvider, args: z.infer<typeof SwapSchema>): Promise<string>;
35
50
  /**
36
51
  * Checks if the EVM wallet action provider supports the given network.
37
52
  *
@@ -8,21 +8,19 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
8
8
  var __metadata = (this && this.__metadata) || function (k, v) {
9
9
  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
10
10
  };
11
- var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
12
- if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
13
- if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
14
- return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
15
- };
16
- var _CdpEvmWalletActionProvider_instances, _CdpEvmWalletActionProvider_getCdpSdkNetwork;
17
11
  Object.defineProperty(exports, "__esModule", { value: true });
18
12
  exports.cdpEvmWalletActionProvider = exports.CdpEvmWalletActionProvider = void 0;
19
13
  const zod_1 = require("zod");
20
14
  const wallet_providers_1 = require("../../wallet-providers");
21
15
  const cdpShared_1 = require("../../wallet-providers/cdpShared");
16
+ const cdpEvmWalletProvider_1 = require("../../wallet-providers/cdpEvmWalletProvider");
22
17
  const actionDecorator_1 = require("../actionDecorator");
23
18
  const actionProvider_1 = require("../actionProvider");
24
19
  const schemas_1 = require("./schemas");
25
20
  const spendPermissionUtils_1 = require("./spendPermissionUtils");
21
+ const swapUtils_1 = require("./swapUtils");
22
+ const viem_1 = require("viem");
23
+ const utils_1 = require("../../utils");
26
24
  /**
27
25
  * CdpEvmWalletActionProvider is an action provider for CDP EVM Wallet specific actions.
28
26
  *
@@ -35,7 +33,6 @@ class CdpEvmWalletActionProvider extends actionProvider_1.ActionProvider {
35
33
  */
36
34
  constructor() {
37
35
  super("cdp_evm_wallet", []);
38
- _CdpEvmWalletActionProvider_instances.add(this);
39
36
  /**
40
37
  * Checks if the EVM wallet action provider supports the given network.
41
38
  *
@@ -77,7 +74,7 @@ class CdpEvmWalletActionProvider extends actionProvider_1.ActionProvider {
77
74
  */
78
75
  async useSpendPermission(walletProvider, args) {
79
76
  const network = walletProvider.getNetwork();
80
- const cdpNetwork = __classPrivateFieldGet(this, _CdpEvmWalletActionProvider_instances, "m", _CdpEvmWalletActionProvider_getCdpSdkNetwork).call(this, network.networkId);
77
+ const cdpNetwork = walletProvider.getCdpSdkNetwork();
81
78
  if ((0, cdpShared_1.isWalletProviderWithClient)(walletProvider)) {
82
79
  if (network.protocolFamily === "evm") {
83
80
  try {
@@ -105,22 +102,183 @@ class CdpEvmWalletActionProvider extends actionProvider_1.ActionProvider {
105
102
  return "Wallet provider is not a CDP Wallet Provider.";
106
103
  }
107
104
  }
105
+ /**
106
+ * Gets a price quote for swapping tokens using the CDP Swap API.
107
+ *
108
+ * @param walletProvider - The EVM wallet provider to get the quote for.
109
+ * @param args - The input arguments for the swap price action.
110
+ * @returns A JSON string with detailed swap price quote information.
111
+ */
112
+ async getSwapPrice(walletProvider, args) {
113
+ // Get CDP SDK network
114
+ const network = walletProvider.getNetwork();
115
+ const networkId = network.networkId;
116
+ const cdpNetwork = walletProvider.getCdpSdkNetwork();
117
+ // Check if the network is supported
118
+ if (networkId !== "base-mainnet" && networkId !== "ethereum-mainnet")
119
+ return JSON.stringify({
120
+ success: false,
121
+ error: "CDP Swap API is currently only supported on 'base-mainnet' or 'ethereum-mainnet'.",
122
+ });
123
+ try {
124
+ // Get token details
125
+ const { fromTokenDecimals, toTokenDecimals, fromTokenName, toTokenName } = await (0, swapUtils_1.getTokenDetails)(walletProvider, args.fromToken, args.toToken);
126
+ // Get swap price quote
127
+ const swapPrice = (await walletProvider.getClient().evm.getSwapPrice({
128
+ fromToken: args.fromToken,
129
+ toToken: args.toToken,
130
+ fromAmount: (0, viem_1.parseUnits)(args.fromAmount, fromTokenDecimals),
131
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
132
+ network: cdpNetwork,
133
+ taker: walletProvider.getAddress(),
134
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
135
+ }));
136
+ const formattedResponse = {
137
+ success: true,
138
+ fromAmount: args.fromAmount,
139
+ fromTokenName: fromTokenName,
140
+ fromToken: args.fromToken,
141
+ toAmount: (0, viem_1.formatUnits)(swapPrice.toAmount, toTokenDecimals),
142
+ minToAmount: (0, viem_1.formatUnits)(swapPrice.minToAmount, toTokenDecimals),
143
+ toTokenName: toTokenName,
144
+ toToken: args.toToken,
145
+ slippageBps: args.slippageBps,
146
+ liquidityAvailable: swapPrice.liquidityAvailable,
147
+ balanceEnough: swapPrice.issues.balance === undefined,
148
+ priceOfBuyTokenInSellToken: (Number(args.fromAmount) / Number((0, viem_1.formatUnits)(swapPrice.toAmount, toTokenDecimals))).toString(),
149
+ priceOfSellTokenInBuyToken: (Number((0, viem_1.formatUnits)(swapPrice.toAmount, toTokenDecimals)) / Number(args.fromAmount)).toString(),
150
+ };
151
+ return JSON.stringify(formattedResponse);
152
+ }
153
+ catch (error) {
154
+ return JSON.stringify({
155
+ success: false,
156
+ error: `Error fetching swap price: ${error}`,
157
+ });
158
+ }
159
+ }
160
+ /**
161
+ * Swaps tokens using the CDP client.
162
+ *
163
+ * @param walletProvider - The EVM wallet provider to perform the swap with.
164
+ * @param args - The input arguments for the swap action.
165
+ * @returns A JSON string with detailed swap execution information.
166
+ */
167
+ async swap(walletProvider, args) {
168
+ // Get CDP SDK network
169
+ const network = walletProvider.getNetwork();
170
+ const networkId = network.networkId;
171
+ const cdpNetwork = walletProvider.getCdpSdkNetwork();
172
+ // Check if the network is supported
173
+ if (networkId !== "base-mainnet" && networkId !== "ethereum-mainnet")
174
+ return JSON.stringify({
175
+ success: false,
176
+ error: "CDP Swap API is currently only supported on 'base-mainnet' or 'ethereum-mainnet'.",
177
+ });
178
+ try {
179
+ // Get token details
180
+ const { fromTokenDecimals, fromTokenName, toTokenName, toTokenDecimals } = await (0, swapUtils_1.getTokenDetails)(walletProvider, args.fromToken, args.toToken);
181
+ // Get the account
182
+ const account = await walletProvider.getClient().evm.getAccount({
183
+ address: walletProvider.getAddress(),
184
+ });
185
+ // Estimate swap price first to check liquidity, token balance and permit2 approval status
186
+ const swapPrice = await walletProvider.getClient().evm.getSwapPrice({
187
+ fromToken: args.fromToken,
188
+ toToken: args.toToken,
189
+ fromAmount: (0, viem_1.parseUnits)(args.fromAmount, fromTokenDecimals),
190
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
191
+ network: cdpNetwork,
192
+ taker: account.address,
193
+ });
194
+ // Check if liquidity is available
195
+ if (!swapPrice.liquidityAvailable) {
196
+ return JSON.stringify({
197
+ success: false,
198
+ error: `No liquidity available to swap ${args.fromAmount} ${fromTokenName} (${args.fromToken}) to ${toTokenName} (${args.toToken})`,
199
+ });
200
+ }
201
+ // Check if balance is enough
202
+ if (swapPrice.issues.balance) {
203
+ return JSON.stringify({
204
+ success: false,
205
+ error: `Balance is not enough to perform swap. Required: ${args.fromAmount} ${fromTokenName}, but only have ${(0, viem_1.formatUnits)(swapPrice.issues.balance.currentBalance, fromTokenDecimals)} ${fromTokenName} (${args.fromToken})`,
206
+ });
207
+ }
208
+ // Check if allowance is enough
209
+ let approvalTxHash = null;
210
+ if (swapPrice.issues.allowance) {
211
+ try {
212
+ approvalTxHash = await walletProvider.sendTransaction({
213
+ to: args.fromToken,
214
+ data: (0, viem_1.encodeFunctionData)({
215
+ abi: viem_1.erc20Abi,
216
+ functionName: "approve",
217
+ args: [swapUtils_1.PERMIT2_ADDRESS, viem_1.maxUint256],
218
+ }),
219
+ });
220
+ const receipt = await walletProvider.waitForTransactionReceipt(approvalTxHash);
221
+ if (receipt.status !== "success") {
222
+ return JSON.stringify({
223
+ success: false,
224
+ error: `Approval transaction failed`,
225
+ });
226
+ }
227
+ }
228
+ catch (error) {
229
+ return JSON.stringify({
230
+ success: false,
231
+ error: `Error approving token: ${error}`,
232
+ });
233
+ }
234
+ }
235
+ // Execute swap using the all-in-one pattern with retry logic
236
+ const swapResult = await (0, utils_1.retryWithExponentialBackoff)(async () => {
237
+ return (await account.swap({
238
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
239
+ network: cdpNetwork,
240
+ fromToken: args.fromToken,
241
+ toToken: args.toToken,
242
+ fromAmount: (0, viem_1.parseUnits)(args.fromAmount, fromTokenDecimals),
243
+ slippageBps: args.slippageBps,
244
+ signerAddress: account.address,
245
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
246
+ }));
247
+ }, 3, 5000); // Max 3 retries with 5s base delay
248
+ // Check if swap was successful
249
+ const swapReceipt = await walletProvider.waitForTransactionReceipt(swapResult.transactionHash);
250
+ if (swapReceipt.status !== "success") {
251
+ return JSON.stringify({
252
+ success: false,
253
+ error: `Swap transaction failed`,
254
+ });
255
+ }
256
+ // Format the successful response
257
+ const formattedResponse = {
258
+ success: true,
259
+ ...(approvalTxHash ? { approvalTxHash } : {}),
260
+ transactionHash: swapResult.transactionHash,
261
+ fromAmount: args.fromAmount,
262
+ fromTokenName: fromTokenName,
263
+ fromToken: args.fromToken,
264
+ toAmount: (0, viem_1.formatUnits)(swapPrice.toAmount, toTokenDecimals),
265
+ minToAmount: (0, viem_1.formatUnits)(swapPrice.minToAmount, toTokenDecimals),
266
+ toTokenName: toTokenName,
267
+ toToken: args.toToken,
268
+ slippageBps: args.slippageBps,
269
+ network: networkId,
270
+ };
271
+ return JSON.stringify(formattedResponse);
272
+ }
273
+ catch (error) {
274
+ return JSON.stringify({
275
+ success: false,
276
+ error: `Swap failed: ${error}`,
277
+ });
278
+ }
279
+ }
108
280
  }
109
281
  exports.CdpEvmWalletActionProvider = CdpEvmWalletActionProvider;
110
- _CdpEvmWalletActionProvider_instances = new WeakSet(), _CdpEvmWalletActionProvider_getCdpSdkNetwork = function _CdpEvmWalletActionProvider_getCdpSdkNetwork(networkId) {
111
- switch (networkId) {
112
- case "base-sepolia":
113
- return "base-sepolia";
114
- case "base-mainnet":
115
- return "base";
116
- case "ethereum-sepolia":
117
- return "ethereum-sepolia";
118
- case "ethereum-mainnet":
119
- return "ethereum";
120
- default:
121
- return networkId; // For other networks, use as-is
122
- }
123
- };
124
282
  __decorate([
125
283
  (0, actionDecorator_1.CreateAction)({
126
284
  name: "list_spend_permissions",
@@ -144,8 +302,51 @@ This action is specifically designed for EVM wallets and uses the EVM wallet for
144
302
  schema: schemas_1.UseSpendPermissionSchema,
145
303
  }),
146
304
  __metadata("design:type", Function),
147
- __metadata("design:paramtypes", [wallet_providers_1.WalletProvider, void 0]),
305
+ __metadata("design:paramtypes", [cdpEvmWalletProvider_1.CdpEvmWalletProvider, void 0]),
148
306
  __metadata("design:returntype", Promise)
149
307
  ], CdpEvmWalletActionProvider.prototype, "useSpendPermission", null);
308
+ __decorate([
309
+ (0, actionDecorator_1.CreateAction)({
310
+ name: "get_swap_price",
311
+ description: `
312
+ This tool fetches a price quote for swapping (trading) between two tokens using the CDP Swap API but does not execute a swap.
313
+ It takes the following inputs:
314
+ - fromToken: The contract address of the token to sell
315
+ - toToken: The contract address of the token to buy
316
+ - fromAmount: The amount of fromToken to swap in whole units (e.g. 1 ETH or 10.5 USDC)
317
+ - slippageBps: (Optional) Maximum allowed slippage in basis points (100 = 1%)
318
+ Important notes:
319
+ - The contract address for native ETH is "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
320
+ - Use fromAmount units exactly as provided, do not convert to wei or any other units
321
+ - Never assume token or address, they have to be provided as inputs. If only token symbol is provided, use the get_token_address tool if available to get the token address first
322
+ `,
323
+ schema: schemas_1.SwapSchema,
324
+ }),
325
+ __metadata("design:type", Function),
326
+ __metadata("design:paramtypes", [cdpEvmWalletProvider_1.CdpEvmWalletProvider, void 0]),
327
+ __metadata("design:returntype", Promise)
328
+ ], CdpEvmWalletActionProvider.prototype, "getSwapPrice", null);
329
+ __decorate([
330
+ (0, actionDecorator_1.CreateAction)({
331
+ name: "swap",
332
+ description: `
333
+ This tool executes a token swap (trade) using the CDP Swap API.
334
+ It takes the following inputs:
335
+ - fromToken: The contract address of the token to sell
336
+ - toToken: The contract address of the token to buy
337
+ - fromAmount: The amount of fromToken to swap in whole units (e.g. 1 ETH or 10.5 USDC)
338
+ - slippageBps: (Optional) Maximum allowed slippage in basis points (100 = 1%)
339
+ Important notes:
340
+ - The contract address for native ETH is "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
341
+ - If needed, it will automatically approve the permit2 contract to spend the fromToken
342
+ - Use fromAmount units exactly as provided, do not convert to wei or any other units.
343
+ - Never assume token or address, they have to be provided as inputs. If only token symbol is provided, use the get_token_address tool if available to get the token address first
344
+ `,
345
+ schema: schemas_1.SwapSchema,
346
+ }),
347
+ __metadata("design:type", Function),
348
+ __metadata("design:paramtypes", [cdpEvmWalletProvider_1.CdpEvmWalletProvider, void 0]),
349
+ __metadata("design:returntype", Promise)
350
+ ], CdpEvmWalletActionProvider.prototype, "swap", null);
150
351
  const cdpEvmWalletActionProvider = () => new CdpEvmWalletActionProvider();
151
352
  exports.cdpEvmWalletActionProvider = cdpEvmWalletActionProvider;