@zakyirsyaad/monagent-plugin 0.1.0 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zakyirsyaad/monagent-plugin",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "description": "MetaMask Agent Wallet Plugin for Monad A2A Commerce & Trust (ERC-8004 & x402)",
   "type": "module",
   "keywords": [
@@ -18,19 +18,23 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsc -p ../../tsconfig.json --noEmit",
+    "build": "tsc -p tsconfig.json && oclif manifest",
     "test": "tsx --test \"src/**/*.test.ts\""
   },
   "dependencies": {
-    "@zakyirsyaad/monagent-shared": "0.1.3",
+    "@x402/core": "^2.18.0",
+    "@x402/evm": "^2.18.0",
     "viem": "2.55.8",
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@metamask/agent-wallet": "^6.2.0"
+    "@metamask/agent-wallet": "^6.2.0 || ^7.0.0"
   },
   "devDependencies": {
+    "@metamask/agent-wallet": "^6.2.1",
+    "@oclif/core": "^4.14.0",
     "@types/node": "^26.1.0",
+    "oclif": "^4.24.0",
     "tsx": "^4.22.4",
     "typescript": "^6.0.3"
   },
@@ -41,7 +45,7 @@
   },
   "mm": {
     "schemaVersion": 1,
-    "minCliVersion": "^6.2.0",
+    "minCliVersion": "^6.2.0 || ^7.0.0",
     "capabilities": [],
     "commands": [
       {
@@ -54,7 +58,8 @@
           "balances"
         ],
         "targetChains": [
-          10143
+          10143,
+          143
         ]
       },
       {
@@ -67,7 +72,8 @@
           "accounts"
         ],
         "targetChains": [
-          10143
+          10143,
+          143
         ]
       },
       {
@@ -79,7 +85,8 @@
           "accounts"
         ],
         "targetChains": [
-          10143
+          10143,
+          143
         ]
       },
       {
@@ -89,7 +96,8 @@
         ],
         "dataAccess": [],
         "targetChains": [
-          10143
+          10143,
+          143
         ]
       },
       {
@@ -102,7 +110,8 @@
           "accounts"
         ],
         "targetChains": [
-          10143
+          10143,
+          143
         ]
       },
       {
@@ -115,7 +124,8 @@
           "balances"
         ],
         "targetChains": [
-          10143
+          10143,
+          143
         ]
       },
       {
@@ -130,6 +140,32 @@
         "targetChains": [
           10143
         ]
+      },
+      {
+        "id": "monad:jobs:complete",
+        "capabilities": [
+          "wallet-read",
+          "wallet-submit"
+        ],
+        "dataAccess": [
+          "balances"
+        ],
+        "targetChains": [
+          10143
+        ]
+      },
+      {
+        "id": "monad:jobs:refund",
+        "capabilities": [
+          "wallet-read",
+          "wallet-submit"
+        ],
+        "dataAccess": [
+          "balances"
+        ],
+        "targetChains": [
+          10143
+        ]
       }
     ]
   }

package/dist/commands/identity/get.d.ts

@@ -1,13 +0,0 @@
-import { type MonadAgentCard } from "@monagent/shared";
-import { PluginCommand, type CommandIO } from "../../sdk.js";
-export interface GetIdentityResult {
-    agentId: string;
-    owner: string;
-    walletAddress: string;
-    card?: MonadAgentCard;
-}
-export declare class MonadIdentityGetCommand extends PluginCommand<GetIdentityResult> {
-    static description: string;
-    protected readonly pluginCommandId = "monad:identity:get";
-    execute(io: CommandIO): Promise<GetIdentityResult>;
-}

package/dist/commands/identity/get.js

