@coinbase/agentkit 0.9.0 → 0.9.1

package/README.md

@@ -261,7 +261,7 @@ const agent = createReactAgent({
 </tr>
 <tr>
     <td width="200"><code>post_cast</code></td>
-    <td width="768">Creates a new cast (message) on Farcaster with up to 280 characters.</td>
+    <td width="768">Creates a new cast (message) on Farcaster with up to 280 characters and support for up to 2 embedded URLs.</td>
 </tr>
 </table>
 </details>
@@ -362,6 +362,23 @@ const agent = createReactAgent({
     <td width="200"><code>post_tweet_reply</code></td>
     <td width="768">Creates a reply to an existing tweet using the tweet's unique identifier.</td>
 </tr>
+<tr>
+    <td width="200"><code>upload_media</code></td>
+    <td width="768">Uploads media (images, videos) to Twitter that can be attached to tweets.</td>
+</tr>
+</table>
+</details>
+<details>
+<summary><strong>TrueMarkets</strong></summary>
+<table width="100%">
+<tr>
+    <td width="200"><code>get_active_markets</code></td>
+    <td width="768">Retrieves active prediction markets from Truemarkets with pagination and sorting options.</td>
+</tr>
+<tr>
+    <td width="200"><code>get_market_details</code></td>
+    <td width="768">Fetches comprehensive details for a specific Truemarkets prediction market including question, status, prices, and liquidity.</td>
+</tr>
 </table>
 </details>
 <details>
@@ -384,6 +401,10 @@ const agent = createReactAgent({
     <td width="200"><code>wrap_eth</code></td>
     <td width="768">Converts native ETH to Wrapped ETH (WETH) on Base Sepolia or Base Mainnet.</td>
 </tr>
+<tr>
+    <td width="200"><code>unwrap_eth</code></td>
+    <td width="768">Converts Wrapped ETH (WETH) to Native ETH on Base Sepolia or Base Mainnet.</td>
+</tr>
 </table>
 </details>
 <details>
@@ -439,6 +460,15 @@ it will return payment details that can be used on retry.</td>
 </tr>
 </table>
 </details>
+<details>
+<summary><strong>Zora</strong></summary>
+<table width="100%">
+<tr>
+    <td width="200"><code>coinIt</code></td>
+    <td width="768">Creates a new Zora coin with customizable name, symbol, description, and image.</td>
+</tr>
+</table>
+</details>
 
 ## Creating an Action Provider
 

package/dist/action-providers/farcaster/farcasterActionProvider.js

@@ -90,6 +90,7 @@ class FarcasterActionProvider extends actionProvider_1.ActionProvider {
                 body: JSON.stringify({
                     signer_uuid: this.signerUuid,
                     text: args.castText,
+                    embeds: args.embeds,
                 }),
             });
             const data = await response.json();
@@ -125,6 +126,7 @@ __decorate([
         name: "post_cast",
         description: `
 This tool will post a cast to Farcaster. The tool takes the text of the cast as input. Casts can be maximum 280 characters.
+Optionally, up to 2 embeds (links to websites or mini apps) can be attached to the cast by providing an array of URLs in the embeds parameter.
 
 A successful response will return a message with the API response as a JSON payload:
     {}

package/dist/action-providers/farcaster/farcasterActionProvider.test.js

@@ -23,6 +23,35 @@ describe("Farcaster Action Provider Input Schemas", () => {
             expect(result.success).toBe(true);
             expect(result.data).toEqual(validInput);
         });
+        it("should successfully parse valid cast text with embeds", () => {
+            const validInput = {
+                castText: "Hello, Farcaster!",
+                embeds: [{ url: "https://example.com" }],
+            };
+            const result = schemas_1.FarcasterPostCastSchema.safeParse(validInput);
+            expect(result.success).toBe(true);
+            expect(result.data).toEqual(validInput);
+        });
+        it("should fail when embed URL is invalid", () => {
+            const invalidInput = {
+                castText: "Hello, Farcaster!",
+                embeds: [{ url: "invalid-url" }],
+            };
+            const result = schemas_1.FarcasterPostCastSchema.safeParse(invalidInput);
+            expect(result.success).toBe(false);
+        });
+        it("should fail when there are more than 2 embeds", () => {
+            const invalidInput = {
+                castText: "Hello, Farcaster!",
+                embeds: [
+                    { url: "https://example1.com" },
+                    { url: "https://example2.com" },
+                    { url: "https://example3.com" },
+                ],
+            };
+            const result = schemas_1.FarcasterPostCastSchema.safeParse(invalidInput);
+            expect(result.success).toBe(false);
+        });
         it("should fail parsing cast text over 280 characters", () => {
             const invalidInput = {
                 castText: "a".repeat(281),
@@ -100,6 +129,32 @@ describe("Farcaster Action Provider", () => {
                 body: JSON.stringify({
                     signer_uuid: mockConfig.signerUuid,
                     text: args.castText,
+                    embeds: undefined,
+                }),
+            });
+            expect(mockFetch).toHaveBeenCalledTimes(1);
+            expect(result).toContain("Successfully posted cast to Farcaster");
+            expect(result).toContain(JSON.stringify(mockCastResponse));
+        });
+        it("should successfully post a cast with embeds", async () => {
+            mockFetch.mockResolvedValueOnce({
+                json: () => Promise.resolve(mockCastResponse),
+            });
+            const args = {
+                castText: "Hello, Farcaster!",
+                embeds: [{ url: "https://example.com" }],
+            };
+            const result = await actionProvider.postCast(args);
+            expect(mockFetch).toHaveBeenCalledWith("https://api.neynar.com/v2/farcaster/cast", {
+                method: "POST",
+                headers: {
+                    api_key: mockConfig.neynarApiKey,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify({
+                    signer_uuid: mockConfig.signerUuid,
+                    text: args.castText,
+                    embeds: args.embeds,
                 }),
             });
             expect(mockFetch).toHaveBeenCalledTimes(1);

package/dist/action-providers/farcaster/schemas.d.ts

@@ -8,8 +8,21 @@ export declare const FarcasterAccountDetailsSchema: z.ZodObject<{}, "strip", z.Z
  */
 export declare const FarcasterPostCastSchema: z.ZodObject<{
     castText: z.ZodString;
+    embeds: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+    }, {
+        url: string;
+    }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     castText: string;
+    embeds?: {
+        url: string;
+    }[] | undefined;
 }, {
     castText: string;
+    embeds?: {
+        url: string;
+    }[] | undefined;
 }>;

package/dist/action-providers/farcaster/schemas.js

@@ -15,6 +15,12 @@ exports.FarcasterAccountDetailsSchema = zod_1.z
 exports.FarcasterPostCastSchema = zod_1.z
     .object({
     castText: zod_1.z.string().max(280, "Cast text must be a maximum of 280 characters."),
+    embeds: zod_1.z
+        .array(zod_1.z.object({
+        url: zod_1.z.string().url("Embed URL must be a valid URL"),
+    }))
+        .max(2, "Maximum of 2 embeds allowed")
+        .optional(),
 })
     .strip()
     .describe("Input schema for posting a text-based cast");

package/dist/action-providers/index.d.ts

@@ -18,6 +18,7 @@ export * from "./moonwell";
 export * from "./morpho";
 export * from "./opensea";
 export * from "./spl";
+export * from "./truemarkets";
 export * from "./twitter";
 export * from "./wallet";
 export * from "./weth";
@@ -28,3 +29,4 @@ export * from "./onramp";
 export * from "./vaultsfyi";
 export * from "./x402";
 export * from "./zerodev";
+export * from "./zora";

package/dist/action-providers/index.js

@@ -34,6 +34,7 @@ __exportStar(require("./moonwell"), exports);
 __exportStar(require("./morpho"), exports);
 __exportStar(require("./opensea"), exports);
 __exportStar(require("./spl"), exports);
+__exportStar(require("./truemarkets"), exports);
 __exportStar(require("./twitter"), exports);
 __exportStar(require("./wallet"), exports);
 __exportStar(require("./weth"), exports);
@@ -44,3 +45,4 @@ __exportStar(require("./onramp"), exports);
 __exportStar(require("./vaultsfyi"), exports);
 __exportStar(require("./x402"), exports);
 __exportStar(require("./zerodev"), exports);
+__exportStar(require("./zora"), exports);

package/dist/action-providers/truemarkets/constants.d.ts

@@ -0,0 +1,179 @@
+export declare const TruthMarketABI: ({
+    readonly name: "marketQuestion";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "string";
+    }];
+} | {
+    readonly name: "marketSource";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "string";
+    }];
+} | {
+    readonly name: "getCurrentStatus";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "uint8";
+    }];
+} | {
+    readonly name: "endOfTrading";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+} | {
+    readonly name: "getPoolAddresses";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "address";
+        readonly name: "yesPool";
+    }, {
+        readonly type: "address";
+        readonly name: "noPool";
+    }];
+} | {
+    readonly name: "paymentToken";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "address";
+    }];
+} | {
+    readonly name: "additionalInfo";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "string";
+    }];
+} | {
+    readonly name: "winningPosition";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "uint8";
+    }];
+})[];
+export declare const TruthMarketManagerABI: ({
+    readonly name: "numberOfActiveMarkets";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+} | {
+    readonly name: "getActiveMarketAddress";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "address";
+    }];
+} | {
+    readonly name: "creatorAddress";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "address";
+    }];
+} | {
+    readonly name: "resolverAddress";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "address";
+    }];
+})[];
+export declare const UniswapV3PoolABI: ({
+    readonly name: "liquidity";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "uint128";
+    }];
+} | {
+    readonly name: "slot0";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "uint160";
+        readonly name: "sqrtPriceX96";
+    }, {
+        readonly type: "int24";
+        readonly name: "tick";
+    }, {
+        readonly type: "uint16";
+        readonly name: "observationIndex";
+    }, {
+        readonly type: "uint16";
+        readonly name: "observationCardinality";
+    }, {
+        readonly type: "uint16";
+        readonly name: "observationCardinalityNext";
+    }, {
+        readonly type: "uint8";
+        readonly name: "feeProtocol";
+    }, {
+        readonly type: "bool";
+        readonly name: "unlocked";
+    }];
+} | {
+    readonly name: "token0";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "address";
+    }];
+} | {
+    readonly name: "token1";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "address";
+    }];
+})[];
+export declare const TruthMarketManager_ADDRESS = "0x61A98Bef11867c69489B91f340fE545eEfc695d7";
+export declare const USDC_ADDRESS = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+export declare const TYD_ADDRESS = "0xb13CF163d916917d9cD6E836905cA5f12a1dEF4B";
+export declare const USDC_DECIMALS = 6;
+export declare const TYD_DECIMALS = 6;
+export declare const YESNO_DECIMALS = 18;
+/**
+ * Market status enum
+ */
+export declare const MarketStatus: {
+    Created: number;
+    OpenForResolution: number;
+    ResolutionProposed: number;
+    DisputeRaised: number;
+    SetByCouncil: number;
+    ResetByCouncil: number;
+    EscalatedDisputeRaised: number;
+    Finalized: number;
+};

package/dist/action-providers/truemarkets/constants.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MarketStatus = exports.YESNO_DECIMALS = exports.TYD_DECIMALS = exports.USDC_DECIMALS = exports.TYD_ADDRESS = exports.USDC_ADDRESS = exports.TruthMarketManager_ADDRESS = exports.UniswapV3PoolABI = exports.TruthMarketManagerABI = exports.TruthMarketABI = void 0;
+const viem_1 = require("viem");
+// Simplified ABIs
+exports.TruthMarketABI = [
+    (0, viem_1.parseAbiItem)("function marketQuestion() view returns (string)"),
+    (0, viem_1.parseAbiItem)("function marketSource() view returns (string)"),
+    (0, viem_1.parseAbiItem)("function getCurrentStatus() view returns (uint8)"),
+    (0, viem_1.parseAbiItem)("function endOfTrading() view returns (uint256)"),
+    (0, viem_1.parseAbiItem)("function getPoolAddresses() view returns (address yesPool, address noPool)"),
+    (0, viem_1.parseAbiItem)("function paymentToken() view returns (address)"),
+    (0, viem_1.parseAbiItem)("function additionalInfo() view returns (string)"),
+    (0, viem_1.parseAbiItem)("function winningPosition() view returns (uint8)"),
+];
+exports.TruthMarketManagerABI = [
+    (0, viem_1.parseAbiItem)("function numberOfActiveMarkets() view returns (uint256)"),
+    (0, viem_1.parseAbiItem)("function getActiveMarketAddress(uint256) view returns (address)"),
+    (0, viem_1.parseAbiItem)("function creatorAddress(address) view returns (address)"),
+    (0, viem_1.parseAbiItem)("function resolverAddress(address) view returns (address)"),
+];
+exports.UniswapV3PoolABI = [
+    (0, viem_1.parseAbiItem)("function liquidity() view returns (uint128)"),
+    (0, viem_1.parseAbiItem)("function slot0() view returns (uint160 sqrtPriceX96, int24 tick, uint16 observationIndex, uint16 observationCardinality, uint16 observationCardinalityNext, uint8 feeProtocol, bool unlocked)"),
+    (0, viem_1.parseAbiItem)("function token0() view returns (address)"),
+    (0, viem_1.parseAbiItem)("function token1() view returns (address)"),
+];
+exports.TruthMarketManager_ADDRESS = "0x61A98Bef11867c69489B91f340fE545eEfc695d7";
+exports.USDC_ADDRESS = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+exports.TYD_ADDRESS = "0xb13CF163d916917d9cD6E836905cA5f12a1dEF4B";
+exports.USDC_DECIMALS = 6;
+exports.TYD_DECIMALS = 6;
+exports.YESNO_DECIMALS = 18;
+/**
+ * Market status enum
+ */
+exports.MarketStatus = {
+    Created: 0,
+    OpenForResolution: 1,
+    ResolutionProposed: 2,
+    DisputeRaised: 3,
+    SetByCouncil: 4,
+    ResetByCouncil: 5,
+    EscalatedDisputeRaised: 6,
+    Finalized: 7,
+};

package/dist/action-providers/truemarkets/index.d.ts

@@ -0,0 +1 @@
+export * from "./truemarketsActionProvider";

package/dist/action-providers/truemarkets/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./truemarketsActionProvider"), exports);

package/dist/action-providers/truemarkets/schemas.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod";
+/**
+ * Input schema for get active markets action.
+ */
+export declare const GetTruthMarketsSchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    sortOrder: z.ZodDefault<z.ZodOptional<z.ZodEnum<["asc", "desc"]>>>;
+}, "strip", z.ZodTypeAny, {
+    offset: number;
+    limit: number;
+    sortOrder: "asc" | "desc";
+}, {
+    offset?: number | undefined;
+    limit?: number | undefined;
+    sortOrder?: "asc" | "desc" | undefined;
+}>;
+/**
+ * Input schema for get market details action.
+ */
+export declare const GetTruthMarketDetailsSchema: z.ZodString;

package/dist/action-providers/truemarkets/schemas.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetTruthMarketDetailsSchema = exports.GetTruthMarketsSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Input schema for get active markets action.
+ */
+exports.GetTruthMarketsSchema = zod_1.z
+    .object({
+    limit: zod_1.z
+        .number()
+        .optional()
+        .describe("Maximum number of markets to return (default: 10)")
+        .default(10),
+    offset: zod_1.z.number().optional().describe("Number of markets to skip (for pagination)").default(0),
+    sortOrder: zod_1.z
+        .enum(["asc", "desc"])
+        .optional()
+        .describe("Sort order for the markets (default: desc)")
+        .default("desc"),
+})
+    .strip()
+    .describe("Instructions for getting prediction markets on Truemarkets");
+/**
+ * Input schema for get market details action.
+ */
+exports.GetTruthMarketDetailsSchema = zod_1.z
+    .string()
+    .describe("Prediction market address (0x...) or market ID (number) to retrieve details for");

package/dist/action-providers/truemarkets/truemarketsActionProvider.d.ts

@@ -0,0 +1,51 @@
+import { z } from "zod";
+import { ActionProvider } from "../actionProvider";
+import { Network } from "../../network";
+import { GetTruthMarketsSchema, GetTruthMarketDetailsSchema } from "./schemas";
+import { EvmWalletProvider } from "../../wallet-providers";
+/**
+ * Configuration options for the TrueMarketsActionProvider.
+ */
+export interface TrueMarketsActionProviderConfig {
+    /**
+     * RPC URL for creating the Viem public client
+     */
+    RPC_URL?: string;
+}
+/**
+ * TrueMarketsActionProvider provides actions to interact with TrueMarkets contracts.
+ */
+export declare class TrueMarketsActionProvider extends ActionProvider<EvmWalletProvider> {
+    #private;
+    /**
+     * Constructor for the TrueMarketsActionProvider.
+     *
+     * @param config - The configuration options for the TrueMarketsActionProvider.
+     */
+    constructor(config?: TrueMarketsActionProviderConfig);
+    /**
+     * Gets active markets from the TruthMarketManager contract.
+     *
+     * @param walletProvider - The wallet provider to use for contract interactions.
+     * @param args - The input arguments for the action, including pagination and sorting options.
+     * @returns JSON object containing the active markets information.
+     */
+    getPredictionMarkets(walletProvider: EvmWalletProvider, args: z.infer<typeof GetTruthMarketsSchema>): Promise<string>;
+    /**
+     * Gets detailed information for a specific market address.
+     *
+     * @param walletProvider - The wallet provider to use for contract interactions.
+     * @param args - The input arguments for the action, containing the market address.
+     * @returns JSON object containing detailed market information.
+     */
+    getPredictionMarketDetails(walletProvider: EvmWalletProvider, args: z.infer<typeof GetTruthMarketDetailsSchema>): Promise<string>;
+    /**
+     * Checks if the TrueMarkets action provider supports the given network.
+     * Currently only supports Base mainnet.
+     *
+     * @param network - The network to check.
+     * @returns True if the TrueMarkets action provider supports the network, false otherwise.
+     */
+    supportsNetwork: (network: Network) => boolean;
+}
+export declare const truemarketsActionProvider: (config?: TrueMarketsActionProviderConfig) => TrueMarketsActionProvider;