helius_get_signatures_for_address
Retrieve transaction signatures for a Solana address to track wallet activity, verify transactions, or analyze blockchain interactions.
Instructions
Get transaction signatures for a Solana address
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes | ||
| limit | No | ||
| before | No | ||
| until | No | ||
| commitment | No |
Implementation Reference
- src/handlers/helius.ts:207-225 (handler)The handler function getSignaturesForAddressHandler that validates the address and calls helius.connection.getSignaturesForAddress with optional parameters.
export const getSignaturesForAddressHandler = async (input: GetSignaturesForAddressInput): Promise<ToolResultSchema> => { const addressResult = validatePublicKey(input.address); if (!(addressResult instanceof PublicKey)) { return addressResult; } try { const options: any = {}; if (input.limit) options.limit = input.limit; if (input.before) options.before = input.before; if (input.until) options.until = input.until; if (input.commitment) options.commitment = input.commitment; const signatures = await (helius as any as Helius).connection.getSignaturesForAddress(addressResult, options); return createSuccessResponse(`Signatures: ${JSON.stringify(signatures, null, 2)}`); } catch (error) { return createErrorResponse(`Error getting signatures: ${error instanceof Error ? error.message : String(error)}`); } } - src/handlers/helius.types.ts:106-112 (schema)TypeScript type definition for the input parameters of the handler.
export type GetSignaturesForAddressInput = { address: string; limit?: number; before?: string; until?: string; commitment?: "confirmed" | "finalized" | "processed"; } - src/tools.ts:162-176 (registration)MCP tool registration including name, description, and input schema definition.
{ name: "helius_get_signatures_for_address", description: "Get transaction signatures for a Solana address", inputSchema: { type: "object", properties: { address: { type: "string" }, limit: { type: "number" }, before: { type: "string" }, until: { type: "string" }, commitment: { type: "string", enum: ["confirmed", "finalized", "processed"] } }, required: ["address"] } }, - src/tools.ts:562-562 (registration)Mapping of tool name to its handler function in the handlers dictionary.
"helius_get_signatures_for_address": getSignaturesForAddressHandler,