accounts

Manage Kaia account keys and decouple private keys from addresses.

3|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/Pieverse-Eng/purrfect-skills --skill accounts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: accounts
Source: https://github.com/Pieverse-Eng/purrfect-skills/tree/main/kaia-skills/vendor/accounts
Command: npx skills add https://github.com/Pieverse-Eng/purrfect-skills --skill accounts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Kaia separates private keys from addresses, creating complexity for developers and wallet operators who need to perform key rotation, role-based access, and protocol-level multi-signature management without losing address continuity. This Skill explains the account model and how to safely create, update, and freeze keys so teams can reduce compromise risk and implement delegated fee payments.

Core Features & Use Cases

  • AccountKey Types: Describes AccountKeyNil, AccountKeyLegacy, AccountKeyPublic, AccountKeyFail, AccountKeyWeightedMultiSig, and AccountKeyRoleBased and when to use each.
  • Role-Based Keys & Delegation: Explains RoleTransaction, RoleAccountUpdate, and RoleFeePayer roles to enable separated responsibilities and fee-paying delegates.
  • Key Rotation & Account Updates: Guides creating TxTypeAccountUpdate transactions for rotating keys, setting multi-sig for sensitive roles, or freezing accounts.
  • Real-World Example: Rotate a compromised signing key to a new public key, keep the same address, and use a weighted multi-sig for account updates while a single key handles daily transactions.

Quick Start

Create and send a TxTypeAccountUpdate transaction specifying the new AccountKeyPublic value and the target address to rotate the account's signing key.

Frequently Asked Questions about accounts

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

FAQPage Schema
How does Kaia account key rotation work without changing the address?

Kaia key rotation uses TxTypeAccountUpdate transactions to decouple private keys from addresses. You can update the AccountKeyPublic value for your target address, allowing you to rotate compromised signing keys while maintaining address continuity.

What are the different AccountKey types available on the Kaia blockchain?

Kaia supports six AccountKey types: AccountKeyNil, AccountKeyLegacy, AccountKeyPublic, AccountKeyFail, AccountKeyWeightedMultiSig, and AccountKeyRoleBased. Each type serves specific security requirements, from single-key management to complex multi-signature setups.

How do I set up role-based keys for Kaia fee delegation and account updates?

Kaia role-based keys assign separate permissions for RoleTransaction, RoleAccountUpdate, and RoleFeePayer activities. This allows you to delegate fee payments and restrict sensitive account updates while letting a single key handle daily transactions.

Can I apply weighted multi-sig to Kaia account updates while using a single key for transactions?

Yes, you can use AccountKeyRoleBased to apply a weighted multi-sig requirement for RoleAccountUpdate while retaining a single AccountKeyPublic for RoleTransaction. This secures sensitive operations without complicating daily transaction signing.

Do I need specific Kaia wallet libraries to support TxTypeAccountUpdate transactions?

Yes, you need wallets or libraries that support Kaia-specific transaction fields to construct TxTypeAccountUpdate transactions. Standard blockchain wallets lack the required fields to handle Kaia's decoupled account key model.

When should I use AccountKeyFail to freeze a Kaia account?

You should use AccountKeyFail when you need to freeze a Kaia account and prevent all future transactions. Applying it via an account update effectively disables the account's signing capabilities without destroying the address.