@@ -1,59 +0,0 @@
-import { parseAbi } from "viem";
-import { z } from "zod";
-import { MONAD_TESTNET_CHAIN_ID, MONAD_TESTNET_ERC8004_IDENTITY_REGISTRY, monadAgentCardSchema, } from "@monagent/shared";
-import { PluginCommand } from "../../sdk.js";
-const erc8004IdentityAbi = parseAbi([
-    "function tokenURI(uint256 tokenId) view returns (string)",
-    "function getAgentWallet(uint256 agentId) view returns (address)",
-    "function ownerOf(uint256 tokenId) view returns (address)",
-]);
-const getIdentityInputSchema = z.object({
-    agentId: z.string().regex(/^\d+$/, "agentId must be a numeric string"),
-});
-export class MonadIdentityGetCommand extends PluginCommand {
-    static description = "Get agent identity details from Monad Testnet ERC-8004 Registry";
-    pluginCommandId = "monad:identity:get";
-    async execute(io) {
-        const rawInputs = await io.resolveInputs(getIdentityInputSchema);
-        const { agentId } = getIdentityInputSchema.parse(rawInputs);
-        const client = this.ctx.publicClient(MONAD_TESTNET_CHAIN_ID);
-        const tokenIdBigInt = BigInt(agentId);
-        const [owner, walletAddress, uri] = await Promise.all([
-            client.readContract({
-                address: MONAD_TESTNET_ERC8004_IDENTITY_REGISTRY,
-                abi: erc8004IdentityAbi,
-                functionName: "ownerOf",
-                args: [tokenIdBigInt],
-            }),
-            client.readContract({
-                address: MONAD_TESTNET_ERC8004_IDENTITY_REGISTRY,
-                abi: erc8004IdentityAbi,
-                functionName: "getAgentWallet",
-                args: [tokenIdBigInt],
-            }),
-            client.readContract({
-                address: MONAD_TESTNET_ERC8004_IDENTITY_REGISTRY,
-                abi: erc8004IdentityAbi,
-                functionName: "tokenURI",
-                args: [tokenIdBigInt],
-            }),
-        ]);
-        let card;
-        if (uri.startsWith("data:application/json;utf8,")) {
-            try {
-                const decoded = decodeURIComponent(uri.replace("data:application/json;utf8,", ""));
-                const parsed = JSON.parse(decoded);
-                card = monadAgentCardSchema.parse(parsed);
-            }
-            catch {
-                io.warn(`Could not parse agent metadata URI for agentId ${agentId}`);
-            }
-        }
-        return {
-            agentId,
-            owner,
-            walletAddress,
-            card,
-        };
-    }
-}

package/dist/commands/identity/register.d.ts

@@ -1,12 +0,0 @@
-import { type MonadAgentCard } from "@monagent/shared";
-import { PluginCommand, type CommandIO } from "../../sdk.js";
-export interface RegisterIdentityResult {
-    transactionHash: `0x${string}`;
-    agentCard: MonadAgentCard;
-    registryAddress: string;
-}
-export declare class MonadIdentityRegisterCommand extends PluginCommand<RegisterIdentityResult> {
-    static description: string;
-    protected readonly pluginCommandId = "monad:identity:register";
-    execute(io: CommandIO): Promise<RegisterIdentityResult>;
-}

package/dist/commands/identity/register.js

@@ -1,39 +0,0 @@
-import { encodeFunctionData, parseAbi } from "viem";
-import { MONAD_TESTNET_CHAIN_ID, MONAD_TESTNET_ERC8004_IDENTITY_REGISTRY, monadAgentCardSchema, } from "@monagent/shared";
-import { PluginCommand } from "../../sdk.js";
-const erc8004IdentityAbi = parseAbi([
-    "function register(string agentURI) returns (uint256 agentId)",
-    "function tokenURI(uint256 tokenId) view returns (string)",
-    "function getAgentWallet(uint256 agentId) view returns (address)",
-    "function ownerOf(uint256 tokenId) view returns (address)",
-]);
-export class MonadIdentityRegisterCommand extends PluginCommand {
-    static description = "Register an AI Agent identity on Monad Testnet ERC-8004 Registry";
-    pluginCommandId = "monad:identity:register";
-    async execute(io) {
-        const rawInputs = await io.resolveInputs(monadAgentCardSchema);
-        const card = monadAgentCardSchema.parse(rawInputs);
-        const agentUri = `data:application/json;utf8,${encodeURIComponent(JSON.stringify(card))}`;
-        const data = encodeFunctionData({
-            abi: erc8004IdentityAbi,
-            functionName: "register",
-            args: [agentUri],
-        });
-        const executor = this.ctx.walletExecutor(io, this.pluginCommandId);
-        const result = await executor({
-            kind: "transaction",
-            chainId: MONAD_TESTNET_CHAIN_ID,
-            to: MONAD_TESTNET_ERC8004_IDENTITY_REGISTRY,
-            data,
-        });
-        if (result.status !== "success" || !result.hash) {
-            throw new Error(`Failed to register agent identity on Monad: status ${result.status}`);
-        }
-        io.log(`Agent identity registered on Monad! TxHash: ${result.hash}`);
-        return {
-            transactionHash: result.hash,
-            agentCard: card,
-            registryAddress: MONAD_TESTNET_ERC8004_IDENTITY_REGISTRY,
-        };
-    }
-}

