The Tatum Key Management System (KMS) is a robust solution designed to manage and secure private keys, mnemonics, and blockchain wallets for Tatum-powered applications. In this guide, we will walk through the installation and usage of KMS, troubleshooting common issues, and strategies for secure key management.
What Does KMS Do?
KMS securely stores private keys and mnemonics for various blockchains. It regularly pulls pending transactions, signs them locally using stored keys, and broadcasts them to the blockchain, ensuring each operation is done securely.

Key Features of KMS
- Secure storage of private keys and mnemonics
- Supports multiple blockchains including Bitcoin, Ethereum, and more
- Easy integration with Tatum API for transaction signing
Setting Up KMS on Your Site
To get KMS operational on your site, follow these steps:
- Install KMS on your local environment.
- Store existing mnemonics and private keys in KMS or generate new ones.
- Implement the four-eye principle.
- Run KMS in daemon mode for automatic transaction signing.
- Use KMS schemas to build the API request bodies for operations.
Installing KMS
KMS can be installed through npm or Docker. It requires Node.js version 14 and npm version 6.
From NPM
npm i -g @tatumiotatum-kms
Via Docker
docker pull tatumiotatum-kms
Understanding KMS with an Analogy
Think of Tatum KMS as a digital vault for your blockchain keys. Just like a vault protects your valuable possessions, KMS safely stores your private keys and mnemonics, shielding them from unauthorized access. Just as you would need a special key to access the vault, KMS requires your unique password to unlock the keys stored within. Each transaction is like a request to withdraw something valuable from the vault, ensuring only authorized operations can take place. KMS also has an added layer of security with the four-eye principle: like having a co-signer for significant withdrawals, this principle ensures that sensitive transactions are only processed with external validation.
Troubleshooting Common Issues
Here are solutions to frequent problems you might face while using KMS:
- Error Message:
TypeError: Cannot read property mnemonic of undefined
- Possible Reasons:
- You used a mnemonic-based ID when the operation requires a private key-based ID.
- You correctly used the mnemonic-based ID but did not specify the index of the private key.
- Possible Reasons:
For more insights, updates, or to collaborate on AI development projects, stay connected with fxis.ai.
Final Thoughts
At fxis.ai, we believe that such advancements are crucial for the future of AI, as they enable more comprehensive and effective solutions. Our team is continually exploring new methodologies to push the envelope in artificial intelligence, ensuring that our clients benefit from the latest technological innovations.