ts-sdk-transactions

Build, sign, submit, and simulate Aptos transactions using the TypeScript SDK.

19|8|Updated Jan 23, 2026
One-click install
npx skills add https://github.com/aptos-labs/aptos-agent-skills --skill ts-sdk-transactions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ts-sdk-transactions
Source: https://github.com/aptos-labs/aptos-agent-skills/tree/main/skills/sdk/typescript/ts-sdk-transactions
Command: npx skills add https://github.com/aptos-labs/aptos-agent-skills --skill ts-sdk-transactions

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill simplifies the complex process of building, signing, submitting, and simulating transactions using the Aptos TypeScript SDK, ensuring reliable dApp interactions.

Core Features & Use Cases

  • Transaction Lifecycle Management: Guides users through the complete transaction flow from building to confirmation.
  • Advanced Scenarios: Covers sponsored transactions (fee payer) and multi-agent transactions for complex dApp logic.
  • Use Case: When developing a decentralized exchange, use this Skill to securely handle token swaps involving multiple accounts and potential fee payer arrangements.

Quick Start

Use the ts-sdk-transactions skill to build, sign, and submit a simple transaction to increment a counter.

Frequently Asked Questions about ts-sdk-transactions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I submit and confirm an Aptos transaction using the TypeScript SDK?

To submit an Aptos transaction using the TypeScript SDK, build and sign the transaction payload, submit it to the network, and explicitly call `waitForTransaction` to ensure full confirmation and avoid common skipping mistakes.

What is a sponsored transaction in Aptos and how do I build it with TypeScript?

A sponsored Aptos transaction allows a secondary fee payer account to cover network gas costs. Use the TypeScript SDK to build a fee payer transaction, collecting signatures from both the sender and the designated fee payer before submission.

How do I handle function arguments for Aptos TypeScript SDK transactions?

Handle Aptos TypeScript SDK transaction arguments by explicitly casting numeric inputs to `bigint`. This ensures the SDK correctly serializes values for on-chain execution and prevents type mismatch errors during transaction building.

Can I execute multi-agent transactions on Aptos using the TypeScript SDK?

Yes, you can execute multi-agent Aptos transactions using the TypeScript SDK by defining multiple signer accounts within the transaction payload and collecting the required signatures from each participating agent before submission.

Why does my Aptos TypeScript SDK transaction fail even after successful submission?

Aptos TypeScript SDK transactions may appear successful but fail on-chain if you skip confirmation steps or use deprecated methods. Always use `waitForTransaction` to verify execution status and confirm the transaction is finalized.

How do I simulate an Aptos transaction before submitting it with the TypeScript SDK?

Simulate an Aptos transaction using the TypeScript SDK by building the transaction payload and running a simulation request to preview execution results, allowing you to validate function arguments and estimate gas costs safely without committing state changes.