package/dist/commands/jobs/create.js

@@ -1,38 +0,0 @@
-import { parseEther } from "viem";
-import { z } from "zod";
-import { MONAD_TESTNET_CHAIN_ID } from "@monagent/shared";
-import { PluginCommand } from "../../sdk.js";
-const createJobInputSchema = z.object({
-    workerAddress: z.string().regex(/^0x[a-fA-F0-9]{40}$/),
-    bountyMon: z.string().regex(/^\d+(\.\d+)?$/),
-    taskDescription: z.string().min(1).max(500),
-    deadlineHours: z.number().int().min(1).max(168).default(24),
-});
-export class MonadJobsCreateCommand extends PluginCommand {
-    static description = "Create and fund a subcontracted A2A task escrow on Monad";
-    pluginCommandId = "monad:jobs:create";
-    async execute(io) {
-        const rawInputs = await io.resolveInputs(createJobInputSchema);
-        const { workerAddress, bountyMon, taskDescription, deadlineHours } = createJobInputSchema.parse(rawInputs);
-        io.log(`Creating A2A Job for worker ${workerAddress} with bounty ${bountyMon} MON (Deadline: ${deadlineHours}h)`);
-        const executor = this.ctx.walletExecutor(io, this.pluginCommandId);
-        const tx = await executor({
-            kind: "transaction",
-            chainId: MONAD_TESTNET_CHAIN_ID,
-            to: workerAddress,
-            value: parseEther(bountyMon),
-        });
-        if (tx.status !== "success" || !tx.hash) {
-            throw new Error(`Failed to fund job escrow on Monad: status ${tx.status}`);
-        }
-        const jobId = `job_${Date.now()}_${tx.hash.slice(2, 10)}`;
-        io.log(`Job escrow funded! JobId: ${jobId}, Tx: ${tx.hash}`);
-        return {
-            jobId,
-            workerAddress,
-            bountyMon,
-            taskDescription,
-            escrowTransactionHash: tx.hash,
-        };
-    }
-}

package/dist/commands/pay.js

@@ -1,33 +0,0 @@
-import { parseEther } from "viem";
-import { MONAD_TESTNET_CHAIN_ID, monadPaymentInputSchema, } from "@monagent/shared";
-import { PluginCommand } from "../sdk.js";
-export class MonadPayCommand extends PluginCommand {
-    static description = "Send direct MON or ERC-20 payment on Monad Testnet";
-    pluginCommandId = "monad:pay";
-    async execute(io) {
-        const rawInputs = await io.resolveInputs(monadPaymentInputSchema);
-        const { to, amount, token, memo } = monadPaymentInputSchema.parse(rawInputs);
-        if (token !== "MON") {
-            throw new Error(`Token ${token} not yet supported directly in quick-pay. Use MON for native transfers.`);
-        }
-        const valueInWei = parseEther(amount);
-        const executor = this.ctx.walletExecutor(io, this.pluginCommandId);
-        const result = await executor({
-            kind: "transaction",
-            chainId: MONAD_TESTNET_CHAIN_ID,
-            to,
-            value: valueInWei,
-        });
-        if (result.status !== "success" || !result.hash) {
-            throw new Error(`Failed to send MON payment: status ${result.status}`);
-        }
-        io.log(`Paid ${amount} MON to ${to}. TxHash: ${result.hash}`);
-        return {
-            transactionHash: result.hash,
-            to,
-            amount,
-            token,
-            memo,
-        };
-    }
-}

package/dist/commands/reputation/check.d.ts

@@ -1,12 +0,0 @@
-import { PluginCommand, type CommandIO } from "../../sdk.js";
-export interface CheckReputationResult {
-    agentId: string;
-    feedbackCount: number;
-    averageScore: number;
-    trustTier: "HIGH" | "MEDIUM" | "LOW" | "UNRATED";
-}
-export declare class MonadReputationCheckCommand extends PluginCommand<CheckReputationResult> {
-    static description: string;
-    protected readonly pluginCommandId = "monad:reputation:check";
-    execute(io: CommandIO): Promise<CheckReputationResult>;
-}

package/dist/commands/reputation/check.js

@@ -1,46 +0,0 @@
-import { parseAbi } from "viem";
-import { z } from "zod";
-import { MONAD_TESTNET_CHAIN_ID, MONAD_TESTNET_ERC8004_REPUTATION_REGISTRY, } from "@monagent/shared";
-import { PluginCommand } from "../../sdk.js";
-const erc8004ReputationAbi = parseAbi([
-    "function getSummary(uint256 agentId, address[] clientAddresses, string tag1, string tag2) view returns (uint64 count, int128 summaryValue, uint8 summaryValueDecimals)",
-]);
-const checkReputationInputSchema = z.object({
-    agentId: z.string().regex(/^\d+$/, "agentId must be a numeric string"),
-    tag1: z.string().default(""),
-    tag2: z.string().default(""),
-});
-export class MonadReputationCheckCommand extends PluginCommand {
-    static description = "Check peer agent reputation on Monad ERC-8004 Reputation Registry";
-    pluginCommandId = "monad:reputation:check";
-    async execute(io) {
-        const rawInputs = await io.resolveInputs(checkReputationInputSchema);
-        const { agentId, tag1, tag2 } = checkReputationInputSchema.parse(rawInputs);
-        const client = this.ctx.publicClient(MONAD_TESTNET_CHAIN_ID);
-        const tokenIdBigInt = BigInt(agentId);
-        const [count, summaryValue, decimals] = await client.readContract({
-            address: MONAD_TESTNET_ERC8004_REPUTATION_REGISTRY,
-            abi: erc8004ReputationAbi,
-            functionName: "getSummary",
-            args: [tokenIdBigInt, [], tag1, tag2],
-        });
-        const feedbackCount = Number(count);
-        const scoreDivider = 10 ** decimals;
-        const averageScore = feedbackCount > 0 ? Number(summaryValue) / (feedbackCount * scoreDivider) : 0;
-        let trustTier = "UNRATED";
-        if (feedbackCount > 0) {
-            if (averageScore >= 80)
-                trustTier = "HIGH";
-            else if (averageScore >= 50)
-                trustTier = "MEDIUM";
-            else
-                trustTier = "LOW";
-        }
-        return {
-            agentId,
-            feedbackCount,
-            averageScore,
-            trustTier,
-        };
-    }
-}

package/dist/commands/reputation/give.d.ts

@@ -1,12 +0,0 @@
-import { type MonadReputationFeedback } from "@monagent/shared";
-import { PluginCommand, type CommandIO } from "../../sdk.js";
-export interface GiveReputationResult {
-    transactionHash: `0x${string}`;
-    feedback: MonadReputationFeedback;
-    registryAddress: string;
-}
-export declare class MonadReputationGiveCommand extends PluginCommand<GiveReputationResult> {
-    static description: string;
-    protected readonly pluginCommandId = "monad:reputation:give";
-    execute(io: CommandIO): Promise<GiveReputationResult>;
-}

package/dist/commands/reputation/give.js

@@ -1,45 +0,0 @@
-import { encodeFunctionData, keccak256, parseAbi, toHex } from "viem";
-import { MONAD_TESTNET_CHAIN_ID, MONAD_TESTNET_ERC8004_REPUTATION_REGISTRY, monadReputationFeedbackSchema, } from "@monagent/shared";
-import { PluginCommand } from "../../sdk.js";
-const erc8004ReputationAbi = parseAbi([
-    "function giveFeedback(uint256 agentId, int128 value, uint8 valueDecimals, string tag1, string tag2, string endpoint, string feedbackURI, bytes32 feedbackHash)",
-]);
-export class MonadReputationGiveCommand extends PluginCommand {
-    static description = "Submit on-chain peer feedback to Monad ERC-8004 Reputation Registry";
-    pluginCommandId = "monad:reputation:give";
-    async execute(io) {
-        const rawInputs = await io.resolveInputs(monadReputationFeedbackSchema);
-        const feedback = monadReputationFeedbackSchema.parse(rawInputs);
-        const feedbackHash = feedback.feedbackURI ? keccak256(toHex(feedback.feedbackURI)) : keccak256(toHex("feedback"));
-        const data = encodeFunctionData({
-            abi: erc8004ReputationAbi,
-            functionName: "giveFeedback",
-            args: [
-                BigInt(feedback.agentId),
-                BigInt(feedback.value),
-                feedback.decimals,
-                feedback.tag1,
-                feedback.tag2,
-                feedback.endpoint,
-                feedback.feedbackURI,
-                feedbackHash,
-            ],
-        });
-        const executor = this.ctx.walletExecutor(io, this.pluginCommandId);
-        const result = await executor({
-            kind: "transaction",
-            chainId: MONAD_TESTNET_CHAIN_ID,
-            to: MONAD_TESTNET_ERC8004_REPUTATION_REGISTRY,
-            data,
-        });
-        if (result.status !== "success" || !result.hash) {
-            throw new Error(`Failed to submit reputation feedback on Monad: status ${result.status}`);
-        }
-        io.log(`Feedback submitted on Monad! TxHash: ${result.hash}`);
-        return {
-            transactionHash: result.hash,
-            feedback,
-            registryAddress: MONAD_TESTNET_ERC8004_REPUTATION_REGISTRY,
-        };
-    }
-}

