ark-vtxo-model

Explain the VTXO domain model, states, and lifecycle in the Ark protocol.

3|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/ArkLabsHQ/arkadian --skill ark-vtxo-model
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ark-vtxo-model
Source: https://github.com/ArkLabsHQ/arkadian/tree/main/skills/ark-vtxo-model
Command: npx skills add https://github.com/ArkLabsHQ/arkadian --skill ark-vtxo-model

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill clarifies the complex lifecycle, states, and data structures of Virtual Transaction Outputs (VTXOs) within the Ark protocol, enabling developers to correctly implement and interact with them.

Core Features & Use Cases

  • VTXO Lifecycle: Explains the journey of a VTXO from creation to spending, settlement, or expiration.
  • State Management: Details VTXO states like Created, Settled, Spent, Swept, and Unrolled.
  • Data Models: Provides insights into both server-side (Go) and client-side (TypeScript) VTXO representations.
  • Use Case: When debugging an issue with a VTXO that appears stuck or unspendable, this Skill helps identify its current state and the reasons behind its behavior.

Quick Start

Explain the difference between a VTXO and a Note in the Ark protocol.

Frequently Asked Questions about ark-vtxo-model

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

FAQPage Schema
What is a VTXO in the Ark protocol?

A VTXO, or Virtual Transaction Output, is a data structure in the Ark protocol representing a transaction output with a lifecycle from creation to settlement or expiration. It differs from a Note by tracking specific state transitions and round-to-VTXO relationships.

What are the possible states in the VTXO lifecycle?

VTXO state management includes Created, Settled, Spent, Swept, and Unrolled states. These states reflect specific lifecycle phases, indicating whether the virtual transaction output is newly generated, confirmed, utilized, or expired.

How do I debug an Ark protocol VTXO that appears stuck or unspendable?

To debug an unspendable VTXO, identify its current state—Created, Settled, Spent, Swept, or Unrolled. Analyzing the VTXO lifecycle and event types reveals the specific reasons behind the behavior and why the virtual transaction output remains blocked.

How are VTXOs represented in Go and TypeScript implementations?

VTXO data models are represented in Go for server-side and TypeScript for client-side implementations. These models define the domain attributes, storage mechanisms, and spending paths required for interacting with the Ark protocol's virtual transaction outputs.

What is the difference between a VTXO and a Note in the Ark protocol?

The distinction between a VTXO and a Note lies in their data structures and lifecycle management. VTXOs involve detailed state management and tree construction, whereas Notes serve a different representational purpose within the Ark protocol's ecosystem.

When does a VTXO expire and what happens during unrolling?

A VTXO expires after a predefined lifecycle duration, transitioning to the Unrolled state. During unrolling, the virtual transaction output is removed from the virtual state, its underlying tree construction is settled on-chain, and its spending paths become invalid.