transferApt.ts•4.66 kB
import { Tool } from "@modelcontextprotocol/sdk/types.js";
import { getAptosClient } from "../../config.js";
import { getDefaultAccount } from "../../utils/account.js";
import { formatAPT, formatAddress, aptToOctas } from "../../utils/format.js";
export const TRANSFER_APT: Tool = {
name: "transfer_apt",
description: "Transfer native APT tokens to another Aptos account. This is used for sending APT tokens from your account to another address. Returns the transaction hash upon successful transfer.",
inputSchema: {
type: "object",
properties: {
recipient_address: {
type: "string",
description: "Recipient Aptos address, e.g., 0x1 or 0x742d35Cc6634C0532925a3b8D6Ac0C4db9c8b3",
},
amount: {
type: "string",
description: "Amount of APT to transfer (e.g., '1.5' for 1.5 APT)",
},
max_gas_amount: {
type: "number",
description: "Maximum gas amount for the transaction (optional)",
default: 2000,
},
},
required: ["recipient_address", "amount"],
},
};
/**
* Transfers native APT tokens to another account
* @param args The arguments containing recipient address and amount
* @returns The transfer transaction details
*/
export async function transferAptHandler(args: Record<string, any> | undefined) {
if (!isTransferAptArgs(args)) {
throw new Error("Invalid arguments for transfer_apt");
}
const { recipient_address, amount, max_gas_amount = 2000 } = args;
try {
const results = await performTransferApt(recipient_address, amount, max_gas_amount);
return {
content: [{ type: "text", text: results }],
isError: false,
};
} catch (error) {
return {
content: [
{
type: "text",
text: `Error transferring APT: ${error instanceof Error ? error.message : String(error)}`,
},
],
isError: true,
};
}
}
/**
* Transfers native APT tokens to another account
* @param recipientAddress The recipient's Aptos address
* @param amount The amount of APT to transfer
* @param maxGasAmount Maximum gas amount for the transaction
* @returns The transfer transaction details as a formatted string
*/
export async function performTransferApt(
recipientAddress: string,
amount: string,
maxGasAmount: number = 2000
): Promise<string> {
try {
const aptos = getAptosClient();
const senderAccount = getDefaultAccount();
// Convert APT amount to Octas
const amountOctas = aptToOctas(amount);
// Build the transfer transaction
const transaction = await aptos.transaction.build.simple({
sender: senderAccount.accountAddress,
data: {
function: "0x1::aptos_account::transfer",
functionArguments: [recipientAddress, amountOctas],
},
options: {
maxGasAmount,
},
});
// Sign and submit the transaction
const committedTxn = await aptos.signAndSubmitTransaction({
signer: senderAccount,
transaction,
});
// Wait for transaction confirmation
const executedTxn = await aptos.waitForTransaction({
transactionHash: committedTxn.hash,
});
return `APT Transfer Successful:
From: ${formatAddress(senderAccount.accountAddress.toString())}
To: ${formatAddress(recipientAddress)}
Amount: ${amount} APT (${amountOctas} Octas)
Transaction Hash: ${committedTxn.hash}
Gas Used: ${executedTxn.gas_used}
Status: ${executedTxn.success ? 'Success' : 'Failed'}
✅ Transfer completed successfully!`;
} catch (error) {
console.error('Error transferring APT:', error);
if (error instanceof Error) {
if (error.message.includes('insufficient')) {
throw new Error("Insufficient APT balance to complete the transfer");
}
if (error.message.includes('invalid')) {
throw new Error("Invalid recipient address format");
}
}
throw new Error(`Failed to transfer APT: ${error instanceof Error ? error.message : String(error)}`);
}
}
/**
* Checks if the provided arguments are valid for the transferApt tool
* @param args The arguments to check
* @returns True if the arguments are valid, false otherwise
*/
export function isTransferAptArgs(args: unknown): args is {
recipient_address: string;
amount: string;
max_gas_amount?: number
} {
return (
typeof args === "object" &&
args !== null &&
"recipient_address" in args &&
typeof (args as any).recipient_address === "string" &&
"amount" in args &&
typeof (args as any).amount === "string" &&
(!(args as any).max_gas_amount || typeof (args as any).max_gas_amount === "number")
);
}