package/dist/commands/x402/pay.d.ts

@@ -1,13 +0,0 @@
-import { PluginCommand, type CommandIO } from "../../sdk.js";
-export interface X402PayResult {
-    url: string;
-    statusCode: number;
-    response: string;
-    paymentSettled: boolean;
-    paymentTransactionHash?: `0x${string}`;
-}
-export declare class MonadX402PayCommand extends PluginCommand<X402PayResult> {
-    static description: string;
-    protected readonly pluginCommandId = "monad:x402:pay";
-    execute(io: CommandIO): Promise<X402PayResult>;
-}

package/dist/commands/x402/pay.js

@@ -1,67 +0,0 @@
-import { parseEther } from "viem";
-import { MONAD_TESTNET_CHAIN_ID, monadX402PaymentSchema, } from "@monagent/shared";
-import { PluginCommand } from "../../sdk.js";
-export class MonadX402PayCommand extends PluginCommand {
-    static description = "Execute paid tool/API call over HTTP 402 with Monad micropayments";
-    pluginCommandId = "monad:x402:pay";
-    async execute(io) {
-        const rawInputs = await io.resolveInputs(monadX402PaymentSchema);
-        const { url, method, body, maxSpendMon } = monadX402PaymentSchema.parse(rawInputs);
-        io.log(`Executing request to paid API: ${url}`);
-        // Initial probe to check if 402 Payment Required is returned
-        const initialRes = await fetch(url, {
-            method,
-            headers: {
-                Accept: "application/json",
-                "Content-Type": "application/json",
-            },
-            body: method === "POST" ? body : undefined,
-        }).catch(() => null);
-        if (initialRes && initialRes.status !== 402) {
-            const text = await initialRes.text();
-            return {
-                url,
-                statusCode: initialRes.status,
-                response: text,
-                paymentSettled: false,
-            };
-        }
-        // Parse x402 payment requirements from headers or body
-        const recipient = initialRes?.headers.get("x-payment-recipient") || "0x1111111111111111111111111111111111111111";
-        const paymentAmount = initialRes?.headers.get("x-payment-amount") || "0.01";
-        if (Number(paymentAmount) > Number(maxSpendMon)) {
-            throw new Error(`Requested payment ${paymentAmount} MON exceeds maximum spend limit of ${maxSpendMon} MON`);
-        }
-        io.log(`Server requested 402 Payment: ${paymentAmount} MON to ${recipient}. Executing on Monad...`);
-        const executor = this.ctx.walletExecutor(io, this.pluginCommandId);
-        const tx = await executor({
-            kind: "transaction",
-            chainId: MONAD_TESTNET_CHAIN_ID,
-            to: recipient,
-            value: parseEther(paymentAmount),
-        });
-        if (tx.status !== "success" || !tx.hash) {
-            throw new Error(`402 payment settlement failed on Monad: ${tx.status}`);
-        }
-        io.log(`Payment confirmed: ${tx.hash}. Retrying paid API request with payment proof...`);
-        // Retry with Monad transaction proof
-        const paidRes = await fetch(url, {
-            method,
-            headers: {
-                Accept: "application/json",
-                "Content-Type": "application/json",
-                "X-Payment-Tx": tx.hash,
-                "X-Payment-Chain": String(MONAD_TESTNET_CHAIN_ID),
-            },
-            body: method === "POST" ? body : undefined,
-        });
-        const responseText = await paidRes.text();
-        return {
-            url,
-            statusCode: paidRes.status,
-            response: responseText,
-            paymentSettled: true,
-            paymentTransactionHash: tx.hash,
-        };
-    }
-}

package/dist/commands.test.d.ts

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