The X1 RPC endpoint. Change only if using testnet or custom endpoint
x1_vault_cli/wallet.json
✅ Yes
—
Your X1 wallet keypair file. Used for encryption and blockchain anchoring.
🔴 SECURITY WARNING: Use a dedicated wallet with minimal XNT. Never use your primary wallet.
What It Does
Backs up your agent's brain (identity, personality, memories) with AES-256-GCM military-grade encryption, stores it on IPFS, and anchors the CID on the X1 blockchain. Only your wallet keypair can decrypt.
Servers die. Containers get wiped. One bad rm -rf and your agent's identity is gone. X1 Vault Memory makes your agent's brain indestructible — encrypted, decentralized, and recoverable from anywhere.
Key Features
AES-256-GCM encryption — uses your wallet keypair as the key. Only you can decrypt.
IPFS storage — your data lives on a decentralized network, not a single server.
X1 blockchain anchoring — every backup CID is recorded on-chain for permanent, verifiable proof.
Self-healing restore — one command to download, decrypt, and restore all agent files.
Negligible cost — about 0.03 USD per year for daily backups.
Start with bridge + XDEX if you are coming from Solana. That is the smoothest path. Each backup costs approximately 0.002 XNT, so even a small amount goes a long way.
How to Set Up Pinata and Get Your JWT Token
Pinata is the IPFS pinning service that stores your encrypted backups. The free tier is more than enough.
Create an account with your email or sign in with GitHub/Google
After login, click your profile icon in the top right corner
Select API Keys from the dropdown menu
Click the New Key button
Enable only the pinFileToIPFS permission (Admin access is NOT required)
Give the key a name like "x1-vault-memory"
Click Create Key
You will see three values: API Key, API Secret, and JWT
Copy the JWT token — this is your PINATA_JWT value
Save it somewhere safe — you will not be able to see the JWT again after closing this page
The JWT token does not expire unless you manually revoke it in the Pinata dashboard. Free tier includes 500 files and 1GB storage. Each encrypted backup is around 10-50KB, so you can store thousands of backups without paying anything.
Setup
🔴 SECURITY WARNING: Use a dedicated wallet with minimal XNT. Never use your primary wallet.
1. Install Node dependencies
cd x1-vault-memory && npm install
2. Configure environment variables
Option A: Using a .env file (recommended for Docker and production)
Create a .env file in your project or workspace root:
