@ton-agent-kit/plugin-escrow 1.0.3 → 1.1.1

package/src/actions/seller-stake.ts

@@ -0,0 +1,69 @@
+import { z } from "zod";
+import { Address, fromNano } from "@ton/core";
+import { defineAction, toFriendlyAddress } from "@ton-agent-kit/core";
+import { loadEscrows, sellerStakeOnContract, getContractState, getLatestTxHash } from "../utils";
+
+export const sellerStakeAction = defineAction({
+  name: "seller_stake_escrow",
+  description:
+    "Seller (beneficiary) deposits their stake into an escrow that requires reputation collateral. " +
+    "Must be called before buyer deposits. Stake amount can be adjusted by reputation: " +
+    "score 90-100 = 50% of base, 60-89 = 100%, 30-59 = 150%, below minRepScore = blocked.",
+  schema: z.object({
+    escrowId: z.string().optional().describe("Escrow ID"),
+    contractAddress: z.string().optional().describe("Contract address (alternative to escrowId)"),
+    stakeAmount: z.string().optional().describe("Stake amount in TON. If not provided, uses baseSellerStake from escrow."),
+  }),
+  handler: async (agent, params) => {
+    const escrows = loadEscrows();
+    let escrow: any;
+    if (params.escrowId) {
+      escrow = escrows[params.escrowId];
+    } else if (params.contractAddress) {
+      escrow = Object.values(escrows).find((e: any) => e.contractAddress === params.contractAddress);
+    }
+    if (!escrow) {
+      return { staked: false, message: "Escrow not found" };
+    }
+
+    const contractAddress = Address.parse(escrow.contractAddress);
+
+    // Read on-chain state to check requirements
+    try {
+      const state = await getContractState(agent, contractAddress);
+
+      if (!state.requireSellerStake) {
+        return { staked: false, message: "This escrow does not require seller stake" };
+      }
+      if (state.sellerStaked) {
+        return { staked: false, message: "Seller has already staked" };
+      }
+
+      const stakeAmount = params.stakeAmount || fromNano(state.baseSellerStake);
+
+      await sellerStakeOnContract(agent, contractAddress, stakeAmount);
+
+      const txHash = await getLatestTxHash(
+        agent.wallet.address.toRawString(),
+        agent.network,
+      );
+
+      return {
+        staked: true,
+        amount: stakeAmount + " TON",
+        escrowId: escrow.id,
+        contractAddress: escrow.contractAddress,
+        friendlyContract: toFriendlyAddress(contractAddress, agent.network),
+        stakeTxHash: txHash,
+        message: `Seller staked ${stakeAmount} TON. Buyer can now deposit.`,
+      };
+    } catch (err: any) {
+      return {
+        staked: false,
+        escrowId: escrow.id,
+        error: err.message,
+        message: `Failed to stake: ${err.message}`,
+      };
+    }
+  },
+});

package/src/actions/vote-refund.ts

@@ -0,0 +1,50 @@
+import { z } from "zod";
+import { Address } from "@ton/core";
+import { defineAction, toFriendlyAddress } from "@ton-agent-kit/core";
+import { loadEscrows, saveEscrows, voteRefundOnContract, getLatestTxHash } from "../utils";
+
+export const voteRefundAction = defineAction({
+  name: "vote_refund",
+  description:
+    "Vote to refund escrow funds to the depositor during a multi-arbiter dispute. Must be called by a registered arbiter. When majority is reached, funds are automatically refunded.",
+  schema: z.object({
+    escrowId: z.string().describe("Escrow ID to vote refund on"),
+  }),
+  handler: async (agent, params) => {
+    const escrows = loadEscrows();
+    const escrow = escrows[params.escrowId];
+    if (!escrow) {
+      return { voted: false, message: `Escrow not found: ${params.escrowId}` };
+    }
+
+    const contractAddress = Address.parse(escrow.contractAddress);
+
+    try {
+      await voteRefundOnContract(agent, contractAddress);
+
+      const txHash = await getLatestTxHash(
+        agent.wallet.address.toRawString(),
+        agent.network,
+      );
+
+      return {
+        voted: true,
+        vote: "refund",
+        escrowId: params.escrowId,
+        contractAddress: escrow.contractAddress,
+        friendlyContract: toFriendlyAddress(contractAddress, agent.network),
+        voter: agent.wallet.address.toRawString(),
+        voteTxHash: txHash,
+        message: `Voted to refund escrow ${params.escrowId}. Contract will auto-execute when majority is reached.`,
+      };
+    } catch (err: any) {
+      return {
+        voted: false,
+        vote: "refund",
+        escrowId: params.escrowId,
+        error: err.message,
+        message: `Vote failed: ${err.message}`,
+      };
+    }
+  },
+});

package/src/actions/vote-release.ts

@@ -0,0 +1,50 @@
+import { z } from "zod";
+import { Address } from "@ton/core";
+import { defineAction, toFriendlyAddress } from "@ton-agent-kit/core";
+import { loadEscrows, saveEscrows, voteReleaseOnContract, getLatestTxHash } from "../utils";
+
+export const voteReleaseAction = defineAction({
+  name: "vote_release",
+  description:
+    "Vote to release escrow funds to the beneficiary during a multi-arbiter dispute. Must be called by a registered arbiter. When majority is reached, funds are automatically released.",
+  schema: z.object({
+    escrowId: z.string().describe("Escrow ID to vote release on"),
+  }),
+  handler: async (agent, params) => {
+    const escrows = loadEscrows();
+    const escrow = escrows[params.escrowId];
+    if (!escrow) {
+      return { voted: false, message: `Escrow not found: ${params.escrowId}` };
+    }
+
+    const contractAddress = Address.parse(escrow.contractAddress);
+
+    try {
+      await voteReleaseOnContract(agent, contractAddress);
+
+      const txHash = await getLatestTxHash(
+        agent.wallet.address.toRawString(),
+        agent.network,
+      );
+
+      return {
+        voted: true,
+        vote: "release",
+        escrowId: params.escrowId,
+        contractAddress: escrow.contractAddress,
+        friendlyContract: toFriendlyAddress(contractAddress, agent.network),
+        voter: agent.wallet.address.toRawString(),
+        voteTxHash: txHash,
+        message: `Voted to release escrow ${params.escrowId}. Contract will auto-execute when majority is reached.`,
+      };
+    } catch (err: any) {
+      return {
+        voted: false,
+        vote: "release",
+        escrowId: params.escrowId,
+        error: err.message,
+        message: `Vote failed: ${err.message}`,
+      };
+    }
+  },
+});